Saltar a contenido

0007. Login en dos pasos y acceso sólo para promotores vigentes

Estado: Propuesto; complementado por ADR 0008 Fecha: 2026-11-02 Autor: David Garcia Módulo(s) afectado(s): modules/auth/, shared/sesion/, app/router/ Complementado por: ADR 0008 — dónde se guardan los tokens y cómo se renueva la sesión

Contexto

Identidad autentica en dos pasos: POST /auth/login valida la contraseña y devuelve un pre-token de 5 minutos con las empresas del usuario, y POST /auth/login/empresa lo canjea por access y refresh de la empresa elegida (ADR 0030 de identidad). Una contraseña temporal corta el paso 1 con 403 password_temp_required. Fuerza de ventas responde 403 a quien no es promotor vigente (ADR 0048 de fuerza de ventas) y expone GET /alcance (ADR 0055 de fuerza de ventas), que siempre responde 200 y trae promotor_id en null para quien no lo es. La app es la herramienta del promotor: un usuario que no es promotor no tiene nada que hacer en ella.

Decisión

  • Paso 1 y paso 2 como en la web: con una empresa se entra directo; con varias, el promotor elige en una lista. El pre-token vive sólo en memoria y, si vence antes de elegir, se vuelve al paso 1.
  • Contraseña temporal: el 403 password_temp_required lleva a la pantalla de cambio de contraseña (POST /auth/cambiar-password) y de ahí al login.
  • Puerta del promotor: tras el paso 2 la app llama a GET /alcance. Con promotor_id presente entra; con null (no es promotor, está borrado o inactivo, o es root) cierra la sesión recién creada y avisa «Tu usuario no es un promotor activo en esta empresa». Se repite al abrir la app.
  • shared/sesion/ guarda usuario, empresa (empresa_id, empresa_nombre), entidad_id y promotor_id, leídos del token y del alcance. Los claims se leen sin verificar la firma, sólo para mostrar: quien autoriza es cada servicio.
  • Cambio de empresa con POST /auth/cambiar-empresa: reemplaza ambos tokens (ADR 0042 de identidad), vuelve a pasar la puerta del promotor e invalida todos los providers con datos de la empresa anterior.
  • Cerrar sesión: POST /auth/logout con el refresh y se borran los tokens del teléfono aunque la llamada falle.

Alternativas descartadas

  • Dejar entrar a cualquiera y que cada pantalla muestre el 403 — la app se ve rota para un usuario que nunca debió entrar.
  • Decidirlo por un permiso del token — los permisos de fuerza de ventas todavía no existen en identidad; el alcance es la fuente real hoy.
  • Login con biometría o PIN — útil en la calle, pero es otra decisión (guardar credenciales o alargar la sesión); se retoma después.

Consecuencias

  • La app depende de crm-svc-fuerza-ventas para dejar entrar: si está caído al iniciar sesión, se muestra el error y se puede reintentar.
  • El administrador de fuerza de ventas, que tiene promotor_id, también entra y ve todo su alcance.
  • root no entra a la app: sólo lee (ADR 0009 de fuerza de ventas) y no tiene promotor.

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.