系统应用说明(统一介绍,仅事实)

版本:doc:SYSTEM_OVERVIEW_AND_HOW_TO_USE_V1.md
# 丽人圈运营中心 · 系统应用说明(统一介绍)V1(facts-only)

这份文档用于“对外/对内统一介绍”:系统是什么、解决什么问题、怎么用、怎么验收、出了问题怎么自救。

核心原则:facts-only(只记录事实与交付),合规优先(不做收益承诺),闭环优先(可追溯、可对账、可复现)。

---

## 1. 这套系统是什么

丽人圈运营中心是一套“增长入口 + 线索沉淀 + 活动运营 + 交付审计 + 自救体系”的轻量后台。

你可以把它理解为:
- **前台**:把报名/咨询/活动/需求做成可复制的事实记录(LRQ_FACTS)
- **后台**:把线索跟进、活动导出、交付审计、短链可观测性做成闭环
- **自救**:任何不正常都能复制 facts(SOP code)交接,不靠口头描述

---

## 2. 解决的核心问题(业务视角)

1) 增长入口不“口口相传”
- 通过 short_links + UTM + 前台落地页,来源可追溯。

2) 线索不丢、可跟进、可对账
- 前台报名/咨询进入 public_leads,后台统一状态/跟进。

3) 活动不是一次性
- events 支持导出与审计引导,活动成为对接场景。

4) 交付不靠记忆
- external_exports 把导出/交付变成可审计记录,能复现口径。

5) 出问题也能推进
- self_heal + SOP codes(401/403/404/5xx/501/空结果/无效 hint)

---

## 3. 系统地图(你应该去哪)

### 3.1 前台入口(Public)
- 首页:`/`
- 栏目页:`/col?k=...`
  - 报名/咨询:`/col?k=signup`
  - 活动:`/col?k=events`
  - 活动筛选(可分享):`/col?k=events_public`
  - 需求大厅:`/col?k=demands_hall`
  - 证书核验:`/col?k=verify`
  - 前台验收:`/col?k=front_acceptance`

### 3.2 后台入口(Admin)
- 控制台:`/admin`
- 操作说明书:`/admin/help_manual`
- 自救索引:`/admin/help_self_heal`
- Release Notes:`/admin/help_self_heal_release`
- DB 就绪检查:`/admin/diag_db`

关键业务页:
- 线索:`/admin/public_leads`
- 活动:`/admin/events`
- 审计链:`/admin/external_exports`
- 短链:`/admin/short_links`
- 漏斗:`/admin/funnel`

---

## 4. 30 分钟上手(建议按这个顺序)

1) 打开 `/admin/help_manual` 了解全局
2) 学会复制 LRQ_FACTS
- “复制最近事件(LRQ_FACTS)”
- “复制本次操作(LRQ_FACTS)”
3) short_links:会看 hits + 会自救
4) events:会导出 + 会复制导出审计引导
5) external_exports:会粘贴 hint 应用 + 会复制本次操作
6) public_leads:会改状态 + 会快速跟进 + 会复制筛选 URL
7) funnel:会复制看板摘要 + 会下钻

---

## 5. 最关键的闭环(标准动作)

### 5.1 前台报名/咨询 → 线索跟进
- 前台:`/col?k=signup` 提交
- 后台:`/admin/public_leads`
  - 状态:NEW/IN_PROGRESS/WON/LOST
  - 快速跟进:填备注 → 生成 LRQ_FACTS(可复制)

### 5.2 活动 → 导出 → 审计复现
- 后台:`/admin/events`
  - 导出 CSV
  - 点击“复制导出审计引导”
- 审计复现:`/admin/external_exports` 粘贴 hint → 应用 → 复制本次操作

### 5.3 短链 → hits → 自救
- 后台:`/admin/short_links`
  - 查看 hits / 统计 / 清理
  - 未就绪会给 self_heal facts + sql_file

---

## 6. 验收(3 分钟)

以 `docs/OPS_SELF_HEAL_RELEASE_NOTES.md` 为准。

推荐路径:
1) `/admin/diag_db`:确认核心表 OK(或按 need_sql 执行 SQL)
2) `/admin/short_links`:查看 hits 自救路径
3) `/admin/external_exports`:invalid/empty hint 自救路径
4) `/admin/events`:导出→审计引导
5) `/admin/help_self_heal`:能打开并复制全文

---

## 7. 出问题怎么自救(统一口径)

看 `recommended_next` 的 SOP code(不要口头描述“打不开/不正常”):
- `SOP_AUTH_LOGIN_TOKEN_RETRY`
- `SOP_FORBIDDEN_CHECK_ROLE_POLICY_RETRY`
- `SOP_404_CHECK_ROUTE_DEPLOY_RETRY`
- `SOP_5XX_CHECK_SERVER_LOG_RETRY`
- `SOP_501_RUN_SQL_THEN_RETRY`
- `SOP_EXTERNAL_EXPORTS_HINT_PASTE_AND_APPLY`
- `SOP_EXTERNAL_EXPORTS_EMPTY_RESULT_CHECK_CONTEXT_WIDEN_RETRY`

入口:`/admin/help_self_heal`

---

## 8. 这套系统不做什么(合规边界)

- 不做收益承诺、不保证成交/上涨
- 不收集身份证/银行卡/验证码/交易口令等敏感信息
- 短链只允许同域跳转(防开放跳转风险)

---

## 9. 相关文档

- 操作说明书(全量):`docs/USER_MANUAL_OPS_CENTER_V1.md`
- 自救索引(SSOT):`docs/OPS_SELF_HEAL_INDEX_V1.md`
- Release Notes:`docs/OPS_SELF_HEAL_RELEASE_NOTES.md`
- 系统体检建议:`docs/SYSTEM_AUDIT_RECOMMENDATIONS_V1.md`
🏠