Guía de desarrollo y pruebas

Este documento explica cómo desarrollar y probar el proyecto con los contenedores definidos en docker-compose.yml, y cómo conectarte a la base de datos desde tu máquina (fuera de la red interna de Docker). Complementa la guía Docker, la referencia API y el manual de pruebas.

Índice API Docker Base de datos Manual QA

1. Requisitos

• Docker Desktop o Docker Engine + Compose v2.
• RAM: al menos 4 GB libres (recomendado 6 GB+ para SQL Server 2022).
• Para desarrollo híbrido (API/web en host): .NET 8 SDK y Node.js 20+ con npm.
• Cliente SQL opcional: Azure Data Studio, DBeaver, SSMS o sqlcmd.

2. Arquitectura del stack Docker

3. Desarrollo y pruebas con todo en Docker

3.1 Levantar el entorno

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

docker compose up -d --build

• La primera ejecución descarga imágenes y compila API + frontend; puede tardar varios minutos.
• El servicio db debe pasar a healthy antes de que arranque api.
• Al iniciar, la API aplica migraciones EF y crea el usuario admin / admin si no existe.

3.2 URLs para probar

3.3 Credenciales de la aplicación

Tras login, el token JWT se guarda en localStorage (clave gotruck_token).

3.4 Flujo de prueba recomendado (Docker completo)

1. docker compose ps — los tres servicios en estado running; db healthy.
2. Abrir http://localhost:3000, iniciar sesión con admin / admin.
3. Ir a Datos demo (API) en el menú (#/datos-demo) y confirmar tablas con datos sembrados.
4. En Swagger: POST /api/auth/login → Authorize con Bearer → probar GET /api/catalogs/drivers (ver referencia API).
5. Revisar logs si algo falla: docker compose logs -f api o db.

3.5 Reconstruir tras cambios de código

3.6 Comandos útiles

# Estado y puertos
docker compose ps

# Logs en vivo
docker compose logs -f api
docker compose logs -f db

# Reiniciar un servicio
docker compose restart api

# Detener todo
docker compose down

4. Desarrollo híbrido (recomendado para iterar rápido)

Mantener solo SQL Server en Docker y correr API + frontend en el host con hot reload.

4.1 Base de datos en Docker, resto local

# Solo SQL Server
docker compose up -d db

# Esperar healthy (o: docker compose ps)
docker compose logs -f db

API (otra terminal):

cd src/GoTruckBackoffice.Api
dotnet run

Web (otra terminal):

cd src/Web
npm install
npm run dev

La cadena en src/GoTruckBackoffice.Api/appsettings.json ya apunta a Server=localhost,14333 con la misma contraseña que Docker.

4.2 Cuándo usar cada modo

5. Acceso a SQL Server desde fuera de Docker

El puerto 14333 del host se mapea al 1433 del contenedor. Cualquier herramienta en tu PC usa localhost (o 127.0.0.1), no el hostname db (ese nombre solo resuelve dentro de la red Compose).

5.1 Datos de conexión (resumen)

5.2 Cadenas de conexión listas para copiar

ADO.NET / appsettings (desde el host):

Server=localhost,14333;Database=GotruckDemo;User Id=sa;Password=Gotruck_Dev_2024!;TrustServerCertificate=True;MultipleActiveResultSets=true

JDBC (DBeaver, etc.):

jdbc:sqlserver://localhost:14333;databaseName=GotruckDemo;encrypt=true;trustServerCertificate=true

Azure Data Studio / SSMS:

• Tipo: SQL Server
• Servidor: localhost,14333
• Autenticación: SQL Server
• Login: sa · Password: Gotruck_Dev_2024!

5.3 Probar con sqlcmd desde el host (Windows)

Si tenés sqlcmd instalado (p. ej. con SQL Server tools):

sqlcmd -S localhost,14333 -U sa -P "Gotruck_Dev_2024!" -C -Q "SELECT name FROM sys.databases"

Consultar tablas de la demo:

sqlcmd -S localhost,14333 -U sa -P "Gotruck_Dev_2024!" -C -d GotruckDemo -Q "SELECT Codigo, Nombre FROM Repartidores"

Alternativa sin sqlcmd en el host: ejecutar dentro del contenedor
docker compose exec db /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'Gotruck_Dev_2024!' -C -d GotruckDemo -Q "SELECT 1"

5.4 Esquema y tablas relevantes

Tras la primera migración exitosa de la API:

Ejemplo para listar usuarios (solo desarrollo):

SELECT Id, NombreUsuario, CreadoEnUtc FROM Usuarios;

5.5 Diferencia: dentro vs fuera de Docker

6. Probar la API con autenticación (curl)

# Login
curl -s -X POST http://localhost:5000/api/auth/login ^
  -H "Content-Type: application/json" ^
  -d "{\"usuario\":\"admin\",\"clave\":\"admin\"}"

# Copiar el token de la respuesta y usarlo:
curl -s http://localhost:5000/api/dashboard/summary ^
  -H "Authorization: Bearer <TOKEN>"

En PowerShell podés usar Invoke-RestMethod con el mismo cuerpo JSON.

7. Solución de problemas

8. Archivos de referencia en el repo