Instalación en Windows Server — IIS + SQL Server local

Guía para desplegar GoTruck BackOffice en un servidor Windows Server con:

• SQL Server instalado en el mismo equipo (base operativa ArcorGev5Reparto).
• IIS existente como punto de entrada HTTPS.
• API .NET 8 escuchando solo en localhost (no expuesta directamente).
• Frontend estático servido por IIS con proxy inverso de /api hacia la API.

Este escenario replica el entorno productivo típico de una distribuidora (un solo servidor, datos locales, acceso por URL interna o VPN).

1. Arquitectura recomendada

                    [ Clientes navegador ]
                              |
                         HTTPS :443
                              v
+-------------------------------------------------------------+
|  Windows Server                                              |
|  IIS (sitio: gotruck.empresa.local)                          |
|    |-- /, /docs/     -> archivos estáticos (dist + docs)     |
|    |-- /api/*        -> proxy ARR -> http://127.0.0.1:5080  |
|                                                              |
|  API (Kestrel o servicio Windows / app pool dedicado)        |
|    escucha SOLO 127.0.0.1:5080                               |
|                                                              |
|  SQL Server (instancia local)                                |
|    base: ArcorGev5Reparto (+ tabla dbo.Usuarios backoffice)  |
+-------------------------------------------------------------+

Por qué es seguro

2. Requisitos del servidor

Software

Hardware orientativo

• RAM: 8 GB mínimo (16 GB si SQL y IIS comparten carga de reportes/mapas).
• Disco: espacio para backup .bak y logs IIS/API.
• Red: puerto 443 (HTTPS) hacia el sitio; no abrir el puerto 5080 al firewall perimetral.

Base de datos

1. Restaurar o disponer de la base ArcorGev5Reparto en SQL Server local.
2. Ver convenciones de lectura (E_*, I_*) en base_datos_arcor_gev5.html.
3. La API crea/actualiza la tabla dbo.Usuarios al arrancar (usuarios del backoffice, no del ERP).
4. Crear login SQL dedicado (ejemplo):

CREATE LOGIN gotruck_app WITH PASSWORD = 'ClaveFuerteAquí';
USE ArcorGev5Reparto;
CREATE USER gotruck_app FOR LOGIN gotruck_app;
ALTER ROLE db_datareader ADD MEMBER gotruck_app;
-- Si en el futuro hubiera escritura en tablas propias:
-- ALTER ROLE db_datawriter ADD MEMBER gotruck_app;

Ajuste permisos según política de seguridad (solo lectura en E_*/I_* es el caso habitual).

3. Publicar artefactos

Desde una estación de build (o el propio servidor con SDK/Node):

cd C:\ruta\arcor-gotruck-backoffice-web
.\scripts\publish-iis.ps1 `
  -WebOutput C:\Deploy\gotruck\wwwroot `
  -ApiOutput C:\Deploy\gotruck\api

Esto ejecuta:

• dotnet publish de la API en Release.
• npm run build del SPA y copia dist/ a wwwroot.
• Copia docs/html/ a wwwroot\docs\ (documentación).
• Copia deploy\iis\web.config al wwwroot.

Configuración de producción de la API

Opción A — Variable de entorno del App Pool (recomendada para la cadena de conexión)

Configurar la cadena de conexión como variable de entorno mantiene las credenciales SQL fuera de cualquier archivo en disco y simplifica las actualizaciones (no hay archivo que preservar entre versiones).

Vía IIS Manager (Windows Server 2016 / IIS 10+):

1. IIS Manager → Application Pools → GoTruckApi → Advanced Settings → Environment Variables.
2. Agregar entrada:

Vía web.config del sitio de la API (dentro del elemento <aspNetCore>):

<environmentVariables>
  <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
  <environmentVariable name="ConnectionStrings__DefaultConnection"
    value="Server=(local);Database=ArcorGev5Reparto;User Id=gotruck_app;Password=***;..." />
</environmentVariables>

ASP.NET Core usa __ (doble guión bajo) como separador de jerarquía en variables de entorno. ConnectionStrings__DefaultConnection equivale a ConnectionStrings:DefaultConnection en JSON.

La variable de entorno tiene mayor precedencia que appsettings.Production.json. Si está definida, el valor del archivo es ignorado automáticamente.

Opción B — Archivo appsettings.Production.json

Si no es posible configurar variables de entorno en el servidor, copie y edite:

deploy\iis\appsettings.Production.example.json
  -> C:\Deploy\gotruck\api\appsettings.Production.json

Asegúrese de que appsettings.Production.json no quede bajo control de versiones. Al actualizar la aplicación, preserve este archivo — el instalador no lo sobreescribe si ya existe y tiene valores válidos.

4. Instalar y registrar la API (localhost)

Opción A — Sitio IIS solo para la API (recomendada con proxy ARR)

1. Cree un Application Pool GoTruckApi:
2. .NET CLR version: No Managed Code

3. Identity: cuenta de servicio con permiso de lectura en carpeta y acceso SQL.

4. Cree un sitio o aplicación interna:

5. Enlace: http://127.0.0.1:5080 (solo loopback).
6. Ruta física: C:\Deploy\gotruck\api.

7. Pool: GoTruckApi.

8. El web.config generado por dotnet publish debe contener el módulo AspNetCore. Si falta:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet"
                  arguments=".\GoTruckBackoffice.Api.dll"
                  stdoutLogEnabled="true"
                  stdoutLogFile=".\logs\stdout"
                  hostingModel="inprocess">
        <environmentVariables>
          <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
        </environmentVariables>
      </aspNetCore>
    </system.webServer>
  </location>
</configuration>

1. Cree la carpeta logs con permisos de escritura para el pool.

2. Prueba local en el servidor:

Invoke-WebRequest -Uri http://127.0.0.1:5080/api/health -UseBasicParsing

Debe responder JSON con servicio / baseDatosOk.

Opción B — Servicio Windows + Kestrel

Útil si prefiere no hospedar la API en IIS:

cd C:\Deploy\gotruck\api
$env:ASPNETCORE_ENVIRONMENT = "Production"
$env:ASPNETCORE_URLS = "http://127.0.0.1:5080"
# Registrar con sc.exe o NSSM apuntando a: dotnet GoTruckBackoffice.Api.dll

5. Configurar IIS — sitio del frontend

5.1 Habilitar proxy ARR (una vez por servidor)

1. IIS Manager → seleccionar el servidor (no el sitio).
2. Application Request Routing Cache → Server Proxy Settings.
3. Marcar Enable proxy → Apply.

5.2 Crear el sitio

5.3 web.config del frontend

El archivo en deploy\iis\web.config (copiado por publish-iis.ps1) define:

• Regla API: ^api/(.*) → http://127.0.0.1:5080/api/{R:1}.
• Regla SPA: fallback a index.html.
• Cabeceras X-Forwarded-* para la API.

Si cambia el puerto de la API, edite la URL en la regla de rewrite.

5.4 Permiso para variables de servidor (opcional)

Si IIS exige declarar variables en rewrite:

1. IIS → sitio → URL Rewrite → View Server Variables.
2. Permitir HTTP_X_FORWARDED_PROTO y HTTP_X_FORWARDED_HOST para el sitio.

5.5 Documentación

Tras publicar, la ayuda está en:

https://gotruck.empresa.local/docs/index.html

6. Comunicación segura front ↔ back

El SPA (src/Web) llama siempre a rutas relativas /api/.... Con IIS en el mismo host:

1. El navegador envía Authorization: Bearer … a https://sitio/api/....
2. IIS termina TLS y reenvía a http://127.0.0.1:5080/api/... (red loopback).
3. La API valida JWT y consulta SQL Server en localhost.

No se requiere exponer la API en firewall. Configure Cors:AllowedOrigins con la URL HTTPS del sitio por si accede desde otro origen en pruebas.

Swagger en producción: deshabilitado salvo ASPNETCORE_ENVIRONMENT=Development. Para pruebas en servidor use temporalmente Development solo en loopback o acceda a /swagger vía túnel RDP.

7. Checklist post-instalación

Cambie la contraseña del usuario admin tras el primer acceso (menú Sistema → Usuarios).

8. Docker equivalente (SQL en el host)

Para pruebas en contenedores sin SQL en Docker (misma idea que IIS):

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

• web → http://localhost:3000 (nginx hace proxy /api al contenedor api).
• api → usa host.docker.internal para alcanzar SQL Server del host Windows.

Ajuste la contraseña en docker-compose.app.yml. El perfil dev sigue levantando SQL en contenedor:

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

9. Mantenimiento y actualización

1. Detener el sitio o el pool de la API (evitar archivos bloqueados).
2. Ejecutar de nuevo publish-iis.ps1 hacia carpetas de despliegue.
3. Revisar appsettings.Production.json (no sobrescribir si está solo en servidor).
4. Arrancar pools / servicio.
5. Comprobar /api/health.

Logs

• API IIS: C:\Deploy\gotruck\api\logs\stdout_*.log
• IIS: logs W3SVC del sitio.
• SQL: según política del DBA.

10. Solución de problemas

11. Referencias del repositorio

Documento alineado al despliegue Windows Server + IIS + SQL Server local. Actualice hostnames, puertos y credenciales según su infraestructura.