Files
GX.O3.WMS/WebApi/.workbuddy/memory/2026-10-09.md
T

25 lines
2.8 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 个菜单项 + 对应页面倒推:
1. 采购申请管理 → procurement.html / procurement_detail.html / multi_detail.html(单据级,可维护,可导入导出,角色 Purchase01)
2. 研发采购看板 → dashboard.html / dashboard_detail.html(物料级,可维护,业务状态多选,仅导出,角色 YF01)
3. 研发采购全链路看板 → procurement_board_list.html(32 列宽表,含 PO/RN,只读,列宽可拖)
4. 研发订单考核时效看板 → 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 天;未收料一律「超高」;基准日期为空不参与考核;负责人为空归「未分配」且排最后。