ichieh commited on
Commit
1714d7d
·
1 Parent(s): 495de8c

docs: 更新專案標題為「蛇來蛇去座位表」

Browse files
Files changed (2) hide show
  1. .history/README_20250117211506.md +200 -0
  2. 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: Event Invite - 活動座位選擇系統
3
  emoji: 📈
4
  colorFrom: blue
5
  colorTo: yellow
 
1
  ---
2
+ title: 蛇來蛇去座位表
3
  emoji: 📈
4
  colorFrom: blue
5
  colorTo: yellow