Facturalandia

Electronic invoicing platform (CFDI 4.0) for Mexico, built as a monorepo with an API and client apps.

Contexto

Facturalandia es una plataforma de facturación electrónica para México conforme a CFDI 4.0. Está estructurada como un monorepo TypeScript con una API y varias apps de cliente independientes.

Arquitectura

facturalandia/
├─ apps/
│  ├─ api/             # Express API
│  ├─ auth/            # React (login + 2FA)
│  ├─ invoicing/       # React (app principal)
│  └─ materialization/
└─ shared/             # cliente API, design system, catálogos SAT, tipos Zod, utils

El monorepo usa Yarn 4 (Corepack) y los servicios se levantan de forma concurrente en desarrollo.

Stack

Runtime: Node.js.
Backend: Express + Mongoose (MongoDB).
Frontend: React 19 + Vite + TanStack Query + React Hook Form.
Facturación: FACTURAPI (CFDI 4.0).
Auth: Firebase Auth con sesiones por cookie. Tiempo real: Firestore (notificaciones de cancelación).
Caché: Redis. Almacenamiento: Google Cloud Storage (PDFs y evidencias).

Retos técnicos

Generación y timbrado de CFDI 4.0 con FACTURAPI, incluyendo catálogos SAT compartidos entre apps.
Notificaciones de cancelación en tiempo real vía Firestore.
Configuración estricta de variables de entorno: la API falla al arrancar si falta alguna.

Resultado

Una plataforma de facturación cohesionada donde la misma capa compartida (cliente HTTP, design system, catálogos SAT y tipos Zod) alimenta autenticación, facturación y materialización.