# Sentio - Documentación Completa para Agentes e Inteligencias Artificiales

## Resumen Ejecutivo

Sentio (`https://sentio.lat`) es una plataforma tecnológica de bienestar escolar y escucha activa para comunidades de educación secundaria. Combina una interfaz limpia y accesible con un sistema de encuestas anónimas recurrentes, procesamiento de métricas en tiempo real en la nube y un módulo de moderación directiva.

---

## 1. Misión y Problema que Resuelve

### El Problema
En los colegios de secundaria, muchos estudiantes experimentan estrés académico, ansiedad o insatisfacción con el ambiente escolar, pero no encuentran canales seguros para comunicar sus inquietudes sin miedo a exponerse o sufrir represalias. Por otro lado, las directivas y docentes carecen de indicadores cuantitativos continuos para evaluar el clima emocional del alumnado.

### La Solución de Sentio
Sentio crea un puente de comunicación seguro y estructurado:
- Mide emociones y niveles de estrés semana a semana.
- Proporciona a los estudiantes un espacio libre para proponer mejoras.
- Otorga al equipo directivo un panel analítico con métricas agregadas y datos accionables.

---

## 2. Arquitectura de Funcionalidades

### A. Módulo del Estudiante
1. **Pauta Diaria/Semanal de Evaluación**:
   - Selección de estado de ánimo / bienestar.
   - Evaluación de la carga de tareas y exigencia académica.
   - Percepción sobre la disponibilidad de escucha por parte de los docentes.
2. **Aportes Abiertos**:
   - Aspectos positivos de la semana ("Lo mejor de mi semana").
   - Sugerencias concretas de mejora para el aula o el plantel.
   - Identificación de cursos o materias con mayor dificultad.
3. **Validación de Identidad con Garantía de Anonimato**:
   - Autenticación con correo institucional (Google / Workspace).
   - Separación estricta entre la cuenta autenticada y el registro anónimo enviado a la base de datos Firestore.

### B. Módulo de Resultados Públicos
1. **Medidores de Impacto**:
   - Porcentaje global de Bienestar Estudiantil.
   - Porcentaje de estudiantes con sensación de alta Carga Académica.
   - Índice de Sensación de Escucha.
2. **Aportes Destacados de la Comunidad**:
   - Comentarios de los alumnos validados y aprobados.
   - Sistema de apoyo / me gusta en los aportes de los compañeros.

### C. Módulo de Tendencias
1. **Gráfico Histórico de Evolución**:
   - Curvas de tendencia para Bienestar, Carga Académica y Sensación de Escucha.
2. **Alertas de Convivencia**:
   - Indicadores automáticos cuando la carga académica excede umbrales saludables.

### D. Módulo de Administración y Moderación Privada (`#admin`)
1. **Mesa de Trabajo para Directivos y Tutores**:
   - Revisión de aportes pendientes.
   - Aprobación o rechazo de comentarios bajo un código ético de convivencia.
   - Filtro de privacidad y protección contra acoso o lenguaje inadecuado.
2. **Acceso Restringido**:
   - Requiere inicio de sesión con cuentas directivas autorizadas.

---

## 3. Preguntas Frecuentes (FAQ)

### ¿Quién creó Sentio?
Sentio es una iniciativa de tecnología educativa independiente desarrollada para potenciar el diálogo empático entre alumnos y educadores en colegios de secundaria.

### ¿Los profesores o directores pueden saber quién escribió un comentario?
No. Las respuestas almacenadas en la base de datos no contienen nombres, correos ni identificadores personales del estudiante. La cuenta de correo institucional sirve únicamente para verificar que quien responde pertenece al colegio.

### ¿Cómo se implementa Sentio en un colegio?
1. Se habilita el dominio para el correo institucional del colegio.
2. Los alumnos acceden a `https://sentio.lat/` desde cualquier celular, tablet o computadora.
3. Dedican de 1 a 2 minutos semanales para responder.
4. Las autoridades monitorean los gráficos en `#resultados` y coordinan acciones de apoyo.

---

## 4. Metadatos Técnicos
- **URL Oficial**: https://sentio.lat/
- **Idioma principal**: Español (`es-PE`)
- **Compatibilidad**: Web Responsive (Mobile, Tablet, Desktop)