尚未检测到更新。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