El panel de administración
Rustango genera una interfaz de administración completa a partir de tus modelos —
un backoffice listo para explorar y editar tus datos, pero con
cero código repetitivo por modelo. Añade #[derive(Model)], monta el admin una
vez, y cada modelo obtiene una vista de lista con búsqueda, filtros, ordenación,
paginación y acciones masivas; un formulario de creación/edición agrupado en conjuntos
de campos; edición inline de hijos; un registro de auditoría por fila; y una referencia
de modelos en vivo. Todo lo que sigue se configura de forma declarativa en un bloque
admin(...) sobre el derive, o con un puñado de métodos del Builder y macros de
registro a nivel de módulo.
Fuente:
rustango::admin(las opciones del deriveadmin(...), la API delBuildery las macros de registro) — tras la característicaadmin(activada por defecto).Versión ejecutable: cada característica de esta página se ejercita en un ejemplo probado y compilable en
crates/rustango/examples/admin_demo. Las capturas de esta página provienen de ese ejemplo. Si un fragmento parece extraño, compáralo con él.
¿Un término aquí es nuevo para ti? model, fieldset, audit trail — consulta el glosario.
Tabla de contenidos
- Montarlo · La página de inicio
- Configurar un modelo: el bloque
admin(...) - La vista de lista — columnas, búsqueda, filtros, jerarquía de fechas, ordenación, paginación
- El formulario de cambio — conjuntos de campos, widgets, edición de FK, campos precompletados y de solo lectura
- Inlines · Acciones masivas · Registro de auditoría
- Columnas calculadas y filtros personalizados
- Vistas, querysets y permisos personalizados
- Autenticación · Temas y marca
- Referencia del
Builder· Referencia de rutas - La referencia de modelos (
__docs) · Prueba el ejemplo
Montarlo
El admin está abierto por defecto. Descubre y sirve todos los modelos automáticamente — listar, crear, editar, eliminar — sin autenticación hasta que la añadas. No lo expongas públicamente antes de conectar el inicio de sesión: consulta Autenticación más abajo.
El admin es un axum::Router que construyes a partir de un pool de base de datos y
anidas bajo una ruta:
use rustango::admin;
let admin_router = admin::Builder::new(pool.clone())
.title("Admin Demo")
.subtitle("rustango auto-admin showcase")
.admin_prefix("/admin") // MUST match the nest path below
.build();
let api = axum::Router::new().nest("/admin", admin_router);
El auto-admin descubre cada #[derive(Model)] de tu binario automáticamente a
través del registro inventory — no registras los modelos uno por uno. Abre
http://localhost:8080/admin y aparecen agrupados en la barra lateral.
admin_prefixdebe coincidir con la ruta de anidamiento. El admin construye sus enlaces y acciones de formulario a partir deadmin_prefix(por defecto/__admin). Si anidas en/adminpero dejas el prefijo por defecto, cada enlace devuelve 404. Ajústalos al mismo valor.
Vincular el registro. El registro de inventory solo se vincula al binario final si los tipos de modelo se referencian en algún lugar. Un crate de biblioteca cuyos modelos no se usan de otro modo puede necesitar un empujón con
let _ = std::any::type_name::<Post>();enmain(el ejemplo lo hace) — de lo contrario el enlazador los descarta y nunca aparecen.
La página de inicio
La raíz del admin (GET /<prefix>) lista cada modelo registrado, agrupado por app, con
el nombre de tabla y el recuento de campos de cada modelo — más un feed de Recent
actions con los cambios auditados más recientes.
Configurar un modelo: el bloque admin(...)
Todo lo relativo a cómo aparece un modelo se establece en un bloque admin(...) sobre
el derive. Aquí tienes el Post de exhibición del ejemplo, que ejercita casi todos los
controles:
#[derive(Model, Clone, Debug)]
#[rustango(
table = "posts",
display = "title",
admin(
list_display = "id, title, author_id, status, view_count, published_at",
list_display_links = "id, title",
list_filter = "status, author_id",
search_fields = "title, body",
search_help_text = "Search posts by title or body",
ordering = "-published_at",
list_per_page = 10,
date_hierarchy = "published_at",
fieldsets = "Content: title, body, status | Publishing: author_id, published_at, view_count",
actions = "publish, archive",
),
audit(track = "title, body, status"),
)]
pub struct Post { /* … */ }
display = "title" (en el modelo, fuera de admin(...)) establece la etiqueta legible
que se usa allí donde se referencia una fila — columnas FK en las listas de otros
modelos, la miga de pan, el título de la página de detalle.
Cada opción de admin(...)
| Clave | Ejemplo | Qué hace |
|---|---|---|
list_display | "id, title, status" | Columnas mostradas en la lista, en orden. Las columnas FK renderizan el valor display del objetivo. Las columnas calculadas (ver abajo) pueden nombrarse aquí. Vacío = cada campo escalar. |
list_display_links | "id, title" | Qué celdas de list_display enlazan a la página de detalle. Debe ser un subconjunto de list_display. |
list_filter | "status, author_id" | Tarjetas de faceta en el panel derecho — valores distintos + recuentos, clic para filtrar. Funciona en columnas escalares y FK. |
search_fields | "title, body" | Campos que coincide el cuadro de búsqueda ?q= (ILIKE/LIKE insensible a mayúsculas). |
search_help_text | "Search by title" | Leyenda renderizada junto al cuadro de búsqueda. |
ordering | "-published_at, id" | Orden por defecto. Prefijo - = DESC; sin él = ASC. Varias claves separadas por comas. |
list_per_page | 10 | Tamaño de página (por defecto 50). |
date_hierarchy | "published_at" | Franja de desglose año → mes → día sobre la lista, en una columna Date/DateTime. |
fieldsets | "Content: title, body | Meta: status" | Agrupa el formulario de cambio en secciones con título. La barra vertical | separa secciones, la coma separa campos; la leyenda Title: es opcional. |
actions | "publish, archive" | Acciones masivas ofrecidas en el selector de acciones de la lista (cada una necesita un manejador registrado — ver Acciones masivas). |
readonly_fields | "created_at" | Campos renderizados como texto (sin entrada) en el formulario de cambio. |
raw_id_fields | "author_id" | Campos FK editados mediante una entrada de id sin procesar + un enlace de búsqueda (bueno para tablas objetivo grandes). |
autocomplete_fields | "author_id" | Campos FK editados mediante un autocompletado Ajax respaldado por el endpoint __autocomplete del objetivo. |
prepopulated_fields | "slug:title" | Autocompleta un campo sluggificando otro mientras escribes (target:source; combina fuentes con +). |
list_select_related | "all" / "none" / "author_id" | Controla el JOIN automático de columnas FK en la consulta de lista. "all" (por defecto) une cada FK; "none" lo desactiva; un CSV lo restringe a los FK nombrados. |
formfield_overrides | "status:textarea" | Sobrescribe el widget de formulario de un campo (field:widget) — ver la tabla de widgets. |
actions_on_top | true | Renderiza la barra de acciones masivas sobre la lista (por defecto true). |
actions_on_bottom | false | Renderiza una segunda barra de acciones bajo la lista (por defecto false). |
La vista de lista
GET /<prefix>/<table> renderiza la lista. A partir del único bloque admin(...) de
arriba obtienes columnas ordenables, un cuadro de búsqueda con texto de ayuda, las
tarjetas de faceta de estado/autor con recuentos en vivo, el desglose de fechas,
paginación a 10/página y el selector de acciones publish/archive.
Filtrado. Haz clic en cualquier valor de una tarjeta de faceta list_filter para
acotar la lista; el filtro activo se muestra como un chip con un enlace clear, y el
recuento de filas y los recuentos de facetas se actualizan. Los filtros, la búsqueda, la
ordenación y la jerarquía de fechas se componen todos en la cadena de consulta y pueden
combinarse. ?<field>= solo funciona sobre una columna de list_filter, mostrada, FK o
padre de inline, nunca sobre una secreta, y ?<field>__isnull=1 lista las filas NULL,
?<field>__isempty=1 las de texto vacío.
Una tarjeta de faceta muestra hasta 15 valores; el resto se agrupa en un enlace
"+N more" (?facet_show_all=<field>), que lista como máximo 200.
Ordenación. Haz clic en un encabezado de columna para ordenar; clic de nuevo para
invertir la dirección (?sort=col&order=asc|desc). El valor por defecto proviene de
ordering.
Paginación. list_per_page establece el tamaño de página; navega con ?page=N.
Una página más allá de la fila 100 000 (lista y registro de auditoría) responde 400; acota con búsqueda o filtros.
Para tablas muy grandes, regístralas con Builder::skip_count_for([...]) para omitir el
SELECT COUNT(*) (el paginador muestra entonces "Page N" sin un total general); un
?count=skip por petición hace lo mismo de forma ad hoc. Esa tabla tampoco
muestra las facetas de list_filter ni los tramos de la jerarquía de fechas (solo
queda la ruta de navegación), porque cada uno lee toda la tabla.
Búsqueda. Cuando search_fields está configurado, aparece un cuadro de búsqueda y
coincide esos campos con ILIKE (PostgreSQL) / LIKE (MySQL, SQLite).
search_help_text se renderiza como su leyenda.
Jerarquía de fechas. Con date_hierarchy configurado, una miga de pan año → mes →
día se sitúa sobre la tabla; profundizar añade filtros de rango semiabierto en esa
columna usando extracción de fechas tri-dialecto (PostgreSQL EXTRACT, MySQL, SQLite
strftime).
El formulario de cambio
GET /<prefix>/<table>/new (crear) y GET /<prefix>/<table>/<pk>/edit (editar)
renderizan el formulario. fieldsets agrupa las entradas en secciones con título; sin
él, todos los campos editables aparecen en un solo bloque.
Enviar un formulario valida la entrada, escribe la fila, registra una entrada de
auditoría y redirige a la vista de detalle de solo lectura
(GET /<prefix>/<table>/<pk>), que muestra cada campo más los inlines y la tarjeta de
auditoría (abajo). Los botones Edit y Delete de la página de detalle llevan al
formulario y a la confirmación de eliminación.
Widgets de formulario
Cada campo renderiza por defecto una entrada que coincide con su tipo —
<input type="number"> para enteros, type="date"/datetime-local para fechas,
type="checkbox" para booleanos, un <textarea> para cadenas largas, un <select>
para columnas FK, y así sucesivamente. Sobrescribe por campo con
formfield_overrides = "field:widget":
| Widget | Se aplica a | Renderiza |
|---|---|---|
textarea | String | <textarea> multilínea |
password | String | <input type="password"> |
email | String | <input type="email"> |
url | String | <input type="url"> |
color | String | <input type="color"> |
slug | String | entrada de texto con patrón de slug |
ipaddress | String | entrada de texto con patrón de IP |
json | Json | <textarea> monoespaciado |
hidden | cualquiera | <input type="hidden"> |
Editar claves foráneas
Las columnas FK tienen tres modos de edición:
- Por defecto — un
<select>poblado desde la tabla objetivo, que muestra el valordisplayde cada fila. raw_id_fields— una entrada de id simple más un enlace de búsqueda; ideal cuando la tabla objetivo es demasiado grande para enumerarla en un desplegable.autocomplete_fields— un autocompletado Ajax que consulta lossearch_fieldsdel modelo objetivo medianteGET /<prefix>/<target>/__autocomplete?q=….
Campos precompletados y de solo lectura
prepopulated_fields = "slug:title" emite JS del lado del cliente que sluggifica el
campo fuente en el destino mientras escribes (combina varias fuentes con +, por
ejemplo "slug:section+title"). readonly_fields renderiza los campos nombrados como
texto escapado en el formulario en lugar de como entradas.
Inlines
Los inlines muestran las filas de un modelo hijo directamente en la página del padre, de modo que ambos se editan en un solo formulario. Registra uno a nivel de módulo:
rustango::register_admin_inline!(
parent = "posts",
child = "comments",
fk = "post_id", // child column → parent PK
kind = rustango::admin::inlines::InlineKind::Tabular, // or Stacked
label = "Comments",
fields = &["author_name", "body", "created_at"],
);
En la página de detalle del padre los hijos se renderizan como una tabla de solo
lectura; en la página de edición se convierten en un FormSet editable (añadir /
cambiar / eliminar filas en el sitio). Opciones: kind (Tabular — una fila de tabla
por hijo, o Stacked — un conjunto de campos por hijo), label, fields (por defecto:
cada escalar excepto el FK), extra (filas en blanco ofrecidas para añadir), max_num
(un guardado que añade filas por encima se rechaza) y readonly_fields. Las filas inline
pasan por el hook view del hijo, los campos secretos nunca se muestran, y una fila extra
con una PK natural escrita se inserta.
Para filas hijas adjuntadas mediante una clave foránea genérica (par content-type +
object-pk) en lugar de una única columna FK, usa
register_admin_inline_generic!(parent, child, ct = "content_type_id", pk = "object_pk", …) — con las mismas opciones por lo demás.
Acciones masivas
Nombra las acciones en admin(actions = "..."), luego registra un manejador por acción
en el Builder. El manejador recibe un ActionCtx: la transacción de escritura del
admin, las claves primarias de las filas seleccionadas que pasaron las comprobaciones
de permisos, el usuario para el que corrieron y (con tenancy) el inquilino:
use rustango::admin::{ActionPerm, AdminError};
use rustango::core::SqlValue;
let admin_router = admin::Builder::new(pool)
.register_action("posts", "publish", ActionPerm::Change, |mut ctx| {
Box::pin(async move {
let query = Post::objects()
.filter("id__in", SqlValue::List(ctx.pks().to_vec()))
.update()
.set("status", "published")
.compile()
.map_err(|e| AdminError::Internal(e.to_string()))?;
rustango::sql::update_tx(ctx.tx(), &query).await?;
Ok(())
})
})
.register_action("posts", "archive", ActionPerm::Change, /* … */)
.build();
Selecciona filas con las casillas, elige la acción en el selector y envía
(POST /<prefix>/<table>/__action). delete_selected está incorporada — no la
registras. Un nombre de acción listado en admin(actions = ...) sin un manejador
registrado simplemente no aparecerá.
ActionPerm::Change comprueba la acción como una edición: {table}.change más un hook de
objeto con el nombre de la acción. Una acción que borra debe pasar
ActionPerm::Delete, para que necesite
{table}.delete y ejecute en su lugar el hook delete. Sigue necesitando
{table}.change, y se audita y se señala como una edición.
El manejador escribe a través de ctx.tx(), de modo que sus escrituras y sus
filas de auditoría se confirman o se revierten juntas. Escribe solo a través de esa transacción: una segunda
conexión puede bloquear un pool SQLite de una sola conexión. ctx.actor() es quien lanzó
la acción; ctx.method(), ctx.path() y ctx.client_ip() describen la petición. La
petición en bruto (con cookies) está tras ctx.raw_request_parts_with_credentials():
mantenla fuera de los logs.
Registro de auditoría
Añade audit(track = "field1, field2") a un modelo y cada creación, actualización y
eliminación se registra en la tabla rustango_audit_log (creada por ti cuando ejecutas
migrate). track selecciona qué campos se capturan en el diff (omítelo para rastrear
todos los escalares). Las escrituras del admin, filas inline incluidas, se registran para
todo modelo: para un modelo audit(...) en la transacción de la escritura, así que una
entrada fallida deshace la escritura; para cualquier otro modelo con el mejor esfuerzo,
tras el commit.
#[rustango(table = "posts", audit(track = "title, body, status"))]
Cada entrada almacena la tabla, la clave primaria, la operación, la fuente, un diff por
campo ({before, after}) como JSON, el actor, una marca de tiempo y una huella
resistente a manipulaciones. Dos lugares lo exponen:
- La página de detalle del modelo gana una tarjeta Audit trail que lista los cambios recientes (quién, cuándo y el diff), con un enlace View full history (mostrado en la captura de detalle de arriba).
- Las entradas de una fila se guardan bajo el texto canónico de su clave:
/posts/007y/posts/7comparten un historial. - La vista Activity de la barra lateral (
GET /<prefix>/__audit) es un feed que cruza filas, del más reciente al más antiguo, con tarjetas de faceta para entidad / operación / fuente y un formulario de limpieza para purgar entradas de más de N días (lo cual se registra a su vez como una entrada de auditoría). Cada tarjeta de faceta muestra hasta 15 valores más el activo; "+N more" (?facet_show_all=<col>) lista como máximo 200, así que filtra el feed para ver el resto. Conwith_user_perms, las tablas con un hook de queryset oviewsolo aparecen aquí para los superusuarios.
Columnas calculadas y filtros personalizados
Cuando el bloque declarativo no es suficiente, dos macros a nivel de módulo extienden la vista de lista:
Columnas calculadas — una columna derivada, no de base de datos:
rustango::register_admin_computed!(
"posts", "word_count", "Words",
|row| row.get("body").and_then(|v| v.as_str())
.unwrap_or_default().split_whitespace().count().to_string(),
);
// then add `word_count` to admin(list_display = "...").
El closure recibe la fila como serde_json::Value y devuelve HTML preescapado. Una forma
de 5 argumentos añade link = |row| Option<String> para envolver la celda en un <a>.
Filtros de lista personalizados — lógica de filtrado que las autofacetas no pueden expresar:
fn by_status(value: &str) -> Vec<rustango::core::Filter> { /* map value → predicates */ }
rustango::register_admin_list_filter!(
"posts", "status", "Status",
&[("draft", "Drafts"), ("published", "Published")], // (value, label) choices
by_status, // fn(&str) -> Vec<Filter>
);
Vistas, querysets y permisos personalizados
Tres macros de registro más se enganchan al comportamiento de un modelo registrado:
- Páginas de admin personalizadas —
register_admin_view!("posts", "duplicate", Method::POST, "Duplicate", handler)monta una página/acción adicional en/<prefix>/posts/duplicate. El manejador es unfn(Pool, Request) -> Responseasíncrono. (Los sufijos reservados comonew,__action,__autocomplete,{pk},{pk}/edit,{pk}/deletese omiten con una advertencia.) Conwith_user_perms, un GET necesita{table}.viewy un POST/PUT/PATCH/DELETE{table}.change; añadeperm = "publish"para exigir{table}.publish. - Acotación de querysets —
register_queryset_scope!("posts", hook)dondehook: fn(&Parts) -> Vec<Filter>restringe lo que una petición puede ver (por ejemplo, solo las filas del usuario actual). Varios hooks sobre una tabla se componen. Una creación, edición o fila inline cuya FK apunta a una fila destino que sus hooks, el soft delete o el hookviewocultan se rechaza con "no such object". - Permisos a nivel de fila —
register_object_permission!("posts", "change", check)dondecheck: fn(&Parts, Option<&Value>) -> boolpermite o deniega por fila. Los manejadores incorporados consultan las accionesadd,change,deleteyview; varios hooks se combinan con Y (AND). Un hookviewtambién oculta filas de la lista, del autocompletado, de los nombres de las facetas de FK y de los nombres de las celdas de FK. La lista lo ejecuta sobre cada fila que coinciden con sus filtros y su búsqueda, así que los totales, las facetas, los grupos de fechas y la búsqueda dejan fuera las filas ocultas; pasadas las 10 000 filas (Builder::view_hook_scan_cap) las retiene en su lugar. Un hook de queryset hace esto en SQL y escala. - Campos secretos — un campo con el widget
password(formfield_overrides = "x: password") nunca muestra su valor y nunca se busca, filtra ni facetea. Nada más marca un secreto: da también ese widget a los campostoken/api_key.
Para un control de acceso más grueso basado en codename, Builder::with_user_perms([...])
condiciona cada tabla a {table}.view / .add / .change / .delete: la ausencia de
view oculta el modelo y devuelve 404 en accesos directos, la ausencia de change lo
renderiza de solo lectura, y la ausencia de add / delete elimina esos botones.
Autenticación
Por defecto el admin está abierto — cualquiera que pueda alcanzarlo puede usarlo. Restríngelo de una de dos maneras:
-
Auth de sesión (incorporada).
Builder::with_session_auth(secret)monta/login+/logout(y una página opcional de cambio en/account/password) y envuelve cada otra ruta en middleware que redirige las peticiones anónimas al formulario de inicio de sesión. Las credenciales viven en la tablarustango_admin_users(username,password_hashargon2,is_superuser,active,created_at); cambiar una contraseña revoca las demás sesiones de ese usuario. La autenticación de dos factores TOTP opcional está disponible tras la característicatotp, con inscripción en/account/totp.let admin = admin::Builder::new(pool) .with_session_auth(session_secret) .secure_cookies(true) // HTTPS-only cookie in production .build(); -
Ponle tu propia auth por delante. Deja el admin abierto y coloca HTTP Basic auth, OAuth2 o SSO corporativo delante de la ruta de anidamiento con tu propio middleware. El admin solo monta CSRF con auth de sesión, y el navegador reenvía Basic auth por su cuenta, así que las mutaciones de un admin con Basic auth se pueden falsificar cross-site; consulta Seguridad → CSRF. Primeros pasos, Paso 14 muestra cómo se construye ese middleware, con tokens Bearer para una API.
Cuando la auth de sesión está activa, el pie de la barra lateral muestra una línea
"Signed in as username" y un botón Logout (un formulario POST). Los admins
independientes hacen POST a {admin_prefix}/logout por defecto; un admin de inquilino se
sitúa tras la propia ruta de logout de la capa de tenancy, así que apunta el botón allí
con Builder::logout_url:
let admin = admin::Builder::new(pool)
.with_session_auth(session_secret)
.logout_url("/staff-logout") // POST target for the sidebar Logout button
.build();
El builder del admin de inquilino conecta esto a su RouteConfig::logout_url
automáticamente, de modo que el botón siempre alcanza una ruta que existe.
El admin rechaza una edición que desmarca active en la fila del propio usuario que ha iniciado sesión, igual que la consola de operador: pídeselo a otro admin.
Desmarcar active en el admin también fija sessions_revoked_at. Una escritura
directa del ORM en active no lo hace; en tu propio código usa
rustango::session::deactivate::<AdminUser>(&pool, id) (o Operator, User),
para que una reactivación posterior no reviva ninguna cookie antigua.
Temas y marca
| Método | Efecto |
|---|---|
.theme_mode("light" | "dark" | "auto") | Tema de color por defecto (establece data-theme en <html>). |
.title(s) / .subtitle(s) | Texto de cabecera de la barra lateral. |
.brand_logo_url(url) | Logo renderizado sobre el título. |
.brand_name(s) / .brand_tagline(s) | Sobrescrituras por inquilino del título/subtítulo. |
.tenant_brand_css(css) | Un bloque de variables CSS :root{…} prefabricado, incrustado inline para paletas por inquilino. |
.from_settings(pool, &settings) | Construye la marca + visibilidad a partir de las secciones [admin] / [brand] de tu archivo de configuración; ver abajo. |
Configuración: [admin] y [brand]
Builder::from_settings(pool, &settings) lee [admin] de
config/default.toml o config/<env>_settings.toml, y recurre a [brand]
para el aspecto. El urls.rs de un proyecto generado ya lo llama. Las
llamadas al Builder hechas después siguen prevaleciendo.
[admin]
title = "Acme Admin"
subtitle = "Back office"
logo_url = "/static/acme-logo.png"
theme_mode = "auto" # auto | light | dark
url_prefix = "/admin"
allowed_tables = [] # empty = every registered model
read_only_tables = ["orders"]
| Clave | Por defecto | Recurre a | Qué hace |
|---|---|---|---|
title | Rustango Admin | [brand] name | Cabecera de la barra lateral y el <title> de la página |
subtitle | ninguno | [brand] tagline | Línea bajo la cabecera |
logo_url | ninguno: sin logo | [brand] logo_url | Imagen junto a la cabecera |
theme_mode | auto | [brand] theme_mode | Tema inicial, el data-theme de <html> |
url_prefix | /__admin | [routes] admin_url | Prefijo de cada enlace del admin. Anida el router en la misma ruta: Builder::settings_prefix(&settings) la devuelve, y el scaffold recurre a /admin |
allowed_tables | [], todos los modelos | Igual que show_only | |
read_only_tables | [] | Igual que read_only |
Una app multi-tenant (Cli::tenancy()) aplica también title, subtitle,
url_prefix, allowed_tables y read_only_tables al admin de tenant.
[brand] también da estilo a las páginas de error incorporadas, que activa [errors]; ver Páginas de error.
[brand] primary_color tampoco tiñe este admin; es para la
consola de operador. La cookie de sesión es
Secure salvo con [security] secure_cookies = false.
El config/dev_settings.toml del scaffold define [brand] tagline = "dev",
que aquí aparece como subtítulo; ver
los lemas por nivel.
Tu propio logo. logo_url va tal cual a <img src>. Sirve el archivo
desde tu app: ponlo en assets/acme-logo.png, añade
.with_static("/static", "./assets") a tu cadena Cli::new() en main.rs
y define logo_url = "/static/acme-logo.png". El admin y el montaje estático
comparten host, así que una ruta funciona. Una URL completa a un CDN también.
[brand] logo_path es solo para la consola de operador; este admin lo ignora.
El admin de inquilino
En un proyecto con tenancy, el admin de cada inquilino se sirve en el host de
ese inquilino, en /admin (RouteConfig::admin_url; el valor por defecto
/__admin del Builder solo no aplica). Los enlaces antiguos a /__admin
siguen llegando a él, salvo que RouteConfig::legacy() haga de /__admin la
ruta principal.
El admin de inquilino toma su nombre de brand_name de la fila Org, o si no
de [admin] title, o de [brand] name, o del nombre visible del tenant; la
barra lateral, el <title> y el encabezado lo muestran. El resto viene de la
fila Org: el logo es el subido en la página de edición de la consola, o si no el
logo del framework (rustango.png bajo la URL estática); el tema es
theme_mode y el color de acento primary_color, que también colorea los enlaces. Ver
marca por tenant.
Referencia del Builder
Cada método de admin::Builder (cada uno devuelve Self para encadenar salvo que se
indique lo contrario):
| Método | Propósito |
|---|---|
new(pool) | Construir a partir de cualquier pool (PostgreSQL / MySQL / SQLite). Valores por defecto: prefijo /__admin, cookies de desarrollo. |
from_settings(pool, &settings) | Construir a partir de configuración parseada (característica config). |
settings_prefix(&settings) | Función asociada, no un paso del builder: el prefijo de montaje que piden los ajustes ([admin] url_prefix, si no [routes] admin_url), o None. |
title(s) / subtitle(s) | Cabecera / subcabecera de la barra lateral. |
admin_prefix(p) | Prefijo de URL — debe coincidir con la ruta de anidamiento. Por defecto /__admin. |
audit_url(u) | Ruta de la vista de actividad/auditoría. Por defecto /__audit. |
static_url(u) | Prefijo para los assets incrustados (favicon, logo). Por defecto /__static__. El admin simple sirve un prefijo de ruta bajo su montaje. |
change_password_url(u) | Ruta de la página de autoservicio de cambio de contraseña (añade el enlace en la barra lateral). |
show_only([tables]) | Lista blanca de qué tablas aparecen; las demás devuelven 404 y quedan ocultas. |
read_only([tables]) | Renderiza esas tablas pero prohíbe crear/editar/eliminar. |
read_only_all() | Marca cada tabla como de solo lectura. |
skip_count_for([tables]) | Omite COUNT(*) en tablas enormes (el paginador muestra "Page N"). |
view_hook_scan_cap(rows) | Cuántas filas recorre la lista con los hooks view antes de retener el resto. Por defecto 10 000. |
with_user_perms([codenames]) | Condiciona tablas a {table}.view/add/change/delete. |
register_action(table, name, perm, handler) | Registra un manejador de acción masiva; su ActionCtx lleva la transacción de escritura (las filas de auditoría se confirman con ella), las filas comprobadas y el usuario. |
with_session_auth(secret) | Requiere inicio de sesión por cookie (/login + /logout). |
logout_url(u) | Destino POST del botón Logout de la barra lateral. Por defecto {admin_prefix}/logout; los admins de inquilino lo ajustan a su ruta de logout de tenancy. |
secure_cookies(bool) | Establece el flag Secure (solo HTTPS) en la cookie de sesión. new sigue a [security].secure_cookies, o si no es segura en el nivel prod. |
theme_mode(m) | "light" / "dark" / "auto". |
brand_logo_url(url) | Logo sobre el título. |
brand_favicon_url(url) | URL del favicon; sin valor se mantiene el icono incluido. |
brand_name(s) / brand_tagline(s) | Sobrescrituras de marca por inquilino. |
tenant_brand_css(css) | Bloque de variables CSS por inquilino. |
impersonated_by(operator_id) | Renderiza un banner de suplantación (consola de operador). |
tenant_mode() | Oculta los modelos con ámbito de registro (se establece automáticamente para los admins de inquilino). |
registry_mode() | Sirve un registro de tenancy: lista Org, Operator y las demás tablas del registro que un admin simple oculta. |
build() | Finaliza y devuelve el axum::Router. |
Referencia de rutas
Todas las rutas son relativas a admin_prefix:
| Ruta | Método | Qué |
|---|---|---|
/ | GET | Inicio — índice de modelos + acciones recientes. |
/<table> | GET | Vista de lista (búsqueda, filtros, ordenación, paginación). |
/<table> | POST | Envío de creación. |
/<table>/new | GET | Formulario de creación. |
/<table>/<pk> | GET | Vista de detalle (solo lectura), con inlines + tarjeta de auditoría. |
/<table>/<pk> | POST | Envío de actualización. |
/<table>/<pk>/edit | GET | Formulario de edición. |
/<table>/<pk>/delete | POST | Eliminación (tras confirmación). Una fila a la que otras aún apuntan responde 409: una página para el navegador, JSON en otro caso. |
/<table>/__action | POST | Ejecuta una acción masiva sobre los PK seleccionados. |
/<table>/__autocomplete | GET | JSON de autocompletado de FK (?q=). |
/__docs | GET | Referencia de modelos. |
/__audit (o audit_url) | GET | Feed de actividad + limpieza. |
/login, /logout | GET/POST | Auth de sesión (cuando está activada). |
/account/password, /account/totp | GET/POST | Autoservicio de cambio de contraseña / inscripción TOTP. |
/account/totp/disable | POST | Desactivar el TOTP con un código actual. |
Las rutas personalizadas registradas con register_admin_view! se montan en
/<table>/<suffix>.
La referencia de modelos
Cada admin incluye una referencia de modelos en vivo en
<prefix>/__docs — un catálogo de solo lectura de cada modelo registrado con sus campos,
columnas, tipos, flags (PK, unique, …) y relaciones. Nada que configurar; se genera a
partir de tus modelos, así que nunca se desvía del esquema.
Prueba el ejemplo
cd crates/rustango/examples/admin_demo
export DATABASE_URL=postgres://rustango:rustango@localhost:5432/admin_demo
cargo run -- migrate # tables + the audit-log table
cargo run # seeds demo data, serves the admin at /admin
En PowerShell:
cd crates/rustango/examples/admin_demo
$env:DATABASE_URL = "postgres://rustango:rustango@localhost:5432/admin_demo"
cargo run -- migrate
cargo run
Luego abre http://localhost:8080/admin y entra en Posts para ver los filtros, la búsqueda, la jerarquía de fechas, las acciones, los conjuntos de campos, los comentarios inline, el registro de auditoría y la referencia de modelos — cada captura de esta página — en un solo lugar.
Véase también
- El recetario del ORM — los modelos a partir de los cuales se genera el admin (incl. el registro de auditoría compartido).
- Vistas HTML — las vistas genéricas basadas en clases sobre las que se construye el admin.
- Backends de autenticación · Sesiones — asegurar el admin tras un inicio de sesión.
- Guía de seguridad — endurecimiento antes de exponerlo.






