Guía Docker — ArcorTruck BackOffice (demo)

Esta guía describe cómo levantar el entorno con tres contenedores (frontend, API .NET 8 y SQL Server 2022), qué URLs usar y cómo comprobar que el sistema funciona con datos de prueba precargados.

1. Requisitos

• Docker Desktop o Docker Engine + Docker Compose v2.
• Al menos 4 GB de RAM libres para SQL Server (recomendado 6 GB+ en el host).
• En Apple Silicon (ARM), la imagen oficial de SQL Server puede requerir emulación linux/amd64; si el contenedor db no arranca, agregá en docker-compose.yml bajo el servicio db:

yaml platform: linux/amd64

2. Cómo iniciar el stack

En la raíz del repositorio (donde está docker-compose.yml):

Stack completo (SQL en contenedor — demo):

docker compose -f docker-compose.yml -f docker-compose.dev.yml --profile dev up -d --build

Solo app (SQL en el host Windows — similar a IIS):

docker compose -f docker-compose.yml -f docker-compose.app.yml --profile app up -d --build

Ver instalacion_iis_windows.md para producción en IIS.

Script de reset / restore (scripts/docker-dev-reset.ps1)

• La primera vez descarga imágenes base (SQL Server, .NET, Node, nginx) y puede tardar varios minutos.
• SQL Server expone un healthcheck; el servicio api espera a que db esté healthy antes de arrancar.

3. Puertos y servicios

Credenciales de demo (no usar en producción):

• Usuario SQL: sa
• Contraseña: Gotruck_Dev_2024!
• Base creada por la API: GotruckDemo

4. Cómo ingresar y ver el sistema funcionando

4.1 Abrir la aplicación web

1. Abrí el navegador en: http://localhost:3000
2. Deberías ver el panel “ArcorTruck · BackOffice (demo)” con:
3. Indicador “API · SQL Server OK” (verde) si la API alcanzó la base.
4. Tarjetas de resumen (hojas de reparto, visitas, entregas, montos).
5. Tablas de repartidores, clientes y hojas de reparto con datos de prueba.

Si ves un mensaje de error de conexión, esperá unos segundos y recargá: la API aplica migraciones EF al iniciar y puede tardar un poco la primera vez.

4.2 Probar la API directamente

• Salud y conexión a BD: http://localhost:5000/api/health
• Swagger (documentación interactiva): http://localhost:5000/swagger
• Otros endpoints JSON:
• GET http://localhost:5000/api/drivers
• GET http://localhost:5000/api/customers
• GET http://localhost:5000/api/delivery-sheets
• GET http://localhost:5000/api/dashboard/summary

El frontend llama a la misma API vía proxy en el mismo origen: http://localhost:3000/api/... (nginx reenvía al contenedor api).

4.3 Conectar un cliente SQL (opcional)

Desde tu host (con sqlcmd, Azure Data Studio, DBeaver, etc.):

• Servidor: localhost,14333
• Usuario: sa
• Contraseña: Gotruck_Dev_2024!

Bases disponibles en el mismo servidor:

4.4 Base operativa ArcorGev5Reparto — regla de lectura

La base del cliente define dos conjuntos de tablas operativas además de los maestros I_*:

Documentación completa: base_datos_arcor_gev5.html en esta carpeta; versión HTML en ../html/base_datos_arcor_gev5.html.

5. Datos de prueba incluidos (GotruckDemo)

Los datos se insertan con la migración EF InitialCreate (semilla en AppDbContext):

• 3 repartidores (REP-001, REP-002, REP-003; uno inactivo).
• 4 clientes con razón social y localidad argentina de ejemplo.
• 3 hojas de reparto con métricas (visitas planificadas/realizadas, entregas OK/rechazadas, montos cobrado/pendiente).

El endpoint GET /api/dashboard/summary agrega todas las hojas para mostrar totales en el panel.

6. Desarrollo local sin Docker (opcional)

1. Levantá solo SQL Server: docker compose up -d db y esperá estado healthy.
2. API: en src/GoTruckBackoffice.Api, appsettings.json ya apunta a localhost,14333 con la misma contraseña.
3. dotnet run en la carpeta de la API (puerto según launchSettings.json, típicamente 5xxx).
4. Frontend: en src/Web, npm install y npm run dev (Vite en 5173 con proxy a 5000 en vite.config.ts). Ajustá el proxy si tu API usa otro puerto.

7. Detener y limpiar

docker compose down

Para borrar también los datos persistentes del volumen de SQL Server (si en el futuro agregás un volumen nombrado), usá docker volume ls / docker volume rm según corresponda. En la configuración actual, los datos viven en la capa del contenedor db; al eliminar el contenedor sin volumen externo, se pierden al hacer docker compose down seguido de prune de contenedores.

8. Estructura relevante

9. Solución de problemas

• db unhealthy: revisá RAM del host y logs con docker compose logs db.
• Puerto ocupado: cambiá el mapeo en docker-compose.yml (por ejemplo 5001:8080 para la API) y actualizá el proxy en src/Web/vite.config.ts si desarrollás sin nginx.
• Error de migración en la API: consultá docker compose logs api; suele deberse a que SQL aún no terminó de inicializar (reintentá con docker compose restart api).

Entorno pensado únicamente para demostración y desarrollo; no exponer la contraseña sa ni estos puertos en redes públicas.