railwaysystem/docs/reports/archive/20260915/deployment-report.md

RailwaySystem 部署与发布准备度报告

文档定位：记录目标环境部署、Nginx 反向代理配置、生产数据库迁移执行状态及服务健康检查结果。 基线版本：Final Candidate 5a49b2e2988bf23ca2a70568264c05b24dfda1b6 (origin/feat/cicd-pipeline) 发布增量基线：CURRENT_RELEASE_DB_DELTA = 3 当前部署状态：⏳ PENDING (等待最终测试门禁收敛后统一执行部署)

---

1. 目标发布环境规格

flowchart TD
    subgraph Env["生产目标环境 (8092/8082)"]
        FE["前端 Web (Nginx 静态托管)<br/>端口 8082<br/>健康检查: HTTP 200"]
        BE["后端 API (Spring Boot)<br/>端口 8092<br/>健康检查: GET /login"]
        DB[("国产主库 KingbaseES<br/>端口 4321 / 54321<br/>健康检查: Druid连接池")]
        RD[("缓存 Redis<br/>端口 6379<br/>健康检查: AUTH & PING")]

        FE -->|/prod-api 代理| BE
        BE --> DB
        BE --> RD
    end

服务组件	部署端口	运行载体	环境健康检查目标	准备状态
后端 API 服务	8092	Spring Boot 2.5 (JAR)	GET /login -> HTTP 200	⏳ PENDING
前端 Web 交互	8082	Nginx 1.20+ (静态承载)	HTTP 200 访问正常	⏳ PENDING
国产主数据库	4321	KingbaseES 8.6.0	JDBC 连接池探测正常 (Druid)	✅ 就绪
会话与缓存服务	6379	Redis 6.2+	AUTH & PING -> PONG	✅ 就绪

---

2. 数据库迁移准备度与增量核实

1. 增量 Delta 脚本就绪情况：
   • 001_sys_oper_log_cost_time.sql —— 消耗时间字段补齐（就绪）
   • 002_legacy_analytics_permissions.sql —— 分析权限对齐（就绪）
   • 003_report_attendance_action_permissions.sql —— 报到与考勤写操作权限（就绪）
2. 安全红线核实：
   • 确认生产发布中严禁执行 007_dicts.sql，避免字典主键唯一性碰撞。

---

3. 部署验证检查清单 (Deployment Checklist)

• 后端 JAR 包编译打包无误（mvn clean package -DskipTests）
• 目标端口 8092 进程无冲突占用
• 前端打包产物构建无报错（npm run build:prod）
• Nginx 反向代理配置加载完成（/api 代理至 8092）
• 初始超级管理员账号 admin 登录鉴权通过

---

4. 技术参考链接 (Technical References)

• 部署与发布手册：docs/handbook/08-deployment-and-release.md
• 发版说明：release-notes.md
• 最终测试综合报告：final-test-report.md