# Google Sheets 集成設置指南

## 第一步：建立 Google Sheets 試算表

1. 前往 https://sheets.google.com
2. 點擊「空白試算表」建立新表格
3. 命名為「尚方教育 – 學生記錄管理」
4. 複製網址中的 **Spreadsheet ID**（格式：`/d/xxxxxx/edit` 中間那串字）

---

## 第二步：建立 Google Apps Script

1. 在 Google Sheets 中，點擊選單：**擴充功能 → Apps Script**
2. 刪除預設的空白內容
3. 複製貼上 `Code.gs` 檔案的全部內容
4. 在頂部 `CONFIG` 區，填入你的 **Spreadsheet ID** 和通知郵件：
   ```javascript
   const CONFIG = {
     SPREADSHEET_ID: '你的試算表ID',
     NOTIFY_EMAILS: 'your-email@gmail.com',  // 可填多個，逗號分隔
     ...
   };
   ```
5. 按 **Ctrl+S** 儲存，項目命名為「尚方教育後端」

---

## 第三步：部署為 Web App

1. 點擊右上角「**部署 → 新增部署**」
2. 選擇類型：**網頁應用程式**
3. 設定：
   - 說明：`尚方教育 API v1`
   - 以誰的身份執行：**我本人**（你的 Google 帳號）
   - 誰可以存取：**所有人（包括匿名）**
4. 點擊「**部署**」，複製生成的 **網頁應用程式 URL**

   URL 格式：`https://script.google.com/macros/s/xxxxxx/exec`

---

## 第四步：更新平台設定

打開 `platform/js/config.js`，把 URL 填入：

```javascript
const GOOGLE_SCRIPT_URL = 'https://script.google.com/macros/s/你的ID/exec';
```

---

## 第五步：授權 Gmail 發送通知

1. 第一次執行時，系統會要求授權
2. 在 Apps Script 點擊「執行 → doGet」
3. 按授權提示，允許存取 Gmail 和 Sheets

---

## Google Sheets 欄位說明

### 工作表 1：學生提交記錄（家長/學生填寫）
| 欄位 | 說明 |
|------|------|
| A | 提交時間 |
| B–D | 學生姓名、電話、電郵 |
| E–J | 目標年級、身份、入讀年份等 |
| K–N | 語言水平、IELTS/TOEFL |
| O–S | 中英數評估分及百分比 |
| T–Y | 地區、學校類型、學費預算 |
| AJ | **跟進狀態**（手動更新：待跟進/已聯絡/已成交/不適合）|
| AK | **顧問備注** |
| AL | **跟進日期** |

### 工作表 2：顧問分析記錄（內部使用）
記錄每次顧問後台的分析結果，含保底/推薦/衝刺學校名單。

---

## 通知郵件功能

每次家長提交問卷，系統自動發送 HTML 格式通知郵件至 `NOTIFY_EMAILS`，包含：
- 學生基本資料
- 評估分數（中英數）
- 學校偏好摘要
- 直接連結到 Google Sheets

---

## 常見問題

**Q: 部署後測試怎麼做？**
在瀏覽器直接訪問：`你的URL?action=ping` 應返回 `{"success":true}`

**Q: 更新 Code.gs 後需要重新部署嗎？**
需要。點擊「部署 → 管理部署 → 編輯 → 建立新版本」

**Q: 可以多人共用 Sheets 嗎？**
可以。在 Sheets 點擊「共用」，加入其他顧問的 Gmail 帳號即可。