From c9ad315a0704b510d4386dc81c68cb9a99c57bb0 Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Fri, 6 Feb 2026 10:43:34 -0600 Subject: [PATCH] [TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS] docs: Update CLAUDE.md to reflect MCP migration to apps/ - All 8 MCP submodules now under apps/ (canonical structure) - Removed exception note (migration successful) - Added branch note: MCPs use master, main apps use main Part of: TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS Sprint 4 Co-Authored-By: Claude Opus 4.6 --- .gitignore | 11 +++++++++- CLAUDE.md | 44 ++++++++++++++++++--------------------- apps/_MAP.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 88 insertions(+), 25 deletions(-) create mode 100644 apps/_MAP.md diff --git a/.gitignore b/.gitignore index 5f6636c..4573549 100644 --- a/.gitignore +++ b/.gitignore @@ -2,13 +2,22 @@ # SUBREPOSITORIOS - Tienen sus propios repositorios independientes # Ver .gitmodules para referencias # ============================================================================= +# Submodules in apps/ (ADR-0011) apps/backend/ apps/frontend/ apps/database/ apps/ml-engine/ apps/data-service/ +apps/mcp-auth/ +apps/mcp-binance-connector/ +apps/mcp-investment/ +apps/mcp-mt4-connector/ +apps/mcp-predictions/ +apps/mcp-products/ +apps/mcp-vip/ +apps/mcp-wallet/ -# Apps adicionales (sin subrepo aún) +# Apps adicionales (sin subrepo aun) apps/llm-agent/ apps/mt4-gateway/ apps/personal/ diff --git a/CLAUDE.md b/CLAUDE.md index e445227..580b92f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -83,32 +83,28 @@ Tables: 101 DDL | Enums: 50 | Functions: 36 | Triggers: 46 ``` trading-platform/ -├── apps/ ← Componentes principales (submodulos) -│ ├── backend/ → Express.js API -│ ├── frontend/ → React SPA -│ ├── database/ → DDL/Schemas -│ ├── data-service/ → Python data aggregation -│ └── ml-engine/ → Python ML service -├── mcp-auth/ → Auth service (port 3095) [submodulo, master] -├── mcp-binance-connector/ → Binance connector (port N/A) [submodulo, master] -├── mcp-investment/ → Investment service (port 3093) [submodulo, master] -├── mcp-mt4-connector/ → MT4 connector (port N/A) [submodulo, master] -├── mcp-predictions/ → ML signals (port 3094) [submodulo, master] -├── mcp-products/ → Products service (port 3091) [submodulo, master] -├── mcp-vip/ → VIP service (port 3092) [submodulo, master] -├── mcp-wallet/ → Wallet service (port 3090) [submodulo, master] -├── packages/ → Shared packages -├── docker/ → Docker configs -├── orchestration/ → Gobernanza SIMCO -└── docs/ → Documentacion +├── apps/ ← Todos los componentes (submodulos) +│ ├── backend/ → Express.js API (main) +│ ├── frontend/ → React SPA (main) +│ ├── database/ → DDL/Schemas (main) +│ ├── data-service/ → Python data aggregation (main) +│ ├── ml-engine/ → Python ML service (main) +│ ├── mcp-auth/ → Auth service, port 3095 (master) +│ ├── mcp-binance-connector/ → Binance connector (master) +│ ├── mcp-investment/ → Investment service, port 3093 (master) +│ ├── mcp-mt4-connector/ → MT4 connector (master) +│ ├── mcp-predictions/ → ML signals, port 3094 (master) +│ ├── mcp-products/ → Products service, port 3091 (master) +│ ├── mcp-vip/ → VIP service, port 3092 (master) +│ └── mcp-wallet/ → Wallet service, port 3090 (master) +├── packages/ → Shared packages +├── docker/ → Docker configs +├── orchestration/ → Gobernanza SIMCO +└── docs/ → Documentacion ``` -> **EXCEPCION ESTRUCTURA (ADR-0004):** Los 8 modulos MCP permanecen en raiz (no en apps/) -> porque son submodulos en branch `master` (no `main`). Migrarlos requeriria: -> (1) cambiar branch en 8 repos remotos, (2) deinit+re-add submodulos, (3) actualizar -> docker-compose y CI. Se acepta como variante valida para este proyecto STANDALONE. -> Las copias regulares en apps/mcp-binance-connector/ y apps/mcp-mt4-connector/ son -> duplicados obsoletos pendientes de eliminacion. +> **NOTA:** Los 8 MCP submodulos usan branch `master` (no `main`). Los 5 apps principales +> usan branch `main`. Migracion de branch pendiente cuando se actualicen los repos remotos. --- diff --git a/apps/_MAP.md b/apps/_MAP.md new file mode 100644 index 0000000..7be6cf5 --- /dev/null +++ b/apps/_MAP.md @@ -0,0 +1,58 @@ +# _MAP: Aplicaciones de trading-platform + +**Carpeta:** apps/ +**Proposito:** Contenedor canonico de todas las aplicaciones del proyecto (ADR-0011) +**Estado:** Activo +**Ultima actualizacion:** 2026-02-06 + +--- + +## Aplicaciones Principales + +| App | Ruta | Tipo | Stack | Estado | Git | +|-----|------|------|-------|--------|-----| +| **Backend API** | `apps/backend/` | API REST | Express.js 5 + TypeScript 5 | Activo | Submodule (trading-platform-backend-v2) | +| **Frontend** | `apps/frontend/` | SPA | React 18 + Vite 6 + Zustand | Activo | Submodule (trading-platform-frontend-v2) | +| **Database** | `apps/database/` | DDL | PostgreSQL 16+ (11 schemas) | Activo | Submodule (trading-platform-database-v2) | +| **ML Engine** | `apps/ml-engine/` | API ML | FastAPI + Python 3.11 | Activo | Submodule (trading-platform-ml-engine-v2) | +| **Data Service** | `apps/data-service/` | Data | Python + Aggregation | Activo | Submodule (trading-platform-data-service-v2) | + +## MCP Services (8) + +| App | Ruta | Puerto | Descripcion | Git | +|-----|------|--------|-------------|-----| +| **MCP Auth** | `apps/mcp-auth/` | 3095 | Auth service | Submodule | +| **MCP Wallet** | `apps/mcp-wallet/` | 3090 | Wallet service | Submodule | +| **MCP Products** | `apps/mcp-products/` | 3091 | Products service | Submodule | +| **MCP VIP** | `apps/mcp-vip/` | 3092 | VIP service | Submodule | +| **MCP Investment** | `apps/mcp-investment/` | 3093 | Investment service | Submodule | +| **MCP Predictions** | `apps/mcp-predictions/` | 3094 | ML signals service | Submodule | +| **MCP Binance** | `apps/mcp-binance-connector/` | - | Binance connector | Submodule | +| **MCP MT4** | `apps/mcp-mt4-connector/` | - | MetaTrader connector | Submodule | + +--- + +## Metricas + +| Componente | Metrica | Valor | +|-----------|---------|-------| +| Database | Schemas | 11 | +| Database | Tablas DDL | 101 | +| Backend | Modulos | 18 | +| Backend | Type Interfaces | 85/101 (84%) | +| Frontend | Componentes | 225 (185 funcionales) | +| Frontend | Paginas | 58 | +| MCP Services | Total | 8 | +| Total Submodules | | 13 | + +--- + +## Notas + +- Arquitectura hibrida TypeScript + Python +- `packages/` queda en raiz (shared SDK code, no es app) +- `docker/` queda en raiz (configuracion Docker) + +--- + +*Generado por TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS (Sprint 4)*