Operations Platform

Internal dashboard used by 3+ departments to manage 400+ partners.

What It Does

Centralizes partner management, sales reporting, complaint tracking, contract workflows, and automated notifications for a B2B operations team. Integrates with 12 external provider APIs through a unified query interface.

Key Details

• 255K lines of code (Python backend + TypeScript frontend)
• 449 tests
• 12 provider integrations with unified query interface
• AI-powered feedback analysis — categorizing reviews across 30+ categories
• Sales manager portal — PWA, used on phones like a native app
• Runs on a Raspberry Pi 5 — deployed via PM2 + Tailscale

Challenges

God files. The codebase started as a prototype and grew to 18 files over 2000 lines each. A major refactoring split these into 135 focused modules, raising the architecture score from 4.5/10 to 7/10. Lesson: prototype velocity creates structural debt that compounds.

Multi-provider API inconsistency. 12 bus company APIs, each with different authentication, data formats, and rate limits. Solution: a unified query interface that normalizes responses. Each provider has an adapter; the business logic never touches raw API responses.

AI feedback categorization. Passenger reviews needed classification across 30+ categories. A fine-tuned GPT-4.1-nano handled this initially, later migrated to Gemini 3 Flash for cost optimization — same accuracy at lower cost.

Stack

Next.js · FastAPI · PostgreSQL · Tailwind CSS · PM2 · Raspberry Pi · Tailscale