Saltar al contenido principal

Scope Freeze de Contratos: Registro y Autenticación V1

Este documento congela el alcance contractual de inicio de desarrollo para Registro y Autenticación.

1. Alcance V1 (in-scope)

Los siguientes endpoints quedan aprobados para implementación V1:

MóduloEndpointMétodoEstado
Registro/api/v1/auth/registerPOSTV1
Registro/api/v1/auth/token/verifyPOSTV1
Registro/api/v1/auth/token/resendPOSTV1
Registro/api/v1/profiles/patientPATCHV1
Registro/api/v1/profiles/doctorPATCHV1
Autenticación/api/v1/auth/loginPOSTV1
Autenticación/api/v1/auth/refreshPOSTV1
Autenticación/api/v1/auth/logoutPOSTV1
Autenticación/api/v1/auth/forgot-passwordPOSTV1
Autenticación/api/v1/auth/reset-passwordPOSTV1
Autenticación Social (Google)/api/v1/auth/oauth2/google/callbackGETV1
Autenticación Social (Google)/api/v1/auth/oauth2/google/linkPOSTV1

2. Fuera de alcance V1 (V1.1)

Los siguientes endpoints legacy se clasifican para V1.1:

MóduloEndpointMétodoEstado
Auth Social (Google - legacy)/api/v1/auth/google/exchangePOSTV1.1
Auth Social (Google - legacy)/api/v1/auth/google/linkPOSTV1.1

3. Enums canónicos (V1)

Los siguientes enums son la referencia única para contratos de Registro/Auth:

3.1 Roles

  • PATIENT
  • DOCTOR
  • ENTITY_ADMIN
  • CATALOG_ADMIN
  • SUPERADMIN

3.2 Estado de cuenta

  • PENDING_VERIFICATION
  • ACTIVE
  • SUSPENDED

4. Reglas de consistencia obligatorias

  1. Ningún documento de producto o matriz E2E puede introducir roles/estados fuera de este catálogo sin PR de contrato.
  2. Todo ejemplo de login/register/verify debe incluir roles y account_status cuando aplique.
  3. Todo ejemplo de emision de sesion debe reflejar el transporte vigente: cookies HttpOnly (accessToken, refreshToken) sin exponer tokens en body.
  4. Los endpoints V1.1 no bloquean el inicio de implementación de V1.
  5. Cualquier cambio de alcance V1 requiere actualización de este documento en el mismo PR de OpenAPI.

5. Referencias

  • OpenAPI: static/openapi.yaml
  • Data contracts: 19-data-contracts-api.md
  • Registro: ../05-Producto/registro.md
  • Autenticación: ../05-Producto/autenticacion.md