Saltar a contenido

ADR de implementación — core-svc-identidad

Registro de las decisiones de arquitectura tomadas durante la implementación de core-svc-identidad. Proviene del repositorio del servicio (core-svc-identidad/docs/adr) y se incorpora a este sitio sin cambios de contenido: mismos textos, mismos estados y la fecha original de cada ADR.

Numeración independiente. Estos ADRs usan la numeración local del repositorio del servicio (0001–0067) y no continúan la serie de ../adr/, que documenta el diseño previo del servicio (0001–0024). Cuando una decisión de implementación cambia una decisión de diseño, el ADR de diseño no se reescribe: cambia su estado y el detalle queda en los ADR de complemento 0025–0031 de ../adr/.

Formato oficial: template/0000-adr-template.md.

Índice

ADR Título Estado Fecha
0001 Stack, dependencias y herramientas de calidad Propuesto 2026-09-24
0002 Estructura del proyecto de core-svc-identidad: monolito modular por dominio Propuesto 2026-09-24
0003 Migraciones de base de datos con Alembic Aceptado 2026-09-25
0004 Tablas iniciales del servicio de identidad Aceptado 2026-09-28
0005 Contratos de API (schemas Pydantic) para todas las tablas Aceptado 2026-09-28
0006 Endpoints de lectura de los catálogos Aceptado 2026-09-28
0007 Seguridad: hashing Argon2id y firma/verificación de JWT Aceptado 2026-09-28
0008 CRUD de los catálogos globales — primer slice: países Aceptado 2026-09-29
0009 CRUD de los catálogos globales — segundo slice: tipos de identificación Superado 2026-09-29
0010 CRUD de los catálogos globales — tercer slice: géneros Aceptado 2026-09-29
0011 CRUD de los catálogos globales — cuarto slice: monedas Aceptado 2026-09-29
0012 Fusión de catálogos: tipos de identificación absorbe tipos de documentos Aceptado 2026-09-29
0013 CRUD de los catálogos globales — sexto slice: provincias Aceptado 2026-09-29
0014 CRUD de los catálogos globales — séptimo slice: ciudades Aceptado 2026-09-29
0015 Scope global de borrado lógico: filtro automático de deleted_at Aceptado 2026-09-29
0016 CRUD del dominio empresas: mae_empresas Aceptado 2026-09-29
0017 CRUD de los catálogos por empresa — primer slice: feriados Aceptado 2026-09-29
0018 CRUD de los catálogos por empresa — segundo slice: bancos Aceptado 2026-09-29
0019 CRUD del dominio sucursales: mae_sucursales Aceptado 2026-09-29
0020 CRUD de navegación — primer slice: cat_aplicaciones Aceptado 2026-09-29
0021 CRUD de navegación — segundo slice: cfg_modulos Aceptado 2026-09-29
0022 CRUD de navegación — tercer slice: cfg_menu Aceptado 2026-09-29
0023 CRUD de navegación — cuarto slice: cfg_menu_acciones Aceptado 2026-09-29
0024 CRUD de navegación — quinto slice: cfg_variables_sistemas Aceptado 2026-09-29
0025 CRUD de entidades — patrón party Aceptado (enmendado por 0067) 2026-09-29
0026 CRUD de catálogo de tipos de usuario Aceptado 2026-09-30
0027 CRUD de usuarios Aceptado 2026-09-30
0028 CRUD de empresas del usuario (rel_usuario_empresa) Aceptado 2026-09-30
0029 CRUD de permisos por acción (rel_usuario_accion) Aceptado 2026-09-30
0030 Autenticación: login en dos pasos y firma JWT Aceptado 2026-09-30
0031 Protección de las rutas CRUD con JWT Aceptado 2026-09-30
0032 CRUD de sucursales del usuario (rel_usuario_sucursal) Aceptado 2026-09-30
0033 CRUD de aplicaciones de la empresa (rel_empresa_aplicacion) Aceptado 2026-09-30
0034 Plantilla base de navegación al crear una empresa Aceptado 2026-10-01
0035 Cambio de la contraseña propia (CU-04) Aceptado 2026-10-01
0036 Panel de navegación por usuario (aplicaciones, módulos y menú) Aceptado 2026-10-02
0037 Acceso de root sin asignaciones y navegación filtrada por la empresa Aceptado 2026-10-05
0038 Empresas con acceso del usuario autenticado Aceptado 2026-10-05
0039 Esquema de seguridad Bearer en OpenAPI (botón Authorize) Aceptado 2026-10-05
0040 Naming canónico de los claims JWT de plataforma: godexerp Aceptado 2026-10-05
0041 Perfil propio: editar mis datos Aceptado 2026-10-05
0042 Cambio de empresa de la sesión Aceptado 2026-10-05
0043 Ensanchar el código de acción de la navegación Aceptado 2026-10-07
0044 Endpoint de lectura de la plantilla base de navegación Aceptado 2026-10-12
0045 Nombre de la empresa activa como claim del access token Aceptado 2026-10-16
0046 Contexto de empresa por transacción para la RLS Aceptado 2026-10-20
0047 Login administrativo exclusivo para root Aceptado 2026-10-21
0048 Autorización con dos tokens para la administración global de empresas Aceptado 2026-10-21
0049 Entidad del usuario como claim del access token Aceptado 2026-10-22
0050 Lista común de entidades (personas naturales y jurídicas) Aceptado (enmendado por 0067) 2026-10-22
0051 Endpoint de existencia de una entidad para otros servicios Aceptado 2026-10-26
0052 Lectura autenticada de las listas maestras Aceptado 2026-10-26
0053 Escrituras de los catálogos globales exclusivas de root Aceptado 2026-10-26
0054 Bloqueo temporal del borrado de empresas con sucursales activas Aceptado 2026-10-26
0055 Validación de longitud de identificaciones según el catálogo Aceptado 2026-10-27
0056 Entorno exclusivo de Alembic: .env.migrations Aceptado 2026-10-29
0057 Dos pools de base de datos: tenant con RLS y panel con BYPASSRLS Aceptado 2026-10-29
0058 Códigos jerárquicos de la navegación (path sin aplicación) Aceptado 2026-11-04
0059 Copiar y mover navegación, y habilitación automática de aplicaciones Aceptado 2026-11-05
0060 rel_empresa_aplicacion conserva historial (único parcial) Aceptado 2026-11-05
0061 Imagen global de usuario Aceptado 2026-11-06
0062 Una entidad por id, buscar entidades y varias por id Aceptado 2026-11-09
0063 Referencia de una sucursal para que otro servicio copie su nombre Aceptado 2026-11-10
0064 Varias sucursales por id para que otro servicio las valide en una llamada Aceptado 2026-11-10
0065 Subida de la foto de perfil con fila pendiente Aceptado 2026-11-10
0066 Documentación de la API apagada por defecto Aceptado 2026-11-11
0067 Persona comercial y tipo de contribuyente Aceptado 2026-11-16

Notas

  • Origen: core-svc-identidad/docs/adr. Los números y los textos se mantienen como están en el repositorio del servicio.
  • Referencias cruzadas: los ADRs de implementación citan decisiones de este sitio como "ADR 000N transversal". Las decisiones de diseño del propio servicio viven en ../adr/.
  • Estados: los estados y las relaciones entre ADRs (Modifica a, Complementa a) son los del repositorio de origen y no se editaron al copiar.
  • Enmiendas por el ADR 0067: los ADR 0004, 0012, 0025, 0041, 0050 y 0051 llevan una nota que remite al ADR 0067 (persona comercial y tipo de contribuyente); conservan los nombres vigentes a su fecha.