qubic-flow
Tracker auto-alojado para billeteras Qubic con reporte fiscal avanzado (FIFO/LIFO/HIFO/AVCO), eventos en vivo vía WebSocket y exportación CSV compatible con CoinTracking, Koinly y Blockpit. Soporte multi-nodo y gestión de activos.
Ficha actualizada 26 sept 2026, 11:49 · upstream 26 sept 2026, 11:26 · release v0.2.17
Qué es qubic-flow
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Qubic-flow es una herramienta open source (MIT) para gestionar y auditar billeteras Qubic de forma auto-alojada. Utiliza un stack tecnológico híbrido con Next.js, Vue, Node.js y FastAPI en Python, permitiendo una arquitectura robusta para el procesamiento de datos blockchain. El sistema soporta múltiples nodos (RPC estándar, BOB y LAN privada), sincronizando eventos y transacciones automáticamente cada 60 segundos mediante WebSockets o APIs REST.
- Reporte fiscal anual para particulares en Alemania o Dinamarca con métodos FIFO/LIFO/HIFO/AVCO.
- Auditoría de activos Qubic empresariales gestionando wallets BUSINESS y separación de costes.
- Integración con CoinTracking o Koinly mediante export CSV nativo con BOM UTF-8.
- Seguimiento de dividendos y recompensas de contratos inteligentes como Qearn, QMine o QX.
- Visualización en tiempo real de flujos de entrada/salida vía WebSocket para dashboards externos.
- Soporte nativo para reglas fiscales específicas (ej. exención 1 año Alemania, FIFO Dinamarca).
- Detección automática de dividendos Qearn y separación precisa principal/interés.
- Sincronización multi-nodo con fallback automático a nodos LAN privados si el RPC falla.
- Exportación CSV compatible directamente con CoinTracking, Koinly y Blockpit.
- Modo privacidad para enmascarar datos sensibles (direcciones, balances) en toda la interfaz.
- Requiere Docker Compose (no incluye Dockerfile directo para construcción simple).
- Dependencia de APIs externas (CoinGecko, Qubic Archiver) que pueden saturarse o cambiar.
- Complejidad media: requiere Python 3.12+ y Node.js 22+ instalados en el entorno.
- Sincronización inicial puede tardar debido al historial del Archiver (retención limitada).
- Algunas funciones avanzadas de Qearn requieren confirmación manual para reconstruir pagos.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar docker compose up --build. Requiere Docker Desktop o plugin en Linux. Puertos 8080, 8000 y 5173 deben estar abiertos. Necesita Python 3.12+ y Node.js 22+. Configurar variables de entorno para nodos RPC y claves API si aplica.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.