v79 端上:任务面板(首页/任务页共用)+ 任务模块功能补齐

用户原话:「鸿蒙端的功能,也需要同样适配,在首页上可以直接修改编辑任务,
另外任务模块的功能需要完善。」

端上原来只有"看列表 / 勾完成 / 新建改标题",网页 v78 那套「就地处理」
(改状态、挪分组、子任务、附件、留言、删除)一件都没有;首页点任务
弹的还是 v73 的只读卡。

一、新增 FbTaskPanel(首页与任务页共用同一组件)
  · 改状态三段(待办/进行中/已完成)+ 标题左侧状态圈
  · 挪看板 chips、勾/加子任务、加图片附件并删、发留言
  · 编辑 → 交给宿主开 FbTaskEditSheet;删除要**点两次**(端上没有 undo)
  · 每个动作成功后再 getTask() 重拉一次:一次动作会牵动子任务计数、
    附件张数、看板色,逐处同步 DOM 必然漏一处

二、退役 FbTaskDetailSheet(v73 只读卡,387 行)
  ⚠️ 它已无人挂载,而守卫还在逐条"通过" —— 等于给死代码盖章。

三、任务模块补齐
  · 卡片点击 → 面板(不再直接进编辑表单:误触一下就开始改标题,
    且子任务/附件/留言没地方放)
  · 「只看已完成」改真打 ?view=done:看板视图服务端就写死
    status <> 'done',在客户端筛永远是空
  · 看板列表改走 ?view=boards:原来从任务反推 ⇒ 空看板永远选不到
  · 编辑表单补分类/循环两排

四、顺带修掉一个自查发现的真 bug
  任务页里 sheetCount 有**两个** @Monitor 都监听 boardSheetOpen、都写同一个值
  ⇒ 关掉设置浮层时谁最后执行不确定,会把还开着的面板"顺便让位结束",
  底部悬浮栏浮上来盖住面板按钮。已并成一个取并集的 monitor。

服务端(另一仓):新增 GET /tasks?view=boards、POST/DELETE /tasks/<id>/attach,
详情补 board_name/board_color_calc,越权删别条任务的附件 → 404。

验证:静态守卫 1055/0(新增 v79 一组,含"全页只许一个 sheetCount 赋值点")、
反向验证 215/0(新增 15 条注入,逐条证明新断言会红)、
服务端 e2e 1558/0、_fb_v79_api.py 26/0、编译通过并已装机。
This commit is contained in:
2026-10-22 16:40:44 +08:00
parent c7bd26dd1b
commit 25a0797a74
8 changed files with 1816 additions and 504 deletions
+122 -81
View File
@@ -39,24 +39,26 @@
import { FbColors, FbMetric, FB_MASK } from '../../common/Theme';
import { FbAppState, fbAppState } from '../../common/Store';
import { FbCalEvent, FbHomeData, FbMark, FbMemoryItem, FbRecentDay, FbTaskItem,
import { FbCalEvent, FbCatOpt, FbHomeData, FbMark, FbMemoryItem, FbRecentDay, FbTaskItem,
FbBoardOpt, FbTaskDetail, FbTaskMeta,
FbWeather, isEditableEvent } from '../../model/Types';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { parseHome } from '../../data/FbParse';
import { loadModule } from '../../data/FbModuleLoad';
import { loadModule, loadPath } from '../../data/FbModuleLoad';
import { FB_CAL_SETTINGS, FbCalStyle } from '../../data/FbCalSettings';
import { FbCalRepo, FbCalEventFull } from '../../data/FbCalRepo';
import { FB_TOKEN_STORE } from '../../data/FbTokenStore';
import { setTaskStatus } from '../../data/FbTaskRepo';
import { parseTaskMeta } from '../../data/FbParse';
import { FB_CARD_FORMS } from '../../data/FbCardForms';
import { fbApi, FbApiResult } from '../../data/FbHttp';
import { FbSectionTitle } from '../../components/Widgets';
import { FbStatCell } from '../../components/FbStatCell';
import { FbDayEventPanel } from '../../components/FbDayEventPanel';
import { FbEventSheet } from '../../components/FbEventSheet';
import { FbTaskDetailSheet } from '../../components/FbTaskDetailSheet';
import { FbTaskPanel } from '../../components/FbTaskPanel';
import { FbTaskEditSheet } from '../../components/FbTaskEditSheet';
import { FB_DOCK_RESERVE } from '../../components/FloatDock';
import { fbOnScroll, fbOnTouch } from '../../common/FbScroll';
import { fbMaskTransition, fbSheetTransition } from '../../common/FbAnim';
@@ -142,14 +144,36 @@ export struct FbHomePage {
/** 丢弃在途请求的令牌(连点两条日程时,先回来的那条不该覆盖后点的) */
@Local evtToken: number = 0;
/** 摘要卡显示的那条任务(非 null = 任务详情卡开着) */
/** 摘要卡显示的那条任务(非 null = 任务面板开着) */
@Local tskBase: FbTaskItem | null = null;
/** 任务卡上显示的当前状态(勾完**立刻**变,不等网络) */
@Local tskStatus: string = 'todo';
/** 任务状态正在提交(防连点) */
@Local tskBusy: boolean = false;
/** 任务卡的提示(失败原因 / 成功说明) */
@Local tskNote: string = '';
/**
* v79:面板里能用的**全部**看板 / 分类(`?view=boards`)。
*
* 🔴 为什么不在页面加载时就拉:首页 `/home` 不返回看板表,
* 而"挪分组/选分类"只有点开任务后才用得上 —— 按需拉更省一次请求。
* ⚠️ 拉的是**全部看板**(含空看板),不是从任务里反推
* (反推会让新建的空看板永远选不到)。
*/
@Local tskBoards: FbBoardOpt[] = [];
@Local tskCats: FbCatOpt[] = [];
/** 任务编辑表单是否打开(v79:在首页直接改,不再跳任务页) */
@Local tskEditOpen: boolean = false;
/** 编辑表单回填的字段 */
@Local tskEditId: number = 0;
@Local tskEditTitle: string = '';
@Local tskEditNote: string = '';
@Local tskEditDueAt: string = '';
@Local tskEditBoardId: number = 0;
@Local tskEditCatId: number = 0;
@Local tskEditRepeat: string = '';
/**
* 面板的"重画脉冲"(v79)。
*
* 🔴 为什么需要:编辑表单保存成功后,面板里的标题/截止/分类都变了,
* 但面板的数据是它**自己**拉的 —— 宿主只重拉首页列表,它不会跟着变。
* ⚠️ 别用"关掉再打开"代替:会闪一下、还会丢掉滚动位置。
*/
@Local tskTick: number = 0;
/**
* 详情卡开着 ⇒ 底部悬浮快捷栏让位。
@@ -158,9 +182,9 @@ export struct FbHomePage {
* `Index` 的 Stack** 里,层级比本页高 ⇒ 不让位就会盖住卡片底部的按钮、
* 还把点击抢走(名册/日程页都踩过)。
*/
@Monitor('evtBase', 'tskBase')
@Monitor('evtBase', 'tskBase', 'tskEditOpen')
onDetailChanged(): void {
this.app.sheetCount = (this.evtBase !== null || this.tskBase !== null) ? 1 : 0;
this.app.sheetCount = (this.evtBase !== null || this.tskBase !== null || this.tskEditOpen) ? 1 : 0;
}
aboutToAppear(): void {
@@ -181,6 +205,12 @@ export struct FbHomePage {
/** 返回手势:先关详情卡,再交给 `Index`(返回 true = 已消费) */
private backOnce(): boolean {
/* v79:**后打开的先关** —— 编辑表单是压在面板之上的,返回一次只该关它。
顺序反了会"按一次返回,两层一起没了"(用户会以为点错了)。 */
if (this.tskEditOpen) {
this.tskEditOpen = false;
return true;
}
if (this.evtBase !== null) {
this.closeEvent();
return true;
@@ -333,69 +363,50 @@ export struct FbHomePage {
}
// ============================================================
// v73:任务详情卡
// v79:任务面板(v73 的"详情卡"升级成可就地处理的面板)
// ============================================================
private openTask(t: FbTaskItem): void {
this.tskBase = t;
this.tskStatus = t.status;
this.tskBusy = false;
this.tskNote = '';
/* 看板/分类表按需拉一次(拉过就不再拉;它是"元数据",几条而己) */
this.loadTaskMeta();
}
private closeTask(): void {
this.tskBase = null;
this.tskBusy = false;
this.tskNote = '';
this.tskEditOpen = false;
}
/**
* 勾完成 / 取消完成。
*
* 🔴🔴 **必须走 `/tasks/<id>/status`**(`setTaskStatus`)——
* 服务端 `PATCH /tasks/<id>` 会把请求里的 status **原样忽略**
* (见 `FbTaskRepo` 文件头),打 PATCH 会"看起来成功、状态没变"。
* ⚠️ 这是本项目已经踩过一次的坑,别改成 updateTask。
*
* ⚠️ 已完成 → 取消完成统一回 `todo`(**不回 `doing`**):
* 用户只想撤销一次误勾,把它标成"进行中"是替他做了他没表达的决定。
* (与任务页 `toggleDone` 同一套规则。)
*/
private async toggleTask(): Promise<void> {
const t: FbTaskItem | null = this.tskBase;
if (t === null || this.tskBusy) {
/** 拉全部看板 + 分类(面板的"挪分组"、表单的"分类"都要用) */
private async loadTaskMeta(): Promise<void> {
if (this.tskBoards.length > 0) {
return;
}
this.tskBusy = true;
this.tskNote = '';
const next: string = this.tskStatus === 'done' ? 'todo' : 'done';
const res: FbApiResult = await setTaskStatus(FB_TOKEN_STORE.get(), t.id, next);
this.tskBusy = false;
if (!res.ok) {
this.tskNote = res.error !== '' ? res.error : '改状态失败,请稍后再试。';
return;
}
/* 本地先把状态改掉(卡上立刻有反馈),再重拉首页数据对齐派生字段
(逾期、看板计数、"近期任务"里这条还在不在,都是服务端算的)。
⚠️ 顺序不能反 —— 等网络回来再改,用户会以为"没点上"又点一次。 */
this.tskStatus = next;
this.tskNote = next === 'done' ? '已标记完成' : '已改回未完成';
this.load();
// 桌面卡片上的数字(今天日程/在做/待办)也可能受影响 —— 顺手推一次
this.pushCards();
await loadPath<FbTaskMeta>('tasks_meta', '/api/v1/tasks?view=boards', parseTaskMeta,
(m: FbTaskMeta): void => {
this.tskBoards = m.boards;
this.tskCats = m.cats;
},
(note: string): void => {
/* ⚠️ 失败**不拦路**:面板里状态/子任务/留言都还能用,
只是"换看板"那一排会少几个(甚至只剩默认看板)。 */
this.syncNote = note;
});
}
/**
* 任务卡上点「改一改」→ 切到任务模块。
*
* ⚠️ 与日程同理:改标题/改截止/看板/负责人是一整套表单,属于任务页的职责。
* 用户要的"弹详情、能勾完成"这里已经给了;"改内容"跳过去是对的。
*/
private editTaskFromDetail(): void {
this.closeTask();
this.app.switchModule('tasks');
/** 面板里点「编辑」→ 在首页就地打开编辑表单(v79,不再跳任务页) */
private openTaskEdit(d: FbTaskDetail): void {
this.tskEditId = d.base.id;
this.tskEditTitle = d.base.title;
this.tskEditNote = d.base.note;
this.tskEditDueAt = d.base.dueAt;
this.tskEditBoardId = d.base.boardId;
this.tskEditCatId = d.categoryId;
this.tskEditRepeat = d.repeat;
this.tskEditOpen = true;
}
/**
* 把最新数据推给桌面上所有日程卡片。
*
@@ -873,31 +884,61 @@ export struct FbHomePage {
.transition(fbSheetTransition())
}
// ==================== 任务详情卡(v73)====================
// ==================== 任务面板(v79:可就地处理)====================
/* 🔴 用户 2026-10-22:「在首页上可以直接修改编辑任务。」
⇒ v73 的"只读详情卡"升级成面板:状态 / 看板 / 子任务 / 附件 / 留言
全在这张卡里做完,**不跳任务模块**(跳模块是用户明确否掉的)。
⚠️ 面板根节点自带遮罩与 `Stack`,这里**不要**再包一层遮罩 ——
包了就会有两层暗色叠在一起(越点越黑)。 */
if (this.tskBase !== null) {
Column()
.width('100%')
.height('100%')
.backgroundColor(FB_MASK)
.transition(fbMaskTransition())
.onClick((): void => {
this.closeTask();
})
FbTaskDetailSheet({
task: this.tskBase,
status: this.tskStatus,
busy: this.tskBusy,
note: this.tskNote,
FbTaskPanel({
taskId: this.tskBase.id,
seed: this.tskBase,
boards: this.tskBoards,
accent: this.taskAccent(),
onToggle: (): void => {
this.toggleTask();
},
onEdit: (): void => {
this.editTaskFromDetail();
},
refreshTick: this.tskTick,
onClose: (): void => {
this.closeTask();
},
onEdit: (d: FbTaskDetail): void => {
this.openTaskEdit(d);
},
onChanged: (): void => {
/* 一次动作会牵动"近期任务"这张卡的排序/计数(服务端算的)⇒ 重拉首页 */
this.load();
this.pushCards();
},
onDeleted: (): void => {
this.closeTask();
this.load();
this.pushCards();
}
})
.transition(fbSheetTransition())
}
// ==================== 任务编辑表单(v79:就地改,不跳任务页)====================
if (this.tskEditOpen) {
FbTaskEditSheet({
accent: this.taskAccent(),
boards: this.tskBoards,
cats: this.tskCats,
editingId: this.tskEditId,
editingTitle: this.tskEditTitle,
editingNote: this.tskEditNote,
editingDueAt: this.tskEditDueAt,
editingBoardId: this.tskEditBoardId,
editingCatId: this.tskEditCatId,
editingRepeat: this.tskEditRepeat,
onClose: (): void => {
this.tskEditOpen = false;
},
onSaved: (): void => {
this.tskEditOpen = false;
/* 面板还开着 ⇒ 让它自己重拉一次(标题/截止/分类都变了) */
this.tskTick = this.tskTick + 1;
this.load();
this.pushCards();
}
})
.transition(fbSheetTransition())