ParkOutside
ParkOutside is a minimum viable product for an enterprise-grade parking marketplace. The philosophy is simple: parking should not be a last-minute scramble. Enterprises (garages, malls, offices, valet operators) own and monetize their inventory, while drivers discover spots based on where they are actually going—not just generic map pins. This MVP establishes the foundation: secure dual-role authentication (driver and enterprise), a production-oriented PostgreSQL data model, and a responsive web experience. The schema is designed upfront for organizations, location management, weather-aware search scoring, hold-based bookings, fines, and payments—so the platform can scale from MVP to full enterprise operations without a rewrite. The long-term vision is a two-sided ecosystem: an enterprise web portal for operators to manage locations, pricing, and availability, plus a dedicated mobile app for drivers to search, reserve, navigate, and pay on the go. The current web app is the enterprise-facing entry point and driver dashboard shell; the driver mobile experience is planned as the primary consumer channel.
FEATURES
Dual-role authentication (MVP)
Registration and login for driver and enterprise accounts, with JWT-based sessions and role-aware user records.
Email verification & account safety
One-time verification links via Resend, resend limits, and automatic suspension for abuse—keeping enterprise onboarding trustworthy.
Password recovery flow
Secure forgot-password and reset-password endpoints with expiring tokens and one-time use enforcement.
Enterprise-ready data model
PostgreSQL schema for organizations, parking locations, availability windows, destinations, bookings, fines, payments, and weather-aware search scoring—migrated with Alembic.
Responsive landing & dashboard shell
Marketing site with value proposition for drivers and enterprises, plus an authenticated dashboard with destination search UI.
Local development infrastructure
Docker Compose for PostgreSQL 16, FastAPI with CORS and health checks, and structured logging for backend observability.
Enterprise location management (planned)
CRUD for parking locations under organizations—address, geo coordinates, slot counts, covered/shade attributes, hold pricing, and custom features.
Availability & dynamic pricing (planned)
Day-of-week availability windows with hourly or flat rates, occupancy snapshots, and real-time open/limited/full status labels.
Destination-first smart search (planned)
Search by destination, area, or parking name with ranked results using distance, walk time, price, convenience, and weather sensitivity scores.
Bookings, holds & payments (planned)
Reserve spots with protected hold windows, booking codes, overtime tracking, fines for no-shows/overstay, and multi-method payment records.
Driver preferences & vehicles (planned)
Saved vehicle profiles and parking preferences (closest, cheapest, covered, security, max walk distance) to personalize recommendations.
Enterprise admin portal (planned)
Organization member roles (owner/manager), fleet-wide location oversight, booking analytics, and revenue management for parking operators.
Driver mobile app (planned)
Native mobile experience for drivers—find parking near a destination, reserve in advance, manage bookings, and pay from the road.