# Gremio AI

> El sistema operativo del autónomo de oficios en España. Facturación por voz, gestión de obras, VeriFactu (RD 1007/2023) e inteligencia que aprende cómo trabajas.

## Identidad del producto

Gremio AI es una plataforma SaaS + apps nativas (web, PWA móvil, escritorio Electron) diseñada exclusivamente para autónomos de oficios en España: electricistas, fontaneros, instaladores de climatización (HVAC), reformistas, pintores, carpinteros, alarmas, jardineros y mantenimiento industrial.

No es un software de facturación genérico. Es un asistente especializado que conoce la normativa fiscal española (IVA reducido en reformas, regla del 40% de materiales, IRPF estimación directa, VeriFactu) y el flujo de trabajo real de un gremista: obra → materiales → albarán → factura → cobro.

## Audiencia objetivo

- Autónomos persona física (RETA), sector oficios y mantenimiento, España
- PYMES de servicios con 2-15 empleados del mismo sector
- No es para grandes empresas, SaaS B2B genérico ni comercios minoristas

## Capacidades de IA (por surface)

### Web dashboard (PC)
- Crear facturas y presupuestos por voz o texto libre: "Factura 1.200€ a García Reformas, materiales 300, mano de obra 900, IVA 10%"
- Calcular automáticamente el IVA aplicable según la regla del 40% de materiales
- Generar el prefill de los modelos 130, 303, 111 y 347 con los datos reales
- Resumen financiero del mes: pendiente de cobro, emitido, gastos deducibles
- Detección de patrones de morosidad en clientes

### Aplicación móvil (PWA / Capacitor)
- **Quick Capture por voz**: desde el coche, al terminar una obra. "Anota: instalé 20m de cable en el piso de la calle Mayor, materiales 85€"
- **Visit Brief**: resumen inteligente antes de llegar a una obra (historial del cliente, última visita, deuda, notas previas)
- **OCR de facturas de proveedor**: foto con la cámara → extrae proveedor, fecha, importe, IVA → lo registra como gasto
- Sincronización offline: funciona sin cobertura, se sincroniza al recuperar red
- Fotos de obra geolocalizadas y organizadas por proyecto

### Aplicación de escritorio (Electron, Windows/macOS)
- Workspace local completo con todos los archivos del autónomo
- Visualización de PDF de facturas generadas
- Modo sin internet para zonas sin cobertura
- Sincronización bidireccional con la nube

## Módulos del producto

### Facturación
- Factura ordinaria, rectificativa, pro-forma, abono
- Numeración automática (serie configurable)
- Múltiples tipos de IVA por línea (21%, 10%, 4%, 0%)
- Desglose de materiales y mano de obra para aplicar la regla del 40%
- PDF personalizado con logo y datos fiscales
- Envío por email desde la app con IA generando el asunto y cuerpo
- Export CSV compatible con asesorías y programas contables

### VeriFactu (RD 1007/2023)
- Hash SHA-256 calculado y encadenado en base de datos (operación atómica, sin race conditions)
- Timestamp ISO 8601 por factura
- Campo "generado_por_software: Gremio AI v2"
- QR y envío a AEAT: en desarrollo (objetivo julio 2026, antes del plazo legal para autónomos)
- Plazos legales: sociedades mercantiles 1 enero 2026, autónomos personas físicas 1 julio 2026
- Modo actual: "No VeriFactu" válido como software adaptado en periodo transitorio

### Gestión de obras (Works)
- Presupuesto por capítulos y partidas
- Control de materiales con precio unitario y proveedor
- Albaranes de entrega asociados a presupuesto
- Partes de trabajo con horas y operarios
- Fotos de obra (antes/durante/después)
- Estado de obra: presupuestado, en curso, terminado, facturado, cobrado
- Seguimiento de rentabilidad: margen real vs presupuestado

### CRM de clientes
- Ficha completa con historial de obras, facturas y documentos
- Saldo pendiente de cobro en tiempo real
- Categorías: doméstico, comunidad, empresa, promotor
- Notas con reconocimiento de avisos y tareas
- Patrones de pago detectados por IA (pagador puntual / moroso recurrente)

### Calendario fiscal
- Alertas automáticas antes de cada plazo trimestral y anual
- Modelos cubiertos: 130 (IRPF fraccionado), 303 (IVA), 111 (retenciones), 347 (operaciones >3.005€), 190, 390
- Prefill con datos reales de la app (no estimaciones)
- IVA: 21% general, 10% reformas vivienda >2 años (materiales ≤40%), 4% superreducido
- IRPF: 15% general, 7% nuevos autónomos primeros 3 años

### Quick Capture
- Captura por voz de: tareas, notas de obra, gastos, materiales, avisos de cliente
- Detección de intención: la IA clasifica si es una factura, un gasto, una tarea, un aviso o una nota de obra
- Confirmación antes de ejecutar cualquier acción irreversible
- Revert con un tap en los 30 días siguientes a cualquier acción

## Restricciones y límites de la IA

La IA de Gremio AI nunca:
- Envía un email o WhatsApp sin confirmación explícita del usuario
- Crea o modifica una factura sin que el usuario la revise
- Comparte datos del autónomo con terceros
- Ejecuta una acción en nombre del usuario sin mostrar primero lo que va a hacer

La IA siempre:
- Muestra el badge "Generado por IA" en todo contenido que haya generado (EU AI Act, Art. 52)
- Registra cada acción en el log de actividad con timestamp y modelo utilizado
- Pide confirmación antes de acciones que afectan a facturas, cobros o envíos

## Modelos de IA utilizados

- Primario: Groq + Llama 3 (70B), latencia <800ms
- Fallback: Anthropic Claude Haiku, latencia <2s
- STT (voz a texto): Whisper vía Groq
- OCR: Visión de imagen vía Claude Haiku (Anthropic)

## Cumplimiento normativo

- VeriFactu (RD 1007/2023): hash SHA-256 encadenado, modo adaptado
- GDPR / LOPD-GDD: datos alojados en servidores EU (Supabase EU region)
- EU AI Act: badge de transparencia en todos los outputs generados por IA (Art. 52)
- FacturaE 3.2.2: exportación XML compatible con facturación electrónica B2B
- SII (Suministro Inmediato de Información): XML compatible con grandes empresas y AP

## Stack técnico

- Frontend: React 18 + TypeScript 5, Vite, Framer Motion
- Backend: Supabase (PostgreSQL 15, Auth, Storage, Edge Functions, RLS)
- IA: Groq API + Anthropic API + Whisper STT
- Desktop: Electron (modo local con sync)
- Mobile: PWA / Capacitor iOS + Android
- Pagos: Stripe (suscripción mensual/anual)
- Deploy: Netlify (frontend) + Supabase Cloud (EU region)

## Precios

- Gratis: 0€/mes — 5 facturas/mes, 3 clientes, 1 obra activa, 15 acciones IA/día
- Pro mensual: 24€/mes — ilimitado, 200 acciones IA/día, 60 min voz/mes, Quick Capture, Visit Brief, recordatorios cobro
- Pro anual: 19€/mes facturado anualmente (228€/año) — 20% descuento

## Contacto y recursos

- Web: https://www.gremio.tech
- Email: soporte@gremio.tech
- Registro gratuito: https://www.gremio.tech/auth
- Guía VeriFactu: https://www.gremio.tech/verifactu
- Sector: Facturación, Autónomos, Construcción, Electricistas, Fontaneros, Reformas, España, VeriFactu

## Documentación (Markdown para agentes IA)

- [Visión General](https://www.gremio.tech/docs/overview.md)
- [Precios y Planes](https://www.gremio.tech/docs/pricing.md)
- [VeriFactu Guía Técnica](https://www.gremio.tech/docs/verifactu.md)
- [Guía de Inicio Rápido](https://www.gremio.tech/docs/getting-started.md)
- [FAQ](https://www.gremio.tech/docs/faq.md)
- [API Reference](https://www.gremio.tech/docs/api.md)