{"id":50721821,"url":"https://github.com/aivm23/valorgrid","last_synced_at":"2026-06-10T01:00:28.945Z","repository":{"id":358757010,"uuid":"1242919452","full_name":"aivm23/ValorGrid","owner":"aivm23","description":"App local y privada para controlar, importar y visualizar tu cartera con Windows, Excel, SQLite y Docker.","archived":false,"fork":false,"pushed_at":"2026-06-09T23:32:11.000Z","size":24602,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T00:18:54.636Z","etag":null,"topics":["docker","electron","excel","finance","local-first","portfolio-tracker","privacy","self-hosted","sqlite","windows"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aivm23.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-18T22:09:29.000Z","updated_at":"2026-06-09T23:32:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"fb978f76-acc4-4beb-869c-bcd989639561","html_url":"https://github.com/aivm23/ValorGrid","commit_stats":null,"previous_names":["alvarovalderramamolina/valorgrid","aivm23/valorgrid"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/aivm23/ValorGrid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aivm23%2FValorGrid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aivm23%2FValorGrid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aivm23%2FValorGrid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aivm23%2FValorGrid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aivm23","download_url":"https://codeload.github.com/aivm23/ValorGrid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aivm23%2FValorGrid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34132030,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","electron","excel","finance","local-first","portfolio-tracker","privacy","self-hosted","sqlite","windows"],"created_at":"2026-06-10T01:00:19.879Z","updated_at":"2026-06-10T01:00:28.932Z","avatar_url":"https://github.com/aivm23.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ValorGrid\n\n![Node.js](https://img.shields.io/badge/Node.js-24+-339933?logo=node.js\u0026logoColor=white)\n![SQLite](https://img.shields.io/badge/SQLite-local-003B57?logo=sqlite\u0026logoColor=white)\n![Windows](https://img.shields.io/badge/Windows-installer-0078D4?logo=windows\u0026logoColor=white)\n![Docker](https://img.shields.io/badge/Docker-GHCR-2496ED?logo=docker\u0026logoColor=white)\n![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)\n![Privacidad](https://img.shields.io/badge/privacidad-local%20first-0f766e)\n![No financial advice](https://img.shields.io/badge/no%20financial%20advice-7c3aed)\n[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub%20Sponsors-EA4AAA?logo=githubsponsors\u0026logoColor=white)](#apoyar-el-proyecto)\n\n![ValorGrid - dashboard privado de cartera](assets/brand/valorgrid-publicidad-completa.png)\n\n**ValorGrid es una app local para controlar, importar y visualizar tu cartera privada sin subir tus datos a una plataforma de terceros.**\n\n[Descargar Windows](https://github.com/aivm23/ValorGrid/releases/latest) · [Ver capturas](#capturas) · [Docker](#docker) · [Primeros pasos](docs/FIRST_STEPS.md) · [Documentación](#documentación-util)\n\n\u003e ValorGrid no ofrece asesoramiento financiero, recomendaciones de inversión ni señales de compra o venta. Es una herramienta de registro, visualización y auditoría personal.\n\n## Para Quién Es\n\nValorGrid está pensado para inversores particulares que hoy controlan su cartera con Excel, varias cuentas o herramientas locales, y quieren:\n\n- tener sus movimientos y evolución en su propio PC;\n- importar y exportar datos con una plantilla Excel clara;\n- revisar distribución, histórico, aportaciones, ventas, comisiones y cash-flow;\n- hacer backups locales;\n- evitar subir su ledger completo a servicios de cartera en la nube.\n\n## Qué Incluye Community\n\n- Dashboard de distribución actual de cartera.\n- Revisión YTD de evolución, flujos y resultado anual.\n- Registro manual de compras y ventas.\n- Importación mediante plantilla Excel oficial de ValorGrid.\n- Exportación Excel de movimientos compatible con reimportación.\n- Histórico materializado de evolución de cartera.\n- Aportaciones automáticas configurables.\n- Backups locales y diagnóstico de base de datos.\n- Instalador Windows y despliegue Docker/GHCR.\n\nLos conectores avanzados de broker pertenecen a ValorGrid Pro/Enterprise. Community puede mostrar esas integraciones como futuras o profesionales, pero no publica código, contratos operativos ni muestras privadas.\n\n## Instalar En Windows\n\nRuta recomendada para usuarios no técnicos:\n\n1. Abrir la [última release oficial](https://github.com/aivm23/ValorGrid/releases/latest).\n2. Descargar `ValorGrid-Setup-X.Y.Z-x64.exe`.\n3. Descargar `SHA256SUMS.txt` si quieres verificar el instalador.\n4. Ejecutar el instalador y abrir ValorGrid desde el menú Inicio.\n\nLa versión de escritorio incluye el runtime necesario. No requiere instalar Node.js ni ejecutar comandos. La base SQLite y los backups se guardan en la carpeta privada de datos de la aplicación del usuario, fuera del directorio instalado.\n\nSi Windows SmartScreen muestra un aviso, comprueba que el archivo viene de GitHub Releases de `aivm23/ValorGrid` y revisa el checksum. Más detalle en [docs/FAQ.md](docs/FAQ.md).\n\n## Primeros 10 Minutos\n\nPara empezar sin tocar comandos:\n\n1. Instala ValorGrid para Windows.\n2. Crea tu primer grupo e instrumento.\n3. Registra una compra manual o descarga la plantilla Excel.\n4. Importa movimientos y revisa el preview antes de confirmar.\n5. Crea un backup local.\n\nGuía completa: [docs/FIRST_STEPS.md](docs/FIRST_STEPS.md).\n\n## Capturas\n\n### Dashboard Principal\n\n![Dashboard principal](assets/screenshots/dashboard-demo.png)\n\n### Movimientos\n\n![Movimientos](assets/screenshots/movimientos-demo.png)\n\n### Histórico\n\n![Histórico](assets/screenshots/histórico-demo.png)\n\n### Instrumentos Y Grupos\n\n![Valores y grupos](assets/screenshots/valores-grupos-demo.png)\n\n### Distribución\n\n![Distribución](assets/screenshots/distribucion-demo.png)\n\n## Importar Y Exportar Excel\n\nValorGrid Community solo acepta la plantilla Excel oficial de ValorGrid. Descárgala desde la app o desde:\n\n```text\nGET /api/import/template.xlsx\n```\n\nLa app también exporta movimientos en el mismo formato Excel:\n\n```text\nGET /api/export/transactions.xlsx\n```\n\nLa fuente pública `valorgrid-xlsx` se procesa internamente con ExcelJS y controles estrictos: hoja `Movimientos`, encabezados exactos, sin fórmulas, tamaño máximo y límite de 500 movimientos en Community.\n\nGuía de importación: [docs/IMPORT_EXCEL.md](docs/IMPORT_EXCEL.md).\n\nUn ejemplo sintético con tickers reales del S\u0026P 500 está disponible en `samples/valorgrid-template/`. Los datos de movimientos son ficticios y no representan una cartera real.\n\n## Docker\n\nValorGrid puede ejecutarse como servicio local con Docker:\n\n```bash\ndocker compose up -d --build\n```\n\nLa base SQLite queda en `./data` y los backups en `./backups`, ambas rutas privadas e ignoradas por Git.\n\nPara exponer Docker o CasaOS fuera de tu LAN privada, configura `VALORGRID_AUTH_PASSWORD` con una contraseña larga y usa HTTPS delante del contenedor. `VALORGRID_AUTH_USER` es opcional y por defecto vale `valorgrid`.\n\nTambién se publican imágenes GHCR versionadas desde tags `vX.Y.Z`:\n\n```text\nghcr.io/aivm23/valorgrid:vX.Y.Z\nghcr.io/aivm23/valorgrid:latest\n```\n\nGuía completa: [docs/DEPLOY_DOCKER.md](docs/DEPLOY_DOCKER.md).\n\n## Privacidad\n\nValorGrid se ejecuta en local. Por defecto escucha en `127.0.0.1`, no requiere login y no sincroniza datos con servidores externos. En Docker/CasaOS puedes activar Basic Auth monousuario con `VALORGRID_AUTH_PASSWORD`.\n\nNo deben subirse a GitHub:\n\n```text\ndata/portfolio.sqlite\n.backups/\nbackups/\n.env\nimports/\ndownloads/\nhojas Excel personales\nexportaciones reales de broker\n```\n\nYahoo Finance se usa solo como proveedor externo de precios. La app no envía tu ledger completo a Yahoo; consulta símbolos de mercado concretos y cachea resultados localmente.\n\nMás detalle en [docs/PRIVACY_SECURITY.md](docs/PRIVACY_SECURITY.md) y [docs/LEGAL_NOTICE.md](docs/LEGAL_NOTICE.md).\n\n## Desarrollo Local\n\nEstos requisitos aplican solo al desarrollo desde el repositorio:\n\n- Node.js 24 o superior, por el uso de `node:sqlite`.\n- macOS o Linux: solo necesitas `node` y `npm`. Los scripts `db:*` y `verify:publication` usan entrypoints Node multiplataforma.\n- Windows: opcionalmente puedes seguir usando los wrappers `.ps1` (requieren PowerShell), aunque ya no son necesarios para `npm run db:*` ni para `npm run verify:publication`.\n\n### Linux y macOS\n\n```bash\nnpm install\nnpm start\n```\n\nDespués abre:\n\n```text\nhttp://localhost:1325\n```\n\nChecks completos:\n\n```bash\nnpm run typecheck\nnpm run lint\nnpm run format:check\nnpm test\nnpm run verify:publication\n```\n\n### Windows\n\nLos mismos comandos funcionan igual. Los wrappers `.ps1` (`scripts\\db-*.ps1`, `scripts\\verify-publication.ps1`) siguen disponibles como atajos nativos si los prefieres invocar directamente con PowerShell.\n\nReconstruir el instalador Windows en local (solo Windows):\n\n```powershell\npowershell -ExecutionPolicy Bypass -File .\\scripts\\build-desktop-win.ps1\n```\n\n## Backups\n\nCrear backup local:\n\n```bash\nnpm run db:backup\n```\n\nDiagnóstico rápido de DB:\n\n```bash\nnpm run db:doctor\n```\n\nReset fresh destructivo, con confirmación:\n\n```bash\nnpm run db:reset\n```\n\nLa app conserva automáticamente los 6 backups más recientes. Flujo completo en [docs/DB_OPERATIONS.md](docs/DB_OPERATIONS.md).\n\n## Documentación Útil\n\n- [docs/FIRST_STEPS.md](docs/FIRST_STEPS.md): primeros 10 minutos para usuarios no técnicos.\n- [docs/IMPORT_EXCEL.md](docs/IMPORT_EXCEL.md): plantilla Excel, columnas, FX y errores comunes.\n- [docs/FAQ.md](docs/FAQ.md): preguntas frecuentes sobre Windows, privacidad, Docker y Pro.\n- [docs/LEGAL_NOTICE.md](docs/LEGAL_NOTICE.md): aviso legal ampliado.\n- [docs/ROADMAP.md](docs/ROADMAP.md): hoja de ruta Community y Pro/Enterprise.\n- [docs/API.md](docs/API.md): endpoints de la API local.\n- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md): backend, frontend, histórico e importaciones.\n- [docs/EDITIONS.md](docs/EDITIONS.md): separación Community / Pro-Enterprise.\n- [docs/DEPLOY_DOCKER.md](docs/DEPLOY_DOCKER.md): despliegue local con Docker y CasaOS.\n- [docs/GITHUB_RELEASE.md](docs/GITHUB_RELEASE.md): checklist de publicación.\n- [SECURITY.md](SECURITY.md): notas estándar de privacidad y seguridad local.\n\n## Apoyar El Proyecto\n\nSi ValorGrid te resulta útil, puedes apoyar su desarrollo mediante GitHub Sponsors, feedback, issues o pull requests.\n\nEl objetivo del proyecto es mantener una herramienta local, privada y sencilla para seguimiento de cartera, sin convertirla en una plataforma de asesoramiento financiero.\n\n## Licencia\n\nEste proyecto se publica bajo licencia MIT. Consulta [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faivm23%2Fvalorgrid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faivm23%2Fvalorgrid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faivm23%2Fvalorgrid/lists"}