Version post accidente

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Qué hace este PR
+
+- Añade el soporte inicial para el rol Representante: DB, endpoints, tests y UI mínima.
+
+## Checklist técnico
+- [ ] Migraciones incluidas en `database/migrations`.
+- [ ] Tests unitarios e integración pasan (Jest).
+- [ ] Documentación mínima incluida (`PULL_REQUEST.md`).
+- [ ] Revisiones de seguridad y privacidad realizadas.
+
+## Cómo probar localmente
+Ver `PULL_REQUEST.md` en la raíz para pasos de ejecución.
+
+## Notas
+- Si la base remota no permite push, crear PR desde la interfaz web con este contenido.

.github/workflows/backend-tests.yml

@@ -0,0 +1,102 @@
+name: Backend tests
+
+on:
+  push:
+    paths:
+      - 'backend/**'
+      - 'database/**'
+  pull_request:
+    paths:
+      - 'backend/**'
+      - 'database/**'
+
+jobs:
+  test-backend:
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: smartstudio_lms
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -uroot -proot --silent"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=20
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Wait for MySQL
+        run: |
+          for i in {1..30}; do
+            if mysqladmin ping -h 127.0.0.1 -uroot -proot --silent; then
+              echo "MySQL is up"; break
+            fi
+            echo "Waiting for MySQL... ($i)"; sleep 2
+          done
+
+      - name: Install backend deps
+        run: |
+          cd backend
+          npm install
+
+      - name: Apply DB migrations (Node), ensure schema, seed
+        env:
+          DB_HOST: 127.0.0.1
+          DB_USER: root
+          DB_PASSWORD: root
+          DB_NAME: smartstudio_lms
+        run: |
+          cd backend
+          DB_HOST=$DB_HOST DB_USER=$DB_USER DB_PASSWORD=$DB_PASSWORD DB_NAME=$DB_NAME npm run migrate:js
+          node ./scripts/ensure_schema.js
+          node scripts/seed_sample_data.js || true
+          node scripts/seed_additional_data.js || true
+
+      - name: Start backend server and wait for /api/health
+        env:
+          DB_HOST: 127.0.0.1
+          DB_USER: root
+          DB_PASSWORD: root
+          DB_NAME: smartstudio_lms
+          RATE_LIMITS_DISABLED: '1'
+          NODE_ENV: test
+          JWT_SECRET: test_secret
+        run: |
+          cd backend
+          HOST=0.0.0.0 FORCE_START=1 RATE_LIMITS_DISABLED=$RATE_LIMITS_DISABLED NODE_ENV=$NODE_ENV JWT_SECRET=$JWT_SECRET nohup node server.js > server.log 2>&1 &
+          export TEST_BASE_URL=http://127.0.0.1:5000
+          for i in {1..30}; do
+            if curl -sSf "$TEST_BASE_URL/api/health" >/dev/null 2>&1; then
+              echo "backend ready"; break
+            fi
+            echo "waiting for backend ($i)"; sleep 1
+          done
+          if ! curl -sSf "$TEST_BASE_URL/api/health" >/dev/null 2>&1; then
+            echo "Server failed to start, last server.log:";
+            tail -n 200 server.log || true
+            exit 1
+          fi
+
+      - name: Run backend tests
+        env:
+          DB_HOST: 127.0.0.1
+          DB_USER: root
+          DB_PASSWORD: root
+          DB_NAME: smartstudio_lms
+          JWT_SECRET: test_secret
+          RATE_LIMITS_DISABLED: '1'
+          TEST_BASE_URL: http://127.0.0.1:5000
+        run: |
+          cd backend
+          npm test --silent

.github/workflows/ci.yml

@@ -0,0 +1,100 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: smartstudio_lms
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping --silent"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+
+    env:
+      DB_HOST: 127.0.0.1
+      DB_USER: root
+      DB_PASSWORD: root
+      DB_NAME: smartstudio_lms
+      RATE_LIMITS_DISABLED: '1'
+      NODE_ENV: test
+      NODE_OPTIONS: '--dns-result-order=ipv4first'
+      TEST_BASE_URL: 'http://127.0.0.1:5000'
+      JWT_SECRET: test_secret
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install backend dependencies
+        working-directory: backend
+        run: npm ci
+
+      - name: Apply DB migrations (Node), ensure schema, seed
+        working-directory: backend
+        env:
+          DB_HOST: ${{ env.DB_HOST }}
+          DB_USER: ${{ env.DB_USER }}
+          DB_PASSWORD: ${{ env.DB_PASSWORD }}
+          DB_NAME: ${{ env.DB_NAME }}
+        run: |
+          DB_HOST=$DB_HOST DB_USER=$DB_USER DB_PASSWORD=$DB_PASSWORD DB_NAME=$DB_NAME npm run migrate:js
+          node ./scripts/ensure_schema.js
+          node scripts/seed_sample_data.js || true
+          node scripts/seed_additional_data.js || true
+
+      - name: Start backend server and wait for /health
+        working-directory: backend
+        run: |
+          # Start server bound to 0.0.0.0 and allow test-mode start, disable rate limits
+          HOST=0.0.0.0 FORCE_START=1 NODE_ENV=test RATE_LIMITS_DISABLED=1 JWT_SECRET=$JWT_SECRET nohup node server.js > server.log 2>&1 &
+          # prefer IPv4 for test runner to avoid ::1/localhost ambiguity
+          export NODE_OPTIONS=--dns-result-order=ipv4first
+          export TEST_BASE_URL=http://127.0.0.1:5000
+          # wait for health endpoint
+          for i in {1..30}; do
+            if curl -sSf "$TEST_BASE_URL/api/health" >/dev/null 2>&1; then
+              echo "backend ready"
+              break
+            fi
+            sleep 1
+          done
+          # show server log tail if not ready
+          if ! curl -sSf "$TEST_BASE_URL/api/health" >/dev/null 2>&1; then
+            echo "Server failed to start, last server.log:";
+            tail -n 200 server.log || true
+            exit 1
+          fi
+
+      - name: Run backend tests (Jest)
+        working-directory: backend
+        env:
+          RATE_LIMITS_DISABLED: '1'
+          NODE_OPTIONS: ${{ env.NODE_OPTIONS }}
+          TEST_BASE_URL: ${{ env.TEST_BASE_URL }}
+        run: npm test --silent
+
+      - name: Install frontend dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Run frontend tests (Vitest)
+        working-directory: frontend
+        run: npm test --silent

.github/workflows/playwright-vitest.yml

@@ -0,0 +1,89 @@
+name: CI - Vitest + Playwright
+
+on:
+  push:
+    branches: [ main, feat/representatives ]
+  pull_request:
+    branches: [ main, feat/representatives ]
+
+jobs:
+  test:
+    name: Run unit tests and Playwright E2E
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: smartstudio_lms
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping --silent"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install frontend dependencies
+        run: |
+          cd frontend
+          npm ci
+
+      - name: Prepare and start backend for E2E
+        run: |
+          # Install backend deps, apply migrations and ensure supplemental schema
+          cd backend
+          npm ci
+          chmod +x ./scripts/run_migrations.sh
+          ./scripts/run_migrations.sh
+          node ./scripts/ensure_schema.js
+          # seed data used by tests
+          node ./scripts/seed_sample_data.js || true
+          node ./scripts/seed_additional_data.js || true
+          # start backend server in background bound to 0.0.0.0
+          HOST=0.0.0.0 FORCE_START=1 NODE_ENV=test nohup node server.js > ../backend-server.log 2>&1 &
+          # wait for health endpoint
+          for i in {1..30}; do
+            if curl -sSf "http://127.0.0.1:5000/health" >/dev/null 2>&1; then
+              echo "backend ready"
+              break
+            fi
+            sleep 1
+          done
+          if ! curl -sSf "http://127.0.0.1:5000/health" >/dev/null 2>&1; then
+            echo "Backend failed to start, logs:"; tail -n 200 ../backend-server.log || true; exit 1
+          fi
+
+      - name: Install Playwright browsers
+        run: |
+          cd frontend
+          npx playwright install --with-deps
+
+      # Use helper script to start mock + vite and run Playwright
+
+      - name: Run unit tests (Vitest)
+        run: |
+          cd frontend
+          npm test --silent
+
+      - name: Run Playwright E2E (helper)
+        run: |
+          chmod +x frontend/scripts/run-e2e.sh
+          ./frontend/scripts/run-e2e.sh
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: frontend/e2e/playwright-report

.gitignore

@@ -0,0 +1,3 @@
+# Ignorar dependencias de frontend
+/frontend/node_modules/
+node_modules/

CHANGELOG.md

@@ -0,0 +1,39 @@
+CHANGELOG — SmartStudio LMS
+
+2026-01-08  — Seeders, Admin dashboard, tests, recovery
+
+Added
+- backend/scripts/seed_sample_data.js — seeds courses, modules, lessons, cohorts, enrollments, assignment.
+- backend/scripts/seed_additional_data.js — seeds quiz_submissions, forum_threads/posts, submissions, representatives.
+- frontend/src/pages/AdminDashboard.jsx — admin metrics + recent assignments view.
+- frontend/src/components/ErrorBoundary.jsx — global React error boundary.
+- frontend/src/contexts/ToastContext.jsx and frontend/src/components/ToastContainer.jsx — toast UX for feedback.
+- RECOVERY_REPORT.md — report of recovery steps and instructions.
+- database/dump_seeded.sql — SQL dump of the seeded DB (snapshot).
+
+Changed
+- backend/server.js
+  - Expanded `/api/admin/summary` to include `forum_threads`, `quiz_submissions`, `assignments` and `recent_assignments`.
+  - Implemented runtime-checkable rate-limit wrappers so `RATE_LIMITS_DISABLED` can bypass limiters during tests.
+  - Fixed prepared-statement usage for `LIMIT/OFFSET` in courses pagination.
+
+Tests
+- Executed backend tests (Jest) and frontend tests (Vitest). All tests now pass locally after fixes.
+
+Notes
+- If you want these changes committed and pushed, tell me which commit message and branch to use.
+- For CI, ensure `RATE_LIMITS_DISABLED=1` or whitelist CI IPs to avoid rate-limit flakiness during automated test runs.
+
+Files touched (high level)
+- backend/server.js
+- backend/scripts/seed_sample_data.js
+- backend/scripts/seed_additional_data.js
+- backend/tests/* (tests executed)
+- frontend/src/pages/AdminDashboard.jsx
+- frontend/src/components/ErrorBoundary.jsx
+- frontend/src/contexts/ToastContext.jsx
+- frontend/src/components/ToastContainer.jsx
+- RECOVERY_REPORT.md
+- database/dump_seeded.sql
+
+-- End of changelog

PULL_REQUEST.md

@@ -0,0 +1,42 @@
+# Pull Request: feat/representatives
+
+Resumen
+- Implementa soporte inicial para el rol Representante (DB, API, tests y UI mínima).
+
+Cambios principales
+- Migración: `database/migrations/20251128120000_create_representatives_tables.sql` (tables: `representatives`, `consents`, `representative_access_logs`).
+- Backend: `backend/routes/representatives.js` (endpoints para solicitar, conceder/revocar consentimiento, listar requests, ver progreso como representante). Registro en `backend/server.js`.
+- Tests: `backend/tests/representatives.test.js` (flujo integración).
+- Frontend: `frontend/src/pages/RepresentativeDashboard.jsx` y ruta `/representative` en `frontend/src/App.jsx`.
+
+Checklist (DoD)
+- [ ] Migraciones incluidas y con rollback documentado (archivo en `/database/migrations`).
+- [ ] Tests unit/integration pasan en CI (Jest).  
+- [ ] UI mínima integrada y accesible desde header.  
+- [ ] PR description y changelog actualizados.  
+- [ ] Reviewer asignado (Tech Lead).
+
+Comandos para probar localmente
+1. Backend
+```bash
+cd backend
+npm install
+set -o allexport; source .env; set +o allexport
+./scripts/run_migrations.sh
+RATE_LIMITS_DISABLED=1 NODE_ENV=development node server.js
+```
+
+2. Frontend
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+Notas de seguridad y privacidad
+- Todos los accesos por parte de representantes registran filas en `representative_access_logs` y en `audits`.  
+- El estudiante debe conceder consentimiento explícito; la operación es revocable.
+
+Testing adicional recomendado
+- E2E UI: flujo solicitar → conceder → visualizar (Playwright/ Cypress).  
+- Stress test para endpoints de consent y requests.