Delivery Ledger
A delivery work and vehicle economics platform that turns TeslaMate journeys into reconciled work sessions, weekly income, operating costs, and savings progress. It connects day-to-day shift operations with a clear financial view of delivery work.
- React
- TypeScript
- FastAPI
- REST APIs
- PostgreSQL
- TeslaMate
- Recharts
- TanStack Query
- Motion
Product overview
Delivery Ledger brings operational and financial data together: shifts are recorded as working periods, TeslaMate journeys are reviewed in context, and confirmed delivery activity becomes weekly performance.
The platform keeps the source vehicle system read-only while owning workflow state, classifications, earnings, cost settings, and analytics in a dedicated PostgreSQL application database.
Shift experience
Responsive workspaces cover today's shift, session reconciliation, trip review, earnings, cost settings, and weekly analytics across desktop and mobile.
- React
- TypeScript
- TanStack Query
- Motion
- Responsive UI
- Accessible controls
API & workflow
FastAPI REST endpoints enforce authenticated access, validated state transitions, session-scoped trip review, earnings updates, and cost configuration.
- FastAPI
- Pydantic
- REST APIs
- Authentication
- Validation
- OpenAPI
Data & telemetry
PostgreSQL owns ledger state and schema migrations. TeslaMate is queried through a read-only connection so vehicle telemetry stays isolated from delivery classifications and finance records.
- PostgreSQL
- psycopg
- Schema migrations
- TeslaMate read-only
- Data integrity
- Sydney timezone
Analytics & cost model
Weekly metrics combine gross income, energy, tyre and depreciation estimates, delivery versus empty distance, hourly efficiency, and the AUD 150 savings target.
- Recharts
- Analytical queries
- Vehicle cost model
- Goal tracking
- Data quality checks
- Animated charts
VPS operations
The Vite client is served by the FastAPI application on a private VPS, with systemd service management, health checks, scheduled PostgreSQL backups, and authenticated access.
- Vite
- Linux VPS
- systemd
- Health endpoints
- Database backups
- GitHub
Core experiences
Reconcile each shift
Start and finish a work session, import its TeslaMate journeys, classify delivery and empty travel, and reconcile only after pending trips are resolved.
Understand weekly performance
Compare gross income, net income, savings progress, distance mix, work hours, and hourly efficiency through animated charts and week navigation.
Model vehicle economics
Adjust energy, tyre, rotation, depreciation, and per-kilometre assumptions to understand how vehicle costs affect take-home income.