🧾 Sistema de Facturación CFDI 4.0

Sistema simplificado de facturación electrónica para negocios familiares con interfaz minimalista y proceso automatizado.

🎯 Características

• Interfaz minimalista: Solo campos esenciales para facilitar el uso
• Catálogo fijo: 3 productos precargados con claves SAT correctas
• Validaciones automáticas: RFC, emails, importes
• Generación CFDI 4.0: XML y PDF conforme a normativa SAT
• Historial básico: Tabla con fecha, cliente, monto, descargas
• Envío automático: Por correo electrónico al cliente

🛠️ Stack Tecnológico

• Frontend: React 18 + Vite
• Validaciones: JavaScript nativo
• Estilos: CSS custom con variables
• Backend: Preparado para Node.js
• Timbrado: Estructura para FiscalAPI o CFDIStamping

📋 Requisitos Previos

• Node.js 16+
• NPM o Yarn
• Certificados de Sello Digital (CSD) del SAT
• RFC activo en el SAT

🚀 Instalación y Configuración

1. Instalar dependencias:

   npm install

2. Configurar datos del emisor: Editar src/data/catalogos.js:

   export const DATOS_EMISOR = {
     rfc: 'TU_RFC_AQUI',
     nombre: 'Nombre de tu Negocio',
     // ... otros datos
   }

3. Configurar productos: Editar PRODUCTOS_CATALOGO en src/data/catalogos.js con tus 3 productos reales.

4. Iniciar en desarrollo:

   npm run dev

📁 Estructura del Proyecto

src/
├── components/
│   ├── Header/              # Encabezado de la aplicación
│   ├── FacturasForm/        # Formulario de nueva factura
│   └── HistorialFacturas/   # Tabla de facturas generadas
├── data/
│   └── catalogos.js         # Productos, formas de pago, etc.
├── utils/
│   └── validaciones.js      # Validaciones RFC, email, etc.
├── App.jsx                  # Componente principal
└── main.jsx                 # Punto de entrada

🔧 Configuración de Producción

Integración con APIs de Timbrado

Opción 1: FiscalAPI

// Instalar SDK
npm install fiscal-api

// En tu componente
import FiscalAPI from 'fiscal-api'

const fiscal = new FiscalAPI({
  key: 'tu-api-key',
  secret: 'tu-secret'
})

Opción 2: CFDIStamping (.NET)

• Clonar: https://github.com/Veld-CC/CFDIStamping
• Crear API REST wrapper
• Integrar con fetch() desde React

Configuración de Correo

1. Configurar SMTP:

   const transporter = nodemailer.createTransporter({
     host: 'smtp.tu-proveedor.com',
     port: 587,
     auth: {
       user: 'tu-correo@dominio.com',
       pass: 'tu-contraseña'
     }
   })

🔐 Seguridad y Certificados

1. Certificados CSD:

   • Obtener del portal SAT
   • Convertir a formato PEM
   • Almacenar de forma segura

2. Variables de entorno:

   CERT_PATH=./certificates/certificado.cer
   KEY_PATH=./certificates/llave.key
   KEY_PASSWORD=tu-contraseña

📝 Flujo de Facturación

1. Usuario completa formulario:

   • RFC, nombre, email del cliente
   • Selecciona producto del catálogo
   • Cantidad y forma de pago

2. Sistema valida datos:

   • RFC formato correcto
   • Email válido
   • Producto existe

3. Genera CFDI:

   • Crea XML con estructura SAT
   • Sella digitalmente
   • Timbra con PAC

4. Entrega archivos:

   • Genera PDF representación
   • Envía por correo
   • Almacena en historial

🧪 Testing

# Ejecutar pruebas
npm run test

# Modo watch
npm run test:watch

📦 Construcción

# Build para producción
npm run build

# Vista previa del build
npm run preview

🚀 Despliegue

GitHub Pages (Recomendado para Demo)

El proyecto está configurado para despliegue automático en GitHub Pages:

1. Configuración automática: Cada push a main despliega automáticamente
2. URL del sitio: https://tiggreee.github.io/FacturAutentico/
3. Workflow: .github/workflows/deploy.yml maneja el proceso completo

Activar GitHub Pages:

1. Ve a Settings → Pages en tu repositorio
2. Source: selecciona "GitHub Actions"
3. El sitio se desplegará automáticamente en el próximo push a main

Opción 2: Local/VPS

1. Build del proyecto
2. Servir con nginx/apache
3. Configurar HTTPS
4. Backup de certificados

Opción 3: Cloud

• Vercel (frontend)
• Railway/DigitalOcean (backend)
• Configurar variables de entorno

📞 Soporte

Este sistema está diseñado específicamente para negocios familiares con:

• 3 productos fijos
• Proceso simple e intuitivo
• Mínima capacitación requerida

📄 Licencia

Proyecto personal para uso familiar.

---

Nota: Este sistema genera facturas CFDI 4.0 válidas, pero siempre verifica con tu contador la configuración fiscal específica de tu negocio.

---

🎓 CONTEXTO DE DESARROLLO - PROYECTO DE GRADUACIÓN

Objetivo: Sistema funcional para el negocio familiar "El Auténtico" + Proyecto de tesis Desarrollador: Victor - Estudiante TripleTen Fecha inicio: Octubre 2025

📊 ESTADO ACTUAL DEL PROYECTO

✅ COMPLETADO (Fase 1)

• Frontend completo: React 18 + Vite funcionando en localhost:3001
• Componentes desarrollados:
  • Header/ - Cabecera con gradiente mexicano profesional
  • FacturasForm/ - Formulario con validación RFC + catálogo SAT integrado
  • HistorialFacturas/ - Tabla con simulación de descarga PDF/XML + email
• Validaciones implementadas: RFC mexicano, emails, cálculos IVA 16%
• Catálogo SAT: 3 productos precargados con claves fiscales correctas
• Git + GitHub: Repositorio organizado con estructura de ramas profesional
• GitHub CLI: Configurado y funcionando como Tiggreee

📂 ARQUITECTURA DE RAMAS

main           ← Código estable para producción
├── develop    ← Rama de desarrollo activo
    ├── feature/frontend-base     ← Componentes UI React
    ├── feature/validaciones-sat  ← Validaciones fiscales avanzadas
    ├── feature/api-integracion   ← APIs externas (FiscalAPI/CFDIStamping)
    └── feature/cfdi-xml         ← Generación XML CFDI 4.0

🎯 ROADMAP DE DESARROLLO

🟡 FASE 2 - Backend & APIs (Próximo)

1. Backend Node.js + Express

   • API REST para generar CFDI
   • Middleware de validación SAT
   • Gestión de certificados CSD

2. Integración Timbrado

   • FiscalAPI SDK (opción 1)
   • CFDIStamping wrapper (opción 2)
   • Manejo de errores PAC

3. Base de datos

   • SQLite local para historial
   • Schema: facturas, clientes, productos

🟡 FASE 3 - Producción (Final)

1. Generación XML real conforme CFDI 4.0
2. PDF con representación impresa
3. Envío automático por email
4. Deploy en servidor familiar
5. Capacitación usuarios finales

📋 COMANDOS DE DESARROLLO

# Directorio del proyecto
cd "C:\Users\victo\Documents\TripleTen\facturacion-cfdi"

# Iniciar desarrollo
npm run dev    # http://localhost:3001

# Gestión Git
git status
git checkout develop              # Cambiar a desarrollo
git checkout feature/api-integracion  # Trabajar en APIs

# GitHub
gh repo view   # Ver repositorio remoto
git push origin develop  # Subir cambios

🎯 OBJETIVOS ACADÉMICOS

1. Demostrar competencias técnicas:

   • React moderno (hooks, contexto, componentes)
   • Integración APIs gubernamentales
   • Git workflow profesional
   • Deployment y DevOps básico

2. Resolver problema real:

   • Automatizar facturación familiar
   • Cumplimiento fiscal SAT
   • UX/UI intuitiva para usuarios no técnicos

3. Documentación técnica:

   • README completo
   • Comentarios en código
   • Casos de prueba
   • Manual de usuario

🔄 PARA CONTINUAR DESARROLLO

Copiar y pegar este contexto en próximas sesiones de trabajo:

PROYECTO: FacturAutentico - Sistema CFDI 4.0
REPO: https://github.com/Tiggreee/FacturAutentico
ESTADO: Frontend completo, backend pendiente
PRÓXIMO: Desarrollar APIs de timbrado en feature/api-integracion
COMANDO: cd "C:\Users\victo\Documents\TripleTen\facturacion-cfdi" && npm run dev

Prioridades inmediatas:

1. Backend Node.js con Express
2. Integración FiscalAPI o CFDIStamping
3. Generación XML CFDI 4.0 válido
4. Testing con certificados CSD reales

---

💡 Este proyecto combina impacto familiar real + rigor académico para graduación exitosa