Weekly Sprint Updates

Sprint 1 16 – 22 Marzo 2026

En progreso

Presentación del Sprint 1: Martes 24 Marzo 2026 — 18:00h

PV

Paola Villasmil

Project Manager — Resumen semanal

Hola Mònica 👋

Esta primera semana hemos arrancado oficialmente el proyecto con la Fase 1 (Cimientos). Te cuento los avances:

• ✅ Infraestructura base montada y funcionando
• ✅ Sistema de login/registro con seguridad avanzada
• ✅ Base de datos configurada con toda la estructura
• ✅ Panel de admin y usuario preparados

La próxima semana empezamos con lo más emocionante: la integración del avatar IA para las sesiones en vivo. 🚀

Cualquier duda estoy disponible. ¡Vamos muy bien!

🔧 Detalle técnico (para el equipo)

M01 — Setup & Infraestructura (24h):

• Express 5 + EJS (ejs-mate) + TailwindCSS v3
• better-sqlite3 con WAL mode, schema completo, migraciones secuenciales
• Variables de entorno (.env.local), logging con winston
• PM2 + Nginx configs preparadas
• Seed data: admin + demo student + avatars + topics + levels + 4 planes

M02 — Autenticación & Roles (28h):

• JWT access (1h) + refresh (7d) con rotación por familia
• Detección de reuso de tokens → revoca toda la familia
• bcrypt, validadores, middleware requireAuth + requireAdmin
• Pantallas login/registro, forgot/reset password, perfil de usuario
• Email verification (no-bloqueante, banner amber)

📷 Pantallas relacionadas

Login

Registro

Dashboard

Perfil

Asignado	Módulo	Tarea	Horas	Estado
NT DevTeam	M01 (24h)	Configuración Express + EJS + arquitectura modular	6h	● Hecho
		Configuración better-sqlite3: schema, migraciones, seeds	6h	● Hecho
		Variables de entorno, gestión de secretos, logging	3h	● Hecho
		CI básico, scripts de deploy, Nginx + PM2	5h	● Hecho
		Configuración monorepo + TailwindCSS	4h	● Hecho
NT DevTeam	M02 (28h)	API registro, login, logout con JWT + refresh tokens	8h	● Hecho
		Middleware de autorización por rol (Admin/Usuario)	4h	● Hecho
		Pantallas de login y registro (validación, UX)	8h	● Hecho
		Recuperación de contraseña vía email	5h	● Hecho
		Gestión de perfil de usuario	3h	● Hecho
PV PM	Project Management (Paola Villasmil)		4h	●
	Total Sprint 1		56h

Notas: Fase 1 (Cimientos) completada. Setup completo, auth funcional con JWT + refresh tokens + rotación por familia. Schema de BD con migraciones. Seed data con admin + student + avatars + topics + levels + plans.

Ver sprints pendientes (9)

Sprint 2 23 – 29 Marzo 2026

Próximamente

PV

🎨 El avatar despierta…

Empezamos con el núcleo del producto: integración con la API de Simli para las sesiones de avatar IA en tiempo real.

📷 Pantallas relacionadas

Avatars

Session Setup

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Estudio de documentación y sandbox Simli API	6h	● Planeado
NT	Configuración de credenciales, agentes y avatares	4h	● Planeado
NT	Componente de sesión con avatar (WebRTC/WebSocket)	16h	● Planeado
NT	Selector de avatar, tema y nivel de dificultad	6h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 2 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 3 30 Mar – 5 Abr 2026

Próximamente

PV

🧠 La inteligencia del feedback…

Finalizamos Simli y empezamos el Motor de Smart Feedback: análisis de transcripción, gramática, vocabulario y fluidez.

📷 Pantallas relacionadas

Sesión

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Control de sesión: inicio, fin, timer	6h	● Planeado
NT	Captura de transcripción + manejo errores	14h	● Planeado
NT	Análisis de transcripción post-sesión	12h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 3 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 4 6 – 12 Abr 2026

★ Hito 1

PV

🌟 Primera demo en vivo…

Completamos el feedback engine. Hito 1 — Demo interna. Primera sesión completa funcional.

📷 Pantallas relacionadas

Setup

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Generación de informe con IA + persistencia	14h	● Planeado
NT	Algoritmo de dificultad + vista de informe	10h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 4 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 5 13 – 19 Abr 2026

Próximamente

PV

📈 El alumno ve su progreso…

Fase 3 — SaaS Completo. Dashboard del alumno con estadísticas, progreso, racha diaria.

📷 Pantallas relacionadas

Dashboard

Sesiones

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Diseño y maquetación del dashboard	8h	● Planeado
NT	Widget progreso + historial con filtros	12h	● Planeado
NT	Gráficos de evolución + gestión suscripción	12h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 5 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 6 20 – 26 Abr 2026

Próximamente

PV

🛠 El admin toma el control…

Admin panel completo y arrancamos con Stripe: checkout, suscripciones, webhooks.

📷 Pantallas relacionadas

Admin

Usuarios

Contenido

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Dashboard admin: métricas globales	8h	● Planeado
NT	CRUD usuarios + gestión suscripciones	14h	● Planeado
NT	Config avatares + sesiones + exports CSV	14h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 6 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 7 27 Abr – 3 May 2026

★ Hito 2

PV

🥳 La plataforma cobra vida…

Cerramos Stripe + emails. Hito 2 — Beta cerrada. SaaS funcional completo.

📷 Pantallas relacionadas

Planes

Billing

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Checkout session + webhooks Stripe	18h	● Planeado
NT	Portal cliente + bloqueo por suscripción	10h	● Planeado
NT	Nodemailer + plantillas + alertas + reminders	20h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 7 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 8 4 – 10 May 2026

Próximamente

PV

🎨 La cara pública del producto…

Fase 4 — Lanzamiento. Landing page completa: hero, pricing, testimonios, CTA, contacto.

📷 Pantallas relacionadas

Landing

Contacto

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Diseño y maquetación full (hero, propuesta)	12h	● Planeado
NT	Pricing + testimonios + FAQ + footer	10h	● Planeado
NT	SEO + contacto/demo + optimización	6h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 8 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 9 11 – 17 May 2026

Próximamente

PV

🔎 Puliendo cada detalle…

QA y testing end-to-end. Revisión de seguridad, pruebas de carga, corrección de bugs.

📷 Pantallas relacionadas

Status

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Testing end-to-end flujo completo	10h	● Planeado
NT	Pruebas de carga + estabilidad Simli	6h	● Planeado
NT	Revisión seguridad: inyección, CORS, rate limiting	4h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 9 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Sprint 10 18 – 24 May 2026

★ Hito 3 — Final

PV

🏆 Next-Gen Tutor sale al mundo…

Despliegue en producción. Documentación final. Hito 3 — MVP Entregado.

📷 Pantallas relacionadas

Landing

Admin

🔮 Ver el futuro

⚠ Preview simulado — Proyección de cómo se vería este sprint completado.

Asignado	Tarea	Horas	Estado
NT	Despliegue producción + dominio + HTTPS	4h	● Planeado
NT	Documentación técnica + manual admin	4h	● Planeado
PV	Project Management (Paola Villasmil)	4h	● Planeado

PV

Sprint 10 completado. Todas las tareas entregadas en tiempo y forma. 🚀

Roadmap de Desarrollo

Equipo de Desarrollo

A. Propuesta Original Contratada

El MVP se contrató como un desarrollo de 316 horas en 10 módulos, estructurado en 4 fases de entrega con hitos de validación.

● En curso — Sprint activo, en desarrollo esta semana. ○ Planeado — Programado según calendario oficial del roadmap.
👉 Click en cualquier módulo para ver detalle y fechas.

Roadmap de entrega (10 semanas)

Gestión del proyecto

• Project Management: 40 horas incluidas — Perfil: Paola Villasmil (PM)
• Frontend & Backend: Nolberto (Team Lead) + equipo de desarrollo
• Main Guidance: NAiOS Labs — dirección técnica, arquitectura y supervisión

Condiciones acordadas

• Forma de pago: 40% inicio · 30% Hito 2 (Beta) · 30% Hito 3 (MVP live)
• Propiedad intelectual: 100% del código pasa a propiedad del cliente al abonar el total
• Garantía post-entrega: 30 días de soporte correctivo sin coste adicional
• Cambios de alcance: Funcionalidades fuera de propuesta valoradas por separado con aprobación escrita

B. Mini Demo (incluido en M09)

Feature adicional integrada en la landing page: demo gratuita de 2 minutos sin registro. Selección de avatar, sesión en vivo, transcripción, análisis y score CEFR. Datos guardados como leads para el admin.

Equipo Asignado

NAiOS Labs — Dirección técnica y desarrollo de producto.
Contacto: info@netretina.ai

Resumen Ejecutivo

Next-Gen Tutor es una plataforma SaaS de inmersión en inglés profesional mediante avatares de IA en tiempo real. Diseñada para ejecutivos y profesionales B1+, permite practicar conversaciones de negocio 24/7.

Flujo principal

1. El alumno elige un avatar IA, un tema de negocio y su nivel CEFR
2. Practica en una sesión de vídeo en tiempo real (15-60 min según plan)
3. Recibe un informe inteligente con puntuación, correcciones y áreas de mejora
4. Sigue su progreso a lo largo del tiempo

Audiencia

• Profesionales internacionales en empresas en expansión
• Directivos B2B que necesitan soltura oral
• Escuelas de negocios y docentes autónomos

Arquitectura Técnica

Pipeline de middleware

sequenceDiagram
    participant A as 👤 Alumno
    participant F as 🖥️ Frontend (Browser)
    participant B as ⚙️ Backend (Express)
    participant DB as 🗄️ Base de Datos
    participant S as 🎭 Simli API
    participant ST as 💳 Stripe

    Note over A,ST: 🔐 Registro & Autenticación
    A->>F: Registro / Login
    F->>B: POST /register o /login
    B->>DB: Crear usuario / Verificar credenciales
    B-->>F: JWT access + refresh token (cookies)
    B->>B: 📧 Email de verificación

    Note over A,ST: 💳 Suscripción
    A->>F: Seleccionar plan
    F->>B: POST /checkout
    B->>ST: Crear Checkout Session
    ST-->>F: Redirect a Stripe Checkout
    A->>ST: Pagar
    ST->>B: Webhook: checkout.session.completed
    B->>DB: Crear suscripción activa

    Note over A,ST: 🎭 Sesión de Práctica
    A->>F: Elegir avatar + tema + nivel
    F->>B: POST /session/create
    B->>DB: Verificar límite mensual + concurrencia
    B->>DB: Crear sesión (status: pending)
    F->>B: POST /api/simli/start
    B->>S: POST /startE2ESession
    S-->>B: { roomUrl, sessionId }
    B-->>F: roomUrl (Daily.co)
    F->>F: Cargar iframe Daily.co
    A->>S: Conversación en tiempo real (WebRTC)

    Note over A,ST: ⏱️ Fin de Sesión
    A->>F: Click "End Session" o timer expira
    F->>B: POST /session/:id/end
    B->>S: GET /transcript/:sessionId
    S-->>B: Transcripción JSON
    B->>B: 🧠 generateFeedback(transcript)
    B->>DB: Guardar feedback + score
    B-->>F: redirect /session/:id/feedback

    Note over A,ST: 📊 Feedback & Progreso
    A->>F: Ver informe de sesión
    F->>B: GET /session/:id/feedback
    B->>DB: Leer feedback JSON
    B-->>F: Score, sub-scores, correcciones
    A->>F: Ver progreso histórico
    F->>B: GET /progress
    B->>DB: Agregar stats de todas las sesiones
    B-->>F: Tendencias, promedios, errores
      

sequenceDiagram
    participant AD as 👑 Admin
    participant F as 🖥️ Frontend
    participant B as ⚙️ Backend
    participant DB as 🗄️ Base de Datos
    participant ST as 💳 Stripe
    participant SM as 📧 SMTP

    Note over AD,SM: ⚙️ Configuración
    AD->>F: Admin Settings
    F->>B: POST /admin/settings/*
    B->>DB: Guardar config (API keys encriptadas AES-256-GCM)
    AD->>F: Test Connection
    F->>B: POST /admin/settings/*/test
    B-->>F: { success, message }

    Note over AD,SM: 🎭 Gestión de Contenido
    AD->>F: Crear/editar avatar
    F->>B: POST /admin/content/avatars/create
    B->>DB: INSERT avatar (face_id, voice, prompt)
    AD->>F: Crear/editar plan
    F->>B: POST /admin/plans/:id/edit
    B->>ST: stripe.prices.create (auto-sync)
    ST-->>B: { priceId }
    B->>DB: UPDATE plan (stripe_price_id)

    Note over AD,SM: 📊 Monitorización
    AD->>F: Dashboard admin
    F->>B: GET /admin
    B->>DB: KPIs, charts data, recent sessions
    B-->>F: Render dashboard con 4 charts

    Note over AD,SM: 📧 Comunicaciones
    AD->>F: Enviar newsletter
    F->>B: POST /admin/newsletters/:id/send
    B->>DB: Obtener usuarios opt-in
    B->>SM: Enviar emails (Nodemailer)
    SM-->>B: { accepted, rejected }
    AD->>F: Gestionar contactos/demos
    F->>B: GET /admin/contacts
    B->>DB: Listar mensajes con status
      

Guía del Alumno

Landing Page

Página pública con hero animado (mesh geométrico interactivo + órbita de avatares + typewriter), secciones How It Works, Demo gratuita, Features, Pricing, Testimonials y CTA.

Registro e Inicio de Sesión

Registro con validación (min 8 chars, complejidad). Email de verificación configurable como bloqueante. Login con "Remember me" y recuperación de contraseña.

Dashboard

4 stat cards (sesiones, avg score, tiempo, racha), última sesión, quick actions y tabla recientes.

Sesiones de Práctica

Selección de avatar + topic + level con cards. Sesión en vivo con Daily.co o LiveKit. Timer per-plan. Máx 1 sesión simultánea.

Feedback, Historial y Progreso

Post-sesión: score circle, 4 sub-scores, fortalezas, mejoras, correcciones. Historial paginado con filtros. Progress tracking (Basic+).

Perfil, Billing y Contacto

Guía del Administrador

Dashboard

6 KPIs + 4 mini-charts (Sessions, Users, Score, MRR por día) + top topics + sesiones recientes + blog/newsletter/ticket stats.

Gestión de Usuarios

Vista dual lista + cards con profile image. CRUD completo. Protección: admin no puede desactivarse a sí mismo.

Contenido (Avatars, Topics, Levels)

Avatares con vista lista + cards (thumbnails circulares). Topics CRUD. Levels edit. Test playground por avatar.

Planes

CRUD con auto-sync de Stripe Price al cambiar precio.

Blog CMS

Posts Markdown + preview, categorías, tags, featured images. Vista lista + cards.

Contactos y Demo Requests

Mensajes de contacto + solicitudes de demo. Status tracking, notas admin, reply by email.

Settings

7 tabs: General, Simli, AI Tutor, AIML, Stripe, Email, LiveKit. API keys encriptadas. Test connection en cada integración.

Legal Pages & Status

Planes y Facturación

Enforcement

• Límite mensual contado por mes calendario
• Duración leída de plan.minutes_per_session
• Concurrencia máx 1 sesión activa (auto-expire stale)
• Feedback Free = score + top 3. Paid = completo

Flujo Stripe

Admin cambia precio → auto-crea Stripe Price → desactiva el anterior. Checkout Session para nuevos subs. Webhooks para sincronizar estados. Customer Portal para self-service.

Motor de Smart Feedback

Sistema de Email

• Nodemailer + SMTP (credentials encriptadas)
• Two-pass EJS render (inner → base wrapper)
• 7 templates personalizables desde admin + preview modal
• Scheduler 24h para practice reminders

Seguridad

Integraciones Externas

Base de Datos

Actualmente usa SQLite (better-sqlite3) con WAL mode y 22 migraciones secuenciales. Es la opción ideal para MVP: zero-config, embebida, transacciones ACID, lectura ultra-rápida.

La arquitectura usa prepared statements en todas las queries, lo que hace la migración a cualquier base de datos relacional directa, sin reescribir lógica de negocio.

Tablas principales

Escalabilidad — Migración a otras bases de datos

Cuando el volumen lo requiera (~500+ usuarios concurrentes), la plataforma puede migrar a cualquiera de estas opciones sin reescribir el código:

Despliegue

Variables de entorno obligatorias (producción)

• JWT_SECRET, SESSION_SECRET, ENCRYPTION_KEY — el server no arranca sin ellas
• APP_URL — para emails y redirects
• NODE_ENV=production

Configuración Inicial (Checklist)

1. Clonar repo + npm install
2. Crear .env.local con secrets
3. npm run db:init
4. npm run build
5. npm start
6. Login: admin@nextgentutor.ai / admin123
7. Admin → Settings: configurar Simli, Stripe, SMTP
8. Admin → Content: crear avatares, topics, levels
9. Admin → Plans: ajustar precios
10. Admin → Status: verificar conexiones
11. Configurar dominio + HTTPS (Nginx + Let's Encrypt)
12. Cambiar passwords de cuentas seed

APIs y Servicios Externos

La plataforma depende de los siguientes servicios externos para funcionar. Las API keys se configuran desde el panel admin en Settings y se almacenan encriptadas (AES-256-GCM) en la base de datos.

* Daily.co es requerido indirectamente cuando se usa el modo E2E de Simli (modo por defecto). No necesita cuenta propia — Simli gestiona las salas.
Los servicios opcionales (LiveKit, SMTP) degradan funcionalidad cuando no están configurados: sin LiveKit se usa el modo E2E; sin SMTP los emails se logean en consola.

Configuración de API Keys

Todas las claves se configuran desde /admin/settings en sus tabs respectivos. El sistema encripta las claves sensibles con AES-256-GCM antes de guardarlas en la base de datos. Cada tab tiene un botón "Test Connection" para verificar la conectividad.

Hosting e Infraestructura

La plataforma está diseñada para ejecutarse en cualquier servidor Linux con Node.js. La configuración inicial usa un VPS de Contabo, pero la arquitectura es portable a cualquier proveedor cloud.