docs(claude): CLAUDE.md 对齐现状 — core/ 为开发目录、电商AI平台/ 为视觉标准答案

- 根 CLAUDE.md:删死目录(app//v2/);设计铁律从"改HTML/restraint.css"改为"改core/前端React+design-restraint.css";路径速查补 core/ 真实路径;新增认证定调(用户名+密码+邀请制,不用邮箱)
- design/CLAUDE.md:空模板参数表填为 AirShelf 真实值(React19/Vite7/自研路由/纯CSS/design-restraint.css/lucide/1440x900)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
seaislee1209
2026-06-19 03:10:19 +08:00
co-authored by Claude Opus 4.8
parent 856a93b8a9
commit afa8e07154
2 changed files with 38 additions and 25 deletions
+12 -10
View File
@@ -12,19 +12,21 @@
| 参数 | 本项目取值 | 说明 |
|---|---|---|
| 前端框架 | (如 React 19 / Vue 3 / Svelte) | 必须与目标工程一致;全新项目默认 React + TypeScript |
| 构建工具 | (如 Vite | 默认 Vite |
| 路由方案 | (目标工程现有方案) | 复用目标工程的路由机制,不自带新路由库 |
| 样式方案 | (如纯 CSS / Tailwind / CSS Modules | 与目标工程一致;目标工程没有的方案不准引入 |
| 组件/图标库 | (目标工程已有的) | 只用已有的,不新增 UI 框架和图标库 |
| 设计 token 文件 | (如 `src/styles.css` / `tokens.css` | 颜色字号间距唯一来源 |
| 基准视口 | (如 1440×900 | 像素核对和验收用的视口 |
| 页面文件落位 | (如 `src/routes/` + `src/<page>.css` | 与目标工程目录同构 |
| Mock 数据落位 | (如 `src/mock/` | 见 §4 |
| 类型定义文件 | (如 `src/types.ts`,可空) | mock 字段形状对齐目标 |
| 前端框架 | **React 19 + TypeScript** | 代码在 `core/frontend` |
| 构建工具 | **Vite 7** | — |
| 路由方案 | **自研 pathname 路由** `core/frontend/src/routes/route-config.ts`(无路由库,switch 渲染) | 新页面在此加一条,不引路由库 |
| 样式方案 | **纯 CSS**(全局 token + 每页 `*-page.css`,选择器收敛在页面根 class) | 不引 Tailwind / CSS Modules |
| 组件/图标库 | **lucide-react**(图标);无额外 UI 框架 | 只用 lucide,不新增图标库 |
| 设计 token 文件 | **`core/frontend/src/design-restraint.css`**(对应规范 `电商AI平台/design.md`) | 颜色/字号/间距唯一来源;改 token 破坏全站 |
| 基准视口 | **1440×900** | 像素核对(`core/qa/visual-parity/compare-page.mjs`)的视口 |
| 页面文件落位 | **`core/frontend/src/routes/<page>.tsx` + `src/<page>-page.css`** | 与工程目录同构 |
| Mock 数据落位 | **已接真实后端 API**(`core/frontend/src/api.ts`);新页若需 mock,用一层 `getXxx()` 取数函数 | 见 §4 |
| 类型定义文件 | **`core/frontend/src/types.ts`** | mock 字段形状对齐 |
> 目标工程尚不存在(全新项目)时:默认 React + TypeScript + Vite + 纯 CSS,并把你定下的取值回填此表,作为后续开发工程的初始约定。
> **本项目(AirShelf)现状**:目标工程已存在 = `core/frontend`;**视觉标准答案** = `电商AI平台/` 的 `*.html` 设计稿 + `design.md` 设计规范。**还原老页面**时逐页对照对应 HTML(像素级);**出新页面**按本规范直接交付 React,不要再画静态 HTML。认证一律用户名+密码、不用邮箱(见根 `CLAUDE.md`)。
## 1. 交付物形态(最重要的一条)
每个页面的交付物固定为: