JianMiauandClaude Fable 5
8cc05183f7
根本原因： 原本配對邏輯只以人數多的一區為基準，缺額全部補「那個」。例如 A 區 7 人、B 區 5 人時會補 2 個「那個」，但總人數 12 是偶數，其實可以讓 A 區 1 人跨區支援就湊滿 6 隊真人對打。 影響： - 兩區差距 2 以上時，每輪自動抽「差距÷2」人跨區支援，且每輪輪替不同人，跨區的人平均分攤 - 只有總人數為奇數時才會補 1 個「那個」 - 三輪之間維持無重複搭檔、同輪無人重複上場 - 「推送到 LINE」按鈕移到上方操作列，三組結果改為三欄並排顯示 - 摘要卡改顯示跨區支援與補位人數 修法： 新增 balanceZones / pickCrossMembers 依輪次輪替抽出跨區成員，createRoundTeams 改在每輪平衡後再建立隊伍；移除不再使用的 prepareParticipants 與 .share-row/.share-button 樣式，並同步更新 README 規則說明。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
152 lines
3.6 KiB
Markdown
152 lines
3.6 KiB
Markdown
# 羽毛球分組配對器
|
|
|
|
這是一個使用 `React + Vite + TypeScript` 製作的網頁應用程式，用來將 A 區與 B 區成員配成羽毛球隊伍。
|
|
|
|
## 功能說明
|
|
|
|
- 分別輸入 A 區與 B 區名單
|
|
- 可指定要寫入資料庫的目標日期
|
|
- 每次固定產生 3 組完整配對結果
|
|
- 每一隊都由 `1 位 A 區 + 1 位 B 區` 組成
|
|
- 每一組都會把 A 區與 B 區名單完整分配完成
|
|
- 兩區人數差 2 以上時，每輪會輪流讓人多的一區成員跨區支援
|
|
- 跨區平衡後仍有缺口（總人數為奇數）時，才補入「那個」
|
|
- 產生配對後可用按鈕手動上傳資料到資料庫
|
|
- 若指定日期已經有資料，上傳前會先詢問是否覆蓋
|
|
- 可讀取指定日期的資料庫內容並回填到畫面
|
|
- 若指定日期沒有資料，畫面會顯示「指定日期沒有資料」
|
|
- 組隊結果產生後可一鍵主動推播到指定 LINE 對話
|
|
- 支援換行、半形逗號、全形逗號與頓號輸入
|
|
- 會自動去除空白與重複名稱
|
|
|
|
## 操作流程
|
|
|
|
1. 輸入 A 區與 B 區名單
|
|
2. 按下 `產生三組配對`
|
|
3. 選擇 `目標日期`
|
|
4. 按下 `上傳資料` 將資料寫入 DB
|
|
5. 若需要，可按 `讀取指定日期` 載回既有資料
|
|
6. 組隊結果顯示後，可按 `推送到 LINE`
|
|
|
|
## 使用方式
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
前端開發網址預設為：
|
|
|
|
```text
|
|
http://localhost:3500
|
|
```
|
|
|
|
推播到 LINE 時，會直接使用 Flex Message 主動送到指定對話，格式參考既有 `line-bot-ts` 羽球查詢結果樣式。
|
|
若指定日期尚未上傳資料，系統會先提示你上傳後再推播。
|
|
|
|
LINE 推播目標支援分成兩組：
|
|
|
|
- `LINE_TARGET_ID_LOCAL`: 本地測試用對話
|
|
- `LINE_TARGET_ID_PROD`: 正式環境用對話
|
|
- `LINE_TARGET_MODE`: `local` 或 `prod`
|
|
|
|
當系統偵測目前為 `local` 模式時，頁面右上角會顯示「測試環境」標籤。
|
|
正式環境 `prod` 不會顯示這個標籤。
|
|
|
|
## 資料庫欄位
|
|
|
|
- `time`: 目標日期，格式為 `YYYYMMDD`
|
|
- `personnel`: 人員清單，格式為 `[[1,"A區成員"],[0,"B區成員"]]`
|
|
- `battlecombination`: 三組隊伍搭配，格式為 `{"0":[["A","B"]],"1":[...],"2":[...]}`
|
|
|
|
## 正式建置
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
## Docker 部署
|
|
|
|
這個專案已提供單容器部署方式，容器啟動後會同時提供：
|
|
|
|
- 網頁前端
|
|
- `/api` 後端
|
|
- MariaDB 寫入功能
|
|
|
|
### 建立映像
|
|
|
|
```bash
|
|
docker build -t badminton-match-hub .
|
|
```
|
|
|
|
### 啟動容器
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name badminton-match-hub \
|
|
-p 3500:3500 \
|
|
-e PORT=3500 \
|
|
-e DB_HOST=192.168.0.15 \
|
|
-e DB_PORT=3307 \
|
|
-e DB_USER=jianmiau \
|
|
-e DB_PASSWORD=你的密碼 \
|
|
-e DB_DATABASE=badminton \
|
|
-e DB_TABLE=badminton \
|
|
badminton-match-hub
|
|
```
|
|
|
|
### NAS 上建議設定
|
|
|
|
- 容器埠使用 `3500`
|
|
- 對外埠可自訂，例如 `3500:3500`
|
|
- 環境變數請在 NAS 的 Docker 介面中填入
|
|
- 不要把本機 `.env` 直接打包進映像
|
|
|
|
部署完成後可直接透過：
|
|
|
|
```text
|
|
http://NAS_IP:3500
|
|
```
|
|
|
|
開啟系統。
|
|
|
|
### docker-compose
|
|
|
|
專案也已提供 `docker-compose.yml`。
|
|
|
|
```bash
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Compose 版本預設會：
|
|
|
|
- 對外使用 `3500`
|
|
- 容器內部使用 `3500`
|
|
- 讀取 `.env` 內的資料庫設定
|
|
- 預設使用 `LINE_TARGET_MODE=prod`
|
|
- 推播到 `LINE_TARGET_ID_PROD`
|
|
|
|
也就是說，在 NAS 上直接執行：
|
|
|
|
```bash
|
|
sudo docker compose up -d --build
|
|
```
|
|
|
|
就會以正式環境方式啟動。
|
|
|
|
請先確認 `.env` 至少有以下設定：
|
|
|
|
```env
|
|
LINE_CHANNEL_ACCESS_TOKEN=你的token
|
|
LINE_TARGET_ID_LOCAL=你的測試對話ID
|
|
LINE_TARGET_ID_PROD=你的正式對話ID
|
|
```
|
|
|
|
部署後可透過：
|
|
|
|
```text
|
|
http://NAS_IP:3500
|
|
```
|
|
|
|
開啟系統。
|