Corporativo Fiscal

Multi-app fiscal suite for an accounting firm: CFDI invoicing, reception, HR and collaborative tools.

Contexto

CorpFiscal es la plataforma interna de un despacho contable y fiscal. Reúne en un monorepo las distintas áreas operativas del corporativo —portal de clientes, recepción, recursos humanos, administración— junto con su API central.

Arquitectura

Monorepo con Yarn 4 Workspaces dividido en apps/* y shared/*:

Frontends (web, auth, admin, customers, reception, rh, materialization, visionfiscal, landiabar) en React 18 + Vite + React Router 7.
api — backend Express 5 con MongoDB/Mongoose, Socket.io y un amplio conjunto de integraciones.
shared/* — componentes, hooks, catálogos SAT, librerías y tipos compartidos.

visionfiscal destaca como módulo de pizarra colaborativa en tiempo real, construido con Excalidraw, Yjs y Socket.io.

Stack

Backend: Express 5, Mongoose/MongoDB, Socket.io.
Facturación: FACTURAPI (CFDI/SAT). Pagos: Stripe.
Generación de documentos: Puppeteer y pdf-lib; imágenes con Sharp.
Mensajería: WhatsApp. Seguridad: JWT, 2FA (Speakeasy), Helmet y rate limiting.
Almacenamiento: Google Cloud Storage. Tareas programadas: node-cron.

Retos técnicos

Coordinar múltiples frontends y un backend compartido manteniendo tipos y catálogos SAT consistentes.
Colaboración en tiempo real con CRDTs (Yjs) sincronizada por sockets en el módulo de pizarra.
Integración de facturación CFDI, pagos y notificaciones automatizadas por WhatsApp.

Resultado

Una suite fiscal modular donde cada área del despacho tiene su propia app, todas alimentadas por una API central con facturación electrónica y automatizaciones.