rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS] docs: Update CLAUDE.md to reflect MCP migration to apps/

Browse Source 
- 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 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-02-06 10:43:34 -06:00
parent 616aa2c847
commit c9ad315a07
3 changed files with 88 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
.gitignore vendored
View File

@ -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/

36
CLAUDE.md
View File

@ -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]
├── 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.
---

58
apps/_MAP.md Normal file
View File

@ -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)*