develop: T02b 部署参数修正——服务端口9182→9280（客户确认）。conf/config.json(server.port/databases.hrs测试库test/test123/Redis会话确认)；deploy/hr-web.service端口同步；deploy/nginx-hrstest.conf反代样例(→127.0.0.1:9280,预留certbot)；architecture.md §7补记+deploy-change-record-T02b.md；dev-notes-T02b.md。其余设计基线不变

2026-08-21 00:08:20 +08:00 · 2026-08-21 00:08:20 +08:00 · c884c1e6d7
commit c884c1e6d7
parent 8ce20fee58
6 changed files with 157 additions and 0 deletions
--- a/conf/config.json
+++ b/conf/config.json
@ -0,0 +1,48 @@
+{
+  "_comment": "hr-web 运行配置（测试环境）。T02b 变更：服务端口 9182→9280（客户确认，见 docs/部署环境需求.md）；databases.hrs 按测试环境本机 MariaDB；Redis 会话配置确认沿用。",
+  "server": {
+    "host": "0.0.0.0",
+    "port": 9280,
+    "name": "hr-web"
+  },
+  "processors": {
+    ".tmpl": "bricks.processor.tmpl",
+    ".ui": "bricks.processor.ui",
+    ".dspy": "ahserver.processor.dspy"
+  },
+  "databases": {
+    "hrs": {
+      "type": "mysql",
+      "host": "127.0.0.1",
+      "port": 3306,
+      "database": "hrs",
+      "user": "test",
+      "password": "test123",
+      "charset": "utf8mb4",
+      "pool_size": 10,
+      "pool_recycle": 3600,
+      "_comment": "测试环境 MariaDB 本机监听；V001__init_hrs.sql（49表）已在测试库执行"
+    }
+  },
+  "redis": {
+    "host": "127.0.0.1",
+    "port": 6379,
+    "db": 0,
+    "session": {
+      "enabled": true,
+      "session_max_time": 28800,
+      "session_issue_time": 86400,
+      "prefix": "hrweb:sess:"
+    },
+    "_comment": "Redis 会话：session_max_time=8h 会话有效期，session_issue_time=24h 签发有效期，与基线口径一致"
+  },
+  "log": {
+    "level": "INFO",
+    "file": "logs/hr-web.log",
+    "max_size_mb": 50,
+    "backup_count": 10
+  },
+  "static": {
+    "path": "static"
+  }
+}
--- a/deploy/hr-web.service
+++ b/deploy/hr-web.service
@ -0,0 +1,22 @@
+# hr-web systemd unit（测试环境 hrstest.opencomputing.cn）
+# T02b 变更：服务端口 9182→9280（客户确认，见 docs/部署环境需求.md 与 docs/01-design/architecture.md §7）
+# 安装：sudo cp hr-web.service /etc/systemd/system/ && sudo systemctl daemon-reload && sudo systemctl enable --now hr-web
+[Unit]
+Description=hr-web 人事系统 Web 服务 (ahserver, port 9280)
+After=network.target mariadb.service redis.service
+Wants=mariadb.service redis.service
+
+[Service]
+Type=simple
+User=hrstest
+Group=hrstest
+WorkingDirectory=/opt/hrs
+Environment=PYTHONUNBUFFERED=1
+ExecStart=/opt/hrs/venv/bin/python -m ahserver --config /opt/hrs/conf/config.json
+Restart=always
+RestartSec=5
+# 端口 9280 探活（监控基线项）
+ExecStartPost=/bin/sh -c 'sleep 2 && ss -ltn | grep -q ":9280 "'
+
+[Install]
+WantedBy=multi-user.target
--- a/deploy/nginx-hrstest.conf
+++ b/deploy/nginx-hrstest.conf
@ -0,0 +1,36 @@
+# Nginx 反代配置样例 —— 测试环境 hrstest.opencomputing.cn
+# T02b：反代后端已由 127.0.0.1:9182 修正为 127.0.0.1:9280（客户确认端口变更）
+# 部署位置：/etc/nginx/conf.d/hrstest.conf（实际远程部署留待部署任务执行）
+# HTTPS：预留 certbot --nginx 自动改写（执行后 certbot 会新增 listen 443 ssl 块、
+#       注入 ssl_certificate/ssl_certificate_key，并在 80 块加 301 跳转，勿手工预写证书路径）
+
+server {
+    listen 80;
+    listen [::]:80;
+    server_name hrstest.opencomputing.cn;
+
+    # 上传/附件体积上限（合同附件、花名册导入等场景预留）
+    client_max_body_size 50m;
+
+    # 访问/错误日志
+    access_log /var/log/nginx/hrstest.access.log;
+    error_log  /var/log/nginx/hrstest.error.log;
+
+    location / {
+        proxy_pass http://127.0.0.1:9280;
+        proxy_http_version 1.1;
+        proxy_set_header Host              $host;
+        proxy_set_header X-Real-IP         $remote_addr;
+        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        # WebSocket / 长连接预留（消息通道、审批待办推送）
+        proxy_set_header Upgrade    $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_read_timeout 300s;
+    }
+}
+
+# ── certbot 操作备忘（部署任务执行时）────────────────────────────
+# sudo certbot --nginx -d hrstest.opencomputing.cn
+# certbot 会自动改写本文件为 443/ssl 配置并配置 80→443 跳转
+# MariaDB(3306)/Redis(6379) 仅本机/内网监听，不经 Nginx 暴露
--- a/docs/01-design/architecture.md
+++ b/docs/01-design/architecture.md
@ -292,3 +292,7 @@ staff-mgr 是 v1 Java 口径下的员工 CRUD 模块（已通过端到端验证
 | ui-design.md | v3.0 | 页面结构、组件树、路由表、核心交互流程、降级项交互说明 |
 | iteration1-task-breakdown.md | v2.0 | 可行性分析、风险、开发任务拆解（T01~T27，面向 develop 角色可直接建任务） |
 | feature-list.md | v2.1 | F01~F17 功能清单与 FEAT-B1 映射（批次1范围基线） |
+
+## §7 部署章节补记（T02b 端口变更）
+
+> **变更记录（批次1-T02b）**：应用服务端口由设计基线 **9182** 修正为 **9280**（客户确认，确认时间 2025-08，补记日期 2026-08）。同步修改：conf/config.json（server.port）、deploy/hr-web.service（systemd unit）、deploy/nginx-hrstest.conf（反代 upstream 127.0.0.1:9280，server_name hrstest.opencomputing.cn，预留 certbot --nginx）。其余设计基线（架构分层、49 表、113 端点、32 路由、27 任务、90 验收项）不变。详见 `docs/01-design/deploy-change-record-T02b.md`。
--- a/docs/01-design/deploy-change-record-T02b.md
+++ b/docs/01-design/deploy-change-record-T02b.md
@ -0,0 +1,25 @@
+# 部署设计变更记录（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）等均不变。
--- a/docs/02-develop/dev-notes-T02b.md
+++ b/docs/02-develop/dev-notes-T02b.md
@ -0,0 +1,22 @@
+# 开发记录 T02b：脚手架部署参数修正（端口 9280）
+
+> 迭代：人事系统-初始迭代｜批次1-T02b｜角色：agent.develop
+> 前置：T01/T02 已完成（49 表 models JSON + hr-web 脚手架 + V001__init_hrs.sql 已在测试库执行）
+
+## 1. 变更内容
+| 文件 | 变更 |
+|---|---|
+| `conf/config.json` | 新增/修正：`server.port` 9182→**9280**；`databases.hrs` 按测试环境（127.0.0.1:3306 本机 MariaDB，库 hrs，用户 test/test123，utf8mb4，pool 10）；Redis 会话配置确认（enabled，session_max_time=28800/session_issue_time=86400，沿用基线口径）；processors .tmpl/.ui/.dspy 保留 |
+| `deploy/hr-web.service` | systemd unit：描述与启动后端口探活同步为 9280；User=hrstest，WorkingDirectory=/opt/hrs，依赖 mariadb/redis，Restart=always |
+| `deploy/nginx-hrstest.conf` | 反代样例：server_name hrstest.opencomputing.cn → proxy_pass 127.0.0.1:9280；含 WebSocket 头、client_max_body_size 50m、certbot --nginx 自动改写备忘（勿手工预写证书路径） |
+| `docs/01-design/architecture.md` | §7 部署章节追加补记段落：端口 9182→9280（客户确认 2025-08，补记 2026-08），声明其余设计基线不变 |
+| `docs/01-design/deploy-change-record-T02b.md` | 新增变更记录全文（变更前后对照、影响范围、同步修改清单、基线冻结声明） |
+
+## 2. 验证记录
+- `conf/config.json` JSON 语法校验通过（python json.load OK），`server.port=9280`。
+- systemd unit 与 nginx 样例中端口引用全量核对为 9280，无 9182 残留。
+- 登录走通验证（admin + 组织专员/薪酬专员/招聘专员/部门主管四角色）：依赖测试环境 MariaDB/Redis 与 rbac 权限初始化数据，属部署任务（webapp-remote-deploy）远程执行项；本任务交付物已满足 9280 启动所需全部配置（venv/ahserver --config conf/config.json），远程冒烟留待部署任务出截图/日志。
+
+## 3. 遗留/移交
+- 远程部署（SSH hrstest.opencomputing.cn，/opt/hrs，certbot 证书）→ 移交部署任务。
+- apps/hr-web.md §3/§4 端口清单中 9182 口径，下次文档修订时同步为 9280（本任务按"不改其余基线"约束未动该文件）。