From 5b372fb8a235293c4838306eb777be389196ce6d Mon Sep 17 00:00:00 2001
From: Nexus Agent <nexus@local>
Date: Sun, 7 Jun 2026 20:19:31 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20Layer=203=20=E5=B7=A1=E6=A3=80=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E7=94=9F=E4=BA=A7=E9=AA=8C=E8=AF=81=E6=8A=A5=E5=91=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 ...26-06-07-ops-patrol-deploy-verification.md | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 docs/reports/2026-06-07-ops-patrol-deploy-verification.md

diff --git a/docs/reports/2026-06-07-ops-patrol-deploy-verification.md b/docs/reports/2026-06-07-ops-patrol-deploy-verification.md
new file mode 100644
index 00000000..5a3a8a21
--- /dev/null
+++ b/docs/reports/2026-06-07-ops-patrol-deploy-verification.md
@@ -0,0 +1,57 @@
+# 生产验证 — Layer 3 宿主机巡检 Telegram 打通
+
+**日期**: 2026-06-07  
+**Commit**: `f9934bd` — feat(ops-patrol): Layer 3 巡检与 Telegram 配置打通  
+**环境**: https://api.synaglobal.vip
+
+## 部署
+
+| 项 | 结果 |
+|----|------|
+| 门控 | 7/7 PASS |
+| push | `66a4cba..f9934bd main → main` |
+| deploy-production | ✓ Docker 重建，容器 healthy |
+| 远程版本 | `f9934bd` |
+
+## 健康检查
+
+| 检查 | 结果 |
+|------|------|
+| `GET /health` | `ok` |
+| `GET /app/` | HTTP 200 |
+| 外网 HTTPS | HTTP 200 |
+
+## Layer 3 巡检
+
+| 检查 | 结果 |
+|------|------|
+| crontab `nexus-health-monitor` | ✓ 已安装（部署脚本自动 `install_ops_cron.sh`） |
+| `health_monitor.sh` 手动执行 | exit 0 |
+| `/var/log/nexus_health.log` | 空（/health 正常，无告警写入） |
+
+## Telegram / env 同步
+
+| 检查 | 结果 |
+|------|------|
+| DB `telegram_bot_token` | 未配置 |
+| DB `telegram_chat_id` | 未配置 |
+| `/app/.env` NEXUS_TELEGRAM_* | 未写入 |
+| `read_telegram_env_status()` | `env_synced: false` |
+
+**说明**: 生产尚未在设置页配置 Telegram；配置并保存后应自动 sync，或点「同步巡检 Telegram」。未 sync 时 `health_monitor.sh` 可通过 MySQL 回退（需 DB 有值）。
+
+## API
+
+| 端点 | 未认证 |
+|------|--------|
+| `GET /api/settings/ops-patrol/status` | 401（预期） |
+
+## 待用户终验
+
+1. 登录设置页 → 配置 Telegram → 确认 Layer 3 区块显示「巡检 Telegram 就绪」
+2. 点「同步巡检 Telegram」→ `.env 已同步`
+3. （可选）临时停容器验证 Telegram 重启告警
+
+## 结论
+
+**部署成功**；cron 与 health_monitor 已就绪。Telegram 告警需用户在 UI 配置后终验。