workspace/projects/gamilit/docs/03-fase-extensiones/EXT-010-parent-notifications

EXT-010: Parent Notifications

⚠️ BACKLOG - FUERA DEL MVP

Esta épica está parcialmente implementada (35%) y NO forma parte del MVP actual. Razón: Feature nice-to-have. Ver: Fase 4: Backlog

Versión: 1.0 Fecha de creación: 2025-11-07 Prioridad: P2 (Promovida desde P3) Story Points: 15 SP Presupuesto: $2,250 USD Timeline: v1.3 (Sprints 17-24) Estado: ⏳ BACKLOG (35% implementado)

---

📋 Descripción

Sistema de notificaciones automáticas a padres de familia sobre el progreso, desempeño y logros de sus hijos en la plataforma GAMILIT, fomentando el involucramiento parental en el proceso educativo.

---

🎯 Objetivos de Negocio

Problema a Resolver

• Padres no tienen visibilidad del progreso de sus hijos
• Instituciones reciben quejas de falta de comunicación
• Bajo engagement parental reduce efectividad educativa

Valor Esperado

• NPS institucional: +15 puntos (padres satisfechos)
• Parental engagement: +50% (padres revisan reportes)
• Renovación institucional: +10% (instituciones renuevan contrato)
• Student accountability: +20% (estudiantes más responsables)
• ROI: 380%

Métricas de Éxito

• Email open rate: >40%
• Click-through rate: >15%
• Parent portal visits: +200%
• Institutional NPS: +15 puntos

---

🏗️ Arquitectura Técnica

Componentes

1. Notification Service (Backend)

   • Cron jobs para emails semanales
   • Alert triggers para bajo desempeño
   • Achievement notifications

2. Email Templates

   • Weekly progress report
   • Low performance alert
   • Achievement unlock notification

3. Parent Portal (Frontend - Básico)

   • Login con código de acceso
   • Dashboard de progreso del hijo
   • Historial de notificaciones

Database Schema

CREATE TABLE auth_management.parent_accounts (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  student_id UUID NOT NULL REFERENCES auth_management.users(id),
  parent_email VARCHAR(255) NOT NULL,
  access_code VARCHAR(20) UNIQUE, -- Código para login
  relationship VARCHAR(50), -- 'mother', 'father', 'guardian'
  is_active BOOLEAN DEFAULT true,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

CREATE TABLE notifications.parent_notifications (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  parent_id UUID NOT NULL REFERENCES auth_management.parent_accounts(id),
  student_id UUID NOT NULL REFERENCES auth_management.users(id),
  type VARCHAR(50), -- 'weekly_report', 'low_performance', 'achievement'
  subject VARCHAR(255),
  body TEXT,
  sent_at TIMESTAMPTZ DEFAULT NOW(),
  opened_at TIMESTAMPTZ,
  clicked_at TIMESTAMPTZ
);

---

👥 User Stories

ID	Historia	Esfuerzo	Prioridad
US-PARENT-001	Weekly Progress Report Email	6h	P1
US-PARENT-002	Low Performance Alert	5h	P1
US-PARENT-003	Achievement Unlock Notification	4h	P2

Total: 15 horas ($2,250 USD)

---

🔗 Dependencias

Bloqueado por

• Email service (Nodemailer/SendGrid) configurado
• Progress tracking funcionando
• Achievement system implementado

---

🚀 Plan de Implementación

Sprint 17-18 (Semanas 17-18) - 15h

• US-PARENT-001: Weekly Report (6h)
• US-PARENT-002: Low Performance Alert (5h)
• US-PARENT-003: Achievement Notification (4h)

---

📚 Referencias

• ANALISIS-FEATURES-P3-ESTRATEGICAS.md
• FEATURES-PENDIENTES.md - F-P2-022

---

Creado: 2025-11-07 Responsable: Backend Team + Email Designer