Saltar a contenido

0016. CRUD de los catálogos — octavo slice: tipos de clientes

Estado: Propuesto Fecha: 2026-09-30 Autor: Kevin Delgado Lopez Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/

Contexto

Sigue el molde del ADR 0008 y cierra los 8 catálogos comerciales. cat_tipos_clientes clasifica la naturaleza jurídica del cliente (PERSONA_NATURAL, PERSONA_JURIDICA) y tiene la misma forma que canales. docs-sql advierte que svc-identidad ya distingue persona natural y jurídica (hoy como tipo_contribuyente de mae_personas_comerciales, ADR 0067 de identidad), y que antes de migrar datos hay que acordar qué sistema gobierna el dato.

Decisión

  • Endpoints bajo /api/v1/catalogos/tipos-clientes, con los mismos códigos y reglas que canales comerciales (ADR 0008).
  • Sin reglas propias ni datos precargados.
  • La superposición con svc-identidad queda pendiente: el catálogo se expone porque mae_clientes.tipo_cliente_id ya lo referencia.

Alternativas descartadas

  • Esperar el acuerdo con svc-identidad — mae_clientes exige el tipo desde su alta; sin el CRUD no habría cómo cargarlo.
  • Admitir clasificaciones comerciales (DISTRIBUIDOR, MAYORISTA) — docs-sql las excluye: pertenecen a canales y clases de cliente.

Consecuencias

  • La API expone 40 operaciones de catálogos (8 catálogos × 5).
  • Si svc-identidad pasa a gobernar el dato, este catálogo se reemplaza por una referencia a identidad en un ADR nuevo.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.