Panel de administración

---
name: panel-de-administracion
description: la pantalla donde tú arreglas lo que el usuario rompió.
---

# Panel de administración

Instrucciones para el agente que está construyendo esta app. Sigue esta skill cuando
construyas listas, filtros, edición de registros o acciones peligrosas con confirmación
para el equipo, no para el usuario final.

## Cuándo usar esta skill

Actívala en cuanto se cumpla cualquiera de estas condiciones:

- Ya tienes usuarios reales y alguien va a escribir pidiendo ayuda.
- Hay estados que a veces se tienen que corregir a mano: pagos, invitaciones, límites.
- Necesitas ver el detalle de una cuenta sin hacer consultas SQL directas.
- Alguien no técnico del equipo tiene que revisar o moderar contenido.

El panel no es el producto, es la herramienta que te permite operar el producto. Sin él
terminas entrando a la base de datos a mano un domingo.

## Cómo construirla

Usa este stack salvo que el proyecto ya tenga otro decidido: rutas `/admin` dentro de la
misma app, protegidas por rol, tablas con **TanStack Table** o un componente de datos de
**shadcn/ui**, paginación por cursor.

1. Vive dentro de la app y detrás de un rol admin. Un segundo proyecto (Retool, Forest
   Admin) es un segundo despliegue que nadie mantiene y otra copia de tus permisos que
   sincronizar.
2. Empieza por dos vistas: lista de usuarios con búsqueda, y detalle de un usuario con
   todo lo suyo en una página.
3. Pagina por cursor (`WHERE id > último ORDER BY id LIMIT n`), no por `OFFSET`, y
   limita las columnas. Un panel que carga 50 mil filas es un panel que nadie abre.
4. Cada acción destructiva pide confirmación escrita y queda registrada con autor y
   fecha.
5. Agrega las tres o cuatro acciones que de verdad haces: reenviar invitación, extender
   prueba, cerrar sesiones, exportar datos.
6. Suplantar usuario (impersonate) solo con registro visible y sesión corta.

## En qué te vas a trabar

- **El panel es la superficie más peligrosa de la app:** una ruta admin sin verificación
  de rol entrega todo. Verifica el rol en el servidor, no solo en la UI.
- **Construir un panel genérico configurable cuesta más que las cinco pantallas que
  realmente necesitas.** No lo generalices antes de tiempo.
- **Exportar datos personales desde el panel también es un asunto de privacidad**, no
  solo un botón. Registra quién exportó qué.

## Criterio de terminado

No declares el panel listo hasta que una cuenta sin rol admin reciba 403 al entrar por
URL directa, la paginación aguante una tabla con decenas de miles de filas sin
lentitud, y cada acción destructiva quede registrada con autor y fecha.