BACK END · Documentación

Cómo agregar un documento

La documentación del proyecto está en brochures_manuals/, en Markdown convertido desde PDF. Esta pantalla lee un índice generado (src/js/data/docs-index.js); no ve los cambios en las carpetas hasta regenerarlo.

1. Convertir el PDF a Markdown con markitdown (si falta: pip install "markitdown[pdf]"): markitdown "archivo.pdf" -o "brochures_manuals/<carpeta>/<nombre>.md"
2. Nombrarlo con el formato TIPO Modelo (N/P del documento, revisión, mes y año) - idioma.md, sin tildes ni caracteres especiales y con una ruta de menos de 240 caracteres. Ejemplo: MANUAL Modulator (25500059 A2 0519).md.
   TIPO: FOLLETO, MANUAL, CERTIFICADO UL, LISTADO CSFM, FICHA, FORMULARIO, CATALOGO, PRESENTACION, APLICACION, GUIA, PLANO, DATASHEET, INSTRUCTIVO, FOTO o PROTOCOLO. El sufijo - ES o - EN solo va cuando existen las dos versiones.
3. Guardarlo en la carpeta de su familia. La pestaña Cobertura por familia muestra la carpeta de cada una (algunas están “por crear”). Si es una familia nueva, agrégala en catalog/docs.json → families.
4. Si respalda un dato del catálogo: citarlo en catalog/products.json (sources) o en catalog/brochure-matrix.json (md) y quitar el verify correspondiente.
5. Actualizar el registro catalog/docs.json: marcar el pendiente como recibido (aquí, en Pendientes, y luego EXPORTAR JSON para reemplazar el archivo) o agregar pendientes nuevos. El formato está explicado en su campo notes.
6. Regenerar los datos desde la raíz del proyecto y recargar esta página: python tools/build_data.py python tools/docs_index.py build_data.py compila el catálogo y la matriz de folletos y verifica que las fuentes existan; docs_index.py regenera el índice de esta pantalla.

Ver los documentos completos

Con doble clic (file://) o en Vercel (solo se publica src/) el visor muestra el extracto guardado en el índice. Para leer el Markdown completo abre la app con el servidor local, desde la raíz del proyecto: