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_hexes opcional y la API sólo acepta un color hexadecimal:#RGB,#RRGGBBo#RRGGBBAA. Cualquier otro texto responde 422.requiere_geolocalizacionvalefalsepor 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,
PUTreemplaza todos los campos editables: si uno no viene, toma su default (nullofalse).
| Tabla | Ruta (/api/v1/catalogos/...) |
Migración |
|---|---|---|
cat_tipos_actividad |
tipos-actividad |
20261007_001 |
Alternativas descartadas¶
color_hexcomo 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_geolocalizacionobligatorio 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_hextal como viene, sin validarlo. - Un
PUTque omiterequiere_geolocalizacionla deja enfalseaunque antes fueratrue: el cliente debe enviar siempre el valor vigente. - Un
INSERTdirecto 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.