Ir al contenido principal

Laboratorio Web de Análisis Fiscal con SQL, Dashboards y API

Imagen
Por

 

CFDI SQL LAB

Laboratorio Web de Análisis Fiscal con SQL, Dashboards y API

Introducción

CFDI SQL LAB es un laboratorio web diseñado para explorar, consultar y analizar comprobantes fiscales digitales (CFDI) mediante consultas tipo SQL, dashboards interactivos y una API fiscal documentada.

El proyecto nace de una necesidad real en entornos contables y fiscales:
analizar grandes volúmenes de XML fiscales sin depender de portales cerrados, lentos o poco flexibles.

Más que una app visual, CFDI SQL LAB es una base técnica reutilizable para análisis fiscal avanzado, automatización contable y futuros sistemas de Business Intelligence (BI).


🧠 ¿Qué problema resuelve?

En la práctica fiscal diaria es común enfrentar problemas como:

  • Miles de CFDI dispersos en carpetas

  • Portales gubernamentales lentos o limitados

  • Falta de métricas agregadas inmediatas

  • Imposibilidad de hacer consultas personalizadas

  • Dependencia total de software cerrado

CFDI SQL LAB resuelve esto permitiendo:

  • Centralizar CFDI en una base de datos SQL

  • Ejecutar consultas dinámicas tipo SQL

  • Obtener métricas fiscales en segundos

  • Explorar datos sin intermediarios

  • Integrar resultados a otros sistemas vía API

🎯 Finalidad del proyecto

CFDI SQL LAB fue construido con tres objetivos claros:

1. Técnico

Demostrar una integración full-stack real, desde base de datos hasta frontend productivo.

2. Operativo

Servir como herramienta funcional para análisis fiscal, pruebas de concepto y automatización.

3. Didáctico

Facilitar el aprendizaje práctico de:

  • SQL aplicado a CFDI

  • APIs fiscales

  • Arquitectura moderna web

  • Separación frontend / backend

🏗️ Arquitectura General

La aplicación sigue una arquitectura desacoplada y escalable:

Usuario
 ↓
Frontend (Next.js)
 ↓ API REST
Backend (FastAPI)
 ↓
Base de Datos SQL

Cada capa es independiente y puede escalarse o reemplazarse sin afectar al resto.

🖥️ Frontend

Tecnologías:

  • Next.js (App Router)

  • TypeScript

  • React

  • UI modular

  • Deploy en Vercel

Componentes principales:

  • Dashboard fiscal (métricas agregadas)

  • SQL Playground (ejecución de consultas)

  • Data Browser (exploración de tablas)

  • Consumo directo de API en producción

El frontend está diseñado para funcionar igual en desktop y móvil, sin cambios de código entre entornos.

⚙️ Backend

Tecnologías:

  • Python 3.11

  • FastAPI

  • SQLAlchemy

  • Pydantic

  • Uvicorn

  • Deploy en Render

Características clave:

  • API REST documentada automáticamente

  • Middleware CORS por entorno

  • Endpoints claros y reutilizables

  • Arquitectura lista para crecer



🗄️ Base de Datos

Motor:

  • SQLite (desarrollo)

  • Preparado para PostgreSQL (producción)

Modelos relacionales:

  • Comprobantes CFDI

  • Emisores

  • Receptores

  • Conceptos

  • Pagos

Incluye script de seed para generar datos fiscales simulados y facilitar pruebas.

📡 API disponible

El backend expone endpoints como:

  • /health → estado del servicio

  • /seed → carga de datos de prueba

  • /comprobantes → listado de CFDI

  • /dashboard → métricas agregadas

  • /playground/run → ejecución controlada de SQL

  • /playground/tables → introspección de tablas

La documentación completa está disponible vía Swagger / OpenAPI.

🧪 Entornos

Desarrollo local

  • Backend local

  • Frontend con npm run dev

Producción

  • Backend desplegado en Render

  • Frontend desplegado en Vercel

👉 Mismo código, distintos entornos, cero cambios manuales.

💡 Casos de uso reales

CFDI SQL LAB puede usarse como base para:

  • Análisis fiscal masivo

  • Validadores CFDI

  • BI fiscal

  • Automatización contable

  • Herramientas internas de despacho

  • Sistemas de monitoreo fiscal




🧠 Qué demuestra este proyecto

Este proyecto demuestra:

  • Dominio full-stack real (no tutorial)

  • Capacidad de diseño de arquitectura

  • Integración correcta frontend ↔ backend ↔ DB

  • Manejo de errores de producción

  • Enfoque técnico aplicado a problemas fiscales reales

📌 Estado actual del proyecto

  • ✅ Funcional en PC y móvil

  • ✅ Backend estable en producción

  • ✅ Frontend conectado correctamente

  • ✅ API documentada

  • ✅ Listo para uso y evolución

🔗 Enlaces del proyecto

Labels:

Comentarios

Publicar un comentario

Entradas más populares de este blog

EVORIX - Nmap Learning Lab

Por
 Simulador interactivo para aprender Nmap desde cero Nmap Learning Lab es un simulador web interactivo para aprender los fundamentos de Nmap sin ejecutar escaneos reales. Incluye lecciones guiadas, escenarios de práctica, exámenes, sistema de progreso y logros, todo con interfaz tipo terminal hacker. Desarrollado con React, TypeScript, Vite y desplegado en GitHub Pages. ¿Qué es Nmap Learning Lab? Es una aplicación web tipo “laboratorio virtual” donde el usuario puede aprender los conceptos básicos de Nmap de forma guiada, segura y gamificada. No ejecuta Nmap real: funciona como simulador educativo para entender comandos, sintaxis y escenarios típicos de ciberseguridad. La app está organizada en: Dashboard: resumen de progreso, lecciones completadas, escenarios y exámenes. Aprender: lecciones teóricas sobre Nmap, sintaxis básica, tipos de escaneo, banderas, etc. Practicar: escenarios tipo “casos reales” donde el usuario interpreta salidas simuladas de Nmap. Exámen...
Publicar un comentario
Sigue leyendo »

Introduccion al Desarrollo Web

Por
 Introduccion al Desarrollo Web I Este curso de Google Actívate me abrió la puerta al mundo del desarrollo web moderno, entendiendo la evolución del HTML y cómo combinarlo con CSS y JavaScript para construir sitios dinámicos. Aprendí que cada sitio web es como una obra en constante evolución: el HTML define la base, el CSS da identidad y el JavaScript aporta interactividad. La clave está en usarlos juntos para crear experiencias que realmente funcionan y se sienten fluidas. Gracias a este curso he podido publicar varios sitios web propios y para terceros, cada vez mejorando su calidad, diseño y actualizaciones. Fue el punto de partida para volverme visible en la web y cimentar mi presencia digital con EVORIX.COM.MX
Publicar un comentario
Sigue leyendo »

Cursor con Python – Desarrollo Inteligente con IA

Por
Cursor con Python — Desarrollo Inteligente con IA Este curso fue una de las piezas más importantes en mi transición hacia el desarrollo moderno asistido por inteligencia artificial. Aquí no solo aprendí Python; entendí cómo se construye software hoy… y cómo va a construirse en los próximos años. El enfoque del curso fue totalmente práctico: usar Cursor , un editor de código basado en VS Code pero optimizado con IA para escribir, analizar y mejorar programas en tiempo real. A lo largo de 8 horas divididas en 2 módulos, exploré una forma completamente nueva de programar: más rápida, más guiada, más limpia y sobre todo más estratégica. Entre los conocimientos clave que adquirí están: Fundamentos sólidos de Python , aplicados directamente en proyectos reales sin perder tiempo en teoría abstracta. Trabajo con entornos inteligentes , usando chat integrado, autocompletado semántico y generación de funciones completas basadas en intención. Buenas prácticas de desarrollo , como estructu...
1 comentario
Sigue leyendo »