恩施州数字档案馆系统从零搭建到上线的完整技术指南
一、系统架构设计与技术选型
恩施州数字档案馆系统需要处理大量非结构化数据，同时满足档案管理的合规性要求。我们采用微服务架构，确保系统的可扩展性和可维护性。
1.1 核心服务划分
系统拆分为以下四个核心微服务：
- 档案采集服务：负责接收、校验和预处理上传的档案文件。
- 档案存储服务：管理档案的元数据和实体文件的存储位置。
- 档案检索服务：提供全文检索和条件检索功能。
- 系统管理服务：处理用户、权限和系统配置。
1.2 技术栈确定
- 后端框架：Spring Boot 2.7.15
- 数据库：PostgreSQL 14.9（主数据）+ Elasticsearch 8.11.1（检索）
- 文件存储：MinIO 作为私有化对象存储
- 服务注册与发现：Nacos 2.2.3
- API网关：Spring Cloud Gateway
- 前端框架：Vue 3 + Element Plus
二、开发环境与基础服务搭建
在开始编码前，必须完成所有基础服务的安装和配置。
2.1 开发环境准备
在CentOS 7.9服务器上执行以下命令：
``` 安装Docker和Docker Compose yum install -y yum-utils yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker 安装Docker Compose curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```2.2 基础服务部署
创建docker-compose.yml文件，内容如下：
``` version: '3.8' services: postgres: image: postgres:14.9 environment: POSTGRES_DB: esa_archive POSTGRES_USER: esa_admin POSTGRES_PASSWORD: YourStrong@Pass123 volumes: - ./data/postgres:/var/lib/postgresql/data ports: - "5432:5432" elasticsearch: image: elasticsearch:8.11.1 environment: - discovery.type=single-node - xpack.security.enabled=false - "ES_JAVA_OPTS=-Xms512m -Xmx512m" volumes: - ./data/elasticsearch:/usr/share/elasticsearch/data ports: - "9200:9200" minio: image: minio/minio:RELEASE.2023-10-25T06-33-25Z command: server /data --console-address ":9001" environment: MINIO_ROOT_USER: minioadmin MINIO_ROOT_PASSWORD: minioadmin123 volumes: - ./data/minio:/data ports: - "9000:9000" - "9001:9001" nacos: image: nacos/nacos-server:v2.2.3 environment: - MODE=standalone - PREFER_HOST_MODE=hostname ports: - "8848:8848" volumes: - ./data/nacos/logs:/home/nacos/logs ```执行docker-compose up -d启动所有服务。
三、核心服务开发与配置
3.1 档案采集服务实现
创建Spring Boot项目，添加以下关键依赖到pom.xml：
```配置MinIO连接，在application.yml中添加：
``` minio: endpoint: http://localhost:9000 accessKey: minioadmin secretKey: minioadmin123 bucket: esa-archive-bucket spring: datasource: url: jdbc:postgresql://localhost:5432/esa_archive username: esa_admin password: YourStrong@Pass123 jpa: hibernate: ddl-auto: update show-sql: true ```实现档案上传接口：
``` @RestController @RequestMapping("/api/archive") public class ArchiveCollectController { @Autowired private MinioClient minioClient; @PostMapping("/upload") public ResponseEntity uploadArchive( @RequestParam("file") MultipartFile file, @RequestParam("archiveNo") String archiveNo, @RequestParam("title") String title) { // 1. 文件格式校验 String originalFilename = file.getOriginalFilename(); String fileExtension = originalFilename.substring( originalFilename.lastIndexOf(".")); if (!Arrays.asList(".pdf", ".doc", ".docx", ".jpg", ".png") .contains(fileExtension.toLowerCase())) { return ResponseEntity.badRequest() .body("不支持的文件格式"); } // 2. 文件大小限制（50MB） if (file.getSize() > 50 1024 1024) { return ResponseEntity.badRequest() .body("文件大小不能超过50MB"); } // 3. 上传到MinIO String objectName = UUID.randomUUID() + fileExtension; try { minioClient.putObject( PutObjectArgs.builder() .bucket("esa-archive-bucket") .object(objectName) .stream(file.getInputStream(), file.getSize(), -1) .contentType(file.getContentType()) .build()); } catch (Exception e) { return ResponseEntity.internalServerError() .body("文件上传失败"); } // 4. 保存元数据到数据库 ArchiveMetadata metadata = new ArchiveMetadata(); metadata.setArchiveNo(archiveNo); metadata.setTitle(title); metadata.setFileName(originalFilename); metadata.setStoragePath(objectName); metadata.setUploadTime(LocalDateTime.now()); metadataRepository.save(metadata); return ResponseEntity.ok("档案上传成功"); } } ```3.2 档案存储服务设计
创建档案元数据表：
``` CREATE TABLE archive_metadata ( id BIGSERIAL PRIMARY KEY, archive_no VARCHAR(50) NOT NULL UNIQUE, title VARCHAR(200) NOT NULL, file_name VARCHAR(255) NOT NULL, storage_path VARCHAR(255) NOT NULL, file_size BIGINT, file_type VARCHAR(50), upload_time TIMESTAMP NOT NULL, category VARCHAR(100), security_level VARCHAR(20), retention_years INTEGER, created_by VARCHAR(50), created_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE INDEX idx_archive_no ON archive_metadata(archive_no); CREATE INDEX idx_category ON archive_metadata(category); CREATE INDEX idx_upload_time ON archive_metadata(upload_time); ```3.3 档案检索服务集成
配置Elasticsearch并创建索引：
``` PUT /esa_archive_index { "mappings": { "properties": { "archiveNo": {"type": "keyword"}, "title": { "type": "text", "analyzer": "ik_max_word", "search_analyzer": "ik_smart" }, "content": { "type": "text", "analyzer": "ik_max_word" }, "category": {"type": "keyword"}, "uploadTime": {"type": "date"}, "securityLevel": {"type": "keyword"} } } } ```
实现全文检索接口：
``` @Service public class ArchiveSearchService { @Autowired private RestHighLevelClient elasticsearchClient; public SearchResponse fullTextSearch(String keyword, int page, int size) { SearchRequest searchRequest = new SearchRequest( "esa_archive_index"); SearchSourceBuilder sourceBuilder = new SearchSourceBuilder(); sourceBuilder.query(QueryBuilders.multiMatchQuery(keyword, "title", "content")); sourceBuilder.from((page - 1) size); sourceBuilder.size(size); searchRequest.source(sourceBuilder); try { return elasticsearchClient.search( searchRequest, RequestOptions.DEFAULT); } catch (IOException e) { throw new RuntimeException("检索失败", e); } } } ```四、系统集成与部署上线
4.1 API网关配置
创建Spring Cloud Gateway项目，配置路由规则：
``` spring: cloud: gateway: routes: - id: archive-collect-service uri: lb://archive-collect-service predicates: - Path=/api/archive/ - id: archive-search-service uri: lb://archive-search-service predicates: - Path=/api/search/ discovery: locator: enabled: true ```4.2 服务注册与发现
在每个微服务中添加Nacos依赖和配置：
```在application.yml中配置：
``` spring: cloud: nacos: discovery: server-addr: localhost:8848 namespace: public group: DEFAULT_GROUP ```4.3 生产环境部署
创建生产环境的Dockerfile：
``` FROM openjdk:11-jre-slim WORKDIR /app COPY target/archive-collect-service.jar app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "app.jar"] ```使用Docker Compose编排所有服务：
``` version: '3.8' services: gateway: build: ./gateway ports: - "80:8080" depends_on: - nacos archive-collect: build: ./archive-collect environment: - SPRING_PROFILES_ACTIVE=prod depends_on: - postgres - minio - nacos archive-search: build: ./archive-search depends_on: - elasticsearch 其他服务配置... ```五、系统验证与监控
5.1 功能验证测试
使用Postman或curl测试核心接口：
``` 测试档案上传 curl -X POST http://localhost/api/archive/upload \ -F "file=@/path/to/document.pdf" \ -F "archiveNo=ESA20240001" \ -F "title=恩施州2024年发展规划" 测试档案检索 curl -X GET "http://localhost/api/search?keyword=发展规划&page=1&size=10" ```5.2 系统监控配置
集成Spring Boot Actuator进行健康检查：
```配置监控端点：
``` management: endpoints: web: exposure: include: health,metrics,info endpoint: health: show-details: always ```5.3 日志收集配置
配置Logback日志输出到文件：
```至此，恩施州数字档案馆系统已完成从环境搭建、服务开发到部署上线的全部流程。按照上述步骤操作，可以构建一个稳定、可扩展的数字档案管理系统。
相关文章
