Operations Platform

Dashboard interno usado por más de 3 departamentos para gestionar más de 400 partners.

Qué hace

Centraliza la gestión de partners, informes de ventas, seguimiento de quejas, flujos de trabajo de contratos y notificaciones automatizadas para un equipo de operaciones B2B. Se integra con 12 APIs de proveedores externos a través de una interfaz de consulta unificada.

Detalles clave

• 255K líneas de código (backend Python + frontend TypeScript)
• 449 tests
• 12 integraciones de proveedores con interfaz de consulta unificada
• Análisis de feedback con IA — categorizando reseñas en más de 30 categorías
• Portal para gestores de ventas — PWA, usado en teléfonos como una app nativa
• Corre en una Raspberry Pi 5 — desplegado con PM2 + Tailscale

Desafíos

Archivos dios. El código base empezó como un prototipo y creció a 18 archivos de más de 2000 líneas cada uno. Una refactorización mayor los dividió en 135 módulos enfocados, elevando la puntuación de arquitectura de 4.5/10 a 7/10. Lección: la velocidad del prototipo crea deuda estructural que se acumula.

Inconsistencia entre APIs de múltiples proveedores. 12 APIs de empresas de autobuses, cada una con diferente autenticación, formatos de datos y rate limits. Solución: una interfaz de consulta unificada que normaliza las respuestas. Cada proveedor tiene un adaptador; la lógica de negocio nunca toca las respuestas crudas de la API.

Categorización de feedback con IA. Las reseñas de pasajeros necesitaban clasificación en más de 30 categorías. Inicialmente un GPT-4.1-nano fine-tuneado se encargó de esto, luego migrado a Gemini 3 Flash para optimización de costos — misma precisión a menor costo.

Stack

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