# Issues

文件版的 issue 追踪（参考 GitHub Issues 模型）。每条 issue = 一个 md 文件，内含正文 + 评论 sections。

## 约定

- **文件名**：`<编号 3 位补零>-<英文 slug>.md`，例如 `001-second-server-for-testing.md`
- **frontmatter**：`id` / `title` / `status` / `labels` / `assignee` / `created_at` / `closed_at`
- **status**：`open` / `in_progress` / `closed`
- **评论**：文件里 `## 讨论` 段下按时间顺序 append，格式 `### YYYY-MM-DD HH:MM @<作者>`
- **归档**：`status: closed` 后可 `mv` 到 `archive/`；文件名保留编号
- **编号**：全项目单调递增，open 和 archive 共用编号空间

## 当前 open / in_progress

按优先级分组（P0 > P1 > P2 > P3 > tech-debt），详见 [blueprints/production-readiness.md](../blueprints/production-readiness.md)。

### P0 合规红线（不做无法对外运营）

| # | 标题 | status | created |
|---|---|---|---|
| [009](009-real-name-verification.md) | 实名认证（身份证 OCR + 人脸比对） | open | 2026-04-23 |
| [010](010-data-lifecycle-compliance.md) | 数据生命周期合规（注销 / 导出） | open | 2026-04-23 |
| [011](011-legal-docs.md) | 用户协议 + 隐私政策 + 相亲特有条款 | open | 2026-04-23 |
| [012](012-icp-compliance-check.md) | ICP 增值电信许可核实（EDI） | open | 2026-04-23 |

### P1 商业闭环（决定产品能不能赚钱）

| # | 标题 | status | created |
|---|---|---|---|
| [030](030-distribution-channels-naming-and-strategy.md) | 分发渠道命名 / 市场定位 / 审核搜索机制调研 | open | 2026-04-23 |
| [013](013-alipay-integration.md) | 支付宝真付接入 | open | 2026-04-23 |
| [014](014-wechat-pay-integration.md) | 微信支付真付接入 | open | 2026-04-23 |
| [028](028-alipay-sandbox-integration.md) | 支付宝沙箱接入（E2E L2） | in_progress | 2026-04-23 |
| [015](015-photo-upload.md) | 照片上传（头像 + 相册 + 审核） | open | 2026-04-23 |
| [016](016-report-review-flow.md) | 举报处理流程 | open | 2026-04-23 |
| [017](017-user-ban-mechanism.md) | 封号 / 冻结机制 | open | 2026-04-23 |

### P2 / P3 体验 + 运营

| # | 标题 | status | created |
|---|---|---|---|
| [018](018-real-agent-notify.md) | agent_gateway 通知真接入 | open | 2026-04-23 |
| [019](019-rate-limit-captcha.md) | 限流 + CAPTCHA 反爬 | open | 2026-04-23 |
| [020](020-refund-dispute.md) | 退款 / 争议处理 | open | 2026-04-23 |
| [021](021-admin-console.md) | 管理员后台 | open | 2026-04-23 |
| [022](022-business-alerts.md) | 业务级告警 | open | 2026-04-23 |
| [023](023-customer-support.md) | 客服支持渠道 | open | 2026-04-23 |

### Tech-debt / chaos engineering 相关

| # | 标题 | status | created |
|---|---|---|---|
| [027](027-skill-contact-info.md) | xiangqin skill 留公司联系方式（腾讯企业邮箱） | open | 2026-04-23 |
| [025](025-db-migration-tests.md) | DB migration 测试规范 + 覆盖所有迁移 | in_progress | 2026-04-23 |
| [024](024-skill-repo-readme-in-main.md) | skill 仓 README 从主仓同步 | open | 2026-04-23 |
| [008](008-m6-drill-flaky.md) | M6 drill flaky（aliyun API 抖动） | open | 2026-04-23 |
| [006](006-performance-monitoring.md) | 性能监控完整版 | open | 2026-04-23 |
| [004](004-db-migrations-separate-folder.md) | DB migrations 独立目录 | open | 2026-04-23 |
| [003](003-epsilon-phone-salt-unset.md) | epsilon PHONE_SALT 未设 | open | 2026-04-23 |

## 已关闭

见 [archive/index.md](archive/index.md)。

## 新建 issue 决策流

先问：这是**待决定**还是**已决定**？

- 待决定（还要讨论 / 评估 / 拿外部资源）→ 建 issue
- 已决定（ADR 级别）→ 写 `brain/decisions/<date>-<slug>.md`

`issues/` 和 `decisions/` 互补：前者是"open question"，后者是"done decision"。
