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

> 需求来源：`../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-03-*.md`  
> 数据模型：见 [数据库设计-V1.0.md](../数据库设计-V1.0.md)  
> 接口约定：见 [接口文档-V1.0.md](../接口文档-V1.0.md)、[00-总体框架设计-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](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*