109 lines
4.9 KiB
Markdown
109 lines
4.9 KiB
Markdown
# 水晶男孩推廣部 — 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 是第一層 `<li>`，depth-2 是子選單項目，depth-3 是 subgroup 裡的巢狀項目。
|
||
|
||
2. **`COMING_SOON_PAGES` 只放檔名**（不含路徑）。
|
||
`normalizePageKey` 只取 href 最後一段，所以 `variety/bangxiao.html` → 比對 `bangxiao.html`。
|
||
|
||
3. **直接連結不需要 subgroup**。
|
||
子選單內只要 `<li><a>` 就夠；`portal-nav__subgroup` 只在該項目還有巢狀子項目時才用（例如「傳奇的轉折」有時間軸、電子書等四項）。
|
||
|
||
4. **site-guide.html 要同步更新**，否則站主索引頁會顯示舊名稱。
|
||
|
||
5. **commit 前網站不會更新**。本地端強制重整用 `Ctrl+Shift+R`；GitHub Pages 需 `git push` 後等約 1 分鐘。
|
||
|
||
---
|
||
|
||
## 目前工作狀態
|
||
|
||
<!-- 每次對話結束後更新這個區塊 -->
|
||
|
||
**最後更新：** 2026-08-02
|
||
|
||
**進行中：**
|
||
- 水晶熱舞社重啟：30TH 報名與水晶練習室練舞清單已接上後臺；播放器本身仍待加入合法影片來源
|
||
|
||
**待確認：**
|
||
- developer-rules 健檢尚未執行
|
||
|
||
**歷史定位（文案不可再寫錯）：**
|
||
- 水晶熱舞社是水晶男孩粉絲自主成立的舞蹈社團，並非水晶男孩推廣部旗下組織
|
||
- 水晶歌詞社、水晶嘻哈社等其他「社」是當時同好為了好玩延伸的稱呼
|
||
- 2017 年 20 週年正式應援由「水晶男孩應援站」企劃與執行；應援站看見水晶熱舞社其中部分成員持續練舞後，邀請這些成員擔任活動的舞蹈小組長，相關影片為該次合作紀錄
|
||
|
||
**已完成：**
|
||
- 建立 AGENTS.md 跨裝置上下文檔案
|
||
- 新增 `variety/bangxiao.html`（世紀級寶藏 / 爆笑養老院，甜蜜負擔計量器）
|
||
- `variety/variety-shows.html` 重構：移除多層包裝，對齊 albums.html 扁平結構
|
||
- portal-nav 新增世紀級寶藏，正確放入淪陷瞬間子選單
|
||
- `extra/site-guide.html` 同步更新：全員發瘋 → 世紀級寶藏
|
||
- 新增 `admin/` 推廣部後臺第一階段：登入、控制台、管理者帳號、通用 CRUD、媒體上傳及公開狀態總覽
|
||
- 水晶熱舞社 30TH 募集表單已接上 PHP/PDO/MySQL，可儲存報名、參與內容與參考檔案
|
||
- 後臺新增「30TH 應援報名」清單、搜尋、狀態處理、內部備註與受登入保護的檔案下載
|
||
- 架構決定：水晶熱舞社暫時共用推廣部後臺；偶像培訓維持獨立資料邊界，之後另拆專案與登入系統
|
||
- 水晶練習室的「練舞清單」已改為讀取 `dance_practice_items`，後臺可管理歌曲、分類、練習重點、影片網址、難度、進度、優先順序與公開狀態
|
||
- 練舞清單初始資料沿用原頁面的 Couple、Com' Back、Road Fighter；偶像培訓的練習生／課程／紀錄未接入此資料表
|
||
|
||
---
|
||
|
||
## 如何使用這個檔案
|
||
|
||
換裝置後，告訴 AI：
|
||
> 「請先讀 AGENTS.md，再讀 developer-rules/rules/ 裡的所有規範，然後繼續 [任務]。」
|
||
|
||
## Imported Claude Cowork project instructions
|