6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
后端PRD交叉审核报告（2026-06-05）
审核方式：agent对照架构方案v0.3 + CLAUDE.md + 7洞落盘 + 扒包(上线版) 逐条核对后端PRD骨架完整性。 结论：后端PRD骨架"只提到名词，没承接细节"，架构方案v0.3里拍过板的细节几乎都没落进PRD——这是倩倩姐"看不懂"的根因。
审出的问题（18遗漏+5不一致+10工程空白）
🔴 重大遗漏（架构v0.3拍了板但PRD没承接）
- 基石A 业务参数不写死(品类/数量/角度) 无落点
- 基石B key机制不完整(缺FERNET_KEY环境变量/gemini_factory每任务建实例/解密不落盘)
- 基石C 读写权限分层(写操作查workspace_members)+base_workspace_repo中间件 缺失
- 基石D 采集↔生产接缝(人工判断标准落点) 完全没有
- 基石E 飞轮四点验收 没列
- 16表精确清单+Alembic001-004分批 缺(且PRD表名错:api_keys应为user_api_keys/tasks应为generation_tasks/无assets表应为text+image_candidates/无login_records/无ai_call_logs)
- 任务状态机7态(pending→generating→pending_selection→pending_review→approved/rejected→archived) 缺
- generation_tasks审核字段平铺(6字段,不建独立notes表) 缺
- preference_events字段(signal_type5枚举/weight/angle_label/reason/data_ownership/workspace_id+product_id) 缺
- 文案轨A"一次出5角度JSON"规格 缺(易被agent照抄产品包单条串行)
- 文案轨B(导入外部文案text_import_handler+source字段) 完全缺
- storyboard分镜与A/B/C并发两套生图逻辑如何整合 没说清
- IMAGE_PROVIDER_PRIMARY环境变量配主备+禁纯文生图+产品锚点防串货 缺
- 三期构建顺序1A/1B/二期/三期+一期不做项 缺
- eval_score留NULL不接banana假评分 缺
- 标杆采集通道分层(截图手填主/登录态插件内部) 缺
- ai_call_logs(usage记录,按key计费排障基础) 缺
- MongoDB只存debug trace(业务不依赖)边界 缺(PRD误把prompt_template放Mongo,实际可调prompt在products表)
🟡 不一致
- C1: PRD把data_ownership列成独立表,实际是preference_events的字段
- C2: 生图把产品包10角色/6品类 和 edits新接口 混在一起没说整合
- C3: 去水印主次反了(主=re-encode/Pillow,banana重绘是可选且海报有改字风险)
- C4: 三层兜底/五维打分要标明"扒产品包重写Python集成进轨A"
- C5: token-url收口缺反面约束(账号表不存url字段/旧兼容废止)
🟢 所有来源都没细化、PRD该补的工程细节
错误码规范/SSE事件类型清单/分页规范/限流(生图4min)/文件存储路径/DB索引/Alembic回滚+FERNET_KEY缺失启动保护/健康检查/环境变量完整清单/workspace_guard注入时机
🟦 CC的处理判断（不照搬agent建议）
- agent建议把后端PRD扩成14章、把架构方案§四§五原文照搬进PRD → 不采纳全照搬
- 理由：架构方案v0.3已是金标准,PRD原文复制=两份打架+维护噩梦
- 正确做法：后端PRD做成"承接层"——①引用架构方案(不复制)②重点补PRD独有的工程细节(§四绿色那10项:错误码/SSE/分页/限流/索引/环境变量等)③把扒包上线版的生图新事实写进去
- 数据模型这种基础:PRD用"引用架构方案§三 + 标注扒包修正点"方式,不重抄16表