Estudio — sistema personal de preparación de exámenes

PWA (móvil y escritorio) para organizar el material de la universidad, practicar con tests y exámenes oficiales, y seguir un plan de estudio adaptativo con repaso espaciado.

• Diseño completo: docs/DISENO.md (arquitectura, esquema de BD, riesgos y fases).
• Stack: Next.js 16 (App Router) + TypeScript · Tailwind CSS 4 · Supabase (Postgres, Auth, Storage) · Vercel.

Estado

Fase	Contenido	Estado
1	Arquitectura, proyecto, base de datos, autenticación	✅ Hecha
2	Asignaturas, parciales y temas	✅ Hecha
3	Biblioteca y subida de documentos	✅ Hecha
4	Banco de preguntas	✅ Hecha
5	Tests y repaso espaciado	✅ Hecha
6	Simulador de exámenes	✅ Hecha
7	Planificador, pantalla HOY y sesiones	✅ Hecha
8	Dashboard y estadísticas	✅
9	IA y procesamiento de documentos	✅
10	PWA y optimización móvil	✅
11	Backups, importación/exportación	✅

Fase 1: qué incluye

• Proyecto Next.js con TypeScript estricto, Tailwind y ESLint.
• Migraciones (supabase/migrations/) con el esquema completo: jerarquía académica, biblioteca, exámenes oficiales, banco de preguntas, progreso y repaso espaciado, intentos, planificación, sesiones, caché de IA y asistente. RLS en todas las tablas y bucket privado documents.
• Autenticación con Supabase Auth (email + contraseña), sesión por cookies, protección de rutas en src/proxy.ts y confirmación de email en /auth/confirm.
• Navegación mobile-first: barra inferior en móvil, lateral en escritorio; pantalla Hoy como inicio; secciones de fases futuras marcadas.
• Capa de IA independiente del proveedor (src/ai/): interfaz AIProvider, registro de proveedores, modo desactivado por defecto, respuestas JSON validadas con zod y claves de caché deterministas.
• Manifest PWA e iconos (instalable; el modo offline llega en la Fase 10).
• Tests (Vitest): migraciones y políticas RLS sobre Postgres real (PGlite), reglas de procedencia de preguntas, utilidades de fechas y capa de IA.

Fase 2: qué incluye

• Cursos y asignaturas (/asignaturas): siglas, color, dificultad percibida e importancia; la lista muestra el próximo examen de cada asignatura con cuenta atrás.
• Temas y prácticas (/asignaturas/[id]): subtemas ilimitados, horas estimadas, reordenar con flechas, editar y borrar.
• Evaluaciones (parciales, final, examen de prácticas...): fecha y hora en tu zona horaria, duración, importancia, dificultad, peso en la nota y estado.
• Temas por evaluación con pesos (/asignaturas/[id]/evaluaciones/[id]): el porcentaje de cada tema se calcula solo; el mismo tema puede entrar en el parcial y en el final.
• Tiempo disponible por día de la semana y días sin estudio (/ajustes), que usará el planificador de la Fase 7.
• Hoy muestra los próximos exámenes con los días que faltan.
• Lógica pura en src/domain/academic (árbol de temas, reordenación, pesos, validación con zod), repositorios en src/server/repositories y Server Actions en src/server/actions.
• Test e2e en móvil (Playwright) que recorre todo lo anterior contra una base de datos real.

Fase 3: qué incluye

• Biblioteca (/biblioteca): documentos por asignatura con filtros por asignatura, tipo y tema; icono por formato, tamaño, páginas y estado de lectura del texto.
• Subida (/biblioteca/subir): uno o varios archivos (PDF, DOCX, PPTX, TXT, Markdown e imágenes, hasta 50 MB) con asignatura, tipo, temas, evaluaciones y, si es un examen, año y convocatoria. El archivo va directo del navegador a Supabase Storage (bucket privado), sin pasar por Vercel. Los duplicados se detectan por la huella SHA-256.
• Lectura del texto en el dispositivo (src/documents/): pdf.js por páginas, DOCX con sus títulos como secciones, PPTX por diapositivas con título y notas del orador, TXT/Markdown. El texto se trocea en fragmentos de ~1500 caracteres con su página y se guarda en document_chunks. Las imágenes quedan para el OCR de la Fase 9. Coste: cero.
• Ficha del documento (/biblioteca/[id]): abrir o descargar con enlace temporal, ver el texto extraído paginado, editar datos, volver a leer el texto y borrar (archivo incluido).
• Búsqueda global (/buscar): texto completo en español sin tildes («clausula» encuentra «cláusula») sobre fragmentos, títulos, preguntas y temas, con resaltado y filtro por asignatura; cada resultado lleva a la página exacta del documento.
• La página de cada asignatura muestra cuántos documentos tiene y un acceso para subir más.
• Migración 20261009000003_search.sql (configuración es_unaccent y función search_all). Si ya tenías la base de datos de las fases 1-2, ejecuta supabase/instalar-fase3.sql en el SQL Editor.

This is the beginning of the README. Read the rest at the original. Read the full README ↗