feat 專案設計規範

This commit is contained in:
2026-05-15 02:00:02 +08:00
parent e5b98f32e2
commit 0e64e5d571
7 changed files with 152 additions and 55 deletions
+14 -1
View File
@@ -20,8 +20,21 @@ alwaysApply: true
- 若需求可能影響多檔(導覽、首頁、共用 CSS):**先問**「是否只改 A,還是 B/C 也要一起?」再改。
## 站主版面與元件預設(設計大原則)
以下為全站/新區塊的**預設假設**,不必每個區域重複交代;若該次需求明講例外再打破。
- **同一列/並排多欄**:預設 **等高**(例如 flex 同列 `align-items: stretch`、grid 同列對齊高度),除非該次明講要頂對齊或其他非等高編排。
- **同一層級、同類可重複元件**(例如多張 **CARD**、同一 pattern 的 tile):預設 **等寬**(同一 breakpoint 下寬度一致),除非明講破格。
- **短字層**(站主慣稱「十字以內」——極短標、標籤、一句內等級,語意上不要硬拆成兩行):盡量 **單行、不換行**;**水平置中**(置中)。
- **超過短字層的標題或內文**:允許自然換行;**置左**對齊。
- **捲軸**:一般區塊 **不要**出現內嵌捲軸(避免預設 `overflow: auto/scroll` 把版面變成「盒子裡再拖條」);**只有**站主對該區曾**明講**要可捲動或強烈規定的例外才做捲動容器。
實作時仍以「只改被點名範圍」為上;若要拉一套新 grid/卡片列,優先在本區父層加 class,避免為了對齊去改未點名的全站共用規則。
## 文件與規則檔
- **不要**主動新增或長篇修改 `README`、`docs/*.md`、規則檔,除非使用者明講要寫入文件或規範。
- **例外**:使用者要求「把約定寫死/規則講清楚/不要再做錯」時,得**精準**更新 `.cursor/rules`(與 `portal-nav.js` 頂部註解對齊),避免重複踩雷;仍避免無關長文。
(與導覽開放、頂欄 vs `site-guide` 相關條文以 **`user-scope-and-nav.mdc`** 為準。)
(與導覽開放、頂欄 vs `site-guide` 相關條文以 **`user-scope-and-nav.mdc`**、**`portal-nav-rules.mdc`** 為準;實作前兩份都讀。)