📚 Documentación de PuntoHack

Esta carpeta contiene toda la documentación del proyecto organizada por categorías.

📁 Estructura de Carpetas

🏗️ architecture/

Documentación sobre la arquitectura del sistema, diagramas y diseño del frontend.

• ARCHITECTURE.md - Arquitectura general del sistema
• DIAGRAMS.md - Diagramas del proyecto
• LOGICA-DE-NEGOCIO.md - Reglas y flujos de negocio del MVP
• FRONTEND-MINIMALISTA.md - Diseño y estructura del frontend

🔌 integrations/

Documentación de integraciones con servicios externos.

integrations/clerk/

• CLERK-CONFIGURACION.md - Configuración de Clerk
• CLERK-DESACTIVAR-2FA.md - Cómo desactivar 2FA
• CLERK-TROUBLESHOOTING.md - Solución de problemas con Clerk
• CLERK-DIAGNOSTICO-COMPLETO.md - Diagnóstico completo
• CLERK-HEADERS-WARNING.md - Advertencias sobre headers
• CLERK-USUARIOS-PRUEBA-INVESTIGACION.md - Investigación de usuarios de prueba

integrations/supabase/

• SUPABASE-REALTIME-ACTIVACION.md - Activación de Realtime
• SUPABASE-REALTIME-CONFIGURACION.md - Configuración de Realtime
• SUPABASE-REALTIME-GUIA.md - Guía completa de Realtime
• SUPABASE-REALTIME-HABILITAR-TABLAS.md - Habilitar tablas para Realtime
• SUPABASE-REALTIME-IMPLEMENTACION-COMPLETA.md - Implementación completa
• SUPABASE-REALTIME-RESUMEN.md - Resumen de Realtime

🔀 git/

Documentación sobre Git, flujo de trabajo y configuración.

• GIT-FLOW.md - Flujo de trabajo con Git
• CAMBIAR-RAMA-DEFAULT-GITHUB.md - Cómo cambiar la rama por defecto
• PUSH-INSTRUCCIONES.md - Instrucciones para push

📋 planning/

Planes de implementación, roadmap, MVP y historias técnicas.

• PLAN-IMPLEMENTACION.md - Plan general de implementación
• MVP-ESTRICTO.md - Definición del MVP
• ROADMAP.md - Roadmap del proyecto
• HISTORIAS-TECNICAS.md - Historias técnicas
• PLAN-DOCUMENTACION-DOCUSAURUS.md - Plan de documentación
• PLAN-EJECUCION-MODULO-2.md - Plan módulo 2
• PLAN-EJECUCION-MODULO-3.md - Plan módulo 3
• PLAN-EJECUCION-MODULO-4-SPONSORS.md - Plan módulo 4
• MODELO-NEGOCIO-SPONSORS.md - Modelo de negocio de sponsors

💻 development/

Notas de desarrollo, usuarios de prueba y lógica de negocio.

• NOTAS-MIDDLEWARE.md - Notas sobre middleware
• USUARIOS-PRUEBA.md - Usuarios de prueba
• SISTEMA-INVITACIONES-EMAIL.md - Sistema de invitaciones por email
• LOGICA-EDICION-FECHAS.md - Lógica de edición de fechas
• CRON-LOCAL.md - Configuración de cron local

🧪 testing/

Documentación sobre testing y guías de pruebas.

• TESTING-NOTIFICACIONES.md - Testing de notificaciones
• TESTS-MODULO-2.md - Tests del módulo 2
• GUIA-TESTING-MODULO-4-SPONSORS.md - Guía de testing módulo 4

🐛 troubleshooting/

Guías para solucionar problemas comunes.

• TROUBLESHOOTING-IMMUTABLE.md - Problemas con objetos inmutables
• TURBOPACK-ERROR-SOLUCION.md - Solución de errores de Turbopack

👥 user-flows/

Flujos de usuario y navegación por roles.

• FLUJOS-USUARIOS.md - Flujos de usuario completos
• ARQUITECTURA-NAVEGACION-ROLES.md - Arquitectura de navegación por roles

📊 analysis/

Análisis técnicos y revisiones del código.

• ANALISIS-MODULO-1.md - Análisis del módulo 1
• ANALISIS-COMPLETO-MODULO-3.md - Análisis completo módulo 3
• ANALISIS-LIDER-EQUIPO.md - Análisis del líder de equipo
• ANALISIS-MEJORAS-IMPLEMENTACION.md - Análisis de mejoras
• REVISION-MODULO-3-CORE.md - Revisión del core del módulo 3
• REVISION-FLUJOS-POR-ROL.md - Revisión de flujos por rol

📈 status/

Estado actual del proyecto, módulos y mejoras implementadas.

• ESTADO-ACTUAL-PROYECTO.md - Estado actual del proyecto
• ESTADO-ACTUAL-ENERO-2025.md - Estado actual enero 2025
• ESTADO-MODULO-2.md - Estado módulo 2
• ESTADO-MODULO-3.md - Estado módulo 3
• ESTADO-MODULO-3-ACTUALIZADO.md - Estado módulo 3 actualizado
• ESTADO-MODULO-EVALUACION.md - Estado módulo evaluación
• ESTADO-EQUIPOS-UI.md - Estado de equipos UI
• MEJORAS-IMPLEMENTADAS-ENERO-2025.md - Mejoras implementadas
• MEJORAS-MODULO-2.md - Mejoras módulo 2
• RESUMEN-MODULO-4-SPONSORS.md - Resumen módulo 4
• RESUMEN-SESION-ENERO-2025.md - Resumen de sesión

✅ evaluation/

Evaluaciones completas de módulos y del proyecto.

• EVALUACION-COMPLETA-PROYECTO.md - Evaluación completa del proyecto
• EVALUACION-COMPLETA-MODULO-3.md - Evaluación completa módulo 3
• EVALUACION-MODULO-2.md - Evaluación módulo 2

📖 guides/

Guías de pruebas y testing por módulo.

• GUIA-PRUEBAS-MODULO-2.md - Guía de pruebas módulo 2
• GUIA-PRUEBAS-MODULO-3.md - Guía de pruebas módulo 3
• GUIA-PRUEBA-SPONSORSHIP.md - Guía de prueba de sponsorship

📦 modules/

Documentación específica de módulos (reservado para futura organización).

---

🎯 Cómo Encontrar Documentación

• ¿Necesitas configurar algo? → integrations/
• ¿Tienes un problema? → troubleshooting/
• ¿Quieres entender la arquitectura? → architecture/
• ¿Necesitas hacer testing? → testing/ y guides/
• ¿Quieres ver el estado del proyecto? → status/
• ¿Necesitas entender flujos? → user-flows/
• ¿Quieres ver planes? → planning/

---

🧩 Docusaurus

La documentación en puntohack-docs se sincroniza directamente desde esta carpeta (/docs).
El sidebar se genera automáticamente y se excluyen duplicados con sufijo 2.md.

---

Última actualización: Enero 2025