Documentación técnica
Monorepo con backend NestJS, frontend Next.js y tipos compartidos, desplegado con Docker sobre dos servidores Debian. Esto es lo que hay:
Estas cifras se recuentan en cada build a partir del código, así que no envejecen.
Por dónde empezar
- Visión general de la arquitectura — cómo viaja un mensaje desde WhatsApp hasta la respuesta.
- Entorno local — levantar el proyecto en tu máquina.
- Cómo se mantiene esta documentación — léelo antes de escribir aquí.
Mapa
| Sección | Contenido |
|---|---|
| Empezar | Entorno local, convenciones y cómo documentar |
| Arquitectura | Visión general, backend, frontend, bots y canales |
| Referencia | API, pantallas, tipos y variables de entorno (todo generado) |
| Datos | Esquema, migraciones y copia de producción a test |
| Seguridad | RLS, permisos y cómo auditar antes de tocar lo que ya existe |
| Operaciones | Despliegue, CI/CD, runbooks y problemas conocidos |
| Decisiones | Por qué las cosas son como son |
Interno
Este sitio está detrás de Cloudflare Access y no debe compartirse fuera del equipo. Aun así, aquí no van secretos: ni contraseñas, ni tokens, ni llaves. Solo nombres de variables y dónde obtener su valor.