Knowledge Portal Consistency Review 001

Fecha de auditoria: 2026-06-10

Estado: AUDITORIA COMPLETADA

Estado posterior: PUBLICACION VALIDADA

Modo: GOVERNANCE + VALIDATE

Resultado: ROJO

Resultado posterior: VERDE

Scope: OpenClaw Knowledge Portal / documentacion visible

1. Objetivo

Verificar si la documentacion marcada o clasificada como relevante para el OpenClaw Knowledge Portal esta publicada, accesible y alineada con el repositorio actual.

Esta auditoria no modifica navegacion, no despliega portal, no toca runtime, no toca VPS, no toca Docker y no regenera el portal publicado.

2. Safe point

Control	Resultado
git status -sb	## main...origin/main
git rev-parse HEAD	261b637dff4ca8e62df859b3e2069b3808cc2bfc

3. Fuentes revisadas

Lectura normativa y operativa:

• CODEX.md
• docs/governance/PROJECT-CONSTITUTION.md
• docs/governance/ACTIVE-CONTEXT.md
• docs/governance/documentation/DOCUMENT-HIERARCHY.md
• docs/governance/documentation/OPENCLAW-BLUEPRINT-GOVERNANCE-MODEL.md
• docs/governance/documentation/BLUEPRINT-AUTHORING-STANDARD.md
• mkdocs.yml
• docs/governance/README.md
• docs/governance/INDEX.md

Evidencia tecnica:

• mkdocs.yml: site_url = https://doc.alpuntodeventa.com.ar/
• https://doc.alpuntodeventa.com.ar/search/search_index.json
• URLs directas esperadas del portal publicado
• build local estricto con .venv-portal\Scripts\mkdocs.exe build --strict

4. Criterio de clasificacion

Fuente de criterio: docs/governance/documentation/DOCUMENT-HIERARCHY.md.

Categorias usadas:

• visible esperado: debe aparecer en el portal por autoridad, blueprint, contrato, evidencia relevante o guia estable.
• technical_reference: puede aparecer como soporte tecnico, pero no debe promocionarse como documento rector.
• internal_only: no debe exponerse navegablemente por sensibilidad, credenciales, runtime, seguridad o detalle operativo interno.
• pending_review: requiere decision humana antes de publicarse.

5. Inventario esperado

Documento	Ruta repo	Categoria	Base de clasificacion	Navegable en mkdocs.yml
Project Constitution	docs/governance/PROJECT-CONSTITUTION.md	visible esperado	DOCUMENT-HIERARCHY.md	SI
Document Hierarchy	docs/governance/documentation/DOCUMENT-HIERARCHY.md	visible esperado	marca directa portal_visible = yes	SI
OpenClaw Blueprint Governance Model	docs/governance/documentation/OPENCLAW-BLUEPRINT-GOVERNANCE-MODEL.md	visible esperado	marca directa portal_visible = yes	SI
Blueprint Authoring Standard	docs/governance/documentation/BLUEPRINT-AUTHORING-STANDARD.md	visible esperado	marca directa portal_visible = yes	SI
Business Observer README	docs/tenants/alpuntodeventa/business-observer/README.md	visible esperado	marca directa portal_visible = yes	SI
Business Observer Blueprints README	docs/tenants/alpuntodeventa/business-observer/blueprints/README.md	visible esperado	marca directa portal_visible = yes	SI
Customer Blueprint	docs/tenants/alpuntodeventa/business-observer/blueprints/CUSTOMER-BLUEPRINT.md	visible esperado	clasificado por README de blueprints	SI
Product Blueprint	docs/tenants/alpuntodeventa/business-observer/blueprints/PRODUCT-BLUEPRINT.md	visible esperado	clasificado por README de blueprints	SI
Sales Blueprint	docs/tenants/alpuntodeventa/business-observer/blueprints/SALES-BLUEPRINT.md	visible esperado	clasificado por README de blueprints	SI
Ownership Blueprint	docs/tenants/alpuntodeventa/business-observer/blueprints/OWNERSHIP-BLUEPRINT.md	visible esperado	clasificado por README de blueprints	SI
Territory Blueprint	docs/tenants/alpuntodeventa/business-observer/blueprints/TERRITORY-BLUEPRINT.md	visible esperado	clasificado por README de blueprints	SI
Business Observer Data Contract 001	docs/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-DATA-CONTRACT-001.md	visible esperado	DOCUMENT-HIERARCHY.md y README local	SI
Source Authority Registry	docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-AUTHORITY-REGISTRY.md	visible esperado	registro oficial de autoridad, navegable localmente	SI
Source Authority SQL	docs/tenants/alpuntodeventa/business-observer/source-authority/*.sql	technical_reference o internal_only	README local, segun sensibilidad	SI, hoy expuesto en nav local
SOURCE-003 Snapshot 001	docs/tenants/alpuntodeventa/business-observer/SOURCE-003-SNAPSHOT-001.md	visible esperado	evidencia relevante sin datos personales expuestos	SI
SOURCE-003 Tabla 2 Column Dictionary	docs/tenants/alpuntodeventa/business-observer/data-dictionary/SOURCE-003-TABLA2-COLUMN-DICTIONARY.md	visible esperado	marca directa portal_visible = yes	SI
SOURCE-003 Sales Items Column Mapping	docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-SALES-ITEMS-COLUMN-MAPPING.md	visible esperado	marca directa portal_visible = yes	SI
SOURCE Secrets Preflight 001	docs/tenants/alpuntodeventa/business-observer/sources/SOURCE-SECRETS-PREFLIGHT-001.md	internal_only	contenido vinculado a credenciales y preflight seguro	NO
Auditorias funcionales historicas APV	docs/tenants/alpuntodeventa/business-observer/*AUDIT*.md	pending_review	evidencia historica no necesariamente rectora	NO

6. Inventario observado en repositorio

Control	Resultado
Entradas de nav en mkdocs.yml	160
Paginas esperadas derivadas de nav	159
Archivos md o sql bajo docs/	292
Targets de nav inexistentes	0
Archivos md o sql no navegables	133
Archivos con marca directa portal_visible = ...	8
Build local estricto	PASS

Lectura:

• La navegacion local actual no apunta a archivos inexistentes.
• El build local genera las paginas esperadas de governance, blueprints, contrato, registry, snapshot, diccionario y mapping.
• Hay muchos documentos navegables sin marca directa portal_visible; varios quedan clasificados por README local o por DOCUMENT-HIERARCHY.md.
• Hay documentos creados pero no navegables; no todos son faltantes, porque varios corresponden a auditorias antiguas, evidencia historica o contenido interno.

7. Consistencia mkdocs.yml

Resultado local: VERDE.

Hallazgos:

• mkdocs.yml incluye los documentos minimos esperados.
• No se detectaron targets inexistentes en nav.
• mkdocs build --strict paso en build local.
• Existe una duplicacion de navegacion para: tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-QUERY-DELTA-REVIEW.md con dos labels: SOURCE-003 Query Delta Review y Source 003 Query Delta Review.
• validation.nav.omitted_files = ignore evita que los 133 archivos omitidos sean warning de build; por eso la decision de exposicion debe gobernarse documentalmente y no solo por el build.

8. Documentos creados pero no navegables

Omitidos relevantes detectados bajo Business Observer APV:

Documento	Clasificacion recomendada	Lectura
BUSINESS-OBSERVER-AUDIT-001.md	pending_review	auditoria funcional historica
BUSINESS-OBSERVER-GAP-AUDIT-001.md	pending_review	auditoria funcional historica
BUSINESS-OBSERVER-KPI-AND-GOALS-AUDIT-001.md	pending_review	auditoria funcional historica
GOALS-GOVERNANCE-AUDIT-001.md	pending_review	auditoria funcional historica
PRICING-AUDIT-001.md	pending_review	auditoria documental historica
UC006-PRICING-SCOPE-AUDIT.md	pending_review	auditoria de alcance historica
GROWTH-PLACEMENT-RULES.md	pending_review	puede estar reemplazado o resumido por docs vigentes
IMPACT-AND-LEARNING.md	pending_review	definicion funcional no navegable
UNSERVED-DEMAND.md	pending_review	definicion funcional no navegable
sources/SOURCE-SECRETS-PREFLIGHT-001.md	internal_only	menciona migracion de credenciales y rutas sensibles

No se recomienda publicar esos documentos automaticamente sin revision humana.

9. Portal publicado observado

Portal auditado: https://doc.alpuntodeventa.com.ar/.

Evidencia del indice publicado:

Control	Resultado
search_index.json accesible	SI
bytes de search_index.json	1078058
entradas de busqueda	1915
paginas unicas publicadas en indice	201
paginas actuales de nav faltantes en indice publicado	75
paginas publicadas que ya no estan en nav actual	117

Terminos esperados no encontrados en el indice publicado:

• Business Observer
• Blueprint
• Project Constitution
• Document Hierarchy
• SOURCE-003

Lectura:

• El portal publicado esta accesible.
• El portal publicado no representa el estado actual del repo.
• El portal publicado conserva paginas de una navegacion anterior y omite la capa nueva de governance documental y Business Observer.

10. Prueba de URLs directas publicadas

Las URLs esperadas devuelven HTTP 200, pero el contenido observado es el mismo fallback con marcador de Page not found, hash de muestra ccc4200e82ffcf08, y no contiene los encabezados esperados.

Documento	URL esperada	Estado publicado
Project Constitution	https://doc.alpuntodeventa.com.ar/governance/PROJECT-CONSTITUTION/	NO aparece, fallback
Document Hierarchy	https://doc.alpuntodeventa.com.ar/governance/documentation/DOCUMENT-HIERARCHY/	NO aparece, fallback
OpenClaw Blueprint Governance Model	https://doc.alpuntodeventa.com.ar/governance/documentation/OPENCLAW-BLUEPRINT-GOVERNANCE-MODEL/	NO aparece, fallback
Blueprint Authoring Standard	https://doc.alpuntodeventa.com.ar/governance/documentation/BLUEPRINT-AUTHORING-STANDARD/	NO aparece, fallback
Business Observer Overview	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/	NO aparece, fallback
Business Observer Blueprints	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/	NO aparece, fallback
Customer Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/CUSTOMER-BLUEPRINT/	NO aparece, fallback
Product Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/PRODUCT-BLUEPRINT/	NO aparece, fallback
Sales Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/SALES-BLUEPRINT/	NO aparece, fallback
Ownership Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/OWNERSHIP-BLUEPRINT/	NO aparece, fallback
Territory Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/TERRITORY-BLUEPRINT/	NO aparece, fallback
Data Contract 001	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-DATA-CONTRACT-001/	NO aparece, fallback
Source Authority Registry	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-AUTHORITY-REGISTRY/	NO aparece, fallback
SOURCE-003 Snapshot 001	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/SOURCE-003-SNAPSHOT-001/	NO aparece, fallback
SOURCE-003 Tabla 2 Column Dictionary	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/data-dictionary/SOURCE-003-TABLA2-COLUMN-DICTIONARY/	NO aparece, fallback
SOURCE-003 Sales Items Column Mapping	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/design/SOURCE-003-SALES-ITEMS-COLUMN-MAPPING/	NO aparece, fallback

11. Business Observer especifico

Frente	Debe ser visible	Estado repo	Estado portal publicado	Clasificacion
Blueprints	SI	README y 5 blueprints en nav local	NO aparece	visible esperado
Data Contract	SI	en nav local	NO aparece	visible esperado
Source Authority Registry	SI	en nav local	NO aparece	visible esperado
Source Authority SQL	DEPENDE	SQL en nav local	NO aparece	technical_reference o internal_only
Snapshot docs	SI, si no exponen datos personales	SOURCE-003-SNAPSHOT-001.md en nav local	NO aparece	visible esperado
Diccionarios	SI	diccionario y mapping con marca directa portal_visible = yes	NO aparece	visible esperado
Preflight de secretos	NO	no navegable localmente	NO aparece	internal_only
Auditorias funcionales antiguas	NO automatico	no navegables localmente	NO aparece	pending_review

Decision de exposicion recomendada:

• publicar blueprints, data contract, registry, snapshot, diccionario y mapping cuando se sincronice el portal con main.
• no publicar automaticamente SOURCE-SECRETS-PREFLIGHT-001.md.
• revisar sensibilidad de los SQL de source authority antes de decidir si siguen navegables como technical_reference o pasan a internal_only.

12. Diferencias principales

Diferencia	Impacto
El repo y mkdocs.yml tienen la capa nueva de governance y Business Observer, pero el portal publicado no.	Los usuarios del portal no ven la autoridad documental actual.
Las URLs directas esperadas resuelven a fallback con Page not found.	El HTTP 200 puede ocultar faltantes reales si solo se valida status code.
El indice publicado tiene 117 paginas que ya no estan en la nav actual.	El portal publico conserva contenido stale y puede inducir decisiones con informacion vieja.
Hay 75 paginas de la nav actual ausentes del indice publicado.	La publicacion esta desalineada con el repo.
Varios documentos navegables no tienen marca directa portal_visible.	La clasificacion depende de README o regla general, menos auditable por documento.
SOURCE-003-QUERY-DELTA-REVIEW.md esta duplicado en nav.	No rompe build, pero ensucia navegacion y busqueda.

13. Documentos faltantes en portal publicado

Faltantes criticos:

• governance/PROJECT-CONSTITUTION/
• governance/documentation/DOCUMENT-HIERARCHY/
• governance/documentation/OPENCLAW-BLUEPRINT-GOVERNANCE-MODEL/
• governance/documentation/BLUEPRINT-AUTHORING-STANDARD/
• tenants/alpuntodeventa/business-observer/
• tenants/alpuntodeventa/business-observer/blueprints/
• tenants/alpuntodeventa/business-observer/blueprints/CUSTOMER-BLUEPRINT/
• tenants/alpuntodeventa/business-observer/blueprints/PRODUCT-BLUEPRINT/
• tenants/alpuntodeventa/business-observer/blueprints/SALES-BLUEPRINT/
• tenants/alpuntodeventa/business-observer/blueprints/OWNERSHIP-BLUEPRINT/
• tenants/alpuntodeventa/business-observer/blueprints/TERRITORY-BLUEPRINT/
• tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-DATA-CONTRACT-001/
• tenants/alpuntodeventa/business-observer/source-authority/SOURCE-AUTHORITY-REGISTRY/
• tenants/alpuntodeventa/business-observer/SOURCE-003-SNAPSHOT-001/
• tenants/alpuntodeventa/business-observer/data-dictionary/SOURCE-003-TABLA2-COLUMN-DICTIONARY/
• tenants/alpuntodeventa/business-observer/design/SOURCE-003-SALES-ITEMS-COLUMN-MAPPING/

14. Navegacion faltante o incorrecta

Faltante publicado:

• toda la seccion nueva de Business Observer APV
• documentos nuevos de governance/documentation
• ACTIVE-CONTEXT y PROJECT-CONSTITUTION

Incorrecto o desactualizado:

• el portal publicado conserva paginas que ya no pertenecen a la navegacion actual, por ejemplo MULTI-APP-VPS-GOVERNANCE/, OPENCLAW-FUNCTIONAL-VALIDATION/, DOCKER-ARCHITECTURE/ y varias paginas antiguas bajo governance/knowledge/docker/*.

Duplicado local:

• SOURCE-003-QUERY-DELTA-REVIEW.md aparece dos veces en mkdocs.yml.

15. Impacto

Clasificacion de impacto: ALTO.

Motivos:

• la fuente de verdad en Git esta mas avanzada que el portal publicado.
• el portal publicado no sirve hoy como superficie confiable para auditar la capa de blueprints, contrato de datos, diccionarios ni snapshot de Business Observer APV.
• un lector externo podria creer que la metodologia de blueprint governance no existe, aunque ya esta en repo y build local.
• validar solo HTTP 200 daria un falso positivo porque el portal devuelve fallback para rutas inexistentes.

16. Recomendaciones

1. Publicar el portal desde el main actual en una ventana aprobada, sin modificar contenido durante el deploy.
2. Antes del deploy, decidir si los SQL de source-authority deben permanecer como technical_reference navegable o pasar a internal_only.
3. En una tarea documental separada, agregar marca directa portal_visible a los documentos navegables clave que hoy dependen solo de README o regla general.
4. En una tarea separada, eliminar la duplicacion de nav de SOURCE-003-QUERY-DELTA-REVIEW.md.
5. Mantener fuera de nav SOURCE-SECRETS-PREFLIGHT-001.md.

17. Resultado

Resultado general: ROJO.

La documentacion relevante existe en el repositorio y la build local estricta la puede generar correctamente, pero el portal publicado no esta alineado con el estado actual de main.

No se detecto falla de build local ni target inexistente en mkdocs.yml. La falla esta en la exposicion publicada.

18. Checklist de alcance

• sin runtime: SI
• sin deploy: SI
• sin VPS: SI
• sin Docker: SI
• sin regenerar portal publicado: SI
• auditoria completada: SI
• evidencia concreta: SI
• docs validadas localmente: SI
• repo limpio al inicio: SI

19. Addendum de publicacion controlada

Fecha/hora de publicacion: 2026-06-10 22:27 -0300 (America/Buenos_Aires).

HEAD publicado: 2e84fb979e80c490cb3c3d9322989d8582b11e73.

Safe point local

Control	Resultado
git status -sb	## main...origin/main
git rev-parse HEAD	2e84fb979e80c490cb3c3d9322989d8582b11e73
rama local	main
origin/main	2e84fb979e80c490cb3c3d9322989d8582b11e73

Metodo de publicacion usado

Metodo documentado: docs/governance/runbooks/SYNC-KNOWLEDGE-PORTAL-FROM-GIT.md y docs/governance/runbooks/MAINTAIN-KNOWLEDGE-PORTAL.md.

Destino remoto: /opt/openclawai en el VPS srv977009.

Comando de publicacion ejecutado: bash /opt/openclawai/infra/knowledge-portal/deploy-knowledge-portal.sh.

Comando de build:

• gate local: .\.venv-portal\Scripts\mkdocs.exe build --strict
• gate remoto: mkdocs build --strict dentro del Dockerfile

Servicio publicado:

• contenedor: knowledge-portal
• compose: /opt/openclawai/infra/knowledge-portal/docker-compose.yml
• bind local: 127.0.0.1:8085 -> 8085
• publicacion externa: Nginx Proxy Manager
• upstream NPM: knowledge-portal:8085

Lectura operativa: el portal se sirve desde un build estatico generado por MkDocs dentro de la imagen Docker del contenedor knowledge-portal, y queda publicado por NPM.

Resultado de publicacion

El script oficial hizo fetch y pull --ff-only desde origin/main, aplico fast-forward remoto de e1ec36d5b9c272fe68965d0175524368fe0f4258 a 2e84fb979e80c490cb3c3d9322989d8582b11e73, ejecuto build estricto en Docker, recreo el contenedor knowledge-portal y valido: http://127.0.0.1:8085/ -> 200.

No se editaron documentos durante la publicacion. No se tocaron OpenClaw runtime, PostgreSQL, queries, Business Observer, NPM ni mkdocs.yml.

No hubo rollback.

Validaciones publicas

https://doc.alpuntodeventa.com.ar/search/search_index.json:

Control	Resultado
HTTP status	200
bytes observados	2993989
contiene Business Observer	SI
contiene Blueprint	SI
contiene Project Constitution	SI
contiene Document Hierarchy	SI
contiene SOURCE-003	SI

URLs publicas validadas con HTTP 200, contenido esperado y sin fallback Page not found:

Documento	URL
Tenant APV	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/
Project Constitution	https://doc.alpuntodeventa.com.ar/governance/PROJECT-CONSTITUTION/
Document Hierarchy	https://doc.alpuntodeventa.com.ar/governance/documentation/DOCUMENT-HIERARCHY/
Blueprint Governance Model	https://doc.alpuntodeventa.com.ar/governance/documentation/OPENCLAW-BLUEPRINT-GOVERNANCE-MODEL/
Blueprint Authoring Standard	https://doc.alpuntodeventa.com.ar/governance/documentation/BLUEPRINT-AUTHORING-STANDARD/
Customer Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/CUSTOMER-BLUEPRINT/
Product Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/PRODUCT-BLUEPRINT/
Sales Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/SALES-BLUEPRINT/
Ownership Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/OWNERSHIP-BLUEPRINT/
Territory Blueprint	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/blueprints/TERRITORY-BLUEPRINT/
SOURCE-003 Snapshot	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/SOURCE-003-SNAPSHOT-001/
SOURCE-003 Column Dictionary	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/data-dictionary/SOURCE-003-TABLA2-COLUMN-DICTIONARY/
SOURCE-003 Column Mapping	https://doc.alpuntodeventa.com.ar/tenants/alpuntodeventa/business-observer/design/SOURCE-003-SALES-ITEMS-COLUMN-MAPPING/

Estado final

Estado final del portal: VERDE.

La recomendacion 1 de esta auditoria queda ejecutada: el portal publicado fue sincronizado desde main actual sin cambios de contenido durante el deploy. Las recomendaciones 2 a 5 quedan como mejoras documentales separadas y no fueron mezcladas con esta publicacion.