Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# 变更日志

## feat: [M030-M032] 迁移订阅增删与通知查询/已读状态(2026-10-30)

- 新增六个旧HTTP入口的普通能力、现有Mongo适配及三个独立、默认关闭的隔离开关,共用身份/同步日志;生产入口、业务模型和客户端用法不变。
- 86组真实旧HTTP/完整BSON,实际Java16项通过并再次重放固定样本;新增Python102项,相关回归及补验分批跑通,最终通知/HLS/架构121passed/0skipped/1既有warning。控制字符/NBSP旧样本修复前实际失败,改用共用Java trim原样规则后通过。Ruff/架构/500行及文档台账检查通过,完整CI见本批PR当前head,真实FC/实机未跑。
- 保留订阅记录/独立计数的部分失败、Long计数、通知旧可选身份/JSON/null/分页和read窄写;不新增原本未调用的通知生成、鉴权规则、队列或云资源。
- 剩余工作固定为M001–M090任务台账,列交付物/验收/依赖/状态,不再扩字母子号;本轮三项隔离交付、未合并,基线仍余87项,不据任务数重算工作量百分比。

## feat: [S15.b.1] 迁移登录用户的订阅状态与列表读取(2026-10-29)

- 新增普通Python读取能力、现有Mongo适配及默认关闭的显式HTTP装配;复用身份/同步日志,不安装订阅写入或改变生产入口。
Expand Down
8 changes: 8 additions & 0 deletions docs/api/1-用户接口.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,14 @@

Python仅在显式`subscription_reads=True`隔离装配启用,默认及生产入口不变;不包含subscribe/unsubscribe写入。实际旧Java/独立Mongo26组样本与Python逐项对照,详见[验收与回退](../requirements/2026-10-14-serverless-backend/user/subscription-reads.md),真实FC与实机未跑。

### 订阅写入及通知迁移契约(M030–M032)

`GET /subscription/subscribe`和`GET /subscription/unsubscribe`仍以`channelUserId`查询参数操作,必须登录;保留原直接错误、记录与独立计数的写入顺序和部分失败,不新增通知。Python仅在显式`subscription_writes=True`安装,已有`subscription_reads`不隐式启用写入。

通知四路由的实际身份策略是页首历史认证概括的例外:旧`InterceptorConfiguration`未给`/notification/**`安装CheckToken,缺失/坏token按原`userId=null`查询/窄写,不在迁移中新增401或非空ID校验。`GET /notification/getMyNotifications`、`GET /notification/getUnreadCount`由`notification_reads=True`安装;`POST /notification/markAsRead`、`POST /notification/markAllAsRead`由`notification_writes=True`安装,读写开关独立、默认关闭。

通知列表默认page=0/pageSize=20,正pageSize最大50,保留非正大小、整数边界、UTC毫秒日期及旧BSON错误;已读按原所有者条件仅更新read,全部已读不解析正文。真实旧HTTP/完整BSON、JSON绑定和回退边界见[订阅与通知契约](../requirements/2026-10-14-serverless-backend/user/subscription-notifications.md)。仅隔离能力,生产入口和各端用法不变。

| 接口 | 方法 | 路径 | 认证 |
|------|------|------|------|
| 请求验证码 | GET | /user/requestVerificationCode | 不需要 |
Expand Down
2 changes: 1 addition & 1 deletion docs/requirements/2026-10-14-serverless-backend/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@

| 入口 | 用途 |
|---|---|
| [总体进度与剩余清单](overview/status.md) | 25阶段总表、当前阶段固定子任务/PR与下一项;区分转码和业务后端迁移 |
| [总体进度与剩余清单](overview/status.md) | 25阶段总表及[固定M编号任务台账](overview/remaining-work.md);区分转码和业务后端迁移 |
| [当前接续](progress.md) | 当前分支/PR/CI与下一步;页首为最新,历史记录保留 |
| [实施计划](plan.md) | 各阶段目标、验收与回退边界 |
| [验证记录](verification.md) | 实际运行证据,区分本机/CI/云端/设备 |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,5 +10,5 @@
| [response-comparison](response-comparison.md) | S05.b 离线响应对照工具 |
| [routes](routes.md) | Controller 声明接口盘点 |
| [status](status.md) | 25阶段总表、当前子任务/PR编号与下一项 |
| [remaining-work](remaining-work.md) | 剩余迁移的执行批次、验收证据与依赖 |
| [remaining-work](remaining-work.md) | 固定M001–M090剩余任务、交付物、验收、依赖和状态;不再扩字母子号 |
| [reuse-for-speakup](reuse-for-speakup.md) | 用户要求的经验复用核对:分层/契约/异步任务/流式/托管数据与实际验证缺口 |

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# 总体进度与剩余清单

更新:2026-10-29。以下是代码/PR和现有验收记录的状态,不是生产迁移完成度。S15.a 的[PR #229](https://github.com/makewheels/video-2022/pull/229)已合并`162c6d37`,master CI40843192645成功;当前S15.b.1订阅读取隔离能力本机验收通过,完整CI以本批PR当前head为准。每阶段的“完成”包括其验收,能力库或隔离HTTP测试通过不能代替真实FC上线。
更新:2026-10-30。远端master为`1b4eeb20`,[PR #229](https://github.com/makewheels/video-2022/pull/229)赞踩和[PR #230](https://github.com/makewheels/video-2022/pull/230)订阅读取均已合并;master CI40846984693及既有Java部署40846984740实际success。Python真实FC发布仍无成功验收记录,不能把Java部署成功当Python上线。

剩余执行改用[固定任务台账](remaining-work.md):基线90项,M001–M090,不再扩展字母子编号。今日M030订阅增删、M031通知查询、M032已读状态的隔离实现/本机验收已交付,工作分支未合并、完整CI见本批PR;剩余87项。历史S阶段和PR编号保留,不重算已交付成果。

## 两个工程分别看

Expand All @@ -13,13 +15,13 @@

## 一眼看懂当前位置

- 后端迁移总计 **25个大阶段**,编号S00–S24;当前小批次为 **S15.b.1订阅读取隔离迁移**,本机验收通过;S10上传剩余项、S11 LOCAL、S12可靠任务和真实FC/各端验收仍未完成,不表示此前阶段全部完成。
- 后端迁移总计 **25个大阶段**,编号S00–S24;S15订阅读取已合并,**M030–M032已交隔离实现/本机验收,待本批PR合并**。S10上传、S11 LOCAL、S12可靠任务和真实FC/各端验收仍未完成,不表示此前阶段全部完成。
- 应用户2026-10-16要求给出沟通用百分比:**整体开发工作量粗估约25%,剩余约75%**。这是基于已完成/部分阶段的人工估算,误差较大,不是实测或生产验收完成率;生产尚未切换。
- **3已交付 / 2阻塞或未验 / 10部分完成 / 10主体未迁移**。S10/S11/S12/S14/S15均有隔离能力,但仍缺各自剩余业务或真实环境验收;不能按PR数量或已写模块数换算上线百分比。
- S09固定拆为 **14个子任务:13已合并、1待验**;m.1–m.3隔离装配/入口/编码矩阵已合并,n真实环境仍未验。S10.a.1已合并#216、a.2/b.1普通创建#217、c.1凭证/文件完成#218;b.2状态轮询已合并#219;原片可靠受理/MD5等仍缺。
- [剩余执行清单](remaining-work.md)已细化后续业务批次、验收和依赖;S09.a–m已合并、n真实环境待验,后续按依赖推进,不因云权限阻塞停下独立开发。
- PR标题统一`type: [Sxx.y] 具体成果`;已有#200–#207已补编号。PR是交付批次,不是项目总任务数。
- 25是大阶段总数;其他阶段的子任务会在进入前按实际接口/依赖细化,**目前没有可信的全项目PR总数或剩余工期**。新增子任务在清单末尾说明原因,不悄悄改变既有编号。
- 25是里程碑总数,90是2026-10-30基线的剩余交付物数;两者都不是PR总数或等权工作量。发现漏项只在任务台账末尾追加并记录原因,不扩字母层级;目前仍没有逐任务实测工时。

## 当前S09:14个子任务

Expand Down Expand Up @@ -61,7 +63,7 @@
| 13/25 | S12 可靠任务/恢复 | 故障实验已交付,方案/运行时待做 | #220进程终止模型确认写库/投递与未知受理间隙;真实托管唤醒、deadline和恢复协议仍未解决 |
| 14/25 | S13 云任务/回调/MPS | 主体未迁移 | 把既有Java任务/回调/恢复迁入Python,不能重复计费或双所有者 |
| 15/25 | S14 评论回复 | 隔离读写能力已交付 | #225读取、#227创建/回复/级联删除/点赞切换;尚未接生产入口,真实FC和各端验收仍待做 |
| 16/25 | S15 赞踩/订阅/通知 | 部分实现 | a视频赞踩#229已合并;b.1订阅读取及26组旧HTTP/BSON本机通过,当前head CI以本批PR为准;订阅写入、通知和真实环境仍缺 |
| 16/25 | S15 赞踩/订阅/通知 | 隔离HTTP能力已交,真实验收未齐 | 赞踩#229、订阅读取#230已合并;M030–M032订阅写入/通知HTTP完成本机验收、待本批PR合并;真实FC/各端归M040,不新增原本未调用的通知生成业务 |
| 17/25 | S16 播放列表/分享 | 未开始迁移 | CRUD/排序/恢复/跳转统计 |
| 18/25 | S17 开发者/JWT/OAuth/OpenAPI | 未开始迁移 | 旧凭据、scope、刷新撤销与两套路径 |
| 19/25 | S18 限流/Webhook | 未开始迁移 | 跨实例额度、签名字节与可靠重试 |
Expand All @@ -74,6 +76,8 @@

## 当前检查点与历史交付

2026-10-30:M030–M032实际旧Java16passed/0skipped,含86组新HTTP/完整BSON且生成后再次固定文件重放;新增Python102项,初轮相关309项分批验证,补真实Java trim/NBSP样本修正兼容边界后通知/HLS/架构最终121passed,非本机全量。Ruff/架构/500行通过,工作分支未合并、CI当前head见本批PR。通知路由旧可选身份、primitive null错误和Java字符串空白规则均按实测保留,没有迁库/切流/云资源变更。

2026-10-29接续:#229已合并`162c6d37`且master CI40843192645成功;S15.b.1隔离订阅读取完成真实Java2项/26组样本、Python相关域108passed/0skipped/1warning及本机门禁。仍约25%的人工开发估算,不表示生产完成度。未自行合并本批或切生产;当前head CI和未验范围记录于本批PR。

2026-10-29:master已快进到`cbc02da7`且基线CI/部署38928696025/38928696127均success;分支`feat-video-reactions-http`完成S15.a,实现提交`d2aea26b`已推送#229。实际Java12项/56组旧HTTP与BSON、本机Python相关域180项通过;[CI40841352861](https://github.com/makewheels/video-2022/actions/runs/40841352861)全部必需检查success,Linux完整Python1400passed/1warning,API/浏览器E2E按条件skipped。未自行合并、切流、迁库或创建云资源;收尾文档head门禁以PR为准,真实FC/各端仍未验。
Expand Down
16 changes: 8 additions & 8 deletions docs/requirements/2026-10-14-serverless-backend/plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@

## 执行粒度

- P0–P4 只作为整体里程碑;下表 S00–S24 是实际交付单元,不把全部迁移做成一个 PR。
- 每个 PR 一个可验证、可回退的目标,默认约 10–30 分钟主动工作的小块,仅为拆分参考,不是耗时承诺。复杂项再拆 Sxx.a/Sxx.b,不为了凑一个阶段不断扩大范围。
- P0–P4是整体里程碑,下表S00–S24保留领域覆盖和历史验收边界;剩余执行以固定M编号交付,不把整个领域或全部迁移做成一个PR。
- 每个任务一个可验证、可回退的交付物;PR包含该交付物必要的旧契约、实现和验收,不再以预计10–30分钟或持续追加字母来拆任务。剩余任务使用固定M编号,内部步骤不再派生新编号。
- 同一时间推进一个实现子阶段;先读相关官方资料,再实现、验证、提交和记录接续。已授权范围内自主继续,不每阶段重新问是否开始。
- 稳定边界及时 commit/push,写入 [progress.md](progress.md);不推测剩余 token 数,也不等额度耗尽才记任务状态。
- CI 等待不算主动编码时间,不无理由重复全套检查。单阶段未完成时明确半成品和下一条操作;不靠内存或聊天摘要交接。
- 不因限额而删减兼容测试、降低播放/鉴权/计费要求。生产切流、不可逆网络/数据变化或新增需求外规则仍须具体证据与对应授权。

## 子阶段与验收

| 阶段 | 里程碑 | 单个 PR 的目标 | 验收与回退边界 |
| 阶段 | 里程碑 | 领域覆盖(历史阶段) | 验收与回退边界 |
|---|---|---|---|
| S00 | P0 | 官方依据、分阶段、Git 单向发布与可迁移边界、接续记录 | 文档一致、引用有效、状态真实;只回退文档 |
| S01 | P1 | 外壳、业务、端口、适配器和配置装配分离 | 两个入口共享用例;公共层不导入 FC/FastAPI/PyMongo;原型回归;不同时扩业务 |
Expand All @@ -30,7 +30,7 @@
| S12 | P1/P2 | 可靠任务受理、唤醒和恢复 | 写库/投递间隙、重复/乱序/超时/死信验证;平台任务 ID 不成为业务模型,不能删除恢复来零空扫 |
| S13 | P2 | 云转码/封面提交、回调及 MPS 兜底 | attempt/租约/manifest/晚回调、有限重试、旧回调和部分成功;不重复付费提交;按提交/登记/恢复再拆 PR |
| S14 | P2 | 评论与回复 | 删除/回复/计数和唯一性回归;评论点赞可独立 PR |
| S15 | P2 | 视频赞踩、订阅、通知 | 每个业务一个小 PR,分别验规则、计数和未读,不强行三域合并 |
| S15 | P2 | 视频赞踩、订阅、通知 | 分别验规则、计数和未读;范围明确、共享契约/装配的小任务可合批,不将隔离实现与真实各端验收混为完成 |
| S16 | P2 | 播放列表和分享 | 列表 CRUD/排序/恢复与分享跳转/统计分 PR,保留旧接口和 v1 |
| S17 | P2 | 开发者登录/应用、JWT/OAuth、OpenAPI | 按鉴权体系分 PR;旧 BCrypt/JWT、scope/刷新/撤销及两套开发者路径逐项对照 |
| S18 | P2 | 跨实例限流和两套 Webhook | 限流、Webhook 分 PR,验配额/响应头、签名字节、次数/退避和状态 |
Expand All @@ -45,7 +45,7 @@ S12 可以提前调查,但依赖可靠任务的写业务不能在它未通过

## 固定编号与可见进度

总计划25个大阶段;当前S09按a–n拆为14个子任务,详见唯一[任务总表](overview/status.md)。编号保持稳定,必要新增项追加并说明原因;当前大阶段位置不等于此前阶段都通过。PR标题必须包含`[Sxx.y]`,正文注明对应任务、已验/未验与下一项;文档整理用`[S00]`,跨域基础门禁用其真实所属阶段,不以PR数量宣称完成度。
总计划25个里程碑S00–S24保留,S09历史a–n及原PR证据不重编号。**2026-10-30起,剩余执行统一使用[固定任务台账](overview/remaining-work.md)的M001–M090**;每项列交付物、验收、依赖和状态,不再扩展字母层级。新PR标题用`[M030]`或明确任务范围,正文记录S阶段归属、已验/未验与回退点;总体状态仍见[总表](overview/status.md)。

## 每个 PR 的交付要求

Expand All @@ -55,7 +55,7 @@ S12 可以提前调查,但依赖可靠任务的写业务不能在它未通过
4. 实际命令/CI 链接,明确 passed/skipped/pending/未跑;既有 Java 用例不是 Python 验收。
5. 回退点、在途任务影响和下一阶段,更新 [接续记录](progress.md)。

分支名不含 `/`。同一阶段可按 a/b 拆分;业务分组先后可按依赖调整,但不能遗漏能力或跨阶段一次性塞入大 PR。进度和估时按实际小阶段修正,早期“1–3 天”只是粗估,不是强制期限或绕过验证的理由。
分支名不含`/`。同一领域按固定M编号交付,不再追加a/b子号;范围明确且共享设施的小任务可合批,逐项保留验收,不遗漏能力或跨阶段一次性塞入大PR。进度和估时按已验交付及实际用时修正,记录阻塞/等待,不用任务数、PR数或测试数换算工作量。早期“1–3天”以及后续周级预算都不是实测工期或绕过验证的理由。

## Git、部署与数据边界

Expand Down Expand Up @@ -83,6 +83,6 @@ Git 是唯一自研源码来源。流程为已知提交→CI 测试/构建→OSS

[两种故障点](tasks/task-submission-persistence.md)已本机隔离验证,2项通过。仅现有Java恢复边界证据,不新增可靠任务产品、生产队列/索引或常驻扫描,不将其标S12完成。

## 2026-10-16 S09继续实施
## 2026-10-16 S09继续实施(历史接续)

当前a–k已合并,继续l会话HTTP、m统一隔离装配、n真实FC/各端验收。[剩余执行清单](overview/remaining-work.md)细化S09.l/m与S03–S24剩余批次及依赖,用户已要求细化后直接实施。固定14项及PR链接以[任务总表](overview/status.md)为准;历史逐轮记录保留在[progress](progress.md)与[verification](verification.md)。
当时a–k已合并;后续l/m也已合并,n真实FC/各端仍待验。固定14项及PR链接以[任务总表](overview/status.md)为准,历史逐轮证据保留在[progress](progress.md)与[verification](verification.md)。2026-10-30后的剩余执行以固定M编号台账为准。
11 changes: 11 additions & 0 deletions docs/requirements/2026-10-14-serverless-backend/progress.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# 接续记录

## 2026-10-30 固定任务台账及今日三项

- 用户要求把剩余工作一次细化,不再不断追加字母层级,并授权今天先实现几项。既有remaining-work.md改为固定M001–M090:交付物、验收、实际依赖和状态;历史S阶段/PR证据不改号。
- 现场确认master `1b4eeb20`、#229/#230均已合并;master CI40846984693/既有Java部署40846984740实际success,#230 Python1429passed/1warning;API/浏览器E2E为skipped。未据此宣称真实FC上线。
- 今日范围M030订阅增删、M031通知列表/未读数、M032单条/全部已读。源码核对订阅同步写入和四个通知HTTP不依赖S12;sendNotification没有生产调用者,不凭旧清单新增通知生成/队列业务。
- 起始工作区干净,分支`feat-migration-interactions-20261030`。三项普通能力/端口/Mongo和显式HTTP均已实现,共用原身份/同步日志,三个开关默认关闭;生产入口不改。
- 真实旧MVC发现通知四路由未安装CheckToken,不能照旧清单猜成登录必需;按可选身份及null用户查询保留。User计数是Long,未新增int上限。通知缺失read为false、显式null反序列化失败,未读/批量已读只匹配BSON false,均按样本保留。
- Java `InteractionHttpContractTest,SubscriptionReadHttpContractTest,NotificationServiceTest`实际16passed/0skipped;最终86组完整HTTP/BSON(订阅32/通知读26/通知写28)生成后再次从固定文件重放,Checkstyle通过。没有真实云调用。
- Python新增102项;首轮与订阅读取/赞踩/评论/统一后端/架构共309项,307passed/2failed为两项夹具误选,修正后2项定向passed。终审又用固定Spring字节码和2组真实旧MVC样本抓住Python Unicode strip与Java trim差异,修复前2failed;抽取现有HLS的纯Java trim共用后,通知/HLS/架构最终121passed。批次重叠不相加,均0skipped、1条既有Starlette/httpx warning;不是本机全量。Ruff/500行通过。
- 单项主动工时未独立采集,不按这批共享调查/契约工作反推每项工期。当前为工作分支隔离交付、未合并,完整CI/提交以本批PR当前head为准;真实FC/各端未跑,不迁库/切流/创建云资源。下一批优先M016/M017与M027,不扩大本轮三个任务。

## 2026-10-29 S15.b.1 订阅读取隔离迁移

- 应用户17:00前再交付一个小批次的要求,从已合并#229的master `162c6d37`新建`feat-subscription-read-http`。只迁移getStatus/getMySubscriptions,共用身份/日志周期;`subscription_reads=False`默认不安装,写订阅/通知及生产入口不变。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,3 +28,4 @@
| [comment-writes](comment-writes.md) | S14.b–d 评论/回复、级联删除、点赞切换与部分失败 |
| [video-reactions](video-reactions.md) | S15.a 视频点赞/点踩、状态读取与旧 HTTP/Mongo 对照 |
| [subscription-reads](subscription-reads.md) | S15.b.1 登录用户订阅状态与分页列表读取,不包含订阅写入 |
| [subscription-notifications](subscription-notifications.md) | M030–M032 订阅增删、通知查询/已读状态、真实旧身份策略及失败边界 |
Loading
Loading