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_requiredlleva 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. Conpromotor_idpresente entra; connull(no es promotor, está borrado o inactivo, o esroot) 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_idypromotor_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/logoutcon 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-ventaspara 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. rootno 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.