[EPIC] Catalogo maestro de insumos unificado (Supply master-data + sinonimos + i18n)

[vgpastor]

Objetivo

Unificar los nombres de productos, categorias y su organizacion para que dejen de ser texto libre y se usen de forma consistente en todas las list items (necesidades, ofertas, inventario, containers). Hoy SupplyLine.name es texto libre: el mismo insumo se escribe de N formas y no se puede agregar, casar oferta<->necesidad ni prever por centro.

Se introduce el catalogo maestro de insumos que el contexto supplies ya preveia (SupplyLine disenado para referenciar un Supply por id):

• Supply (master-data global): codigo INS-NNNN, nombre canonico, categoria, unidad por defecto, attributes (jsonb) y variantes estructuradas (variantOfId + atributos: agua por tamano, panales por talla...).
• Sinonimos (SupplyAlias): los 454 terminos del BUSCADOR UCAB (genericos, comerciales venezolanos, erratas) -> insumo canonico. Es el corazon de "unificar nombres".
• Categorias y subcategorias globales, ya sembradas y editables por admin (etiquetas, orden, jerarquia, idiomas). Los ~12 slugs nucleo del enum quedan protegidos (no se borran/renombran porque el codigo los cablea).
• i18n de categorias y nombres de insumo: nombre base (es) + tablas de traduccion (*_translations) con fallback, extensible a N idiomas sin migracion.
• Gobernanza admins-only (catalogue:manage): catalogo cerrado; en campo se usa el escape "Otro" y un admin lo promueve/aliasa. Enlace soft SupplyLine.supplyId (opcional) para no romper datos legacy ni la captura.
• Semilla real: la Hoja Maestra UCAB (215 insumos + 454 alias) arranca el catalogo con datos reales.

Decisiones tomadas

• Catalogo global (sin emergency_id, como categories).
• Enlace soft: SupplyLine mantiene name y gana supplyId opcional.
• Variantes/atributos estructurados.
• Categorias globales, sembradas y admin-editables; slugs nucleo protegidos.
• Admins-only; campo limitado al catalogo con escape "Otro".
• i18n con base + traducciones + fallback; locales iniciales es (base) + en.

Issues hijas

Fase 1 - Modelo + datos (backend)

• [FEATURE] Dominio Supply (master-data): agregado, codigo INS-NNNN, atributos y variantes #216 Dominio Supply (master-data): agregado, codigo INS-NNNN, atributos y variantes
• [FEATURE] Sinonimos de insumo (SupplyAlias) + supply-resolver (normalizacion y matching) #217 Sinonimos de insumo (SupplyAlias) + supply-resolver (normalizacion y matching)
• [FEATURE] Migraciones y schema: supplies, supply_aliases, traducciones e i18n, subcategorias #218 Migraciones y schema: supplies, supply_aliases, traducciones e i18n, subcategorias
• [FEATURE] Semilla del catalogo desde la Hoja Maestra UCAB (215 insumos + 454 alias + categorias finas) #219 Semilla del catalogo desde la Hoja Maestra UCAB (215 insumos + 454 alias + categorias finas)

Fase 2 - API

• [FEATURE] API publica de catalogo: GET /supplies (autocomplete) y GET /supplies/:id, locale-aware #220 API publica de catalogo: GET /supplies (autocomplete) y GET /supplies/:id, locale-aware
• [FEATURE] Admin CRUD de categorias y subcategorias (jerarquia, orden, i18n, slugs nucleo protegidos) #221 Admin CRUD de categorias y subcategorias (jerarquia, orden, i18n, slugs nucleo protegidos)
• [FEATURE] Admin CRUD de insumos, variantes y alias (incluye merge / des-duplicacion) #222 Admin CRUD de insumos, variantes y alias (incluye merge / des-duplicacion)
• [FEATURE] Enlace SupplyLine.supplyId (soft link) en needs, offers, inventario y containers #223 Enlace SupplyLine.supplyId (soft link) en needs, offers, inventario y containers

Fase 3 - Web + datos legacy

• [FEATURE] Web: SupplySelector (autocomplete + Otro) en /registrar, necesidades y ofertas #224 Web: SupplySelector (autocomplete + Otro) en /registrar, necesidades y ofertas
• [FEATURE] Web: panel admin del catalogo (categorias, insumos, alias y traducciones) #225 Web: panel admin del catalogo (categorias, insumos, alias y traducciones)
• [FEATURE] Backfill/matching de lineas legacy -> supplyId + informe de no-casados #226 Backfill/matching de lineas legacy -> supplyId + informe de no-casados

Fase 4 - Cierre

• [DOCS] Documentar el catalogo de insumos: AGENTS.md (supplies) y Swagger /docs #227 Documentar el catalogo de insumos: AGENTS.md (supplies) y Swagger /docs

Definicion de Done

• Existe el catalogo Supply global con codigo, categoria, unidad, atributos y variantes.
• Los alias resuelven nombre/sinonimo -> insumo canonico (semilla UCAB cargada: 215 insumos + 454 alias).
• Categorias y subcategorias globales, sembradas, editables por admin con i18n y slugs nucleo protegidos.
• SupplyLine.supplyId (soft link) propagado a needs/offers/inventario/containers y datos legacy enlazados best-effort.
• Selector de insumo (autocomplete + "Otro") en captura y panel admin del catalogo operativos.
• API publica /supplies locale-aware en el api-client tipado y documentada en /docs + AGENTS.md.