Control de versiones¶

2026-09-13 — Volver a objetivos y recorridos guiados¶

Portada reconstruida alrededor de «qué quiero lograr», primera nómina destacada y navegación por responsabilidades. Catálogo exhaustivo conservado bajo Referencia; portada anterior archivada, sin borrar rutas.
Preparación visual del trabajador: seis pasos con ocho capturas existentes, datos, controles y recuperación; sin alta positiva todavía. Mayor espacio de lectura para las imágenes y enlace al mismo caso Ana/Luis.
Selector de informes y cinco recetas: tablero, costo, checklist, bitácora y comité. Actualizado comprobante con botón vigente y cotejo del PDF. Distinción expresa entre costo analítico y composición ampliada; botón de descarga no demuestra recibo finalizado.
Revalidado 067ec7a21cf049451cd349ae473e872883f98e77, Development 37956195 / Test: Success; PR #17 sigue abierto. Chrome permite identificar entorno; la sesión User/YourCompany no muestra BPS. Se solicita autenticación privada de sesión administrativa/RR. HH. ya autorizada.
A: 0 imágenes Odoo nuevas; B: 5 capturas nuevas de QA del sitio. 0 recorridos funcionales y 0 resultados nuevos. Se mantiene PARCIAL y las dos imágenes por opción siguen pendientes.
QA de once páginas a 1280/480/360, claro/oscuro de portada, enlaces y compilación estricta. Detalle medible, límites y hashes: evidence/v1.1-recorridos-por-objetivos.md.

Añadida la sección Todos los menús: 14 páginas de menú/entrada con 177 fichas y ejemplos individuales, además de los contenedores anidados. Reconstrucción estática de 209 nodos en SHA 067ec7a21cf049451cd349ae473e872883f98e77, mediante archivos de datos en orden de dependencias y reubicación de la app.
Cada ficha incorpora ruta, finalidad, ejemplo, pasos de entrada/consulta, campos declarados, controles, recuperación y fuentes. Es referencia extraída de código: no se presenta como verificación individual de todas las reglas de negocio ni como tutorial visual terminado.
Incorporada al contrato la exigencia de dos capturas Odoo significativas por opción/contenedor, sin duplicados de tamaño, imágenes del sitio ni resultados inventados. Registro de destinos y evidencia separado por XML ID.
0 capturas Odoo nuevas, 0 nuevos recorridos, 0 resultados generados. Dos fotos existentes del formulario de Empleados se reutilizan como apoyo, no como evidencia del menú BPS. Chrome permite leer URL y entorno, pero la sesión User/YourCompany no muestra BPS; requerida autenticación privada del PO con sesión administrativa BPS y luego los roles específicos.
Estado PARCIAL conservado. QA de esta ampliación: ver evidence/v1.1-cobertura-menus.md. No se modifica producto, permisos ni repositorios documentales externos.

2026-09-13 — Primera nómina con dos salarios y ocho capturas actuales¶

Reescrito Mi primera nómina: Ana con SMMLV de referencia 2026 y Luis con COP 3.500.000; instrucciones por pestaña, campos mínimos/condicionales/calculados, responsables, operación mensual y salidas.
8 capturas nuevas de Odoo, distintas de las de QA del sitio: ficha nueva no guardada en Work/Personal/Payroll, calendario y faltantes. Sesión User/YourCompany, Development 37956195, SHA 067ec7a2, 1536 × 639 reales. La lista de 22 empleados no cambió tras descartar la ficha vacía.
Chrome volvió a permitir leer e interactuar por el mecanismo autorizado. Se revalidaron Odoo.sh Test: Success, enlace al build 37956195 y SHA exacto; los timeouts del apartado anterior son historia de esa continuación, no el bloqueo actual.
No se usó YourCompany para guardar los empleados. Falta sesión Administrador BPS/RR. HH. en compañía sintética; H-8 sigue en PR #17 abierto. 0 recibos/PDF del caso. La tabla monetaria es comprobación aritmética condicionada, no resultado Odoo.
Explicitado que el productor vigente de IBC recibe solo salario básico: no demuestra la incorporación del auxilio al recibo BPS. No se modifica producto para cubrir ese límite.
Evidencia y QA de esta edición: evidence/v1.1-primera-nomina-dos-salarios.md. Se conserva INFOCENTER_PRIMERA_NOMINA_PARCIAL.

2026-09-13 — Guías ampliadas desde el cambio final integrado¶

G01–G14 relacionan los 52 PRs fusionados y los 2 cambios directos con los 314 commits, sus superficies, sustituciones y destino documental. El contador de 309 análisis independientes de la primera pasada queda retirado; se conserva abajo como historia de esa entrega.
Ampliadas las instrucciones de instalación/roles, compañía/DANE, empleado/contrato/certificado, tiempo–IBC, liquidación/FSP, prestaciones/vacaciones/consignación/antigüedad, F220, PILA, contabilidad/costos, riesgo/NIC37 y habilitación. Nueva guía de gobierno de alcance y cierre. Calendario y evidencia distinguen preparación, operación y revisión.
Contraste documental no equivale a pantalla observada, recorrido ejecutado ni resultado generado. En esta continuación: 0 nuevas capturas Odoo, 0 nuevos recorridos, 0 nuevos recibos/PDF/XML/ZIP. Se conserva INFOCENTER_PRIMERA_NOMINA_PARCIAL.
Chrome identificó URL Development 37956195, pero dos lecturas terminaron con js execution timed out; kernel reset, rerun your request. Se detuvieron reintentos; no se atribuye a Odoo ni a sus permisos. Intervención PO y comprobación que falta.
QA estático: compilación estricta y verificación de enlaces/fragmentos/archivos fuente; no QA visual completo ni funcional. El reporte actualizado por sección queda en cobertura integral.

2026-09-13 — Primera pasada de trazabilidad (registro histórico)¶

Revalidados SHA actual y PR #17 abierto. Comparadas identidades SHA/árbol de A (4b0f549d) y B (4073760e) en PayrollBPS y BPSPayrollE; comprobada ascendencia A → B → S (067ec7a2). No se limitó el intervalo por semanas.
Inventariados 314 commits con archivos y atribución de PR por grafo/API: 241 no-merge y 73 merges. Detectados 23 commits en pruebas; solo cinco tienen diff examinado y justificación interna sin cambio operativo. Los 309 restantes mantienen análisis integral pendiente, incluidos commits con contrastes parciales. El filtro de rutas no es un dictamen de ausencia de impacto.
Incorporadas 14 unidades de impacto a la matriz de cambios, con guía/paso, usuario, captura y pendiente. No equivalen a 14 PRs íntegramente cubiertos ni a recorridos ejecutados.
Nuevas instrucciones para PILA/exoneración, FondoSP, prestaciones y régimen por período, ZIP, DANE, zona de detección y reapertura; mensajes separados del catálogo histórico.
Capturas A (Odoo) y B (sitio) inventariadas por separado. En este contraste histórico: cero recorridos funcionales y cero capturas nuevas de Odoo. Pendientes documentales no atribuidos al acceso.

2026-09-13 — Ampliación integral en curso, prioridad habilitación¶

Remoto BPSPayrollE/dev-fase3 revalidado en 067ec7a21cf049451cd349ae473e872883f98e77; PR #17 sigue abierto y no fusionado.
Nueva guía Preparar la habilitación de nómina electrónica, con fuentes oficiales y acciones locales/privadas/externas separadas.
Apertura real del asistente Consolidar documento DSNE con Operador UAT; no consolidado. Edge se desconectó antes de completar captura; Chrome conserva sesión User/YourCompany sin icono BPS. Captura nueva de esa condición, sin permisos modificados.
Corregidas referencias obsoletas de preliquidación, reapertura, gate jurídico y rutas DSNE/PILA. Añadidas entradas de antigüedad y descarga directa del comprobante verificadas en vistas del SHA, no como ejecuciones positivas.
Matriz integral en curso y sesiones agrupadas. QA integral y recorridos pendientes: no se emite estado de entrega integral.

2026-09-13 — Mi primera nómina, entrega parcial¶

Precisión editorial posterior del mismo corte: responsabilidades separadas entre RR. HH./administrador, operador y revisor; autenticación a cargo del PO sin compartir contraseñas. PR #17 permanece fuera del comportamiento disponible, según confirmación del PO de que está abierto. Se distinguen QA de portada, manual completo y ejecución funcional. La captura móvil prueba recorte inicial con barra interna visible, no columnas definitivamente inaccesibles. Estado conservado: INFOCENTER_PRIMERA_NOMINA_PARCIAL.

Canon xdiegob/BPSPayrollE, rama dev-fase3, Odoo.sh xdiegob-bpspayrolle. SHA remoto revalidado 067ec7a21cf049451cd349ae473e872883f98e77; build Development 37956195, Test: Success observado mediante extensión Edge. La tabla de canon de agosto más abajo se conserva como historia, no como destino de trabajo vivo.

Nueva sección al final de navegación: Mi primera nómina — Paso a paso.
Navegación real con Operador UAT en compañía D-19, sin cambiar sus permisos.
Bloqueo de acceso a Empleados por RR. HH. observado; recuperación pendiente.
H-8 declarado por la instalación del SHA y corroborado con vista de retención de consulta; no se produjo una aplicación mensual nueva.
Cuatro capturas reales, manifiesto v1.1-primera-nomina-manifiesto.csv en evidencia editorial.
No se crearon la compañía/trabajador del caso, ni cálculos, recibo o comprobante. Datos D-19 preexistentes se usan solo para mostrar pantallas, nunca para probar el ejemplo.
A 360 px la tabla de retención recorta importes y tiene desplazamiento interno: QA móvil del recorrido pendiente.
Esta entrega no acredita nómina real, cliente, transmisión ni pago.

Canon histórico de agosto de 2026¶

Toda afirmación funcional de esta wiki se ancla al código fusionado del repositorio canónico. Desde el 2026-08-08 el canon cambió de repositorio y de proyecto Odoo.sh; las versiones anteriores de esta wiki citaban el canon antiguo.

Elemento	Valor vigente	Reemplaza a
Repositorio	`xdiegob/PayrollBPS`	`xdiegob/BPSNomina` (congelado)
Rama funcional	`dev-fase3`	—
Proyecto Odoo.sh	`xdiegob-payrollbps`	`xdiegob-bpsnomina` (eliminado al vencer su trial)

Un SHA no es un adorno

Si una guía no declara el commit sobre el que fue verificada, trátela como no verificada. El producto cambia más rápido que la wiki.

V1.1 — Ficha de verificación¶

Dato	Valor
Versión de la entrega	V1.1 (parcial: Onda 0 + Onda 1 documental, reanclada)
Fecha de verificación	2026-08-10
Código observado	`4b0f549dd72d6d61dd1eb181d165dbe48459480f`
Rama	`dev-fase3` de `xdiegob/PayrollBPS`
Último cambio incorporado	Merge del PR #5 (2026-08-10, 15:27)
Entorno	Odoo.sh `xdiegob-payrollbps`, Development, build 36201289, `Test: Success`
Rol usado	Sesión administradora sin ningún grupo BPS
Datos	Demostración/sintéticos. Sin datos personales reales
Estado externo	No aplica. Ninguna afirmación de aceptación DIAN, MiPlanilla, banco ni pago

Qué se verificó y cómo¶

Código: lectura directa de modelos, vistas, menús, grupos y reportes en el commit exacto.
Runtime: consultas de solo lectura al build verde: 17 módulos bps_nomina_* instalados, árbol de 176 opciones en trece contenedores, 24 asistentes, grupos que gobiernan el menú raíz, acciones de servidor y tareas programadas.
Interfaz: verificada la puerta de entrada (aplicación ausente del lanzador sin rol BPS) y la operabilidad declarada de cada operación del ciclo mensual, recorriendo todas las vistas en busca del botón que la dispara.

Movimientos del código incorporados en esta revisión¶

Fecha	Cambio	Efecto en la wiki
2026-08-10 11:01	Merge del PR #6	Superficie nueva: dependencias externas gobernadas, auditoría de base parafiscal y tipo de cotizante en el empleado
2026-08-10 15:27	Merge del PR #5	Habilitación de UAT de negocio y aprovisionador de ambiente sintético D-19

Qué NO se pudo verificar en esta entrega¶

Pendiente	Causa concreta
Recorridos con rol BPS (operador, auditor)	La sesión no tiene ninguno de los grupos BPS, y el PO decidió no modificar ningún ambiente en esta entrega
Capturas de formularios, resultados y gates	La base del build trae datos de demostración de Odoo, sin nómina BPS sembrada: los formularios se fotografiarían vacíos
Vista angosta (≤ 500 px) de pantallas Odoo	La herramienta de navegador no puede reducir el viewport: queda fijo en 1536 px CSS

Un bloqueo anterior quedó resuelto

La revisión previa registró que ninguna vista de acción renderizaba contenido en el build 36148957. En el build 36201289 el problema no se reproduce: las vistas renderizan con normalidad, comprobado con Empleados de Odoo estándar. La causa era del build, no del producto.

Estas ausencias están listadas una a una en Convenciones de capturas.

V1.0 — Base visual Pre-UAT¶

Arquitectura por objetivos de usuario, no por árbol de menús.
Capturas reales de una instancia Odoo.sh de Development con datos de demostración, tomadas sobre el canon antiguo (xdiegob-bpsnomina).
Cobertura de instalación, seguridad, operación mensual, PILA, DSNE, banco, retención, reportes, límites y evidencia.
Separación explícita entre control local y aceptación por terceros.

La V1.0 se conserva como evidencia histórica

Sus capturas siguen en assets/screenshots/v1.0/ y no se sobrescriben. Algunas ya no reproducen el comportamiento actual; cuando es así, la guía correspondiente lo dice en el pie de la imagen.

Cómo actualizar una guía¶

Revalide el SHA vivo de dev-fase3 en xdiegob/BPSPayrollE. No reutilice el SHA de una entrega anterior.
Confirme que la capacidad está fusionada, no en una rama ni en un PR abierto.
Verifique la funcionalidad en el entorno autorizado, con el rol real.
Capture solo datos de demostración o previamente anonimizados.
Guarde la imagen en assets/screenshots/v<versión>/<frente>/ y registre su procedencia en evidence/v<versión>-manifiesto-capturas.csv.
Actualice la ficha de verificación de la guía con el SHA, la fecha, el entorno y el rol.
Declare cualquier límite externo; no convierta un pendiente en capacidad productiva.
Ejecute mkdocs build --strict antes de dar por terminada la entrega.