尚未偵測到更新。GitHub 發布版本後會顯示在這裡。
個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
在專案資料夾中執行 /nomorevibe verify,即可驗證所有權並自行管理介紹。
一分鐘完成驗證Live Riva↔Circle shuttle tracker for Edge City India 2026
翻譯準備中
取自儲存庫 README
正在載入完整 README。
檢視完整 README ↗Live shuttle tracking for Edge City India 2026 (Mandrem, Goa, 11 Oct – 1 Nov). Attendees pick their stop and see where the shuttle is and when it reaches them. Drivers' phones report GPS, the server decides when phones track, and ops run everything from an admin site, a Telegram bot, or an AI agent over MCP.
/start for updates on your stop| Part | Where | What it does |
|---|---|---|
| Web | apps/web | Next.js 15 site: public page + 3D map, phone-first admin, Telegram webhook, MCP server (/api/mcp, OAuth) |
| Worker | apps/worker | Same image with ROLE=worker: watchdog, service windows, arrival alerts, notice and push queue, nightly learning |
| Driver app | apps/driver | Expo (Android) app: pairing, GPS, server-controlled modes, over-the-air updates. iPhones use Telegram live location or Traccar |
| Shared | packages/shared | Contracts, schedule maths, IST time helpers |
Postgres with Drizzle holds everything. Every change goes through one service layer and writes one audit-log row.
The public side never shows lateness: it says where the shuttle is, calmly. Design notes live in docs/:
SPEC (the design), OVERVIEW (what exists), CONTRACTS (code layout
and ownership), RESUME (operating notes).
Each vehicle has one phone sharing its location. Android: install the driver app (apps/driver) and pair it with a
code or QR. iPhone: no app needed, share Telegram live location with the bot (/pair <code> first); the Traccar
Client app also works as a backup.
You need Node 22+, pnpm, and Docker (for Postgres).
pnpm install
docker compose -f docker-compose.dev.yml up -d # Postgres on 127.0.0.1:5548
cp apps/web/.env.example apps/web/.env.local # fill in SESSION_SECRET and TOKEN_SECRETS (random strings)
pnpm dev # web + worker
Telegram is optional: leave TELEGRAM_BOT_TOKEN empty and the bot stays off. To try it with fake shuttles driving the
route, see pnpm sim. Tests:
pnpm test-db # throwaway Postgres for tests (port 5547)
pnpm test # unit + database tests
pnpm typecheck && pnpm lint
Stops, routes, services, vehicles and staffing are data, not code: set them up in the admin site (or over MCP), then
pair a phone per vehicle. You'll need your own Telegram bot (via @BotFather), a Postgres, and, for the Android driver
app, your own Expo and Firebase projects (replace apps/driver/google-services.json, eas.json and the package id in
app.config.ts). Stop names, copy and art are Edge City India's; swap them freely.
See CONTRIBUTING.md. Security issues: SECURITY.md.
MIT © Naman Hajela