Desarrollo de fuentes y construcción de imágenes

Iniciar el entorno de desarrollo

Prepara Node.js 24+, pnpm 10.34.6, Docker Engine / Compose, rsync y mkcert. Ejecuta desde la raíz del repositorio:

pnpm install --frozen-lockfile
pnpm dev:prepare
pnpm dev

pnpm dev:prepare inicia servicios, crea imágenes y el centro de ayuda, e inicializa la base de datos de desarrollo preservando la configuración existente. La primera tirada puede pedir confiar en el mkcert local de California. pnpm dev acopla vigilantes y troncos; pnpm dev:stop detiene la pila de desarrollo.

Direcciones predeterminadas: Web http://localhost:18172 / https://localhost:18173, API http://localhost:4000, Runner http://localhost:4010. Utiliza las direcciones reales que reporta el lanzador.

Puntos de entrada de fuentes

• Espacio de trabajo web y administración
• API, permisos y lógica de negocio
• Corredores y trabajadores de tarea

Consulta el Arquitectura, Guía de desarrollo de repositorios y Guía de contribuciones. Ejecuta pruebas afectadas, pruebas de tipos, lint y builds antes de enviar cambios.

Compilar imágenes Docker desde la fuente

docker compose --env-file .env.example build \
  migrate api runner runner-worker-image web

El API Dockerfile proporciona runtime y migration objetivos; el Corredor proporciona controller y worker. Para imágenes multiarquitectura, usa docker buildx build --platform linux/amd64,linux/arm64 con el Dockerfile y destino adecuados. Prefiero Imágenes publicadas con pins digestos para instalaciones de producción normales. El Runbook de producción git de mantenedores cubre un flujo de trabajo separado para la construcción del código fuente.