Files
photo-live/docs
浅念 60b675a908 feat(sync): 对账清单 ad 实体当前态清扫
Task 8(ads-carousel):cn reconcile 增 entityType='ad' 分支——纯 SELECT
当前态映射(sortOrder/createdAt 确定性排序,albumId 恒空串信封约定),
载荷复用 ads/ad-payload.ts 单一出处(与业务事务内即时事件逐字节同形,
纯函数模块无依赖环);DTO SYNC_ENTITY_TYPES 追加 'ad'(对齐契约 enum)。

随附质量审查两项:
- ads.service list() 行→AdminAdItem 映射复用 toItem(删 ~14 行内联重复,
  ⑮ 补 admin list 200 形状断言覆盖重构路径);
- 新增 test/ads-extensions.spec.ts 守护 AD_IMAGE_EXTENSIONS ===
  UPLOAD_CONTENT_TYPES 派生归一扩展名集合(jpeg→jpg),防三处白名单漂移。

测试基建:reset.ts RESET_TABLES 补 'ads'(Task 6 建表遗漏,固定 id 直种
依赖跨 spec 清场);reconcile.e2e-spec 追加 ⑤(红→绿,5/5)。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-29 00:22:13 +08:00
..
2026-09-17 16:13:49 +08:00
2026-09-17 16:13:49 +08:00

图片直播项目文档

版本:V1.3 · 更新日期:2026-09-17

本目录包含第一版项目需求、计划、技术实施与优化方案。建议按以下顺序阅读:

  1. 需求说明书:范围、角色、流程、功能和验收标准。

  2. 项目计划:工作分解、依赖、相对周次、工作量和交付门槛。

  3. 技术实施方案:架构、数据模型、接口、OSS、后台上传、实时互动、嵌入组件和部署。

  4. 优化方案:12 项优化、需求任务验收映射、异常处理和排期影响。

  5. 项目思维导图与计划导图:项目全景、业务流程、工作分解、里程碑和任务依赖,共七张图。

已确认的核心选型为 Flutter 双平台 App 与现有国内阿里云 OSS、全球 CDN、国内管理与海外观众服务。首发语种、服务端框架、测试容量和工期属于建议基线;优化已同步到原三份文档。项目计划按三名开发及兼职支持估算,约 156 至 231 角色人日,以 16 周排期为工作基线,需结合真实人员与技术验证结果修订。

当前只完成文档编制,尚未创建业务工程、接入用户接口或 OSS,也未执行产品功能与容量测试。

V1.3:第一期后台与 App 仅账号密码登录,飞书暂不接入;用户信息由指定接口定期拉取,密码与项目权限由本地管理。