Add Gitea setup documentation

.claude/settings.local.json

@@ -4,7 +4,9 @@
       "Bash(git init:*)",
       "Bash(git remote add:*)",
       "Bash(git config:*)",
-      "Bash(git add:*)"
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)"
     ],
     "deny": [],
     "ask": []

docs/GITEA_SETUP.md

@@ -0,0 +1,153 @@
+# Gitea Repository 設定指南
+
+## 連線資訊
+
+- **Gitea URL**: https://gitea.theaken.com/
+- **使用者**: donald
+- **Token**: 9e0a888d1a25bde9cf2ad5dff2bb7ee6d68d6ff0
+
+## 設定步驟
+
+### 1. 在 Gitea 上建立 Repository
+
+由於系統不允許透過 push 自動建立 repository，需要先在 Gitea 上手動建立：
+
+1. 登入 Gitea: https://gitea.theaken.com/
+2. 點擊右上角的 "+" 按鈕
+3. 選擇 "新建倉庫" (New Repository)
+4. 填寫以下資訊：
+   - **倉庫名稱**: `hr-performance-system`
+   - **可見性**: 私有 (Private) 或 公開 (Public)
+   - **描述**: HR 績效評核系統 - 四卡循環管理平台
+   - **不要**勾選 "使用 README 初始化"
+5. 點擊 "建立倉庫"
+
+### 2. 推送本地代碼
+
+Repository 建立完成後，在本地執行：
+
+```bash
+# 確認遠端設定
+git remote -v
+
+# 如果還沒設定遠端，執行：
+git remote add origin https://gitea.theaken.com/donald/hr-performance-system.git
+
+# 使用 token 推送（推薦）
+git push -u https://donald:9e0a888d1a25bde9cf2ad5dff2bb7ee6d68d6ff0@gitea.theaken.com/donald/hr-performance-system.git master
+
+# 或設定 credential helper 後推送
+git config credential.helper store
+git push -u origin master
+# 輸入使用者名稱: donald
+# 輸入密碼: 9e0a888d1a25bde9cf2ad5dff2bb7ee6d68d6ff0
+```
+
+### 3. 設定 Git Credential (可選)
+
+為了避免每次都要輸入密碼，可以設定 credential helper：
+
+**Windows:**
+```bash
+git config --global credential.helper wincred
+```
+
+**Linux/Mac:**
+```bash
+git config --global credential.helper store
+```
+
+### 4. 使用 Token 進行認證
+
+在需要輸入密碼時，使用 token 代替密碼：
+
+- **使用者名稱**: donald
+- **密碼**: 9e0a888d1a25bde9cf2ad5dff2bb7ee6d68d6ff0 (使用 token)
+
+或在 URL 中直接包含 token：
+
+```bash
+git clone https://donald:9e0a888d1a25bde9cf2ad5dff2bb7ee6d68d6ff0@gitea.theaken.com/donald/hr-performance-system.git
+```
+
+## 常用 Git 指令
+
+### 查看狀態
+```bash
+git status
+```
+
+### 拉取最新代碼
+```bash
+git pull origin master
+```
+
+### 提交變更
+```bash
+git add .
+git commit -m "提交訊息"
+git push origin master
+```
+
+### 查看提交歷史
+```bash
+git log --oneline
+```
+
+### 建立分支
+```bash
+git checkout -b feature/new-feature
+git push -u origin feature/new-feature
+```
+
+## 疑難排解
+
+### 錯誤: Push to create is not enabled
+
+**原因**: Gitea 設定不允許透過 push 自動建立 repository
+
+**解決方案**: 先在 Gitea 網頁介面手動建立 repository
+
+### 錯誤: 403 Forbidden
+
+**原因**: 認證失敗或權限不足
+
+**解決方案**:
+1. 確認 token 是否正確
+2. 確認使用者有推送權限
+3. 確認 repository 已存在
+
+### 錯誤: remote: Repository does not exist
+
+**原因**: Repository 尚未建立
+
+**解決方案**: 在 Gitea 上先建立 repository
+
+## Repository 資訊
+
+建立完成後，Repository 資訊如下：
+
+- **URL**: https://gitea.theaken.com/donald/hr-performance-system
+- **Clone URL (HTTPS)**: https://gitea.theaken.com/donald/hr-performance-system.git
+- **Clone URL (SSH)**: git@gitea.theaken.com:donald/hr-performance-system.git
+
+## 安全提醒
+
+⚠️ **重要**: Token 具有完整的帳號權限，請妥善保管！
+
+- 不要將 token 提交到公開的 repository
+- 不要在程式碼中硬編碼 token
+- 定期更換 token
+- 如果 token 外洩，請立即在 Gitea 設定中撤銷
+
+## 下一步
+
+1. ✅ 初始化 Git repository
+2. ✅ 建立初始 commit
+3. ⏳ 在 Gitea 上建立 repository
+4. ⏳ 推送代碼到 Gitea
+5. ⏳ 設定專案的 README 和描述
+
+---
+
+**建立日期**: 2025-12-03