bpstack · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026
diff --git a/backend/README.md b/backend/README.md
diff --git a/backend/backend.md b/backend/backend.md
diff --git a/backend/db-mysql/AGENTS.md b/backend/db-mysql/AGENTS.md
@@ -24,7 +24,6 @@ backend/db-mysql/
 ├── backup/            # DB dumps (local + Aiven)
 ├── MASTER_INSTALL.sql # Runs all aiven/ files in order. Empty DB only.
 ├── MIGRATIONS_POLICY.md
-├── MIGRATION_GUIDE.md
 ├── INDEX.md           # Full table index + incremental migration log
 └── mock-data.sql      # Clears module data and loads fictitious data (keeps users and scheduling)
 ```
@@ -172,4 +171,4 @@ password.
 
 - `MIGRATIONS_POLICY.md` — full policy rationale and when to change the model.
 - `INDEX.md` — module-by-module table list + full incremental migration log.
-- `MIGRATION_GUIDE.md` — initial install guide (scripts 01-19 walkthrough).
+- Fresh install: `pnpm setup:local` (`scripts/setup-local.ts`), never `MASTER_INSTALL.sql` by hand.
diff --git a/backend/db-mysql/INDEX.md b/backend/db-mysql/INDEX.md
@@ -34,7 +34,6 @@ db-mysql/
 ├── MASTER_INSTALL.sql        # Instalación completa (apunta a aiven/)
 ├── INDEX.md
 ├── README.md
-├── MIGRATION_GUIDE.md
 ├── cleanup-scheduling.sql
 └── mock-data.sql        # Vacía los módulos y carga datos ficticios (no toca usuarios ni horarios)
 ```

diff --git a/backend/db-mysql/MIGRATIONS_POLICY.md b/backend/db-mysql/MIGRATIONS_POLICY.md
@@ -71,7 +71,7 @@ Esos cambios se han reconstruido a posteriori como scripts marcados `[RETROACTIV
 ## Archivos relacionados
 
 - `INDEX.md` — índice general, tabla "Migraciones incrementales"
-- `MIGRATION_GUIDE.md` — guía de instalación inicial (scripts 01-20 congelados)
+- `pnpm setup:local` — instalación local desde cero (`scripts/setup-local.ts`)
 - `README.md` — overview de la carpeta
 - `scripts/` — scripts incrementales, ordenados por fecha. Única fuente de verdad para cambios desde 2026-05-20.
 - `aiven/NN_*.sql` — snapshot congelado del install base. No editar.
diff --git a/backend/db-mysql/MIGRATION_GUIDE.md b/backend/db-mysql/MIGRATION_GUIDE.md
diff --git a/backend/db-mysql/README.md b/backend/db-mysql/README.md
@@ -36,7 +36,6 @@ db-mysql/
 ├── MASTER_INSTALL.sql              # Snapshot 2026-05-20 (base congelada)
 ├── INDEX.md                        # Índice general + tabla de incrementales
 ├── MIGRATIONS_POLICY.md            # Política vigente
-├── MIGRATION_GUIDE.md              # Guía de instalación
 └── README.md                       # Este archivo
 ```
 
@@ -45,15 +44,14 @@ db-mysql/
 ### Instalación completa
 
 ```bash
-# Un solo comando (recomendado)
-mysql -u root -p < MASTER_INSTALL.sql
-
-# O desde el directorio aiven/
-cd aiven/
-mysql -u root -p < 01_create_database.sql
-# ... ejecutar en orden
+# Desde backend/: tablas, migraciones, admin local y datos ficticios
+pnpm setup:local
 ```
 
+No ejecutes `MASTER_INSTALL.sql` a mano: borra `hotel_db`, no aplica las
+migraciones de `scripts/` y tiene dos fallos del baseline que solo
+`setup:local` corrige (ADR-039).
+
 ### Verificación
 
 ```bash
@@ -142,7 +140,7 @@ WHERE status = 'completed'
 
 ## 🆘 Troubleshooting
 
-Ver [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) para solución de problemas comunes.
+Una instalación que falla: vuelve a lanzar `pnpm setup:local -- --force` (ver «Instalación completa»).
 
 ---
 
@@ -156,7 +154,7 @@ Ver [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) para solución de problemas comunes
 
 ## 🔗 Enlaces Útiles
 
-- [Guía de Migración](MIGRATION_GUIDE.md)
+- [Política de migraciones](MIGRATIONS_POLICY.md)
 - [Índice de Tablas](INDEX.md)
 - [Script de Verificación](aiven/99_verification.sql)
 

diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md
@@ -842,3 +842,31 @@
   cero, se corrigen en `setup:local` y con
   `20261005_complete_fresh_install.sql` sin tocar `aiven/` (ADR-021).
 - **Revisa:** ADR-015 en la BD local.
+
+## ADR-040 — La documentación obsoleta se archiva fuera del repositorio
+
+- **Estado:** ✅ aceptada (2026-10-05)
+- **Fecha:** 2026-10-05
+- **Decisión:** un documento que ya no describe el proyecto se mueve a
+  `docs/_archive/<su ruta original>` (en `.gitignore`: solo en el equipo del
+  propietario) y se borra del repositorio. Se apunta aquí con el último commit
+  que lo contiene: `git show <commit>:<ruta>` lo recupera.
+- **Archivados el 2026-10-05** (último commit: `da7c643`):
+
+  | Ruta | Por qué |
+  | --- | --- |
+  | `backend/backend.md` | Duplicaba `backend/README.md` en inglés; decía que el backend era privado y describía la demo antigua (lista blanca de rutas) |
+  | `backend/README.md` | 442 líneas de arquitectura repetidas en `docs/`; sustituido por un README corto |
+  | `frontend/README.md` | 877 líneas con Next 14 / React 18 y la demo antigua; sustituido por un README corto |
+  | `backend/db-mysql/MIGRATION_GUIDE.md` | Mandaba instalar con `MASTER_INSTALL.sql` a mano, que falla desde cero; lo sustituye `pnpm setup:local` (ADR-039) |
+  | `frontend/messages/cmd.md` | Una línea con un comando de búsqueda |
+  | `frontend/app/dashboard/conciliation/nota.md` | Idea sin hacer: una descripción obligatoria en cada entrada de la conciliación (habitaciones OOO que restan) |
+
+- **Motivo:** el repositorio va a ser público; un documento con datos falsos
+  confunde más que su ausencia, y los README largos repetían `docs/` sin
+  mantenerse.
+- **Rechazado:** actualizarlos en el sitio. Era más trabajo y seguían
+  duplicando `docs/general`.
+- **Consecuencias:** los documentos del proceso de publicación (`GITCLEAN.md`,
+  `VERIFY.md`, `ROADMAP.md`, `SESSION.md`) se archivan igual cuando el
+  repositorio sea público.
diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
@@ -55,17 +55,19 @@ Historial de `main` y `claude/compassionate-planck-gh6aof` reescrito y auditado
 ## Fase 4 — Publicación ← **actual**
 
 El historial limpio está en `bpstack/four-points`, todavía privado; Vercel y
-Render despliegan desde él y el original está archivado. Pasar a público (con
-secret scanning y push protection) espera a la demo de la fase 5 (ADR-037). La
-rotación de credenciales (ADR-007) no bloquea: va en «Después de publicar» de
-`TODO.md`.
+Render despliegan desde él y el original está archivado. La demo de la fase 5
+ya está en producción, así que solo falta pasarlo a público y activar secret
+scanning y push protection. Comprobado el 2026-10-05: ningún valor de
+`backend/.env` aparece en los 662 commits de todas las ramas, salvo dos valores
+públicos por defecto (el usuario `avnadmin` de Aiven y `localhost:11434` de
+Ollama). La rotación de credenciales (ADR-007) no bloquea: va en «Después de
+publicar» de `TODO.md`.
 
-## Fase 5 — Demo pública
+## Fase 5 — Demo pública ✅ cerrada (2026-10-05)
 
 Que cualquiera pruebe la aplicación en la propia web, que es solo un escaparate
 (ADR-037): un admin demo restringido que entra con un botón, datos ficticios,
 generación de horarios y reinicio diario; y quien quiera verlo todo lo instala
-en local con admin completo (ADR-038, ADR-039). Hecho en código y probado en
-preview el 2026-10-05; lo que falta, en `TODO.md`, «Demo pública en la propia
-web: lo que falta». El repositorio se hace público cuando la demo esté en
-producción.
+en local con admin completo (ADR-038, ADR-039). En producción desde el
+2026-10-05 (PR #3 y #4, `DEMO_MODE` en Render y Vercel), probada en preview y
+en la web.