{
  "schemaVersion": "1.0.0",
  "formatVersion": "1.0.0",
  "brandVersion": "0.1.0",
  "slug": "pahfacturar",
  "name": "PahFacturar",
  "language": "es",
  "reviewedAt": "2026-09-08",
  "releaseStatus": "draft",
  "owner": "Equipo PahFacturar · Revisión de identidad pendiente",
  "headline": "Claridad para cada empresa.",
  "intro": "Identidad de PahFacturar. Contabilidad y facturación electrónica para empresas y firmas contables en Colombia.",
  "notice": "Manual 0.1.0 en revisión. La identidad documentada procede del sitio del producto. Las reglas nuevas son propuestas; no son aprobaciones.",
  "sources": [
    {
      "id": "site",
      "title": "Sitio público de PahFacturar · revisado el 8 de septiembre de 2026",
      "location": "https://pahfacturar.com/"
    },
    {
      "id": "visual",
      "title": "Identidad visual y procedencia pública",
      "location": "docs/decisions.md"
    },
    {
      "id": "proposal",
      "title": "Propuestas de uso del manual",
      "location": "docs/decisions.md"
    }
  ],
  "logo": {
    "path": "assets/pahfacturar-logo-original-v1.svg",
    "alt": "Símbolo F de PahFacturar con degradado esmeralda y cian",
    "width": 32,
    "height": 32,
    "status": "documented",
    "source": "visual",
    "rights": "Símbolo del sitio de PahFacturar. Se reproduce para identificar la marca. No se concede una licencia de uso a terceros."
  },
  "colors": [
    {
      "id": "field",
      "name": "Blanco",
      "value": "#FFFFFF",
      "use": "Fondo principal.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "ink",
      "name": "Tinta",
      "value": "#0F172A",
      "use": "Texto y títulos.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "emerald",
      "name": "Esmeralda",
      "value": "#059669",
      "use": "Color principal; evitar texto normal sobre blanco.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "sea",
      "name": "Esmeralda oscuro",
      "value": "#047857",
      "use": "Enlaces y texto sobre blanco.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "accent",
      "name": "Cian",
      "value": "#06B6D4",
      "use": "Acento gráfico; no usar como texto sobre blanco.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "mint",
      "name": "Menta",
      "value": "#A7F3D0",
      "use": "Detalles del símbolo y fondos de apoyo.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "cyan-dark",
      "name": "Cian oscuro",
      "value": "#0E7490",
      "use": "Extremo del degradado del símbolo.",
      "status": "documented",
      "source": "visual"
    },
    {
      "id": "emerald-light",
      "name": "Esmeralda claro",
      "value": "#10B981",
      "use": "Inicio del degradado del símbolo.",
      "status": "documented",
      "source": "visual"
    }
  ],
  "semantic": {
    "background": "field",
    "text": "ink",
    "heading": "ink",
    "link": "sea",
    "actionBackground": "sea",
    "actionText": "field",
    "inverseBackground": "ink",
    "inverseText": "field",
    "focus": "sea"
  },
  "fonts": {
    "display": "\"Space Grotesk Variable\", \"Space Grotesk\", system-ui, sans-serif",
    "body": "ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
    "mono": "\"JetBrains Mono\", ui-monospace, monospace",
    "status": "documented",
    "source": "visual",
    "note": "Space Grotesk para títulos; sistema operativo para texto; JetBrains Mono para datos. Archivos locales bajo SIL OFL 1.1. Las licencias acompañan las descargas."
  },
  "contrastPairs": [
    [
      "ink",
      "field"
    ],
    [
      "sea",
      "field"
    ],
    [
      "field",
      "sea"
    ],
    [
      "emerald",
      "field"
    ],
    [
      "accent",
      "field"
    ],
    [
      "ink",
      "mint"
    ]
  ],
  "sections": [
    {
      "id": "esencia",
      "title": "Esencia",
      "lead": "Una marca para el trabajo contable.",
      "items": [
        {
          "title": "Propósito",
          "text": "Ayudar a empresas y firmas contables de Colombia a organizar su contabilidad y facturación electrónica.",
          "status": "documented",
          "source": "site"
        },
        {
          "title": "Audiencia",
          "text": "Empresas y equipos contables que administran uno o varios NITs.",
          "status": "documented",
          "source": "site"
        },
        {
          "title": "Límites del mensaje",
          "text": "Describir operaciones concretas. No añadir certificaciones, garantías de cumplimiento ni resultados sin una fuente vigente.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "logotipo",
      "title": "Logotipo",
      "lead": "Conservar el símbolo y su construcción.",
      "items": [
        {
          "title": "Símbolo original",
          "text": "La F blanca se sitúa en un cuadrado redondeado con degradado esmeralda y cian. El archivo conserva el dibujo del encabezado del sitio.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Nombre",
          "text": "Escribir PahFacturar con P y F mayúsculas. En el encabezado del sitio, Pah usa tinta y Facturar usa esmeralda oscuro.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Área libre y mínimo",
          "text": "Propuesta: dejar un margen de un cuarto del ancho del símbolo. Usar al menos 48 px en piezas nuevas. El sitio emplea un símbolo de 32 px.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Usos incorrectos",
          "text": "No estirar, recortar, girar ni cambiar el degradado. No presentar el favicon como una nueva versión del símbolo.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Variantes y derechos",
          "text": "Faltan un paquete maestro de marca y un registro de licencias para terceros. No se crean variantes negativas o monocromas.",
          "status": "missing",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "color",
      "title": "Color",
      "lead": "Esmeralda, cian y fondos claros.",
      "items": [
        {
          "title": "Paleta documentada",
          "text": "Los valores proceden de la configuración visual del sitio. Los nombres facilitan su consulta; no crean una aprobación nueva.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Contraste",
          "text": "Usar esmeralda oscuro para texto normal sobre blanco. Reservar esmeralda y cian claros para elementos gráficos.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Roles del manual",
          "text": "La asignación de tokens a las superficies del manual es una propuesta técnica con contraste verificado.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "tipografia",
      "title": "Tipografía",
      "lead": "Títulos con carácter. Texto fácil de leer.",
      "items": [
        {
          "title": "Familias",
          "text": "El sitio usa Space Grotesk para títulos, la pila del sistema para texto y JetBrains Mono para datos.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Jerarquía",
          "text": "Propuesta del formato: títulos amplios, párrafos con interlínea de 1,65 y datos en monoespaciada. Revisar cada composición en móvil.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Licencias",
          "text": "Las dos fuentes incluidas usan SIL Open Font License 1.1. Se conservan sus avisos. No se cargan fuentes remotas.",
          "status": "documented",
          "source": "visual"
        }
      ]
    },
    {
      "id": "imagenes",
      "title": "Imágenes",
      "lead": "Gráficos que explican el trabajo.",
      "items": [
        {
          "title": "Lenguaje visual",
          "text": "El sitio usa tarjetas redondeadas, líneas de cuadrícula y degradados esmeralda/cian.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Fotografía",
          "text": "No hay un banco de fotografía verificado para esta entrega. No se distribuyen fotografías de personas ni imágenes de terceros.",
          "status": "missing",
          "source": "proposal"
        },
        {
          "title": "Iconos y movimiento",
          "text": "Propuesta: iconos simples junto a texto. Evitar movimiento esencial y respetar la preferencia de movimiento reducido.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "voz",
      "title": "Voz",
      "lead": "Español directo y acciones concretas.",
      "items": [
        {
          "title": "Tratamiento",
          "text": "El sitio se dirige a la persona en segunda persona. Usa acciones como crear, configurar, emitir y consultar.",
          "status": "documented",
          "source": "site"
        },
        {
          "title": "Vocabulario",
          "text": "Usar empresa, equipo contable, NIT, factura y documento. Explicar las siglas cuando el contexto lo requiera.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Ejemplo de voz",
          "text": "Preferir «Consulta el estado de tu factura». Evitar «Tu cumplimiento está garantizado».",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "aplicaciones",
      "title": "Aplicaciones",
      "lead": "Ejemplos para revisar antes de usar.",
      "items": [
        {
          "title": "Composiciones",
          "text": "Las muestras siguientes aplican los tokens del manual. Son propuestas gráficas. No prueban funciones ni disponibilidad.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Contenido comercial",
          "text": "Consultar el sitio del producto para condiciones y oferta vigentes. No fijar precios ni métricas en piezas sin revisión.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "descargas",
      "title": "Descargas",
      "lead": "Activos locales con versión e integridad.",
      "items": [
        {
          "title": "Contenido",
          "text": "Se incluyen el símbolo, datos de marca, tokens y modelo de datos. El manifiesto registra SHA-256 de cada archivo.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Uso de activos",
          "text": "Los estados y fuentes forman parte de los datos. Descargar un archivo no equivale a aprobarlo ni concede derechos sobre la marca.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    },
    {
      "id": "mantenimiento",
      "title": "Mantenimiento",
      "lead": "Cambios trazables y revisión de identidad.",
      "items": [
        {
          "title": "Versión",
          "text": "Formato 1.0.0. Marca 0.1.0 en revisión. Evidencia consultada el 8 de septiembre de 2026.",
          "status": "documented",
          "source": "visual"
        },
        {
          "title": "Revisión",
          "text": "El equipo PahFacturar debe revisar márgenes, mínimos, ejemplos y roles semánticos antes de adoptarlos como reglas.",
          "status": "proposed",
          "source": "proposal"
        },
        {
          "title": "Adopción",
          "text": "Mantener las versiones, fuentes y estados al consumir los tokens. Registrar los cambios de identidad antes de actualizar piezas.",
          "status": "proposed",
          "source": "proposal"
        }
      ]
    }
  ],
  "examples": {
    "webTitle": "Cada empresa, en orden.",
    "webBody": "Una composición para explicar el trabajo contable con claridad.",
    "webAction": "Conoce la marca",
    "appTitle": "Tus empresas",
    "appBody": "Organiza el contexto antes de mostrar los datos.",
    "appAction": "Ver empresa",
    "commercialTitle": "Claridad en cada paso.",
    "commercialBody": "PahFacturar · Contabilidad y facturación electrónica en Colombia."
  },
  "specimens": {
    "heroCaption": "Símbolo documentado del sitio",
    "display": "Cada empresa.\nCada detalle.",
    "body": "Consulta la información de tu empresa y continúa con el siguiente paso.",
    "mono": "NIT · Factura · Estado",
    "logoCaption": "Margen de ¼ y mínimo de 48 px: propuestas. El dibujo original se conserva."
  },
  "semanticStatus": {
    "status": "proposed",
    "source": "proposal"
  },
  "logoSpec": {
    "clearSpaceRatio": 0.25,
    "minScreenPx": 48,
    "status": "proposed",
    "source": "proposal"
  }
}
