docs: update LLM guides for completed architecture phase

Refresh the development guidance to point to layered src GUIDE files and document Phase 4 completion, including AppShell extraction and page driver/component adoption for non-maintenance pages.docs: update LLM guides for completed architecture phase Refresh the development guidance to point to layered src GUIDE files and document Phase 4 completion, including AppShell extraction and page driver/component adoption for non-maintenance pages.
2026-05-19 17:17:43 +08:00
parent 51fbbd7101
commit ac7e1959cf
15 changed files with 400 additions and 1074 deletions
@@ -0,0 +1,22 @@
+# Layouts Guide
+
+`components/layouts` 是 app shell layout。一般功能需求不應修改這裡。
+
+## MainLayout 責任
+
+- drawer
+- app bar
+- breadcrumb
+- favorites
+- toolbar actions
+- 主內容 slot
+
+## 禁止放入
+
+- 頁面專屬業務流程
+- 查詢條件、表單、列表、CRUD
+- 特定 dialog 內容
+- API 呼叫
+- domain-specific 狀態
+
+如果頁面要影響 breadcrumb、favorites、menu 或 toolbar，優先使用 route meta、store 或 `shell/AppShell.vue` 已提供的 props/events。