Convenciones de capturas¶
Regla vigente: dos imágenes por opción¶
El PO exige mínimo dos capturas reales de Odoo por opción de menú: entrada/datos y detalle/resultado/bloqueo del caso. Los contenedores también deben enseñar el menú desplegado y el nivel/destino siguiente. No cuentan dos tamaños de la misma escena, duplicados, montajes ni capturas del InfoCenter.
El canon vigente es BPSPayrollE/dev-fase3, Odoo.sh xdiegob-bpspayrolle. Las versiones V1.1 contienen varias ondas con distintos SHA: el nombre de la carpeta no determina el corte. Cada imagen lleva su propio rol, SHA, entorno y alcance. El registro por opción separa destinos de imágenes verificadas; un espacio pendiente no equivale a captura.
Se permiten listas vacías o formularios sin guardar para explicar entrada/campos si se declaran como tales, pero no sustituyen el resultado del ejemplo. Las vistas con secretos solo se capturan si no exponen valores sensibles; no eludir seguridad ni realizar una operación externa para conseguir la segunda imagen.
Los apartados históricos de abajo describen condiciones de ondas anteriores, no el acceso ni el viewport actual. Las capturas actuales y el estado por frente se consultan en inventarios separados.
Dónde vive cada versión¶
docs/assets/screenshots/v1.0/<frente>/...
docs/assets/screenshots/v1.1/<frente>/NN-accion-estado-viewport.png
Las capturas V1.0 no se sobrescriben: son evidencia histórica del canon anterior. Cada versión nueva crea su propia carpeta y registra la procedencia de sus imágenes en evidence/v<versión>-manifiesto-capturas.csv.
Campos del manifiesto:
Qué muestran las imágenes V1.0¶
Tomadas en una instancia Odoo.sh de Development del canon antiguo (xdiegob-bpsnomina, hoy eliminado), con datos de demostración o formularios abiertos sin guardar.
| Tipo de captura | Cómo leerla | Qué no demuestra |
|---|---|---|
| Lanzador/listado con datos demo | Ruta, disposición de la pantalla y columnas | Que esos empleados sean clientes o datos reales. |
| Menú desplegable | Opciones disponibles para el rol de demostración | Que una opción esté completada o autorizada en producción. |
| Formulario nuevo sin guardar | Datos y secciones que se deben revisar antes de crear | Que se creó un registro. |
| Listado vacío con cabeceras | Campos que el proceso dejará trazados en una base limpia | Que hubo un envío, pago, aceptación o cierre. |
Una captura V1.0 puede haber envejecido
El lanzador de la V1.0 muestra la aplicación Nómina BPS con un icono genérico. En el código vigente el icono es el oficial entregado por el PO, y la aplicación solo aparece si el usuario tiene un rol BPS. Ver Roles y seguridad.
Primera onda histórica V1.1 de agosto¶
Tomadas sobre xdiegob/PayrollBPS, rama dev-fase3, commit b403706a, en el proyecto Odoo.sh xdiegob-payrollbps (Development, build con Test: Success).
Cada imagen V1.1 debe declarar en su pie: entorno, rol, estado, tipo de datos y qué no demuestra.
Viewports¶
- Escritorio: registre el viewport CSS real, no el nominal. Las capturas V1.1 actuales son de 1536 px CSS (1920 físicos, DPR 1.25).
- Angosto: 480 px para recorridos frecuentes.
- Crítico: 360 px cuando haya tablas, pestañas, trazas o diálogos.
Confirme scrollWidth <= innerWidth, sin texto elidido en etiquetas necesarias, sin botones fuera del viewport y sin diálogos cortados.
Pendientes históricos de aquella onda V1.1¶
Lista cerrada. Ninguna de estas imágenes se sustituyó por una ilustración, un montaje ni una captura del canon anterior.
Bloqueo A — sin rol BPS en la sesión¶
La sesión no tiene ninguno de los tres grupos que abren la aplicación, y el PO decidió no modificar ningún ambiente en esta entrega: ni conceder un rol ni sembrar datos.
| Frente | Captura pendiente |
|---|---|
01-acceso-roles |
Lanzador con rol BPS (aplicación visible) |
01-acceso-roles |
Menú principal de Nómina BPS desplegado por proceso |
02-empleados-contratos |
Lista «Empleados no aptos para nómina» con registros |
03-tiempos-novedades |
Formulario de novedad y lista de registros de hora |
04-liquidacion |
Preliquidación técnica, recibo productivo y comprobante de pago |
Bloqueo B — la base del build no tiene nómina BPS sembrada¶
El build 36201289 trae la base de demostración estándar de Odoo: 22 empleados de ejemplo, sin contratos BPS, sin novedades, sin preliquidaciones ni recibos. Aun con rol BPS, los formularios y listas se fotografiarían vacíos, que es peor que no publicar la imagen: sugiere que la pantalla no tiene contenido cuando en realidad no tiene datos.
El repositorio incluye un aprovisionador que siembra un mes completo de nómina sintética D-19 y los seis usuarios de UAT con sus roles. Ejecutarlo exige autorización expresa, y en esta entrega no se concedió.
El bloqueo B anterior era otro, y quedó resuelto
La revisión previa reportó que en el build 36148957 ninguna vista de acción renderizaba contenido, ni siquiera aplicaciones estándar de Odoo. En el build 36201289 no se reproduce: Empleados de Odoo estándar renderiza con normalidad. Era un defecto de aquel build, no del producto.
Limitación conocida — las capturas de escritorio no se leen en un teléfono¶
Verificado a 480 px con Chrome real: el sitio no desborda horizontalmente y la navegación colapsa correctamente, pero las capturas tomadas a 1536 px se reducen hasta quedar ilegibles. Es comportamiento heredado de la V1.0, no un defecto introducido en la V1.1.
Mientras no se recapture por pantalla y no solo por página, en un móvil use el texto como fuente principal: cada paso está descrito de forma que no dependa de leer la imagen. Si necesita el detalle visual, abra la imagen aparte o consulte la wiki desde un escritorio.
Bloqueo C — viewport angosto no alcanzable en pantallas de Odoo¶
Afecta solo a las capturas de Odoo, y por una razón concreta: el navegador que conserva la sesión autenticada de Odoo.sh informa el cambio de tamaño como exitoso pero el viewport permanece en 1536 px CSS; el navegador que sí redimensiona correctamente arranca con un perfil limpio y no tiene esa sesión. Las capturas de Odoo a 480 px quedan pendientes.
La verificación angosta del sitio de la wiki sí se realizó, con Chrome real a 480 px: innerWidth 480, scrollWidth 465, sin desbordamiento horizontal ni imágenes fuera del viewport.
Actualización de imágenes¶
- Verifique primero la ruta y el resultado en el entorno autorizado, con el rol real.
- Elija una pantalla que enseñe una decisión, campo o control; no una carga ni una transición.
- Guarde la imagen con nombre descriptivo
NN-accion-estado-viewport.png. - Añada un pie que explique qué se ve y qué no puede inferirse.
- Registre la fila en el manifiesto de procedencia.
- Ejecute
mkdocs build --strict.
Seguridad visual¶
- No se incorporan contraseñas, PIN, P12/PFX, tokens, llaves privadas ni secretos de API.
- Se evitan datos reales de empleados. Cuando Odoo muestra datos de demostración, se informa en el pie.
- Una captura UAT debe anonimizar lo que no sea necesario para enseñar el paso y declarar su versión y entorno.