docs/project-business/README.md
@@ -8,18 +8,19 @@
- **业务定位**:离散制造工厂产供销人财物一体化:覆盖『销售接单 → 采购/生产 → 质检 → 仓储 → 发货 → 回款 → 售后』全链路闭环
- **技术底座**:yudao(ruoyi-vue-pro)二开,Spring Boot + MyBatis + Flowable + Redis + MySQL 8.4 + Milvus + 通义千问;前端 mom-pro2-before(Vue3)
- **核心主线**:CRM 合同 → ERP 销售订单 → MES 主计划/工单/报工 → 质检与仓储 → 销售出库 → 开票回款 → 售后闭环
- **独立模块**:财务报销(`yudao-module-finance`,报销单/明细/发票附件/审批/归档)与会员管理(`yudao-module-ums`,入会申请/秘书处与理事会两级审批/会员/通讯录)各自成一条链路,均不与其他业务模块产生单据关联(UMS 例外:审批通过会经 AdminUserApi 创建系统登录账号);课题管理(`yudao-module-research`,课题指南/在线申报/专家评审/三级立项审批/立项通知/经费拨付)为另一条独立科研主线,仅向外取 `ums_member` 作为申报人、向内写 `system_notice` 立项公告
## 2. 目录结构
```text
docs/project-business/
├── index.html      # 可视化页面:双击直接打开(file:// 即可,无需任何服务)
├── mermaid/        # 11 张 Mermaid 业务图(权威源,改这里)
├── mermaid/        # 14 张 Mermaid 业务图(权威源,改这里)
├── data/           # 业务数据(权威源,改这里)
│   ├── business.json  # 项目元信息/业务十问/AI能力/待确认事项
│   ├── modules.json   # 12 个业务模块定义
│   ├── modules.json   # 16 个业务模块定义
│   ├── objects.json   # 核心业务对象(作用/上游/下游/表名)
│   ├── flows.json     # 7 条流程(摘要+步骤+角色)
│   ├── flows.json     # 9 条流程(摘要+步骤+角色)
│   └── roles.json     # 角色权限
└── README.md
```
@@ -45,6 +46,9 @@
| 09-data-flow | 跨模块数据流(单据生成、字段带入、数量回写、事件) |
| 10-business-object | 核心业务对象 ER(只含业务对象,非全库表) |
| 11-ai-business-flow | AI 业务链路(OCR/质检判定/四类预测/RAG,含 API 依赖) |
| 12-finance-flow | 财务报销(独立模块):报销单+明细+发票附件 → 提交 BPM 审批 → 通过/驳回 → 归档终态 |
| 13-ums-membership-flow | 会员入会(独立模块):入会申请 + 材料附件 → 提交 BPM 两级审批(秘书处初审→理事会审议)→ 通过自动建会员与登录账号 → 会员列表/通讯录检索 |
| 14-research-flow | 课题管理(独立模块):指南发布(重点/一般)→在线申报(选会员带出申报人)→专家评分明细加权排名→BPM 三级审批(秘书处形式审查→专家评审→学会立项审批)→立项编号与公告→经费拨付记录 |
图中状态数字均为源码枚举真实值(如工单 0草稿/1已确认/2完成/3取消;ERP 审批 15审批中/20已审核)。
@@ -65,8 +69,8 @@
- 本目录由项目技能 **project-business-analysis** 管理(`.claude/skills/project-business-analysis/`),并有规则 `.claude/rules/business-visualization-maintenance.md` 强制:业务模块/流程/状态/对象/角色/AI 变更后需同步维护本目录。
- 增量维护:改对应的 `mermaid/*.mmd` + `data/*.json` → 运行上面的 sync 脚本 → 浏览器验证受影响图。
- 全量重做(偏差过大时):对 Claude 说「重新生成业务全景」,技能会重新走读源码并按生成模式重建。
- 生成基线:dev_business @ 87bf4a99,2026-09-10。
- 生成基线:dev_business @ 87bf4a99,2026-09-10;2026-09-28 增量补充财务报销模块(`yudao-module-finance`)、会员管理模块(`yudao-module-ums`)与课题管理模块(`yudao-module-research`,一期项 1~5;二期结项验收与成果归档尚未做,图中已标注未覆盖范围)。
## 7. 已知待确认业务
见 `data/business.json` 的 `pendingConfirm`(页面「待确认事项」栏),要点:仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单等。
见 `data/business.json` 的 `pendingConfirm`(页面「待确认事项」栏),要点:仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单、财务报销的 BPM 流程定义未发布与普通角色未授菜单、会员管理的 BPM 流程未发布且缺审批自定义表单页、自动建账号用手机号作初始密码存在弱口令风险、课题管理的评分权重与通过阈值为占位规则待学会确认、一期经费拨付与财务模块无数据同步、申报单与会员为软关联可能悬空等。