Doc Manager — documentación de calidad, como doc-as-code

Doc Manager — documentación de calidad, como doc-as-code

Acerca de mí

Un proyecto secundario que permite a los equipos de calidad de empresas del sector salud redactar, revisar y publicar su documentación regulatoria a partir de archivos Markdown versionados, y producir PDFs en su propio estilo corporativo.

Doc Manager — documentación de calidad, como doc-as-code

En el sector salud, la documentación de calidad — procesos, procedimientos, instrucciones, especificaciones, plantillas, control de cambios — debe cumplir con estrictos requisitos regulatorios. Doc Manager la mantiene en Markdown, versionada en Git: cada cambio es rastreado, atribuido y reversible. La herramienta hace que esta forma de trabajar sea usable por equipos de calidad compuestos por no desarrolladores: todo sucede en el navegador, sin necesidad de instalar nada más que Docker.

Muestra el árbol de documentos, con el texto fuente y su renderizado en PDF uno al lado del otro. Cada documento sigue su ciclo de vida: borrador, revisión, aprobación y luego obsolescencia. Se nombra a un autor, un revisor y un aprobador, y cada paso está vinculado a un commit. La exportación produce un único PDF en los colores de la empresa, con la referencia, la versión, la tabla de revisiones, la tabla de contenidos, el cuadro de aprobación y las iniciales. Los diagramas se escriben en Mermaid y se dibujan automáticamente. Los documentos existentes — Word, PowerPoint, Excel, PDF, incluso escaneados — se convierten a Markdown en la estación de trabajo, sin servicio externo, y luego se envían para su revisión.

Las verificaciones automáticas siguen comprobando que se cumplan las reglas de redacción: campos requeridos, un revisor distinto del autor, formatos de versión y fecha, enlaces válidos, nombrado de archivos. Los agentes de IA revisan la ortografía y el lenguaje de los documentos y reportan sus hallazgos. La herramienta está construida sobre la plataforma Board de Wexample, que orquesta el procesamiento, las verificaciones y los agentes.

Imágenes