# 丽人圈运营中心 · 运维自救索引（facts-only）

目标：当后台出现 401/403/501/空结果/提示看不懂时，团队能用同一套“可复制事实块（LRQ_FACTS）+ 下一步”快速自救与对账。

## 一、最常见问题（按优先级）

### 1) 401（未登录/Token 失效）
- 表现：页面跳转到 `/admin/login` 或接口返回 401
- recommended_next（SOP）：`SOP_AUTH_LOGIN_TOKEN_RETRY`
- 推荐动作：
  - 登录后台 / 重新设置 Token
  - 重试刚才动作
- 证据：复制“最近事件（LRQ_FACTS）”即可

### 2) 403（权限不足）
- 表现：弹出“权限不足（403）”
- recommended_next（SOP）：`SOP_FORBIDDEN_CHECK_ROLE_POLICY_RETRY`
- 推荐动作：
  - 检查角色 / 合规策略 / 路由权限
  - 重试
- 证据：弹窗内容即 LRQ_FACTS（可复制）

### 3) 501（数据库/功能未就绪）
- 表现：接口返回 501，`LRQ_FACTS` 中会包含 `sql_file: ...`
- recommended_next（SOP）：`SOP_501_RUN_SQL_THEN_RETRY`
- 推荐动作：
  - 执行 `sql_file` 指向的 SQL
  - 刷新页面
  - 重试操作

## 二、模块级自救

### A. short_links · hits 表未就绪
- 页面：`/admin/short_links`
- 入口：查看 hits / hits 统计 / hits 清理
- 自救 facts：会生成 `action: self_heal`，并包含
  - `case: short_links_hits_table_missing`
  - `sql_file: sql/UPGRADE_v669_short_link_hits.sql`

### B. external_exports · hint 应用失败 / 无结果
- 页面：`/admin/external_exports`
- 入口：粘贴并应用 hint
- invalid_hint：
  - `case: external_exports_query_hint_not_found`
  - recommended_next（SOP）：`SOP_EXTERNAL_EXPORTS_HINT_PASTE_AND_APPLY`
- empty_result：
  - `case: external_exports_no_rows_after_hint`
  - recommended_next（SOP）：`SOP_EXTERNAL_EXPORTS_EMPTY_RESULT_CHECK_CONTEXT_WIDEN_RETRY`
  - `city_center_id_source: localStorage.LRQ_CITY_CENTER_ID`

### C. 城市站审计上下文（LRQ_CITY_CENTER_ID）
- 页面：`/admin/external_exports`
- 入口：按钮“复制城市站设置说明”
- 推荐：城市站审计时先设置 `localStorage.LRQ_CITY_CENTER_ID` 再筛选/应用 hint。

## 三、3 分钟验收路径（后台）

1) `/admin/short_links` 点“查看 hits” → 表未就绪时生成 self_heal facts（含 sql_file）
2) `/admin/external_exports` 粘贴无效文本 → invalid_hint self_heal facts
3) `/admin/events` 查看活动 → 点“复制导出审计引导” → 到 `/admin/external_exports` 应用 hint
4) `/admin/funnel` 点“复制看板摘要（LRQ_FACTS）” + 点击 count 下钻

---

## 四、SOP code 速查

- `SOP_AUTH_LOGIN_TOKEN_RETRY`：打开登录页/设置 token → 重试
- `SOP_FORBIDDEN_CHECK_ROLE_POLICY_RETRY`：检查角色/策略 → 重试
- `SOP_404_CHECK_ROUTE_DEPLOY_RETRY`：检查路由/部署版本是否一致 → 重试
- `SOP_5XX_CHECK_SERVER_LOG_RETRY`：查看服务端错误日志（Nginx/PHP/MySQL）→ 修复后重试
- `SOP_501_RUN_SQL_THEN_RETRY`：执行提示的 SQL → 刷新页面 → 重试
- `SOP_EXTERNAL_EXPORTS_HINT_PASTE_AND_APPLY`：把 `external_exports_query_hint:` 那一行（或完整 LRQ_FACTS）粘贴到 hint 输入框 → 点“粘贴并应用”
- `SOP_EXTERNAL_EXPORTS_EMPTY_RESULT_CHECK_CONTEXT_WIDEN_RETRY`：检查 `LRQ_CITY_CENTER_ID` 上下文 → 放宽 status/q → 重试
- `SOP_RETRY`：直接重试（用于不确定/偶发失败）

相关：`docs/OPS_SELF_HEAL_RELEASE_NOTES.md`（本轮变更与验收清单）

说明：本索引不做收益承诺；只用于运维、对账与可追溯的事实记录。


## Events 导出→审计 Drilldown
- 目的：导出生成 external_exports 证据记录，并用 export_id 一键 drilldown 取证（静音展示）。
- 文档：`docs/UPGRADE_STEPS_vM_EVENTS_EXPORT_AUDIT_DRILLDOWN_V1.md`
- 一键门禁：`bash bin/ci_ops_events_exports_external_audit_drilldown_v1.sh`
- Drilldown：`/admin/external_exports?evidenceId=<export_id>`


## DD Pack（品牌项目）
- 入口：`/admin/brand_projects` -> 生成DD Pack
- 文档：`docs/UPGRADE_STEPS_vM_DD_PACK_BRAND_PROJECTS_V1.md`
- 门禁：`bash bin/ci_check_brand_projects_dd_pack_v1.sh` + `bash bin/ci_check_brand_projects_dd_pack_bind_exports_v1.sh` + `bash bin/ci_check_brand_projects_dd_pack_binding_visible_v1.sh`


## 披露更新（品牌项目）
- 文档：`docs/UPGRADE_STEPS_vM_BRAND_PROJECT_DISCLOSURE_UPDATES_V1.md`
- SQL：`docs/SQL_BRAND_PROJECT_UPDATES_V1.sql`
- 门禁：`bash bin/ci_check_brand_projects_updates_v1.sh`

- 自动证据：M 更新可勾选 auto_create_export（kind=brand_project_update_M_v1），仍保持 M=证据硬规则。


## 披露节奏（品牌项目）
- 文档：`docs/UPGRADE_STEPS_vM_BRAND_PROJECT_DISCLOSURE_RHYTHM_V1.md`
- 门禁：`bash bin/ci_check_brand_projects_updates_stats_v1.sh`


## 资本合作项目中心
- 文档：`docs/UPGRADE_STEPS_vM_CAPITAL_PROJECTS_V1.md`
- SQL：`docs/SQL_CAPITAL_PROJECTS_V1.sql`
- 门禁：`bash bin/ci_check_capital_projects_v1.sh`


## 资本项目披露（DD Pack）
- 文档：`docs/UPGRADE_STEPS_vM_CAPITAL_PROJECTS_DISCLOSURE_V1.md`
- SQL：`docs/SQL_CAPITAL_PROJECT_UPDATES_V1.sql`
- 门禁：`bash bin/ci_check_capital_projects_disclosure_v1.sh`


## 女性创业赋能中心
- 入口：`/admin/women_empower`
- 文档：`docs/UPGRADE_STEPS_vM_WOMEN_EMPOWER_M1_TEMPLATES_V1.md`
- 门禁：`bash bin/ci_check_women_empower_m1_v1.sh`

- WOMEN_EMPOWER_M2: `docs/UPGRADE_STEPS_vM_WOMEN_EMPOWER_M2_ENTREPRENEURS_V1.md`

- WOMEN_EMPOWER_M1_1: `docs/UPGRADE_STEPS_vM_WOMEN_EMPOWER_M1_1_INDUSTRIES_V1.md`

- WOMEN_EMPOWER_M3: `docs/UPGRADE_STEPS_vM_WOMEN_EMPOWER_M3_UPDATES_RHYTHM_V1.md`


### Women empower 501 self-heal
- `women_entrepreneurs_not_ready` / `women_playbooks_not_ready` -> run `docs/SQL_WOMEN_ENTREPRENEURS_V1.sql`
- `women_updates_not_ready` -> run `docs/SQL_WOMEN_UPDATES_V1.sql`


## 城市资源池
- 入口：`/admin/city_resources`
- SQL：`docs/SQL_CITY_RESOURCES_V1.sql`
- 文档：`docs/UPGRADE_STEPS_CITY_RESOURCES_M1_V1.md`
- 门禁：`bash bin/ci_check_city_resources_m1_v1.sh`


## 城市项目池
- 入口：`/admin/city_projects`
- SQL：`docs/SQL_CITY_PROJECTS_V1.sql`
- 文档：`docs/UPGRADE_STEPS_CITY_PROJECTS_M2_V1.md`
- 门禁：`bash bin/ci_check_city_projects_m2_v1.sh`


## 城市对账中心
- 入口：`/admin/city_recon`
- SQL：`docs/SQL_CITY_RECON_V1.sql`
- 文档：`docs/UPGRADE_STEPS_CITY_RECON_M3_V1.md`
- 门禁：`bash bin/ci_check_city_recon_m3_v1.sh`


## Final Delivery Workbench
- `docs/FINAL_DELIVERY_WORKBENCH_INDEX_V1.md`

- CITY_A1_RECON_STATS: `docs/UPGRADE_STEPS_CITY_A1_RECON_STATS_V1.md`

- CITY_A2_PROJECT_META: `docs/UPGRADE_STEPS_CITY_A2_PROJECT_UPDATE_META_CITY_CENTER_V1.md`

- CITY_A3_RECON_TEMPLATE: `docs/UPGRADE_STEPS_CITY_A3_RECON_TEMPLATE_VALIDATION_V1.md`


## 城市线索池
- 入口：`/admin/city_leads`
- SQL：`docs/SQL_CITY_LEADS_V1.sql`
- 文档：`docs/UPGRADE_STEPS_CITY_LEADS_A_PLUS_1_V1.md`
- 门禁：`bash bin/ci_check_city_leads_a_plus_1_v1.sh`

- CITY_A_PLUS_2_LEADS_STATS: `docs/UPGRADE_STEPS_CITY_A_PLUS_2_LEADS_STATS_V1.md`


## Self-heal Quickref
- `docs/SELF_HEAL_QUICKREF_V1.md`

- CITY_RECON_STATS_SSOT: `docs/CITY_RECON_STATS_SSOT_V1.md`