--- name: finora-autor-documental description: > Cómo escribir, identificar, versionar y entregar un documento para la biblioteca de FINORA Nexus siguiendo el estándar documental de FINORA: código FIN-<ÁREA>--, ficha de control en la primera página, versiones 0.x / 1.0, clasificación (Público, Uso interno, Confidencial, Restringido), tabla de control de cambios, reglas de contenido (PAN solo enmascarado 6 + 4, ningún secreto, ningún nombre de cliente en material público, nunca afirmar una certificación que no se tiene) y las validaciones automáticas que aplica Nexus al subir un PDF. Trigger: cuando un desarrollador o integrador externo prepara un documento, manual, guía o informe para entregarlo a FINORA o publicarlo en FINORA Nexus; o se menciona "código FIN-", "ficha de control", "FINORA Nexus", "subir a Nexus", "clasificación del documento", "control de cambios". license: Apache-2.0 metadata: author: FINORA version: "1.0" --- ## When to Use - Vas a entregar a FINORA un documento formal (guía de integración, manual, informe técnico, evidencia de pruebas). - Tienes que elegir el código, la versión o la clasificación de un documento. - Una subida a FINORA Nexus fue rechazada y necesitas saber por qué. - Vas a generar un PDF desde Markdown, HTML o un procesador de texto y quieres que pase las validaciones a la primera. No la uses para: código fuente (va en su repositorio), páginas de tutoriales (van en la Academy) ni credenciales (nunca viajan en un documento). ## Critical Patterns ### 1. Código del documento Formato `FIN-<ÁREA>--`: `FIN-MER-2026-GIN`, `FIN-CORE-2026-MOP`. | Área | Uso | Área | Uso | |---|---|---|---| | GOB | Gobierno, estándares, índices | CERT | Certificaciones y cumplimiento | | ARQ | Arquitectura y diseño transversal | PCI | Programa PCI | | CORE | FINORA Core | ISO | Sistema de gestión ISO/IEC 27001 | | CMS | FINORA Emisión (CMS) y emisor | REG | Regulatorio | | SW | Switch Aurora y Aurora Office | MC / VI | Marcas de tarjeta | | MER | FINORA Merchant, portal y apps de cobro | LEG | Legal | | ERP | FINORA ERP | VEN | Material comercial | | COM | FINORA Commerce | OPS | Operación, instalación, infraestructura | | GC | FINORA Gift Cards | | | - `AAAA` = año de emisión. `SIGLA` = 2 a 8 letras o dígitos en mayúsculas (iniciales del título). - Si no tienes código, pide a tu contacto FINORA que lo asigne: Nexus propone el siguiente libre. El código **no cambia** entre versiones. - Nombre del archivo: `_[_AAAAMMDD].pdf`, sin espacios ni acentos. ### 2. Ficha de control (primera página, obligatoria) | Campo | Valor | |---|---| | Título | … | | Código | FIN-ÁREA-AAAA-SIGLA | | Versión | 1.0 | | Fecha | dd-mmm-aaaa (p. ej. 27-oct-2026) | | Sistema o corte | Producto y versión a los que aplica | | Clasificación | Público / Uso interno / Confidencial / Restringido | | Autor · Revisor · Aprobador | Nombres | Nexus **lee el texto de la primera página** y rechaza el PDF si el código no aparece en ella. Si exportas desde una imagen escaneada, el código no será legible: exporta con texto real. ### 3. Versiones - `0.x` = borrador: nunca sale a un cliente. - `1.0` = primera emisión aprobada; `1.1`, `1.2`… cambios menores; `2.0` = cambio de alcance. - Cada versión nueva debe ser **mayor** que la vigente del mismo código; Nexus rechaza repetir o retroceder. - Todo documento termina con una tabla **Control de cambios** (Versión · Fecha · Autor · Cambio). ### 4. Clasificación | Nivel | Quién lo ve en Nexus | |---|---| | Público | Cualquiera, sin sesión | | Uso interno | Solo el equipo FINORA | | Confidencial | Organizaciones con una concesión vigente del producto y del nivel (comercial, técnico, operación, auditoría); opcionalmente, solo una organización destinataria | | Restringido | Nunca se publica en Nexus | Ante la duda, clasifica más alto. Un documento Restringido (llaves, credenciales) no se sube: se entrega cifrado por el canal que indique FINORA. ### 5. Reglas de contenido (Nexus las verifica) - **PAN**: solo enmascarado `6 + 4` (`411111******1111`). Nexus detecta números de 13 a 19 dígitos con prefijo de marca y dígito de control Luhn válido, con o sin espacios, y rechaza el PDF. - **Secretos**: ninguna clave privada (`-----BEGIN … PRIVATE KEY-----`), token, llave de API, cadena de conexión con contraseña ni `clave = valor`. Usa marcadores: ``. - **Material Público**: sin nombres de clientes, prospectos, aliados ni competidores; compara por categorías ("un banco regional", "el procesador"). Nexus aplica, además, la lista de términos prohibidos que FINORA tenga configurada. - **Certificaciones**: nunca afirmes una certificación que no exista; usa "alineado con", "diseñado conforme a", "en preparación". Las certificaciones de Nexus son internas de FINORA, no de redes ni normas. - **Evidencia**: marca las afirmaciones técnicas con `[Verificado en código]`, `[Verificado en entorno]`, `[No verificado]` o `[Asunción de diseño]`. ### 6. Qué pasa después de subir 1. Nexus valida (tipo PDF, tamaño, formato del código, versión, código en la primera página, PAN, secretos, términos). 2. Si pasa, la versión queda **pendiente de aprobación**. 3. **Otra persona** del equipo FINORA la revisa y la aprueba (quien sube nunca aprueba: control a cuatro ojos). 4. Al aprobarse, se publica y la versión anterior queda **superada** (se conserva). 5. Cada descarga lleva una **marca de agua** con el nombre, la organización, la fecha y hora y el código, y queda registrada. ## Commands ```bash # Comprobar que el código aparece en la primera página del PDF (poppler-utils) pdftotext -f 1 -l 1 MI_DOCUMENTO.pdf - | grep -c "FIN-MER-2026-GIN" # Buscar posibles PAN sin enmascarar antes de entregar (13–19 dígitos seguidos) pdftotext MI_DOCUMENTO.pdf - | grep -nE '([0-9][ -]?){13,19}' # Buscar secretos evidentes pdftotext MI_DOCUMENTO.pdf - | grep -niE 'BEGIN .*PRIVATE KEY|password *[:=]|api[_-]?key *[:=]|://[^ :]+:[^ @]+@' # Huella SHA-256 que se registrará para el archivo shasum -a 256 MI_DOCUMENTO.pdf ``` Plantilla en Markdown: `PLANTILLA_DOCUMENTO.md` (junto a este archivo). Guía completa: página «Guía para autores» de FINORA Nexus.