xiaoshu-app/docs/operations/lesson-report-edit-2026-10-13.md

学习报表与完课报告编辑（2026-10-13）

学习报表和已结课预约详情沿用绿色视觉系统，统一课程概览、反馈、学习记录、评价和复习进度卡片。日期按北京时间显示到分钟；预约详情用已保存的报告快照展示本次词数与课程分钟数，避免把缺失的旧累计字段显示为零。

老师可在预约详情底部或反馈卡片点击“修改报告”，学习报表也提供相同入口。编辑时回填全部反馈字段，取消不写入，失败保留输入，成功刷新详情并提示。复习、生词本、训练状态仍为可选文本。学生端不显示修改按钮。

app_lesson_feedback_update 调用独立的 xs_lesson_feedback_update 事务，只更新反馈文字、对应上课记录的点评及用于刷新的时间戳。校验帐套、有效老师、预约归属、已结课状态、取消状态、精确报告版本；请求编号保障重试幂等。修改前后的反馈保存在 LessonWorkflowCommand。不调用结课函数，不重复扣课时，不改工资快照、原始起止时间、单词成果、复习计划或学生评价。

验收：

• 数据库流程测试覆盖文字修改、重试、越权、旧版本和取消拒绝；比较修改前后余额、学习成果、评价及报告系统字段。
• Angular 定向测试覆盖编辑回填、取消、失败保留输入、保存、学生权限和请求幂等；移动端构建通过。
• Chromium 隔离接口页面验收覆盖 375px 和 812px，无横向溢出、无页面异常，实际点击编辑与保存通过。截图在 /tmp/xiaoshu-report-previews/；该页面测试数据为模拟数据。
• 云端发布版本 2026-10-13-edit-feedback-v6，仅发布移动网关及新增反馈修改 SQL 函数。
• 线上隔离账号完成真实教学流程、报告修改与重试、过期版本拒绝、学生端回读；余额对账、原有学生评价和学习成果保持。隔离数据与临时函数均已清理。
• 实际服务器发布前备份、迁移与验收日志在本机权限受限目录 /Users/mac/.local/state/xiaoshu/report-edit/2026-10-13/。前端本地开发页面可刷新查看；本次未发布公网静态站点。