docs(readme): 更新第一阶段进度：区分已完成批次与未完成清单

原进度表严重过期（仍写 06 待做、07 创作者中心待做、08 部分、09 待做），与代码和 api-phase1.md 都不一致，容易误导排期与联调。本次按实测重写： - 模块表 01-10 逐条核对（04/05/06/07/08 改为已实现；09/10 标部分并写明差什么） - 新增「已完成批次」表，列出本轮冲刺 13 个批次与对应提交，便于回溯 - 新增「尚未完成」清单，分四类：后端研发 6 项、上线前必补 6 项（P0/Go-No-Go）、基础设施 6 项、非后端范围（客户端与 Web 分工），每条标注依据文档 - 写明已作废方案：module-analytics 收敛因创作者中心改由 Web 端承载而不再需要为什么改：README 是接手者第一眼看的文档，进度表过期会直接误导排期与联调。
2026-10-16 15:31:33 +08:00
1 parent 4418a840ec
commit 50ffc974db
@@ -191,18 +191,43 @@ java -jar fruitshorts-app-api/target/fruitshorts-app-api-1.0.0-SNAPSHOT.jar

 ## 第一阶段实现进度

+> 最后更新：2026-10-16（后端 `develop` 分支 `4418a84`）。**未完成清单见文末「尚未完成」。**
+
 | 模块 | 状态 | 说明 |
 | --- | --- | --- |
-| 01 基础与交付准备 | 已实现 | 多模块骨架、接口契约、双密钥鉴权、分区维护 |
+| 01 基础与交付准备 | 已实现 | 多模块骨架、接口契约、双密钥鉴权、分区维护；**雪花主键（S0）**、**Swagger 在线文档 `/doc.html`（S1）** |
 | 02 用户账号与登录 | 已实现 | 手机号/邮箱注册登录、验证码反刷、令牌轮换、资料、注销、封禁即时生效 |
-| 03 内容发现与详情 | 已实现 | 首页/发现/分类/详情；补内容分级、可播区域、版权窗口、标签字段 |
-| 04 播放器与播放控制 | 部分 | 播放票据 + 签名地址 + 进度已实现；多码率片源待转码 worker |
-| 05 记录、收藏与下载 | 部分 | 进度、观看流水、收藏已实现；离线下载授权待做 |
-| 06 评论、点赞与分享 | 待做 | 表已建，接口与实现待补 |
-| 07 创作者中心 | 待做 | 表已建；转码任务与多码率产物记账已实现 |
-| 08 平台运营后台 | 部分 | App 用户管理已实现；内容治理、订单、看板待做 |
-| 09 分集收费与支付 | 待做 | 表已建；播放入口的权益判定端口已预留，接上即生效 |
-| 10 质量、数据与上线 | 待做 | 压测、埋点、对账待做 |
+| 03 内容发现与详情 | 已实现 | 首页/发现/分类/详情；内容分级、可播区域、版权窗口、标签字段 |
+| 04 播放器与播放控制 | 已实现 | 播放票据 + 签名地址 + 进度；多码率 HLS 由转码 worker 产出（见 10） |
+| 05 记录、收藏与下载 | 已实现 | 进度、观看流水、收藏、离线下载授权与任务 |
+| 06 评论、点赞与分享 | 已实现 | 评论（游标翻页/审核/删除）、点赞、举报、敏感词；**分享埋点待 C3** |
+| 07 创作者中心 | 已实现 | **在后台管理（Web 端 `ReelShortWeb`）**：工作台、内容编辑、分片上传与断点续传、提交审核与上下架、分集收费与试看、数据看板；不含提现/结算。**App 客户端不提供创作者中心**（口径 2026-10-16） |
+| 08 平台运营后台 | 已实现 | 用户管理、内容治理、订单与权益、创作者与内容审核、数据看板 + 四个后台页面 |
+| 09 分集收费与支付 | 部分 | **Google Play 票据校验闭环已实现**（校验→建单→发权益、幂等与防重放、恢复购买、退款拒付回收、对账）；**Apple IAP 只留端口未实现**（印尼 iOS 占比低，文档口径为"预留"） |
+| 10 质量、数据与上线 | 部分 | **转码 worker（C1）已实现**；**Redis 缓存与限流（C2）、埋点（C3）、压测未做** |
+
+### 已完成批次（按提交顺序）
+
+| 批次 | 内容 | 提交 |
+| --- | --- | --- |
+| S0 | 主键改雪花（58 表 / 52 实体 / 存量库幂等迁移脚本） | `37c9a14` `84aa0e1` |
+| S1 | 接口文档在线化（39 个 Controller / 172 个接口中文注解 + `/doc.html`） | `c6fcfcc` |
+| 契约补遗 | 补全接口契约遗漏（系统管理 / 内容 / watch-history / creators 账号 / media 详情） | `efe8af6` |
+| M2 | 后端契约测试补齐（**0 → 37 条**） | `fafadfc` |
+| B1-1 | Google Play 票据校验闭环（校验→建单→发权益） | `db897d5` |
+| B1-2 | 恢复购买 / 退款拒付回收 / 对账真实比对 + Apple 端口预留 | `1dc97b4` |
+| C1 | 转码 worker（独立进程消费 `transcode_task`，四档 HLS + 封面） | `9f76302` |
+| D1 | 部署就绪（配置外置 + prod fail-fast + 自包含 Compose + 冒烟/回滚） | `b567365` |
+| D1-fix | 冒烟脚本与 prod Swagger 开关解耦 | `cbb9961` |
+| D2 | 部署文档按 specs 约束补全（新增 `DEPLOY-CHECKLIST.md`） | `7dd4b15` |
+| 部署修复 | PG18 数据卷挂载路径 + worker 的 prod 密钥/CORS 映射（PR #1） | `8b46e53` `4c4f643` |
+| E1 | 补 5 个 C 端接口（`/app/creator/apply`、`/app/config`、`/app/notices`） | `14b5e41` |
+| 契约修正 | 移除 `/app/creator/works`、`/app/creator/stats` 的 C 端定义 | `bb21920` |
+| E1-rollback | 撤除上述两条接口对应代码（创作者中心归 Web 端） | `4418a84` |
+
+**门禁现状**：`mvn test` **91 条全过**（app-api 49 / commerce 27 / worker 12 / admin-api 3）。
+
+> 客户端仓库 `ReelShort`（Flutter）另有已完成批次：网络层换 `dio`（`1853e18`）、客户端改名 `nontonki → FruitShorts` + 印尼语 `id-ID` 文案（`61454e3`）。

 ## 默认账号

@@ -399,15 +424,54 @@ public Result<Long> create(@Valid @RequestBody DramaCategorySaveReqVO req) { ...
 6. 表格状态列改用接口返回的 `status` / `statusText`，
   大数值用 `src/utils/format.js` 的 `formatCount` 格式化。

-## 尚未实现
+## 尚未完成

-评论点赞分享、订单与钱包权益（IAP / Google Play Billing 票据校验、对账、退款回收）、
-创作者中心、内容治理与经营看板、转码 worker（消费 `transcode_task`，产出多码率 HLS）、
-Redis 缓存与限流、离线下载授权、埋点与数据看板。
+> 最后更新：2026-10-16。完成后请同步本表与 [docs/api-phase1.md](docs/api-phase1.md)。

-这些模块的表结构、接口契约、状态机与权限点都已经冻结，见
-[docs/api-phase1.md](docs/api-phase1.md) 里标注「下一批」的部分 —— 接下来是照契约填代码，
-不会再有结构性改动。
+### 一、后端研发（剩余）
+
+| # | 项 | 内容 | 依据 |
+| --- | --- | --- | --- |
+| 1 | **C2 Redis 缓存与限流** | 首页/发现/分类等热点接口缓存（Cache-Aside）+ 验证码/注册/登录限流；生产 Redis 规格 `4C16G 主从 2~3 哨兵` | 任务清单 C2、`17-风险评估` R-10、`10-安全方案` §三 |
+| 2 | **C3 埋点** | 播放/支付/转化事件 + 数据字典对齐（含 06 的分享埋点） | 任务清单 C3、`api-phase1` §3 |
+| 3 | **Apple IAP 票据校验** | 目前只留端口与枚举，未做真实校验（印尼 iOS 占比低，文档口径为"预留"） | `api-phase1` §1.8 |
+| 4 | **压测** | 目标 `P95 < 50ms`（预热后）；容量口径文档里有两套（"1 万并发"与"2 万并发 + 3000 QPS"），需定稿 | `09-测试计划` §五、`13/14-容量` |
+| 5 | **对账数据源** | 结算金额/手续费/税只能从 Play Console 财务报告取（需报表权限）；当前 `storeAmountSum` 恒为 `null` + `notes` 说明 | B1-2 待确认 |
+| 6 | **退款口径完善** | 部分退款按比例回收、退款实时性（当前由每日对账 + 手动驱动，未接 RTDN 推送） | B1-2 待确认 |
+
+### 二、上线前必补（P0 / Go-No-Go：非研发，但阻塞上线）
+
+| # | 项 | 当前状态 | 目标 |
+| --- | --- | --- | --- |
+| 1 | 生产密钥集中托管 + 轮换 | 仅 `.env`（权限 600），无托管、无轮换流程 | 密钥集中托管、最小权限、可轮换（`10-安全方案` §五） |
+| 2 | 安全专项测试 | 未做 | 越权/注入/敏感数据专项，高危上线前清零（`12-上线检查清单` §三） |
+| 3 | 备份与恢复演练 | 仅手动 `pg_dump`，且与数据库**同机** | **RPO ≤ 5min / RTO ≤ 30min**；全量 + WAL 归档 + 加密 + 异地 + 季度演练（`08-备份恢复`） |
+| 4 | 监控告警接入 | 未部署，仅日志 + `SlowRequestLogger` 兜底 | Prometheus / Grafana / Loki + P0/P1 告警规则（`07-监控告警`；**需先加 actuator 指标端点**） |
+| 5 | HTTPS + 域名 + 反代 | 无 | 管理端 / 客户端 API / 媒资**分别域名**，HTTPS 强制（`04-部署架构` §四、`10-安全方案` §二） |
+| 6 | 媒资迁 OSS/S3 + CDN | 本地磁盘 `./data/uploads` | 生产必须换 OSS/S3 + CDN（`08-备份恢复` §六、`12-上线检查清单` §四） |
+
+### 三、基础设施
+
+- **CI/CD 流水线**：当前手动跑门禁，未接流水线（`06-CI-CD方案`）
+- **多实例 / 高可用**：当前单点部署；文档要求应用 `8C16G × 3~4`、转码 worker `8C16G × 2~3`，生产用 K8s（`14-生产资源规划`）
+- **短信 / 邮件真实通道**：开发走 log，生产待接通道（`05-中间件清单`）
+- **分区保留策略**：`partition.retention-enabled=false`，待合规确认后打开（`03-数据架构`）
+- **`watch_history` 异步落库**：Kafka 异步通道为 Phase 2 预留（`13-容量与扩展规划` §四）
+- 备份存储位置与成本待定（`08-备份恢复` §六）
+
+### 四、不在后端范围（另有分工）
+
+- **客户端 Flutter（`ReelShort`）**：A2~A6 与后端联调、B2 Google Play Billing 购买流程、秒开基线（需低端安卓设备）；网络层 `dio`、改名与印尼语文案已完成
+- **Web 后台（`ReelShortWeb`）**：由另一位同事侧负责
+
+### 五、文档待同步（供文档维护人）
+
+`docs/api-phase1.md` 与 specs `docs/` 下仍有 20+ 处**过期陈述**（例：`api-phase1` §3 仍把 09 支付标"下一批"；specs `17-风险评估` 的 R-01/R-03/R-04/R-09 仍标"未开始"）。
+**遇到冲突以本表与本仓库 `api-phase1.md` 正文为准。**
+
+> **已作废的方案**：曾提议新建 `fruitshorts-module-analytics` 收敛"两份创作者看板"。
+> 因 2026-10-16 口径变更（**创作者中心由 Web 端承载**）撤除了 App 侧 `/app/creator/works`、`/app/creator/stats`，
+> **两份看板问题已从根上消失，该方案不再需要**。

 ## 常见问题