<!--
===============================================================================
  PLANTILLA DE CLAUDE.md
===============================================================================

  CÓMO SE USA
  1. Copia este archivo a la raíz de tu proyecto y renómbralo a  CLAUDE.md
  2. Llena los bloques de abajo.
  3. BORRA TODOS LOS COMENTARIOS COMO ESTE antes de guardar.
     Se cargan en cada sesión: son tokens y son ruido.

  DÓNDE VA
  - ~/.claude/CLAUDE.md        se carga en TODAS tus sesiones. Va lo TUYO.
    (Windows: C:\Users\TU-USUARIO\.claude\CLAUDE.md)
  - CLAUDE.md en el proyecto   se carga solo ahí. Va lo del PROYECTO.

  LA REGLA PARA NO EQUIVOCARTE
  Lee la frase que ibas a escribir.
  Empieza con "yo..."             -> global
  Empieza con "este proyecto..."  -> del proyecto

  LARGO
  Una o dos pantallas. Esto se carga entero en cada sesión.
  Si crece más, lo que crece son fichas de memoria, no este archivo.

  Los ejemplos usan dos negocios inventados: "Café Lima" (cafetería) y
  "Clínica Norte". Bórralos.
===============================================================================
-->

# NOMBRE DEL PROYECTO

<!--
  BLOQUE 0 — QUÉ ES ESTO. Tres líneas, no más.
  Qué es, para quién, y en qué estado está hoy.
  Sin esto, Claude asume que todo proyecto es un MVP nuevo.
-->

Bot de pedidos por WhatsApp de **Café Lima**, una cafetería con dos locales.
En producción desde agosto de 2026, con pedidos reales entrando todos los días.
**No es un prototipo: lo que se rompe aquí, se rompe delante de un cliente.**

---

## Dónde vive la memoria

<!--
  BLOQUE 1 — EL QUE CONECTA TODO.
  Sin estas dos líneas, tienes una carpeta de fichas que no lee nadie.
  Ajusta la ruta a donde de verdad pusiste la carpeta.
-->

La memoria de este proyecto está en `.claude/memoria/`.

**Antes de empezar a trabajar, lee `.claude/memoria/MEMORY.md`** y abre las fichas
que tengan que ver con lo que te pedí. Las marcadas `[LEER PRIMERO]` se leen siempre.

Cuando cerremos algo que valga la pena recordar, escribe una ficha nueva ahí
y enlázala en el índice.

---

## Qué NUNCA hacer

<!--
  BLOQUE 2 — EL MÁS RENTABLE, Y EL QUE CASI NADIE ESCRIBE.
  No es una lista de buenas prácticas de internet.
  Son las cosas concretas que YA PASARON y te dieron rabia.
  Cada vez que tengas que decir "no, eso no", aquí va una línea.
  Empieza con dos. Crece solo.
-->

- **NUNCA borres ni reescribas una migración que ya corrió.** Se agrega una nueva.
- **NUNCA toques nada de la carpeta `facturacion/` sin avisarme primero.**
- **NUNCA mandes un mensaje de prueba a un número real.** Los de prueba están
  en `docs/numeros-de-prueba.md`.
- **NUNCA cambies el esquema de la base sin migración**, aunque sea un campo.
- **NUNCA des por desplegado algo sin verificarlo.** Si no lo comprobaste, dilo.

---

## Cómo se llama cada cosa

<!--
  BLOQUE 3 — VOCABULARIO.
  Si dos palabras que para ti son distintas Claude las usa como sinónimos,
  vas a corregir lo mismo cada semana.
  Van aquí: las que se confunden, y las que suenan igual pero no lo son.
-->

- **Pedido** = lo que el cliente pide por WhatsApp. Tabla `pedidos`.
- **Comanda** = lo que sale impreso a la cocina. Tabla `comandas`.
  **No son lo mismo.** Un pedido puede generar dos comandas.
- **Local** = punto de venta físico. Hay dos. Nunca "sucursal", nunca "sede".
- **Cliente** = quien compra. **Usuario** = quien entra al panel de administración.
- Todo lo que se muestra al cliente va en español de Perú. Los nombres en el
  código van en inglés. No se mezcla en el mismo archivo.

---

## Qué ya está decidido

<!--
  BLOQUE 4 — LO QUE NO SE VUELVE A DISCUTIR.
  Sin esto, cada dos semanas te vuelve a proponer lo que ya descartaste
  y tú vuelves a explicar por qué no.
  Escribe la decisión Y el porqué. Una decisión sin porqué se rompe sola.
-->

- **La agenda es Google Calendar.** Ya se evaluó hacer una propia y se descartó:
  el personal ya la usa desde su teléfono y no vamos a enseñarles otra cosa.
- **Los pagos son contra entrega.** No hay pasarela y no se va a integrar
  este año. No propongas integrarla.
- **El panel es una sola página.** No hay framework, es a propósito: lo mantiene
  una persona sola.
- **No hay aplicación móvil.** Es una web que se abre en el teléfono. Decidido
  en agosto de 2026 y sigue en pie.

---

## Comandos reales de este proyecto

<!--
  BLOQUE 5 — LO QUE DE VERDAD SE EJECUTA.
  Claude va a adivinar "npm test" si no se lo dices, y en la mitad de los
  proyectos eso no existe o hace otra cosa.
  Pega los que usas tú, con los que se llevan trampa marcada.
-->

```
npm run dev        # levanta local en el puerto 3000
npm test           # la suite entera, ~40 s
npm run desplegar  # produccion. PREGUNTA ANTES DE CORRERLO.
```

- Las pruebas **no corren en paralelo**: comparten base de datos y se pisan.
- Después de desplegar, la primera petición tarda. No es un error.

---

## Quién decide qué

<!--
  BLOQUE 6 — DÓNDE PARAR.
  Esto es lo que evita que Claude "resuelva" algo que no le tocaba.
  Es el bloque que más se agradece cuando el proyecto crece o entra alguien más.
-->

- **Precios, textos de cara al cliente y promociones:** los decide el dueño.
  Si hace falta cambiar uno, propónmelo; no lo cambies tú.
- **Esquema de base de datos y despliegues a producción:** se me pregunta antes.
- **Nombres de variables, estructura del código, refactors internos:** decide tú
  y sigue.
- **Si una decisión te parece equivocada:** dilo antes de ejecutarla, no después.

---

## Cómo quiero que trabajes

<!--
  BLOQUE 7 (OPCIONAL) — EL TRATO.
  Si esto vale para todos tus proyectos, va en el GLOBAL (~/.claude/CLAUDE.md),
  no aquí. Se repite abajo solo para que veas la forma.
-->

- Si no estás seguro, dilo. No rellenes con algo que suene bien.
- Cuando afirmes que algo funciona, di cómo lo comprobaste.
- Cambios chicos y verificables, no reescrituras grandes.
- Si te pido algo que choca con una regla de arriba, avísame antes de hacerlo.

---

<!--
===============================================================================
  QUÉ NO METER NUNCA EN ESTE ARCHIVO

  Este archivo se sube al repositorio por defecto y aparece en cualquier
  captura de pantalla que hagas de tu editor.

  - Claves, tokens, contraseñas, cadenas de conexión.
  - Teléfonos, correos o documentos de terceros.
  - Números del negocio que no querrías ver en pantalla compartida.

  Lo que sí va es el NOMBRE de la variable, nunca su valor:

      La clave del proveedor de pagos está en .env como PAGOS_API_KEY.
      Nunca la pegues en un archivo ni la imprimas en consola.

  Y .env en el .gitignore, antes del primer commit.
===============================================================================
-->