Files
beige/PRD/后端PRD交叉审核报告.md
yangqianqian 6a2632da70 baseline: Clover 独立仓库首次基线提交
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。
当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包),
M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-16 11:30:22 +08:00

43 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 后端PRD交叉审核报告2026-06-05
> 审核方式agent对照架构方案v0.3 + CLAUDE.md + 7洞落盘 + 扒包(上线版) 逐条核对后端PRD骨架完整性。
> 结论后端PRD骨架"只提到名词,没承接细节"架构方案v0.3里拍过板的细节几乎都没落进PRD——这是倩倩姐"看不懂"的根因。
## 审出的问题18遗漏+5不一致+10工程空白
### 🔴 重大遗漏架构v0.3拍了板但PRD没承接
1. 基石A 业务参数不写死(品类/数量/角度) 无落点
2. 基石B key机制不完整(缺FERNET_KEY环境变量/gemini_factory每任务建实例/解密不落盘)
3. 基石C 读写权限分层(写操作查workspace_members)+base_workspace_repo中间件 缺失
4. 基石D 采集↔生产接缝(人工判断标准落点) 完全没有
5. 基石E 飞轮四点验收 没列
6. 16表精确清单+Alembic001-004分批 缺(且PRD表名错:api_keys应为user_api_keys/tasks应为generation_tasks/无assets表应为text+image_candidates/无login_records/无ai_call_logs)
7. 任务状态机7态(pending→generating→pending_selection→pending_review→approved/rejected→archived) 缺
8. generation_tasks审核字段平铺(6字段,不建独立notes表) 缺
9. preference_events字段(signal_type5枚举/weight/angle_label/reason/data_ownership/workspace_id+product_id) 缺
10. 文案轨A"一次出5角度JSON"规格 缺(易被agent照抄产品包单条串行)
11. 文案轨B(导入外部文案text_import_handler+source字段) 完全缺
12. storyboard分镜与A/B/C并发两套生图逻辑如何整合 没说清
13. IMAGE_PROVIDER_PRIMARY环境变量配主备+禁纯文生图+产品锚点防串货 缺
14. 三期构建顺序1A/1B/二期/三期+一期不做项 缺
15. eval_score留NULL不接banana假评分 缺
16. 标杆采集通道分层(截图手填主/登录态插件内部) 缺
17. ai_call_logs(usage记录,按key计费排障基础) 缺
18. 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表