Adrian Flores Cortes
967ab360bb
Structure: - control-plane/: Registries, SIMCO directives, CI/CD templates - projects/: Gamilit, ERP-Suite, Trading-Platform, Betting-Analytics - shared/: Libs catalog, knowledge-base Key features: - Centralized port, domain, database, and service registries - 23 SIMCO directives + 6 fundamental principles - NEXUS agent profiles with delegation rules - Validation scripts for workspace integrity - Dockerfiles for all services - Path aliases for quick reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
133 lines
3.7 KiB
Markdown
133 lines
3.7 KiB
Markdown
# 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](../../04-fase-backlog/README.md)
|
|
|
|
**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
|
|
|
|
```sql
|
|
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](./historias/US-PARENT-001-weekly-report.md) | Weekly Progress Report Email | 6h | P1 |
|
|
| [US-PARENT-002](./historias/US-PARENT-002-low-performance-alert.md) | Low Performance Alert | 5h | P1 |
|
|
| [US-PARENT-003](./historias/US-PARENT-003-achievement-notification.md) | 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/ANALISIS-FEATURES-P3-ESTRATEGICAS.md)
|
|
- [FEATURES-PENDIENTES.md](../../features/FEATURES-PENDIENTES.md) - F-P2-022
|
|
|
|
---
|
|
|
|
**Creado:** 2025-11-07
|
|
**Responsable:** Backend Team + Email Designer
|