# App Knowledge Catalog

本目录保存移动端和全平台 App 生产可上线相关的外挂知识候选。Codex 会话应先读本 catalog，再判断是否需要读取完整规范文件；不要把完整长文档作为默认上下文。

## 查询顺序

1. 当前任务涉及移动端 App、H5 / WebView、Hybrid、小程序、上架审核、支付、隐私、安全、灰度、回滚、生产发布或移动端 QA 时，先读本文件。
2. 需要完整 Release Gate、测试矩阵或行业案例时，再读取对应规范文件。
3. 如果当前项目已有 PRD、架构约束、测试矩阵或合规规则，以项目事实为准；本目录只作为补充检查和 checklist 来源。

## 条目索引

| ID | Type | Maturity | Title | Tags | Path |
| --- | --- | --- | --- | --- | --- |
| FRAMEWORK-APP-READINESS-001 | framework | draft | Mobile App Production Readiness Framework：移动端全平台生产可上线规范与宠物商城行业案例 | mobile-app, release-gate, qa, privacy, security, app-store, ecommerce, pet-commerce | `docs/external-knowledge/app/Mobile_App_Production_Readiness_Framework_移动端全平台生产可上线规范.md` |

## 适用阶段

| 阶段 | 推荐用途 |
| --- | --- |
| analysis | 识别平台范围、隐私合规、商店审核、支付、行业高风险边界 |
| design | 补齐 App 生命周期、权限、离线弱网、灰度回滚、可观测性和后台治理要求 |
| plan | 拆分 iOS、Android、H5 / WebView、小程序、服务端、后台、QA、安全和合规任务 |
| implement | 检查生产包、SDK、权限、WebView、Deep Link、支付、数据同步等实现边界 |
| review | 作为 Stage Review 的移动端生产可上线 checklist，但 `draft` 内容不能单独作为阻塞依据 |
| verify | 生成 Release Gate、真机矩阵、支付/退款、隐私、安全、灰度和回滚证据清单 |

## 使用边界

- 本目录内容初始为 `draft`，只能作为启发和检查清单，不能覆盖当前项目 truth source。
- 涉及法律、医疗、兽药、活体交易、跨境数据、儿童、金融等高风险事项时，必须由项目法务或合规负责人确认。
- 宠物商城内容是行业案例，不代表所有电商 App 的默认要求；非宠物行业只复用通用移动端框架部分。
- 后续如果拆分为独立条目，应保留本 catalog 作为长文档入口，并把可验证规则提炼成短条目。
