USER MANUAL · 情境式操作手冊

5 分鐘上手:用發票開放資料回答你的商業問題

這份手冊用「真實工作情境」帶你操作儀表板——你不需要懂資料工程,只要找到和你角色相近的情境,照著三步驟看,就能拿到要的答案。所有數字皆來自財政部電子發票開放資料,未經加工。

⚡ 快速開始 🛒 行銷:全國消費熱度 📍 展店:城市/景點選點 ☁️ 財會/ESG:無紙化進度 ❤️ 公益:捐贈檔期 📊 主管:一頁月報 🗺️ 地圖:選點與預估 🔮 AI:消費預測 🚨 AI:異常偵測 ⛰️ AI:觀光商機 💬 AI:自然語言問數 🧭 介面操作 🔄 更新資料 🤖 AI 進階

0快速開始

三種開啟方式,擇一即可。

🐳 方式 A:Docker 一鍵起站(可帶走,推薦)

任何有 Docker 的主機(Linux / 雲端 / 內網)執行 docker compose up -d --build,開 http://主機:8087/。六頁全部可用——含「💬 問數」(純前端 SQLite)。建置與 serve 全在容器內,不依賴本機。

☁️ 方式 B:Cloudflare Pages / CDN(公開)

當純靜態站上 Cloudflare Pages(雲端):npx wrangler pages deploy .。純靜態、無後端、無資料庫對外,攻擊面最小。見 README.md。

🔄 方式 C:更新資料(仍在容器內)

取得最新 data/*.json 後,docker compose build --no-cache 即在 build 容器內重建 db/einvoice.sqlite(含去重+smoke),再 up -d。不在本機跑腳本。需即時連活資料庫/LLM 的,用 Production(postgres)版。

🧭 六個頁面

📊 儀表板·🗺️ 地圖·📈 AI 分析·💬 問數·📑 月報·📘 手冊。頂部互相連結。中/EN 可切換(問數/月報/手冊正文為中文,介面標籤切換)。

1行銷企劃:全國消費現在熱不熱?

情境:你要決定本週要不要加碼投放廣告,想先掌握全國消費的「即時體溫」。

🛒
行銷企劃 Amy
數位行銷

這個月全國買氣比上個月旺嗎?雲端發票占比上來了沒?

  1. 看 「國民消費脈動 · 日 / 週 / 年」 三張卡:分別是最新單日、近 7 日、近 365 日的全國開立張數,卡上小圖是近期走勢。
  2. 看 「近 12 個月開立量」:橘線是雲端化率,柱是開立量,判斷月趨勢是上升或回落。
  3. 回到頂部 「電子發票開立成效」 KPI 卡,看年增(YoY)百分比與單日雲端化率。
📈 怎麼判讀:近 7 日張數明顯高於前期、且雲端化率持續往上 → 線上消費動能強,適合加碼數位投放;若單日驟降,先確認是否遇連假再決策。

2展店/通路團隊:哪個城市、哪個景點最旺?

情境:你要替零售或餐飲品牌找下一個展店點,想用客觀數據佐證。

📍
展店經理 Ken
零售展店

近一年哪個縣市最會花?客單價最高在哪?哪個觀光景點消費最熱?

  1. 到 「三維消費熱點分析」,點 城市別消費分析:看「縣市開立金額排行」與「縣市客單價」兩張圖,金額大=市場規模,客單價高=高消費客群。
  2. 下方縣市明細表可同時比較金額、張數、客單價,挑符合品牌定位的縣市。
  3. 點 觀光景點別消費分析:選年度與業別(零售/住宿/餐飲),切換依金額指數/依張數指數,看村里級熱點排行。
🗺️ 怎麼判讀:金額指數高的村里=該業別消費熱區,適合街邊店/快閃;搭配客單價挑「高消費 × 高人流」的雙高地段。指數為財政部相對熱度,跨景點可比、非絕對金額。

3財會 / ESG:無紙化(雲端發票)進度到哪了?

情境:你要在 ESG 報告或數位轉型簡報引用「全國電子發票雲端化」趨勢。

☁️
永續專員 Lisa
ESG / 財會

電子發票雲端化從幾年前到現在進步多少?有沒有長期曲線可以引用?

  1. 看 「B2C 年度開立與捐贈累計」 旁的 雲端化長期趨勢圖:這是每月雲端發票占全部開立比率,一路從個位數爬升。
  2. 頂部 KPI 卡的單日雲端化率是最新即時值;數據摘要會自動算出「起點 → 現在」的雲端化提升幅度,可直接引用。
  3. 「B2C 年度」柱狀圖看歷年開立張數規模成長,佐證數位化普及。
♻️ 怎麼引用:截圖雲端化趨勢圖 + 摘要那句「雲端化率由 X% 升至 Y%」即可放進報告;正式引用請註明資料來源為財政部電子發票開放資料。

4公益團體:什麼時候推捐發票效果最好?

情境:你負責勸募雲端發票愛心捐贈,想找最佳檔期與溝通時機。

❤️
勸募專員 Wei
NPO 公益

雲端發票捐贈長期是成長還是停滯?單日捐贈量大概多少?

  1. 頂部 KPI 卡看 單日雲端捐贈張數,掌握目前每日捐贈規模基準。
  2. 「每月開立量 vs 雲端化率」可看整體雲端發票成長(捐贈須先有雲端發票載具)。
  3. 對照 B2C 年度圖的捐贈線:看歷年捐贈張數走勢,鎖定成長年份的季節規律。
💡 怎麼運用:雲端發票基數越大、捐贈轉換空間越大;在開立量高峰月(如年節、報稅季)加強勸募,通常成效較佳。進一步可用 §AI 的「捐贈優化」做檔期推估。

5主管:給我一頁就好的月報

情境:你要在週會 3 分鐘講完「全國消費 + 我們關注的縣市/行業」近況。

📊
部門主管 David
決策

不用我自己挑數字,直接給我重點和一句話結論。

  1. 看頁面中段的 「數據摘要與觀察」 黃綠色框:已自動把日/週/年脈動、雲端化、最熱行業/縣市/景點濃縮成 5 條重點。
  2. 需要圖就截 KPI 卡 + 脈動三卡 + 一張熱點圖,貼進簡報即可。
  3. 想要全自動、每月寄到信箱的中文月報?見 §AI 的「自動月報生成」。
🧾 小技巧:摘要會隨語言切換為中/英;對外簡報用英文版時切 EN 再截圖即可。

6消費地圖:在臺灣地圖上選點、比較、看預估

情境:你想用一張臺灣地圖直觀比較幾個縣市,還要看下個月的預估。

🗺️
區域經理 Ray
區域營運

北中南幾個縣市,哪個現在最強、下個月可能多少?

  1. 右上角點 🗺️ 消費地圖 進入地圖頁;地圖依最新月金額深淺著色,顏色越深=金額越高。
  2. 在地圖上點縣市:右側出現該縣市卡片 —— 左上最新月累計金額、左下次月預估(最好/標準/最差)、右側近 12 月趨勢 + 去年同期虛線。
  3. 再點其他縣市可同時比較(最多 6 區),上方會出現疊圖;再點一次或按 × 取消。
  4. 切到 鄉鎮熱度 圖層,選年度與業別(零售/住宿/餐飲),看觀光景點消費熱區(相對指數)。
📐 預估怎麼來:「標準」= 該縣市近 12 個月線性迴歸推次月;「最好/最差」= 標準 ± 預估區間(地圖上可下拉調整,預設 ±1.75%)。月金額因「批次申報」會波動,看趨勢方向比看單點更可靠。
🔆 鄉鎮熱度看不懂?切到「鄉鎮熱度」後,右側會把財政部的「指數」換算成 0–100 熱度分數 + 全國排名,並列出該鄉鎮的熱點村里;指數是相對比較值、非金額。

AAI 加值功能(已上線)

頂部「📈 AI 分析」與「💬 問數」兩頁,提供四項在開放資料上實作的分析。以下逐一說明使用情境。

🔮消費預測(季節性)

在「📈 AI 分析 → 消費熱點預測」。預測各縣市 / 行業的次月開立金額。

🔮
營運企劃 Joy
需求預估

下個月哪個縣市/行業會成長?旺季落在幾月?

  1. 切 縣市 或 行業 分頁,看「次月預測排行」:每列有上月、預測次月、變化%、旺季月。
  2. 點任一列 → 右圖顯示近 12 月實際(柱)+ 預測次月(橘點)。
  3. 用「變化%」找成長最快的縣市/行業;用「旺季月」安排檔期與備貨。
📐 方法:季節性分解——先用月別算出季節指數,去季節後做線性趨勢外推,預測 = 趨勢 × 季節指數。比單純直線更貼近實際月節奏。為統計推估,僅供參考。

🚨異常偵測

在「📈 AI 分析 → 開立量異常偵測」。自動標出每日開立量的異常波動。

🚨
維運/分析 Sam
監控

最近有沒有哪天開立量爆衝或異常下滑?可能是什麼?

  1. 看上方三個指標:近 18 月異常數、全期異常數、最新資料日。
  2. 折線圖上紅點就是異常日;滑入看當天張數。
  3. 「近期異常清單」列出日期(含星期)、當日、預期、偏離 %、方向(偏高/偏低)——對照節慶/連假/政策判讀成因。
📐 方法:星期別基準 z-score——拿前 8 個同星期幾算平均與標準差(避免平日/假日落差),z=(當日−平均)/標準差,|z|≥3 視為異常。純統計、不需訓練。

⛰️觀光商機(外縣市客源 × 在地消費)

在「📈 AI 分析 → 觀光商機」。看哪些縣市靠外地遊客消費、客源從哪來。

⛰️
觀光/通路 Tina
觀光行銷

哪個縣市最靠觀光財?遊客主要來自哪幾個縣市?

  1. 看「觀光磁吸排行」:長條 = 外縣市客源占比,越長代表越靠外地遊客(例:臺東、連江、屏東)。
  2. 點任一長條 → 右側顯示該縣市外縣市占比、外縣市消費額與主要客源縣市排行。
  3. 客源縣市 = 行銷投放的目標市場;高外來占比 = 適合觀光導向選品/活動。
📐 資料:電子發票載具客源地統計;「外縣市」= 載具持有人非消費當地縣市。金額為該年該業別合計,屬推估,僅供參考。

💬自然語言問數(Text-to-SQL)

在頂部「💬 問數」。用中文問問題,系統轉成 SQL 查資料庫,回圖表 + 結論。

💬
任何人 Anyone
免寫 SQL

上個月哪個縣市開立金額最高?餐飲業哪個縣市最高?

  1. 直接在輸入框打中文問題(或點下方範例問句),按「問數」。
  2. 系統回:一句話結論 + 產生的 SQL + 圖表 + 結果表格。
  3. 看不準?換句話問;狀態列會顯示引擎狀態與最新月份。
⚙️ 怎麼運作(技術 · 本 CDN 版為純前端):
① 規則式 NL→SQL(預設、現在就在跑):瀏覽器內用樣式比對判讀意圖(縣市/行業/觀光/雲端化/捐贈排行)與實體(縣市名、行業關鍵字、年度、前 N、金額 vs 張數),套用 SQL 範本——不需任何模型、不需後端。
② 查詢引擎:以 sql.js(SQLite/WebAssembly) 在你的瀏覽器內直接查打包好的 db/einvoice.sqlite。LLM 自由問句版本(可接任何 OpenAI 相容端點)由內部環境另外提供,不在公開版。
🔒 安全:純前端唯讀查詢,無對外資料庫、無後端 API;查的是隨頁打包的開放資料快照,正式引用以官方原始資料為準。

6介面操作速查

所有互動元件一覽。

元件位置作用
語言切換 中文/EN右上角切換全頁中英文,選擇會被記住;網址加 #en 直接開英文
頂部導覽列標題下方(吸頂)一鍵跳到:開立成效 / 消費脈動 / 三維熱點 / B2C / AI 功能
三維分頁籤三維消費熱點區切換 行業別 / 城市別 / 觀光景點別 三種分析
最新月 / 近 12 月行業別圖上方切換行業金額的時間範圍
年度 / 業別 下拉觀光景點區選擇要看的年度(2023–2026)與業別(零售/住宿/餐飲)
依金額/依張數觀光景點區切換景點排行依據(金額指數 或 張數指數)
圖表滑鼠移入所有圖表顯示精確數值 tooltip

7更新資料(進階)

資料來自財政部官方 Open API。Demo 版的建置全在容器內,不在本機跑腳本。

# 1) 取得最新開放資料 JSON 放入 data/(抓取由內部資料管線/容器處理) # 官方 API 對非瀏覽器用戶端會擋 TLS 指紋,由內部管線處理 # 2) 重建映像:build 容器內重跑 build_sqlite + smoke,產出新的 SQLite docker compose build --no-cache # 3) 重新起站(任何 Docker 主機 / 雲端皆同一指令) docker compose up -d
⚠️ Demo 版「問數/圖表」資料 = 打包當下的快照;更新就重 build 映像。建置與 serve 全在 Docker,移雲端不改設定。需即時反映活資料庫者,請用 Production(postgres)版。

8AI 功能狀態總覽

儀表板底部 6 張 AI 卡片中,4 項已實作上線(卡片標 ✅ 已上線、可點進入),2 項規劃中。

功能狀態在哪裡
🔮 消費預測(季節性)✅ 已上線📈 AI 分析 → 消費預測(§🔮)
⛰️ 觀光商機(客源×消費)✅ 已上線📈 AI 分析 → 觀光商機(§⛰️)
🚨 異常偵測✅ 已上線📈 AI 分析 → 異常偵測(§🚨)
💬 自然語言問數✅ 已上線💬 問數(§💬,需 Docker 模式)
📑 自動月報生成✅ 已上線📑 月報頁(report.html;可下載 Markdown / HTML)
🎯 捐贈與公益優化🔜 規劃中—
已上線項目皆由開放資料以透明統計方法計算;「問數」預設規則式即可用,可選接任何 OpenAI 相容端點。規劃中項目需後續導入。