8.6 KiB
8.6 KiB
会议核销SaaS 未开发项开发迭代清单 V2（2026-03）
一、V2目标与范围
- 目标：基于
会议核销SaaS系统_技术开发文档.md新增6.10/7.7/7.8，完成“字段级口径 + 接口闭环 + 权限矩阵”落地。 - 范围：仅覆盖当前确认缺口，不回滚已完成能力。
- 原则：先补齐 P0 闭环，再推进 P1 增强；所有新增能力必须带审计、权限、测试。
二、当前迭代状态（V2启动）
| 迭代项 | 优先级 | 状态 | 说明 |
|---|---|---|---|
| V2-P0-1 字段级数据字典落库（6.10） | P0 | 已完成（待预发验证） | 已新增 V38__v2a_field_dictionary.sql，包含加列/新表/索引。 |
| V2-P0-2 接口缺口补齐（7.7） | P0 | 已完成（后端待QA，前端待联调） | 角色、数据权限、审计日志、资料包、会议总结、通知策略补齐。 |
| V2-P0-3 权限矩阵落地（7.8） | P0 | 进行中 | 接口三元绑定（permissionCode/dataScopeType/auditActionCode）统一治理。 |
| V2-P1-1 发票结构化明细全链路 | P1 | 未开始 | 明细项、附件、汇总、校验规则与财务联动。 |
| V2-P1-2 审核SLA与批量能力增强 | P1 | 未开始 | 催办、批量催办、超时升级、审计回溯增强。 |
三、迭代批次规划（建议 3 个 Sprint）
- Sprint V2-A（本期，1.5~2周）
- V2-P0-1、V2-P0-2、V2-P0-3 全部完成可提测版本。
- Sprint V2-B（下期，2周）
- V2-P1-1 发票结构化明细 + 财务分类费用打通。
- Sprint V2-C（下下期，1~1.5周）
- V2-P1-2 审核SLA批量能力增强 + 回归收口。
四、第一轮迭代（已启动）
4.1 V2-P0-1 字段级数据字典落库（6.10）
- 范围
project、meeting、meeting_material、audit_task、audit_action_log、expert、expert_bank_card、template/template_version、finance_meeting_bill字段补齐。- 新增建议表：
meeting_material_invoice_item、meeting_material_invoice_file、meeting_invoice_summary。
- 后端任务
- 完成实体/DO/DTO 字段扩展与向后兼容映射。
- 对关键写接口补充字段校验（金额单位“分”、比例范围、状态枚举合法性）。
- 当前进展：已完成
meeting_material发票结构化链路、audit_task新字段读写链路（SLA/超时/转审扩展）、meeting/project新字段基础映射、finance_meeting_bill读写接口、expert/template新字段映射。
- DB/Flyway任务
- 已完成：
backend/src/main/resources/db/migration/V38__v2a_field_dictionary.sql（幂等加列 + 新表 + 索引）。 - 待完成：预发执行验证、回填策略脚本（如需）与回滚演练记录。
- 已完成：
- 验收标准
- 新增字段不破坏现有接口。
- 发票明细可结构化保存并查询。
- 审核、财务、专家关键字段可检索可追溯。
4.2 V2-P0-2 接口缺口补齐（7.7）
- 范围
- 角色管理、数据权限管理、审计日志查询导出、会议资料包导出、会议总结生成下载、通知策略配置侧。
- 目标接口组（本期必须交付）
- 角色：
GET/POST/PUT /api/roles、POST /api/roles/{id}/enable|disable、POST /api/roles/{id}/permissions - 数据权限：
GET/POST/PUT /api/data-scope-policies、POST /api/data-scope-policies/{id}/copy|assign-roles|enable|disable - 审计日志：
GET /api/audit-logs、GET/POST /api/audit-logs/export-tasks - 会议资料：
POST /api/meetings/{id}/materials/{module}/submit|resubmit、POST /api/meetings/{id}/materials/export - 会议总结：
POST /api/meetings/{id}/summary/generate、GET /api/meetings/{id}/summary/download - 通知策略配置：
GET/POST/PUT /api/notification-policies、POST /api/notification-policies/{id}/events|enable|disable
- 角色：
- 验收标准
- 接口文档、权限码、错误码、审计动作码齐全。
- 前端按钮权限与后端接口权限一致。
- 导出/下载能力遵循数据权限范围。
- 当前进展
- 已补齐通知策略配置侧接口：
POST /api/notification-policies/{id}/events|enable|disable。 - 已补齐会议字段配置启停接口：
POST /api/meeting-fields/{id}/enable|disable。 - 已补齐发票抬头配置启停接口与别名路由：
POST /api/invoice-profiles/{id}/enable|disable、/api/invoice-heads。 - 前端系统设置页已接入上述能力：数据权限（复制/启停）、通知策略（绑定事件/启停）、会议字段（启停）、发票抬头（启停）。
- 审计日志页已接入导出任务能力：
GET/POST /api/audit-logs/export-tasks。 - 会议页已接入资料包导出与会议总结入口：资料包导出、总结生成、总结令牌刷新、总结下载。
- 已补齐通知策略配置侧接口：
4.3 V2-P0-3 权限矩阵落地（7.8）
- 范围
- 全量接口补三元绑定：
permissionCode、dataScopeType、auditActionCode。 - 接口发布前增加权限元数据检查门禁。
- 全量接口补三元绑定：
- 后端任务
- 新增权限元数据校验组件（启动校验 + 单测校验）。
- 统一数据范围枚举：
TENANT/PROJECT/MEETING/MEETING_MODULE/GLOBAL_READONLY。
- 当前进展
- 已完成注解扩展：
@RequirePermission支持dataScopeType/auditActionCode元数据。 - 已新增启动校验门禁组件：
PermissionMetadataGuard（支持writeoff.permission-metadata.strict严格模式）。 - 已在核心接口组补齐三元标注：通知策略、会议字段、发票抬头、数据权限、审计日志、会议资料包/会议总结接口。
- 已批量补齐存量控制器三元标注：角色/菜单/用户/租户/企业、模板、专家、审核流/审核任务、财务、导出任务、通知分发、可观测、文件下载等。
- 已完成注解扩展：
- 前端任务
- 按钮权限码与接口权限码同源配置。
- 无权限状态统一“置灰+原因提示”。
- 当前进展
- 已新增前端权限常量单源：
frontend/src/constants/permissions.ts。 - 已完成页面侧
hasPermission("...")到hasPermission(PERMS.xxx)的统一替换（系统设置、审核、财务、模板、专家、导出、通知、可观测等模块）。 - 已补齐主要操作按钮的“无权限置灰 + 原因提示（title）”展示规范。
- 已新增前端权限常量单源：
- 验收标准
- 缺权限元数据的接口不可发布。
- 越权请求稳定返回统一错误码（
20001/20002）。
五、任务卡（可直接建单）
| 任务ID | 模块 | 任务 | 负责人 | 预计人天 | 状态 | 依赖 |
|---|---|---|---|---|---|---|
| V2A-DB-01 | 字段落库 | 6.10 加列与新表迁移脚本 | 后端 | 2 | 已完成（待预发验证） | - |
| V2A-BE-01 | 字段落库 | 实体/接口字段扩展与校验 | 后端 | 3 | 已完成（待QA） | V2A-DB-01 |
| V2A-QA-01 | 字段落库 | 兼容性回归（存量接口） | 测试 | 1.5 | 未开始 | V2A-BE-01 |
| V2A-BE-02 | 接口补齐 | 角色+数据权限+审计日志接口组 | 后端 | 3 | 已完成（待QA） | - |
| V2A-FE-01 | 接口补齐 | 系统设置页面能力补齐 | 前端 | 3 | 已完成（待QA） | V2A-BE-02 |
| V2A-BE-03 | 接口补齐 | 会议资料包/会议总结接口组 | 后端 | 2 | 已完成（待QA） | - |
| V2A-FE-02 | 接口补齐 | 资料包导出与会议总结入口 | 前端 | 2 | 已完成（待QA） | V2A-BE-03 |
| V2A-BE-04 | 权限矩阵 | 三元绑定校验门禁 | 后端 | 1.5 | 已完成（待QA） | - |
| V2A-FE-03 | 权限矩阵 | 按钮权限同源配置改造 | 前端 | 1.5 | 已完成（待QA） | V2A-BE-04 |
| V2A-QA-02 | 全链路 | 权限+审计+导出下载回归 | 测试 | 2 | 未开始 | V2A-FE-01;V2A-FE-02;V2A-FE-03 |
六、风险与阻塞位
- 风险1：历史数据缺失（如旧会议无结构化发票明细）导致回填不完整。
- 处理：回填脚本允许空值，前端按“旧数据兼容展示”策略处理。
- 风险2：权限码重构影响存量按钮显隐。
- 处理：灰度发布，先日志观测再全量切换。
- 风险3：导出/下载接口并发高峰导致任务堆积。
- 处理：复用导出任务中心，增加限流与重试监控。
七、统一DoD（V2）
- 文档：OpenAPI 与技术文档同步更新，接口示例可直接联调。
- 数据：Flyway 迁移可重复执行，预发演练通过。
- 安全：权限、数据范围、审计动作三链路全部生效。
- 质量：单测覆盖新增校验与状态流转；至少 1 条端到端回归通过。
- 发布：灰度策略、回滚策略、监控告警规则完成配置。
八、下一步（默认执行顺序）
- 第1步：先完成
V2A-DB-01+V2A-BE-01，锁定字段口径。 - 第2步：并行推进
V2A-BE-02、V2A-BE-03、V2A-BE-04。 - 第3步：前端接入
V2A-FE-01/02/03，随后执行V2A-QA-01/02。 - 第4步：输出 Sprint V2-A 版本说明与上线检查单。