啡記：從今天的需要出發。
按你今天的需要，找到合適的香港咖啡店。
這套工具把產品定位轉成可操作的六週驗證：手機尺寸原型、30 間有來源的候選分店，以及訪談、試用和回訪工作表。訪談、店主確認和實地測試尚未執行；本套件沒有虛構測試結果。
01 / 產品與差異
公開產品以 iPhone 和 Android 為正式開發目標，逐步覆蓋全港。每間分店獨立記錄；同一間店可同時適合多種用途。第一版聚焦探索、收藏、私人日誌與資料更正。
| 找店入口 | 優先資訊 | 必要條件的處理 |
|---|---|---|
| 喝精品咖啡 | 豆單、烘焙商、沖煮選項、飲品價位 | 例如「有手沖」須有明確證據 |
| 工作或讀書 | 電腦政策、插座、Wi-Fi、限時、最低消費 | 未知不可當作符合；政策可按時段不同 |
| 體驗氣氛 | 空間照片、風格、自然光、安靜或熱鬧 | 觀察附日期與時段，避免視為永久保證 |
用戶先選目的，再按地區、預算和必要條件縮小結果。卡片說明符合的條件，詳情保留「未確認」和來源。收藏用來保存想去的店，日誌預設私人，日誌照片與心得不自動成為公開店舖資料。
市場已有相近功能：OpenRice 提供收藏及想去／去過清單；Desk Out 聚焦香港工作場所；Brewtifi 結合咖啡與工作條件。這是官方產品描述的比較，沒有實測競品。
02 / 六週執行表
| 時間 | 行動與配額 | 本階段的產出 |
|---|---|---|
| 第 1–2 週 | 15 人訪談；主要需求每類 5 人 | 最近一次找店流程、工具、困難、必要條件與可放棄條件 |
| 第 3 週 | 核實 30 間店；港島、九龍、新界各 10 間 | 店舖政策、價位、場景觀察、照片授權、證據與核實日期 |
| 第 4 週 | 30 人試用；主要需求每類 10 人 | 三分鐘任務、選店成功與失敗原因；開始 14 日觀察 |
| 第 5–6 週 | 實際選店及到訪、逐人完成回訪 | 現場準確度、主動重用、再用理由；整理繼續或調整的決策 |
以兼職投入，每週先安排 2–3 次訪談／測試時段，再處理名錄與證據。先招募有近期找店經驗的人；每人只按主要需求計入一個配額，仍可記錄次要需求。測試者應包括不認識你的用戶。
第 4 週較遲開始的參加者，14 日觀察可能超過第 6 週，應延後結案，不能提前判定留存。招募、聯絡和排期由你執行；此套件沒有自動發送訊息或建立排程。
目前狀態：工具已製作；全部真人研究及分店核實仍待執行。工作表的受訪者和試用者 ID 是空白記錄位置。
03 / 訪談：重建最近一次找店
開場（2 分鐘）
「我在研究香港人怎樣選咖啡店，想了解你最近一次的經驗。沒有標準答案；你可跳過問題或隨時停止。我會以匿名編號記錄。是否同意？」錄音及照片另行取得同意。
經驗（15 分鐘）
- 你最近一次想找咖啡店是甚麼時候？當時在哪區、和誰、想做甚麼？
- 由起念到決定，逐步用了哪些工具或問了誰？可展示當時的搜尋／收藏，毋須提供私人帳戶資料。
- 當時不可缺少甚麼？哪些只是加分？如何確認條件？
- 花了多久？在哪一步卡住或放棄？有沒有到場才發現不合適？
- 最後為何選那間？同時排除了甚麼？
- 之後有記下店或飲品嗎？下次如何找回？
收尾（3 分鐘）
「若這一步變得容易，你會在甚麼情況再次需要它？」先取得具體例子，最後才展示構想。避免用「你會喜歡這 App 嗎」作需求證據。
記錄方式
在「訪談紀錄」填日期、當時目的、現用工具、具體困難、必要條件及原話。把觀察、原話、你的推論分開記錄。匿名 ID 用 I01–I15，聯絡方法另存，不放進可分享工作表。
04 / 名錄與分店核實
已備 30 間真實候選分店，港島、九龍、新界各 10 間，每間有來源與查閱日期。來源支持候選名稱與地址，不代表已確認現時營業、設施、價位或氣氛。30 間名單偏向容易取得官方資料的品牌分店，並非代表香港咖啡店市場的樣本。正式測試前補充獨立店及不同風格，替換名額時保持各地域 10 間。
食環署餐廳牌照資料 可協助核對牌照，但需另外辨識咖啡店，亦不能由牌照推定場景設施。
| 證據種類 | 要問或觀察的事項 | 保存方式 |
|---|---|---|
| 店主／職員確認 | 可否用電腦？是否限座位／時段？插座能否使用？Wi-Fi？限時？最低消費？豆單與沖煮？飲品最低價？ | 分店、確認日期、確認方式、逐條原文及適用時段；不把一間分店的政策套到整個品牌 |
| 實地觀察 | 自然光、音量、空間風格、座位情況、到訪日期與時段 | 標示觀察者及日期；氣氛是當次觀察，保留與店主說法不同的內容 |
| 公開來源 | 分店官方頁、公開菜單或已授權資料 | 網址、查閱日期、來源所支持的具體欄位；網站查閱日與實地核實日分開 |
| 用戶更正 | 漏店、地址錯誤、條件或營業狀態改變 | 先列待核實，核實後再公開；私人日誌不自動匯入 |
不清楚就填「未確認」。必要條件未知時不推薦為符合。條件互相矛盾時保留證據並暫停肯定標示。資料更新可先按使用量與最近爭議排列人工核查，正式服務再設更新週期。
把核實資料放進原型
修改 candidate-cafes.json，可逐店加 features（如 {"wifi":true,"outlets":null,"laptop":false}）、priceMin、verifiedAt、verificationSource、atmosphere、observedAt 及 observationSource。只有有證據的條件才用 true／false，未知用 null。用 Node.js 在套件目錄執行 node refresh-data.cjs，重新產生原型資料與 CSV，再重新整理瀏覽器。工作表名錄需同步更新，兩者不會自動同步。任何已確認咖啡、價位或政策欄都需核實日期與依據；氣氛觀察另需 observedAt 和 observationSource。日期不能無效或在未來。新增店保留獨立 ID；備份日誌依賴該 ID，勿隨意改動或刪除舊 ID。替換試用名額時，保留舊分店記錄並加 inPilot:false，新增分店使用新 ID；舊店仍可從收藏及日誌查看。
05 / 原型試用與真實到訪
先驗證介面，再驗證需求
「示範」內有 6 間虛構店，條件和插畫只供操作測試。示範模式不能作真實選店、現場準確度或需求驗證的證據。「真實候選」有 30 間待核實分店；必須先完成必要條件核實，才用於正式測試。
- 取得同意；分配 P01–P30，記主要需求。每類 10 人，盡量使用自己的 iPhone／Android 瀏覽器。
- 讓參加者說明今天想去哪區、預算、不可缺少的條件；主持人事先檢查已核實名錄是否有符合的店，沒有時保留失敗，不提示答案。
- 從打開探索並開始閱讀計時，到參加者找到、確認一間符合全部必要條件的候選店停表。記實際秒數，不截斷為 180；180 秒內且條件成立才算成功。
- 主持人不教操作或暗示店名；記錯誤點、查閱來源的需要和找不到的原因。途中求助另記。
- 邀請自行決定是否實際到訪，不強迫消費。到訪後逐條核對必要條件、價格及政策；取得照片使用同意後才保存研究照片。
- 邀請試用收藏和私人日誌，觀察是否有真實保存理由，而非只因主持人要求按鈕。
14 日回訪
先觀察首次試用後第 1–14 個曆日是否自行再次使用。不要以促銷或操作提醒製造主動使用。第 14 日完成後做一次研究回訪，核對再次使用日期、觸發原因與是否受提醒。主持人要求打開 App、研究回訪當次打開、同日重開均不計主動回用。此原型沒有自動追蹤，用戶自述為人工資料，保留此限制。
06 / 指標與決策
| 指標 | 計算 | 初步門檻 |
|---|---|---|
| 找店成功 | 180 秒內且符合全部必要條件的人數 ÷ 有同意及完整任務紀錄的人數；30 人完成才判定首輪 | ≥80% |
| 現場準確 | 認為選店資料符合現場的人數 ÷ 實際到訪者；有到訪者欠回報時暫不判定 | ≥70% |
| 14 日主動回用 | 首次試用後第 1–14 日有主動回用的人數 ÷ 已過 14 日的試用者；有人欠回訪時暫不判定 | ≥30% |
「成效總覽」可改評估日期及研究起始日；工作表的藍色欄為輸入、灰綠欄為計算。找店與回用需 30 人完成／成熟後才判定；準確度另列實際到訪人數與回報完整度。未到訪的人不進準確度分母。以小樣本形成下一步決策，不當作統計上的市場需求證明。
- 三項均到門檻：檢查三類用戶的差異與實際再次使用理由，再投入正式開發和資料維護。
- 找店失敗：區分資料不足、條件無候選、操作困難與需求不存在，修改後重新測試。
- 準確度不足：先修核實流程，記最常失真的條件，不用增加店數掩蓋問題。
- 回用不足：查是否需求頻率低、已有工具足夠、收藏價值弱；考慮縮小主要用途。
07 / 商業假設與正式開發交接
初期免費，待有重複使用再分開測試兩條商業方向。這輪原型沒有收費、商户廣告或支付功能。
店舖贊助專題／活動
向店主展示匿名研究摘要，問最近如何吸引合適客人、目前渠道、活動成效與付費條件。再展示標示「贊助」的專題構想，問願意試哪些方案及可接受的費用；口頭興趣不算付費承諾。
進階個人整理
向已重用的用戶問收藏變多後的困難，展示分组、日誌整理或匯出構想，了解會付費的具體情境及替代方案。先驗證付費意願，再決定功能與價格。
贊助內容清楚標示；任何排序或適用條件都根據核實資料呈現。正式版本再實作帳戶、私人存取權限、跨裝置同步、照片儲存、真實地圖與更正審核。兩平台的需求與資料模型共用，技術選型在驗證後決定。
資料模型以分店為單位：ID、名稱、全港 18 區、地址、目的相關 nullable conditions、價格、來源、逐條證據及日期。私人收藏／日誌有使用者擁有者，公開名錄與回報審核分開。原型沒有公開後端，不能視為正式服務的安全與同步實作。
08 / 開始使用
- 解壓整套檔案，開啟 prototype/index.html。頁面不依賴外部字型或網絡程式庫；來源及 Google Maps 連結需網絡。
- 先用示範模式試用途、篩選、詳情、收藏、日誌。地圖是區域示意，非精準導航；真實店詳情可按地址開啟 Google Maps。
- 收藏、日誌、照片及待提交更正只存這個瀏覽器。沒有帳戶／跨裝置同步，不會自動提交或公開。共用裝置的下一位使用者可能看到它們。
- 更正店舖時用「只匯出回報」，分享前自行檢查內容；它不含私人日誌與照片。完整私人備份只供恢復自己的紀錄。在「資料」匯出 JSON 備份後妥善保存；清除網站資料、換瀏覽器或改來源網址可能遺失本機紀錄。匯入會先確認替換。分享原型檔案不包含本機日誌，但匯出的私人備份含日誌與照片。
- 打開驗證工作表，輸入起始日期；依手冊進行訪談與分店核實。先確保真實名錄適合測試，再招募 30 人進行正式找店任務。
可在電腦啟動本機 HTTP 服務測試手機尺寸；若要讓測試者在自己的手機使用，需安排合適的測試網址或個別裝置檔案開啟方法。本套件未公開部署、未建立手機商店版本。