Roadmap de Criptofolio y Fases Futuras

🗺️ Roadmap de Criptofolio y Fases Futuras

Este documento recoge la evolución técnica y la trayectoria estratégica de Criptofolio a través de cuatro fases de desarrollo, más la línea del Asesor de IA.

---

🏁 Fase 1: Cimientos y Capa de Presentación (Completada)

Los cimientos arquitectónicos y la capa de presentación están plenamente operativos:

• Topología del Monorepo: PNPM Workspaces y caché con Turborepo (apps/frontend, apps/backend, packages/core-domain, packages/shared-types, packages/database).
• Arquitectura Hexagonal: Lógica de dominio 100% agnóstica de Vue, Hono o librerías de base de datos.
• Diseño Institucional Claro: Paleta de alto contraste, tipografía Inter + JetBrains Mono con números tabulares, TailwindCSS v4 y Radix-Vue.
• Gestión de Estado Asíncrono: Empleo de Pinia Colada para consultas declarativas en caché y mutaciones optimistas.
• Asistente de Ingesta: Parser multietapa de CSV/XLSX con mapeo de alias de exchanges y validación de operaciones Spot vs. Futuros.
• i18n sin Dependencias: Sistema de diccionarios por entorno con soporte para inglés y español.

---

⚙️ Fase 2: Motor Backend y RPC (Completada)

Consolidación de los cálculos financieros en un servicio backend centralizado:

• Servidor API Hono.js: Servicio centralizado que expone rutas REST tipadas y datos mock para desarrollo rápido.
• Seguridad de Tipos Extremo a Extremo: Exportación de AppType consumido por Hono RPC (hc<AppType>).
• Streaming de Mercado en Vivo: Canal Server-Sent Events (SSE) con intercambio en caliente de exchanges (Kraken, Binance, CoinGecko).
• Bóveda Cifrada Local: Bóveda AES-256-GCM con depuración de memoria RAM en V8 (buffer.fill(0)).

---

🗄️ Fase 3: Motor Dual-Database Profesional (Foco Actual)

Implementación de la arquitectura dual de alto rendimiento:

• Acondicionamiento del Dominio: Erradicación de atributos de multi-inquilino (user_id) y tipado estricto con PreciseAmount.
• Ledger Transaccional SQLite: Esquema estricto, hashes de idempotencia SHA-256 (id_hash) y triggers nativos de auditoría.
• Motor DuckDB OLAP Vectorizado: Conexión Zero-Copy a SQLite (ATTACH ... TYPE SQLITE), asignación FIFO vectorizada de lotes y métricas de riesgo (Sharpe, volatilidad 30d, caídas ATH, Alpha/Beta).
• Almacenamiento Federado en Parquet: Almacenamiento temporal particionado por Hive (data/historical/prices/year=YYYY/month=MM).
• Servicio de Novedades y Materialización: FifoChainFreshnessService y reconciliación de conjuntos con FifoMaterializerService sobre SQLite.
• Mantenimiento y VACUUM: Programación automática de tareas de mantenimiento sobre SQLite y DuckDB.
• Informes AEAT: Generación automatizada de borradores para el Modelo 721 y el Modelo 714.

---

🤖 Asesor de IA: Implementado vs Planificado

El Asesor de Cartera con IA de solo lectura (cambio OpenSpec add-ai-portfolio-advisor, “Fase 0”) está implementado en el código. Consulta la visión general del Asesor de IA.

Implementado

• Supervisor de solo lectura más taxAnalyst con 25 herramientas (14 expuestas a las ejecuciones locales); investmentAnalyst declarado pero inalcanzable.
• Seis proveedores (openai, anthropic, google, opencode, ollama, ollama-cloud) con claves en la bóveda; cadena de modelos ordenada con reintentos por entrada y fallback.
• Perfiles de ejecución local/medido derivados, límites editables, presupuestos en caracteres, regla de cadena mixta.
• Guardarraíles deterministas de fundamento, inyección y evasión fiscal; flag de descargo estructural.
• Contrato de streaming SSE, ruta sin streaming, rutas de configuración tipadas.
• Tabla de auditoría sin contenido (ai_advisor_runs, migraciones 009 y 010); memoria conversacional desechable.
• Panel de chat, sección de Ajustes, textos en inglés y español.
• Doce herramientas más de lectura y escenarios: detalle de posición, posiciones por cuenta (por nombre), comparación de ejercicios fiscales, huecos de datos, explicación de métricas, valor hipotético de una posición, precio de equilibrio, PnL de derivados, ubicaciones de custodia, shocks de cartera, riesgo de concentración y búsqueda de transacciones spot. Toda la aritmética vive en packages/core-domain a través de Money.
• Exposición escalonada de herramientas: una ejecución local ve las 14 herramientas core, las ejecuciones metered y mixtas ven las 25 (código estático, no un ajuste).
• GET /api/settings/accounts y GET /api/tax/transactions/spot ahora pasan por casos de uso (ListAccountsUseCase, SearchSpotTransactionsUseCase); sus respuestas no cambian.
• performance_history en la moneda base: cada punto se convierte con la tasa de su fecha; los puntos sin tasa son null, se dibujan como huecos en el gráfico y se muestran como “—” en el resumen.

Estado de los cambios: add-ai-portfolio-advisor está archivado (openspec/changes/archive/2026-09-30-add-ai-portfolio-advisor) y sus deltas de spec están fusionados en openspec/specs/, igual que el seguimiento add-ai-advisor-read-and-scenario-tools (archivado el 2026-10-05).

Dejadas fuera a propósito: fees_paid y cash_flow_summary. Volverán cuando el subtipo spottofutures de Kraken se declare transferencia interna, exista la valoración en EUR del activo de comisión como caso de uso y las comisiones con cero explícito sobrevivan a la normalización en todos los perfiles. Ver Catálogo de Herramientas.

Planificado, sin implementar

Fase	Id del cambio	Alcance
1	add-ai-advisor-investment-analyst	Activar investmentAnalyst con price_forecast, allocation_model, market_indicators y simulación fiscal de ventas
2	add-ai-advisor-quality-and-safety	Conjunto de referencia y evaluadores, clasificador de moderación, detección de inyección, redacción de PII para la nube
3	add-ai-advisor-contextual-insights	“Explica este número”, triaje por impacto, checklist previo a la declaración, informes estructurados
4	add-ai-advisor-data-quality-copilot	Primeras escrituras: correcciones aprobadas, elemento a elemento, mediante casos de uso existentes
5	add-ai-advisor-tax-knowledge-rag	Corpus fiscal citado, embeddings locales, memoria a largo plazo

Cada fase tiene una pre-propuesta, que es contexto y no una spec. Otros elementos diseñados pero sin publicar:

• Ajustes del criterio de previsión: ai_advisor_forecast_min_hit_rate y ai_advisor_forecast_min_samples son solo nombres reservados. Nada en el código los lee, almacena ni expone, y no hay UI en Ajustes.
• Desbloqueo recordado de la bóveda: propuesto como vault-remember-unlock-on-device (solo propuesta). Hoy cada reinicio del backend vuelve a bloquear la bóveda y los proveedores con clave se omiten.

Invariantes que toda fase posterior debe mantener: el modelo nunca produce un número; el asesor nunca escribe por su cuenta; no hay trading en exchanges ni ejecución de órdenes; el FIFO fiscal y la custodia nunca se fusionan ni se reordenan por código de la capa de IA; ninguna telemetría sale de la máquina. Las diferencias conocidas entre el diseño y el código se recogen en Divergencias conocidas.

---

🚀 Fase 4: Capacidades Avanzadas (Futuro)

• 🤖 Agentes de IA más amplios: el primer asesor de solo lectura ya expone Casos de Uso existentes como herramientas LLM (ver arriba). Las fases posteriores lo amplían con análisis de inversión, insights contextuales y escrituras aprobadas.
• 📊 Analítica DeFi: Calculadoras automatizadas de pérdida impermanente (Impermanent Loss) para pools de liquidez y seguimiento de rendimientos en staking.
• 🐳 Empaquetado en Escritorio y Docker: Despliegue en un solo paso mediante Docker Compose y versión de escritorio nativa ultraligera mediante Tauri.