baseline: Clover 独立仓库首次基线提交

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

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
yangqianqian
2026-06-16 11:30:22 +08:00
commit 6a2632da70
253 changed files with 27467 additions and 0 deletions

View File

@@ -0,0 +1,46 @@
---
paths:
- "src/components/**"
- "src/app/**"
- "src/pages/**"
- "src/stores/**"
---
# 前端开发规则Clover · Next.js
> 承接 前端交互设计.md5屏金标准+ API契约.md §3 DTO。
## 组件规范
- 单一职责:一个组件只做一件事
- Props 必须定义类型TypeScript interface
- 避免 prop drilling 超 3 层,用 Context 或状态管理
## DTO 对接堵官网V1坑4
- 所有 DTO 字段严格按 API契约§3**不许自己假设嵌套结构**
- 后端响应与契约不符立即报 Lead不私下适配
- workspace_id / product_id 不在前端传
## SSE异步生图电影
- 按 event_seq 去重,断线重连补发历史事件
- 11类事件按契约§2渲染0/N进度 + 谁好谁先冒 + 单批失败重试 + 能离开
- flywheel_injected 事件 → 显"本次已注入:最近偏好/打回原因"
## 样式
- 用 CSS Modules 或 Tailwind不用全局样式
- 响应断点统一sm(640) md(768) lg(1024) xl(1280)
- 颜色/间距用 design token不硬编码
## 可访问性
- 交互元素必须有 aria-label
- 图片必须有 alt 文本
- 键盘导航可用
## 红线CLAUDE.md
- ❌ 不展示 Token 余额、不做积分页key 去中转站后台看)
- ❌ 飞轮隐形:无"训练AI"按钮,只在生成时显注入提示
- ❌ 不做"自动发布到小红书"——只到确认预览
- ❌ 不做移动端(一期)
## 状态管理
- 4 个 Store任务 / 候选 / 审核 / 全局
- 异步态用骨架屏错误态对接契约§0错误码