这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下(由开发机迁移
79d3c2e 前后的不明批量操作产生)。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录,
它们从未入过 git 任何分支 history。删除即永久丢失。
按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行,将全部 96 份 D 类孤本
(主目录无同名、git history 亦无记录)复制到 docs/audit/changes/ 主目录入仓。
涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
DDL 基线合并 / Kiro 到 Claude Code 迁移
阶段 2(B 类内容漂移 1 份)和阶段 4(嵌套目录删除)独立推进。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4.5 KiB
4.5 KiB
变更审计记录:Task 6 Change B/C — 定时任务管理页面 + 小程序清理
| 字段 | 值 |
|---|---|
| 日期 | 2026-03-23 22:47:54 |
| Prompt-ID | P20260323-224401 |
| Session-ID | 5b6bbdcb |
| Session 路径 | docs/audit/session_logs/2026-03/23/38_0ad4d674_221119 |
操作摘要
Task 6(ETL 状态页修复 + 定时任务管理页面 + 启动检查)的 Change B 和 Change C 收尾:
- Change B:新建后端 trigger_jobs router + schemas,前端 TriggerJobs 页面和 API,admin-web 菜单/路由注册
- Change C:小程序 task-list 页面数据映射修复(banner 空数据、perfData 字段类型、头像加载、权限守卫)、api.ts 响应适配
- 清理:移除小程序中的 debug console.log
风险标签
root-file · dir:admin-web · dir:backend · dir:etl · dir:miniprogram · dir:db · db-schema-change
本次对话文件变更
新增文件
docs/audit/prompt_logs/prompt_log_20260323_224401.mddocs/audit/session_logs/2026-03/23/38_0ad4d674_221119/main_01_5b6bbdcb.mddocs/audit/session_logs/2026-03/23/38_0ad4d674_221119/sub_01_5b6bbdcb.md
删除文件
docs/audit/session_logs/2026-03/23/38_0ad4d674_221119/main_01_0744d658.md(被新版替换)
改动注解
apps/admin-web/src/App.tsx
- 变更类型:修改
- 原始原因:Task 6 Change B 需要在管理后台添加「定时任务」页面入口,同时本轮还集成了租户管理员、AI 监控、开发调试日志等多个新页面的路由
- 思路分析:在 NAV_ITEMS 菜单数组中插入
ClockCircleOutlined图标的「定时任务」菜单项(位于 ETL 状态之后),同时添加 AI 监控子菜单组(含运行总览/调度状态/调用明细/手动操作);Routes 区域对应添加 7 条新路由;菜单组件增加defaultOpenKeys逻辑以自动展开 AI 子菜单 - 修改结果:admin-web 侧边栏新增「定时任务」「租户管理员」「AI 监控」「开发调试日志」菜单项及对应路由,用户可直接导航到
/trigger-jobs查看和手动执行定时任务
apps/miniprogram/miniprogram/pages/task-list/task-list.ts
- 变更类型:修改
- 原始原因:P13 前端打磨审查 + 角色路由权限守卫 + 修复 banner 数据为空问题(后端返回 performance 字段未映射到 perfData)
- 思路分析:多项改动合并:(1) G1:从 fetchMe 获取头像/昵称/角色/门店名,替代硬编码 mock 数据;(2) G2:根据 incomeMonth 判断 isCurrentMonth;(3) perfData 字段类型从 string 改为 number(basicHours/bonusHours/totalHours/bonusMoney);(4) loadData 中新增完整的 performance→perfData 映射逻辑,兼容 snake_case 和 camelCase;(5) T1.3:abandonReason 从 task 对象获取不硬编码;(6) T1.4:盖戳动画始终播放不依赖 tierCompleted;(7) onShow 添加 checkPageAccess 权限守卫;(8) 移除硬编码的 AI 建议文案数组
- 修改结果:task-list 页面从后端实际数据驱动渲染,不再显示空白 banner;权限守卫阻止未授权用户访问;数据类型对齐后 WXML 模板中的格式化函数(fmt.money/fmt.hours 等)可正确工作
apps/miniprogram/miniprogram/services/api.ts
- 变更类型:修改
- 原始原因:后端 /api/xcx/tasks 返回格式为
{ items, total, page, pageSize, performance },前端 fetchTasks 期望{ tasks, hasMore, performance },需要适配层 - 思路分析:在 fetchTasks 函数中增加响应适配逻辑:将
res.items映射为tasks,根据page * pageSize < total计算hasMore,透传performance字段 - 修改结果:前端 task-list 页面可正确接收后端分页数据和业绩进度数据,消除了空数据问题
NeoZQYY.code-workspace
- 变更类型:修改(非高风险)
- 简要:workspace 配置更新
其他 session_logs 索引文件
- 变更类型:修改(非高风险)
- 简要:session 日志系统自动维护的 day_index 文件批量更新(2026-02 至 2026-03 各日期)
DDL/迁移检查
compliance.new_migration_sql:空(无新增迁移 SQL)- DDL 基线状态:⚠️
has_ddl_baseline为 false,DDL 基线待合并
OpenAPI Spec 同步
api_changed:false — 本轮未直接修改接口定义文件,无需重新导出 spec
合规检查
| 检查项 | 状态 |
|---|---|
| 审计记录 | ✅ 本文件 |
| AI_CHANGELOG | ✅ 已更新 |
| CHANGE 注释 | ✅ 已添加 |
| 文档同步 | ⚠️ apps/admin-web/README.md 和 apps/miniprogram/README.md 待确认同步 |
| DDL 基线 | ⚠️ 待合并 |