Documentation & User Manual

系統操作手冊

完整解析「AIAddress 智慧選址與加盟決策平台」的核心功能、角色權限與標準操作流程 (SOP)，幫助您快速掌握數據決策能力。

1

系統總覽

AIAddress 智慧選址系統是一套專為營運總部與加盟開發單位量身打造的決策 OS。我們將複雜的 GIS 商圈分析、內部營業數據、市場競品分佈與 AI 預測模型融合，提供一站式的展店評估流。

系統不僅解決了過去選址高度依賴主觀經驗的痛點，更能透過客觀的 AI 營收預測 與 財務回本模擬，為每一份選址決策產出具備 A/B/C 分級的專業提報報告。

地理大數據底座

內建人流、消費力、競品分佈、交通節點與租金行情等數十種維度，0.5 秒即時生成商圈輪廓。

自動化決策引擎

整合內部歷史展店模型，透由機器學習輸出精準備的點位評分、預估營收及產品結構建議。

2

角色與權限分配 (RBAC)

系統採用嚴格的「角色導向存取控制」(Role-Based Access Control, RBAC)，確保機敏營收數據與決策報告的安全性。

系統管理員 / 高階主管 (Admin)

擁有全站最高權限，負責模型參數調整與人員管理。

    帳號審核與權限派發 全局 KPI 儀表板觀測 AI 模型參數與系統設定

市場開發 / 加盟專員 (Developer)

系統核心使用者，負責日常物件建檔、商圈分析與報告生成。

    新增/編輯選址案件 匯出 PDF / PPT 提報報告 加盟商 CRM 管理

加盟商 / 唯讀展示 (Franchisee / Demo)

受限的外部使用者，僅能查看分配到的核准案件進度。

    會員專屬 GIS 探索器操作 專屬報告中心下載報告 無權限創建案件與查看演算細節
3

後台介面與主要功能操作

總部人員與加盟商可登入系統後台，進行各項管理與觀測作業。以下為系統核心的操作模組與用途指南：

營運儀表板 (Dashboard)

提供全品牌的選址案件總覽，包含本月預估營收、A/B/C 等級分佈及高風險案件動態，幫助高層主管從宏觀視角掌握展店健康度與潛在風險。

選址案件管理中心

案件的日常作業入口。支援逐筆輸入或「Excel/CSV 批量匯入」，可在此查詢歷史評估紀錄，或點擊啟動特定門市的 GIS 地理與 AI 綜合演算流程。

加盟商 CRM 管理

開發人員在此追蹤加盟主的互動歷程。可建立訪談日誌、預約店鋪勘察，並直接針對個別加盟主發放該點位的專屬評估報告。

精美的報表決策中心

大幅縮短手工製作企劃書的時間。將商圈地圖、消費熱力圖、競爭分析與三情境模擬，一鍵封裝成高質感的 PDF 或 PPT 品牌報告。

4

會員前台 (GIS探索器與報告中心)

為加盟商或外部會員全新打造的視覺化介面，讓使用者無需進入複雜的內部系統，即可沉浸式體驗商圈數據。

Next-Gen

GIS 商圈探索器 (次世代升級)

沉浸式的全螢幕地圖介面，內建 7 大分析類別。右側具備透明玻璃面板 (Glassmorphism) 及互動圖表，最新版本更導入了兩大創新：

  • 真實等時圈 (Isochrones)：摒棄不精準的直線半徑圓圈，改以真實路網計算的 10 分鐘步行不規則幾何範圍。
  • AI 地理精靈 (Chat-to-Map)：內建互動式語義助理，輸入需求後能自動平移地圖 (Auto-Pan) 並高亮推薦最佳點位。

我的報告中心 (Member Reports)

將會員專屬的各項決策分析報告集中管理。視覺風格與前台介面無縫整合，提供一鍵下載高階 PDF 摘要或 PPT 簡報檔功能，徹底優化使用者體驗。

5

核心選址決策流程 (五步拆解)

創建案件與地址定位

在後台點擊「新增案件」，輸入候選店面的精確地址。系統會透過 Geocoding 技術即時抓取經緯度，並在地圖上完成標繪。同時請輸入坪數與月租金，作為後續財務模組的基礎參數。

也支援透過「批量匯入 (Excel/CSV)」一次性上傳大量候選地址清單。

啟動 GIS 商圈擴散分析

系統會以該點位為圓心，展開預設的 500M 步行分析半徑。後置微服務會自動抓取範圍內的人口結構（居住/工作）、歷史消費力熱圖、以及同業競品密度指標。

AI 點位評分與營運預測

這是一鍵完成的核心環節。Python FastAPI 模型將接收環境參數與物件參數，輸出「點位綜合分數 (0-100)」、「建議產品結構佔比 (Product Mix)」及「精確營收預測」。

三情境回本模擬

結合前階段的營收數據加上輸入的租金，系統會自動套入內建的人事與裝潢成本參數，運算出「樂觀」、「基準」、「悲觀」三種情境下的預計回本期 (Payback Period)。

產出 PDF/PPT 決策報告

完成分析後，開發人員僅需點擊右上角的「匯出報告」，系統會自動生成品牌專屬格式的 PDF 摘要檔案或 PPT 企劃書，供內部評議會提報使用。

6

常見問題與障礙排除 (FAQ)

系統提示「AI 服務連線失敗或超時」該怎麼辦？

這通常意味著後端 Python 分析微服務 (預設 Port: 8001) 因負載過高或網路波動中斷。智慧選址系統內建了 Failover 容錯機制，畫面若呈現「Mock/降級資料」，請稍後重新整理頁面。若持續發生，請聯繫管理員檢查 AI 服務。

發現地圖定位的地址偏差該如何修正？

部分新開闢道路或商場內部地址，Geocoding API (OpenStreetMap) 可能無法準確辨識。您可以在案件編輯頁面中，直接手動拖曳地圖大頭針 (Pin)，獲取準確座標儲存後再重新執行商圈分析即可。

無法順利下載 PDF 報告檔？

請確定您使用的帳號擁有 Developer 以上權限。同時，若案件處於「Draft (草稿)」狀態且尚未完成至少一次的 AI 運算，報表生成按鈕將被鎖定。請首頁完成計算後再嘗試匯出。