# Fermenty — Índice de la documentación

> La **puerta de entrada**. Qué es cada documento, en qué orden leerlos, y el estado del
> proyecto. Si eres una sesión nueva (o una persona nueva), empieza aquí.
>
> Foto de estado: **2026-07-25**. Los hitos cerrados se listan abajo (son estables); la
> cola viva de pendientes NO se enumera aquí —para que este índice no se pudra—: vive en
> la **memoria del proyecto** y en los `*_Deuda.md` / briefings.

---

## El proyecto en cuatro líneas

1. **Fermenty** es un mentor de fermentación (kombucha primero, el resto son casos degenerados): formula lo que quieres, **acompaña durante** la tanda, y **explica cómo salió**.
2. **Hecho:** el motor entero (`App\Mentor`) y el mentor incorporado — formular (ciclo de borrador), corte F1→2F, cierre del lazo (corte × valoración), y el bucle 1 (la cata mueve la ventana). ~167 tests en verde.
3. **Pendiente:** el bucle 2 (calibración entre tandas — antes hay que decidir §3 de `Cierre_del_lazo.md`), el flujo de cultivo/arrancador, orden de producción ≠ tanda, y el port a **Flutter**.
4. **Tres superficies, un solo Laravel:** ERP web (`erp.*`), PWA de simulación (`app.*`), API (`api.*` `/v1`). Ruteo por host en `bootstrap/app.php`.

---

## Por dónde empezar (orden de lectura)

1. **Este índice** — orientación y estado.
2. **`Lexico.md`** — el vocabulario del dominio: qué significa cada palabra, qué **no**, y dónde vive. Todo lo demás asume estos términos. *Empieza aquí para entender el sistema.*
3. **`00_PROJECT_OVERVIEW.md`** — la referencia técnica: stack, ruteo por host, directorios, estado. *Empieza aquí para tocar el código.*
4. **`Matematica_Motor.md`** — la matemática del motor (la verdad calculable; la tabla dorada de los tests).
5. Según lo que toques: `Cierre_del_lazo.md` (cierre + calibración), `Backtest.md` (contraste), `El_Mentor_Incorporado_v0.8.md` (la visión/porqué), `Simulacion_UI.md` (el flujo y sus huecos).

---

## Los documentos, por familia

Estado: ✅ referencia viva · 🟡 vigente con reservas · 🔜 deuda abierta · ⚠ obsoleto/superado · 🗄 histórico («cómo se llegó aquí»).

### Referencia viva — el dominio y el motor
| Doc | Qué es | |
|---|---|---|
| `Lexico.md` | El catálogo de términos del dominio y su sitio en el esquema | ✅ |
| `Matematica_Motor.md` | La matemática entera del motor, extraída del prototipo | ✅ |
| `afinador.py` · `backtest.py` | Transcripción ejecutable del motor y del contraste (producen la tabla dorada) | ✅ |
| `Backtest.md` | Contraste del modelo contra 6 recetas del obrador (LIRONA) | ✅ |
| `Cierre_del_lazo.md` | Diseño del cierre del lazo y la calibración; §2 y bucle 1 hechos, §3 y bucle 2 abiertos | ✅ |

### Referencia técnica y operativa
| Doc | Qué es | |
|---|---|---|
| `00_PROJECT_OVERVIEW.md` | Stack, ruteo por host, directorios, estado actual | ✅ |
| `Runbook_Operaciones.md` | Backup, dumps, permisos, migración inmutable | ✅ crítico |
| `MOBILE_API_PLANNING.md` | Plan e inventario de la API móvil (núcleo construido) | 🟡 |
| `APP_DEVELOPMENT_PROCESS.md` | El flujo web→app→Flutter | ✅ |
| `MAIL_SERVER_SETUP.md` | Correo (Mailpit local, Resend prod pendiente) | 🟡 |
| `API_USAGE_ANALYTICS.md` | Panel de analítica de uso del API (`/acp/api`) | ✅ |
| `Reproducibilidad_y_Aplanado.md` | Restricción del aplanado final de migraciones (aún no hecho) | 🔜 |

### Producto y diseño
| Doc | Qué es | |
|---|---|---|
| `El_Mentor_Incorporado_v0.8.md` | Documento fundacional (visión/porqué); §5 con nota de reconciliación (cuatro ejes) | ✅ |
| `Simulacion_UI.md` | El guion del flujo con 20 huecos; 9 cerrados por el arco del motor (ver su tabla §3) | ✅ |
| `Design-Mentor presence-msg.md` | El sistema de voz/mensajes del mentor (nota silenciosa vs tarjeta) | ✅ |
| `TAREAS_PRIORIZADAS.md` | Backlog de features web | 🟡 varios abiertos |
| `MEJORAS_ERP.md` | Roadmap ERP; su §3 (escalado con quantity) superado por el motor | 🟡 |
| `APP_FLOW.md` · `DESIGN_BRIEF_FOR_CLAUDE_DESIGN.md` | Flujo/pantallas de la sim móvil — **pre-motor**, sin reconciliar con el mentor | 🟡 |

### Deudas con vencimiento (pendientes)
| Doc | Qué es | |
|---|---|---|
| `FaseA_Afinador_Deuda.md` | Deuda de la Fase A (reabrir borrador, reformular nivel 3, pH de arranque, traducciones) | 🔜 |
| `Paso2_Deuda_Contenido_Guias.md` | Contenido de las 3 guías «flacas» a rellenar | 🔜 |
| `Paso3_Deuda.md` · `Paso4_Deuda.md` · `Paso6_Deuda.md` | Deudas de los pasos 3/4/6 (favoritos, capa social, alias `ferment_type`) | 🔜 |

### Legal y marketing
| Doc | Qué es | |
|---|---|---|
| `GOOGLE_PLAY_LEGAL_CHECKLIST.md` | Checklist legal Play Store (NIF/CIF pendiente) | 🟡 |
| `PREMIUM_LANDING_COPY.md` | Copy de la landing «¿Por qué Premium?» | ✅ |
| `marketing/mails1.md` | Emails de preaviso del lanzamiento (7-jul, fecha pasada) | 🗄 |

### Datos / esquema
| Doc | Qué es | |
|---|---|---|
| `DATABASE_ERM.md` | ERM de la base de datos — **PRE-refactor** (FermentType vivo, versionado): describe un esquema que ya no existe | ⚠ **regenerar** |
| `fermenty_blog_erd.html` | ERD del subsistema de blog (datos reales, independiente del motor) | ✅ |
| `api-doc.html` | Documentación HTML de la API (puede estar desincronizada) | 🟡 |

### Histórico — «cómo se llegó aquí» (no referencia viva)
Briefings ejecutados y diseños superados por el refactor del motor. Se conservan por su
razonamiento, pero **no describen el estado actual**:
`Plan_Pasos.md` (numeración de los pasos, ya hechos) · `Briefing_ClaudeCode_Paso1_Clasificaciones.md` ·
`Briefing_ClaudeCode_Reconciliar_Afinador.md` (superado por `Matematica_Motor.md`) ·
`RECIPE_LAYER_DESIGN.md` (capa Recipe pre-motor, con FermentType — superado por `Lexico.md`) ·
`Content-Listing.md` · `api_plan.md` (superado por `MOBILE_API_PLANNING.md`).

---

## Cómo se mantiene este índice

- **Los hitos cerrados se listan** (son estables). **La cola de pendientes se apunta** a la memoria del proyecto y a los `*_Deuda.md` / briefings (es lo que cambia). Todo estado incluido lleva **fecha de foto**.
- Un doc de referencia que miente sobre su estado es peor que no tenerlo: cuando el código avance y un `🔜` deje de ser cierto, se reconcilia el doc **y** su línea aquí.
- **Huecos de documentación conocidos** (temas sin doc de referencia): el ERM vigente post-motor (el actual es pre-refactor), un contrato de API único, y el briefing de calibración/bucle 2 (`Cierre_del_lazo.md §3` deja la decisión abierta).