九鼎/OCIM 收口验收清单

# 九鼎/OCIM 最强闭环（收口）验收清单 v1

> 目标：项目 → 模板 → 审计 → 核验 → 导出ZIP → 归档指纹 → 修复闭环

## 0. 前置条件
- 管理员登录（ops/super）
- ZipArchive 可用（建议先跑 `/admin/diag_capital_ops`）

## 1. 九鼎模板包（SSOT）
### 1.1 模板表与预置
- [ ] 执行 SQL：`docs/SQL_CAPITAL_MODE_TEMPLATES_JIUDING_V1.sql`
- [ ] 打开 `/admin/capital_templates`，选择任意 `mode_code` 可看到模板

### 1.2 模板复制进入证据链
- [ ] 在 `/admin/capital_templates` 选中某模板，点击 **复制模板正文**
- [ ] 打开 `/admin/share_cards_audit?q=capital_mode_template_copied` 可看到记录
- [ ] 记录应包含（ctx）：`template_id`、`content_hash`、`mode_code`、`template_kind`

### 1.3 模板核验与热度
- [ ] `/admin/capital_templates` 列表：
  - copy_30d/last_copy（按 template_id 聚合）
  - hot_version（按 template_id 的最热版本，含 verify_url）
- [ ] 点击 hot_version 链接进入 `/admin/share_cards_audit?q=<facts_hash>`

### 1.4 模板包 ZIP（可核验交付）
- [ ] 下载 `/admin/capital_templates_zip.php?mode_code=<mode>`
- [ ] `templates.csv` / `templates.json` 均包含：
  - `content_hash`、`facts_hash`、`verify_url`、`copy_30d`、`last_copy_at`
- [ ] `metrics.json` 含 `top_hot_templates`

## 2. OCIM 项目（SSOT + 项目级证据链）
### 2.1 项目保存写审计
- [ ] 打开 `/admin/ocim_projects` 新建/编辑项目保存
- [ ] `/admin/share_cards_audit?q=ocim_project_saved` 可见记录
- [ ] 该记录应有稳定 `facts_hash` 与 `verify_url`

## 3. 项目交付包（Project Pack ZIP）
### 3.1 一键下载
- [ ] 在 `/admin/ocim_projects` 行内点击 **下载交付包ZIP**
- [ ] ZIP 内包含：
  - `project.json`
  - `templates_snapshot.json / templates_snapshot.csv`（含 content_hash/facts_hash/verify_url）
  - `audit_evidence.csv`（严格按 ctx.capital_project_id 收敛）
  - `VERIFY_INDEX.md`
  - `ACCEPTANCE_CHECKLIST.md`
  - `SETTLEMENT_SCOPE.json`
  - `PACK_MANIFEST.json`（真实 sha1/bytes）
  - `settlement_policy.md`
  - `README.txt`

### 3.2 导出证据链（export_id）
- [ ] `PACK_MANIFEST.json` 含 `export_id`
- [ ] `/admin/share_cards_audit?q=capital_project_pack_downloaded` 记录 ctx 含相同 `export_id`

## 4. 审计运营（chips + 项目检索）
- [ ] `/admin/share_cards_audit` 九鼎 chips 可用：
  - 模板复制/模板保存/项目保存/交付包下载/运营动作
- [ ] chip **按项目ID**：输入 PJ-YYYY-0001 后启动筛项目证据链
- [ ] chip **运营动作**：可快速筛出 `ocim_projects_audit_links_copied` 与 `ocim_project_audit_link_copied`（运营动作入证据链）

## 5. 缺失 project_id 的修复闭环（最终收口门）
### 5.1 发现
- [ ] 若关键事件缺 `capital_project_id`，其 ctx 会带 `warn=missing_capital_project_id`
- [ ] `/admin/share_cards_audit` chip **缺少项目ID** 可筛出

### 5.2 修复并留痕
- [ ] singleOps 中点击 **补写项目ID**：
  - prompt 自动建议（可从 url/title/ctx 提取 PJ-YYYY-0001）
  - 写入修复事件：`capital_project_id_backfill`
  - 自动跳转到 `/admin/share_cards_audit?q=<project_id>` 验收

## 6. 自检
- [ ] `/admin/diag_capital_ops` 全部关键项 OK
- [ ] 运行 smoke（防止 octet-stream / 源码下载回潮）：
  - 基础：`bash bin/smoke_capital_closure_loop_v1.sh https://<你的域名>`
  - 含项目交付包：`bash bin/smoke_capital_closure_loop_v1.sh https://<你的域名> PJ-YYYY-0001`
- [ ] 无 `application/octet-stream` 风险提示（如有，优先检查 BT rewrite 禁用 `location ^~ /admin/`）

---

## 一页入口索引（建议收藏）
- 九鼎中心：`/admin/capital_center`
- 九鼎模板：`/admin/capital_templates`
- 模板包ZIP：`/admin/capital_templates_zip.php?mode_code=financial`
- OCIM项目：`/admin/ocim_projects`
- 项目交付包ZIP：`/admin/capital_project_pack_zip.php?project_id=PJ-YYYY-0001`
- Share-card审计：`/admin/share_cards_audit`
- 资本闭环自检：`/admin/diag_capital_ops`
- 交付索引（对外交付版）：`/admin/capital_delivery_index`

---

## 5分钟快跑（最小闭环串联）
1) 自检：打开 `/admin/diag_capital_ops`（全 OK）
2) smoke（命令行）：
   - `bash bin/smoke_capital_closure_loop_v1.sh https://<你的域名>`（输出 DONE）
3) 建项目：打开 `/admin/ocim_projects` 新建/保存（产生 `ocim_project_saved` 审计）
4) 下载交付包：在项目行点“下载交付包ZIP”（产生 `capital_project_pack_downloaded` 审计 + ZIP 内含 export_id）
5) 核验：
   - 点项目行“审计核验”进入 `/admin/share_cards_audit?q=<project_id>`
   - 或在 ZIP 里打开 `VERIFY_INDEX.md` 的链接逐条核验
6) 若发现缺 project_id：
   - `/admin/share_cards_audit` 点 chip “缺少项目ID”
   - singleOps 点“补写项目ID”→ 自动跳项目视图完成验收