# RailwaySystem 部署与发布准备度报告

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

---

## 1. 目标发布环境规格

```mermaid
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 脚本就绪情况**：
   - [x] `001_sys_oper_log_cost_time.sql` —— 消耗时间字段补齐（就绪）
   - [x] `002_legacy_analytics_permissions.sql` —— 分析权限对齐（就绪）
   - [x] `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](../handbook/08-deployment-and-release.md)
* 发版说明：[release-notes.md](release-notes.md)
* 最终测试综合报告：[final-test-report.md](final-test-report.md)