Saltar a contenido

0010. CRUD de los catálogos — segundo slice: clases de cliente

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

Contexto

El ADR 0008 fijó el molde del CRUD con canales comerciales y dejó los demás catálogos para agregarse de a uno. cat_clases_cliente tiene la misma forma que canales (codigo, nombre, descripcion), sin FK ni reglas propias, así que es el siguiente para confirmar que el molde se repite sin cambios.

Decisión

  • Endpoints bajo /api/v1/catalogos/clases-cliente, con el mismo contrato y los mismos códigos que canales comerciales (ADR 0008).
  • Una sección nueva por archivo del dominio: ClaseCliente*Request/Response, listar_ / obtener_ / existe_codigo_ / crear_ / actualizar_ / eliminar_clase_cliente en el repository, los mismos casos en el service y los 5 endpoints en el router.
  • Mismas reglas: borrado lógico visible, código único por empresa aunque esté borrado, codigo e is_activo no editables.

Alternativas descartadas

  • Extraer ahora un CRUD genérico para los catálogos iguales — el ADR 0008 lo descarta: cada tabla mantiene sus consultas propias.
  • Empezar por un catálogo con reglas propias (estados_prospecto, terminos_pago, tipos_canal_comercial) — primero se confirma el molde con una tabla idéntica.

Consecuencias

  • La API expone 10 operaciones de catálogos (2 catálogos × 5).
  • El mismo código puede existir en canales y en clases: son tablas distintas.
  • Quedan 6 catálogos; los que tienen reglas propias las documentan en su ADR.

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.