GitControl

Resumen del Proyecto

GitControl es un dashboard self-hosted para GitHub que reemplaza la interfaz de github.com para el seguimiento diario de repositorios y organizaciones. Reúne issues, pull requests, estrellas, actions, proyectos, paquetes y dependencias en una sola pantalla, con un atajo Cmd+K para saltar a cualquier repo.

El Desafío

Quien trabaja con muchos repositorios y organizaciones pierde tiempo saltando entre pestañas de github.com, choca con los límites de la API y necesita confiar en dónde queda su token. Los objetivos fueron:

• Centralizar la actividad de todos los repos y organizaciones en una sola vista
• Mantenerse bajo el rate limit de la API de GitHub sin perder datos frescos
• Proteger los tokens de acceso y aislar a cada usuario en instancias compartidas
• Permitir que cada usuario personalice su espacio de trabajo

La Solución

Desarrollamos una aplicación web completa que se instala en un único VPS:

• Dashboard: KPIs del contexto activo, heatmap de contribuciones de 365 días y gráfico de actividad de 28 días con tarjetas reordenables
• Cambio de contexto: Alternancia entre cuenta personal y organizaciones sin recargar, más feeds cruzados de issues y pull requests
• Caché inteligente: Cada llamada a Octokit pasa por Redis con revalidación ETag; un 304 renueva el TTL sin volver a descargar
• Salud del repositorio: Puntaje de salud, estado de sincronización y rastreador de dependencias con creación automática de issues
• Preferencias persistentes: Repos fijados, orden de tarjetas y vistas guardadas en PostgreSQL por usuario

Seguridad y Privacidad

• Tokens cifrados en reposo con AES-256-GCM desde que termina el OAuth
• Claves de caché con prefijo por usuario para aislar instancias multiusuario
• Permisos mínimos de GitHub: el acceso a facturación de Actions se concede solo bajo demanda
• Toda la infraestructura (app, PostgreSQL y Redis) corre en el servidor propio

Stack Tecnológico

• Next.js
• TypeScript
• PostgreSQL
• Redis
• Octokit (API de GitHub)
• GitHub OAuth
• Despliegue self-hosted en VPS