rckrdmrd
97f407c661
- Prefijo v2: MCH - TRACEABILITY-MASTER.yml creado - Listo para integracion como submodulo Workspace: v2.0.0 | SIMCO: v4.0.0
392 lines
10 KiB
Markdown
392 lines
10 KiB
Markdown
# 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**
|