# 运维自救闭环增强 · Release Notes（facts-only）

范围：Admin 端增长闭环与自救闭环（short_links → external_exports → events → funnel），统一 LRQ_FACTS / self_heal / SOP codes，并提供一键入口。

## 关键交付（按 commit）

- `6b30106a`：401/403 自救 facts（auth_required / forbidden）写入最近事件，便于复制交接
- `2b4608e2`：`api_failed` facts 增强（verify/policy/recommended_next）覆盖 404/5xx
- `b206dc28`：501 SQL hint 升级为 `self_heal` facts（db_not_ready + policy/verify）

- `0a0768bf`：external_exports hint invalid → self_heal（可复制）
- `1d659c3d`：external_exports hint empty_result → self_heal（含 city_center_id 上下文提示）
- `7e87c959` / `baea201e` / `9403a4d5`：external_exports self_heal 补齐城市站上下文字段与提示
- `7608a3cd`：external_exports 增加“复制城市站设置说明”（LRQ_CITY_CENTER_ID）

- `db2f4baa`：events 增加“复制导出审计引导”（导出→审计链一键交接）
- `581f477a`：funnel 增加“复制看板摘要（LRQ_FACTS）”与 best-effort 下钻
- `f9f1bb3c`：funnel 下钻映射字典化 + localStorage 可覆盖（LRQ_FUNNEL_DRILLDOWN_MAP_JSON）

- `8e5733fe`：recommended_next 关键自救链路 SOP code 枚举化（401/403/404/5xx/501）
- `268f828c` / `391873dc`：自救索引文档与系统口径对齐
- `3b240089`：external_exports 两类自救 recommended_next 也枚举化为 SOP code

- `2bd34b5d`：新增 `/admin/help_self_heal` 路由，四大入口统一挂载“打开自救索引”
- `7e460277`：`/admin/help_self_heal` 改为从 `docs/OPS_SELF_HEAL_INDEX_V1.md` 读取渲染（SSOT）
- `02affcb9`：`/admin/help_self_heal` 增加“一键复制全文（LRQ_FACTS）”

## 验收清单（3 分钟）

1) `/admin/short_links`：查看 hits → 未就绪时生成 self_heal facts（含 sql_file），可复制
2) `/admin/external_exports`：粘贴无效文本 → invalid_hint self_heal（SOP code）；粘贴有效但 0 条 → empty_result self_heal（SOP code）
3) `/admin/events`：打开活动详情 → “复制导出审计引导” → `/admin/external_exports` 应用 hint 复现口径
4) `/admin/funnel`：复制看板摘要（LRQ_FACTS）→ 点击 count 下钻
5) `/admin/help_self_heal`：页面能打开；能一键复制全文

相关：`docs/OPS_SELF_HEAL_INDEX_V1.md`（自救索引 SSOT）

说明：facts-only；不做收益承诺。

## 2026-03-05 - Events Export -> External Exports Audit Drilldown
- Events exports write external_exports audit records with city_center_id context.
- Export endpoints return `X-External-Export-Id` and `X-External-Export-Drilldown`.
- Events admin page probes headers via `HEAD` and emits `LRQ_FACTS` with export_id + drilldown.
- External exports admin supports `/admin/external_exports?evidenceId=<id>` auto-load and in-page evidence rendering.
- Docs: `docs/UPGRADE_STEPS_vM_EVENTS_EXPORT_AUDIT_DRILLDOWN_V1.md`

## 2026-03-05 - DD Pack (Brand Projects)
- Added DD Pack generator for brand projects using external_exports as disclosure-grade evidence container.
- Supports binding `dd_pack_export_ids` for reproducible packs and shows binding preview on list.
- Self-heal: `docs/OPS_SELF_HEAL_INDEX_V1.md` + `docs/UPGRADE_STEPS_vM_DD_PACK_BRAND_PROJECTS_V1.md`.

## 2026-03-05 - Brand Project Disclosure Updates (M/O)
- Added disclosure updates stream for brand projects (M=material requires evidence export_id).
- Optional auto evidence creation for M updates (`auto_create_export`, kind=`brand_project_update_M_v1`).
- Self-heal: `docs/SQL_BRAND_PROJECT_UPDATES_V1.sql` + docs + gates.

## 2026-03-05 - Capital Projects (Facts-Only)
- Added `capital_projects` admin module for listed-company cooperation (facts-only, no trading).
- Supports external_exports evidence creation and capital DD Pack + M/O disclosure updates.
- Self-heal: SQL + docs + gates.

## 2026-03-05 - Nav Entry: Capital Projects
- Added admin nav entry for `/admin/capital_projects`.


## Women empower final v1
- Entry: `/admin/women_empower`
- SQL: `docs/SQL_WOMEN_ENTREPRENEURS_V1.sql`, `docs/SQL_WOMEN_UPDATES_V1.sql`
- Gate: `bash bin/ci_check_women_empower_final_v1.sh`
- Evidence: external_exports drilldown `/admin/external_exports?evidenceId=`


## City center final v1
- Entries: `/admin/city_resources`, `/admin/city_projects`, `/admin/city_recon`
- Gates: `bash bin/ci_check_city_final_v1.sh`
- Doc: `docs/CITY_CENTER_FINAL_DELIVERY_V1.md`


## Go-live command card v1
- One command acceptance: `bash bin/ci_check_workbench_all_v1.sh`
- Card: `docs/GO_LIVE_COMMAND_CARD_V1.md`


## Patch: recon forward summary + demo recon seed
- Clean recon forward summary init (avoid misleading summaryCounts).
- Repair demo city recon seed LRQ_FACTS template in `docs/SQL_SEED_DEMO_CITY_V1.sql`.


## workbench_all_v2 coverage
- women: workbench + SOP
- city: resources/projects/leads/recon + SOP + UI workbench
- city A/A+: stats/meta/template/leads pipeline + won evidence
- demo assets + city setup wizard
- command: `bash bin/ci_check_workbench_all_v2.sh`