ZFundPilot
ZFundPilot es una herramienta autoalojada para análisis de portafolios de fondos chinos. Gestiona transacciones, calcula rendimientos (XIRR), detecta dividendos y ofrece análisis de riesgo con visualización en React/FastAPI.
Ficha actualizada 24 sept 2026, 17:12 · upstream 24 sept 2026, 17:05 · release v0.23.0
Qué es ZFundPilot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ZFundPilot es una plataforma de autogestión para inversores en el mercado chino que centraliza el análisis de portafolios de fondos. La aplicación permite registrar transacciones (compras, ventas, dividendos) mediante entrada manual o importación CSV, calculando automáticamente costes medios móviles y rendimientos reales ajustados a inflación.
La arquitectura combina un frontend React con componentes Tailwind para una interfaz moderna y un backend en Python/FastAPI que procesa datos financieros. Utiliza bases de datos SQLite locales y se conecta a fuentes como AkShare y la plataforma TianTianJin para obtener netos actualizados, evitando dependencias externas no controladas.
Destaca por su enfoque en privacidad: los datos residen localmente sin sincronización con terceros. Incluye módulos avanzados como detección automática de dividendos, análisis de correlación entre fondos, backtesting de estrategias de inversión programada (DCA) y generación de informes de salud del portafolio con puntuaciones de riesgo.
- Seguimiento detallado de portafolios chinos con cálculo automático de costes medios móviles y rendimientos reales ajustados a inflación.
- Detección automática de eventos de dividendos en fondos activos para confirmar ingresos pasivos sin intervención manual.
- Backtesting de estrategias de inversión programada (DCA) comparando rendimiento frente a inversión inicial única.
- Análisis de riesgo mediante detección de concentraciones excesivas en sectores o tipos de activo específicos.
- Importación masiva de transacciones históricas desde archivos CSV para reconstruir historiales de inversión.
- Generación de informes de salud del portafolio con puntuaciones cuantitativas y recomendaciones de reequilibrio.
- Arquitectura autoalojada con Docker que garantiza privacidad total sin sincronización con servicios externos.
- Integración nativa con fuentes de datos chinas (AkShare, TianTianJin) para obtener netos y métricas locales.
- Cálculo preciso de rendimientos XIRR ajustado a inflación y comparativo contra índices bursátiles chinos.
- Detección automática de dividendos con sistema de confirmación para evitar duplicidad en registros.
- Interfaz reactiva con visualización de datos financieros y soporte para modo oscuro nativo.
- Módulo de backtesting para estrategias de inversión programada con métricas de riesgo (Sharpe, máxima caída).
- Requiere configuración manual de credenciales para APIs externas (OpenAI, etc.) si se activan funciones de IA.
- No incluye funcionalidad de trading automático ni conexión directa con brokers o plataformas de corretaje.
- Dependencia de fuentes de datos chinas que pueden presentar latencia en la actualización de netos.
- Requiere conocimientos técnicos básicos para despliegue y mantenimiento del entorno Docker local.
- Algunas funciones avanzadas (como análisis de IA) dependen de servicios externos no incluidos en el paquete base.
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.
Despliegue recomendado mediante docker compose up -d --build. Configurar variables de entorno ZFUNDPILOT_USERNAME y ZFUNDPILOT_PASSWORD antes del primer inicio. Asegurar acceso a puertos 8000 (API) y 5173 (frontend). Para producción, habilitar HTTPS con Caddy o Nginx y configurar ZFUNDPILOT_TRUSTED_PROXIES si se usa detrás de un proxy inverso.
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.