erp-core/orchestration/04-dependencias/ANALISIS-DEPENDENCIAS-ARCHIVOS-2026-01-10.md

ANALISIS DE DEPENDENCIAS DE ARCHIVOS - FASE 4 (CAPVED)

Fecha: 2026-01-10 Fase CAPVED: D (Dependencias) Orquestador: Claude Code - Opus 4.5

---

HALLAZGOS CRITICOS

La verificacion detallada de archivos revela que MUCHAS MAS TAREAS del plan estan completadas de lo estimado inicialmente.

Resumen de Impacto

Area	Tareas Planificadas	Estado Real	Impacto SP
OAuth Providers	BE-009 (8 SP)	YA EXISTEN	-8 SP
Auth Tests	BE-002 (8 SP)	YA EXISTEN	-8 SP
Permission Cache	BE-006 (2 SP)	YA EXISTE	-2 SP
Email Verification	BE-011 (4 SP)	YA EXISTE	-4 SP
Frontend Catalogs	FE-001 a FE-006 (30 SP)	YA EXISTEN	-30 SP
Frontend Settings	FE-008 a FE-012 (19 SP)	YA EXISTEN	-19 SP
TOTAL REDUCCION	-	-	-71 SP

---

1. MODULO AUTH - VERIFICACION COMPLETA

1.1 Archivos que YA EXISTEN

Archivo	Ubicacion	Estado	Lineas
google.provider.ts	auth/providers/	COMPLETO	~200
microsoft.provider.ts	auth/providers/	COMPLETO	~200
oauth.service.ts	auth/providers/	COMPLETO	~150
oauth.types.ts	auth/providers/	COMPLETO	~100
permission-cache.service.ts	auth/services/	COMPLETO	~150
email-verification.service.ts	auth/services/	COMPLETO	~200
token.service.ts	auth/services/	COMPLETO	~300
auth.service.spec.ts	auth/tests/	COMPLETO	19KB
auth.controller.spec.ts	auth/tests/	COMPLETO	13KB
auth.integration.spec.ts	auth/tests/	COMPLETO	17KB
oauth.spec.ts	auth/providers/tests/	EXISTE	~200
permission-cache.service.spec.ts	auth/services/tests/	EXISTE	~200

1.2 Archivos MFA (Por Verificar en Detalle)

backend/src/modules/auth/
├── mfa.routes.ts        # EXISTE
├── mfa.controller.ts    # EXISTE
├── mfa.service.ts       # EXISTE
├── dto/mfa.dto.ts       # EXISTE
└── entities/
    ├── user-mfa.entity.ts      # EXISTE
    ├── trusted-device.entity.ts # EXISTE
    └── mfa-audit-log.entity.ts  # EXISTE

1.3 Entidades OAuth (Ya Existen)

entities/
├── oauth-provider.entity.ts    # EXISTE
├── oauth-state.entity.ts       # EXISTE
└── oauth-user-link.entity.ts   # EXISTE

1.4 Estructura Completa de Auth Routes

Rutas Existentes:
/auth/login          POST
/auth/register       POST
/auth/refresh        POST
/auth/profile        GET  (protected)
/auth/change-password POST (protected)
/auth/logout         POST (protected)
/auth/logout-all     POST (protected)

Rutas OAuth (ya implementadas):
/auth/oauth/google           GET
/auth/oauth/google/callback  GET
/auth/oauth/microsoft        GET
/auth/oauth/microsoft/callback GET
/auth/oauth/link             POST
/auth/oauth/unlink/:provider DELETE

Rutas MFA (verificar estado):
/auth/mfa/setup      POST
/auth/mfa/verify     POST
/auth/mfa/disable    POST
/auth/mfa/backup-codes GET

---

2. FRONTEND - VERIFICACION COMPLETA

2.1 Feature Catalogs - YA EXISTE COMPLETA

frontend/src/features/catalogs/
├── api/
│   ├── countries.api.ts     # EXISTE
│   ├── states.api.ts        # EXISTE
│   ├── currencies.api.ts    # EXISTE
│   ├── uom.api.ts           # EXISTE
│   ├── categories.api.ts    # EXISTE
│   └── catalog.api.ts       # EXISTE (7 APIs)
├── types/
│   ├── country.types.ts     # EXISTE
│   ├── currency.types.ts    # EXISTE
│   ├── uom.types.ts         # EXISTE
│   ├── category.types.ts    # EXISTE
│   └── index.ts             # EXISTE
├── hooks/
│   ├── useCountries.ts      # EXISTE
│   ├── useCurrencies.ts     # EXISTE
│   ├── useUom.ts            # EXISTE
│   └── useProductCategories.ts # EXISTE
├── stores/
│   ├── countries.store.ts   # EXISTE
│   ├── currencies.store.ts  # EXISTE
│   ├── uom.store.ts         # EXISTE
│   └── categories.store.ts  # EXISTE
├── components/
│   ├── CountrySelect.tsx    # EXISTE
│   ├── CurrencySelect.tsx   # EXISTE
│   ├── CategoryTree.tsx     # EXISTE
│   └── CategoryTreeSelect.tsx # EXISTE
└── index.ts                 # EXISTE

2.2 Rutas Catalogs - YA EXISTEN (routes.tsx lineas 309-495)

/catalogs              → CatalogsIndexPage      EXISTE
/catalogs/countries    → CountriesPage          EXISTE
/catalogs/countries/new → CountryFormPage       EXISTE
/catalogs/countries/:id → CountryDetailPage     EXISTE
/catalogs/countries/:id/edit → CountryFormPage  EXISTE
/catalogs/states       → StatesPage             EXISTE
/catalogs/currencies   → CurrenciesPage         EXISTE
/catalogs/currencies/:id/rates → CurrencyRatesPage EXISTE
/catalogs/uom          → UomPage                EXISTE
/catalogs/uom/categories → UomCategoriesPage    EXISTE
/catalogs/uom/conversion → UomConversionPage    EXISTE
/catalogs/categories   → CategoriesPage         EXISTE

2.3 Feature Settings - YA EXISTE

frontend/src/features/settings/
├── api/
│   ├── systemSettings.api.ts   # EXISTE
│   ├── tenantSettings.api.ts   # EXISTE
│   └── userPreferences.api.ts  # EXISTE
├── types/
│   ├── settings.types.ts       # EXISTE
│   └── index.ts                # EXISTE
├── hooks/
│   ├── useSystemSettings.ts    # EXISTE
│   ├── useTenantSettings.ts    # EXISTE
│   ├── useUserPreferences.ts   # EXISTE
│   └── useTheme.ts             # EXISTE
├── stores/
│   ├── systemSettings.store.ts # EXISTE
│   ├── tenantSettings.store.ts # EXISTE
│   └── userPreferences.store.ts # EXISTE
└── index.ts                    # EXISTE

2.4 Rutas Settings - YA EXISTEN (routes.tsx lineas 722-766)

/settings              → Redirect to /settings/tenant  EXISTE
/settings/tenant       → TenantSettingsPage            EXISTE
/settings/feature-flags → FeatureFlagsPage             EXISTE
/settings/preferences  → UserPreferencesPage           EXISTE
/settings/billing      → Placeholder (pendiente)

2.5 Paginas Settings que Existen

frontend/src/pages/settings/
├── TenantSettingsPage.tsx    # EXISTE
├── FeatureFlagsPage.tsx      # EXISTE
└── UserPreferencesPage.tsx   # EXISTE

---

3. ACTUALIZACION DE TAREAS DEL PLAN

3.1 Tareas ELIMINADAS (Ya Completadas)

Tarea	SP Original	Razon de Eliminacion
BE-002	8 SP	Tests auth YA EXISTEN (49KB en tests)
BE-006	2 SP	permission-cache.service.ts YA EXISTE
BE-009	8 SP	OAuth providers YA EXISTEN (google, microsoft)
BE-011	4 SP	email-verification.service.ts YA EXISTE
FE-001	5 SP	Catalogs structure YA EXISTE
FE-002	5 SP	Countries pages YA EXISTEN
FE-003	5 SP	Currencies pages YA EXISTEN
FE-004	5 SP	UoM pages YA EXISTEN
FE-005	8 SP	Categories pages YA EXISTEN
FE-006	2 SP	Rutas catalogs YA EXISTEN
FE-007	3 SP	Stores catalogs YA EXISTEN
FE-008	3 SP	Settings structure YA EXISTE
FE-009	5 SP	System Settings YA EXISTE (parcial)
FE-010-A	3 SP	Tenant Settings YA EXISTE
FE-010-B	2 SP	Tenant Settings YA EXISTE (completar)
FE-011	5 SP	User Preferences YA EXISTE
FE-012	5 SP	Feature Flags YA EXISTE
FE-013	3 SP	Settings Stores YA EXISTEN
TOTAL	81 SP	-

3.2 Tareas REDUCIDAS

Tarea	SP Original	SP Nuevo	Razon
BE-001	2 SP	1 SP	Solo verificar config jest.config.js
BE-003	5 SP	5 SP	Sin cambios (tests users)
BE-004	5 SP	5 SP	Sin cambios (tests roles)
BE-005	5 SP	5 SP	Sin cambios (tests tenants)
BE-007	8 SP	8 SP	Sin cambios (tests financial)
BE-008	6 SP	6 SP	Sin cambios (tests inventory)
BE-010	8 SP	4 SP	MFA parcialmente existe, completar
FE-014	3 SP	1 SP	Theme selector integrar (ya hay useTheme)
FE-015	1 SP	0 SP	Vitest ya configurado

3.3 Tareas NUEVAS o PENDIENTES

Tarea	Descripcion	SP	Sprint
DB-002	Ejecutar RLS validation	2 SP	1
BE-003	Tests Users Module	5 SP	2
BE-004	Tests Roles Module	5 SP	2
BE-005	Tests Tenants Module	5 SP	2
BE-007	Tests Financial Module	8 SP	3
BE-008	Tests Inventory Module	6 SP	3
BE-010	Completar MFA (verificar estado)	4 SP	4
VALIDACION	Verificar OAuth flow end-to-end	2 SP	3

---

4. NUEVO RESUMEN DE STORY POINTS

4.1 Comparativa Final

Sprint	Original	Ajustado Anterior	Nuevo Ajuste	Delta
Sprint 1	44 SP	22 SP	3 SP	-41 SP
Sprint 2	39 SP	37 SP	15 SP	-24 SP
Sprint 3	36 SP	36 SP	16 SP	-20 SP
Sprint 4	33 SP	31 SP	5 SP	-28 SP
TOTAL	152 SP	126 SP	39 SP	-113 SP (74%)

4.2 Nuevo Plan por Sprint

SPRINT_1_NUEVO:
  total_sp: 3
  tareas:
    - DB-002: Ejecutar RLS validation (2 SP)
    - BE-001: Verificar jest config (1 SP)

SPRINT_2_NUEVO:
  total_sp: 15
  tareas:
    - BE-003: Tests Users Module (5 SP)
    - BE-004: Tests Roles Module (5 SP)
    - BE-005: Tests Tenants Module (5 SP)

SPRINT_3_NUEVO:
  total_sp: 16
  tareas:
    - BE-007: Tests Financial Module (8 SP)
    - BE-008: Tests Inventory Module (6 SP)
    - VALIDACION: Verificar OAuth flow (2 SP)

SPRINT_4_NUEVO:
  total_sp: 5
  tareas:
    - BE-010: Completar MFA si necesario (4 SP)
    - FE-014: Integrar theme selector (1 SP)

---

5. DEPENDENCIAS ENTRE ARCHIVOS EXISTENTES

5.1 Backend - Grafo de Dependencias

auth.routes.ts
    ├── auth.controller.ts
    │   └── auth.service.ts
    │       ├── token.service.ts
    │       │   └── Redis (blacklist)
    │       └── TypeORM repositories
    │
    ├── oauth.routes.ts
    │   └── oauth.controller.ts
    │       └── oauth.service.ts
    │           ├── google.provider.ts
    │           └── microsoft.provider.ts
    │
    ├── mfa.routes.ts
    │   └── mfa.controller.ts
    │       └── mfa.service.ts
    │
    └── email-verification.routes.ts
        └── email-verification.controller.ts
            └── email-verification.service.ts

5.2 Frontend - Grafo de Dependencias

routes.tsx
    ├── pages/catalogs/**
    │   └── features/catalogs/
    │       ├── api/catalog.api.ts
    │       ├── hooks/use*.ts
    │       ├── stores/*.store.ts
    │       └── components/*.tsx
    │
    ├── pages/settings/**
    │   └── features/settings/
    │       ├── api/settings.api.ts
    │       ├── hooks/use*.ts
    │       └── stores/*.store.ts
    │
    └── shared/
        ├── components/
        └── stores/
            ├── useAuthStore.ts
            ├── useUIStore.ts
            └── useNotificationStore.ts

---

6. ARCHIVOS CRITICOS - NO MODIFICAR

Los siguientes archivos son estables y NO deben modificarse:

Archivo	Razon
auth.service.ts	Core auth logic, stable
token.service.ts	JWT handling, tested
auth.routes.ts	Complete, only extend
routes.tsx	~800 lines, complex routing
config/redis.ts	Stable, with fallback
config/database.ts	Stable

---

7. VALIDACIONES REQUERIDAS

7.1 Verificar Funcionamiento (No Crear)

Componente	Archivo	Verificacion
OAuth Google	google.provider.ts	Test login flow
OAuth Microsoft	microsoft.provider.ts	Test login flow
Permission Cache	permission-cache.service.ts	Test <5ms
Email Verification	email-verification.service.ts	Test email send
MFA TOTP	mfa.service.ts	Verificar estado
Catalogs CRUD	catalogs feature	Test E2E
Settings CRUD	settings feature	Test E2E

7.2 Crear Tests para Modulos Sin Tests

Modulo	Prioridad	SP
users	Alta	5
roles	Alta	5
tenants	Alta	5
financial	Alta	8
inventory	Alta	6

---

8. RECOMENDACIONES

8.1 Acciones Inmediatas

1. NO crear archivos que ya existen - Verificar antes de crear
2. Ejecutar tests existentes - Medir cobertura actual
3. Validar OAuth flow - Probar con credenciales reales
4. Documentar estado actual - Actualizar inventario

8.2 Reduccion de Scope

El proyecto esta mucho mas avanzado de lo que indicaba el plan original. Se recomienda:

1. Cambiar enfoque a validacion en lugar de creacion
2. Crear tests faltantes (users, roles, tenants, financial, inventory)
3. Ejecutar RLS validation (tests SQL ya existen)
4. Verificar MFA status - Puede estar casi completo

8.3 Nuevo Objetivo

Objetivo Original: Crear infraestructura de tests y features
Objetivo Revisado: VALIDAR infraestructura existente y completar tests faltantes

---

9. CONCLUSION

9.1 Hallazgos Principales

• 74% del trabajo planificado ya esta completado
• OAuth, Email Verification, Permission Cache: EXISTEN
• Frontend Catalogs y Settings: COMPLETAMENTE IMPLEMENTADOS
• Tests de Auth: EXISTEN (49KB de tests)
• El enfoque debe cambiar de "creacion" a "validacion"

9.2 Nuevo Total de Trabajo

Metrica	Valor
SP Original	152
SP Ajustado Fase 2	126
SP Real (Fase 4)	39
Reduccion	74%
Foco principal	Tests de modulos foundation

---

Documento generado por: ORQUESTADOR (Claude Code Opus 4.5) Sistema: SIMCO + CAPVED Fase actual: D (Dependencias) - COMPLETADA Proxima fase: FASE 5 - Refinamiento Final del Plan