ichieh commited on
Commit
5fb5209
·
1 Parent(s): 0adb92f

feat: 添加桌次設定同步到 Google Sheets 的功能

Browse files
.history/README_20250117200004.md ADDED
@@ -0,0 +1,180 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Event Invite - 活動座位選擇系統
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
+ 本系統部署在 Hugging Face Spaces 平台,使用持久化存儲來保存資料。
52
+
53
+ ### 環境變數設定
54
+ - `ADMIN_PASSWORD`: 管理者密碼
55
+ - `SETTINGS_SCRIPT_URL`: Google Apps Script 網址(用於同步設定)
56
+
57
+ ## 本地開發
58
+
59
+ 1. 安裝依賴:
60
+ ```bash
61
+ pip install -r requirements.txt
62
+ ```
63
+
64
+ 2. 設定環境變數:
65
+ ```bash
66
+ export ADMIN_PASSWORD=your_password
67
+ export SETTINGS_SCRIPT_URL=your_script_url
68
+ ```
69
+
70
+ 3. 啟動應用:
71
+ ```bash
72
+ python app.py
73
+ ```
74
+
75
+ 應用將在 http://localhost:7860 運行
76
+
77
+ ## 資料庫結構
78
+
79
+ ### Table 資料表
80
+ - id: 桌次 ID
81
+ - name: 桌次名稱
82
+ - capacity: 座位容量
83
+ - participants: 關聯到 Participant 資料表
84
+
85
+ ### Participant 資料表
86
+ - id: 參與者 ID
87
+ - nickname: 暱稱
88
+ - email: 電子郵件
89
+ - fb_link: Facebook 連結
90
+ - introduction: 自我介紹
91
+ - table_id: 所屬桌次
92
+ - seat_number: 座位號碼
93
+ - is_table_leader: 是否為桌長
94
+ - created_at: 建立時間
95
+ - has_paid: 付款狀態
96
+ - note: 管理者備註
97
+
98
+ ## 資料備份
99
+
100
+ 系統提供兩種備份機制:
101
+ 1. 資料庫備份:完整備份所有資料
102
+ 2. Google Sheets 同步:即時同步重要設定
103
+
104
+ ## 注意事項
105
+
106
+ 1. 請定期備份資料庫
107
+ 2. 管理者密碼請妥善保管
108
+ 3. 建議定期檢查 Google Sheets 同步狀態
109
+
110
+ ## 授權資訊
111
+
112
+ 本專案採用 MIT 授權條款。
113
+
114
+ ## 開發 Debug 記錄
115
+
116
+ ### 資料庫相關
117
+
118
+ 1. **Hugging Face Spaces 資料持久化問題**
119
+ - 問題:每次重新部署時資料會被重置
120
+ - 原因:預設的 SQLite 資料庫存儲在臨時目錄
121
+ - 解決:將資料庫檔案移至 `/data` 持久化目錄,並在 `app.py` 中添加資料庫路徑判斷邏輯
122
+
123
+ 2. **資料庫遷移問題**
124
+ - 問題:本地開發和 Spaces 環境的資料庫路徑不同
125
+ - 解決:根據環境變數 `SPACE_ID` 動態判斷資料庫路徑
126
+
127
+ ### 前端顯示
128
+
129
+ 1. **圓形桌位顯示溢出**
130
+ - 問題:參與者超過 5 人時,名字會溢出圓形區域
131
+ - 解決:改用長方形設計,並根據參與者數量自動調整大小
132
+
133
+ 2. **參與者資訊顯示優化**
134
+ - 問題:自我介紹和備註內容過長時影響版面
135
+ - 解決:實作文字截斷和彈出式詳細資訊視窗
136
+
137
+ ### Google Sheets 同步
138
+
139
+ 1. **跨域請求問題**
140
+ - 問題:無法直接從前端呼叫 Google Apps Script
141
+ - 解決:透過後端 API 轉發請求,並處理回應
142
+
143
+ 2. **資料同步時序問題**
144
+ - 問題:大量資料同步時可能發生衝突
145
+ - 解決:添加同步鎖定機制,確保資料一致性
146
+
147
+ ### 安全性問題
148
+
149
+ 1. **管理者密碼保護**
150
+ - 問題:密碼以明文形式存在環境變數中
151
+ - 解決:使用環境變數和 session 機制,避免密碼外洩
152
+
153
+ 2. **參與者資料保護**
154
+ - 問題:需要防止未授權的資料存取
155
+ - 解決:實作管理者身份驗證,限制 API 存取權限
156
+
157
+ ### 效能優化
158
+
159
+ 1. **頁面載入速度**
160
+ - 問題:參與者數量增加時,頁面載入變慢
161
+ - 解決:優化資料庫查詢,實作資料快取機制
162
+
163
+ 2. **即時更新機制**
164
+ - 問題:需要手動重新整理才能看到最新狀態
165
+ - 解決:定期自動重新載入資料,確保資訊即時性
166
+
167
+ ### 使用者體驗
168
+
169
+ 1. **座位選擇流程**
170
+ - 問題:原本點擊整個圓桌來選擇不夠直覺
171
+ - 解決:新增獨立的選擇按鈕,並提供視覺回饋
172
+
173
+ 2. **錯誤處理優化**
174
+ - 問題:系統錯誤訊息不夠友善
175
+ - 解決:使用 SweetAlert2 提供更好的錯誤提示
176
+
177
+ 這些問題的解決方案都已整合到目前的系統中,希望這些經驗能幫助其他開發者避免類似的問題。
178
+
179
+ ---
180
+ Hosted on 🤗 Hugging Face Spaces
.history/README_20250117200221.md ADDED
@@ -0,0 +1,165 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Event Invite - 活動座位選擇系統
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
+ 本系統部署在 Hugging Face Spaces 平台,使用持久化存儲來保存資料。
52
+
53
+ ### 環境變數設定
54
+ - `ADMIN_PASSWORD`: 管理者密碼
55
+ - `SETTINGS_SCRIPT_URL`: Google Apps Script 網址(用於同步設定)
56
+
57
+ ## 本地開發
58
+
59
+ 1. 安裝依賴:
60
+ ```bash
61
+ pip install -r requirements.txt
62
+ ```
63
+
64
+ 2. 設定環境變數:
65
+ ```bash
66
+ export ADMIN_PASSWORD=your_password
67
+ export SETTINGS_SCRIPT_URL=your_script_url
68
+ ```
69
+
70
+ 3. 啟動應用:
71
+ ```bash
72
+ python app.py
73
+ ```
74
+
75
+ 應用將在 http://localhost:7860 運行
76
+
77
+ ## 資料庫結構
78
+
79
+ ### Table 資料表
80
+ - id: 桌次 ID
81
+ - name: 桌次名稱
82
+ - capacity: 座位容量
83
+ - participants: 關聯到 Participant 資料表
84
+
85
+ ### Participant 資料表
86
+ - id: 參與者 ID
87
+ - nickname: 暱稱
88
+ - email: 電子郵件
89
+ - fb_link: Facebook 連結
90
+ - introduction: 自我介紹
91
+ - table_id: 所屬桌次
92
+ - seat_number: 座位號碼
93
+ - is_table_leader: 是否為桌長
94
+ - created_at: 建立時間
95
+ - has_paid: 付款狀態
96
+ - note: 管理者備註
97
+
98
+ ## 資料備份
99
+
100
+ 系統提供兩種備份機制:
101
+ 1. 資料庫備份:完整備份所有資料
102
+ 2. Google Sheets 同步:即時同步重要設定
103
+
104
+ ## 注意事項
105
+
106
+ 1. 請定期備份資料庫
107
+ 2. 管理者密碼請妥善保管
108
+ 3. 建議定期檢查 Google Sheets 同步狀態
109
+
110
+ ## 授權資訊
111
+
112
+ 本專案採用 MIT 授權條款。
113
+
114
+ ## 開發 Debug 記錄
115
+
116
+ ### 前端顯示
117
+
118
+ 1. **圓形桌位顯示溢出**
119
+ - 問題:參與者超過 5 人時,名字會溢出圓形區域
120
+ - 解決:改用長方形設計,並根據參與者數量自動調整大小
121
+
122
+ 2. **參與者資訊顯示優化**
123
+ - 問題:自我介紹和備註內容過長時影響版面
124
+ - 解決:實作文字截斷和彈出式詳細資訊視窗
125
+
126
+ ### Google Sheets 同步
127
+
128
+ 1. **跨域請求問題**
129
+ - 問題:無法直接從前端呼叫 Google Apps Script
130
+ - 解決:透過後端 API 轉發請求,並處理回應
131
+
132
+ 2. **資料同步時序問題**
133
+ - 問題:大量資料同步時可能發生衝突
134
+ - 解決:添加同步鎖定機制,確保資料一致性
135
+
136
+ ### 安全性問題
137
+
138
+ 1. **管理者密碼保護**
139
+ - 問題:密碼以明文形式存在環境變數中
140
+ - 解決:使用環境變數和 session 機制,避免密碼外洩
141
+
142
+ ### 效能優化
143
+
144
+ 1. **頁面載入速度**
145
+ - 問題:參與者數量增加時,頁面載入變慢
146
+ - 解決:優化資料庫查詢,實作資料快取機制
147
+
148
+ 2. **即時更新機制**
149
+ - 問題:需要手動重新整理才能看到最新狀態
150
+ - 解決:定期自動重新載入資料,確保資訊即時性
151
+
152
+ ### 使用者體驗
153
+
154
+ 1. **座位選擇流程**
155
+ - 問題:原本點擊整個圓桌來選擇不夠直覺
156
+ - 解決:新增獨立的選擇按鈕,並提供視覺回饋
157
+
158
+ 2. **錯誤處理優化**
159
+ - 問題:系統錯誤訊息不夠友善
160
+ - 解決:使用 SweetAlert2 提供更好的錯誤提示
161
+
162
+ 這些問題的解決方案都已整合到目前的系統中,希望這些經驗能幫助其他開發者避免類似的問題。
163
+
164
+ ---
165
+ Hosted on 🤗 Hugging Face Spaces
.history/README_20250117200245.md ADDED
@@ -0,0 +1,165 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Event Invite - 活動座位選擇系統
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
+ 本系統部署在 Hugging Face Spaces 平台,使用持久化存儲來保存資料。
52
+
53
+ ### 環境變數設定
54
+ - `ADMIN_PASSWORD`: 管理者密碼
55
+ - `SETTINGS_SCRIPT_URL`: Google Apps Script 網址(用於同步設定)
56
+
57
+ ## 本地開發
58
+
59
+ 1. 安裝依賴:
60
+ ```bash
61
+ pip install -r requirements.txt
62
+ ```
63
+
64
+ 2. 設定環境變數:
65
+ ```bash
66
+ export ADMIN_PASSWORD=your_password
67
+ export SETTINGS_SCRIPT_URL=your_script_url
68
+ ```
69
+
70
+ 3. 啟動應用:
71
+ ```bash
72
+ python app.py
73
+ ```
74
+
75
+ 應用將在 http://localhost:7860 運行
76
+
77
+ ## 資料庫結構
78
+
79
+ ### Table 資料表
80
+ - id: 桌次 ID
81
+ - name: 桌次名稱
82
+ - capacity: 座位容量
83
+ - participants: 關聯到 Participant 資料表
84
+
85
+ ### Participant 資料表
86
+ - id: 參與者 ID
87
+ - nickname: 暱稱
88
+ - email: 電子郵件
89
+ - fb_link: Facebook 連結
90
+ - introduction: 自我介紹
91
+ - table_id: 所屬桌次
92
+ - seat_number: 座位號碼
93
+ - is_table_leader: 是否為桌長
94
+ - created_at: 建立時間
95
+ - has_paid: 付款狀態
96
+ - note: 管理者備註
97
+
98
+ ## 資料備份
99
+
100
+ 系統提供兩種備份機制:
101
+ 1. 資料庫備份:完整備份所有資料
102
+ 2. Google Sheets 同步:即時同步重要設定
103
+
104
+ ## 注意事項
105
+
106
+ 1. 請定期備份資料庫
107
+ 2. 管理者密碼請妥善保管
108
+ 3. 建議定期檢查 Google Sheets 同步狀態
109
+
110
+ ## 授權資訊
111
+
112
+ 本專案採用 MIT 授權條款。
113
+
114
+ ## 開發 Debug 記錄
115
+
116
+ ### 前端顯示
117
+
118
+ 1. **圓形桌位顯示溢出**
119
+ - 問題:參與者超過 5 人時,名字會溢出圓形區域
120
+ - 解決:改用長方形設計,並根據參與者數量自動調整大小
121
+
122
+ 2. **參與者資訊顯示優化**
123
+ - 問題:自我介紹和備註內容過長時影響版面
124
+ - 解決:實作文字截斷和彈出式詳細資訊視窗
125
+
126
+ ### Google Sheets 同步
127
+
128
+ 1. **跨域請求問題**
129
+ - 問題:無法直接從前端呼叫 Google Apps Script
130
+ - 解決:透過後端 API 轉發請求,並處理回應
131
+
132
+ 2. **資料同步時序問題**
133
+ - 問題:大量資料同步時可能發生衝突
134
+ - 解決:添加同步鎖定機制,確保資料一致性
135
+
136
+ ### 安全性問題
137
+
138
+ 1. **管理者密碼保護**
139
+ - 問題:密碼以明文形式存在環境變數中
140
+ - 解決:使用環境變數和 session 機制,避免密碼外洩
141
+
142
+ ### 效能優化
143
+
144
+ 1. **頁面載入速度**
145
+ - 問題:參與者數量增加時,頁面載入變慢
146
+ - 解決:優化資料庫查詢,實作資料快取機制
147
+
148
+ 2. **即時更新機制**
149
+ - 問題:需要手動重新整理才能看到最新狀態
150
+ - 解決:定期自動重新載入資料,確保資訊即時性
151
+
152
+ ### 使用者體驗
153
+
154
+ 1. **座位選擇流程**
155
+ - 問題:原本點擊整個圓桌來選擇不夠直覺
156
+ - 解決:新增獨立的選擇按鈕,並提供視覺回饋我ㄘㄨㄣ
157
+
158
+ 2. **錯誤處理優化**
159
+ - 問題:系統錯誤訊息不夠友善
160
+ - 解決:使用 SweetAlert2 提供更好的錯誤提示
161
+
162
+ 這些問題的解決方案都已整合到目前的系統中,希望這些經驗能幫助其他開發者避免類似的問題。
163
+
164
+ ---
165
+ Hosted on 🤗 Hugging Face Spaces
.history/README_20250117204133.md ADDED
@@ -0,0 +1,200 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Event Invite - 活動座位選擇系統
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
app.py CHANGED
@@ -273,25 +273,30 @@ def update_settings():
273
 
274
  # 創建新的桌子
275
  for i in range(total_tables):
276
- table = Table(
277
- name=f'第{i+1}桌',
278
- capacity=seats_per_table
279
- )
280
  db.session.add(table)
281
 
282
  db.session.commit()
 
 
 
 
 
 
 
 
 
283
 
284
- # 自動備份設定到 Google Sheets
285
  try:
286
- sync_settings_to_sheets('saveSettings', {
287
- 'totalTables': total_tables,
288
- 'seatsPerTable': seats_per_table
289
- })
290
- print("成功備份桌次設定到 Google Sheets")
 
 
291
  except Exception as e:
292
- print(f"備份設定到 Google Sheets 時發生錯誤: {str(e)}")
293
- # 不要因為備份失敗而影響設定更新
294
- pass
295
 
296
  return jsonify({'message': '設定已更新'})
297
  except Exception as e:
 
273
 
274
  # 創建新的桌子
275
  for i in range(total_tables):
276
+ table = Table(name=f'第 {i+1} 桌', capacity=seats_per_table)
 
 
 
277
  db.session.add(table)
278
 
279
  db.session.commit()
280
+
281
+ # 同步設定到 Google Sheets
282
+ settings_data = {
283
+ 'action': 'updateSettings',
284
+ 'settings': {
285
+ 'total_tables': total_tables,
286
+ 'seats_per_table': seats_per_table
287
+ }
288
+ }
289
 
 
290
  try:
291
+ response = requests.post(
292
+ current_app.config['SETTINGS_SCRIPT_URL'],
293
+ json=settings_data,
294
+ timeout=10
295
+ )
296
+ if not response.ok:
297
+ current_app.logger.error(f"Failed to sync settings to Google Sheets: {response.text}")
298
  except Exception as e:
299
+ current_app.logger.error(f"Error syncing settings to Google Sheets: {str(e)}")
 
 
300
 
301
  return jsonify({'message': '設定已更新'})
302
  except Exception as e:
sync_settings.gs CHANGED
@@ -35,6 +35,27 @@ function doPost(e) {
35
  .setMimeType(ContentService.MimeType.JSON);
36
  }
37
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
38
  return ContentService.createTextOutput(JSON.stringify({error: 'Invalid action'}))
39
  .setMimeType(ContentService.MimeType.JSON);
40
  }
 
35
  .setMimeType(ContentService.MimeType.JSON);
36
  }
37
 
38
+ if (action === 'updateSettings') {
39
+ // 更新設定
40
+ var settingsSheet = sheet.getSheetByName('Settings') || sheet.insertSheet('Settings');
41
+ var settings = data.settings;
42
+
43
+ // 清除現有設定
44
+ settingsSheet.clear();
45
+
46
+ // 設定標題
47
+ settingsSheet.getRange('A1:B1').setValues([['設定項目', '值']]);
48
+
49
+ // 更新設定值
50
+ settingsSheet.getRange('A2:B3').setValues([
51
+ ['總桌數', settings.total_tables],
52
+ ['每桌人數', settings.seats_per_table]
53
+ ]);
54
+
55
+ return ContentService.createTextOutput(JSON.stringify({success: true}))
56
+ .setMimeType(ContentService.MimeType.JSON);
57
+ }
58
+
59
  return ContentService.createTextOutput(JSON.stringify({error: 'Invalid action'}))
60
  .setMimeType(ContentService.MimeType.JSON);
61
  }