26 lines
2.0 KiB
Markdown
26 lines
2.0 KiB
Markdown
# 部署设计变更记录（architecture.md §7 部署章节补记）
|
||
|
||
> 任务：批次1-T02b 脚手架部署参数修正。本文件为 architecture.md §7 部署章节的补充记录，
|
||
> 按"不改其余设计基线"约束以补记形式归档；architecture.md §7 引用本记录。
|
||
|
||
## 变更项：应用服务端口 9182 → 9280
|
||
|
||
| 项 | 变更前（设计基线） | 变更后（客户确认） |
|
||
|---|---|---|
|
||
| ahserver/hr-web 服务端口 | 9182 | **9280** |
|
||
| Nginx 反代 upstream | 127.0.0.1:9182 | 127.0.0.1:9280 |
|
||
| systemd unit 说明/探活端口 | 9182 | 9280 |
|
||
| 监控探活端口 | 9182 | 9280 |
|
||
|
||
- **变更原因**：客户最新部署参数与既有脚手架基线不一致，客户确认测试环境服务端口使用 9280（见 `docs/部署环境需求.md`，客户 2025-08 会话确认）。
|
||
- **变更日期**：客户确认于 2025-08；本任务（T02b）落实配置与文档修正，记录日期 2026-08。
|
||
- **影响范围**：仅部署参数（端口），**不改变**架构分层、49 表数据设计、113 端点/32 路由/27 任务等设计基线。
|
||
- **同步修改清单**：
|
||
1. `conf/config.json` → `server.port = 9280`；`databases.hrs` 按测试环境配置（host 127.0.0.1 本机 MariaDB，库 hrs，用户 test/test123）；Redis 会话配置（session_max_time/session_issue_time）确认沿用基线口径。
|
||
2. `deploy/hr-web.service` → systemd unit 描述与端口探活同步为 9280。
|
||
3. `deploy/nginx-hrstest.conf` → 反代样例 server_name hrstest.opencomputing.cn → 127.0.0.1:9280，预留 certbot --nginx 自动改写 HTTPS。
|
||
- **apps/hr-web.md 口径说明**：该应用文档 §3/§4 端口清单中 9182 为任务下达时口径，客户确认版以本记录（9280）为准，后续文档修订时同步更新。
|
||
|
||
## 不变项（设计基线冻结声明）
|
||
架构分层、模块划分、数据设计（49 表/V001__init_hrs.sql）、API 设计（113 端点）、路由（32）、任务（27）、验收项（90）等均不变。
|