Saltar a contenido

0055. Validación de longitud de identificaciones según el catálogo

Estado: Aceptado
Fecha: 2026-10-27
Autor: David Garcia
Módulo(s) afectado(s): app/domains/usuarios/, app/domains/empresas/, docs/adr/

Contexto

Las personas naturales, las personas jurídicas y las empresas referencian un registro de cat_tipos_identificacion. El catálogo ya define longitud_minima y longitud_maxima, pero las escrituras sólo comprobaban que el tipo existiera y que la identificación no estuviera duplicada.

Decisión

  • Cuando se recibe tipo_identificacion_id, los repositories consultan el registro activo completo (deleted_at IS NULL) de cat_tipos_identificacion.
  • La longitud se valida sobre el valor recibido, sin asumir que sea numérico ni aplicar expresion_validacion.
  • En una actualización parcial se valida la combinación efectiva final: el nuevo valor de cada campo, o el valor actual si ese campo no fue enviado.
  • Un tipo inexistente o inactivo mantiene la respuesta 404. Una longitud fuera del rango devuelve 422 con el nombre del tipo y el rango esperado. La regla se aplica en creación y actualización de personas naturales, personas jurídicas y empresas.
  • La consulta y el acceso a SQLAlchemy permanecen en los repositories; las excepciones de la regla y la coordinación permanecen en los services.

Alternativas descartadas

  • Validar sólo con Field(max_length=20): no aplica los límites específicos del catálogo.
  • Validar en el router: duplicaría la regla y requeriría que el router conozca la persistencia del catálogo.
  • Validar expresion_validacion: queda fuera del alcance y podría cambiar el comportamiento de tipos alfanuméricos existentes.

Consecuencias

El frontend recibe un error de contrato claro antes de persistir una identificación con longitud inválida. Los tipos alfanuméricos conservan su compatibilidad porque sólo se cuenta la longitud del valor recibido.