How jesshdzz/punta-de-flecha works
Project type and purpose
• This is a full-stack, server-rendered web application (“Punta de flecha”) built with Next.js, using MySQL as its primary datastore and Docker for containerization. It implements a school-management system (students, attendance, grades, reports, etc.) exposing both UI pages and RESTful API endpoints under the same Next.js codebase.
File structure
• next/app: React pages (UI) for routes like /login, /estudiantes, /asistencias, /reportes, each with optional loading.tsx and page.tsx.
• next/app/api: API routes organized by domain (estudiantes, asistencias, calificaciones, auth, reportes, materiales, materias, grupos). Each route.ts is a handler.
• next/dominio/entidades: Domain model definitions (TypeScript classes/interfaces) for core concepts (Estudiante, Profesor, Grupo, MaterialEducativo, etc.).
• next/lib/prisma.ts: Prisma client instantiation.
• next/prisma/schema.prisma & migrations: Database schema and migration history for MySQL.
• docker/docker-compose.yml: Service definitions for app, MySQL, and possibly admin tools.
• next/middleware.ts, next/next.config.ts, tailwind.config.ts, ESLint, PostCSS, tsconfig.json: configuration and build pipeline.