Setup Local

Requisitos Previos

Software	Versión Mínima	Propósito
Node.js	20.x LTS	Runtime para Orchestrator y Sevastopol
PostgreSQL	16.x	Base de datos
Git	2.x	Control de versiones
Python	3.11+	Scripts ETL (accounting_system)

---

Clonar Repositorio

git clone https://github.com/ChrisTkm/Nostromo.git
cd Nostromo

---

Estructura del Monorepo

Nostromo/
├── orchestrator/       # Backend Node.js
├── sevastopol/         # Frontend Astro
├── accounting_system/  # Scripts ETL Python
├── jean_d_arc/         # Esta documentación
└── .github/            # Skills y workflows

---

Setup por Componente

Orchestrator (Backend)

1. Instalar dependencias

   cd orchestrator
   npm install

2. Configurar variables de entorno

   cp .env.example .env
   # Editar .env con credenciales de PostgreSQL

3. Iniciar en desarrollo

   npm run dev

Note

El backend corre en https://localhost:8000 por defecto.

---

Sevastopol (Frontend)

1. Instalar dependencias

   cd sevastopol
   npm install

2. Configurar API endpoint

   cp .env.example .env
   # Verificar que API_URL apunta al Orchestrator

3. Iniciar en desarrollo

   npm run dev

Note

El frontend corre en http://localhost:4321 por defecto.

---

Jean d’Arc (Documentación)

1. Instalar dependencias

   cd jean_d_arc
   npm install

2. Iniciar servidor de desarrollo

   npm run dev

3. Build para producción

   npm run build

---

Base de Datos

Crear Base de Datos

CREATE DATABASE nostromo;

Ejecutar Migraciones

cd orchestrator
npm run migrate

Cargar Datos de Prueba

npm run seed

---

Verificar Instalación

Componente	URL	Verificación
Orchestrator	https://localhost:8000/health	Debe retornar {"status": "ok"}
Sevastopol	http://localhost:4321	Debe mostrar página de login
Jean d’Arc	http://localhost:4322	Debe mostrar documentación

---

Troubleshooting

Puerto ocupado

# Verificar qué usa el puerto
netstat -ano | findstr :8000

Error de conexión a PostgreSQL

Verificar que el servicio esté corriendo:

pg_isready -h localhost -p 5432

Errores de SSL en desarrollo

El Orchestrator usa HTTPS. Si hay problemas con certificados:

# Generar certificados de desarrollo
npm run generate-certs