2.8 KiB
Executable File
2.8 KiB
Executable File
2026-10-09
逆向整理 ProcurementController 功能需求文档
- 读取
Controllers/ProcurementController.cs(3582 行,32 个接口:29 GET + 3 POST),按业务功能域划分输出需求文档。 - 产出:
docs/ProcurementController_功能需求文档.md(语雀可直接导入的 Markdown)。 - 模块划分(M1-M9):基础支撑层 / 采购申请单管理 / 采购物料看板 / 全链路单据追溯 / 导入导出 / 采购业务状态看板(L1-L4) / 物料交付状态看板(含未转单分支) / 审批与转单考核时效看板 / 到料考核时效看板。
- 关键业务口径记录:
- 数据源三套:OA MySQL(formtable_main_23 / _dt1 / _39_dt1)、GXWMS SQL Server(T_PUR_POORDER/RECEIVE + 两个 SP)、金蝶云星空(PUR_Requisition/PurchaseOrder/ReceiveBill)。
- 项目经理审批时间 = workflow_requestlog nodeid='844' 且 logtype IN ('0','2') 最后一条。
- 时效阈值走 Web.config:AuditLeadtimeHigh=5/Low=2,AuditReceiveHigh=4/Low=2。
- 金额口径:第一轮/第二轮总金额不读库,统一 报价 × 申请数量。
- 用途 yt:0生产/1研发(空默认)/2售后。
- 遗留 TODO(已在文档中列出):金蝶账号密码硬编码、SQL 拼接注入风险、OA djbh 关联键待业务确认、SaveDetail 缺事务。
修正:改为按 nav.js 菜单倒推业务需求文档
- 用户反馈上一版写偏(写成技术/接口文档),要求只写业务需求、不写技术实现。
- 依据
View/common/nav.js的【采购管理 › 采购申请管理】4 个菜单项 + 对应页面倒推:- 采购申请管理 → procurement.html / procurement_detail.html / multi_detail.html(单据级,可维护,可导入导出,角色 Purchase01)
- 研发采购看板 → dashboard.html / dashboard_detail.html(物料级,可维护,业务状态多选,仅导出,角色 YF01)
- 研发采购全链路看板 → procurement_board_list.html(32 列宽表,含 PO/RN,只读,列宽可拖)
- 研发订单考核时效看板 → procurement_audit_leadtime.html + l2/l3、receive_l2/l3(两区域×三级下钻)
- 产出:
docs/采购申请管理_功能需求文档.md(已删除上一版全技术向的那份)。 - 项目约定:docs 下已有 01-采购申请管理.md / 02-采购看板.md / 03-采购物料交付状态看板.md / 04-研发采购看板.md,模板为「基本信息/功能说明/配置项/关键接口/变更记录」的开发文档风格;本次用户要的是业务需求文档,风格不同。
- 关键业务口径(需求侧):转单超期 = 最早PO日期 − 项目经理审批时间(无PO用当前日期);到料时效阈值 4/2 天,转单 5/2 天;未收料一律「超高」;基准日期为空不参与考核;负责人为空归「未分配」且排最后。