Overview

iFondita — Documentación Técnica

Documentación técnica interna del ecosistema iFondita: punto de venta (POS), portal de anunciantes, panel Fogón (BI interno) y app comensal (Aprovecho), sobre un backend Express + PostgreSQL/Supabase.

Esta documentación se genera desde fuentes reales — el schema desplegado (docs/DATABASE_ERD.md), el código de los routers (docs/api/openapi.yaml) y el registro de decisiones de la bóveda. No es contenido inventado.

¿Qué es iFondita?

Plataforma multi-tenant para fondas y restaurantes mexicanos. Cada fonda (restaurant) opera su POS (mesas, órdenes, cocina/KDS, cobro, caja), su menú y modificadores, fidelidad, y superficies de publicidad (manteles/QR). La plataforma añade un panel de operación interna (Fogón) y una app de comensal (Aprovecho).

Estado del proyecto

El backend acaba de cerrar el Bloque B — la reconciliación completa entre el código del pos-backend y el esquema realmente desplegado en Supabase. Se resolvió en 8 piezas (C, G-shifts, A4, F2, B, E, A0-A2, D), todas desplegadas en producción.

Cambios estructurales del Bloque B:

  • A0-A2 — Núcleo POS reescrito contra el esquema desplegado: orders/order_items/tables/cash_sessions, KDS a nivel ítem, cobro y corte de caja.
  • A1 — El dinero se guarda como jsonb (orders.payment_details) con lines[] de métodos-hoja, no en tablas normalizadas.
  • D — El login del owner migró a Supabase Auth (signInWithPassword), ligado por restaurants.auth_user_id.
  • E — Publicidad reconciliada al modelo QR/paquete (advertisers/campaigns/qr_scans).

Mapa de la documentación

SecciónContenido
ArquitecturaStack técnico, modelo híbrido PG + Supabase, apps y puertos, contratos clave.
Base de datosInventario completo del schema (60 tablas, 70 FKs, CHECKs) + diagrama ER.
APISwagger UI interactivo + convenciones del pos-backend.
Decisiones (Bloque B)Las 13 decisiones oficiales que guiaron la reconciliación.
Deuda técnicaDeuda conocida, features diferidas y pendientes de seguridad.
Para desarrolladoresClonar, build, deploy, rama staging, aliases SSH.

Enlaces rápidos

Arquitectura