Guía para preparar el entorno de desarrollo Angular de Nebula ERP (SimappeAdmin, SimappeClient y futuros módulos web). Los comandos de instalación del sistema operativo de esta guía son para Ubuntu/Debian; en Windows se recomienda Node.js LTS con instalador oficial o NVM para Windows. Usa siempre la versión de Node indicada por el repositorio (.nvmrc, engines o documentación del proyecto) si está disponible.
package.json del repositorio que vas a trabajar.No es necesario instalar Java, Maven ni Spring Tools para trabajar únicamente en el frontend.
Node.js ejecuta el compilador, el servidor local y las herramientas de pruebas. npm instala las dependencias declaradas en package.json y fijadas por el lockfile.
Página oficial: Node.js.
# Agregar repositorio NodeSource para Node.js 22 LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# Instalar Node.js (npm se instala automaticamente)
sudo apt-get install -y nodejs
# Instalar NVM (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
source ~/.bashrc
# Instalar Node.js 22 LTS y configurarlo como version por defecto
nvm install 22
nvm use 22
nvm alias default 22
Verifica la instalación:
node --version
npm --version
Las versiones impresas dependen de cuándo se instalen y de la versión fijada por el proyecto.
Angular CLI permite ejecutar generación, desarrollo y compilación. Prioriza la CLI local del repositorio (npx ng ... o los scripts npm), porque respeta la versión que usa el proyecto. Si el equipo requiere el comando global ng, instala la versión principal compatible:
Página oficial: Angular CLI.
# Opcional: instalar Angular CLI global; usa la versión principal del proyecto
npm install -g @angular/cli@21
ng version
La versión instalada globalmente no sustituye la versión fijada por el proyecto. Revisa package.json y el lockfile antes de actualizar Angular o la CLI.
package.json y comprueba la versión requerida de Node (.nvmrc, engines o documentación del proyecto).package-lock.json, ejecuta npm ci; usa npm install solo al cambiar dependencias de forma intencional.npm run. Arranca con el script documentado por el proyecto, habitualmente npm start o npx nx serve <app> en repositorios Nx.node --version
npm --version
npm ci
npm run
No ejecutes npm audit fix, actualizaciones globales ni cambios de versiones como parte de la instalación inicial; pueden modificar el árbol de dependencias. Consulta Arquitectura Nx y Angular y Configuración inicial Nebula Core para el contexto propio del workspace.
# Clonar un repositorio de prueba para validar acceso
git clone https://TU_USUARIO@gitlab.centricasoluciones.com/nebula/cross-cutting/nebula-masters.git /tmp/test-clone
# Si pide password, usar el Personal Access Token proporcionado por el arquitecto
# Despues del primer clone exitoso, las credenciales quedan almacenadas
Crear o editar ~/.m2/settings.xml:
<settings>
<servers>
<server>
<id>centrica-nexus</id>
<username>TU_USUARIO</username>
<password>TU_PASSWORD</password>
</server>
</servers>
</settings>
Las credenciales de Nexus serán proporcionadas por el arquitecto al momento de la configuración.
# Login al registry de Docker de Centrica (si aplica)
docker login registry.centricasoluciones.com
# Ingresar usuario y password cuando lo solicite
Frontend: Git → Node.js/npm → clonar repositorio → instalar dependencias (npm ci) → CLI local y scripts del proyecto. Docker es opcional si se requieren APIs locales.
Backend: Git → Docker/Compose → Java → Maven → Spring Tools.
Fullstack: combina los pasos frontend y backend; configura primero las herramientas compartidas y luego los runtimes de cada stack.
Ejecuta los comandos pertinentes a tu rol y confirma que las versiones coincidan con el proyecto:
echo "=== VALIDACION AMBIENTE DESARROLLO ==="
echo ""
echo "--- COMUNES ---"
echo "Git: $(git --version)"
echo "Docker: $(docker --version)"
echo "Docker Compose: $(docker compose version)"
echo ""
echo "--- BACKEND ---"
echo "Java: $(java -version 2>&1 | head -1)"
echo "Maven: $(mvn -version 2>&1 | head -1)"
echo "STS: Abrir Spring Tools y verificar que inicie correctamente"
echo ""
echo "--- FRONTEND ---"
echo "Node.js: $(node --version)"
echo "npm: $(npm --version)"
echo "Angular CLI: $(ng version 2>&1 | grep 'Angular CLI')"
echo ""
echo "=== FIN VALIDACION ==="
La validación completa solo aplica a perfiles que tengan instaladas herramientas de backend. Para frontend, comprueba al menos Git, Node.js y npm; valida Docker si lo necesitas para servicios locales.
Área: Frontend — Nebula ERP, Centrica Soluciones
Última actualización: 15 de octubre de 2026