From 7f252ad4e0194d0a3abcab9d51e637bfe5d843b2 Mon Sep 17 00:00:00 2001 From: zjh <15615273395@163.com> Date: Tue, 30 Dec 2025 09:42:55 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9:=E5=8F=82=E6=95=B0=E4=BF=AE?= =?UTF-8?q?=E6=94=B9=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 37 +-------- README.md | 229 --------------------------------------------------- 2 files changed, 1 insertion(+), 265 deletions(-) diff --git a/README.en.md b/README.en.md index 4d532eb..d800886 100644 --- a/README.en.md +++ b/README.en.md @@ -1,36 +1 @@ -# 数据管理平台 - -#### Description -{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**} - -#### Software Architecture -Software architecture description - -#### Installation - -1. xxxx -2. xxxx -3. xxxx - -#### Instructions - -1. xxxx -2. xxxx -3. xxxx - -#### Contribution - -1. Fork the repository -2. Create Feat_xxx branch -3. Commit your code -4. Create Pull Request - - -#### Gitee Feature - -1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md -2. Gitee blog [blog.gitee.com](https://blog.gitee.com) -3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore) -4. The most valuable open source project [GVP](https://gitee.com/gvp) -5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help) -6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) +123 \ No newline at end of file diff --git a/README.md b/README.md index 66a722d..9ff1491 100644 --- a/README.md +++ b/README.md @@ -4,232 +4,3 @@ 数据管理平台是一个综合性的数据管理系统，主要用于发动机型号数据录入、参数配置管理、审批流程控制、基准报告生成等功能。该平台基于Spring Boot框架开发，集成了Activiti工作流引擎，支持数据录入、维护、审批等完整的业务流程。 -## 功能架构 - -### 1. 数据录入与引擎模型管理 -- **发动机型号管理**：支持发动机型号的录入、编辑、删除等操作 -- **Excel导入功能**：支持通过Excel批量导入发动机型号数据 -- **型号字段管理**：包括产品型号、产品编号、板块、平台、系列、细分市场、项目名称、项目编号、品牌、排放等信息 - -### 2. 参数与模板配置 -- **参数管理**：管理发动机相关的各类参数信息 -- **模板配置**：配置数据录入模板，支持参数模板的增删改查 -- **参数详情管理**：管理具体参数的详细信息和版本控制 - -### 3. 审批流程控制 -- **Activiti工作流**：基于Activiti引擎实现的审批流程 -- **参数审批**：支持参数修改的审批流程 -- **报告审批**：支持基准报告的审批流程 -- **审批节点配置**：可配置多级审批节点 -- **审批记录**：记录完整的审批过程和结果 - -### 4. 基准报告生成 -- **报告管理**：支持对标报告的创建、编辑、上传 -- **报告审批流程**：集成审批流程的报告管理 -- **文件上传**：支持报告附件上传功能 - -### 5. 待办任务处理 -- **待办中心**：集中管理用户需要处理的审批任务 -- **已办任务**：查看已完成的任务记录 -- **发起任务**：查看用户发起的审批流程 - -### 6. 部门人员管理 -- **部门管理**：管理部门信息和层级关系 -- **人员管理**：管理各部门人员信息 -- **责任人员配置**：配置各部门的责任人 - -## 主要模块说明 - -### 1. 数据录入模块 -- 路径：`/custom/dataEntry` -- 支持模板筛选、列表显示、添加模板、导入模板、查看、下载、版本管理、修改等功能 - -### 2. 引擎型号管理模块 -- 路径：`/custom/dataEntryEngineModel` -- 支持发动机型号的Excel导入功能 -- 管理发动机型号的基本信息 - -### 3. 参数管理模块 -- 路径：`/custom/parameter` -- 管理发动机相关的参数配置 - -### 4. 审批流程模块 -- 路径：`/custom/activitiProcess` -- 处理参数和报告的审批流程 - -### 5. 基准报告模块 -- 路径：`/custom/benchmark` -- 管理对标报告的创建、审批、查看等 - -### 6. 待办任务模块 -- 路径：`/custom/todoTask` -- 管理用户的待办、已办、发起任务 - -## 技术架构 - -### 后端技术栈 -- **Spring Boot 2.2.7.RELEASE**：核心框架 -- **Maven**：项目构建工具 -- **Java 1.8**：开发语言 -- **Lombok**：简化代码 -- **Hutool**：工具库 -- **MongoDB**：数据查询 -- **Activiti**：工作流引擎 -- **Groovy**：编译器集成 - -### 数据库 -- 使用MySQL作为主要数据存储 -- 支持多数据源配置 -- 通过MpaasQuery进行数据访问 - -### 接口规范 -- RESTful API设计 -- 统一的响应格式 -- 基于Response的返回结果封装 - -## 安装部署 - -### 环境要求 -- JDK 1.8 -- Maven 3.5+ -- MySQL 5.7+ -- Redis（可选） - -### 部置步骤 - -1. **克隆项目** - ```bash - git clone <项目地址> - ``` - -2. **配置数据库** - - 修改 [application.properties](file:///D:/JavaProjects/data-management-platform/src/main/resources/application.properties) 文件中的数据库连接信息 - - 执行 [sql.sql](file:///D:/JavaProjects/data-management-platform/src/main/resources/sql.sql) 初始化数据库表结构 - -3. **Maven构建** - ```bash - # 使用single profile构建可执行jar - mvn clean package -Psingle - - # 或使用lib profile构建库模式 - mvn clean package -Plib - ``` - -4. **启动项目** - ```bash - java -jar target/data-management-platform.jar - ``` - -## 使用指南 - -### 1. 发动机型号管理 - -#### 添加发动机型号 -1. 访问数据录入模块 -2. 可通过Excel导入或手动添加发动机型号 -3. 填写型号信息包括：产品型号、产品编号、板块、平台、系列等 -4. 提交后系统会自动为该型号绑定所有参数模板 - -#### Excel导入 -- 支持批量导入发动机型号数据 -- 需按照指定的Excel模板格式填写数据 -- 上传后系统会自动验证数据格式和重复性 - -### 2. 参数管理 - -#### 参数维护 -1. 选择具体的发动机型号 -2. 查看该型号绑定的参数列表 -3. 可编辑参数值、版本信息等 -4. 修改后需要提交审批 - -### 3. 审批流程 - -#### 发起审批 -1. 在参数编辑完成后，点击发起审批 -2. 系统会生成审批修改说明 -3. 选择审批流程和审批人 -4. 提交审批请求 - -#### 处理审批任务 -1. 在待办任务中查看需要处理的审批 -2. 查看审批详情和修改内容 -3. 选择通过、拒绝或转交操作 -4. 填写审批意见 - -### 4. 基准报告管理 - -#### 创建报告 -1. 进入基准报告模块 -2. 填写报告基本信息 -3. 上传报告文件 -4. 保存为草稿或提交审批 - -#### 报告审批 -1. 选择需要审批的报告 -2. 按照预设流程进行审批 -3. 查看审批进度和历史记录 - -## API接口 - -### 数据录入相关 -- `GET /custom/dataEntry/getTemplateByCondition` - 模板条件查询 -- `GET /custom/dataEntry/getParameterByCondition` - 参数条件查询 -- `POST /custom/dataEntryEngineModel/excelImport` - Excel导入发动机型号 - -### 审批流程相关 -- `POST /custom/activitiProcess/initiateApproval` - 发起参数审批 -- `POST /custom/activitiProcess/handleApproval` - 处理审批 -- `GET /custom/activitiProcess/getApprovalProcess` - 获取审批流程 - -### 报告管理相关 -- `POST /custom/benchmark/uploadFile` - 上传文件 -- `POST /custom/benchmark/insertReport` - 创建报告 -- `POST /custom/benchmark/updateReport` - 更新报告 -- `GET /custom/benchmark/getReportDetail` - 获取报告详情 - -### 任务管理相关 -- `GET /custom/todoTask/getTodoTaskList` - 获取待办任务列表 -- `GET /custom/todoTask/getCompletedTaskList` - 获取已办任务列表 -- `GET /custom/todoTask/getInitiatedTaskList` - 获取发起任务列表 - -## 系统配置 - -### 配置文件 -- [application.properties](file:///D:/JavaProjects/data-management-platform/src/main/resources/application.properties) - 主配置文件 -- [application-s.properties](file:///D:/JavaProjects/data-management-platform/src/main/resources/application-s.properties) - 服务配置文件 - -### 多数据源配置 -系统支持配置多个数据源，通过 `mpaas.datasource` 配置项进行设置。 - -## 常见问题 - -### 1. Excel导入失败 -- 检查文件格式是否为.xlsx或.xls -- 确认Excel模板格式是否正确 -- 验证数据是否符合字段要求 - -### 2. 审批流程异常 -- 确认审批人配置是否正确 -- 检查工作流配置是否完整 -- 查看系统日志获取详细错误信息 - -### 3. 数据库连接问题 -- 检查数据库连接参数 -- 确认数据库服务是否正常运行 -- 验证数据库用户权限 - -## 维护说明 - -### 日志管理 -- 系统日志文件默认位于 `log/xdap-app.log` -- 支持日志级别配置和日志轮转 - -### 数据备份 -- 定期备份数据库 -- 保留重要配置文件的备份 -- 建立数据恢复机制 - -## 版权声明 - -本项目为数据管理平台系统，所有权利保留。 \ No newline at end of file