# 仪陇表务 — 功能设计 12 入库管理 V1.0

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

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 12 |
| 模块名称 | 入库管理 |
| 后端包（建议） | `com.tofly.wm.manage.inventory.in` |
| 业务模式 | 登记直办 |
| 工单 | 可关联退库/调拨工单 REF |

## 2. 功能范围

- 总仓入库
- 总仓入库确认
- 分仓入库
- 退库入库登记

## 3. 数据模型

### 3.1 涉及表

- `wssmet_invin_w`
- `wssmet_invinmeter_w`
- `wssmet_invconfirm_w`
- `wssmet_stnreturnin_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. 核心业务规则

- IN_TYPE 字典区分场景

## 6. 接口设计（概要）

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/inventoryIn/` | 见 PRD 界面 |
| — | `/inventoryConfirm/` | 见 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_*` 表名），**不参照**存量业务表与接口。*