R79 收口公网部署与治理事实源

docs/architecture.md

@@ -1,12 +1,22 @@
 # hyb-oa 系统架构概览
 
-**版本**：1.2  
-**日期**：2026-02-09  
-**目的**：描述系统当前实现（P5/F25 完备态）并为未来演进提供参考。
+**版本**：1.3  
+**日期**：2026-05-04  
+**目的**：描述系统当前实现、当前部署基线和仍待外部环境闭环的部分，为试运行与后续演进提供参考。
 
 **相关文档**：
 - [需求规格说明书](./requirements-specification.md)
-- [实现状态矩阵（P5-P10）](./feature-matrix.md)
+- [实现状态矩阵](./feature-matrix.md)
+- [试运行覆盖矩阵](../artifacts/r75/coverage-matrix.csv)
+- [人工试运行报告](../artifacts/r70/manual-trialrun-report.md)
+
+**2026-05-04 已核实部署基线**：
+- 公网入口：`https://oa.hyinda.com`
+- 反向代理：`caddy`，当前配置为 `oa.hyinda.com -> reverse_proxy 127.0.0.1:3000`
+- 部署用户：`deploy`（常规） / `root`（系统配置），`shunli` 当前不可免密登录
+- 部署目录：`/opt/hyb-oa-trialrun`
+- 部署方式：本地执行 `deploy/trialrun/deploy.sh`，通过 `rsync` 同步到远端；远端目录不是 git 工作树
+- 容器编排：脚本兼容 `docker compose` 与 `docker-compose`，当前服务器实际为 `docker-compose 1.29.2`
 
 ---
 
@@ -21,7 +31,7 @@ graph TB
   end
 
   subgraph Cluster["部署环境 (Docker Compose Profiles)"]
-    Proxy["可选：Nginx/Caddy\nTLS/反代/前端托管"]
+    Proxy["Caddy\nTLS/反代/前端托管"]
     
     subgraph Server_Nodes["计算层"]
       API["Fastify API\n(JOBS_ENABLED=false)"]
@@ -54,9 +64,10 @@ graph TB
 ```
 
 **关键变更说明**：
-- **Worker 进程独立**：支持通过 `docker compose --profile worker` 拆分 API 与定时作业进程。
+- **Worker 进程独立**：支持通过 `docker compose --profile worker` 或 `docker-compose --profile worker` 拆分 API 与定时作业进程。
 - **存储抽象层**：适配本地文件系统与 S3/MinIO，通过 `STORAGE_DRIVER` 切换。
 - **治理接入**：内置 Prometheus 指标采集 `/metrics`。
+- **远端发布模型**：当前生产化试运行通过 `deploy/trialrun/deploy.sh` 从本地 `rsync` 到服务器，不依赖远端 `git pull`。
 
 ---