ylsw-bw/business/water-meter/doc/design/功能设计/仪陇表务-功能设计-12-入库管理-V1.0.md

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

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