ylsw-bw/business/water-meter/doc/design/功能设计/仪陇表务-功能设计-03-采购管理-V1.0.md

# 仪陇表务 — 功能设计 03 采购管理 V1.0

需求来源：../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-03-*.md
数据模型：见 数据库设计-V1.0.md
接口约定：见 接口文档-V1.0.md、00-总体框架设计-V1.0.md

1. 模块概述

项	说明
模块序号	03
模块名称	采购管理
后端包（建议）	com.tofly.wm.manage.puachase
业务模式	申请工单+计划直办
工单	PURCHASE_APPLY，四级审批

2. 功能范围

• 采购申请
• 采购计划
• 到货登记

3. 数据模型

3.1 涉及表

• wssmet_purapply_w
• wssmet_purapplylist_w
• wssmet_purplan_w
• wssmet_purplanarr_w
• wssmet_purplanarrlist_w

3.2 实体约定

• 所有实体 extends BaseEntity；逻辑删除 Boolean deleted ↔ deleted。
• 字典 DictEntry + @DictDirectory(MeterConstant.*) ↔ 库列 VARCHAR2；组织/用户 OrganizationEntry/UserNameEntry ↔ 库列 NUMBER(19)；附件 FileEntryList/FileEntry 用 @TableField(exist = false)，无库列。
• 申请类主表含 process_instance_id / work_order_code / approve_status；工单反查 （无本地表，见 workflow）.TABLE_NAME + TABLE_ID。

4. 业务流程

申请→四级审批→自动生成计划→履约/到货→创建 Meter(待落地检)。

5. 核心业务规则

• 终审按厂家/口径/类型/分公司拆分计划
• 到货附件为 FileEntryList，@TableField(exist = false)，无库列

6. 接口设计（概要）

方法	路径（示例前缀）	说明
—	/purchaseApply/	见 PRD 界面
—	/purchaseApply/page	见 PRD 界面
—	/purchasePlan/	见 PRD 界面
—	/purchasePlan/arrive	见 PRD 界面

• 标准 CRUD 另含：GET /page、GET /list、POST /update、DELETE /{id}、DELETE /deleteByIds。
• 返回体：ResultResponse<T>。

7. 权限与数据范围

遵循 PRD-02：菜单角色 + 组织数据权限 + 工单岗位权限；具体角色见 PRD-04 各功能「菜单权限」「数据权限」章节。

8. 上下游依赖

上游	下游
见 PRD-03 流程说明	见 PRD-01 总体主流程

---

本设计仅依据 ../demand/ PRD 与 数据库设计-V1.0.md；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*