workspace/devtools

DevTools - Herramientas de Desarrollo

Development tools, configurations, and scripts for the ISEM workspace.

Estructura

devtools/
├── configs/                    # Shared configurations
│   ├── eslint.config.base.js   # ESLint base configuration
│   ├── prettier.config.js      # Prettier configuration
│   ├── tsconfig.base.json      # TypeScript base configuration
│   └── jest.config.base.js     # Jest base configuration
├── docker/                     # Docker utilities
│   └── postgres-init/          # PostgreSQL initialization scripts
├── scripts/                    # Development scripts
│   ├── dev.sh                  # Main development helper
│   ├── bootstrap-project.sh    # Crear nuevo proyecto
│   └── validate-structure.sh   # Validar estructura
└── templates/                  # Project templates

Scripts Disponibles

dev.sh - Script principal de desarrollo

# Ver comandos disponibles
./scripts/dev.sh help

# Ver estado del workspace
./scripts/dev.sh status

# Iniciar servicios Docker
./scripts/dev.sh docker-up

# Iniciar un proyecto
./scripts/dev.sh start gamilit
./scripts/dev.sh start trading
./scripts/dev.sh start mecanicas

# Instalar dependencias
./scripts/dev.sh install

# Ver puertos asignados
./scripts/dev.sh ports

# Lint de proyectos
./scripts/dev.sh lint gamilit

bootstrap-project.sh

Crea un nuevo proyecto con estructura estándar.

# Uso
./scripts/bootstrap-project.sh <nombre> [tipo]

# Tipos disponibles
# - saas (default)
# - erp-vertical
# - analytics
# - edtech

# Ejemplos
./scripts/bootstrap-project.sh mi-proyecto
./scripts/bootstrap-project.sh erp-retail erp-vertical
./scripts/bootstrap-project.sh trading-bot analytics

validate-structure.sh

Valida la estructura del workspace y/o proyectos.

# Validar todo el workspace
./scripts/validate-structure.sh

# Validar un proyecto específico
./scripts/validate-structure.sh gamilit

Templates

project-template/

Template base para nuevos proyectos. Contiene:

• Estructura de directorios estándar
• Archivos README.md predefinidos
• Configuración de orchestration

customer-template/

Template para implementaciones de clientes. Contiene:

• Estructura de configuración
• Archivos de personalización
• Documentación del cliente

Configuraciones Compartidas

ESLint (eslint.config.js)

import baseConfig from '../../../devtools/configs/eslint.config.base.js';
export default [...baseConfig];

Prettier (.prettierrc.js)

module.exports = require('../../../devtools/configs/prettier.config.js');

TypeScript (tsconfig.json)

{
  "extends": "../../../devtools/configs/tsconfig.base.json",
  "compilerOptions": { "outDir": "./dist", "rootDir": "./src" }
}

Docker

Docker Compose principal en la raíz del workspace (/docker-compose.yml):

# Levantar todos los servicios
docker-compose up -d

# Ver logs
docker-compose logs -f

# Detener servicios
docker-compose down

Servicios incluidos:

• PostgreSQL 15 - Base de datos principal (multi-database)
• TimescaleDB - Series temporales para Trading Platform
• Redis 7 - Cache y sesiones
• MinIO - Almacenamiento S3-compatible
• Mailhog - Testing de emails
• Adminer - UI de administración de BD

Asignación de Puertos

Proyecto	Servicio	Puerto
Gamilit	Backend	3000
Gamilit	Frontend	5173
Trading	Backend	3001
Trading	Frontend	5174
Trading	Data Service	8001
ERP Core	Backend	3010
Mecánicas	Backend	3011
Shared	PostgreSQL	5432
Shared	TimescaleDB	5433
Shared	Redis	6379

---

DevTools del Workspace ISEM