jiezhoufg/yc_fdjyfluru
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
yc_fdjyfluru/README.md
zjh 50cc133c17 修改:对标流程修改
2025-12-26 09:51:35 +08:00

7.2 KiB
Raw Blame History

数据管理平台用户手册

项目概述

数据管理平台是一个综合性的数据管理系统，主要用于发动机型号数据录入、参数配置管理、审批流程控制、基准报告生成等功能。该平台基于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. 克隆项目

    git clone <项目地址>

  2. 配置数据库

  3. Maven构建

    # 使用single profile构建可执行jar
mvn clean package -Psingle

# 或使用lib profile构建库模式
mvn clean package -Plib

  4. 启动项目

    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 - 获取发起任务列表

系统配置

配置文件

多数据源配置

系统支持配置多个数据源，通过 mpaas.datasource 配置项进行设置。

常见问题

1. Excel导入失败

  • 检查文件格式是否为.xlsx或.xls
  • 确认Excel模板格式是否正确
  • 验证数据是否符合字段要求

2. 审批流程异常

  • 确认审批人配置是否正确
  • 检查工作流配置是否完整
  • 查看系统日志获取详细错误信息

3. 数据库连接问题

  • 检查数据库连接参数
  • 确认数据库服务是否正常运行
  • 验证数据库用户权限

维护说明

日志管理

  • 系统日志文件默认位于 log/xdap-app.log
  • 支持日志级别配置和日志轮转

数据备份

  • 定期备份数据库
  • 保留重要配置文件的备份
  • 建立数据恢复机制

版权声明

本项目为数据管理平台系统，所有权利保留。