Instrucciones

Cómo levantar, probar y apagar EMPRESA_JOSESAID con los scripts del proyecto.

Arrancar el proyecto

Cinco pasos, desde la raíz del proyecto. Solo el paso 1 se hace una vez.

1
Preparar los scripts

Dale permiso de ejecución a los scripts y verifica que exista el archivo .env.
```
chmod +x configuration_scripts/*.sh
```
2
Compilar y construir

Compila los 14 proyectos Maven, construye las imágenes Docker y genera la documentación Swagger.

Es lento: tarda aproximadamente 2 min 30 s por servicio al construir las imágenes, unos 30 minutos en los 12 servicios de la raíz. Úsalo solo cuando sea necesario, después de un cambio fuerte en el código o en los Dockerfiles.
```
./configuration_scripts/build.sh
```
3
Levantar el entorno

Inicia la base de datos, Kafka, los microservicios y la UI. Espera a que todo esté healthy y abre el login.
```
./configuration_scripts/start.sh
```
4
Probar un servicio

Ejecuta las pruebas de un servicio. Cambia clientes por el servicio que quieras probar.
```
./ejecutar-pruebas-clientes.sh
```
5
Revisar la API

Abre la documentación de los endpoints de cada microservicio en Swagger.
```
open docs/api/index.html
```

Apagar el proyecto

Tres pasos, en orden. Los datos se conservan.

1
Detener los servicios

Apaga todos los contenedores y redes del proyecto, incluida la UI (ui-ms). Los volúmenes de PostgreSQL, Redis y Kafka no se borran.
```
./configuration_scripts/stop.sh
```
2
Liberar espacio (opcional)

Borra las carpetas target de Maven. Son temporales y build.sh las vuelve a crear.
```
./configuration_scripts/rm-target-directories.sh
```
3
Confirmar que no queda nada

La lista debe salir vacía. Si aparece algún contenedor del proyecto, repite el paso 1.
```
docker ps --filter "label=com.docker.compose.project"
```

Antes de empezar: ten Docker Desktop instalado. Si está cerrado, build.sh y start.sh lo abren solos.