从零构建企业级年鉴档案管理系统：技术选型与实战部署

一、系统架构与核心组件

一个完整的年鉴档案管理系统需要处理文档存储、元数据管理、全文检索、权限控制等核心功能。我们采用微服务架构，确保系统可扩展和易维护。

1.1 技术栈选型

以下是经过生产环境验证的技术组合：

• 后端框架: Spring Boot 2.7.18
• 数据库: PostgreSQL 15.3（主数据存储） + Redis 7.2（缓存）
• 文件存储: MinIO（用于文档对象存储）
• 搜索引擎: Elasticsearch 8.12.2（全文检索）
• 前端框架: Vue 3.4 + Element Plus
• 容器化: Docker 24.0 + Docker Compose

1.2 系统架构图

系统采用四层架构：

• 接入层: Nginx反向代理
• 应用层: Spring Boot微服务集群
• 服务层: 数据库、缓存、搜索、存储服务
• 基础设施层: Docker容器平台

二、开发环境搭建

2.1 基础环境安装

使用Docker Compose一键部署所有依赖服务：

创建docker-compose.yml文件：

``` version: '3.8' services: postgres: image: postgres:15.3 environment: POSTGRES_DB: yearbook_archive POSTGRES_USER: admin POSTGRES_PASSWORD: Archive@2024 ports: - "5432:5432" volumes: - postgres_data:/var/lib/postgresql/data redis: image: redis:7.2-alpine ports: - "6379:6379" command: redis-server --requirepass Redis@2024 minio: image: minio/minio:latest ports: - "9000:9000" - "9001:9001" environment: MINIO_ROOT_USER: minioadmin MINIO_ROOT_PASSWORD: minioadmin123 volumes: - minio_data:/data command: server /data --console-address ":9001" elasticsearch: image: elasticsearch:8.12.2 environment: - discovery.type=single-node - xpack.security.enabled=false - "ES_JAVA_OPTS=-Xms512m -Xmx512m" ports: - "9200:9200" volumes: - es_data:/usr/share/elasticsearch/data volumes: postgres_data: minio_data: es_data: ```

启动服务：

``` docker-compose up -d ```

2.2 验证服务状态

执行以下命令检查所有服务是否正常运行：

``` docker-compose ps ```

三、后端服务实现

3.1 项目初始化

使用Spring Initializr创建项目：

``` curl https://start.spring.io/starter.zip \ -d type=maven-project \ -d language=java \ -d bootVersion=2.7.18 \ -d baseDir=yearbook-archive \ -d groupId=com.example \ -d artifactId=yearbook-archive \ -d name=yearbook-archive \ -d description="Yearbook Archive System" \ -d packageName=com.example.yearbook \ -d packaging=jar \ -d javaVersion=17 \ -d dependencies=web,data-jpa,data-redis,validation \ -o yearbook-archive.zip ```

解压后添加依赖到pom.xml：

``` org.springframework.boot spring-boot-starter-data-elasticsearch io.minio minio 8.5.7 org.postgresql postgresql runtime ```

3.2 数据库配置

配置application.yml：

``` spring: datasource: url: jdbc:postgresql://localhost:5432/yearbook_archive username: admin password: Archive@2024 driver-class-name: org.postgresql.Driver jpa: hibernate: ddl-auto: update show-sql: true properties: hibernate: dialect: org.hibernate.dialect.PostgreSQLDialect data: redis: host: localhost port: 6379 password: Redis@2024 database: 0 elasticsearch: uris: http://localhost:9200 minio: endpoint: http://localhost:9000 accessKey: minioadmin secretKey: minioadmin123 bucket: yearbook-files ```

3.3 核心实体设计

创建档案实体类：

``` @Entity @Table(name = "archive_documents") @Document(indexName = "archive_documents") public class ArchiveDocument { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @Column(nullable = false) private String title; @Column(nullable = false) private Integer year; @Column(nullable = false) private String category; @Column(length = 2000) private String description; @Column(nullable = false) private String filePath; @Column(nullable = false) private String fileType; @Column(nullable = false) private Long fileSize; @Column(nullable = false) private String uploadUser; @Column(nullable = false) private LocalDateTime uploadTime; @ElementCollection @CollectionTable(name = "document_tags") private Set tags = new HashSet<>(); // 省略getter/setter } ```

3.4 文件存储服务

实现MinIO文件上传服务：

``` @Service public class FileStorageService { @Value("${minio.endpoint}") private String endpoint; @Value("${minio.accessKey}") private String accessKey; @Value("${minio.secretKey}") private String secretKey; @Value("${minio.bucket}") private String bucket; private MinioClient minioClient; @PostConstruct public void init() { try { minioClient = MinioClient.builder() .endpoint(endpoint) .credentials(accessKey, secretKey) .build(); boolean exists = minioClient.bucketExists( BucketExistsArgs.builder().bucket(bucket).build()); if (!exists) { minioClient.makeBucket(MakeBucketArgs.builder() .bucket(bucket).build()); } } catch (Exception e) { throw new RuntimeException("MinIO初始化失败", e); } } public String uploadFile(MultipartFile file, String objectName) { try { InputStream inputStream = file.getInputStream(); minioClient.putObject( PutObjectArgs.builder() .bucket(bucket) .object(objectName) .stream(inputStream, file.getSize(), -1) .contentType(file.getContentType()) .build() ); return endpoint + "/" + bucket + "/" + objectName; } catch (Exception e) { throw new RuntimeException("文件上传失败", e); } } } ```

3.5 全文检索实现

创建Elasticsearch Repository：

``` @Repository public interface ArchiveSearchRepository extends ElasticsearchRepository { List findByTitleContainingOrDescriptionContaining( String title, String description); List findByYear(Integer year); List findByCategory(String category); @Query("{\"multi_match\": {\"query\": \"?0\", \"fields\": [\"title\", \"description\", \"tags\"]}}") List fullTextSearch(String keyword); } ```

四、前端界面开发

4.1 Vue项目初始化

创建Vue项目并安装依赖：

``` npm create vue@latest yearbook-frontend cd yearbook-frontend npm install element-plus axios vue-router pinia npm install ```

4.2 档案上传组件

创建UploadDocument.vue：

``` ```

4.3 档案搜索组件

创建SearchDocument.vue：

``` ```

五、系统部署与配置

5.1 生产环境配置

创建application-prod.yml：

``` server: port: 8080 servlet: context-path: /api spring: datasource: url: jdbc:postgresql://${DB_HOST:localhost}:5432/yearbook_archive username: ${DB_USER:admin} password: ${DB_PASSWORD:Archive@2024} jpa: hibernate: ddl-auto: validate show-sql: false data: redis: host: ${REDIS_HOST:localhost} password: ${REDIS_PASSWORD:Redis@2024} elasticsearch: uris: http://${ES_HOST:localhost}:9200 minio: endpoint: http://${MINIO_HOST:localhost}:9000 accessKey: ${MINIO_ACCESS_KEY:minioadmin} secretKey: ${MINIO_SECRET_KEY:minioadmin123} logging: level: com.example.yearbook: INFO file: name: logs/yearbook-archive.log logback: rollingpolicy: max-file-size: 10MB max-history: 30 ```

5.2 Docker部署配置

创建Dockerfile：

``` FROM openjdk:17-jdk-slim WORKDIR /app COPY target/yearbook-archive.jar app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "app.jar", "--spring.profiles.active=prod"] ```

创建docker