Spaces:
Sleeping
Sleeping
ichieh commited on
Commit ·
1714d7d
1
Parent(s): 495de8c
docs: 更新專案標題為「蛇來蛇去座位表」
Browse files- .history/README_20250117211506.md +200 -0
- README.md +1 -1
.history/README_20250117211506.md
ADDED
|
@@ -0,0 +1,200 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: 蛇來蛇去座位表
|
| 3 |
+
emoji: 📈
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: yellow
|
| 6 |
+
sdk: docker
|
| 7 |
+
pinned: false
|
| 8 |
+
license: apache-2.0
|
| 9 |
+
app_port: 7860
|
| 10 |
+
persistent_dir: ["/data"]
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# Event Invite - 活動座位選擇系統
|
| 14 |
+
|
| 15 |
+
這是一個專為活動設計的座位選擇系統,讓參與者可以自由選擇想要坐的桌次。系統支援多桌次管理、桌長設定、付款狀態追蹤等功能。
|
| 16 |
+
|
| 17 |
+
## 功能特色
|
| 18 |
+
|
| 19 |
+
### 參與者功能
|
| 20 |
+
- 即時查看各桌剩餘座位
|
| 21 |
+
- 選擇想要入座的桌次
|
| 22 |
+
- 填寫個人資料(暱稱、Email、FB連結、自我介紹)
|
| 23 |
+
- 點擊參與者名字可查看詳細資訊
|
| 24 |
+
|
| 25 |
+
### 管理者功能
|
| 26 |
+
- 管理者後台密碼保護
|
| 27 |
+
- 查看所有參與者資訊
|
| 28 |
+
- 設定/取消桌長身份
|
| 29 |
+
- 標記付款狀態
|
| 30 |
+
- 新增/編輯參與者備註
|
| 31 |
+
- 匯出參與者資料
|
| 32 |
+
- 備份/還原資料庫
|
| 33 |
+
- 與 Google Sheets 同步
|
| 34 |
+
|
| 35 |
+
## 技術架構
|
| 36 |
+
|
| 37 |
+
### 前端
|
| 38 |
+
- HTML5/CSS3
|
| 39 |
+
- Bootstrap 5.1.3
|
| 40 |
+
- SweetAlert2 (彈窗提示)
|
| 41 |
+
- Bootstrap Icons
|
| 42 |
+
|
| 43 |
+
### 後端
|
| 44 |
+
- Python Flask
|
| 45 |
+
- SQLite 資料庫
|
| 46 |
+
- Flask-SQLAlchemy
|
| 47 |
+
- Google Apps Script (資料同步)
|
| 48 |
+
|
| 49 |
+
## 系統架構圖
|
| 50 |
+
|
| 51 |
+
```mermaid
|
| 52 |
+
graph TB
|
| 53 |
+
subgraph Frontend
|
| 54 |
+
A[首頁 index.html] --> B[管理者登入 admin_login.html]
|
| 55 |
+
B --> C[管理面板 admin.html]
|
| 56 |
+
end
|
| 57 |
+
|
| 58 |
+
subgraph Backend
|
| 59 |
+
D[Flask App] --> E[SQLite 資料庫]
|
| 60 |
+
D --> F[Google Apps Script]
|
| 61 |
+
end
|
| 62 |
+
|
| 63 |
+
subgraph 使用者流程
|
| 64 |
+
G[瀏覽座位] --> H[選擇座位]
|
| 65 |
+
H --> I[填寫資料]
|
| 66 |
+
I --> J[完成報名]
|
| 67 |
+
end
|
| 68 |
+
|
| 69 |
+
subgraph 管理者流程
|
| 70 |
+
K[登入驗證] --> L[查看報名]
|
| 71 |
+
L --> M[管理座位]
|
| 72 |
+
M --> N[同步資料]
|
| 73 |
+
end
|
| 74 |
+
|
| 75 |
+
A --> D
|
| 76 |
+
C --> D
|
| 77 |
+
D --> F
|
| 78 |
+
F --> O[Google Sheets]
|
| 79 |
+
```
|
| 80 |
+
|
| 81 |
+
## 主要功能流程
|
| 82 |
+
|
| 83 |
+
1. **一般使用者流程**
|
| 84 |
+
- 瀏覽活動座位表
|
| 85 |
+
- 選擇想要的座位
|
| 86 |
+
- 填寫個人資料(暱稱、Email、FB連結、自我介紹)
|
| 87 |
+
- 完成報名
|
| 88 |
+
|
| 89 |
+
2. **管理者流程**
|
| 90 |
+
- 登入管理面板
|
| 91 |
+
- 查看所有報名資料
|
| 92 |
+
- 管理座位分配
|
| 93 |
+
- 與 Google Sheets 同步資料
|
| 94 |
+
|
| 95 |
+
3. **資料同步流程**
|
| 96 |
+
- 後端 Flask 應用程式處理請求
|
| 97 |
+
- 透過 Google Apps Script 進行資料同步
|
| 98 |
+
- 資料存儲於 SQLite 資料庫和 Google Sheets
|
| 99 |
+
|
| 100 |
+
## 部署資訊
|
| 101 |
+
|
| 102 |
+
本系統部署在 Hugging Face Spaces 平台,使用持久化存儲來保存資料。
|
| 103 |
+
|
| 104 |
+
### 環境變數設定
|
| 105 |
+
- `ADMIN_PASSWORD`: 管理者密碼
|
| 106 |
+
- `SETTINGS_SCRIPT_URL`: Google Apps Script 網址(用於同步設定)
|
| 107 |
+
|
| 108 |
+
## 本地開發
|
| 109 |
+
|
| 110 |
+
1. 安裝依賴:
|
| 111 |
+
```bash
|
| 112 |
+
pip install -r requirements.txt
|
| 113 |
+
```
|
| 114 |
+
|
| 115 |
+
2. 設定環境變數:
|
| 116 |
+
```bash
|
| 117 |
+
export ADMIN_PASSWORD=your_password
|
| 118 |
+
export SETTINGS_SCRIPT_URL=your_script_url
|
| 119 |
+
```
|
| 120 |
+
|
| 121 |
+
3. 啟動應用:
|
| 122 |
+
```bash
|
| 123 |
+
python app.py
|
| 124 |
+
```
|
| 125 |
+
|
| 126 |
+
應用將在 http://localhost:7860 運行
|
| 127 |
+
|
| 128 |
+
## 資料庫結構
|
| 129 |
+
|
| 130 |
+
### Table 資料表
|
| 131 |
+
- id: 桌次 ID
|
| 132 |
+
- name: 桌次名稱
|
| 133 |
+
- capacity: 座位容量
|
| 134 |
+
- participants: 關聯到 Participant 資料表
|
| 135 |
+
|
| 136 |
+
### Participant 資料表
|
| 137 |
+
- id: 參與者 ID
|
| 138 |
+
- nickname: 暱稱
|
| 139 |
+
- email: 電子郵件
|
| 140 |
+
- fb_link: Facebook 連結
|
| 141 |
+
- introduction: 自我介紹
|
| 142 |
+
- table_id: 所屬桌次
|
| 143 |
+
- seat_number: 座位號碼
|
| 144 |
+
- is_table_leader: 是否為桌長
|
| 145 |
+
- created_at: 建立時間
|
| 146 |
+
- has_paid: 付款狀態
|
| 147 |
+
- note: 管理者備註
|
| 148 |
+
|
| 149 |
+
## 資料備份
|
| 150 |
+
|
| 151 |
+
系統提供兩種備份機制:
|
| 152 |
+
1. 資料庫備份:完整備份所有資料
|
| 153 |
+
2. Google Sheets 同步:即時同步重要設定
|
| 154 |
+
|
| 155 |
+
## 注意事項
|
| 156 |
+
|
| 157 |
+
1. 請定期備份資料庫
|
| 158 |
+
2. 管理者密碼請妥善保管
|
| 159 |
+
3. 建議定期檢查 Google Sheets 同步狀態
|
| 160 |
+
|
| 161 |
+
## 授權資訊
|
| 162 |
+
|
| 163 |
+
本專案採用 MIT 授權條款。
|
| 164 |
+
|
| 165 |
+
## 開發 Debug 記錄
|
| 166 |
+
|
| 167 |
+
### 前端顯示
|
| 168 |
+
|
| 169 |
+
1. **圓形桌位顯示溢出**
|
| 170 |
+
- 問題:參與者超過 5 人時,名字會溢出圓形區域
|
| 171 |
+
- 解決:改用長方形設計,並根據參與者數量自動調整大小
|
| 172 |
+
|
| 173 |
+
2. **參與者資訊顯示優化**
|
| 174 |
+
- 問題:自我介紹和備註內容過長時影響版面
|
| 175 |
+
- 解決:實作文字截斷和彈出式詳細資訊視窗
|
| 176 |
+
|
| 177 |
+
### Google Sheets 同步
|
| 178 |
+
|
| 179 |
+
1. **跨域請求問題**
|
| 180 |
+
- 問題:無法直接從前端呼叫 Google Apps Script
|
| 181 |
+
- 解決:透過後端 API 轉發請求,並處理回應
|
| 182 |
+
|
| 183 |
+
### 安全性問題
|
| 184 |
+
|
| 185 |
+
1. **管理者密碼保護**
|
| 186 |
+
- 問題:需要保護管理者頁面的存取
|
| 187 |
+
- 解決:使用環境變數和 session 機制,實作管理者登入功能
|
| 188 |
+
|
| 189 |
+
### 使用者體驗
|
| 190 |
+
|
| 191 |
+
1. **座位選擇流程**
|
| 192 |
+
- 問題:原本點擊整個圓桌來選擇不夠直覺
|
| 193 |
+
- 解決:新增獨立的選擇按鈕,並提供視覺回饋
|
| 194 |
+
|
| 195 |
+
2. **錯誤處理優化**
|
| 196 |
+
- 問題:系統錯誤訊息不夠友善
|
| 197 |
+
- 解決:使用 SweetAlert2 提供更好的錯誤提示
|
| 198 |
+
|
| 199 |
+
---
|
| 200 |
+
Hosted on 🤗 Hugging Face Spaces
|
README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
emoji: 📈
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: yellow
|
|
|
|
| 1 |
---
|
| 2 |
+
title: 蛇來蛇去座位表
|
| 3 |
emoji: 📈
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: yellow
|