DM-ROW 接口文档

Appearance

个人库存表结构 ​

**本文档引用的文件** - [device.sql](file://docs/ddl/device.sql) - [store.sql](file://docs/ddl/store.sql) - [workflow.sql](file://docs/ddl/workflow.sql)

目录 ​

  1. 简介
  2. 项目结构
  3. 核心组件
  4. 架构概览
  5. 详细组件分析
  6. 依赖关系分析
  7. 性能考虑
  8. 故障排除指南
  9. 结论

简介 ​

本文档详细描述了个人库存管理相关的数据库架构，重点涵盖以下核心表结构：

  • 个人借用申请表：personal_apply_borrow_orders 及其明细 personal_apply_borrow_order_detail
  • 个人归还申请表：personal_part_return_orders 及其明细 personal_part_return_order_detail
  • 个人报损申请表：personal_report_damage_orders 及其明细 personal_report_damage_order_detail
  • 个人调拨申请表：personal_transfer_orders 及其明细 personal_transfer_order_detail_detail
  • 个人物品清单表：personal_part_store

该架构支持完整的个人物品生命周期管理，包括借用审批、归还确认、损坏处理、转移登记等功能，并实现了与公共库存系统的区分管理。

项目结构 ​

基于代码库分析，个人库存相关的数据库对象主要分布在以下文件中：

图表来源

章节来源

核心组件 ​

个人借用申请系统 ​

个人借用申请系统包含主表和明细表两个层次，支持完整的借用流程管理：

图表来源

个人归还申请系统 ​

个人归还申请系统提供完整的归还流程管理，支持好品和坏品分类：

图表来源

个人报损申请系统 ​

个人报损申请系统支持损坏物品的完整处理流程：

图表来源

个人调拨申请系统 ​

个人调拨申请系统支持物品在不同用户间的转移管理：

图表来源

个人物品清单系统 ​

个人物品清单系统提供每个用户的物品持有情况跟踪：

图表来源

章节来源

架构概览 ​

个人库存管理系统采用分层架构设计，通过主表-明细表的关联模式实现完整的业务流程管理：

图表来源

该架构实现了以下关键特性：

  1. 流程化管理：所有重要操作都通过工作流进行审批
  2. 数据完整性：通过外键约束确保数据一致性
  3. 可追溯性：完整的审计日志记录所有操作
  4. 权限控制：基于用户和仓库的权限管理

详细组件分析 ​

数据模型设计原则 ​

个人库存系统遵循以下设计原则：

  1. 唯一性约束：每个表都有相应的唯一性约束确保数据唯一性
  2. 索引优化：针对常用查询字段建立索引提高查询性能
  3. 序列管理：使用序列号确保主键的唯一性和连续性
  4. 逻辑删除：通过is_delete字段实现软删除功能

关键业务流程 ​

借用申请流程 ​

图表来源

归还确认流程 ​

图表来源

权限控制机制 ​

系统通过以下方式实现权限控制：

  1. 仓库权限表：store_permission 表管理用户对仓库的访问权限
  2. 用户角色：通过工作流用户表管理审批权限
  3. 工厂级别控制：所有操作都绑定到具体的工厂编号

章节来源

依赖关系分析 ​

个人库存系统与其他模块的依赖关系如下：

图表来源

章节来源

性能考虑 ​

索引策略 ​

系统在关键查询字段上建立了适当的索引以优化查询性能：

  • 个人物品清单表：user_no 字段建立索引
  • 报损单据表：damage_order_no 字段建立索引
  • 调拨单据表：多个用户相关字段建立索引

查询优化建议 ​

  1. 批量操作：对于大量数据的查询，建议使用分页查询
  2. 条件过滤：优先使用索引字段进行WHERE条件过滤
  3. 连接优化：合理使用JOIN操作，避免N+1查询问题

故障排除指南 ​

常见问题及解决方案 ​

  1. 序列号冲突

    • 症状：插入数据时报序列号冲突错误
    • 解决方案：检查序列号生成器的状态，必要时重新初始化

  2. 权限不足

    • 症状：用户无法访问特定仓库或执行特定操作
    • 解决方案：检查store_permission表中的权限配置

  3. 数据一致性问题

    • 症状：个人物品清单与实际库存不一致
    • 解决方案：检查工作流审批状态和库存更新日志

章节来源

结论 ​

个人库存管理系统通过精心设计的数据库架构，实现了完整的个人物品生命周期管理。系统具有以下优势：

  1. 完整的业务覆盖：涵盖了借用、归还、报损、调拨等所有核心业务场景
  2. 严格的流程控制：通过工作流实现审批流程的标准化管理
  3. 完善的权限体系：基于用户、仓库、工厂的多层次权限控制
  4. 良好的扩展性：模块化的表结构设计便于后续功能扩展

该架构为个人物品管理提供了可靠的技术支撑，能够满足复杂业务场景下的各种需求。