Normalize docs and add class zero diagnostic

Author: vladimiracunadev-create

README.md

@@ -1,4 +1,4 @@
-# 🧭 Python Data Science Bootcamp
+# Python Data Science Bootcamp
 
 [![CI](https://github.com/vladimiracunadev-create/python-data-science-bootcamp/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/vladimiracunadev-create/python-data-science-bootcamp/actions/workflows/ci.yml)
 [![Security](https://github.com/vladimiracunadev-create/python-data-science-bootcamp/actions/workflows/security.yml/badge.svg?branch=master)](https://github.com/vladimiracunadev-create/python-data-science-bootcamp/actions/workflows/security.yml)
@@ -11,26 +11,22 @@ Base de capacitacion tecnica para Python y Data Science orientada a clases reale
 
 No es solo un repo de materiales. Reune curriculum modular, laboratorio interactivo local, portal del alumno, presentacion institucional y una familia documental que separa producto, operacion, seguridad y audiencias.
 
----
+## Estado actual del producto
 
-## 🧭 Estado actual del producto
-
-> Estado: base operativa  
-> Superficies publicas: portal del alumno + vista institucional  
-> Superficie local: laboratorio Flask con runner y notebooks  
+> Estado: base operativa
+> Superficies publicas: portal del alumno + vista institucional
+> Superficie local: laboratorio Flask con runner y notebooks
 > Postura de despliegue: local-first, no internet abierta sin capas adicionales
 
-## ✨ Que resuelve hoy este repositorio
+## Que resuelve hoy este repositorio
 
 - una ruta concreta para ensenar Python y Data Science con progresion real;
 - un entorno local de clase para visualizar materiales, cargar notebooks y ejecutar codigo;
 - una superficie publica para alumnos y otra para stakeholders;
 - una base reusable para entrevistas, propuestas y futuras cohortes;
 - una postura documental mas cercana a producto que a inventario de archivos.
 
----
-
-## 👥 Rutas recomendadas segun perfil
+## Rutas recomendadas segun perfil
 
 | Perfil | Documento de entrada | Que mirar primero |
 |---|---|---|
@@ -44,9 +40,7 @@ No es solo un repo de materiales. Reune curriculum modular, laboratorio interact
 
 Si no sabes por donde entrar, usa [docs/INDEX.md](docs/INDEX.md).
 
----
-
-## ⏱ Como leer este repo segun tiempo disponible
+## Como leer este repo segun tiempo disponible
 
 | Tiempo | Secuencia recomendada | Resultado esperado |
 |---|---|---|
@@ -56,77 +50,69 @@ Si no sabes por donde entrar, usa [docs/INDEX.md](docs/INDEX.md).
 
 Eso evita leer la carpeta `docs/` como una coleccion plana. La documentacion esta pensada como sistema y no como inventario.
 
----
-
-## 🧱 Superficies del producto
+## Superficies del producto
 
 | Superficie | Rol | Estado |
 |---|---|---|
 | Laboratorio interactivo (`app/`) | entorno local de clase, notebooks y runner | operativo |
 | Portal del alumno (`site/`) | punto de entrada oficial para estudiantes | operativo |
 | Vista institucional (`site/product/`) | presentacion visual del producto | operativa |
-| Curriculum modular (`classes/`) | base pedagogica reusable — 12 clases con notebooks documentados | operativo |
+| Curriculum modular (`classes/`) | base pedagogica reusable con clase 0 diagnostica y 12 clases con notebooks documentados | operativo |
 | Instalador Windows (`launcher.py` + `bootcamp.spec` + `installer/`) | empaqueta el laboratorio como .exe instalable sin Python | listo para build |
 | App Android (`mobile/`) | app Expo/React Native con contenido embebido + integracion Colab | listo para build |
 | PDFs (`docs/pdfs/`) | apoyo para reunion, evaluacion e impresion | operativo |
 
 La fuente de verdad para esta taxonomia vive en [docs/CATALOGO_PRODUCTO.md](docs/CATALOGO_PRODUCTO.md).
 
----
-
-## 🏗 Arquitectura en una mirada
+## Arquitectura en una mirada
 
 ```mermaid
 graph LR
-    INST["Institucion"] --> PRODUCT["site/product/"]
-    ALUM["Alumno"] --> PORTAL["site/"]
-    ALUM --> MOBILE["mobile/ App Android"]
-    DOC["Docente"] --> LAB["app/ Laboratorio Flask"]
-    DOC --> WIN["launcher.py Instalador Windows"]
-
-    PRODUCT --> DOCS["docs/"]
-    PORTAL --> DOCS
-    MOBILE --> CLASSES["classes/ 12 clases"]
-    MOBILE --> COLAB["Google Colab"]
-    LAB --> CLASSES
-    LAB --> DATA["datasets/"]
-    LAB --> NOTEBOOKS["app/notebooks/"]
-    LAB --> SAVED["app/saved_notebooks/"]
-    WIN --> LAB
+INST["Institucion"] --> PRODUCT["site/product/"]
+ALUM["Alumno"] --> PORTAL["site/"]
+ALUM --> MOBILE["mobile/ App Android"]
+DOC["Docente"] --> LAB["app/ Laboratorio Flask"]
+DOC --> WIN["launcher.py Instalador Windows"]
+
+PRODUCT --> DOCS["docs/"]
+PORTAL --> DOCS
+MOBILE --> CLASSES["classes/ clase 0 + 12 clases"]
+MOBILE --> COLAB["Google Colab"]
+LAB --> CLASSES
+LAB --> DATA["datasets/"]
+LAB --> NOTEBOOKS["app/notebooks/"]
+LAB --> SAVED["app/saved_notebooks/"]
+WIN --> LAB
 ```
 
 La arquitectura completa, con flujos y fronteras, esta en [docs/ARQUITECTURA_PRODUCTO.md](docs/ARQUITECTURA_PRODUCTO.md).
 
----
-
-## 🚀 Capacidades actuales
+## Capacidades actuales
 
-### 📚 Curriculum y pedagogia
+### Curriculum y pedagogia
 
-- 12 clases modulares;
+- clase 0 diagnostica + 12 clases modulares;
 - ejercicios, tareas, notebooks y soluciones;
 - datasets sinteticos para practica;
 - guias de instructor, metodologia y evaluacion;
 - ruta inicial acotada para contexto escolar.
 
-### 💻 Laboratorio interactivo
+### Laboratorio interactivo
 
 - app Flask con visualizacion de clases;
 - carga de notebooks base;
 - ejecucion de codigo Python en navegador;
 - guardado de notebooks de practica;
 - endpoints `GET /health` y `GET /ready`.
 
-### 🖼 Presentacion y evaluacion
+### Presentacion y evaluacion
 
 - landing publica para alumnos en GitHub Pages;
 - vista institucional HTML separada del portal del alumno;
 - PDFs listos para preparacion personal y muestra del producto;
 - guia de evaluacion rapida para entrevista o revision externa.
 
----
-
-## ⚡ Inicio rapido
+## Inicio rapido
 
 ### Opcion A - entorno virtual
 
@@ -151,9 +137,7 @@ docker compose up --build
 docker compose -f docker-compose.prod.yml up -d --build
 ```
 
----
-
-## 🔁 Validacion y CI/CD
+## Validacion y CI/CD
 
 ```bash
 pytest
@@ -176,9 +160,7 @@ Eso cubre:
 - escaneo estatico de seguridad;
 - despliegue del portal del alumno a GitHub Pages.
 
----
-
-## 🔐 Seguridad y limites
+## Seguridad y limites
 
 Protecciones actuales:
 
@@ -201,9 +183,7 @@ Limites actuales:
 
 Ver detalle en [SECURITY.md](SECURITY.md).
 
----
-
-## 🗺 Mapa documental
+## Mapa documental
 
 | Documento | Rol |
 |---|---|
@@ -222,24 +202,20 @@ Ver detalle en [SECURITY.md](SECURITY.md).
 
 > La documentacion de preparacion para entrevista y las notas internas del maintainer viven en `docs/entrevista/` y `docs/maintainer/` respectivamente. Ver [docs/INDEX.md](docs/INDEX.md) para el mapa completo.
 
----
-
-## ✅ Lo que este repo si es
+## Lo que este repo si es
 
 - una base seria de capacitacion tecnica;
 - un sistema que integra contenido, practica y presentacion;
 - una muestra de criterio pedagogico y operacional;
 - una propuesta que puede empezar acotada y crecer sin rehacerse.
 
-## 🚫 Lo que este repo no vende
+## Lo que este repo no vende
 
 - una plataforma multiusuario endurecida para internet abierta;
 - una app movil ya operativa;
 - una promesa de personalizacion infinita antes de cerrar condiciones;
 - una profundidad total en todas las direcciones desde la primera version escolar.
 
----
-
-## 💡 Idea fuerza
+## Idea fuerza
 
 El valor de este proyecto no depende de competir contra una tecnologia puntual. Su valor esta en traducir herramientas a aprendizaje real, con secuencia pedagogica, criterio docente, operacion responsable y una base documental que permite evaluarlo como producto.

RUNBOOK.md

@@ -1,10 +1,10 @@
-# 🛠 RUNBOOK
+# RUNBOOK
 
 > Guia de operacion diaria, smoke checks y recuperacion basica para `python-data-science-bootcamp`.
 
-## ▶ Arranque estandar
+## Arranque estandar
 
-### 🐍 Entorno virtual
+### Entorno virtual
 
 ```powershell
 python -m venv .venv
@@ -13,53 +13,53 @@ pip install -r requirements.txt
 python run_bootcamp.py
 ```
 
-### 🐳 Docker Compose
+### Docker Compose
 
 ```powershell
 docker compose up --build
 ```
 
-### 🛡 Compose endurecido
+### Compose endurecido
 
 ```powershell
 docker compose -f docker-compose.prod.yml up -d --build
 ```
 
-## ✅ Smoke checks minimos
+## Smoke checks minimos
 
-### ❤️ Health
+### Health
 
 ```powershell
 Invoke-WebRequest -UseBasicParsing http://127.0.0.1:8000/health
 ```
 
-### 🟢 Readiness
+### Readiness
 
 ```powershell
 Invoke-WebRequest -UseBasicParsing http://127.0.0.1:8000/ready
 ```
 
-### 📚 Clase disponible
+### Clase disponible
 
 ```powershell
 Invoke-WebRequest -UseBasicParsing http://127.0.0.1:8000/api/classes
 ```
 
-### ⚙ Ejecucion basica
+### Ejecucion basica
 
 ```powershell
 Invoke-WebRequest -UseBasicParsing -Method Post -ContentType 'application/json' -Body '{"notebook_id":"smoke","code":"2+2"}' http://127.0.0.1:8000/api/execute
 ```
 
-## 🔁 Validaciones de repo
+## Validaciones de repo
 
 ```powershell
 .\.venv\Scripts\python.exe -m pytest
 .\.venv\Scripts\python.exe -m pip install ruff
 .\.venv\Scripts\python.exe -m ruff check .
 ```
 
-## 🚨 Incidentes comunes
+## Incidentes comunes
 
 | Incidente | Que revisar |
 |---|---|
@@ -69,20 +69,20 @@ Invoke-WebRequest -UseBasicParsing -Method Post -ContentType 'application/json'
 | Docker expone mal el puerto | confirmar mapeo `127.0.0.1:8000:8000` |
 | GitHub Pages no se publica | confirmar que el workflow corre sobre `master` o `main` y que `site/` existe |
 
-## ⏹ Apagado
+## Apagado
 
-### 💻 Proceso local
+### Proceso local
 
 Detener la terminal donde corre `python run_bootcamp.py`.
 
-### 🐳 Docker
+### Docker
 
 ```powershell
 docker compose down
 docker compose -f docker-compose.prod.yml down
 ```
 
-## 🧯 Recuperacion basica
+## Recuperacion basica
 
 - si el runner queda en estado inconsistente, reiniciar la sesion del notebook o reiniciar la app;
 - si el contenido guardado en `app/saved_notebooks` no se necesita, eliminarlo manualmente;

SECURITY.md

@@ -1,19 +1,19 @@
-# 🔐 SECURITY
+# SECURITY
 
 > Postura de seguridad actual y hardening recomendado para `python-data-science-bootcamp`.
 
-## 🧭 Estado actual
+## Estado actual
 
 Este repositorio esta pensado para uso local, docente y de laboratorio. La app interactiva permite ejecutar codigo Python, por lo que hoy su postura de seguridad es adecuada para entornos controlados, demos guiadas y maquinas administradas por el docente, pero no para exposicion abierta a internet sin capas adicionales.
 
-## 🧾 Versiones soportadas
+## Versiones soportadas
 
 | Linea | Estado |
 |---|---|
 | `2.x` | soportada |
 | `1.x` | sin soporte activo |
 
-## 🛡 Protecciones que existen hoy
+## Protecciones que existen hoy
 
 - validacion de `slug` e identificadores para evitar rutas arbitrarias;
 - limite de payload por request;
@@ -24,7 +24,7 @@ Este repositorio esta pensado para uso local, docente y de laboratorio. La app i
 - defaults de arranque local via `127.0.0.1`;
 - `docker-compose` enlazado a `127.0.0.1`.
 
-## 🚧 Lo que no existe todavia
+## Lo que no existe todavia
 
 - autenticacion de usuarios;
 - aislamiento fuerte por estudiante;
@@ -33,35 +33,35 @@ Este repositorio esta pensado para uso local, docente y de laboratorio. La app i
 - auditoria estructurada;
 - sandbox de sistema operativo para ejecucion de codigo no confiable.
 
-## 🔒 Recomendaciones de hardening
+## Recomendaciones de hardening
 
-### 🏫 Para uso local y docente
+### Para uso local y docente
 
 - mantener `BOOTCAMP_HOST=127.0.0.1`;
 - ejecutar en maquina controlada por el docente;
 - limpiar notebooks guardados antes de compartir el repo o una imagen.
 
-### 🌐 Si se publica fuera del equipo local
+### Si se publica fuera del equipo local
 
 - poner la app detras de un reverse proxy con TLS;
 - exigir autenticacion externa antes de abrir el runner;
 - aplicar rate limiting en proxy o gateway;
 - registrar accesos y errores en logs centralizados;
 - separar entorno demo de cualquier entorno con usuarios reales.
 
-## ⚠ Riesgos aceptados
+## Riesgos aceptados
 
 - el runner ejecuta codigo Python del usuario dentro del proceso de la app;
 - el timeout reduce riesgo de bloqueos, pero no reemplaza un sandbox real;
 - el proyecto prioriza facilidad de uso en laboratorio por sobre postura multiusuario endurecida.
 
-## 🔎 Nota sobre analisis estatico
+## Nota sobre analisis estatico
 
 - el archivo `app/execution_engine.py` contiene usos intencionales de `exec` y `eval` para emular una experiencia tipo notebook en laboratorio local;
 - esas lineas estan marcadas de forma localizada para Bandit, no porque el riesgo no exista, sino porque es una capacidad central del producto;
 - la mitigacion real no es "eliminar exec", sino mantener el runner en entorno controlado, con localhost por defecto, timeout, limites de payload y sin exposicion abierta.
 
-## 📬 Reporte responsable
+## Reporte responsable
 
 Si detectas una vulnerabilidad: