理事長 踩雷報告書 + Phase 1a 修完請回爐驗收（2026-04-18）
嘿 理事長，
4/17 你從頭到尾玩過一遍、卡在「審核通過之後完全沒下文」那個雷——今天我們把它修掉了。以下是你現在可以再玩一次的新流程，以及你 4/17 提到的 12 項回饋中哪幾項已經進去、哪幾項排在後面。
一、4/17 你踩到的那個雷，我們做了什麼
你那天的實測紀錄（prod 資料庫實證）：
- 08:33 用
cd27001347@gmail.com送出「朝代金站大樓」申請 - 08:56 Hugo 按通過
- 然後你就完全沒下文了 —— 沒信、沒邀請碼、不知道下一步
這次 Phase 1a 修的部分，直接對應你那次卡關：
| 你說的痛點 | 現在的狀態 |
|---|---|
| 「通過之後要有通知信」 | ✅ 審核通過會自動寄信給申請人，顯示「三和雲客服」寄件人 |
| 「然後邀請碼」 | ✅ 信裡有8 位邀請碼（大字、好看、好複製） |
| 「邀請碼可以整個社區共用 (or QR Code)」 | ✅ 信裡附內嵌的 QR Code 圖片，可直接列印貼公告欄 |
| 「申請人下次登錄要看到社區總覽」 | ✅ 通過後下次登入直接跳 /dashboard（你之前會停在原畫面） |
| 「駁回要可以寫理由」 | ✅ 駁回彈出 modal，強制最少 10 字，內容會寄 email 給申請人 |
| 統一編號 | ✅ 社區申請表已加（選填） |
| 建築使用執照 | ✅ 加了，且三種申請狀態都必填（照你 4/18 的指示） |
| 民選委員 | ✅ 已改成「管理委員」 |
| 送出申請後停在等待畫面 | ✅ 改成直接回首頁，上方橫幅顯示「審核中」 |
| 一般使用者可以自助註冊 | ✅ 新增「我只是來看看」入口 |
| 廠商申請 | ✅ 新增「廠商申請」入口 + 完整表單 |
二、請你再來踩一次（約 10 分鐘）
上次你沒走完後半段，這次請走全程。
網址： https://harmonyhub.cc
帳號： 建議用跟 4/17 不同的 Google 帳號（那個已經卡在舊狀態了）。或是到 Neon 把 cd27001347@gmail.com 的 communityId 清掉重新來過，看你方便。
新的 11 步驗證
| # | 動作 | 位置 | 預期看到 |
|---|---|---|---|
| 1 | 用新 Google 帳號登入 | /login | 導向 /onboarding，顯示歡迎畫面 |
| 2 | 進入步驟 2，應該看到四張卡片 | /onboarding | 建立社區 / 加入社區 / 我只是來看看 / 廠商申請 |
| 3 | 點「建立社區」→ 選「有報備」→ 看到「統一編號（選填）」欄位 | 步驟 4 | 下方會有四個必填文件上傳欄位（含「建築使用執照」） |
| 4 | 身份類別下拉選單 | 同上 | 「管理人（管理委員）」—— 不是民選委員 |
| 5 | 上傳四份測試檔 + 填完送出 | 同上 | 自動跳首頁，最上方有黃色橫幅「申請審核中」 |
| 6 | 換 heyjoey70@gmail.com 登入（系統管理員） | /ops/communities | 看到剛才送的申請在「待審申請」區塊 |
| 7 | 點「核准」 | 同上 | 上方出現綠色卡片：8 位邀請碼（可複製）＋ 下載 QR ＋ 重寄通知信 |
| 8 | 檢查信箱（或看 Vercel log） | 申請人 email | 收到「【三和雲】您的社區申請已通過審核」，信裡有 QR 圖片 |
| 9 | 換原本的申請人帳號登入 | /login | 直接進 /dashboard 社區總覽 |
| 10 | 試一下駁回流程（另一個 pending 申請或重建一個） | /ops/communities | 彈出駁回 modal，必須填 ≥10 字理由才能送出，信也會寄出 |
| 11 | 點「我只是來看看」 | 全新帳號 → /onboarding | 一鍵跳首頁，可自由瀏覽不卡在 onboarding |
已知尚未實作（預計 Phase 1b / 2 / 3）
- 信中的 QR 掃出來會是
https://harmonyhub.cc/verify/...——這個頁面 Phase 1b 才會做，目前掃到會看到 404，不影響核心流程 - 所有權人 Excel 上傳 + 住戶自助驗證（這整塊是 Phase 1b）
- 裝修登記、文件庫改「只能看不能下載＋申請寄信」、公告附檔（Phase 2）
- 保養車梯車位分類、報修分拆、安檢照片、行事曆個人事件、廠商名片拖曳（Phase 3）
三、還有五個小問題之前你已經回答過了，我記一下：
- 建築使用執照 —— 三種申請狀態都需要（已做）
- 所有權人姓名比對 —— 名字陣列找得到就算過（Phase 1b 實作時會照這個做）
- 兼職總幹事 —— 社區委外的持證總幹事（Phase 2 文件庫加簽邏輯會 gate 在這個身份上）
- 寄件人 —— 三和雲客服 <客服@harmonyhub.cc>（已上線）
- QR 共用還是獨立 —— 共用一張（已做）
四、下一步
這一輪你踩完沒問題的話，我們就進 Phase 1b：
- 所有權人名冊 Excel 上傳
- 住戶 QR 自助驗證（掃碼 → 選門牌 → 比對姓名 → 選身份/用途）
然後才是 Phase 2（裝修 + 文件庫 + 公告附檔）和 Phase 3（模組優化細節）。
踩到什麼立刻 LINE 我，別客氣。
Jason ＆ Claude 🫡