From 00b4f8ea541f862067cf0e298b73b7652f9c9960 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=BC=A0=E6=80=A1=E8=93=89?= <377046077@qq.com>
Date: Tue, 20 May 2025 09:48:57 +0800
Subject: [PATCH] =?UTF-8?q?=E7=9B=AE=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/main/java/com/ruoyi/api/readme.md     | 19 ++++++++++++++++
 .../src/main/java/com/ruoyi/bas/readme.md     | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/device/readme.md  | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/in/readme.md      | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/job/readme.md     | 21 ++++++++++++++++++
 .../src/main/java/com/ruoyi/kpi/readme.md     | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/out/readme.md     | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/pda/readme.md     | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/search/readme.md  | 20 +++++++++++++++++
 .../src/main/java/com/ruoyi/stock/readme.md   | 22 +++++++++++++++++++
 10 files changed, 202 insertions(+)
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/api/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/bas/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/device/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/in/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/job/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/kpi/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/out/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/pda/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/search/readme.md
 create mode 100644 ruoyi-admin/src/main/java/com/ruoyi/stock/readme.md

diff --git a/ruoyi-admin/src/main/java/com/ruoyi/api/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/api/readme.md
new file mode 100644
index 0000000..8eba455
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/api/readme.md
@@ -0,0 +1,19 @@
+# API目录说明
+
+## 目录用途
+存放API相关配置文件和接口模块
+
+## 主要功能
+- 提供系统对外的API接口定义
+- 存放API相关的配置文件
+- 管理接口的版本控制
+- 处理API的认证和授权
+
+## 目录结构
+```
+api/
+├── config/         # API配置文件
+├── controller/     # API控制器
+├── model/          # API数据模型
+└── service/        # API业务逻辑
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/bas/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/bas/readme.md
new file mode 100644
index 0000000..20fc6b2
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/bas/readme.md
@@ -0,0 +1,20 @@
+# 基础（Base）功能目录说明
+
+## 目录用途
+存放系统基础功能和公共库相关代码
+
+## 主要功能
+- 提供系统基础功能实现
+- 管理公共组件和工具类
+- 处理基础数据结构和通用业务逻辑
+- 维护系统公共配置和常量定义
+
+## 目录结构
+```
+bas/
+├── common/         # 通用工具类和公共组件
+├── config/         # 基础配置文件
+├── constant/       # 常量定义
+├── model/          # 基础数据模型
+└── service/        # 基础业务逻辑
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/device/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/device/readme.md
new file mode 100644
index 0000000..1306bc5
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/device/readme.md
@@ -0,0 +1,20 @@
+# 设备管理目录说明
+
+## 目录用途
+存放设备管理相关的代码和配置文件
+
+## 主要功能
+- 管理仓库内各类设备信息
+- 处理设备状态监控
+- 设备维护和保养记录
+- 设备故障诊断和处理
+
+## 目录结构
+```
+device/
+├── config/         # 设备配置文件
+├── controller/     # 设备控制器
+├── model/          # 设备数据模型
+├── service/        # 设备业务逻辑
+└── utils/          # 设备相关工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/in/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/in/readme.md
new file mode 100644
index 0000000..88b5dc2
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/in/readme.md
@@ -0,0 +1,20 @@
+# 入库单据目录说明
+
+## 目录用途
+存放入库相关的业务代码和配置文件
+
+## 主要功能
+- 处理商品入库业务流程
+- 管理入库单据信息
+- 处理入库质检和验收
+- 入库数据统计和分析
+
+## 目录结构
+```
+in/
+├── config/         # 入库配置文件
+├── controller/     # 入库控制器
+├── model/          # 入库数据模型
+├── service/        # 入库业务逻辑
+└── utils/          # 入库相关工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/job/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/job/readme.md
new file mode 100644
index 0000000..5c39ab3
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/job/readme.md
@@ -0,0 +1,21 @@
+# 入出库作业目录说明
+
+## 目录用途
+存放入出库作业相关的业务代码和配置文件
+
+## 主要功能
+- 处理入库作业流程
+- 处理出库作业流程
+- 管理作业任务分配
+- 作业进度跟踪和监控
+- 作业数据统计分析
+
+## 目录结构
+```
+job/
+├── config/         # 作业配置文件
+├── controller/     # 作业控制器
+├── model/          # 作业数据模型
+├── service/        # 作业业务逻辑
+└── utils/          # 作业相关工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/kpi/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/kpi/readme.md
new file mode 100644
index 0000000..c327ebb
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/kpi/readme.md
@@ -0,0 +1,20 @@
+# 数据报表图示目录说明
+
+## 目录用途
+存放数据统计分析和报表展示相关的代码
+
+## 主要功能
+- 生成各类业务数据报表
+- 数据可视化图表展示
+- 业务指标统计分析
+- 数据趋势监控和预警
+
+## 目录结构
+```
+kpi/
+├── config/         # 报表配置文件
+├── controller/     # 报表控制器
+├── model/          # 报表数据模型
+├── service/        # 报表业务逻辑
+└── utils/          # 报表工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/out/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/out/readme.md
new file mode 100644
index 0000000..2a7742e
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/out/readme.md
@@ -0,0 +1,20 @@
+# 出库单据目录说明
+
+## 目录用途
+存放出库相关的业务代码和配置文件
+
+## 主要功能
+- 处理商品出库业务流程
+- 管理出库单据信息
+- 处理出库复核和交接
+- 出库数据统计和分析
+
+## 目录结构
+```
+out/
+├── config/         # 出库配置文件
+├── controller/     # 出库控制器
+├── model/          # 出库数据模型
+├── service/        # 出库业务逻辑
+└── utils/          # 出库相关工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/pda/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/pda/readme.md
new file mode 100644
index 0000000..8c1e043
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/pda/readme.md
@@ -0,0 +1,20 @@
+# 移动终端（PDA）目录说明
+
+## 目录用途
+存放移动终端专用的业务代码和配置文件
+
+## 主要功能
+- 处理PDA设备交互逻辑
+- 管理移动端数据同步
+- 处理离线操作和数据缓存
+- 移动端界面适配和优化
+
+## 目录结构
+```
+pda/
+├── config/         # PDA配置文件
+├── controller/     # PDA控制器
+├── model/          # PDA数据模型
+├── service/        # PDA业务逻辑
+└── utils/          # PDA相关工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/search/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/search/readme.md
new file mode 100644
index 0000000..3a9e565
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/search/readme.md
@@ -0,0 +1,20 @@
+# 查询统计目录说明
+
+## 目录用途
+存放查询统计相关的业务代码和配置文件
+
+## 主要功能
+- 提供系统各类数据查询功能
+- 处理复杂的统计分析需求
+- 管理查询条件和结果缓存
+- 优化查询性能和响应时间
+
+## 目录结构
+```
+search/
+├── config/         # 查询配置文件
+├── controller/     # 查询控制器
+├── model/          # 查询数据模型
+├── service/        # 查询业务逻辑
+└── utils/          # 查询工具类
+```
\ No newline at end of file
diff --git a/ruoyi-admin/src/main/java/com/ruoyi/stock/readme.md b/ruoyi-admin/src/main/java/com/ruoyi/stock/readme.md
new file mode 100644
index 0000000..51201f5
--- /dev/null
+++ b/ruoyi-admin/src/main/java/com/ruoyi/stock/readme.md
@@ -0,0 +1,22 @@
+# 库存管理系统目录说明
+
+## 目录用途
+存放库存管理系统相关的业务代码和配置文件
+
+## 主要功能
+- 库存查询和统计
+- 库存调整和盘点
+- 库存预警管理
+- 库存移动追踪
+- 库存报表生成
+- 库存分析和预测
+
+## 目录结构
+```
+stock/
+├── config/         # 库存系统配置文件
+├── controller/     # 库存控制器
+├── model/          # 库存数据模型
+├── service/        # 库存业务逻辑
+└── utils/          # 库存相关工具类
+```
\ No newline at end of file