Admin (@tedos/admin)
El admin es la superficie principal del operador — donde el operador opera el proyecto de cada
cliente. Es un shell de dos niveles: el mismo chrome envuelve ambos niveles, y el nivel
intercambia solo los slots de sidebar + topbar (composición, no una variante booleana).
Desplegado en Vercel en app.tuempresa.digital.
Los dos niveles
| Nivel | Rutas | Qué |
|---|---|---|
| Nivel 1 — plataforma | /projects, /inicio, … | Elige o crea un proyecto (el selector de proyectos). La superficie de toda la plataforma. |
| Nivel 2 — contexto de proyecto | /p/[projectId]/… | El contexto de un proyecto — intercambia el sidebar del proyecto, fija el contexto de la org y renderiza navegación restringida por rol. |
En el Nivel 2, una membresía de org de Clerk mapea a un rol de proyecto (Owner · Sales · Finanzas · Soporte · Alumno); el rol restringe qué navegación y pantallas aparecen. El operador es superadmin (cualquier proyecto). Ver SoR del producto → Roles.
Pantallas (E1)
La primera slice de producto entregó estas pantallas sobre el sistema de diseño existente:
/projects— el selector de proyectos del Nivel 1.- Alumnos — la lista de personas del proyecto (búsqueda + filtro por canal).
- Vista única de persona — cabecera de identidad, registros por canal, datos fiscales enmascarados, un placeholder de inscripciones.
- Resumen — un resumen básico del proyecto (tarjetas de métrica).
Cada pantalla entrega los cuatro estados obligatorios (cargando / vacío / error / éxito) y sigue las convenciones del admin. Ver Sistema de diseño.
Flujo de datos
El admin lee la API de producto (apps/api) a través de un proxy del lado del servidor, de modo
que la sesión de Clerk + el contexto de tenant se inyectan en el servidor y el alcance de tenant
nunca se confía del cliente. El admin y la API importan ambos el contrato congelado @tedos/shared,
así que las formas request/response coinciden por construcción. Ver api y
SoR del producto.
Superficies del flujo de trabajo
El admin también aloja las vistas del Plan Engine — /plan (árbol de planes editable),
/roadmap (timeline) y /work (dónde-estamos) — sobre el grafo del flujo de trabajo. Son
superficies internas, solo para el operador. Ver Plan Engine.
Sistema de diseño
El sistema de diseño del admin (tokens, shell, primitivos components/ui y vistas de pantalla
compartidas) vive en @tedos/admin-ui. El matiz de acento del admin es Cian, exclusivo del
admin. Ver Sistema de diseño y Alcance de color.