create-dwy 0.8.0 → 0.9.1

package/templates/claude-global/rules/dwy-api-design.md

@@ -1,110 +0,0 @@
----
-description: 后端 API URL/响应格式/状态码/Schema 命名规范
-paths:
-  - "**/routers/**/*.py"
-  - "**/schemas/**/*.py"
-  - "**/services/**/*.py"
-  - "**/dependencies.py"
-  - "**/main.py"
----
-
-# API 设计规范
-
----
-
-## 一、URL 命名
-
-```
-基础格式: /api/{resource}
-
-GET    /api/users              # 列表(支持分页)
-POST   /api/users              # 创建
-GET    /api/users/{id}         # 详情
-PATCH  /api/users/{id}         # 部分更新
-DELETE /api/users/{id}         # 删除
-
-# 子资源
-GET    /api/users/{id}/orders  # 用户的订单列表
-
-# 动作(非 CRUD,用 POST + 动词)
-POST   /api/users/{id}/activate
-POST   /api/tasks/{id}/cancel
-POST   /api/tasks/{id}/retry
-```
-
-**规则:**
-- 资源名用复数、kebab-case:`/api/upload-tasks`(不是 `uploadTasks` 或 `upload_task`)
-- 路径参数用 `{id}` 不用 `{user_id}`(除非有歧义)
-- 查询参数用 snake_case:`?page_size=20&task_type=export`
-- 所有路由加 `/api` 前缀
-- 禁止在 URL 中包含动词(用 HTTP 方法区分),但非 CRUD 操作例外
-
-## 二、统一响应格式
-
-所有 API 使用 eapi response 模块的标准格式:
-
-**成功响应(`response.success()`):**
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": { ... },
-  "timestamp": 1712467200
-}
-```
-
-**分页响应(`response.paginated()`):**
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "items": [ ... ],
-    "total": 100,
-    "page": 1,
-    "page_size": 20
-  },
-  "timestamp": 1712467200
-}
-```
-
-**错误响应(eapi 异常处理器自动生成):**
-```json
-{
-  "code": "NOT_FOUND",
-  "message": "用户不存在"
-}
-```
-
-**禁止:** 自造响应格式、在 router 中手动构造 `{"success": true, ...}` 等非标准格式。
-
-## 三、HTTP 状态码
-
-| 场景 | 状态码 | 说明 |
-|------|--------|------|
-| 查询/更新成功 | 200 | GET / PATCH 默认 |
-| 创建成功 | 201 | POST 创建资源 |
-| 删除成功 | 204 | DELETE,无响应体 |
-| 参数错误 | 400 | 请求格式错误 |
-| 未认证 | 401 | Token 缺失或过期 |
-| 无权限 | 403 | 认证通过但权限不足 |
-| 资源不存在 | 404 | — |
-| 业务错误 | 422 | 参数合法但业务规则不允许 |
-
-## 四、Pydantic Schema 命名约定
-
-```python
-# 创建请求
-class UserCreate(BaseModel): ...
-
-# 更新请求(所有字段可选)
-class UserUpdate(BaseModel): ...
-
-# 响应
-class UserResponse(BaseModel): ...
-
-# 列表项(精简字段)
-class UserBrief(BaseModel): ...
-```
-
-请求和响应**必须分离**,禁止同一个 Schema 同时用于请求和响应。

package/templates/claude-global/rules/dwy-git-commit-convention.md

@@ -1,82 +0,0 @@
----
-description: Git commit message 规范(type 枚举、scope、中文 subject、提交前检查)
----
-
-# Git Commit 强制规范
-
-每次 `git commit` 前按顺序执行以下检查,任一步未通过则 **STOP,不得提交**。
-
-## Step 1: 分析变更
-
-`git diff --cached` 回答:这次改做了几件事?涉及哪些模块?
-
-**做了多件事(无法用 ≤72 字符 subject 清晰描述)→ 必须拆成多个 commit。**
-
-## Step 2: 确定 scope
-
-读当前项目 CLAUDE.md 的 `## Git Commit Scope` 段落:
-
-- **找到** → scope 从其中枚举值选,不得自造
-- **没找到** → 提醒用户:「当前项目 CLAUDE.md 未定义 Git Commit Scope,建议添加」,scope 可省略
-
-单模块变更 → **必须**带 scope;跨模块变更 → 省略 scope。
-
-## Step 3: 生成 message
-
-格式:`<type>(<scope>): <subject>` 或(无 scope)`<type>: <subject>`
-
-**type 枚举(只能从中选)**:
-
-| type | 用途 |
-|------|------|
-| feat | 新功能 |
-| fix | 修复 bug |
-| refactor | 重构(不改外部行为) |
-| chore | 构建/依赖/配置/发版等杂务 |
-| docs | 文档 |
-| test | 测试 |
-| perf | 性能优化 |
-| style | 代码格式(不影响逻辑) |
-| ci | CI/CD 配置 |
-
-**subject**:中文、无句号、≤72 字符、动宾短语(添加/修复/移除/重构/升级)。
-
-**body(可选)**:空一行后写;中文;只写 why 不复述 what;破坏性变更加 `BREAKING CHANGE:` 前缀(subject 用 `feat!:` / `fix!:` 标记)。
-
-## Step 4: 禁止大模型署名
-
-commit message(subject、body、footer、trailer)**禁止出现任何大模型/AI 工具相关内容**,覆盖系统默认的 `Co-Authored-By` 追加行为。
-
-**禁止出现的内容(不完全列举)**:
-
-- `Co-Authored-By: Claude ...` / `Co-Authored-By: GPT ...` / `Co-Authored-By: Copilot ...` 等 AI 署名 trailer
-- `Generated with Claude Code` / `🤖 Generated with ...` 等生成声明
-- `noreply@anthropic.com` / `noreply@openai.com` 等 AI 厂商邮箱
-- 任何提到 Claude / ChatGPT / GPT / Copilot / Cursor / AI / 大模型 / LLM 的字样
-
-**执行要点**:
-
-- `git commit -m "..."` 只写规范内容,**绝不**附加 `Co-Authored-By` trailer
-- 使用 HEREDOC 传 commit message 时,HEREDOC 内容也不得包含上述字样
-- 若发现暂存的 message 含大模型信息,**立即删除**后再提交
-
-## 常见错误 vs 正确
-
-| 错误 | 正确 |
-|------|------|
-| `feat: add user login`(英文) | `feat: 添加用户登录功能` |
-| `fix(eui): 修复了按钮样式。` | `fix(eui): 修复按钮样式`(无句号、不用"了") |
-| `feat: 添加登录并修复登出 bug` | 拆成两个 commit |
-| `update: 修改配置` | `update` 不在枚举,应为 `chore` |
-| `feat(auth): ...`(项目无 auth scope) | 用项目已定义的 scope 值 |
-| message 末尾加 `Co-Authored-By: Claude ...` | 不加任何 AI 署名 trailer |
-| `🤖 Generated with Claude Code` | 不加任何生成声明 |
-
-## 正确示例
-
-- `feat(eui): 添加 Image 组件,支持懒加载`
-- `fix: 修复 token 刷新竞态条件`
-- `refactor(backend): 提取分页逻辑为共享工具`
-- `chore: 升级 Vite 至 8.x`
-- `feat(eui)!: 重命名 EDialog open 属性为 v-model:open`
-  - body:`BREAKING CHANGE: EDialog 不再接受 visible 属性,请改用 v-model:open`

package/templates/claude-global/rules/dwy-git-security.md

@@ -1,53 +0,0 @@
----
-description: Git 提交前文件与敏感内容扫描规则(全局,每次 add/commit 都应检查)
----
-
-# Git 提交安全规则
-
-每次 `git add` 或 `git commit` 前按本规则扫描暂存区。发现违规**立即停止并提示用户确认**。
-
-## 一、禁止提交的文件
-
-| 类型 | 示例 |
-|---|---|
-| 环境变量 | `.env`, `.env.*`, `*.env` |
-| SSH 密钥 | `id_rsa`, `id_ed25519`, `*.pem`, `*.key` |
-| 证书 | `*.p12`, `*.pfx`, `*.jks`, `*.keystore` |
-| 数据库 | `*.sql`(含真实数据)、`*.dump`, `*.sqlite` |
-| 原始数据 | `*.xlsx`, `*.csv`(含用户/学生等敏感数据) |
-| 日志 | `*.log` |
-| Docker 卷 | `pgdata/`, `cache/*.json` |
-
-## 二、禁止提交的内容(敏感模式)
-
-**总则**:代码、文档、规则文件、注释里禁止出现真实的 API Key / Token / 密码 / IP / 凭证,即使作为"示例"也不行。GitHub Secret Scanning 不区分上下文,真实格式的 key 写在文档里也会触发泄露告警。示例必须用明显的假值(`sk-xxxxxxxxxxxx`、`your-key-here`、`192.168.x.x`)。
-
-| 类型 | 匹配模式 |
-|---|---|
-| API Key | `sk-[a-zA-Z0-9]{20,}` |
-| AWS Key | `AKIA[0-9A-Z]{16}` |
-| 密码赋值 | `password\s*[:=]\s*["'][^"']{4,}` |
-| 数据库连接串 | `://\w+:[^@\s]+@` |
-| 私钥内容 | `-----BEGIN (RSA \|EC )?PRIVATE KEY-----` |
-| Token | `token\s*[:=]\s*["'][a-zA-Z0-9_\-]{20,}` |
-| Secret | `secret\s*[:=]\s*["'][^"']{8,}` |
-| 服务器 IP+端口 | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}:\d+` |
-| SSH 连接 | `ssh\s+.*@\d{1,3}\.\d{1,3}` |
-
-**例外(不算违规)**:`.env.example` 里的占位符;从环境变量读取(`os.getenv("API_KEY")`);`localhost`/`127.0.0.1` 的连接串;文档里的假数据;配置文件的空字符串默认值。
-
-## 三、违规处理
-
-检测到违规时:
-
-1. **立即停止** `git add` / `git commit`
-2. **列出违规项**:文件 + 行号 + 匹配的敏感模式 + 脱敏摘要(如 `sk-5522****dc3`)
-3. **建议**:加入 `.gitignore` / 移到 `.env` / 用环境变量
-4. **等用户明确确认**后才能继续;确认提交时,commit body 附注释 `GIT-SECURITY: 用户已确认提交此内容`
-
-## 四、已提交敏感数据
-
-若发现已在 git 历史中:立即通知用户,**建议先轮换凭证**,然后提供清理命令(不自动执行,待确认):
-
-- `git filter-repo --path <file> --invert-paths --force`
-- 或 `bfg --delete-files <filename>`

package/templates/claude-global/rules/dwy-payload-limits.md

@@ -1,186 +0,0 @@
----
-description: 用户输入 / HTTP 请求体 / 文件上传的长度与大小限制。涉及表单字段 maxlength、Nginx client_max_body_size、Pydantic max_length、分页 page_size 上限、批量操作 items 限制、文件上传大小与像素校验时触发。
-paths:
-  - "**/*.vue"
-  - "**/*.py"
-  - "**/nginx*.conf"
----
-
-# 数据载荷三层长度限制规则
-
-防止大文本 DoS、内存耗尽、带宽滥用。所有涉及用户输入 / HTTP 请求体 / 文件上传的场景必须遵循三层限制,单层失守即高风险。
-
-本文件是"长度 / 大小 / 数量"规则的**唯一权威源**。其他规则文件(`dwy-server-security.md`、`dwy-python-security.md`)的对应章节只做引用,不重复定义。
-
-## 为什么需要三层
-
-- **前端 = UX 边界**:给用户即时反馈,避免无效输入浪费带宽和后端算力
-- **网关 = 流量边界**:Nginx / CDN / 负载均衡层拦截异常大请求,保护后端不被打满
-- **后端 = 业务边界**:字段级严格校验,阻断绕过前端的恶意请求
-- 三层职责不可互相替代。只靠前端易被绕过;只靠后端流量先耗在 TCP/TLS 握手和解析上;只靠网关无法挡住"多个小字段组合起来刚好达到 body 上限"的攻击
-
-三层数字必须对齐:**前端 maxlength ≤ 后端 max_length**,**后端字段累加加冗余 ≤ 网关 client_max_body_size**。
-
-## 第一层:前端输入限制
-
-### 强制规则
-
-- 所有 `<input type="text">` / `<input type="search">` / `<textarea>` 必须设 `maxlength` 属性
-- `@dwydev/eui` 的 `EInput` / `ETextarea` / 可搜索 `ESelect` / 可输入 `ETag` 必须传 `maxlength` prop
-- 富文本编辑器(tiptap / quill 等)必须配置字符数上限,超出禁止输入
-- 文件选择控件必须在前端预校验大小和 MIME 类型(`accept` 属性 + JS 二次校验)
-- 批量操作前端必须做分页 / 分批,不允许一次性超过 items 上限
-- 表单校验层必须用 zod `.max()` 再补一道,防粘贴 / 脚本绕过 HTML `maxlength`
-
-### 禁止事项
-
-- 禁止 `EInput` / `ETextarea` 不带 `maxlength` 上线
-- 禁止富文本编辑器无字符上限
-- 禁止"前端不限制,全部让后端兜底"
-- 禁止大文件(>10MB)走普通 API 中转
-
-### 示例
-
-```vue
-<!-- ✅ 正确 -->
-<EInput v-model="form.title" :maxlength="100" show-word-limit />
-<ETextarea v-model="form.desc" :maxlength="500" show-word-limit />
-
-<!-- ❌ 违规 -->
-<EInput v-model="form.title" />
-<ETextarea v-model="form.desc" />
-```
-
-配套 zod schema(vee-validate):
-
-```ts
-import { z } from 'zod'
-
-const schema = z.object({
-  title: z.string().max(100),
-  desc: z.string().max(500),
-})
-```
-
-## 第二层:网关 / 部署限制
-
-### 强制规则
-
-- Nginx `client_max_body_size` 必须显式配置,不允许使用默认值
-- 无文件上传业务时:全局 `client_max_body_size 1m`,**禁止** > `10m`
-- 有上传业务时:针对上传路径单独放宽(如 `location /api/upload` 设 `20m`),**禁止**全局放宽
-- 上传大文件(>10MB)必须走对象存储直传(MinIO / S3 预签名 URL),**禁止**走 API 中转
-- CDN / 负载均衡层的 body 限制和超时必须与 Nginx 数字对齐
-
-### 示例
-
-```nginx
-# server 块 — 全局默认
-client_max_body_size 1m;
-client_body_timeout 10s;
-client_header_timeout 10s;
-
-# 仅上传路径放宽
-location /api/upload {
-    client_max_body_size 20m;
-    proxy_pass http://127.0.0.1:8000;
-}
-```
-
-### 违规检测
-
-- Nginx 配置缺少 `client_max_body_size` 或值 > `10m` 但业务不是文件上传
-- 大文件上传路由走 API 中转而非对象存储直传
-- CDN 和 Nginx 的 body 上限不一致
-
-## 第三层:后端数据校验
-
-### 强制规则
-
-- Pydantic 每个 `str` 字段必须 `max_length`
-- Pydantic 每个 `list` 字段必须 `max_length`(限制数组元素数量)
-- `Query()` / `Path()` / `Header()` 参数同样必须 `max_length`
-- FastAPI 路由必须显式声明 Pydantic schema,**禁止** `data: dict` / `data: Any`
-- 分页 `page_size` 必须有 `le`(默认 `le=100`)
-- 后端不信任网关,必须在中间件做 request body 大小二次兜底(超出直接 413)
-- 图片上传除文件大小外,**必须**校验实际像素尺寸(Pillow `image.size`),防 decompression bomb
-- 文件大小后端二次校验,不信任前端声明的 `Content-Length`
-
-### 示例
-
-```python
-from pydantic import BaseModel, Field
-
-# ✅ 正确
-class UserCreate(BaseModel):
-    name: str = Field(max_length=32)
-    title: str = Field(max_length=100)
-    desc: str = Field(max_length=500)
-    tags: list[str] = Field(max_length=20)
-
-class ListParams(BaseModel):
-    page: int = Field(default=1, ge=1)
-    page_size: int = Field(default=20, ge=1, le=100)
-
-# ❌ 违规
-@router.post("/users")
-async def create_user(data: dict): ...
-
-class BadParams(BaseModel):
-    page_size: int = 20            # 无 le,攻击者可传 999999
-    name: str                       # 无 max_length
-    tags: list[str]                 # 无 max_length
-```
-
-> 说明:格式校验(`EmailStr` / 手机号 `pattern` / `HttpUrl` / 数字 `ge` / `le` 的数值范围)不是长度议题,仍归属 `dwy-python-security.md` §四,本文件不重复。
-
-## 统一尺寸参考表
-
-三层数字必须对齐。下表为全局默认,项目 CLAUDE.md 可为特殊业务覆盖个别字段(须显式说明原因)。
-
-| 场景 | 前端 maxlength | 后端 max_length | 网关 / 上传 |
-|------|---------------|----------------|-------------|
-| 用户名 | 32 | 32 | — |
-| 邮箱 | 254 | 254(RFC 5321) | — |
-| 密码(输入框) | 128 | 128 | — |
-| 手机号 | 20 | 20 | — |
-| 标题 / 短名称 | 100 | 100 | — |
-| 描述 / 摘要 | 500 | 500 | — |
-| 正文 / 评论 | 2000 | 2000 | — |
-| 富文本(HTML 串) | 100 KB | 100 KB | 走 body_size |
-| 搜索关键词 | 100 | 100 | — |
-| URL 字段 | 2048 | 2048 | — |
-| JSON body(默认) | — | 中间件兜底 1 MB | `client_max_body_size 1m` |
-| 图片上传(直发 API) | 前端预检 5 MB | 5 MB + 像素 `<= 8000×8000` | 上传路径 `10m` |
-| 通用小文件上传 | 前端预检 10 MB | 10 MB | 上传路径 `20m` |
-| 大文件(>10 MB) | — | — | 走对象存储直传,不过 API |
-| 批量接口 items | UI 分批 | `max_length=100` | — |
-| 查询分页 page_size | — | `le=100` | — |
-
-### 边界原则
-
-- 前端 `maxlength` ≤ 后端 `max_length`(前端更严,UX 明确)
-- 后端所有字段 `max_length` 总和加冗余 ≤ 网关 `client_max_body_size`
-- 超出表中范围的业务必须在项目 CLAUDE.md 中显式记录并说明原因
-
-## 全局禁止事项
-
-- 禁止任一层以"无限制"上线
-- 禁止三层数字互相冲突(例如前端 1000 但后端 100)
-- 禁止只靠前端 `maxlength` 而后端不校验
-- 禁止只靠后端 `max_length` 而前端不限
-- 禁止只靠网关 `client_max_body_size` 而无字段级 `max_length`
-
-## 违规检测
-
-发现以下任一情况,立即停止并提示用户:
-
-1. `.vue` 文件中 `EInput` / `ETextarea` 没有 `maxlength`
-2. 富文本组件(tiptap / quill)未配置字符上限
-3. Pydantic `BaseModel` 有 `str` 字段但未设 `max_length`
-4. Pydantic `BaseModel` 有 `list` 字段但未设 `max_length`
-5. FastAPI 路由以 `dict` / `Any` 作为 body 参数
-6. 分页参数无 `le` 上限
-7. Nginx 配置缺失 `client_max_body_size`,或值 > `10m` 但业务不是文件上传
-8. 上传 > 10MB 文件走 API 中转而非对象存储直传
-9. 图片上传仅校验文件大小而不校验像素尺寸

package/templates/claude-global/rules/dwy-prefer-open-source.md

@@ -1,32 +0,0 @@
----
-description: 优先使用成熟开源库,避免重复造轮子
----
-
-# 优先使用成熟开源方案
-
-开发新功能时，优先选用成熟的开源项目/库，而不是手写实现。只有在确认没有合适的开源方案时，才自行实现。
-
-## 决策流程
-
-```
-需要某项功能
-  → 1. 搜索是否有成熟的开源库（npm/PyPI/GitHub stars > 1k、近期有维护）
-    → 有：评估是否适配当前技术栈（Vue 3 / FastAPI / Node.js）
-      → 适配：直接使用，不重复造轮子
-      → 不适配：寻找替代方案
-    → 没有合适的：自行实现，但在代码注释中说明为什么没用现成方案
-```
-
-## 强制规则
-
-- **禁止**手写已有成熟方案的功能：日期处理(dayjs/date-fns)、HTTP 请求(axios)、表单校验(zod/vee-validate)、状态管理(pinia)、图表(echarts/chart.js)、富文本(tiptap/quill)、拖拽(vuedraggable/dnd-kit)、虚拟滚动(@tanstack/virtual)、Markdown 渲染(markdown-it)、模糊搜索(fuse.js)
-- **禁止**手写加密/哈希/JWT 算法，必须使用 bcrypt/jose/crypto 等标准库
-- 选用开源库时，优先选择：项目已在用的依赖 > 社区主流方案 > 小众但适合的方案
-
-## 例外情况
-
-以下情况允许自行实现：
-- 功能极其简单（< 20 行），引入一个库反而增加复杂度
-- 开源库有严重的安全漏洞或已停止维护
-- 开源库的依赖体积过大，与需求不成比例
-- 项目有特殊定制需求，开源库无法满足且改造成本高于自建

package/templates/claude-global/rules/dwy-project-structure.md

@@ -1,181 +0,0 @@
----
-description: 后端/前端/Flutter/Monorepo 项目目录结构模板(按项目入口文件触发)
-paths:
-  - "**/package.json"
-  - "**/pyproject.toml"
-  - "**/pubspec.yaml"
-  - "**/pnpm-workspace.yaml"
----
-
-# 项目目录结构模板
-
-AI 创建文件时**必须**遵循以下目录结构,不得自造目录名或层级。
-
----
-
-## 一、后端项目(FastAPI)
-
-```
-backend/
-├── src/app/
-│   ├── __init__.py
-│   ├── main.py              # FastAPI 应用入口 + lifespan
-│   ├── config.py             # 继承 eapi BaseSettings
-│   ├── database.py           # create_async_engine_factory + create_session_factory
-│   ├── dependencies.py       # FastAPI Depends(get_db, get_current_user)
-│   ├── exceptions.py         # 项目级异常(继承 eapi AppError)
-│   ├── validators.py         # 输入校验工具(防注入等)
-│   ├── models/               # SQLAlchemy ORM 模型
-│   │   ├── __init__.py
-│   │   ├── user.py           # 每个实体一个文件
-│   │   └── ...
-│   ├── schemas/              # Pydantic v2 请求/响应模型
-│   │   ├── __init__.py
-│   │   ├── user.py           # UserCreate, UserUpdate, UserResponse
-│   │   └── ...
-│   ├── routers/              # FastAPI 路由(按业务域拆分)
-│   │   ├── __init__.py
-│   │   ├── auth.py           # 认证端点
-│   │   ├── user.py           # 每个业务域一个文件
-│   │   └── ...
-│   ├── services/             # 业务逻辑层
-│   │   ├── __init__.py
-│   │   ├── auth.py
-│   │   ├── user.py           # 与 router 同名,一一对应
-│   │   └── ...
-│   ├── tasks.py              # ARQ 任务注册(@register 装饰器)
-│   └── worker.py             # ARQ Worker 入口
-├── alembic/                  # 数据库迁移
-│   ├── versions/             # 迁移文件
-│   ├── env.py
-│   └── alembic.ini
-├── scripts/                  # 初始化/运维脚本
-│   ├── init_db.py            # 初始化数据库表结构
-│   └── seed_admin.py         # 创建初始管理员
-├── tests/
-│   ├── conftest.py           # pytest fixtures(SQLite 内存库、mock)
-│   ├── test_auth.py          # 与 routers/ 同名
-│   └── ...
-├── pyproject.toml            # UV 依赖配置
-├── Dockerfile.dev            # 开发容器(--reload)
-├── Dockerfile.prod           # 生产容器(只读、non-root)
-├── .env.example              # 环境变量模板
-└── TEST_CASES.md             # 测试用例清单
-```
-
-**强制规则:**
-- 分层:`routers → schemas → services → models → database`,不可跨层调用
-- services 层抛 eapi 异常(AppError 子类),**不抛 HTTPException**
-- routers 层只做参数接收和 response 包装,**不写业务逻辑**
-- models/ schemas/ routers/ services/ 四个目录内文件按业务域一一对应
-
----
-
-## 二、前端项目(Vue 3)
-
-```
-frontend/
-├── src/
-│   ├── main.ts               # createApp + 插件注册
-│   ├── App.vue               # 根组件
-│   ├── router/
-│   │   └── index.ts          # Vue Router 配置 + 守卫
-│   ├── stores/               # Pinia Setup Store
-│   │   ├── auth.ts           # 认证状态
-│   │   └── ...
-│   ├── api/                  # HTTP 客户端(按业务域拆分)
-│   │   ├── client.ts         # ekit createRequest() 实例
-│   │   ├── auth.ts           # 登录/注册接口
-│   │   ├── user.ts           # 用户接口
-│   │   └── ...
-│   ├── views/                # 页面级组件(路由对应)
-│   │   ├── LoginView.vue
-│   │   ├── DashboardView.vue
-│   │   └── ...
-│   ├── components/           # 共享 UI 组件(非页面级)
-│   ├── composables/          # Vue 3 组合式函数(use* 前缀)
-│   ├── utils/                # 纯工具函数
-│   └── index.css             # Tailwind CSS 入口
-├── tests/
-│   ├── api/
-│   ├── stores/
-│   ├── router/
-│   └── utils/
-├── package.json
-├── vite.config.ts
-├── tsconfig.json
-├── Dockerfile                # 生产构建(多阶段)
-└── TEST_CASES.md
-```
-
-**强制规则:**
-- views/ 放页面组件(路由直接引用),components/ 放复用组件
-- api/ 每个文件对应后端一个 router 模块,保持命名一致
-- stores/ 统一 Setup Store 写法(`export const useXxxStore = defineStore('xxx', () => {...})`)
-
----
-
-## 三、Flutter 项目
-
-```
-lib/
-├── main.dart                  # runApp + ProviderScope
-├── app.dart                   # MaterialApp.router + GoRouter
-├── core/
-│   ├── config/
-│   │   └── env.dart           # 环境配置
-│   ├── network/
-│   │   ├── dio_client.dart    # Dio 实例 + 拦截器
-│   │   └── api_response.dart  # 统一响应模型(对齐 eapi 格式)
-│   ├── storage/
-│   │   └── secure_storage.dart
-│   ├── theme/
-│   │   └── app_theme.dart     # ThemeData + 设计 tokens
-│   └── utils/
-├── features/                  # 按功能模块拆分(feature-first)
-│   └── {feature_name}/
-│       ├── data/
-│       │   ├── {feature}_repository.dart   # Repository 实现
-│       │   └── {feature}_dto.dart          # 数据传输对象
-│       ├── domain/
-│       │   └── {feature}_entity.dart       # 领域实体
-│       └── presentation/
-│           ├── {feature}_page.dart         # 页面
-│           ├── {feature}_provider.dart     # Riverpod Provider
-│           └── widgets/                    # 功能内专属 Widget
-├── shared/
-│   ├── providers/             # 全局 Provider(auth, theme)
-│   ├── widgets/               # 跨功能共享 Widget
-│   └── models/                # 共享数据模型
-test/
-├── features/
-│   └── {feature_name}/
-└── core/
-```
-
-**强制规则:**
-- features/ 按功能模块拆分,每个模块自包含 data/domain/presentation
-- core/ 放全局基础设施(网络、存储、主题),不放业务代码
-- shared/ 放跨功能共享的 provider/widget/model
-
----
-
-## 四、Monorepo 项目结构(pnpm workspace)
-
-当项目包含前端 + 后端时,使用 monorepo:
-
-```
-project-root/
-├── backend/                   # FastAPI 后端(上述第一节结构)
-├── frontend/                  # Vue 前端(上述第二节结构)
-├── mobile/                    # Flutter 移动端(上述第三节结构,独立管理)
-├── docker-compose.dev.yml     # 开发环境
-├── docker-compose.prod.yml    # 生产环境
-├── dev.sh                     # 一键启动脚本
-├── pnpm-workspace.yaml        # pnpm monorepo 配置
-├── package.json               # 根 package.json(scripts)
-├── CLAUDE.md                  # 项目规范
-└── .env.example               # 全局环境变量模板
-```
-
-**注意:** Flutter 项目(mobile/)不纳入 pnpm workspace,独立用 `flutter pub get` 管理依赖。