Saltar a contenido

0016. Catálogo cat_tipos_actividad: color validado y geolocalización por defecto false

Estado: Aceptado Fecha: 2026-10-07 Autor: David Garcia Módulo(s) afectado(s): app/domains/catalogos/, alembic/versions/20261007_001_crear_cat_tipos_actividad.py Complementa a: ADR 0015

Contexto

cat_tipos_actividad es el primero de los catálogos pendientes del ADR 0015 con campos propios además de codigo y nombre: color_hex (texto de hasta 10 caracteres, opcional), para mostrar el tipo de actividad en pantalla, y requiere_geolocalizacion (booleano obligatorio, sin default en el borrador del modelo de datos). El CRUD sigue el estándar del ADR 0015; falta decidir cómo se validan y llenan estos dos campos.

Decisión

  • color_hex es opcional y la API sólo acepta un color hexadecimal: #RGB, #RRGGBB o #RRGGBBAA. Cualquier otro texto responde 422.
  • requiere_geolocalizacion vale false por defecto, en la API y en la base (server_default false), apartándose del borrador.
  • Ambos son editables. Como en el resto de catálogos, PUT reemplaza todos los campos editables: si uno no viene, toma su default (null o false).
Tabla Ruta (/api/v1/catalogos/...) Migración
cat_tipos_actividad tipos-actividad 20261007_001

Alternativas descartadas

  • color_hex como texto libre — admitiría valores como "azul" que el frontend no puede pintar.
  • Nombre de color o lista cerrada de colores — limita las opciones de cada empresa y obliga a traducirlos a un color real en el frontend.
  • requiere_geolocalizacion obligatorio en la entrada, como en el borrador — obliga a enviarlo siempre, aunque lo habitual es que no se requiera.

Consecuencias

  • El frontend puede usar color_hex tal como viene, sin validarlo.
  • Un PUT que omite requiere_geolocalizacion la deja en false aunque antes fuera true: el cliente debe enviar siempre el valor vigente.
  • Un INSERT directo en la base sin esa columna no falla.

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.