feat: frontend y docusaurus

.claude/plans/concurrent-splashing-nest.md

@@ -0,0 +1,45 @@
+# Plan: Simplificar layout EvaluacionEntrevistaPage — quitar columna competencia
+
+## Context
+
+La EvaluacionEntrevistaPage ya tiene la grilla alumnos×competencias con selects de profesor, periodo, nivel y retroalimentación. El usuario quiere simplificar el layout:
+- **Quitar** la columna izquierda del row header (periodo badge, nombre competencia, nivel, descripción, descriptores de nivel) — ocupa demasiado espacio
+- **Agregar** solo el nombre de la competencia como título dentro de cada card/celda, para saber cuál se evalúa
+
+## Archivos a modificar
+
+| Archivo | Cambio |
+|---------|--------|
+| `EvaluacionEntrevistaPage.tsx` | Quitar `<td>` row header + `<th>Competencia</th>`, agregar nombre competencia dentro del `.cell` |
+| `EvaluacionEntrevistaPage.module.css` | Quitar estilos de row header (`compLabel`, `compNivel`, `compDescripcion`, `levelDescriptors`, `periodoBadge`, sticky first-child), agregar `.cellCompName` |
+
+## Cambios en TSX
+
+1. **Eliminar** el `<th>Competencia</th>` del `<thead>`
+2. **Eliminar** todo el primer `<td>` del `<tr>` de cada competencia (el que contiene periodoMap badge, compLabel, compNivel, compDescripcion, details/levelDescriptors)
+3. **Agregar** dentro de cada `.cell` (antes del label "Profesor") el nombre de la competencia como título:
+   ```tsx
+   <div className={styles.cellCompName}>{comp.competencia}</div>
+   ```
+
+## Cambios en CSS
+
+1. **Quitar** las reglas de sticky en `.grid th:first-child` y `.grid td:first-child` (ya no hay columna fija)
+2. **Quitar** `.compLabel`, `.compNivel`, `.compDescripcion`, `.levelDescriptors` y sub-reglas, `.periodoBadge` — ya no se usan
+3. **Agregar** `.cellCompName`:
+   ```css
+   .cellCompName {
+     font-size: 0.8125rem;
+     font-weight: 600;
+     color: var(--color-text, #333);
+     margin-bottom: 0.5rem;
+     padding-bottom: 0.5rem;
+     border-bottom: 1px solid var(--color-border, #eee);
+   }
+   ```
+
+## Verificación
+
+1. `cd packages/web && npx tsc --noEmit` — sin errores
+2. Cada card muestra: nombre competencia (título) → profesor → periodo → nivel → retroalimentación → guardar
+3. No hay columna izquierda redundante

.gitignore

@@ -1,50 +1,40 @@
-# These are some examples of commonly ignored file patterns.
-# You should customize this list as applicable to your project.
-# Learn more about .gitignore:
-#     https://www.atlassian.com/git/tutorials/saving-changes/gitignore
-
-# Node artifact files
+# Dependencies
 node_modules/
+
+# Build outputs
 dist/
+packages/web/dist/
+packages/docusaurus/build/
+packages/docusaurus/.docusaurus/
+packages/api/dist/
 
-# Compiled Java class files
-*.class
+# TypeScript
+*.tsbuildinfo
 
-# Compiled Python bytecode
-*.py[cod]
+# Vite
+*.local
 
-# Log files
+# Logs
 *.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
 
-# Package files
-*.jar
-
-# Maven
-target/
-dist/
-
-# JetBrains IDE
+# Editor / IDE
 .idea/
+.vscode/
+*.swp
+*.swo
+*~
 
-# Unit test reports
-TEST*.xml
-
-# Generated by MacOS
+# OS generated
 .DS_Store
-
-# Generated by Windows
 Thumbs.db
 
-# Applications
-*.app
-*.exe
-*.war
-
-# Large media files
-*.mp4
-*.tiff
-*.avi
-*.flv
-*.mov
-*.wmv
+# Environment variables
+.env
+.env.local
+.env.*.local
 
+# Deprecated backup directory
+deprecated/backup/

CLAUDE.md

@@ -4,38 +4,57 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Static course website for **TC2005B - Construcción de Software y Toma de Decisiones** at Tecnológico de Monterrey, Campus Querétaro. Hosted via GitHub Pages.
-
-## Commands
-
-- **Run tests:** `npm test` (uses Vitest with `--globals` flag)
-- **Serve locally:** Open `index.html` in a browser or use any static file server (e.g., `npx serve .`)
+Course website for **TC2005B - Construcción de Software y Toma de Decisiones** at Tecnológico de Monterrey, Campus Querétaro. Hosted via GitHub Pages.
 
 ## Architecture
 
-- **Static HTML site** — no build step, no static site generator. Pages are plain `.html` files.
-- **UI Framework:** Materialize CSS (`css/materialize.min.css`, `js/materialize.min.js`) with Google Material Icons.
-- **Custom styles:** `css/daw.css`
-- **Language:** Spanish (es-mx). All page content, labels, and calendar entries are in Spanish.
+**Monorepo** with npm workspaces containing two packages:
 
-### Key Pages
+- `packages/web/` — React 19 + Vite 6 + TypeScript SPA (main site: calendar, labs, avances, policies)
+- `packages/docusaurus/` — Docusaurus 3.9.2 documentation site (served under `/docs/`)
 
-- `index.html` — Landing page with group selection links
-- `grupo1.html`, `grupo2.html` — Class schedule/calendar per group (table-based calendars)
-- `code_reviews.html` — Team work policies
+Legacy static HTML content (ejercicios, laboratorios, lecturas, documentos) lives in `static-legacy/` and is copied to the build output.
 
-### Content Directories
-
-- `labs/` — Web development labs (HTML, CSS, JS, Node, Express, MVC, sessions, auth, AJAX, REST, deployment)
-- `laboratorios/` — Database labs (SQL, stored procedures, transactions, optimization)
-- `ejercicios/` — Database exercises (ER models, relational algebra, SQL, normalization)
-- `lecturas/` — Reading materials on databases, SQL, usability, application design
-- `avances/` — Project milestone/deliverable descriptions
-- `documentos/` — Course documents, presentations (.pptx), and supplementary files
-- `archived/` — Deprecated content from prior semesters
-
-### Conventions
+## Commands
 
-- All HTML pages use the same Materialize boilerplate: navbar, main container, footer with important links.
-- Calendar pages (`grupo*.html`) use `<table class="calendario">` with weekly rows.
-- Links to labs/exercises use relative paths from the root.
+- **Dev servers:** `npm run dev` — starts Vite (port 5173) and Docusaurus (port 3001) concurrently
+- **Build:** `npm run build` — builds web + docs + merges into `dist/`
+- **Preview:** `npm run preview` — serves the built `dist/` directory
+- **Run tests:** `npm test` (uses Vitest with `--globals` flag)
+- **Type check:** `cd packages/web && npx tsc --noEmit`
+
+## Key Directories
+
+### `packages/web/src/`
+- `components/` — React components organized by feature (layout, home, calendar, labs, avances, policies)
+- `data/` — Migrated data files as typed ES modules (labs, avances, calendario)
+- `types/` — TypeScript interfaces (Lab, Avance, Calendario, Actividad, etc.)
+- `hooks/` — Custom hooks (useCalendarFilter, useWeekNavigation)
+- `styles/` — CSS variables and global styles
+
+### Routing (React Router 7)
+| Route | Component |
+|-------|-----------|
+| `/` | HomePage |
+| `/calendario/:grupoId` | CalendarPage |
+| `/labs/:labId` | LabPage |
+| `/avances/:avanceId` | AvancePage |
+| `/politicas` | CodeReviewsPage |
+
+### Data Sources
+- `data-source/labs/` — Original JS lab data files (34 files, source of truth)
+- `data-source/avances/` — Original JS avance data files (6 files)
+- `data-source/calendario/` — Original JS calendario data file
+- Migrated to TypeScript via `scripts/migrate-data.mjs`
+
+### Legacy Content
+- `static-legacy/` — ejercicios, laboratorios, lecturas, documentos, imagenes (copied to build)
+- `deprecated/` — All legacy HTML pages, viewers, assets, and content duplicates (not used at runtime)
+
+## Conventions
+
+- **Language:** Spanish (es-mx). All content, labels, and calendar entries are in Spanish.
+- **Styling:** CSS Modules with design tokens in `variables.css`. No Tailwind.
+- **Fonts:** Inter (Google Fonts) + Material Icons.
+- **Data pattern:** Each lab/avance is a separate TS file with typed `export default`. Barrel exports use dynamic imports for code splitting.
+- **Links:** Internal links use React Router paths (`/labs/lab1`, `/avances/av1`). External links use full URLs.