# 丽人圈运营中心（lrq_empower_cloud_app_v1）操作说明书 V1（facts-only）
定位：这是“能交接、能对账、能自救”的后台操作手册。
原则：
- facts-only：所有关键动作都要能产出可复制的 `LRQ_FACTS`（证据块）
- 合规优先：不做收益承诺，不引导规避监管
- 自救优先：遇到 401/403/404/5xx/501/空结果，先按 SOP code 处理
相关文档：
- 自救索引（SSOT）：`docs/OPS_SELF_HEAL_INDEX_V1.md`
- 本轮变更与验收：`docs/OPS_SELF_HEAL_RELEASE_NOTES.md`
- 里程碑指针：`docs/MILESTONE_OPS_SELF_HEAL_CHAIN.md`
---
## 0. 你是谁（角色与常用入口）
### 0.1 运营同事（默认）
常用入口：
- 控制台：`/admin`
- 线索：`/admin/public_leads`
- 活动：`/admin/events`
- 审计链：`/admin/external_exports`
- 短链：`/admin/short_links`
- 漏斗看板：`/admin/funnel`
- 自救索引：`/admin/help_self_heal`
- Release Notes：`/admin/help_self_heal_release`
### 0.2 城市站负责人（默认包含）
额外关注：
- 城市站上下文：`localStorage.LRQ_CITY_CENTER_ID`
- 对账/审计：external_exports + events 导出
### 0.3 总部管理员（默认包含）
额外关注：
- 部署/升级/SQL 执行
- 权限/Token/合规策略（403）
---
## 1. 登录与 Token（必须先完成）
### 1.1 登录入口
- 后台入口：`/admin`
- 登录页：`/admin/login`
### 1.2 设置 Token（浏览器 localStorage）
- 在任意 admin 页面左侧 Token 区点击“设置”
- 粘贴 Token（通常与 `config.php` 的 `ADMIN_TOKEN` 一致）
### 1.3 常见问题（自救）
- 401：recommended_next = `SOP_AUTH_LOGIN_TOKEN_RETRY`
- 403：recommended_next = `SOP_FORBIDDEN_CHECK_ROLE_POLICY_RETRY`
- 404：recommended_next = `SOP_404_CHECK_ROUTE_DEPLOY_RETRY`
- 5xx：recommended_next = `SOP_5XX_CHECK_SERVER_LOG_RETRY`
- 501：recommended_next = `SOP_501_RUN_SQL_THEN_RETRY`
（详见：`/admin/help_self_heal`）
---
## 2. 自救体系（建议先学会）
### 2.1 两个自救入口
- 自救索引：`/admin/help_self_heal`
- Release Notes：`/admin/help_self_heal_release`
### 2.2 复制证据块（LRQ_FACTS）
你会在多个页面看到：
- “复制最近事件（LRQ_FACTS）”：复制全站最近一次关键 facts（错误/门禁/提示）
- “复制本次操作（LRQ_FACTS）”：复制本页一次操作的事实块（例如 external_exports 的 hint 应用）
- 自救页“复制全文（LRQ_FACTS）”：一键复制整份索引/发行说明
### 2.3 SOP code 速查
以 `recommended_next: <SOP_CODE>` 为准，先按 SOP 做，再找技术。
---
## 3. 城市站上下文（LRQ_CITY_CENTER_ID）
### 3.1 什么时候需要设置
- 城市站审计 / 城市站对账 / 城市站导出链路复现时
### 3.2 如何设置（运营版）
- 打开 `/admin/external_exports`
- 点击按钮：`复制城市站设置说明`
- 按复制内容在控制台执行：
- `localStorage.setItem('LRQ_CITY_CENTER_ID','<数字ID>')`
- 刷新页面
### 3.3 验收
- external_exports 的 self_heal/结果中会出现：
- `current_city_center_id: ...`
- `city_center_id_source: localStorage.LRQ_CITY_CENTER_ID`
---
## 4. short_links（短链增长入口与可观测性）
入口：`/admin/short_links`
### 4.1 你能做什么
- 搜索短链 code/kind
- 查看 hits（可观测性）
- hits 统计 / hits 清理（治理）
### 4.2 hits 表未就绪（最常见自救）
表现：点“查看 hits/访问统计/清理”时提示未就绪。
处理：
1) 复制出现的 self_heal LRQ_FACTS
2) 按其中 `sql_file` 执行 SQL
3) 刷新页面重试
对应 SOP：`SOP_501_RUN_SQL_THEN_RETRY`
---
## 5. external_exports（对外交付审计链）
入口：`/admin/external_exports`
### 5.1 核心概念（运营视角）
- external_exports = 对外可交付/可审计的导出记录
- 你要做的是：用 `q/status/city_center` 复现口径，并把 facts 发给团队对账
### 5.2 使用 hint 一键复现（推荐）
- 在输入框 `external_exports_query_hint` 粘贴 hint
- 点“粘贴并应用”
- 成功后用“复制本次操作（LRQ_FACTS）”发给同事
### 5.3 hint 无效/空结果自救
- invalid_hint：
- `recommended_next: SOP_EXTERNAL_EXPORTS_HINT_PASTE_AND_APPLY`
- empty_result：
- `recommended_next: SOP_EXTERNAL_EXPORTS_EMPTY_RESULT_CHECK_CONTEXT_WIDEN_RETRY`
---
## 6. events（活动 → 导出 → 审计）
入口：`/admin/events`
### 6.1 常用动作
- 创建活动
- 生成匹配/对接清单
- 导出 CSV
### 6.2 导出后如何交接审计（最推荐动作）
在活动详情区：
1) 点击“复制导出审计引导”
2) 把复制出来的 LRQ_FACTS 发给同事
3) 同事打开 `/admin/external_exports` → 粘贴 hint → 应用，即可复现审计口径
---
## 7. funnel（运营漏斗看板）
入口：`/admin/funnel`
### 7.1 你能做什么
- 复制看板摘要（LRQ_FACTS）：用于日报/对账
- 点击 count 下钻到对应页面（leads/events/short_links）
### 7.2 下钻映射可配置（高级）
- 默认规则内置
- 可覆盖：`localStorage.LRQ_FUNNEL_DRILLDOWN_MAP_JSON`
---
## 8. public_leads（线索跟进闭环，facts-only）
入口：`/admin/public_leads`
### 8.1 核心原则
- 线索状态只保留 4 个：NEW / IN_PROGRESS / WON / LOST
- 每次跟进尽量用“快速跟进”生成可复制 facts
### 8.2 常用动作
- 状态…（选择 NEW/IN_PROGRESS/WON/LOST）
- 快速跟进（弹窗填备注 → 提交）
- 复制筛选 URL（含 `LRQ_FACTS(filters)`，用于对账）
---
## 9. 部署/升级/验收（管理员）
入口文档：`docs/DEPLOY_INSTALL_FINAL.md`
### 9.1 新增路由（本轮）
- `/admin/help_self_heal`
- `/admin/help_self_heal_release`
### 9.2 验收（3 分钟）
以 `docs/OPS_SELF_HEAL_RELEASE_NOTES.md` 为准。
---
## 10. 附录：推荐培训顺序（30 分钟）
1) 学会复制 LRQ_FACTS（最近事件 / 本次操作）
2) 学会打开自救索引与 Release Notes
3) short_links：会看 hits + 会自救
4) events：会导出 + 会复制审计引导
5) external_exports：会粘贴 hint 应用 + 会复制本次操作
6) funnel：会复制看板摘要 + 会下钻
7) public_leads：会改状态 + 会快速跟进 + 会复制筛选 URL