rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration

- Configure workspace Git repository with comprehensive .gitignore
- Add Odoo as submodule for ERP reference code
- Include documentation: SETUP.md, GIT-STRUCTURE.md
- Add gitignore templates for projects (backend, frontend, database)
- Structure supports independent repos per project/subproject level

Workspace includes:
- core/ - Reusable patterns, modules, orchestration system
- projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.)
- knowledge-base/ - Reference code and patterns (includes Odoo submodule)
- devtools/ - Development tools and templates
- customers/ - Client implementations template

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-08 10:44:23 -06:00

6.1 KiB

Raw Blame History

INICIO RÁPIDO - CONFIGURACIÓN DE PUERTOS

Configuración completada el: 2025-12-05

ARCHIVOS IMPORTANTES

1. Configuración de Puertos

📄 .env.ports - Definición centralizada de todos los puertos

2. Docker Compose

🐳 docker-compose.yml - Orquestación completa de servicios

3. Documentación

📚 docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md - Guía completa

4. Scripts de Verificación

🔧 scripts/check-ports.sh - Verificar estado de puertos

5. Configuración del Proyecto

⚙️ orchestration/environment/PROJECT-ENV-CONFIG.yml - Config centralizada

PUERTOS ASIGNADOS (QUICK REFERENCE)

┌─────────────────────────────────────────────────────────┐
│                   FRONTEND SERVICES                      │
├─────────────────────────────────────────────────────────┤
│  Frontend Web (React)          →  3100                  │
│  Frontend Admin (futuro)       →  3101                  │
│  Frontend Preview (Vite)       →  4173                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   BACKEND SERVICES                       │
├─────────────────────────────────────────────────────────┤
│  Backend API (Express)         →  4000                  │
│  Backend WebSocket             →  4001                  │
│  Backend Webhooks              →  4002                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   PYTHON SERVICES                        │
├─────────────────────────────────────────────────────────┤
│  ML Engine (FastAPI)           →  5000                  │
│  Data Service                  →  5001                  │
│  LLM Agent (futuro)            →  5002                  │
│  Portfolio Manager (futuro)    →  5003                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   INFRASTRUCTURE                         │
├─────────────────────────────────────────────────────────┤
│  PostgreSQL                    →  5432  ✓ ACTIVO        │
│  Redis                         →  6379  ✓ ACTIVO        │
└─────────────────────────────────────────────────────────┘

COMANDOS ESENCIALES

Verificar Estado de Puertos

bash scripts/check-ports.sh

Iniciar Todo con Docker

docker-compose up -d

Ver Logs

docker-compose logs -f

Verificar Puertos Ocupados

ss -tuln | grep LISTEN

Verificar un Puerto Específico

lsof -i :4000

ESTADO ACTUAL

✅ Servicios Activos

PostgreSQL en puerto 5432
Redis en puerto 6379

⚠️ Puertos Ocupados (No usar)

3000 - Ya en uso por otro servicio
8000 - Ya en uso por otro servicio

🔄 Servicios Por Configurar

Backend API: Actualizar de puerto 3000 → 4000
Frontend Web: Actualizar de puerto 5173 → 3100
ML Engine: Confirmar puerto 5000
Data Service: Configurar puerto 5001

PRÓXIMOS PASOS

1. Actualizar Backend

cd apps/backend
# Editar .env
PORT=4000

2. Actualizar Frontend

cd apps/frontend
# Editar vite.config.ts
server.port = 3100

3. Probar Docker Compose

docker-compose up -d
docker-compose logs -f

4. Verificar Conectividad

curl http://localhost:4000/health
curl http://localhost:5000/health

URLs DE ACCESO RÁPIDO

Servicio	URL
Frontend	http://localhost:3100
Backend API	http://localhost:4000/api/v1
Backend Health	http://localhost:4000/health
ML Engine Docs	http://localhost:5000/docs
PgAdmin	http://localhost:5050

TROUBLESHOOTING RÁPIDO

Puerto ya en uso

# Ver qué está usando el puerto
lsof -i :4000

# Matar proceso
kill -9 $(lsof -t -i :4000)

Docker no levanta

# Ver logs
docker-compose logs backend

# Reiniciar servicio
docker-compose restart backend

# Reconstruir
docker-compose up -d --build backend

Variables de entorno no cargan

# Verificar que existe .env
ls -la apps/backend/.env

# Ver variables
cat apps/backend/.env | grep PORT

DOCUMENTACIÓN COMPLETA

Para información detallada, ver:

docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md

¿Preguntas? Revisar la documentación completa o ejecutar bash scripts/check-ports.sh

6.1 KiB Raw Blame History