Documentation & User Manual
系統操作手冊
完整解析「珍煮丹 AI 智慧商圈決策系統」的核心功能、角色權限與標準操作流程 (SOP)，幫助您快速掌握數據決策能力。
系統總覽
AIAddress 智慧選址系統是一套專為營運總部與加盟開發單位量身打造的決策 OS。我們將複雜的 GIS 商圈分析、內部營業數據、市場競品分佈與 AI 預測模型融合，提供一站式的展店評估流。
系統不僅解決了過去選址高度依賴主觀經驗的痛點，更能透過客觀的 AI 營收預測 與 財務回本模擬，為每一份選址決策產出具備 A/B/C 分級的專業提報報告。
地理大數據底座
內建人流、消費力、競品分佈、交通節點與租金行情等數十種維度，0.5 秒即時生成商圈輪廓。
自動化決策引擎
整合內部歷史展店模型，透由機器學習輸出精準備的點位評分、預估營收及產品結構建議。
角色與權限分配
系統依角色分配功能與資料範圍，確保機敏營收與決策報告安全。請點各角色「操作影片觀看」了解日常操作畫面。
實際登入後台截取的操作示範｜管理員／專員／加盟商
系統管理員／高階主管
擁有全站最高權限，負責模型參數調整與人員管理。
-
帳號審核與權限派發
全局關鍵績效儀表板
模型參數與系統設定
市場開發／加盟專員
系統核心使用者，負責日常物件建檔、商圈分析與報告生成。
-
新增／編輯選址案件
匯出 PDF／簡報報告
加盟商客戶關係管理
加盟商
查看分配到的案件進度、商圈探索與核准報告下載。
-
商圈探索器
我的報告中心
分配案件進度
後台介面與主要功能操作
總部人員與加盟商可登入系統後台，進行各項管理與觀測作業。以下為系統核心的操作模組與用途指南：
營運儀表板 (Dashboard)
提供全品牌的選址案件總覽，包含本月預估營收、A/B/C 等級分佈及高風險案件動態，幫助高層主管從宏觀視角掌握展店健康度與潛在風險。
營運監控儀表板（/ops）
開店後盯業績、外送、會員（OCARD）、異常預警、備料耗損與加盟主單店視角。期間比較刻意採「本月 vs 去年同月」以避開季節失真。
- ・老闆／營運經理可見知識庫、模型監控、POV 成果追蹤
- ・畫面右上「？」可看各頁怎麼用與專業名詞
- ・數字以 POS／日營運／商品銷售／OCARD 等後端資料為主；缺資料顯示空狀態或 N/A
選址案件管理中心
案件的日常作業入口。支援逐筆輸入或「Excel/CSV 批量匯入」，可在此查詢歷史評估紀錄，或點擊啟動特定門市的 GIS 地理與 AI 綜合演算流程。
加盟商 CRM 管理
開發人員在此追蹤加盟主的互動歷程。可建立訪談日誌、預約店鋪勘察，並直接針對個別加盟主發放該點位的專屬評估報告。
精美的報表決策中心
大幅縮短手工製作企劃書的時間。將商圈地圖、消費熱力圖、競爭分析與三情境模擬，一鍵封裝成高質感的 PDF 或 PPT 品牌報告。
會員前台 (GIS探索器與報告中心)
為加盟商或外部會員打造的視覺化介面；也可從營運後台「商圈搜尋」進入同一探索器。地圖上的色點與圖表名詞，可隨時點右上或地圖右上「？」查看圖例與白話說明。
GIS 商圈探索器
全螢幕地圖＋左側分析面板（消費力、人口、交通、指標品牌等）。最新能力包含：
- 真實等時圈：依真實路網計算步行 5／10／15 分鐘可到達範圍，不是直線圓。
- 分析鎖點（紅色準心）：可拖曳或點地圖空白處移動，系統會重算周邊分析。
- 分色圖示標記：門市為深綠方塊＋店舖圖示；補習班／金融／捷運／同業餐飲等 POI 各有圓形圖示，避免誤認成門市。
- 尋址精靈／語意選址：用語意條件篩已建檔候選案件並標在地圖上（不是自由聊天知識庫）。
地圖點位怎麼看（與畫面上「？」圖例一致）
自家門市（方塊）
補習班
金融機構
軌道／捷運
同業餐飲
分析鎖點
我的報告中心 (Member Reports)
將會員專屬的各項決策分析報告集中管理。視覺風格與前台介面無縫整合，提供一鍵下載高階 PDF 摘要或 PPT 簡報檔功能。
專業名詞白話說明
系統畫面常出現技術用語。以下用一般人聽得懂的方式說明；在商圈搜尋／營運頁也可點「？」即時查閱。
電信信令
電信業者用手機連線基地台彙整的去識別統計，用來估計哪個時段人比較多。不是追蹤個人、也不是即時監視。
旅次
統計區間內「人移動／進出」次數的加總。數字越高＝該時段活動越熱絡；不是門市來客數、也不是現在現場人數。
鄉鎮市區旅次時段
以整個行政區（如板橋區）為單位，把平日／假日的早中晚旅次畫成圖，方便看尖峰時段。正式資料來源常標「電信信令」。
軌道可及性
鎖定點附近捷運／軌道站多不多、近不近的綜合評級。
等時圈
依真實路網步行 5／10／15 分鐘可到達的範圍，不是直線畫圓。
六角熱力網格
【用途】用地圖上的六角形色塊＋顏色深淺，一眼看出候選點周邊哪裡據點密、哪裡空，方便找熱區或避開過擠／過冷位置；不是即時人流。
六角網格
【用途】把分析範圍切成一塊塊六角形「小區」，讓你對齊系統在算哪一區，而不是整片模糊地帶。
熱力網格
【用途】用顏色深淺標出哪一格附近學校／捷運／競品等據點比較密；越深越熱鬧。沒資料不會亂填假數字。
消費力熱點
依村里綜所稅／人口等開放資料推估相對購買力較高的村里，不是即時刷卡金額。
SEGIS
政府社會經濟地理資訊系統的開放統計圖資來源代號。
OCARD
會員／點數相關匯入資料（本系統多為 FTP 檔案匯入），儀表板用來觀察會員活動與通路結構。
期間比較（月對月）
本月跟「去年同月」比，不是跟上個月比，避免飲料業季節性造成誤判。
POV
期末價值驗證（Proof of Value）指標追蹤頁，供管理層對照政府／專案查核目標。
Geocoding（地理編碼）
把地址文字轉成地圖上的經緯度座標。
核心選址決策流程 (五步拆解)
創建案件與地址定位
在後台點擊「新增案件」，輸入候選店面的精確地址。系統會透過 Geocoding 技術即時抓取經緯度，並在地圖上完成標繪。同時請輸入坪數與月租金，作為後續財務模組的基礎參數。
也支援透過「批量匯入 (Excel/CSV)」一次性上傳大量候選地址清單。
啟動 GIS 商圈擴散分析
系統會以該點位為圓心，展開預設的 500M 步行分析半徑。後置微服務會自動抓取範圍內的人口結構（居住/工作）、歷史消費力熱圖、以及同業競品密度指標。
AI 點位評分與營運預測
這是一鍵完成的核心環節。Python FastAPI 模型將接收環境參數與物件參數，輸出「點位綜合分數 (0-100)」、「建議產品結構佔比 (Product Mix)」及「精確營收預測」。
三情境回本模擬
結合前階段的營收數據加上輸入的租金，系統會自動套入內建的人事與裝潢成本參數，運算出「樂觀」、「基準」、「悲觀」三種情境下的預計回本期 (Payback Period)。
產出 PDF/PPT 決策報告
完成分析後，開發人員僅需點擊右上角的「匯出報告」，系統會自動生成品牌專屬格式的 PDF 摘要檔案或 PPT 企劃書，供內部評議會提報使用。
常見問題與障礙排除 (FAQ)
「鄉鎮市區旅次時段（電信信令）」是什麼？可以當現場人數嗎？
這是用電信業者彙整的「人移動次數（旅次）」，依平日／假日早中晚畫成圖，用來判斷哪個時段人潮較熱。單位是整個行政區（如板橋區），不是單一路口。
不能當成現在這一刻的現場人數，也不是門市來客數。詳見本頁「專業名詞白話說明」與商圈搜尋交通面板上的說明文字。
地圖上綠／紫／紅點各代表什麼？
門市為深綠方塊＋店舖圖示；補習班／金融／捷運／同業餐飲等為不同顏色的圓形圖示；紅色準心是分析鎖點（可拖曳重算）。在商圈搜尋頁點右上或地圖右上「？」可開完整圖例。
系統提示「AI 服務連線失敗或超時」該怎麼辦？
這通常意味著後端 Python 分析微服務 (預設 Port: 8001) 因負載過高或網路波動中斷。智慧選址系統內建了 Failover 容錯機制，畫面若呈現「Mock/降級資料」，請稍後重新整理頁面。若持續發生，請聯繫管理員檢查 AI 服務。
發現地圖定位的地址偏差該如何修正？
部分新開闢道路或商場內部地址，地理編碼可能無法準確辨識。您可以在案件編輯頁或商圈探索器中，直接手動拖曳地圖大頭針（分析鎖點），獲取準確座標後再重新執行商圈分析即可。
無法順利下載 PDF 報告檔？
請確定您使用的帳號擁有 Developer 以上權限。同時，若案件處於「Draft (草稿)」狀態且尚未完成至少一次的 AI 運算，報表生成按鈕將被鎖定。請先完成計算後再嘗試匯出。