Saltar a contenido

0004. MongoDB time-series para puntos GPS

Fecha: 2026-11-10 Estado: Propuesto; reevaluado por ADR 0007 Módulo(s) afectado(s): persistencia, ingestión, consulta de rutas Relacionado con: ADR 0006 — propuesta histórica/alternativa cuando RLS de base sea requisito no negociable; ADR 0007 — propuesta reevaluada de alcance tenant en MongoDB.

Contexto

Los puntos GPS son mediciones temporales con alta frecuencia de escritura y consultas por intervalos. Una colección de series temporales es candidata, pero su modelo de buckets, índices y operaciones disponibles condiciona la idempotencia y las futuras consultas geoespaciales.

Decisión

Se propone una colección location_points con recorded_at UTC como timeField y device_context estable con empresa_id como metaField (por ejemplo, {empresa_id, app_installation_id}). Cada sesión lógica y cada medición persiste también empresa_id; puntos mantienen tracking_session_id y promotor como mediciones/referencias, no como dimensiones variables del metaField. Latitud, longitud y calidad son mediciones. No se configura TTL por defecto, dado el requisito confirmado de historial permanente.

Para la app móvil, el tenant procede del contexto autenticado, nunca de un campo libre. Para solicitudes internas, la API consumidora suministra empresa_id; tracking autentica y autoriza que el caller pueda actuar para esa empresa antes de usarla. Empresa ausente, no autorizada o discordante con el contexto autenticado se rechaza. No hay tenant predeterminado ni filtrado en cliente. empresa_id se persiste en cada sesión/medición y en el metaField estable. Toda lectura, listado, actualización, borrado e inserción aplica el tenant como predicado obligatorio; al operar puntos, se valida también que la sesión corresponda a ese tenant. Las respuestas incluyen empresa_id junto con los datos.

Excepción y estado de gobernanza: MongoDB no aplica las políticas RLS de PostgreSQL a documentos de colecciones compartidas. El aislamiento aquí es de aplicación, no RLS. Esta propuesta requiere reconciliación y aprobación explícitas como excepción acotada a los ADR transversales aceptados 0002/0012; no los modifica ni afirma que la excepción esté aprobada. Si la excepción no se acepta y RLS de base es innegociable, la alternativa es PostgreSQL particionado con RLS del ADR 0006. RBAC de MongoDB concede privilegios sobre recursos, no predicados por documento.

La API validará los lotes y definirá reintentos/idempotencia sin depender de índice único: MongoDB no admite índices únicos en colecciones time-series. Las consultas por proximidad tampoco se asumirán como equivalentes a colecciones convencionales: la documentación limita $near/$nearSphere y condiciona $geoNear e índices geoespaciales. Deben verificarse contra la versión desplegada.

Alternativas descartadas

  • Promotor o sesión dinámica en metaField — puede fragmentar buckets y elevar cardinalidad.
  • Confiar en índice único para deduplicar reintentos — no está soportado en estas colecciones.
  • TTL automático por simplicidad operativa — contradice la expectativa confirmada de historial permanente mientras no exista una política aprobada.
  • Presentar el filtro de tenant en MongoDB como RLS — las colecciones compartidas no ofrecen enforcement por documento; la equivalencia no debe asumirse.

Consecuencias

Se deben probar autenticación/autorización del caller, rechazo de empresa ausente/no autorizada, predicados tenant obligatorios en todas las rutas, respuestas con empresa_id y no interferencia entre empresas. Medir forma de consulta (empresa_id, tracking_session_id, recorded_at) y (empresa_id, promoter_id, recorded_at), escritura por lotes y lecturas por empresa/sesión/tiempo en la versión seleccionada. Las limitaciones de índices únicos e idempotencia de time-series requieren estrategia explícita. Costos de archivo, privacidad, retención legal y aprobación de la excepción siguen abiertos.

Referencias oficiales: consideraciones y metaField, buenas prácticas, limitaciones, arquitectura multi-tenant con colecciones compartidas y control de acceso basado en roles (RBAC).


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.