竣工资料交付系统

# 竣工资料交付系统核心内容总结
## 一、立项背景与目标
### 立项背景
铁路传统档案管理存在四大痛点：纸质化管理效率低、存储成本高；档案分散形成信息孤岛，跨单位协同困难；纸质档案易损毁丢失，电子档案缺乏统一管控，不符合《档案法》等合规要求；传统检索耗时，档案价值难以挖掘。为响应国家档案数字化战略与铁路智能化转型需求开发。

### 核心目标
实现档案数字化，解决纸质档案存储与检索难题；内置铁路行业标准元数据与模板，实现档案标准化管理；通过分布式检索与在线审批提升协同效率；覆盖档案从上传到验收移交的全生命周期电子化管理。

## 二、软件功能与核心模块
系统包含七大功能模块，支持4类角色分级权限：超级管理员拥有全部权限，项目管理员、施工单位管理员、普通用户权限逐级限定于所属项目/单位。
- **可视化大屏**：展示全项目文档状态、数量、模板使用、周完成量及实时上传记录，提供全局数据概览。
- **档案管理（基础核心）**：包含档案列表、我的文件、操作记录、回收站，支持本地上传、在线新建Word/Excel三种方式归档，可查看文件关联的检验批数据。
- **验收记录模板**：按专业分类管理验收模板，支持上传、下载与预览，为数字化加工提供标准依据。
- **数字化加工（业务核心）**：按"检验批→分项→分部→单位工程"倒序生成各级验收记录，可从档案库关联支撑数据，自动复用历史数据。
- **工序镜像**：管理铁路施工各工序照片，支持新增工序、上传带元数据的施工照片，可导出拼版后的工序资料。
- **系统设置**：完成项目、专业、单位工程、档案目录、部门、施工单位及用户的基础配置与权限分配。

## 三、核心业务流程与功能路径
1. **系统初始化**：超级管理员通过【系统设置】新增项目→配置专业与单位工程→维护档案目录→添加部门与施工单位→创建用户并分配权限。
2. **模板准备**：管理员进入【验收记录模板】，按专业上传对应验收记录表模板。
3. **档案归集**：用户登录后经大屏进入系统，在【档案管理】选择对应类目，上传各类工程档案文件并提交归档。
4. **验收记录生成**：进入【数字化加工】，选择项目层级，调用模板生成验收记录，从档案库关联支撑数据，保存后逐级生成上一级验收文件。
5. **工序资料管理**：在【工序镜像】新增工序步骤，上传包含施工单位、拍摄信息的工序照片，按需导出拼版资料。
6. **数据统计**：通过【档案统计】查看各项目/专业/单位工程的档案上传进度与柱状图统计，或通过可视化大屏获取全局数据。

# 竣工资料交付系统 整体架构与设计思路
## 一、技术架构定位
项目为**竣工资料交付系统后端服务**，基于 **Spring Boot 2.7.5 + JDK1.8** 开发，Maven构建，采用Spring生态**分层架构**，是面向工程档案数字化管理的企业级Java Web应用。
## 二、核心架构分层
1. **基础框架层**
Spring Boot Web提供MVC服务，AOP实现日志、事务、权限解耦，支持JAR/WAR打包部署。
2. **数据持久化层**
采用MyBatis-Plus操作MySQL，Druid高性能连接池，实现工程档案数据高效存储与管理。
3. **安全认证层**
Spring Security + CAS单点登录 + JWT令牌，结合Redis分布式会话，实现多角色权限管控与跨系统登录。
4. **缓存与消息层**
Redis做数据缓存，RabbitMQ消息队列实现异步处理，提升系统并发性能与模块解耦能力。
5. **通用工具层**
整合Hutool、Lombok等工具库，搭配参数校验框架，简化开发、保障数据合法性。
6. **核心业务层（档案专属）**
基于Apache POI、poi-tl、OnlyOffice等组件，实现Word/Excel文档的上传、在线编辑、预览、模板生成、导出，完美适配竣工资料交付核心业务。
## 三、整体设计思路
以**竣工资料数字化管理**为核心，采用分层架构设计；依托Spring Boot生态快速开发，通过分布式缓存、消息队列保障高可用；重点强化**文档处理、权限管控**能力，适配工程档案全生命周期业务，支持集群部署，扩展性与稳定性满足企业级应用需求。