---
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` 补一行