Catálogo de plantillas vinculado por contrato.
El catálogo ejecutable pertenece a Firmas y Documentos. Style publica los puntos de integración y la guía visual, sin convertir un snapshot en otra fuente de verdad.
Accesos canónicos
Descubrimiento y render
GET /api/v1/templates
POST /api/v1/documents/render
Procedencia objetivo:
id
version
definition_sha256Estado observado del contrato
| Superficie | Estado al 25-08-2026 | Consecuencia |
|---|---|---|
| GET /api/v1/templates | Producción responde 200 y publica 13 plantillas; no incluye definition_sha256 | Sirve para descubrir. Todavía no prueba una definición exacta. |
| OpenAPI público | /openapi.json y /api/openapi.json responden 404 | No declarar referencia pública ni generar clientes desde producción. |
| POST /api/v1/documents/render | Existe en el candidato y en sus pruebas; no fue invocado contra producción | Tratar como candidato hasta promoverlo y verificarlo sin fabricar un documento real. |
| cis.document.v1 | Contrato semántico aceptado en core-document-engine d564c1c | El motor define el documento, pero aún no es una dependencia distribuida y obligatoria para todos los consumidores. |
Fuente canónica
| Recurso | Ubicación |
|---|---|
| Guía del motor | firmasydocumentos/docs/guides/motor-documental.md |
| Definiciones | firmasydocumentos/src/fyd_documents/templates.py |
| Lock verificable | firmasydocumentos/template-lock-v1.json |
| Integración Style | Esta página y el contrato DOC-* |
Galería Style
- Muestra anatomía, densidad, tablas, firmas, notas y gráficos con datos ficticios.
- Enlaza id y version del catálogo cuando existe una plantilla real.
- No ofrece un botón Renderizar si no existe autorización y backend.
- Distingue template contractual, documento de marca, reporte de datos y export técnico.
- Incluye impresión, páginas largas, saltos, idioma, zonas horarias y cifras tabulares.
Caché y cambios
La lista puede refrescarse con caché corta. El objetivo es identificar una definición por version y definition_sha256 y rechazar drift antes de producir un documento final. Producción aún no entrega ese hash: el consumidor no debe inventarlo ni presentar el resultado como reproducible.
Decisiones
Usa el identificador para confirmar, modificar o rechazar una regla.
DOC-TPL-01Cobertura incompletaGET /api/v1/templates descubre el catálogo en producción. El render existe en el candidato, pero falta promoción y verificación pública del contrato.
DOC-TPL-02Pendiente de aprobaciónid, version y definition_sha256 forman la procedencia mínima objetivo; el catálogo vivo todavía no publica el hash.