 jianghaifeng
|
5609b42dcd
|
docs: 对齐契约 §3 与 README 文档索引的进度口径
按实测修正 4 处状态描述，消除"已完成/未完成"口径不一致：
- api-phase1.md §3「契约与实现状态对照」：
04 多码率为「转码 worker（C1）已产出」；06 分享埋点标「待 C3」；
09 由"下一批"改为「Google Play 票据校验闭环已实现，Apple IAP 只留端口」；
10 由"压测与埋点 下一批"改为「C1 已实现，C2/C3/压测 未做」；
并补最后更新时间与「未完成清单见 README」的指向
- README.md 文档索引：api-phase1 的描述由"标注已实现 / 下一批"
改为"含「契约与实现状态对照」"
为什么改：契约里的状态表过期会直接误导排期与联调判断，属最容易踩的坑。
|
2026-10-16 15:32:05 +08:00 |
|
|
jianghaifeng
|
50ffc974db
|
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 |
|
|
jianghaifeng
|
9f76302e53
|
feat(media): C1 转码 worker（独立进程消费 transcode_task，产出四档 HLS + 封面）
为什么：codex-研发任务清单阶段 C 第一项要求消费 transcode_task 产出多码率 HLS + 截图；
勘察发现除 worker 外还缺两件——TranscodeService.enqueue 没有任何调用方（队列永远空）、
media_asset.hls_url/poster_url 没人回写，所以一并补齐，已有能力（条件更新认领 / 3 次重试）直接复用。
- 新增 TranscodeRunner 端口 + FfmpegTranscodeRunner（每档一条 ffmpeg 出 VOD HLS + 手写 master.m3u8 + 抽封面 + ffprobe 读时长）
- 新增 TranscodeWorker：claimNext → 转码 → 登记 media_rendition → 媒资 ready；失败记原因、第 3 次才落 FAILED 并把媒资置 failed
- 存储统一走 MediaStorageService（新增 fileFor / objectKeyOf，含目录穿越校验），worker 不自己拼磁盘路径
- 队列隔离：app-api/admin-api 默认 worker-enabled=false，新增独立模块 fruitshorts-transcode-worker（随机端口）
- MediaService 上传完成对视频素材入队并置 transcoding（图片仍直接 ready）
- 实测抓到并修掉两个真问题：① scale 未加 force_divisible_by=2 时 854x480 算出奇数宽 853，libx264 拒绝转码
② 只写 -hls_time 不强制关键帧时 8 秒片源只出 1 个分片，补 -force_key_frames 后按 6s 正确切分
- README 开发环境补 ffmpeg 9.0.2（只有 worker 需要）
- 实测：mvn test 83 条全过、0 skipped（新增 worker 12 条，含真实 ffmpeg smoke）；
端到端：正常源 SUCCESS + 4 档 rendition + 媒资 ready；坏源重试 3 次后 FAILED
|
2026-10-16 12:41:48 +08:00 |
|
|
Vicky
|
b3179fc836
|
refactor: 后端标识统一为 FruitShorts，并落地 05 离线下载
为什么：
1) 产品已定名 FruitShorts，但后端仍是 reelshort 系列标识 —— Java 包 com.reelshort、
模块名与 jar 名 reelshort-*、spring.application.name、配置前缀 reelshort.*，
这些会出现在启动日志、命令行和 IDE 里，与产品名不一致。本次整体替换为 fruitshorts，
数据库连接名上一轮已改名，保持不变。
2) 第一阶段下一批第 1 步（05 离线下载）要求把下载授权（设备绑定/有效期/吊销）、
下载任务与断点续传、配额与过期清理、仅 Wi-Fi 规则做成完整接口，本提交一并落地。
3) 顺带修复：schema-phase1.sql 里 playback_ticket / order_event 仍按普通表定义唯一索引，
表分区化之后重跑脚本必定报错（分区表的唯一索引必须包含分区键）。改为在本脚本里就
按分区表定义，并验证脚本可重复执行。
|
2026-10-15 11:44:26 +08:00 |
|
|
Vicky
|
a4aa749cc6
|
feat: 初始化短剧服务端（管理后台 API + 客户端 API）
Spring Boot 3.2 / MyBatis-Plus / PostgreSQL，7 个 Maven 模块；含认证鉴权、内容与媒资管理、操作日志，以及客户端 /app/** 接口。
|
2026-10-14 18:02:47 +08:00 |
|