| 12345678910111213141516171819202122 |
- ---
- description: VOC SaaS UI 升级时先查组件索引和字段契约，禁止新造一套卡片/页头。
- alwaysApply: true
- ---
- # SaaS UI / Agent 定位
- 改页面或组件前先读：
- 1. `docs/SAAS-UPGRADE-PLAN.md` — 三种页面、字段必填/预留、路由、波次文件所有权
- 2. `docs/COMPONENT-INDEX.md` — 选择器 → 目录，禁止再造页头/指标卡/表格壳
- 3. `docs/SAAS-UI-UPGRADE.md` — 视觉 token（shadcn Neutral，炭黑主按钮）
- 定位：共享组件在 `src/modules/shared/components/<name>/`，路由在 `src/app/app.routes.ts`，色板在 `src/modules/shared/styles/_tokens.scss`。
- 硬约束：
- - 预留字段为空显示 `—`，不编数字、不编评论
- - 实体用独立子路由；抽屉只留给创建/筛选/预览
- - 不执行 `npx shadcn@latest init`，不引入 Material / ng-zorro / Tailwind
- - 不改 `styles.scss` 里 `.ai-visual-report-html`
- - 新组件必须在 `COMPONENT-INDEX.md` 补一行
|
