Assessment-GradingMatrix

Plataforma web con matriz de calificaciones para evaluar participantes en actividades de assessment del Grupo NOVA EAFIT.

---

Documentación Técnica (Recomendado para Onboarding)

Para entender la arquitectura, el dominio y cómo contribuir, consulta los siguientes documentos:

• Guía de Onboarding (Paso a Paso): Cómo configurar tu entorno local y hacer tu primer login.
• Vista General de la Arquitectura: El flujo de datos (Next.js + Supabase) y patrones de código.
• Glosario de Dominio: Diccionario de términos técnicos y de negocio (Assessment, Base, Impostor, etc.).
• Especificación de API: Contratos detallados de todos los endpoints de src/pages/api/.
• Roles y Permisos: Matriz de acceso por pantalla y por endpoint.
• Decisiones de Arquitectura (ADRs): Registro de por qué se tomaron decisiones clave (Cookies, Group Scoping, etc.).
• Guía de Contribución: Reglas de Git, commits y Definition of Done.
• Solución de Problemas (Troubleshooting): Soluciones a errores comunes de auth y base de datos.

---

Tecnologías

• Framework: Next.js 15 (App Router + Pages Router mixto)
• Lenguaje: TypeScript / React 19
• Estilos: Tailwind CSS (Integrado con variables CSS para consistencia).
• Validación: Zod (Validación de esquemas en runtime).
• Testing: Vitest + React Testing Library.
• Base de datos: Supabase (PostgreSQL)

---

Configuración Inicial

1. Requisitos: Node.js 20+, npm.
2. Instalación: npm install.
3. Tests: npm test para ejecutar la suite de pruebas.
4. Variables de Env: Copia .env.example a .env.local y completa los valores.
5. Desarrollo: npm run dev abre http://localhost:3000.
6. Datos Mock: (Opcional) npm run db:seed genera un assessment y calificadores temporales para poder probar.

---

Estructura del Proyecto

src/
├── app/                      # Rutas y Layouts (Thin Pages)
├── features/                 # Módulos por funcionalidad (Hooks, Components, Schemas)
├── components/               # UI Atoms/Primitives (Button, Toast, Modal)
├── hooks/                    # Hooks globales compartidos
├── lib/                      # Utilidades core (Supabase, Auth, Helpers)
├── db/                       # Esquema SQL y Políticas RLS
└── pages/api/                # API Endpoints (Backend)

---

Contribución

Por favor, lee la Guía de Contribución antes de abrir un Pull Request.

1. Usa el template de Requirement al crear issues.
2. Sigue Conventional Commits (feat:, fix:, docs:, etc.).
3. Asegúrate de que npm run lint y npm run build pasan sin errores.

---

Licencia

MIT © Grupo Nova EAFIT