浅念
f6448bd006
- status enum active|archived -> active|offline (align requirement docs)
- UploadSessionState session-state semantics documented (no failed state)
- maxLength: clientTaskId 128 / filename 255 / cursor 512
- PublicPhoto width/height required (layout placeholders)
- reusable Unauthorized/InternalError responses (hybrid with inline op-specific codes)
- PublicAlbum.translations -> translation (single resolved object)
- contentType enum [jpeg/png/heic] (heic provisional pending G2)
- minLength 1 on title/name; publicToken pattern ^[0-9a-z]{20,32}$
- CursorPageMeta hasMore/nextCursor invariant documented
- public locale: silent fallback to defaultLocale (tech doc section 11)
- plan: upload_sessions state comment aligned; P1b adds management photo list + account lookup endpoints
Co-Authored-By: Claude Code <noreply@anthropic.com>
图片直播项目文档
版本：V1.3 · 更新日期：2026-09-17
本目录包含第一版项目需求、计划、技术实施与优化方案。建议按以下顺序阅读：
-
需求说明书：范围、角色、流程、功能和验收标准。
-
项目计划：工作分解、依赖、相对周次、工作量和交付门槛。
-
技术实施方案：架构、数据模型、接口、OSS、后台上传、实时互动、嵌入组件和部署。
-
优化方案：12 项优化、需求任务验收映射、异常处理和排期影响。
-
项目思维导图与计划导图：项目全景、业务流程、工作分解、里程碑和任务依赖，共七张图。
已确认的核心选型为 Flutter 双平台 App 与现有国内阿里云 OSS、全球 CDN、国内管理与海外观众服务。首发语种、服务端框架、测试容量和工期属于建议基线；优化已同步到原三份文档。项目计划按三名开发及兼职支持估算，约 156 至 231 角色人日，以 16 周排期为工作基线，需结合真实人员与技术验证结果修订。
当前只完成文档编制，尚未创建业务工程、接入用户接口或 OSS，也未执行产品功能与容量测试。
V1.3：第一期后台与 App 仅账号密码登录，飞书暂不接入；用户信息由指定接口定期拉取，密码与项目权限由本地管理。