Pupo
Documentación interna del panel administrativo Pupo.
Qué es Pupo
Pupo es el panel de administración de Anfibia. Consta de dos proyectos (repos separados):
auth-panel— backend: NestJS + tRPC + MikroORM + PostgreSQL.auth-panel-front— frontend: React 19 + Vite + TanStack, deployado en Cloudflare Pages.
La autenticación está delegada en el servicio centralizado ajolote (better-auth). El panel no emite sesiones propias: valida los JWT que emite ajolote. Ver Autenticación.
URLs
| Entorno | Frontend | Rama | Backend | ajolote |
|---|---|---|---|---|
| Producción | https://pupo-panel.pages.dev | master | https://pupo.anfibia.io | público (DigitalOcean) |
| Desarrollo / Pre | https://dev.pupo-panel.pages.dev | dev | https://pupo-pre.anfibia.io | Tailscale-only (100.64.x) |
Cada entorno es una copia corriendo completa del stack (front + back + DB + ajolote), con el mismo código desplegado dos veces y distinto set de variables. Ver Entornos.
Arquitectura
Secciones
- Entornos — separación pre/prod: base de datos, Redis, ramas y matriz de variables.
- Autenticación — flujo de login con ajolote y el reverse-proxy
/api/authpara pre. - Deploy — configuración de Dokploy (backend) y Cloudflare Pages (frontend), + troubleshooting.