Commit graph

362 commits

Author SHA1 Message Date
56b8725a52 ✨ (util): Añade SecretStr para contraseñas
SecretStr guarda un secreto que no se muestra con Debug y se borra de
la memoria al descartarse. Lo usan las contraseñas de los ajustes de
pagetop-seaorm (db_pass) y pagetop-mail (smtp.password).

HttpRequest::from_parts() pasa a ser pública, para crear la petición
en un middleware antes de que llegue al handler.
2026-11-12 19:52:38 +01:00
3096ed7bfd 🔒️ Añade el ajuste secure_cookies para cookies
Las cookies de PageTop se montan con la nueva función
`web::cookie_header()`, que añade `Secure` según `[server]
secure_cookies`.
2026-11-11 22:42:12 +01:00
a276a5f797 ✨ (form): Añade texto de ayuda a Checkbox
Documenta el criterio de uso de las cookies en PageTop y por qué no
requieren la aceptación del usuario.
2026-11-11 18:36:04 +01:00
e4a88b2150 ✨ (web): Recuerda el estado de los listados
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.
2026-11-11 07:46:27 +01:00
d8493291e4 ✨ (base) Añade ListView y ListFilter para listados
- 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.
2026-11-10 22:49:40 +01:00
0f71eba7ab 📝 Acorta la descripción de AdminFrame 2026-11-10 22:02:50 +01:00
698b917fb1 ➖ Sustituye parking_lot por std::sync
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.
2026-11-09 07:22:18 +01:00
a6d15ab211 ♻️ Exige la petición en las variantes de ErrorPage
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.
2026-11-08 14:24:30 +01:00
947aef2f91 🔥 Simplifica startup_banner a booleano 2026-11-08 13:51:35 +01:00
f9ab1f55a3 ✨ Detecta errores de programación en desarrollo
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`.
2026-11-08 12:59:45 +01:00
c7888c85ac ✨ (auth): Registra los accesos denegados 2026-11-08 11:24:01 +01:00
c940403869 ✨ (base): Oculta separadores en menús sin opciones
`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()`.
2026-11-08 10:11:42 +01:00
e2e2ccb31e ✨ (pagetop): Oculta enlaces sin acceso con Endpoint
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.
2026-11-08 08:56:57 +01:00
87711e4a37 🐛 (user): Vuelve a la página de origen tras envío
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.
2026-11-07 19:20:11 +01:00
d074f252a7 ✅ Mueve a tests/ pruebas públicas
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.
2026-11-07 16:57:57 +01:00
ab2677be44 ✨ (web): Exige el acceso de cada ruta al montarla
`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.
2026-11-07 13:52:04 +01:00
71ea609088 ♻️ (admin): Construye piezas del panel con new()
AdminSection, AdminPage, AdminTask y AdminAction pasan a campos
privados con constructores y pesos Weight.
2026-11-07 07:58:01 +01:00
8e0c887ba6 ✨ (admin): Integra el panel de administración
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.
2026-11-07 07:16:15 +01:00
ecba7b2bd8 ✨ (admin): Añade acciones para declarar el panel
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.
2026-11-07 06:27:14 +01:00
379450ec40 ✨ (auth): Añade el catálogo de permisos y acceso
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.
2026-11-07 06:19:48 +01:00
b2dfb52d93 ♻️ (pagetop): Unifica la interfaz de Context y Page
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.
2026-11-06 16:18:15 +01:00
574010374d 🔒️ Protección CSRF y límite de logins por IP
- 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.
2026-11-02 14:34:05 +01:00
c9fdc7afc7 ✨ Mensajes flash y Messages automático en Content
- 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`.
2026-11-02 13:20:36 +01:00
3c6dea9728 ✨ (web): Añade HttpRequest::client_ip() 2026-10-31 20:42:51 +01:00
1df91ce4c8 ✨ (config): Admite variables de entorno
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]).
2026-10-31 19:06:01 +01:00
f3228d6b59 ✨ (pagetop): Añade subida y descarga de archivos
- `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.
2026-10-31 15:28:58 +01:00
4c3f4dab1b ✨ (core): Añade start() y shutdown() a Extension
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.
2026-10-27 20:26:09 +01:00
f2a052d66c 🔒️ (response): Evita "open redirect" en Waypoint
El navegador descarta tabuladores y saltos de línea de una URL, así que
`/\t/evil.example` acababa en `//evil.example` (open redirect).
2026-10-19 07:23:25 +02:00
b2e9fe79e8 📝 (auth): Documenta la convención de las claves
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()`.
2026-10-19 07:20:50 +02:00
b3a7d40930 ⚡️ (locale): Lc escapa argumentos sólo si hace falta
`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.
2026-10-18 12:49:03 +02:00
bae8358471 ⚡️ (locale): Prueba antes el idioma exacto en Lc
` 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.
2026-10-18 12:30:20 +02:00
0bcc7e5236 🔒️ (locale): Escapa argumentos texto en using()
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.
2026-10-18 12:25:16 +02:00
c3f45e7688 ✨ (macros): Funde class="..." con clases abreviadas 2026-10-17 11:35:48 +02:00
d1d3a62c8f 🥅 (config): Detiene arranque si config falla 2026-10-17 11:27:51 +02:00
98a71b6f51 ✨ (web): Añade form() y más métodos a TestRequest 2026-10-17 08:09:49 +02:00
fd6030ee7d ♻️ (config): Ajustes no válidos sin panic al arrancar 2026-10-13 01:21:34 +02:00
79655932d0 📝 Ejemplos de documentación usando prelude 2026-10-13 00:12:13 +02:00
d3a9be7550 ♻️ (pagetop): initialize() devuelve Result sin panic
`Extension::initialize()` devuelve `Result<(), BoxError>`; `BoxError` es
un nuevo alias. Si una extensión falla, `prepare()` registra el error
con sus causas, vuelca las trazas, lo repite en stderr y termina con
código 1, sin panic! ni cambiar su firma.
2026-10-13 00:04:04 +02:00
728a5c83dc ♻️ (config): Ajustes con #[settings] al arrancar
- Nuevo atributo `#[settings]`: valores por defecto en los campos (tipos
  comprobados al compilar y documentados); claves desconocidas y valores
  no válidos rechazados. Sustituye a `include_config!`, que se elimina.
- `LazySettings<T>::new()` declara los ajustes de una sección, y
  `Extension::settings()` los carga al arrancar, en orden; un error de
  configuración o una sección reclamada dos veces detiene el arranque.
- Aviso de secciones que no corresponden a ninguna extensión.
- Bootsier: [dev] bootsier_static_dir pasa a [bootsier] static_dir.
2026-10-12 21:41:01 +02:00
8a7a827259 🐛 (app): Middleware y cabeceras en páginas de error
- El fallback de rutas inexistentes se registra antes del middleware: la
  página 404 ve el usuario actual.
- Las páginas de error conservan las cabeceras que añaden el middleware
  o el handler (salvo `Content-*`), p. ej. una cookie de sesión
  renovada.
2026-10-12 12:46:37 +02:00
8377ddb4c6 ⚡️ Declara un favicon vacío si la página no tiene
Evita que el navegador pida `/favicon.ico` en cada página, una ruta
inexistente que acababa en una página 404 completa.
2026-10-12 12:37:10 +02:00
27e3ff529e 📝 Nombra web::Form adecuadamente 2026-10-12 09:55:33 +02:00
7793eb796c ⚡️ Caché HTTP y estáticos fuera del middleware
- ServeEmbedded envía ETag (del contenido) y `Cache-Control: no-cache`,
  y responde 304 sin cuerpo si el recurso no ha cambiado.
- Los archivos servidos desde disco añaden también `no-cache`.
- Nuevo `Extension::configure_static_files()`: sus rutas se montan tras
  el middleware y no resuelven la sesión. Movidos los estáticos del
  núcleo, Bootsier, Aliner y HTMX.
2026-10-12 09:54:47 +02:00
cbe38136c9 🎨 Usa AutoDefault en lugar de derive(Default) 2026-10-12 07:59:57 +02:00
58c48aad16 ♻️ (config): Revisa avisos diferidos y documentación
- Avisa al arrancar si CONFIG_DIR no se puede resolver.
- CONFIG_DIR y PAGETOP_RUN_MODE vacías equivalen a no definirlas.
- `trace::defer_warning()` genérica; detecta su uso tras iniciar trazas.
- `config::invalid_setting()` sustituye `trace::warn_invalid_setting()`.
2026-10-12 07:57:39 +02:00
d52cbdef3f 🐛 (app): Vuelca las trazas al detener el servidor
El WorkerGuard de las trazas vive ahora en Application y run() detiene
de forma ordenada el servidor con Ctrl+C o SIGTERM para volcar las
trazas pendientes. Una segunda Ctrl+C lo detiene en el acto.
2026-10-11 08:57:47 +02:00
e238db1a1b 🔊 (theme): Avisa si el tema configurado no existe
Fija el tema predeterminado al arrancar, después de registrar las
extensiones, y avisa si `app.theme` no está habilitado para usar Basic.
2026-10-10 23:06:48 +02:00
3512fed7e0 🔊 (config): Emite avisos de opciones como trazas 2026-10-10 22:05:36 +02:00
91f60a420d 🔊 (datetime): Avisa de regiones no ofrecidas 2026-10-10 20:52:57 +02:00
3355750922 🎨 Ajusta líneas largas en relative.rs 2026-10-10 13:33:40 +02:00