diff --git a/AGENTS.local.bak.md b/AGENTS.local.bak.md new file mode 100644 index 0000000..d50c85a --- /dev/null +++ b/AGENTS.local.bak.md @@ -0,0 +1,103 @@ +# 水晶男孩推廣部 — AI 工作上下文 + +> 這個檔案讓 AI 在任何裝置（家／學校）都能快速恢復上下文。 +> **每次對話做了重要決定，請叫我更新這裡，然後 git commit。** + +--- + +## 專案簡介 + +水晶男孩（Sechs Kies）推廣粉絲網站。靜態 HTML + PHP + 原生 CSS/JS，無框架。 +站主（Noopy）2016 年入坑，藝廊式創作風格。 + +--- + +## 規範速查（詳細見 `developer-rules/rules/`） + +| 規範 | 檔案 | +|------|------| +| 改檔行為守則（必問再改） | `agent-must-ask.md` | +| 變更邊界（只改被點名的） | `ai-change-boundaries.md` | +| CSS 顏色 Token | `color-tokens.md` | +| 版面視覺預設 | `design-defaults.md` | +| Git commit 規範 | `git-commit-required.md` | +| 導覽邏輯（portal-nav） | `portal-nav-rules.md` | +| 文案語調 | `site-voice.md` | + +**最重要的三條：** +1. 沒說「執行」→ 不改檔 +2. 只改被點名的那一頁／區塊 +3. 改完必附 commit 指令（禁止在 sandbox 跑 git） + +--- + +## 架構重點 + +- **全站導覽**：`assets/js/portal-nav.js`（`COMING_SOON_PAGES` 控制開放） +- **全站 CSS**：`assets/css/style.css`（定義所有 color token） +- **首頁**：`index.html` +- **站主索引**（自用）：`extra/site-guide.html`（`data-portal-nav-all-open`，不對外） +- **內頁 header class**：`inner-page-header`（禁改回舊名） + +### variety/ 頁面 + +| 檔案 | 頁面標題 | 說明 | +|------|----------|------| +| `variety/bangxiao.html` | 世紀級寶藏 / 爆笑養老院 | 甜蜜負擔計量器；六人卡片選取 + jQuery 計算；CTA → `totoga2/ebook.html` | +| `variety/variety-shows.html` | 全員發瘋 | 綜藝節目存檔表；tabs + 搜尋；已對齊 albums.html 扁平結構 | +| `variety/NJTW/NJTW5.html` | 新西遊記5 | 各自暴走專頁 | + +--- + +## portal-nav 操作守則（血淚版） + +> 每次新增或修改導覽，必須先讀這裡再動手。 + +1. **先查 `extra/site-guide.html` 確認層級**，再動 `portal-nav.js`。 + site-guide 的 depth 數字 = nav 的層級：depth-1 是第一層 `
  • `，depth-2 是子選單項目，depth-3 是 subgroup 裡的巢狀項目。 + +2. **`COMING_SOON_PAGES` 只放檔名**（不含路徑）。 + `normalizePageKey` 只取 href 最後一段，所以 `variety/bangxiao.html` → 比對 `bangxiao.html`。 + +3. **直接連結不需要 subgroup**。 + 子選單內只要 `
  • ` 就夠；`portal-nav__subgroup` 只在該項目還有巢狀子項目時才用（例如「傳奇的轉折」有時間軸、電子書等四項）。 + +4. **site-guide.html 要同步更新**，否則站主索引頁會顯示舊名稱。 + +5. **commit 前網站不會更新**。本地端強制重整用 `Ctrl+Shift+R`；GitHub Pages 需 `git push` 後等約 1 分鐘。 + +--- + +## 目前工作狀態 + + + +**最後更新：** 2026-06-17 + +**進行中：** +- 無 + +**待確認：** +- developer-rules 健檢尚未執行 + +**已完成：** +- 建立 AGENTS.md 跨裝置上下文檔案 +- 新增 `variety/bangxiao.html`（世紀級寶藏 / 爆笑養老院，甜蜜負擔計量器） +- `variety/variety-shows.html` 重構：移除多層包裝，對齊 albums.html 扁平結構 +- portal-nav 新增世紀級寶藏，正確放入淪陷瞬間子選單 +- `extra/site-guide.html` 同步更新：全員發瘋 → 世紀級寶藏 + +--- + +## 如何使用這個檔案 + +換裝置後，告訴 AI： +> 「請先讀 AGENTS.md，再讀 developer-rules/rules/ 裡的所有規範，然後繼續 [任務]。」 + +## Imported Claude Cowork project instructions + +在這個專案資料夾中，有一個名為 developer-rules 的資料夾。 + +這是我們第一次合作，我不確定裡面目前記錄的規範是否完全正確、有沒有被之前亂寫的扣給弄髒。 + +請你在初始化專案後，立刻去徹底閱讀 developer-rules 裡的所有內容，並且不要盲目死背。請幫我仔細檢查、挑出裡面是否有前後矛盾、不夠乾淨、或是不符合現代高標準前端美感與 PHP 結構的規範。讀完後，請在我們的第一次對話中，條理分明地向我回報你的健檢結果，並給出優化建議，等我確認後我們再正式鎖定。 diff --git a/AGENTS.md b/AGENTS.md index abe976b..785f50d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -72,13 +72,15 @@ -**最後更新：** 2026-08-02 +**最後更新：** 2026-08-04 **進行中：** -- 水晶熱舞社重啟：30TH 報名與水晶練習室練舞清單已接上後臺；播放器本身仍待加入合法影片來源 +- 無 **待確認：** - developer-rules 健檢尚未執行 +- `sechskies_fans`（新獨立專案）本機尚未建 MySQL 資料庫、尚未跑過 `admin/setup.php`；Render 部署中，資料庫主機未定 +- `portal-nav.js` 新增的「水晶練習室」項目目前是 `data-coming-soon` 佔位（href=`#`），等 sechskies_fans 網址確定後要補上真實外部連結並移除 coming-soon 標記 **歷史定位（文案不可再寫錯）：** - 水晶熱舞社是水晶男孩粉絲自主成立的舞蹈社團，並非水晶男孩推廣部旗下組織 @@ -92,11 +94,8 @@ - portal-nav 新增世紀級寶藏，正確放入淪陷瞬間子選單 - `extra/site-guide.html` 同步更新：全員發瘋 → 世紀級寶藏 - 新增 `admin/` 推廣部後臺第一階段：登入、控制台、管理者帳號、通用 CRUD、媒體上傳及公開狀態總覽 -- 水晶熱舞社 30TH 募集表單已接上 PHP/PDO/MySQL，可儲存報名、參與內容與參考檔案 -- 後臺新增「30TH 應援報名」清單、搜尋、狀態處理、內部備註與受登入保護的檔案下載 -- 架構決定：水晶熱舞社暫時共用推廣部後臺；偶像培訓維持獨立資料邊界，之後另拆專案與登入系統 -- 水晶練習室的「練舞清單」已改為讀取 `dance_practice_items`，後臺可管理歌曲、分類、練習重點、影片網址、難度、進度、優先順序與公開狀態 -- 練舞清單初始資料沿用原頁面的 Couple、Com' Back、Road Fighter；偶像培訓的練習生／課程／紀錄未接入此資料表 +- 水晶熱舞社／水晶練習室／偶像練習生已於 2026-08-04 拆成獨立專案 `sechskies_fans`（另一個 repo，路徑 `d:\Developer\projects\sechskies_fans`，不在本站範圍）：30TH 應援報名表單、練舞清單、後台 CRUD 與管理者登入都已搬走並改用自己的資料庫；`extra/site-guide.html` 與本站 `admin/bootstrap.php`／`admin/database/schema.sql` 已同步移除相關項目 +- `portal-nav.js` 頂欄新增第 7 項「水晶練習室」（Yellow Note 之後），連到獨立專案 sechskies_fans；`extra/site-guide.html` 同步新增對應項目；目前是 coming-soon 佔位，尚未接上真實網址 --- diff --git a/SECHSKIES_Crystal_Dance_Survey_Notion_Export.md b/SECHSKIES_Crystal_Dance_Survey_Notion_Export.md deleted file mode 100644 index 74d2b85..0000000 --- a/SECHSKIES_Crystal_Dance_Survey_Notion_Export.md +++ /dev/null @@ -1,170 +0,0 @@ -# 水晶熱舞社頁面改版對話紀錄 - -> 來源：`yellow-note/crystal-dance-survey.html` 改版討論 -> 日期：2026-07-09 -> 用途：可貼上 Notion 的整理稿 - ---- - -## 一、任務目標 - -把 **水晶熱舞社** 頁（`yellow-note/crystal-dance-survey.html`）從「自創黃框、多層卡片、閱讀擁擠」改成： - -1. **對齊首頁／全站簡約風格**（黑底 + 白卡片 + 品牌黃） -2. **多套用全站 CSS**（`style.css` 的 `section`、`.section-title`、`.card` 語彙） -3. **熱舞社相關內容不刪**（可改外觀與排版） -4. **Bootstrap class 必須保留**（作業要求） -5. **表單區參考「見面會應援調查表」的 summer-form 邊框排版**，顏色仍用全站黃色 token - ---- - -## 二、核心原則（這次定下來的） - -| 原則 | 說明 | -|------|------| -| 內容優先 | 跟熱舞社相關的資訊不要刪；外觀排版可以改 | -| 只改被點名的頁 | 主要動 `crystal-dance-survey.html` | -| Bootstrap 保留 | `row` / `col` / `form-control` / `form-select` / `btn-check` / `ratio` 等 class 留下 | -| 顏色不動 | 用全站 `--color-brand` 系列，不改成參考圖的藍 | -| 美感對齊 | 參考 index 簡約乾淨 + 參考圖的留白與分階段框線 | - ---- - -## 三、舊版問題診斷 - -### 為什麼「怎麼看都不順眼」 - -1. **雙重／三重卡片** - 全站 `section` 本身已是圓角白卡片，頁內又加 `video-card`、`song-card`、`form-panel` → 盒子套盒子。 - -2. **約 400 行 inline CSS 重做設計系統** - 全站已有 `.card`、`.section-title`，卻自創多套黃框樣式。 - -3. **`info-card` 深色漸層突兀** - 跟全站暖白、輕盈感相反。 - -4. **導覽太吵** - 五顆黃色 pill 按鈕搶眼；首頁錨點是低調文字列。 - -5. **UX 問題（後續回饋）** - - 表單左右分欄難讀 - - 標題跟內容距離太近 - - 主影片寬度沒跟下方三支影片左右對齊 - - 文字擠在一起、閱讀節奏差 - ---- - -## 四、結構重組（6 區 → 3 區） - -### 備份 - -``` -yellow-note/crystal-dance-survey.backup-2026-07-09.html -``` - -（本地備份；改動前版本） - -### 新架構 - -| 新區塊 | ID | 合併來源 | 合併理由 | -|--------|-----|----------|----------| -| ① 認識水晶熱舞社 | `#about` | Hero + 熱舞社介紹 | 都在回答「這是什麼」 | -| ② 從 20TH 到 30TH | `#from-20th-to-30th` | 20TH 影片回顧 + 30TH 應援募集敘事 | 同一條時間軸：過去記憶 → 未來募集 | -| ③ 30TH 應援募集表單 | `#form-30th` | 表單區獨立 | Bootstrap 表單作業清楚；敘事講完才行動 | - -### 移除 - -- 整個 **經典舞曲區**（`#song-archive` 四張 song-card） -- 歌曲資訊不丟：表單「想練的歌曲」` - -
    - - -
    -
    取消
    - -prepare('SELECT COUNT(*) FROM dance_applications' . $whereSql); -$countStmt->execute($params); -$total = (int) $countStmt->fetchColumn(); -$pages = max(1, (int) ceil($total / $perPage)); -$page = min($page, $pages); -$offset = ($page - 1) * $perPage; - -$stmt = db()->prepare('SELECT * FROM dance_applications' . $whereSql . " ORDER BY created_at DESC, id DESC LIMIT $perPage OFFSET $offset"); -$stmt->execute($params); -$rows = $stmt->fetchAll(); - -render_header('30TH 應援報名', 'dance-applications'); -?> -
    -
    - - - -
    - 查看募集表單 -
    - -
    -

    報名清單

    共 筆；Email 與上傳檔案僅供企劃聯絡使用

    -
    - - - - - - - - - - - - - - - - - -
    編號暱稱Email想參與歌曲狀態送出時間操作
    #查看／處理
    目前沒有符合條件的報名資料。
    -
    - 1): ?> - - -
    -SECHSKIES Logo @@ -257,9 +257,9 @@
  • 影片
    • -
  • 世紀級寶藏
    • +
  • 世紀級寶藏
  • 完整的六顆
  • 現場的震撼
    • +
  • 水晶練習室
    • `.trim(); } diff --git a/extra/site-guide.html b/extra/site-guide.html index 15c2839..81b0290 100644 --- a/extra/site-guide.html +++ b/extra/site-guide.html @@ -143,6 +143,9 @@ +
  • + 水晶練習室（籌備中，外部連結待 sechskies_fans 部署完成後補上） +
  • 站內其他頁面（草稿／作業／備查，不在頂欄）
    • -
  • sechskies-admin-hw/（另一份學校作業，非本站，與上方水晶練習室頁面無關）
    • +
  • + 水晶熱舞社／水晶練習室／偶像練習生 → 已拆成獨立專案 sechskies_fans +
  • 待確認/（舊備份快照，滑鼠移入看說明）