額度重置後開工前,把這份清單勾完,能讓 M1~M4 一路不卡在「等憑證/等圖資/等環境」。 打勾方式:完成後把
[ ]改成[x]。 對應建置規格:見spec.md。
- 安裝 Docker Desktop,且
docker compose version可正常執行 - 安裝 Go 1.23+(
go version確認) - 安裝 golang-migrate CLI(
migrate -version) - 安裝 sqlc(
sqlc version) - (選)安裝
make,方便用 Makefile 跑常用指令 - 準備一個可對外的 HTTPS 通道給 LINE webhook:ngrok 或 cloudflared 擇一
- 免費 ngrok:
ngrok http 8080→ 拿到https://xxxx.ngrok.io
- 免費 ngrok:
- 到 LINE Developers Console 登入、建立一個 Provider
- 建立 Messaging API channel
- 記下 Channel secret(填入
.env的LINE_CHANNEL_SECRET) - 發行並記下 Channel access token(填入
LINE_CHANNEL_ACCESS_TOKEN) - 關閉「自動回覆訊息」、開啟「Webhook」
- 設定 Webhook URL 為
https://<你的 ngrok 網域>/webhook/line(動工起服務後再填) - 建立一個 LIFF app(司機定位頁用),Endpoint URL 先隨意填、拿到 LIFF ID(填
LIFF_ID) - 用手機把這個官方帳號加為好友,準備當測試客戶
- (選)另一支手機或帳號當測試司機
額度限制提醒:LINE 主動 push 有月額度、reply token 回覆免費——demo 夠用,設計上盡量用 reply。
- 下載台灣圖資:
wget http://download.geofabrik.de/asia/taiwan-latest.osm.pbf - 預處理(三步,會跑一段時間):
docker run -t -v "$PWD:/data" osrm/osrm-backend osrm-extract -p /opt/car.lua /data/taiwan-latest.osm.pbf docker run -t -v "$PWD:/data" osrm/osrm-backend osrm-partition /data/taiwan-latest.osrm docker run -t -v "$PWD:/data" osrm/osrm-backend osrm-customize /data/taiwan-latest.osrm
- 確認產出
taiwan-latest.osrm*一系列檔案(compose 的 osrm 服務會掛這個目錄)
- 不需要 API key、不需要付費——用 deep link URL(
https://www.google.com/maps/dir/?api=1&...)即可。此項已確認無須準備。
- 確認要放的路徑:
/Users/mac/Documents/line-fleet-dispatch/ -
git init(目前只有 docs/,尚未 init) -
go mod init line-fleet-dispatch - 依 spec 第 8 節建立
.env(複製.env.example填入 B 的真實值)
- 前台只做 LINE Bot,暫不做獨立 App/網站?(預設:是)
- ETA 用自架 OSRM(免費、無即時路況)而非 Google 付費 API?(預設:OSRM)
- 儀表板用 Grafana 接 PostGIS,還是自寫 WebSocket 頁?(預設:M4 先做 Grafana,行有餘力再自寫)
- 司機定位先用「模擬器」驗證完整管線,真手機 LIFF 當加分?(預設:是)
只要 A 全部 + B 的 channel secret/access token/LIFF ID 備好,就能開工 M1(LINE 收單建單)。 C(OSRM)可以等做到 M3 再補,不擋 M1/M2。