368b1d5b47
Task 12 + Task 7 quality-review carryovers: Part A - password hashing & controlled initial admin: - src/auth/password.ts: hashPassword/verifyPassword over @node-rs/argon2 (napi prebuilt, argon2id default); empty plain rejected at the door - src/scripts/seed-admin.ts: idempotent admin seed (ADMIN_ACCOUNT/ ADMIN_PASSWORD env, walk-up root .env load); existing account -> skip, never overwrites the password; no audit_logs (system op, no actor) - pnpm seed script (build + node dist/scripts/seed-admin.js); .env.example dev defaults admin/admin-secret-change-me - tests: test/password.spec.ts (5), test/seed.spec.ts real-DB idempotency (4) Part B - Task 7 carryovers (all 8): - ApiException(apiCode, message, httpStatus, details?) recognized first by the filter; unmapped-status rule: >=500 -> INTERNAL_ERROR + generic message, <500 -> VALIDATION_FAILED keeping original status (warn-logged) - 5xx/INTERNAL_ERROR responses forced to generic message (leak fix) - pino redact adds req.headers.cookie / res.headers.set-cookie - x-request-id echo capped at 128 chars (fresh UUID beyond, no log) - LOG_LEVEL validated against pino levels at module wiring -> fail fast - shared/ constants (API_PREFIX), request-with-id, log-level (+spec) - jest ts-jest reuses tsconfig.json; unit testMatch includes test/*.spec.ts - build:watch script (no concurrently dep; dev = build:watch + node --watch) api: 35 unit + 10 e2e tests green; root lint/typecheck/test green. 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 仅账号密码登录,飞书暂不接入;用户信息由指定接口定期拉取,密码与项目权限由本地管理。