Upwork Dashboard

Dashboard financiero local que transforma un reporte CSV de Upwork en métricas, tendencias y señales visuales para freelancers.

La aplicación se ejecuta íntegramente en el navegador: el CSV se procesa en el dispositivo del usuario y no se envía a un servidor de este proyecto. El repositorio contiene la herramienta, no datos de trabajo ni reportes personales.

Funcionalidades

• Métricas de ingreso bruto, comisiones, ajustes, ingreso neto y retiros.
• Evolución mensual y comparación de períodos.
• Seguimiento de una meta mensual.
• Análisis de clientes y concentración de ingresos.
• Indicador orientativo de salud financiera.
• Búsqueda y filtros para transacciones.
• Tema claro u oscuro y preferencias locales.

Privacidad

• El archivo CSV se lee localmente en el navegador.
• Los datos cargados desaparecen al recargar la página.
• Solo el tema y la meta mensual se guardan en localStorage.
• Nunca subas CSV, nombres de clientes, datos bancarios, capturas ni credenciales al repositorio, issues o pull requests.

Cómo usarlo

1. Abre index.html en un navegador moderno.
2. Descarga el reporte de Upwork desde Reports → Transaction history en formato CSV.
3. Arrastra el archivo al dashboard o selecciónalo desde el equipo.
4. Revisa las métricas y define una meta mensual si lo deseas.

Si el navegador restringe el uso desde file://, ábrelo con un servidor estático local:

py -m http.server 8080

Luego visita http://localhost:8080.

Formato compatible

El dashboard espera el reporte oficial de transacciones de Upwork y requiere, como mínimo, Date, Transaction type y Amount $. También aprovecha, cuando están disponibles, Transaction summary, Freelancer, Client team y Current balance $.

Estructura

.
├── index.html                    # Interfaz accesible
├── styles.css                    # Sistema visual y temas
├── app.js                        # Importación, cálculos y gráficos
├── .nojekyll                     # Compatibilidad con GitHub Pages
└── .github/workflows/static.yml  # Despliegue estático

Publicación

El proyecto puede alojarse en GitHub Pages. El workflow incluido publica el contenido de main; activa Settings → Pages → GitHub Actions. La página publicada sigue procesando cada CSV localmente en el navegador del visitante.

Aviso

Las métricas y el indicador de salud financiera son orientativos. No sustituyen la contabilidad, una declaración fiscal ni el asesoramiento de un profesional.

Contribuciones

Lee CONTRIBUTING.md antes de abrir un issue o pull request.