hyb-oa/.trellis/tasks/08-05-contract-detail-workspace/implement.md

实施计划

1. Schema 与迁移

• 在 ContractRegistry 增加 terminated_at/reason/by、terminator 关系，在 Employee 增加反向关系。
• terminated_reason 限制 1000，terminated_by 使用 onDelete: Restrict；按查询需要添加索引。
• 生成纯增量 migration，检查只有可空列、外键/索引，无历史回填、drop 或状态改写。
• 运行 cd server && npm run prisma:format && npm run prisma:validate && npm run prisma:generate。

2. 状态与服务端不变量

• 持久/筛选状态加入 terminated，一般 create/PATCH 可写状态仍排除 terminated。
• 增加 terminated 筛选、effective status、expiring 排除和 renew 拒绝测试。
• 增加详情 GET，按列表相同范围查询 owner/project/terminator/document refs，并投影安全 history。
• 增加专用 terminate schema 和接口，reason trim 后 10–1000。
• 终止 transaction 原子写三字段、status 和 required audit；模拟 audit failure 证明全回滚。
• 阻止 archived/terminated 普通字段覆盖与终止绕过。
• 归档/恢复改为 required audit；实现归档后追加修正记录，不覆盖主合同。
• 保持续约 active/expired 语义和事务审计。

3. 客户端 API 与状态映射

• 客户端合同类型加入 terminated 与三个终止字段、terminator、document refs、history DTO。
• contractStatusLabel 增加“已终止”，未知兜底为“未知状态”而非原值。
• 增加 fetch detail、terminate、correction 等必要 API 函数，不暴露 raw audit/document path。

4. 列表、详情和表单

• 合同列表移除内联 editor，仅保留筛选、提醒、导出、状态和查看详情。
• 新建合同详情路由和页面元数据，权限 guard 与现有列表一致。
• 建设状态/下一步、摘要、证据区、历史和动作面板；窄屏复用共享底部动作容器。
• 证据区展示归档位置、离线档案号、涉密资料索引和强制引导文案；不显示空附件区或附件完整性列。
• 迁移编辑、续约、归档/恢复；按动作矩阵隐藏或禁用。
• 终止输入持续显示至少 10 字要求；禁用时显示原因；确认包含合同编号、相对方、金额和后果。
• 归档后只提供授权修正追加入口，不覆盖普通字段。
• 只展示真实 project 摘要与跳转；采购/付款无稳定关联时不渲染。

5. 后端与迁移验证

• cd server && node --check src/routes/contractsRegistry.js
• cd server && npm test -- tests/unit/routes/contractsRegistry.test.js tests/unit/routes/exports.contractsRegistry.test.js
• cd server && npm run prisma:validate
• cd server && npx prisma migrate status（只读；不得未经批准 deploy/reset）。
• 检查生成 migration SQL 和既有数据兼容，记录应用回滚前/后首次终止写入的不同边界。

6. 前端与交互验证

• cd client && npm run typecheck
• cd client && npm run build
• 增加合同详情聚焦 Playwright：列表进入、深链刷新、无权限/不存在、dirty guard、涉密引导、无附件区。
• 覆盖终止原因不足、确认摘要、成功状态、重复终止、审计失败和窄屏动作安全区。
• 覆盖归档锁定、修正追加、恢复、续约和未知状态兜底。

7. 只读 Review 与治理

• 实施完成后启动只读 reviewer，按 design 第 9 节逐项审查，明确 reviewer 不改代码。
• 主会话修复 finding 后重新运行聚焦测试并请求只读复查。
• 运行 task validate、process contract、docs registry、Trellis governance、敏感内容检查和 git diff --check。
• 判断稳定规则是否需要更新现有合同规约或 Trellis spec，不新建平行文档。

8. 提交、部署与回滚

• 使用中文 commit message 并引用 08-05-contract-detail-workspace。
• 本地实现提交不等于批准生产 migration 或部署。
• 生产发布另行获批后，显式验证 migration status、/ready、合同详情和权限负向路径。
• 首次生产终止写入前保留应用回滚窗口；产生 terminated 行后优先 roll-forward，不自动 drop 列或回退到不识别 terminated 的旧应用。