一個由社團成員共同維護的平台，用來整合資訊、分享教學資源，以及記錄我們在機器人世界裡走過的每一步。
這是中臺科技大學機器人研究社的官方網站，目前持續開發中。
我們希望這個網站不只是一個公告欄，而是一個讓社員真正會用到的地方——查競賽時間、跟著課程學習、分享實作成果。每一個功能的設計，都從「社員實際需要什麼」出發。
網站本身也是我們的一個實踐場：從架構選型到 UI 細節，從認證系統到響應式設計，這個專案讓我們在社團課以外，有機會碰到真實的工程問題。
| 功能模組 | 狀態 |
|---|---|
| 全新首頁（動態視覺、互動模組） | ✅ 已上線 |
| 競賽資訊與報名系統 | ✅ 已上線 |
| 社團行事曆 | ✅ 已上線 |
| 新聞公告（Markdown 渲染、圖片輪播、上下篇導覽） | ✅ 已上線 |
| 文件中心（社章、隱私權政策等） | ✅ 已上線 |
| 響應式設計（手機／平板／桌機） | ✅ 全頁面覆蓋 |
| Supabase 認證系統（多角色權限、身分驗證） | ✅ 已完成 |
| 課程系統（學期制、章節課程、程式碼片段、審核流程） | ✅ 已上線 |
| 管理後台（Dashboard、課程、社員、審核、新聞、行事曆） | ✅ 已上線 |
使用者個人頁面（/@username，含個人資料編輯） |
✅ 已上線 |
| 帳號設定中心（安全、資料匯出、刪除帳號、權限管理） | ✅ 已上線 |
| 多語系支援（i18n，zh-TW / en） | ✅ 已上線 |
| 行動端 API（iOS App 支援） | ✅ 已上線 |
| 經驗值與成就系統 | 🔨 開發中 (v2.5) |
| 社群發文平台（追蹤、發文、互動） | 📋 規劃中 (v3.0) |
| 3D 模型展示（React Three Fiber） | 🔬 研究中 |
將課程認證記錄轉換為經驗值，並根據累積進度或特定課程完成情況解鎖成就徽章。讓學習過程更有目標感與成就感。
v3.0 是一次全面性的大版本更新，目標是將課程系統、個人帳號、社群平台、經驗值與成就系統串連成一個互相連動的完整體驗。社員可以在同一個平台上學習、記錄成長、分享成果、與其他成員互動，讓網站從工具集合演進為真正意義上的社團平台。
- Next.js 16（App Router） — SSR／SSG、路由管理、API Routes
- React 19 — Server Components、Hooks
- TypeScript — 全面型別覆蓋，確保可維護性
- SCSS Modules — 主要樣式方案，支援巢狀選擇器與變數管理
- Tailwind CSS v4 — 輔助使用，處理快速排版需求
- Framer Motion / React Spring — 動畫與首頁互動效果
- FontAwesome & Lucide React — 圖示系統
- Supabase — 使用者認證（Email + Google OAuth）、PostgreSQL 資料庫、Row Level Security (RLS)
- Firebase — 部分資料服務（競賽、課程內容等，持續遷移至 Supabase 中）
- React Hook Form + Yup — 表單驗證
- FullCalendar — 社團行事曆
- React Markdown + Highlight.js — Markdown 渲染與語法高亮
- Next-Intl — 多語系支援（
[locale]路由架構） - Nuqs — URL 查詢參數管理
- Vercel — 部署平台
- Vercel Analytics / Speed Insights — 效能監控
- Google Analytics / Search Console — 流量分析與 SEO
- React Three Fiber + Drei — 未來用於 3D 模型展示
.
├── app/
│ ├── api/ # 行動端與後端 API 路由（iOS App 支援）
│ ├── [locale]/ # 多語系路由根節點（zh-TW / en）
│ │ ├── [username]/ # 個人主頁與個人資料編輯
│ │ ├── about/ # 關於社團
│ │ ├── admin/ # 超級管理員後台
│ │ ├── auth/ # 認證（登入、Google OAuth）
│ │ ├── calendar/ # 社團行事曆
│ │ ├── competitions/ # 競賽資訊與報名
│ │ ├── courses/ # 課程前台
│ │ ├── dashboard/ # 管理後台（課程、社員、審核、新聞、行事曆）
│ │ ├── docs/ # 社團文件（社章、隱私權政策等）
│ │ ├── news/ # 新聞公告
│ │ ├── onboarding/ # 註冊身分驗證流程
│ │ └── settings/ # 帳號設定中心
│ ├── components/ # 共用元件庫
│ ├── contexts/ # React Context（Auth、Theme 等）
│ ├── hooks/ # 自訂 Hooks
│ ├── styles/ # SCSS 變數與全域樣式
│ ├── types/ # TypeScript 型別定義
│ └── utils/ # 工具函式與服務層（Supabase、Firebase 等）
├── messages/ # i18n 翻譯檔（zh-TW、en）
├── i18n/ # 國際化配置
├── public/ # 靜態資源（Assets、Icons）
└── README.md
本專案使用 pnpm 管理套件。
# 安裝依賴
pnpm install
# 啟動開發伺服器
pnpm dev開啟瀏覽器前往 http://localhost:3000。
環境變數：請參考 .env.example（即將提供），你需要取得 Supabase 與 Firebase 的相關金鑰才能完整執行各項功能。
如果你是社團成員，對網站有任何想法——不管是發現問題、有功能建議，還是想實際動手改，都非常歡迎。
在提交程式碼前，請留意：
- 樣式以 SCSS Modules 為主，輔以 Tailwind CSS v4
- 新增功能請搭配 TypeScript 型別定義
- 元件結構遵循 feature-based 目錄規則
- 路由位於
app/[locale]/下，新頁面需注意多語系架構
有任何問題，也可以直接找社團幹部討論。
| 版本 | 日期 | 主要更新 |
|---|---|---|
| v2.4.0 | 2026-06-11 | 帳號設定中心、安全功能、權限管理統一至控制台 |
| v2.3.7 | 2026-06-01 | 網站地圖重構、分析腳本 Hydration 修正 |
| v2.3.6 | 2026-05-30 | 新聞上下篇導覽、原生動態 Sitemap |
| v2.3.5 | 2026-05-28 | 通用 Table 元件、Dashboard 管理頁面重構 |
| v2.3.0 | 2026-05-14 | i18n 多語系架構、新聞模組、後台擴充、全站 SEO 強化 |
| v2.2.6 | 2026-04-11 | 課程平台 UI 優化、管理後台架構重構 |
| v2.2.5 | 2026-04-08 | 程式碼片段管理系統、課程內容渲染優化 |
| v2.2.4 | 2026-03-31 | 個人資料編輯、server-side 使用者服務拆分 |
| v2.2.1 | 2026-03-30 | 正式開放登入系統 |
| v2.2.0 | 2026-03-30 | 課程管理系統、社員驗證流程與後台管理架構 |
| v2.1.4 | 2026-03-26 | 權限驗證重構、管理控制台初步上線 |
| v2.1.0 | 2026-03-13 | Supabase 認證整合、個人頁面系統 |
| v2.0.0 | 2026-03-01 | 首頁全面改版，v2 系列正式啟動 |
© 中臺機器人研究社 · Robot Research Club of CTUST