6.8 KiB
6.8 KiB
企业银行账户与付款制单实施计划
1. 实施前门禁
- 用户审查并批准 PRD、设计与本实施计划后，才运行
task.py start。 - 运行
trellis-before-dev，读取 backend/frontend/hyb-oa 相关 spec 与研究材料。 - 核对工作树，不提交本地空白银行模板、生成制单文件、真实账号或个人 workspace。
- 记录当前
FIELD_ENCRYPTION_KEY载荷兼容口径，但不读取或输出任何密钥/真实账号。
2. 依赖与迁移
- 以精确官方 tarball安装 SheetJS
0.20.3，锁定 package-lock 完整性；确认许可证与依赖门禁，不使用 npm registry 的[email protected]。 - 新增
BankInstitution、PaymentAccount，以及 Employee/PaymentBatch 可空关系、内部快照和制单统计字段。 - 迁移增加同一法人主体单一 active 付款账户的 PostgreSQL 部分唯一索引；不回填存量批次或员工银行机构。
- 更新 Prisma Client 并运行
npm run prisma:validate；核对 migration SQL 和回滚兼容说明。
3. 权限、账户与员工收款资料
- 新增
payment.account.manage/read/read_full与payment.order.export，按设计分配角色；清理finance_mgr重复的payment.batch.manage条目。 - 实现银行机构和付款账户脱敏 CRUD/替换/停用 API，事务内审计并通知 active admin/CEO。
- 实现公司完整账号带原因查看：先写审计，再返回；负向路径不返回明文。
- 扩展员工敏感资料接口：默认脱敏、HR/admin 可写银行机构与账号、finance/finance_mgr 只读；完整查看独立带原因审计。
- 员工本人 API 返回银行名称与脱敏尾号，不返回完整账号。
- 增加管理端企业银行账户页面和人员档案收款信息区；移动端不增加复杂配置入口。
4. 批次冻结快照
- 对报销银行批次解析并锁定单一法人主体、唯一 active CCB 付款账户和完整员工 CCB 收款资料。
- 直接复制现有账号密文进入内部快照；只为脱敏显示做受控解密，不进行解密后再加密。
- 扩展付款 DTO，只映射付款账户/收款账户脱敏字段及制单统计，禁止原始 snapshot 或
v1:密文外泄。 - 旧批次继续显示兼容信息、允许人工付款，但永久不具备制单资格。
5. BIFF8 制单
- 建立独立制单服务：固定 15 列和三个工作表、稳定排序、单一流水号函数、七列字符串类型、金额两位小数、中文和 CCB-only 校验。
- 实现 POST 制单下载接口：finance/finance_mgr 业务角色 + 独立权限 + reviewed 状态 + 必填原因。
- 在生成任何文件前聚合阻塞项；任何非 CCB、历史快照、缺资料或异常均整批失败，不生成部分文件。
- 首次导出/重导在事务内写制单统计与脱敏审计，之后以内存 buffer 和 no-store 安全响应头下载，不持久化文件。
- 重导确认固定展示重复付款风险原文，不暗示旧文件已作废。
6. 付款详情交互
- DTO 提供制单次数、最近导出摘要、可制单状态与聚合阻塞原因，页面用自然中文逐项说明。
- 未导出新批次主动作显示“下载银行制单”；已导出无回单时主动作显示“上传银行回单”；当前重导为顶部次动作，待详情页结构统一任务再收进正式“更多”槽位。
- 人工付款可直接上传回单，不把制单设为上传或登记付款的门禁。
- 详情显示是否已生成制单；处理进度按未导出/已导出显示两种批准文案。
- 不在本任务重构完整详情页骨架；与未来详情结构统一任务保持组件边界清楚。
7. 自动化与独立读回
- 后端测试覆盖权限矩阵、active 唯一约束、账户替换/停用、通知、审计、默认脱敏和完整查看原因。
- 付款批次测试覆盖单一法人主体、CCB-only、密文复制、员工资料后改不漂移、旧批次拒绝和普通响应无密文。
- 制单测试覆盖 15 列、三个工作表、确定性排序、流水号校验、七列字符串、金额、中文、重导一致性、整批失败和无持久化。
- 增加可复现的
xlrd==2.0.2独立读回环境和 CI 步骤；合成文件仅存临时目录并自动清理。 - 前端测试覆盖角色可见性、员工本人脱敏、管理表单、导出原因、重导警告、主动作切换和旧批次人工兜底。
8. 全量验证与只读复核
cd server && npm run prisma:validate。- 对全部触及的服务端 JS 运行
node --check，运行付款批次/用户/导出/通知聚焦 Vitest。 cd client && npm run typecheck && npm run build；未新增或运行本任务前端 E2E。- 运行 BIFF8 独立读回脚本；Excel/WPS 人工打开仍待执行。
- 运行依赖审计、Trellis governance、process contract、敏感扫描、
git diff --check；依赖审计保留仓库既有 14 项告警，新增 SheetJS 未命中告警。 - 对权限、状态机、迁移、密文数据流和 API 响应执行一次独立只读 review；发现的聚合阻塞项合同漂移已由主流程修复并复验。
9. 文档、提交与上线边界
- 仅把稳定安全/付款合同更新到现有 spec、产品事实源和管理员手册，不新建无必要业务文档。
- 按逻辑分批中文提交，提交信息引用
corporate-bank-account-payment-order。 - 不在代码任务中写入任何生产银行资料；生产配置、部署和员工资料确认分别取得明确批准。
- 部署后先由 admin 配置 CCB 与公司付款账户，再由 HR/admin 确认员工 CCB；配置完成前暂停新建银行批次。
- 旧杨俊批次继续人工付款并上传回单，不补写快照、不尝试制单。
- 公网门禁通过后才通知王芝玲测试制单；没有独立网银校验步骤时不做生产网银导入试验。
10. 本地验证记录
- 服务端全量：176 个测试文件、1186 项测试通过。
- 本任务聚焦：付款批次与 BIFF8 服务 57 项测试通过；公司账户、员工敏感资料和个人资料测试包含在全量结果中。
- 前端：TypeScript 检查和生产构建通过。
- 数据与文件：Prisma schema 校验通过；
xlrd==2.0.2独立读回确认三个工作表、15 列、长账号字符串、01字符串、数值金额与中文。 - 治理：Trellis task 校验、governance、process contract、敏感内容扫描和
git diff --check通过；文档注册审计仅保留仓库既有 22 个未登记文件警告。 - 依赖：
[email protected]来自官方精确 tarball且锁定；生产依赖审计仍有 14 项仓库既有告警，未执行破坏性npm audit fix --force。 - 尚未完成：Excel/WPS 人工打开、前端 E2E/截图、生产数据库迁移、真实资料配置、部署、公网检查和企业网银校验。