docs: 日历那两处"未做"清单早已过期(写侧早就做完了)
`CalendarPage` 的文件头写着「没做:新建/编辑/删除事件(**写侧**)、……**ics 导入导出**」,
而写侧当时**早就做完了**(`createEvent`/`updateEvent` 已接线、表单在 765 行起)。
`docs/HARMONY-ALIGN-PLAN.md` 的 P6 行同样标着 ⬜ 未做。
注释把已完成的说成未做,比漏写更糟:下一个读的人会去"实现"一个已经存在的东西。
本仓反复在消的"说的与做的不一致"这次落在文档/注释上(判据看不见注释,
只有人读的时候才会发现 —— 所以更该在每次真做完时顺手改)。
- `CalendarPage` 文件头:补上月/周/日三档、农历、写侧、.ics,并写明为什么还没有滑动翻页。
- `HARMONY-ALIGN-PLAN.md` P6:⬜ → ✅(滑动翻页除外),带三笔提交号(fbe7879 / 2da38bb / bcd7e7f)
与"鸿蒙无下载目录概念、DocumentViewPicker 是唯一路径"这条平台差异。
This commit is contained in:
@ -1,13 +1,25 @@
|
||||
/*
|
||||
* AgentMail 鸿蒙客户端 — 日历(P6 第一步:只读月视图)
|
||||
* AgentMail 鸿蒙客户端 — 日历
|
||||
*
|
||||
* # 这一版做了什么、没做什么(别把"没做的"读成"做了")
|
||||
*
|
||||
* 做了:月网格(可翻月、可回"今天")、点某一天看当天日程、事件点标记、
|
||||
* 今天/选中两态、加载失败**说出来**。
|
||||
* 做了:
|
||||
* · 月 / 周 / 日**三档**视图(`calScale`),可翻月/翻周/翻天、可回"今天";
|
||||
* · 点某一天看当天日程、事件点标记、今天/选中两态;
|
||||
* · 农历标签(`GET /calendar/lunar`,走服务端 —— 不在 ArkTS 里重写天文算法);
|
||||
* · **写侧**:新建 / 编辑 / 删除日程(与 WebUI 同一份 `CalendarEventInput` 打两个端点);
|
||||
* · **.ics 导入导出**(`common/IcsFile.ets` 走系统 `DocumentViewPicker`);
|
||||
* · 加载失败**说出来**(静默吞掉会让"这个月没日程"与"服务端没答上来"长得一样)。
|
||||
*
|
||||
* 没做:农历重复事件、左右滑动翻页(P6 第 3 步)。
|
||||
* 滑动那条还牵着 `docs/DEBTS.json` 的 `gesture-semantics`("鸿蒙侧出现滑动手势代码时立即建判据")
|
||||
* —— 没写手势就不该先建那条假判据,所以这一版用按钮翻月。
|
||||
* —— 没写手势就不该先建那条假判据,所以目前用按钮翻月。
|
||||
*
|
||||
* ★ 2026-09-18 修这段注释:它原先写着"做了:只读月视图……没做:新建/编辑/删除事件(写侧)、
|
||||
* .ics 导入导出" —— 而**写侧当时早就做完了**(`saveEvent` 调 `createEvent`/`updateEvent`,
|
||||
* 表单在 765 行起)。注释把已完成的说成未做,比漏写更糟:下一个读的人会去"实现"一个
|
||||
* 已经存在的东西。这种"说的与做的不一致"本仓已经反复在消(判据看不见注释,
|
||||
* 所以只有人读的时候才会发现)。
|
||||
*
|
||||
* # 为什么先做只读
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user