Admin (@tedos/admin)
The admin is the operator's primary surface — where the operator runs each client's project.
It is a two-level shell: the same chrome wraps both levels, and the level swaps only the
sidebar + topbar slots (composition, not a boolean variant). Deployed on Vercel at
app.tuempresa.digital.
The two levels
| Level | Routes | What |
|---|---|---|
| Level 1 — platform | /projects, /inicio, … | Pick or create a project (the project switcher). The platform-wide surface. |
| Level 2 — project context | /p/[projectId]/… | A project's context — swaps in the project sidebar, sets the org context, and renders role-scoped nav. |
At Level 2, a Clerk org membership maps to a project role (Owner · Sales · Finanzas · Soporte · Alumno); the role gates which nav and screens appear. The operator is superadmin (any project). See Product SoR → Roles.
Screens (E1)
The first product slice shipped these screens on the existing design system:
/projects— the Level-1 project switcher.- Alumnos — the project's people list (search + channel filter).
- Person single-view — identity header, channel records, masked fiscal data, an enrollments placeholder.
- Resumen — a basic project summary (metric cards).
Each screen ships the four mandatory states (loading / empty / error / success) and follows the admin conventions. See Design system.
Data flow
The admin reads the product API (apps/api) through a server-side proxy, so the Clerk session
- tenant context inject on the server and the tenant scope is never trusted from the client. The
admin and the API both import the frozen
@tedos/sharedcontract, so request/response shapes match by construction. See api and Product SoR.
Dev-workflow surfaces
The admin also hosts the Plan Engine views — /plan (editable plan tree), /roadmap
(timeline), and /work (where-we-stand) — over the dev-workflow graph. These are operator-only,
internal surfaces. See Plan Engine.
Design system
The admin's design system (tokens, shell, components/ui primitives, and shared screen views)
lives in @tedos/admin-ui. The admin's accent hue is Cian, exclusive to the admin. See
Design system and Color scope.