Documentación de Criptofolio

Pilares Fundamentales e Innovaciones

🏛️ Arquitectura Hexagonal Estricta

Aislamiento absoluto del dominio. Cero dependencias de frameworks en modelos puros. Frontend UI (Vue 3 + Pinia Colada) desacoplado del motor de cálculo backend (Hono + SQLite + DuckDB).

⚖️ Motor Fiscal FIFO Global

Cumplimiento normativo con la AEAT (IRPF en España). Separa la identidad fiscal del lote de la custodia física por cuenta, impidiendo que transferencias internas generen ganancias fantasmas o desordenen la cola FIFO.

🗄️ Arquitectura Dual-Database (OLTP/OLAP)

Ledger transaccional en SQLite con precisión tipográfica estricta y hashes criptográficos de idempotencia, junto a DuckDB OLAP con Window Functions vectorizadas y uniones ASOF de alto rendimiento.

🔐 Privacidad Absoluta y Bóveda Local

100% auto-alojado y funcional offline. Bóveda cifrada AES-256-GCM con depuración de memoria RAM en V8 (buffer.fill(0)), garantizando que las claves jamás abandonen tu equipo.

📊 Métricas de Riesgo Institucional

Analítica financiera en tiempo real: Ratio de Sharpe, volatilidad anualizada a 30 días, caídas ATH (Drawdown), Alpha y Beta frente a Bitcoin, y TTWROR federando archivos Parquet particionados.

🧹 Asistente de Ingesta con Perfiles de Origen

Parser multietapa de CSV/XLSX con perfiles específicos por exchange (Kraken, Bitvavo, Bit2Me, Bitunix, Tangem) que garantizan la clasificación sin pérdidas de movimientos y comisiones.

---

Aspectos Técnicos Destacados

// Precisión Absoluta: Branded Value Object para erradicar errores IEEE-754 de coma flotante
export type PreciseAmount = string & { readonly __brand: 'PreciseAmount' };

// DuckDB OLAP Vectorizado: Conexión de copia cero (Zero-Copy) al ledger SQLite
ATTACH 'criptofolio_ledger.db' AS ledger (TYPE SQLITE);