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

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 »

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 »

Guía para Aprender Seguridad Informática

Por
  Guía para Aprender Seguridad Informática Este curso fue un punto de inicio en mi camino dentro de la ciberseguridad. No se trató solo de teoría: me abrió la mente para imaginar todas las posibilidades detrás del concepto de "saber hackear", entendiendo que no es un fin en sí mismo, sino una responsabilidad. Aprendizajes clave Qué es la seguridad informática y por qué es esencial en un mundo digitalizado. La diferencia entre un ataque y una defensa. El papel de la ética en el hacking. Este fue uno de esos cursos que encienden una chispa: me hizo cuestionar cómo usamos la tecnología, cómo nos exponemos y cómo podemos protegernos. Me abrió un universo de posibilidades en el que lo importante no es "romper", sino aprender a construir barreras y pensar como un hacker para defender lo que importa .
Publicar un comentario
Sigue leyendo »