Server documentation
GigRentals platform
A California P2P car-share marketplace backend that demos live with no vendor bills, then turns into production by setting one or two environment variables.
Live process
Investor demo · us-west
database
postgres
cache
memory
broker
memory
payments
simulated
auth
supabase
uploads
memory
- ●
Investor demo runs with zero vendor accountsdemo
Memory adapters + simulated Stripe/IoT/Twilio. npm run dev is enough.
- ●
Durable Postgres (DATABASE_URL)production
Prisma + PostGIS will persist trips, ledger, and presence samples.
- ●
Non-default JWT_SECRETproduction
Custom signing secret is set.
- ○
Stripe Connect for real moneyproduction
Holds post to the in-process ledger only. No card network fees.
- ●
Compliance jurisdiction (US-CA)production
US-CA is the first live state. Other states stay dark until counsel enables them.
- ○
California counsel reviewed program formsproduction
On-site contracts are templates. Set LEGAL_COUNSEL_REVIEWED=true after a CA attorney signs off.
- ○
1099 + local tax collection switchesproduction
TAX_FORM_1099_ENABLED and TAX_COLLECTION_ENABLED must be true before live payouts.
- ●
Point-in-time backupsproduction
Backup provider is the database host (Neon/Supabase PITR) or BACKUP_PROVIDER.
Backups: host-pitr · neon · point-in-time (seconds). Upgrade knobs: DATABASE_URL, REDIS_URL.
What this server is
GigRentals LLC is a marketplace, not a rental-car agency. The backend is a modular monolith: one Next.js deployable, DDD modules, ports for Postgres, Redis, AMQP, and Stripe. Investor walkthroughs hit real routes and real algorithms. They do not hit paid APIs unless you add keys.
- Two places to read every loop: this site, and @docs comments on the source file.
- Same TypeScript path in demo and production — adapters swap, business rules do not.
- Countrywide expansion is a jurisdiction table, not a rewrite. Only US-CA can take live money today.
The only knobs that matter later
| Variable | What it turns on | When to set it |
|---|---|---|
| DATABASE_URL | Postgres + PostGIS + host PITR backups | When demo state must survive a restart |
| REDIS_URL | Shared presence, rate limits, Socket.io adapter | When you run more than one process or realtime workers |
| GO_LIVE=true | Production gates (JWT, Stripe, counsel, 1099, tax) | After a California attorney and a broker have signed off |
Stripe, Twilio, Mapbox, Persona, and IoT webhooks are optional overlays. The loops below already complete without them.
Plain English: /docs/company (what the business is). If production is on fire: /docs/break-glass. Point a Namecheap domain at Vercel: /docs/deploy.
Read next
- Investor demo — press one button, watch every loop.
- Runtime loops — GPS, match, FSM, escrow, unlock, SOS.
- Turnkey checklist — the production gate list the server actually enforces.