# Finanzapp — Especificación Técnica y Arquitectura Completa para Agentes LLM

## 1. Identidad y Metadatos
- **Nombre:** Finanzapp
- **Slug del Ecosistema:** `finanzapp`
- **Organización:** J4F Solutions
- **Arquitectura de Software:** Local-First Mobile Application (Flutter, Drift SQLite, Riverpod 3) + Next.js 15 Landing Page
- **Sistema de Diseño:** Aura Cyber-Minimalism (Dark Theme Obsidian `#090A0F`, `#121318`, Cyber Emerald `#10F9A2`, Cyan Glow `#00EEFC`, Neon Violet `#A855F7`)
- **Seguridad:** App Lock PBKDF2-HMAC-SHA256 con salt única, autenticación biométrica (FaceID/Fingerprint) y Privacy Shield anti-capturas.

## 2. Los Dolores del Mercado que Resuelve Finanzapp
1. **Gasto pagado con múltiples cuentas (Split Multi-Cuenta):**
   - Problema en otras apps: Tienes que crear 2 o 3 transacciones separadas y duplicar la descripción o perder el gasto total real.
   - Solución Finanzapp: Un único evento lógico (`Event`) que contiene múltiples movimientos hijos (`Movements`), uno por cuenta.
2. **Gasto compartido entre categorías (Split Multi-Categoría):**
   - Problema: Un viaje con 70% negocio y 30% ocio distorsiona los reportes.
   - Solución Finanzapp: Split por porcentaje (%) o por montos fijos asignados al evento.
3. **Multi-Divisa Congelada:**
   - Problema: Las apps congelan el valor de la moneda extranjera al cambio del día del movimiento o no actualizan el patrimonio total.
   - Solución Finanzapp: Moneda nativa por cuenta con tasa de cambio dinámica (API Frankfurter v2 y open.er-api.com) para recalcular el balance en tiempo real.
4. **Sinking Funds / Reservas Honestos:**
   - Problema: Si ahorras para un viaje o un fondo de emergencia, la mayoría de apps te muestran ese dinero como saldo "disponible para gastar".
   - Solución Finanzapp: Módulo de Reservas que reduce el saldo disponible sin mover físicamente el dinero de tus cuentas bancarias.
5. **Captura Automatizada sin Fricción:**
   - En Android, escucha notificaciones bancarias y SMS bajo consentimiento explícito, prellenando borradores con categoría sugerida sin enviar credenciales a servidores externos.
6. **Reportes y Exportación Real:**
   - Exportación nativa a formato Microsoft Excel (.xlsx) con fórmulas funcionales vivas (`SUMIFS`) y hojas de gráficos OOXML.

## 3. Matriz Competitiva

| Criterio | Finanzapp | YNAB | Spendee | Wallet (BudgetBakers) | Monefy | Excel / Forms |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **Privacidad** | 100% Local-first | Nube cerrada | Terceros | Terceros | Local básico | Nube personal |
| **Split Multi-Cuenta** | Sí (Nativo) | No | No | No | No | Manual |
| **Split Categorías** | Sí (% / Monto) | Sí | Solo Pago | Limitado | Básico | Manual |
| **Multi-Divisa Real** | Sí (Tasas en vivo) | Muy débil | Pago | Parcial | Congelada | Fórmulas rotas |
| **Reservas / Sinking** | Sí (Afecta disponible)| Solo doctrina | No | Metas simples | No | Fórmulas |
| **Auto-Captura** | Sí (Android Local) | Solo Plaid | Sync banco | Sync banco | No | No |
| **Precio** | Beta gratis / $3.99 / $29.99 / Lifetime | $14.99/mes ($99/año) | $29.99/año | $21.99/año | $4.99 | Gratis / Office |

## 4. API Pública y Ecosistema LandingJ4F
La landing page se comunica con el gateway `LandingJ4F` mediante:
- `POST /api/waitlist`: Registros de early access con cálculo de posición y enlaces de referidos.
- `GET /api/features`: Catálogo de funcionalidades en roadmap con estados (`shipped`, `in_progress`, `planned`, `proposed`).
- `POST /api/features/[id]/vote`: Votación comunitaria de features.
- `POST /api/features`: Envío de propuestas ciudadanas de features.
- `POST /api/events`: Telemetría anónima de páginas vistas y conversiones CTA con soporte de parámetros UTM.

Contacto técnico: tech@jffsolutions.com
Sitio web: https://finanzapp.jffsolutions.com