Centro de Documentación & Manuales - AQUILA A-ERP

⚡

1. Setup & Clonación del Repositorio

Guía paso a paso para clonar, configurar y correr la plataforma en menos de 3 minutos.

1. Clonar Repositorio Git

Asegúrate de tener instalado .NET 10 SDK y Git. Ejecuta:

git clone https://github.com/felipeostosb/intranet-institucional-modular.git

cd intranet-institucional-modular

2. Crear Rama (Opción 2) Asistente

Usa la Opción 2 del asistente para crear tu rama protegida automáticamente:

./dev.sh # Linux / Mac

.\dev.ps1 # Windows

Pregunta tu módulo (00-09) y el nombre de la tarea.

3. Actualizar (Opción 3) Zero-Loss

Si otro equipo actualizó main, usa la Opción 3:

./dev.sh -> Elegir Opción 3

Descarga cambios de producción sin borrar ni perder tu avance local.

4. Correr Intranet (Opción 1) Port 5000

Selecciona la Opción 1 para arrancar la web con Hot-Reload:

http://localhost:5000

Vistas Razor minimalistas con soporte nativo Dark Mode.

👑

2. Manual del Product Owner (PO)

Definición de requerimientos de negocio, historias de usuario y validación final de aceptación (UAT).

📋 Abrir Generador PO & PDF ↗

✨ Nueva Herramienta Integrada • Llenado en 90s

Generador Interactivo de Ficha de Requerimiento PO

Escribe tu requerimiento en lenguaje claro, descarga la Ficha Oficial en PDF A4 con firmas del equipo y docente, envía el Issue a GitHub con 1 clic o genera el prompt para Cursor / IA.

🚀 Llenar Ficha PO Ahora

🎯

Misión: Definir el "QUÉ"

Regla Clave: El PO NO hace de QA. Su rol es definir el requerimiento y validar la satisfacción del usuario final (UAT), dejando las pruebas técnicas de errores al Especialista QA.

El PO solo recibe la pantalla cuando el QA Tester ya validó que no tiene errores de formulario ni bugs de código.

📝

Receta Universal de Requerimientos

Aplica esta estructura para cualquiera de los 10 módulos:

• Como: [Rol: Docente / Alumno / Director / Cajero]

• Quiero: [Acción concreta en pantalla]

• Para: [Resultado o beneficio cuantificable]

📋

Criterios de Aceptación (Gherkin)

Define las condiciones exactas antes de que el equipo empiece a programar:

Dado que: [Estado inicial del sistema]

Cuando: [El usuario realiza la acción]

Entonces: [Respuesta esperada en pantalla/BD]

🏃

3. Manual del Scrum Master (SM)

Gobernanza del flujo ágil, protección de la rama main, eliminación de bloqueos y control de entregas.

Liderazgo Ágil

🌿

Blindaje de la Rama Main

Innegociable: Nadie puede hacer push directo a main.

// Formato estándar obligatorio:

moduloXX/nombre-de-la-tarea

Ej: modulo03/actas-calificaciones

⏱️

Daily Standup (5 Minutos)

Reunión rápida al inicio del sprint para alinear a PO, DBA, Devs y QA:

¿Qué avance de tu módulo cerraste ayer?
¿Qué pantalla o tabla vas a conectar hoy?
¿Tienes algún bloqueo con la BD o dependencias?

✅

Definition of Done (DoD)

Requisitos obligatorios antes de aprobar el Pull Request:

✓ dotnet build con 0 Warnings, 0 Errors.
✓ Interfaz limpia en estándar Zen Minimalista.
✓ Validación de QA: 0 bugs reportados por el Tester.
✓ Visto Bueno del PO: Requerimiento funcional cumplido.

🗄️

4. Manual del Especialista de Base de Datos (DBA)

Guía completa de ciclo de vida relacional: esquemas soberanos, integración con core, scripts SQL e índices.

PostgreSQL 16 Cloud

1. Conexión Cloud Adminer ↗

Acceso web sin instalación o vía DBeaver / pgAdmin / psql:

Host: 35.206.81.32:5432

BD: db_intranet_iestp

User: user_equipoXX

🛡️

2. Soberanía de Esquema

Cada equipo administra exclusivamente su esquema (mod00..09):

• ALL PRIVILEGES en modXX.*

• SELECT en core.*

Prohibido DROP/ALTER en esquemas ajenos.

🔗

3. Tablas Maestras (Core)

Vincula tus tablas con Foreign Keys hacia el esquema maestro:

core.estudiantes(id)

core.docentes(id)

core.carreras(id)

core.semestres(id)

📁

4. Scripts en el Repo

Guarda tus scripts en la carpeta de tu módulo:

📁 scripts/modXX/

├── 01_crear_tablas.sql

├── 02_crear_indices.sql

└── 03_datos_prueba.sql

🧪

5. Manual del Especialista de Calidad (QA Tester)

Validación técnica rigurosa de formularios, casos borde, persistencia en BD y consistencia visual antes del PO.

Control de Calidad

⚠️

1. Pruebas de Entrada & Errores

• Enviar formularios vacíos (debe mostrar alertas, nunca error 500).
• Probar caracteres especiales, textos extra largos y números negativos.
• Probar doble clic rápido para evitar registros duplicados.

🔍

2. Verificación en Base de Datos

• Abrir Adminer y verificar que los datos guardados en pantalla coinciden exactamente con la tabla en PostgreSQL.
• Comprobar que no queden campos clave nulos o truncados.
• Verificar que el borrado o edición actualice el estado real.

🌓

3. UX Zen & Modo Oscuro

• Probar la vista en Modo Claro y Modo Oscuro (cero textos ilegibles o fondos rotos).
• Probar en resolución móvil/tablet (que las tablas tengan scroll horizontal limpio).
• Dar el visto bueno para que el Product Owner realice el UAT.

🤖

6. Prompts Maestros para Inteligencia Artificial

Plantillas blindadas listas para copiar y pegar en ChatGPT, Claude, DeepSeek o Cursor para asegurar que respeten la arquitectura.

Protección de Contexto

👑

Prompt 1 • Para el Product Owner

Historias & Gherkin

Genera historias de usuario con formato DoR y criterios de aceptación sin tecnicismos confusos.

Actúa como Product Owner Senior especializado en ERPs Educativos del Perú. Mi módulo asignado es: [Módulo XX: Nombre del Módulo]. Redacta 3 Historias de Usuario de alto valor para este módulo siguiendo estrictamente este formato: 1. Historia: "Como [Rol: Docente/Estudiante/Director/Cajero], Quiero [Acción concreta en la vista], Para [Beneficio medible]". 2. Criterios de Aceptación (Gherkin): - Dado que: [Precondición del sistema] - Cuando: [Acción del usuario] - Entonces: [Resultado esperado en pantalla y en la BD] 3. Requerimientos de Datos: Lista de 4 campos clave que el Especialista de BD debe crear en la tabla de este módulo. Restricción: No uses código SQL ni tecnicismos de programación. Sé directo y claro.

🗄️

Prompt 2 • Para el Especialista BD (DBA)

PostgreSQL 16

Genera scripts DDL y DML aislados en tu esquema soberano con Foreign Keys hacia `core`.

Actúa como Lead Database Administrator (DBA) especializado en PostgreSQL 16. Estamos desarrollando un ERP modular institucional. Mi esquema soberano asignado es: [modXX] (ej: mod02). Mi usuario de PostgreSQL es: [user_equipoXX]. El requerimiento funcional de mi módulo es: [Pegar historias del PO o describir funcionalidad]. Genera los scripts SQL optimizados siguiendo estrictamente estas reglas arquitectónicas: 1. SOBERANÍA: Todas las tablas deben crearse dentro de mi esquema 'modXX' (ej: CREATE TABLE modXX.nombre_tabla (...)). 2. INTEGRIDAD REFERENCIAL: Las entidades globales NO se duplican; debes referenciar con Foreign Keys hacia el esquema 'core': - core.estudiantes(id) - core.docentes(id) - core.carreras(id) - core.semestres(id) 3. BUENAS PRÁCTICAS: - Primary Keys: id SERIAL PRIMARY KEY. - Timestamps: created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP. - Restricciones CHECK para estados o tipos acotados. - Índices B-Tree en columnas de búsqueda (dni, fechas, estado). 4. ESTRUCTURA: - Archivo 1: scripts/modXX/01_crear_tablas.sql - Archivo 2: scripts/modXX/02_crear_indices.sql - Archivo 3: scripts/modXX/03_datos_prueba.sql (5 inserts con FKs válidas a core). Restricción crítica: PROHIBIDO hacer DROP/ALTER a esquemas ajenos o al esquema 'core'.

💻

Prompt 3 • Para el Desarrollador (.NET 10)

C# 13 & Razor Zen

Genera Controllers, Servicios y Vistas Razor minimalistas con soporte nativo de Modo Oscuro.

Actúa como Senior .NET Engineer especializado en .NET 10 LTS, C# 13, ASP.NET Core MVC y Tailwind CSS / DaisyUI. Estamos trabajando en el proyecto modular: src/02_Modulos/Intranet.ModuloXX (ej: Intranet.Modulo02). El esquema de PostgreSQL es: modXX. Las tablas en BD son: [Pegar el DDL SQL o describir las entidades]. Genera el código compilable siguiendo esta arquitectura: 1. ENTIDADES & DTOs: Clases en Intranet.ModuloXX/Models. 2. REPOSITORIO / SERVICIO: Métodos asíncronos con Npgsql / Dapper hacia el esquema modXX. 3. CONTROLLER: ModuloXXController con [Authorize] y manejo de alertas TempData. 4. VISTA RAZOR ZEN (Views/ModuloXX/Index.cshtml): - Diseño Zen Minimalista (Apple/Linear). - Soporte nativo de Modo Oscuro (dark:bg-[#111827], dark:border-slate-800, dark:text-slate-100). - Cabecera con título claro y botón de acción principal. - 4 Tarjetas KPI minimalistas con indicadores numéricos. - Tabla responsive con badges de estado limpios. - Alertas amigables de DaisyUI (alert-success, alert-error). Restricción: No toques código fuera de src/02_Modulos/Intranet.ModuloXX. Cero estilos CSS en línea o dependencias no autorizadas.

🧪

Prompt 4 • Para el Especialista QA (Tester)

Test Matrix

Genera un checklist de validación exhaustivo de casos borde, formularios y persistencia en BD.

Actúa como Lead QA Engineer especializado en pruebas de software web y bases de datos. El módulo a probar es: [Módulo XX: Nombre del Módulo]. Las funcionalidades del módulo son: [Pegar historias de usuario o pantallas]. Diseña la Matriz de Pruebas de Calidad (Checklist Técnico de QA) antes de entregar al Product Owner: 1. PRUEBAS DE ENTRADA & VALIDACIÓN: - Casos con campos obligatorios vacíos (validar mensajes de error amigables, evitar error 500). - Casos con caracteres especiales, inyección básica, números negativos o textos extremadamente largos. - Prevención de doble submit (doble clic rápido). 2. PRUEBAS DE BASE DE DATOS (PostgreSQL / Adminer): - Verificación de inserción exacta en modXX.tabla sin campos nulos imprevistos. - Verificación de Foreign Keys correctas con core.estudiantes y core.docentes. 3. PRUEBAS DE EXPERIENCIA VISUAL ZEN: - Comprobación de contraste y legibilidad en Modo Claro y Modo Oscuro. - Comprobación de adaptación responsive en pantallas móviles y tablets. Genera el checklist en formato Markdown con casillas de verificación (- [ ]) listo para auditar.

🤝

7. Sinergia de Equipo: El Ciclo de 4 Pasos

Cómo trabajan juntos PO, DBA, Scrum Master, Desarrolladores y QA para entregar una funcionalidad completa.

Flujo Integral

Paso 1 • Definición 👑 🗄️

PO + Especialista BD

El PO redacta la historia y criterios Gherkin. El DBA crea las tablas en el esquema modXX de PostgreSQL Cloud y sube el script SQL.

Paso 2 • Construcción 🏃 💻

Scrum Master + Devs

El SM crea la rama con ./dev.sh. El programador implementa el Controller en .NET 10 y maqueta la vista Razor en Tailwind Zen conectada al esquema.

Paso 3 • QA Técnico 🧪 🔍

Especialista QA

El QA Tester prueba exhaustivamente formularios, casos borde, persistencia en Adminer y modo oscuro. Reporta bugs al dev hasta que todo funcione perfecto.

Paso 4 • UAT & Entrega ✅ 📹

Aceptación & Video

El PO realiza la validación de negocio final (UAT). El SM aprueba el PR hacia main y el equipo graba un video demo de 2 minutos para `/Docs`.

🏢

8. Directorio Oficial de los 10 Módulos

Mapeo institucional de los 10 equipos, esquemas PostgreSQL y responsabilidades.

10 Equipos

N°	Módulo Institucional Real	Esquema PostgreSQL	Usuario BD	Responsable BD / Líder	Funcionalidad Principal	Carpeta Soberana
00	Seguridad Core & Auditoría	`mod00`	`user_equipo00`	DevOps / Core	Autenticación SSO, gestión de sesiones y auditoría base	`src/02_Modulos/Intranet.Modulo00/`
01	Matrícula & Admisión	`mod01`	`user_equipo01`	📝 Ismael	Postulación, fichas académicas y reserva de vacantes	`src/02_Modulos/Intranet.Modulo01/`
02	Asistencia & DPI (18 Semanas) PRO	`mod02`	`user_equipo02`	📅 Sheyla	Sábana 18 semanas, alertas automáticas >30% DPI	`src/02_Modulos/Intranet.Modulo02/`
03	Inventario & Equipos	`mod03`	`user_equipo03`	📦 Brenda	Control patrimonial, inventario de laboratorios y equipos	`src/02_Modulos/Intranet.Modulo03/`
04	Módulo 04	`mod04`	`user_equipo04`	📦 Equipo 04 (Morales)	Módulo 04 institucional y servicios del equipo	`src/02_Modulos/Intranet.Modulo04/`
05	Incidencias & Requerimientos	`mod05`	`user_equipo05`	🛠️ Oliva	Mesa de ayuda TI, tickets de soporte y requerimientos técnicos	`src/02_Modulos/Intranet.Modulo05/`
06	Egresados & Titulación	`mod06`	`user_equipo06`	🎓 Sandra	Seguimiento a graduados, trámites de titulación y constancias	`src/02_Modulos/Intranet.Modulo06/`
07	Encuestas & Calidad Docente	`mod07`	`user_equipo07`	📊 Brayan	Evaluación de desempeño docente y encuestas de satisfacción	`src/02_Modulos/Intranet.Modulo07/`
08	Login, Seguridad & Roles	`mod08`	`user_equipo08`	🔐 Toro	Gestión de credenciales institucionales, políticas RBAC y accesos	`src/02_Modulos/Intranet.Modulo08/`
09	Tesorería & Pagos TUPA	`mod09`	`user_equipo09`	💳 Equipo 09 (Vargas)	Recaudación de tasas TUPA, caja chica y estado de cuenta	`src/02_Modulos/Intranet.Modulo09/`

📹

9. Academia de Videotutoriales & Demos

Aprende con videos demostrativos y sube las capacitaciones de tu equipo.

Todos General 00. Seguridad 01. Matrícula (Ismael) 02. Asistencia (Sheyla) 03. Inventario (Brenda) 04. Módulo 04 (Eq 04) 05. Incidencias (Oliva) 06. Egresados (Sandra) 07. Encuestas (Brayan) 08. Login & Roles (Toro) 09. Tesorería (Eq 09)

Módulo 02: Registro de Asistencias de 18 Semanas y Alertas DPI

Módulo 02 (Asistencia)

Sheyla (Líder Mod 02) 18/10/2026

Módulo 02: Registro de Asistencias de 18 Semanas y Alertas DPI

Cómo funciona el registro de asistencia por sesión de clase, cálculo automático de inasistencias (>30% DPI) y diseño de la sábana de 18 semanas en Razor.

Nivel: Avanzado

Módulo 00: Arquitectura de Seguridad, Roles y Protección de Rutas

Módulo 00 (Seguridad & Roles)

Toro (Líder Mod 00) 17/10/2026

Módulo 00: Arquitectura de Seguridad, Roles y Protección de Rutas

Explicación del flujo de autenticación, claims de rol, manejo de contraseñas y consultas soberanas al esquema mod00 en PostgreSQL.

Nivel: Intermedio

Inducción Rápida: Cómo Clonar, Usar dev.sh y Configurar PostgreSQL

General / Onboarding Dev

Felipe (PM & Lead) 16/10/2026

Inducción Rápida: Cómo Clonar, Usar dev.sh y Configurar PostgreSQL

Guía completa de 5 minutos para nuevos desarrolladores: clonar repositorio, ejecutar dev.sh, crear rama propia y configurar appsettings.Local.json con la base de datos de la nube.

Nivel: Básico

Manual de Operaciones & Guía de Ingeniería