rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
6b2baf8b0f
michangarrito/backups/orchestration-backup-2026-01-10/orchestration/analisis/DEPENDENCIAS-ARCHIVOS-2026-01-06.md
rckrdmrd 97f407c661 [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 
- Prefijo v2: MCH
- TRACEABILITY-MASTER.yml creado
- Listo para integracion como submodulo

Workspace: v2.0.0 | SIMCO: v4.0.0
2026-01-10 11:28:54 -06:00

10 KiB
Raw Blame History

Analisis de Dependencias entre Archivos - FASE 4

Fecha: 2026-01-06 Ejecutor: PERFIL_ORQUESTADOR

Objetivo

Documentar las dependencias entre archivos que seran modificados en FASE 2, identificando el orden correcto de modificacion y posibles conflictos.

1. MAPA DE ARCHIVOS A MODIFICAR

1.1 Backend (apps/backend/)

apps/backend/
├── src/
│   ├── main.ts                          [MODIFICAR - Puerto]
│   ├── app.module.ts                    [MODIFICAR - TypeORM config]
│   ├── common/
│   │   └── middleware/
│   │       └── tenant.middleware.ts     [CREAR - RLS]
│   └── modules/
│       └── auth/
│           └── entities/
│               ├── tenant.entity.ts     [VERIFICAR - Schema sync]
│               └── user.entity.ts       [VERIFICAR - Schema sync]
├── .env                                 [CREAR/MODIFICAR]
└── .env.example                         [ACTUALIZAR]

1.2 Frontend (apps/frontend/)

apps/frontend/
├── src/
│   ├── main.tsx                         [SIN CAMBIOS]
│   ├── App.tsx                          [MODIFICAR - Rutas auth]
│   ├── lib/
│   │   └── api.ts                       [MODIFICAR - Interceptors]
│   ├── contexts/
│   │   └── AuthContext.tsx              [CREAR]
│   ├── pages/
│   │   ├── Login.tsx                    [CREAR]
│   │   ├── Register.tsx                 [CREAR]
│   │   ├── Dashboard.tsx                [MODIFICAR - API real]
│   │   ├── Products.tsx                 [MODIFICAR - API real]
│   │   ├── Orders.tsx                   [MODIFICAR - API real]
│   │   ├── Customers.tsx                [MODIFICAR - API real]
│   │   ├── Fiado.tsx                    [MODIFICAR - API real]
│   │   ├── Inventory.tsx                [MODIFICAR - API real]
│   │   └── Settings.tsx                 [MODIFICAR - API real]
│   └── components/
│       └── Layout.tsx                   [MODIFICAR - Auth nav]
├── vite.config.ts                       [MODIFICAR - Proxy]
└── .env                                 [CREAR]

1.3 WhatsApp Service (apps/whatsapp-service/)

apps/whatsapp-service/
├── src/
│   ├── main.ts                          [MODIFICAR - Puerto]
│   └── webhook/
│       └── webhook.service.ts           [MODIFICAR - Backend calls]
└── .env                                 [ACTUALIZAR]

1.4 MCP Server (apps/mcp-server/)

apps/mcp-server/
├── src/
│   └── index.ts                         [MODIFICAR - Backend URL]
└── .env                                 [CREAR/ACTUALIZAR]

2. GRAFO DE DEPENDENCIAS

2.1 Dependencias Backend

.env (DB credentials)
    │
    ▼
app.module.ts (TypeORM import)
    │
    ├──────────────────────────────────┐
    │                                  │
    ▼                                  ▼
tenant.middleware.ts              entity/*.ts
    │                                  │
    └──────────┬───────────────────────┘
               │
               ▼
        main.ts (middleware registration)

Orden de modificacion Backend:

  1. .env - Credenciales DB
  2. app.module.ts - TypeORM config
  3. *.entity.ts - Verificar schemas
  4. tenant.middleware.ts - Crear nuevo
  5. main.ts - Puerto y middleware

2.2 Dependencias Frontend

.env (API URL)
    │
    ▼
vite.config.ts (proxy)
    │
    ▼
api.ts (axios config)
    │
    ▼
AuthContext.tsx (estado auth)
    │
    ├────────────────────────────────────────────┐
    │                                            │
    ▼                                            ▼
App.tsx (rutas)                            Layout.tsx (nav)
    │
    ├──► Login.tsx
    ├──► Register.tsx
    ├──► Dashboard.tsx
    ├──► Products.tsx
    ├──► Orders.tsx
    ├──► Customers.tsx
    ├──► Fiado.tsx
    ├──► Inventory.tsx
    └──► Settings.tsx

Orden de modificacion Frontend:

  1. .env - API URL
  2. vite.config.ts - Proxy
  3. api.ts - Interceptors
  4. AuthContext.tsx - Crear
  5. Login.tsx - Crear
  6. Register.tsx - Crear
  7. App.tsx - Rutas
  8. Layout.tsx - Nav auth
  9. Pages (paralelo)

2.3 Dependencias WhatsApp Service

.env (Backend URL, WhatsApp tokens)
    │
    ▼
main.ts (puerto)
    │
    ▼
webhook.service.ts (backend calls)

Orden: .env → main.ts → webhook.service.ts

2.4 Dependencias MCP Server

.env (Backend URL)
    │
    ▼
index.ts (URL config)

Orden: .env → index.ts

3. DEPENDENCIAS CROSS-PROJECT

3.1 Backend ← Otros Servicios

                    ┌── Frontend (api.ts)
                    │
Backend (main.ts) ◄─┼── WhatsApp Service (webhook.service.ts)
                    │
                    └── MCP Server (index.ts)

Implicacion: Backend DEBE estar funcionando antes de probar otros servicios

3.2 Database ← Backend

PostgreSQL (schemas DDL)
         │
         ▼
   Backend (TypeORM)

Implicacion: Database DEBE tener schemas creados antes de iniciar backend

4. ARCHIVOS CRITICOS Y SU IMPACTO

4.1 Archivos de Alto Impacto (Riesgo Alto)

Archivo Impacto Razon
app.module.ts CRITICO Configuracion central NestJS
api.ts ALTO Todas las llamadas API pasan aqui
AuthContext.tsx ALTO Estado de autenticacion global
vite.config.ts MEDIO Proxy afecta todas las llamadas
main.ts (backend) MEDIO Puerto y bootstrap

4.2 Archivos de Bajo Riesgo

Archivo Impacto Razon
Dashboard.tsx BAJO Cambio aislado
Products.tsx BAJO Cambio aislado
Settings.tsx BAJO Cambio aislado

5. CONFLICTOS POTENCIALES

5.1 Conflictos de Configuracion

Conflicto Archivos Resolucion
Puerto duplicado main.ts (backend vs whatsapp) Usar 3141 y 3143
DB credentials .env en multiples proyectos Centralizar en root
API URL api.ts vs webhook.service.ts Usar variable de entorno

5.2 Conflictos de Versionado

Item Backend Frontend Accion
TypeORM 0.3.19 N/A OK
Axios 1.6.5 1.13.2 Actualizar backend
TypeScript 5.3.3 5.9.3 OK (compatible)

6. ORDEN DE MODIFICACION RECOMENDADO

6.1 Dia 1: Preparacion y Backend Core

Hora 1-2:
  [1] database/.env.example → Verificar/crear
  [2] apps/backend/.env → Crear con credenciales

Hora 3-4:
  [3] apps/backend/src/app.module.ts → TypeORM config

Hora 5-6:
  [4] apps/backend/src/modules/**/entities/*.ts → Verificar sync

Hora 7-8:
  [5] apps/backend/src/common/middleware/tenant.middleware.ts → Crear
  [6] apps/backend/src/main.ts → Puerto + middleware

6.2 Dia 2: Frontend Auth

Hora 1-2:
  [7] apps/frontend/.env → Crear
  [8] apps/frontend/vite.config.ts → Proxy

Hora 3-4:
  [9] apps/frontend/src/lib/api.ts → Interceptors

Hora 5-8:
  [10] apps/frontend/src/contexts/AuthContext.tsx → Crear
  [11] apps/frontend/src/pages/Login.tsx → Crear
  [12] apps/frontend/src/pages/Register.tsx → Crear
  [13] apps/frontend/src/App.tsx → Rutas
  [14] apps/frontend/src/components/Layout.tsx → Nav

6.3 Dia 3: Frontend Pages + Services

Hora 1-4 (paralelo):
  [15] Dashboard.tsx
  [16] Products.tsx
  [17] Orders.tsx
  [18] Customers.tsx

Hora 5-6:
  [19] Fiado.tsx
  [20] Inventory.tsx
  [21] Settings.tsx

Hora 7-8:
  [22] apps/whatsapp-service/.env
  [23] apps/whatsapp-service/src/main.ts
  [24] apps/mcp-server/.env
  [25] apps/mcp-server/src/index.ts

6.4 Dia 4: WhatsApp + MCP Integration

Hora 1-4:
  [26] apps/whatsapp-service/src/webhook/webhook.service.ts

Hora 5-8:
  Testing y ajustes

7. MATRIZ DE IMPACTO

# Archivo Depende de Afecta a Riesgo
1 .env (db) - 3 BAJO
2 .env (backend) 1 3 BAJO
3 app.module.ts 2 4,5,6 ALTO
4 entities/*.ts 3 5 MEDIO
5 tenant.middleware.ts 3 6 MEDIO
6 main.ts (backend) 3,5 9,23,25 ALTO
7 .env (frontend) - 8 BAJO
8 vite.config.ts 7 9 MEDIO
9 api.ts 6,8 10-21 ALTO
10 AuthContext.tsx 9 11-14 ALTO
11 Login.tsx 10 13 MEDIO
12 Register.tsx 10 13 MEDIO
13 App.tsx 10,11,12 15-21 ALTO
14 Layout.tsx 10 15-21 MEDIO
15-21 Pages 9,10,13,14 - BAJO
22-23 WhatsApp .env/main 6 26 BAJO
24-25 MCP .env/index 6 - BAJO
26 webhook.service.ts 22,23 - MEDIO

8. ROLLBACK PLAN

8.1 Puntos de Checkpoint

Checkpoint Despues de Verificacion
CP1 Paso 6 Backend inicia, DB conectada
CP2 Paso 14 Frontend login funciona
CP3 Paso 21 Todas las paginas cargan
CP4 Paso 26 WhatsApp webhook responde

8.2 Rollback por Checkpoint

Fallo en Rollback a Accion
CP1 Sin cambios Revisar .env y app.module
CP2 CP1 Revisar api.ts y AuthContext
CP3 CP2 Revisar paginas individuales
CP4 CP3 Revisar webhook.service.ts

9. CONCLUSIONES

9.1 Archivos Criticos (No modificar sin backup)

  1. apps/backend/src/app.module.ts
  2. apps/frontend/src/lib/api.ts
  3. apps/frontend/src/contexts/AuthContext.tsx

9.2 Orden Inviolable

  1. Database schemas primero
  2. Backend .env segundo
  3. Backend TypeORM tercero
  4. Backend middleware cuarto
  5. Frontend despues de backend funcionando

9.3 Recomendaciones

  • Hacer commit despues de cada checkpoint
  • Probar backend aislado antes de frontend
  • Usar branch feature para cambios

Fin de Analisis de Dependencias FASE 4