docs: update LLM guides for models and layout rules
Document new GUIDE.md expectations for src-layer edits and add index entries for models and shared types. Clarify layout usage, composable placement, error page conventions, and model/type ownership so future changes follow the intended layer boundaries.docs: update LLM guides for models and layout rules Document new GUIDE.md expectations for src-layer edits and add index entries for models and shared types. Clarify layout usage, composable placement, error page conventions, and model/type ownership so future changes follow the intended layer boundaries.
This commit is contained in:
@@ -30,6 +30,8 @@
|
||||
| AppShell、tabs、global overlays | `src/shell/GUIDE.md` |
|
||||
| Pinia store | `src/stores/GUIDE.md` |
|
||||
| HTTP service / ky / API module | `src/services/GUIDE.md` |
|
||||
| domain model 與 page model 型別 | `src/models/GUIDE.md` |
|
||||
| 跨模組共用 API 型別 | `src/types/GUIDE.md` |
|
||||
| i18n 文案 | `src/language/GUIDE.md` |
|
||||
|
||||
## 預設修改策略
|
||||
@@ -57,6 +59,9 @@
|
||||
- layout / AppShell / tabs / global overlay:讀 `src/shell/GUIDE.md` 與 `src/components/layouts/GUIDE.md`。
|
||||
- API 串接:讀 `src/services/GUIDE.md`。
|
||||
- 跨頁共享狀態:讀 `src/stores/GUIDE.md`。
|
||||
- 定義 page model 或 domain model 型別:讀 `src/models/GUIDE.md`。
|
||||
- 共用 API 型別定義:讀 `src/types/GUIDE.md`。
|
||||
- 錯誤頁:讀 `src/views/GUIDE.md`(ErrorShell 模式)與 `src/router/GUIDE.md`(錯誤頁路由慣例)。
|
||||
- 語系文案:讀 `src/language/GUIDE.md`。
|
||||
|
||||
## 修改前檢查
|
||||
@@ -67,6 +72,7 @@
|
||||
- 是否應拆成 page / section / item。
|
||||
- 是否應新增 page driver 或 command composable。
|
||||
- 是否需要 store,或只需要頁面內 state。
|
||||
- 是否應定義新的 model 型別(`src/models/`)。
|
||||
- 是否需要更新語系、menu、breadcrumb、favorites。
|
||||
|
||||
## 完成前驗證
|
||||
|
||||
Reference in New Issue
Block a user