Skip to content

AngelAnderson/Facu

Repository files navigation

Facu.app

Tu empleado invisible para cobrar más rápido.

Facu.app es una herramienta proactiva diseñada para trabajadores independientes que quieren profesionalizar su cobro sin drama. No es solo un generador de PDFs, es un asistente que recuerda tus precios y analiza tu negocio.


⚠️ Regla Crítica de Desarrollo

IMPORT MAPS: El archivo index.html utiliza un importmap para cargar dependencias directamente en el navegador.

  • NO ELIMINAR ni modificar las rutas de React sin asegurar sincronía con package.json.
  • El entorno de ejecución requiere React 19.x.
  • No incluir herramientas de desarrollo (como Vite) dentro del importmap, ya que causan errores de "Failed to fetch" en el navegador.

1. Qué es Facu.app

Facu nació para eliminar la fricción entre terminar un trabajo y recibir el pago. Está optimizado para el "hustle" diario: plomeros, mecánicos, reposteras y creativos que cobran por ATH Móvil, Cash o Stripe.

  • IA de Segunda Generación: No solo redacta emails, ahora entiende instrucciones en lenguaje natural y genera insights de negocio.
  • Privacidad Local: Tus datos financieros son tuyos. Se guardan en tu dispositivo por defecto.
  • Categorización por Proyecto: Organiza facturas por cliente y por obra o contrato específico.

2. Arquitectura y Capacidades

Componentes Inteligentes

  • Invisible Memory: El sistema aprende de tu historial local para sugerir precios y descripciones.
  • Natural Language Parser: Usa Google Gemini para transformar texto simple en facturas estructuradas.
  • Business Intelligence: Módulo de análisis que detecta dinero "en la calle" y patrones de facturación.
  • PDF Engine (pdfmake): Generación de documentos profesionales con 3 estilos visuales.

Stack Tecnológico

  • React 19 / Vite: UI ultra-rápida y moderna.
  • Google Gemini API: El cerebro detrás de los insights y el parseo de texto.
  • Supabase: Sincronización opcional en la nube para usuarios Pro.
  • Tailwind CSS: Diseño responsivo y adaptable a modo oscuro.

3. Guía de Uso Rápido

Comandos de Facu

En el editor, puedes usar la barra de Facu para crear documentos al vuelo:

"Facu, factura a María 40 dólares por el bizcocho de boda del proyecto Eventos Mayo"

Métricas que importan

En el Dashboard encontrarás:

  • Dinero en la Calle: Lo que tienes pendiente de cobrar.
  • Insights de Facu: Consejos automáticos basados en tus últimos movimientos.
  • Resumen por Proyecto: Cuánto has generado en cada contrato específico.

4. Guardrails (Reglas para Contribuidores)

  • TypeScript Estricto: Mantener las interfaces de types.ts actualizadas.
  • PDF Typing: Las propiedades de alineación en pdfService.ts deben ser casteadas como as Alignment para evitar errores de build.
  • Traducciones: Todo texto nuevo debe ir en translations.ts. No hardcodear strings.

Documentación actualizada para la versión v0.2.0 - Facu Intelligence Era

About

AI invoice generator for self-employed workers. Talk to it in Spanish, get a professional PDF in seconds.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors