Añade `web::remember_query()`, que guarda en una cookie por listado los
filtros, el orden y la página, y los restaura con un 303 al volver al
listado sin parámetros. "Limpiar" de `ListFilter` añade `?reset` para
olvidarlos.
- ListView: botones, mensajes, tabla y paginador en orden fijo;
anuncia el número de resultados a los lectores de pantalla.
- ListFilter: filtros en fila con "Filtrar" y "Limpiar", envío
automático opcional y marcas de cambios sin aplicar.
- pagetop-htmx: hx_pager::boost() y hx_filter::boost(); cancelan
las peticiones solapadas y atenúan el listado mientras carga,
con estilos sólo en las páginas con listado.
- Usuarios y roles migrados al nuevo patrón.
- "Guardar" y "Cancelar" en la misma fila en todos los formularios.
- "Volver" sólo en fichas de sólo lectura.
- Búsqueda de usuarios con `form::input::Field` y botones de alta en
estilo principal.
PageTop ya no lo necesita como dependencia directa: `std::sync` cubre
los bloqueos del contexto, los temas y las trazas. No se detecta pérdida
de rendimiento en ningún caso.
Usa `unwrap()` en los bloqueos, también en las extensiones, porque sus
secciones exclusivas no pueden provocar panic. Sólo pagetop-cron ignora
el envenenamiento, porque calcula fechas con el bloqueo tomado.
Sustituye `Option<HttpRequest>` por `HttpRequest` en todas las
variantes. Ningún uso construía un ErrorPage sin petición y, sin ella,
la página de error pierde el idioma negociado y el usuario actual.
Añade comprobaciones sin coste en producción:
- Falla con `debug_assert!` si `param_or*`/`extra_or*` piden otro tipo,
si `form:📅:Field` recibe un valor de otro tipo, si `grid::Tracks`
supera MAX_TRACKS o si `TestRequest::header()` recibe una cabecera
no válida.
- Avisa en desarrollo de las traducciones ausentes y, al arrancar, de
las claves de permiso repetidas.
- Corrige en Bootsier el título por defecto de los desplegables y los
botones de confirmación, que salían siempre en inglés. Evita también
el aviso de import sin usar en release de `core/extension/all.rs`.
`Dropdown::items()` devuelve `dropdown::Items`, cuyo `render()` sólo
pinta un encabezado si su grupo tiene algún elemento visible, y un
separador sólo entre elementos visibles. Lo aprovecha cualquier tema
que pinte el menú con `items().render()`.
Las rutas se declaran con su acceso en un enum que implementa Endpoint y
se montan con `routes.endpoint()`. Convertidas en Route, `nav::Item`,
`dropdown::Item` y `Button::anchor()` no se muestran a quien no cumple
el acceso, sin repetir el permiso. `to()` rellena el parámetro de la
ruta.
Un envío anónimo a una ruta que sólo admite POST llevaba, tras iniciar
sesión, a un 405 en blanco. Ahora vuelve a la página del Referer, si es
del mismo Host, y avisa de que el envío no se ha guardado.
Las pruebas de los ajustes que sólo usan la API pública pasan de
global.rs y del config.rs de pagetop-cron a `tests/`. En el código sólo
quedan las que prueban algo privado y la de reference.toml.
Una página del panel muestra la configuración del correo, sin las
credenciales, y envía un correo de prueba esperando el resultado,
para comprobar el transporte en producción. Exige el permiso
`mail:send_test`.
pagetop-user deja de depender de pagetop-admin: declara sus páginas
en el panel del núcleo y monta sus rutas con su acceso. Quita las
comprobaciones que repetían el permiso de la ruta y, con la acción
AnonymousDenied, ofrece el inicio de sesión a un usuario anónimo
sin acceso, también en las peticiones HTMX.
El panel pasa al núcleo y pagetop-admin se queda con los ajustes
guardados en la base de datos: DeclareConfigForms, ConfigForm y la
tabla settings. Un campo obligatorio vacío ya no se guarda, y un
fallo al guardar se muestra con los mensajes del núcleo.
`configure_router()` recibe Routes, que no monta ninguna ruta sin su
Access: `route()`, `public_route()` y `admin_route()`, que toma el
permiso de la página del panel de la que cuelga.
Una ruta del panel montada de otra forma impide arrancar.
`configure_middleware()` recibe Layers y `configure_static_files()`
recibe StaticFiles, siempre públicos.
El núcleo reúne al arrancar las secciones, páginas, pestañas y
botones que declaran las extensiones. La plantilla Admin pinta la
navegación (AdminMenu) y el marco de cada página (AdminFrame), y
PageTop monta el dashboard y las páginas de sección. La raíz del
panel se configura con admin_path.
DeclareAdminSections, DeclareAdminPages, DeclareAdminTasks y
DeclareAdminActions permiten a cada extensión aportar secciones,
páginas, pestañas y botones al panel de administración. Están en
`base::action::admin`, con el mismo patrón que las demás acciones.
DeclarePermissions y PermissionRegistry reúnen al arrancar los
permisos que declaran las extensiones. Access define quién puede
acceder a una ruta y `deny_access()` responde a quien no lo cumple.
Las acciones de permisos (CheckPermission, DeclarePermissions y
AnonymousDenied) pasan a `base::action::auth`, con el mismo patrón
que las de páginas y componentes.
Toda la API de Context pasa a métodos por defecto de Contextual, que
sólo exige `context()` y `context_mut()`; Page la implementa sobre su
Context y deja de duplicar estado y métodos. Título, descripción,
metadatos y propiedades se guardan ahora en el contexto, así que un
componente puede fijarlos al renderizarse. LangId pasa a ser una
implementación general para todo lo que implemente Contextual.
- CSRF sin tokens en el núcleo: se rechazan con 403 las peticiones que
cambian estado si el navegador indica otro origen (`Sec-Fetch-Site`, y
`Origin` frente a `Host`), con el criterio de Go. Sin interruptor.
- Nuevo `[server] trusted_origins`, validado y normalizado al arrancar.
- (user): `max_ip_failed_logins` limita por IP los logins fallidos; el
intento se anota antes de Argon2 para que no se salte en paralelo.
- (user): avisos para la página siguiente tras registro, verificación,
restablecimiento de contraseña y cambio de email.
- `flows.rs` ignora las marcas de componentes aplazados al comparar.
- Componentes aplazados: `Component::is_deferred()` deja una marca
`<!-- placeholder ... -->` y `Page::render()` los renderiza al final
del `<body>`, en su sitio. Si no generan nada, la marca se queda.
- `Region` empieza `Content` con un `Messages` aplazado, que recoge
todos los mensajes de la página. Las aplicaciones ya no tienen que
añadirlo.
- `Messages` retira los mensajes que muestra y admite `with_deferred()`.
- `ResponseExt::with_message()` deja mensajes para la página siguiente
en una cookie técnica de vida corta, que sólo se crea si se usa.
- Basic y Bootsier ocultan las regiones vacías con `.region:empty`.
- `max_email_changes` en `email_change_window_secs`: una cuenta no puede
usar el cambio de email para enviar confirmaciones a muchas
direcciones ajenas, aunque reparta las peticiones entre muchas IP.
- El límite por cuenta se aplica al crear el token (`TokenKind::limit()`
para los dos límites): guarda primero y cuenta después, así las
peticiones simultáneas no lo superan; rechazado, el enlace anterior
sigue valiendo. Sustituye a `count_tokens_since()`.
- El cambio de email crea el token antes de guardar la dirección
pendiente, para que un rechazo no anule el cambio en curso.
- Mensaje de `TooManyRequests` genérico, válido para los límites por
cuenta y por IP.
- Límite de solicitudes por dirección IP para registros, recuperaciones
de contraseña y cambios de email (`max_ip_requests`).
- Avisa del cambio de contraseña, propio o de un administrador.
- El email propio se cambia en /user/email con la contraseña actual y no
se aplica hasta confirmarlo desde un enlace ligado a esa dirección.
- Cambiar el email o la contraseña anula los enlaces antiguos, y los
fallos de la contraseña actual cuentan para el bloqueo de la cuenta.
- `Referrer-Policy: no-referrer` en las páginas con token en la URL.
Por defecto, los correos llevan `Auto-Submitted: auto-generated` (RFC
3834) para no recibir avisos de ausencia; `with_auto_submitted(false)`
la quita en los que escribe una persona. Añade SentEmail::links() para
seguir en las pruebas los enlaces de los correos.
Las variables PAGETOP_<SECCIÓN>__<CLAVE> sobrescriben cualquier ajuste
de los archivos, como última capa de la cascada (p. ej.
PAGETOP_DATABASE__DB_PASS para db_pass de [database]).
- `web::Upload` guarda los archivos de un envío multipart en disco por
trozos, con nombre aleatorio, extensiones y tamaño máximo por archivo.
`receive()` deserializa además los campos de texto con serde_qs.
- `web::Download` sirve un archivo subido con rangos y peticiones
condicionales, inline sólo para tipos pasivos y con nosniff.
- `form::File`, componente para elegir archivos, y soporte en Bootsier.
- Límite del cuerpo según el tipo de contenido: `server.max_body_size`
baja a 2 MiB y el nuevo `upload.max_request_size` (32 MiB) se aplica
sólo a multipart/form-data.
Añade `max_password_resets` (3; 0 = sin límite) y
`password_reset_window_secs` (3600) en [user]. Alcanzado el límite no se
envía el correo y la respuesta es la misma, para no revelar si la cuenta
existe.
Nueva feature `queue`, con `pagetop-seaorm` y `pagetop-cron`: los
correos se guardan ya compuestos en la tabla `mail_queue` y el trabajo
`mail.queue` los envía por lotes, con reintentos de espera creciente y
reserva por fila para varias instancias (entrega «al menos una vez»).
- `Email::queue()` sólo guarda el correo; `send_later()` lo guarda y lo
intenta enseguida, o lo deja para el lote si hay demasiados en espera.
- SMTP con el transporte síncrono de `lettre` en `spawn_blocking`, con
`timeout_secs` en cada lectura y escritura del socket.
- Turnos de envío y límites configurables para todos los transportes:
envíos simultáneos, correos en espera, tiempo máximo de entrega y
espera máxima entre intentos, validados al arrancar.
- Nuevos errores `Timeout`, `Overloaded`, `Interrupted`, `OutOfRange` y
`Queue`; `MailError` pasa a ser `#[non_exhaustive]`.
- Trabajos programados con expresiones cron (croner), `fixed_rate()` y
`fixed_delay()`, declarados con la acción `DeclareCronJobs` y
ajustables por su clave en `[cron.jobs."clave"]`.
- Control de solapamiento, tiempo máximo, zona horaria por trabajo,
ejecución al arrancar y bajo demanda con `run_now()`.
- Modo `external` sin estado, para réplicas y escalado a cero:
`POST /cron` con `Authorization: Bearer`, ventanas alineadas de
`trigger_interval_secs` y respuesta al terminar los trabajos.
- Estado con `jobs()`/`job()`, acción `AfterJobRun` y parada ordenada
con `JobContext::is_stopping()`.
Arranca los servicios en segundo plano sólo con `Application::run()`,
nunca en las pruebas, y los detiene en orden inverso al parar el
servidor o si falla el `start()` de una extensión posterior.
- Envía por correo la recuperación de contraseña y, con
`require_email_verification`, la verificación de cuentas nuevas, que
se confirma con un botón (los escáneres de correo abren los enlaces).
- Nueva política de nombres de usuario (`identity_policy`): sin `@`, sin
distinguir mayúsculas y sin nombres confusables (UTS #39). Email
validado con pagetop-mail.
- Tokens de un solo uso atómicos y ligados al usuario. Los correos a
direcciones sin verificar no incluyen datos elegidos por el usuario.
- Bloqueo por intentos fallidos con su ventana de recuento, y el mismo
tiempo de respuesta exista o no la cuenta. Argon2 en `spawn_blocking`.
- Límites de longitud del nombre visible y de los roles, y botones sólo
con el permiso que exigen. Más correcciones en formularios y búsqueda.
Los ejemplos usaban `.` como separador, pero las extensiones usan
`extensión:permiso` (p. ej. `user:admin_users`). Se unifican ejemplos y
se documenta la convención en `Permission::key()`.
`using()` copiaba siempre cada argumento de texto al escaparlo. Ahora
sólo lo hace si contiene algún carácter que Maud escapa; si no, se pasa
prestado.
` try_lookup_complete()` negocia el idioma en cada llamada aunque casi
siempre sea uno disponible. Ahora se prueba antes el idioma exacto y
sólo si falla se recorre la cadena de respaldo, con el mismo resultado.
Los argumentos de `with_arg()` pueden venir de datos de usuario y
`using()` los insertaba sin escapar. Ahora se escapan, y `with_markup()`
añade argumentos con marcado HTML de confianza que se insertan tal cual.