Infraestructura

IZ-CentralForms se encuentra actualmente en ambiente local de desarrollo. La aplicación está preparada para ejecutarse localmente como ASP.NET Core Web API y para una futura publicación en Windows Server con IIS, SQL Server real y SMTP externo.

Esta página documenta la infraestructura actual, la infraestructura objetivo y las condiciones mínimas para pasar de local a QA, staging o producción.

Estado actual

Elemento	Configuración actual
API	ASP.NET Core Web API net10.0
Ejecución	Perfiles locales http y https
URLs locales	http://localhost:5273 / https://localhost:7122
Ambiente	Development
Base de datos	SQL Server LocalDB: (localdb)\MSSQLLocalDB
Swagger	Habilitado en desarrollo
Email local	SMTP localhost:1025
SDK JS	Servido desde wwwroot/sdk/centralforms.js
Ejemplo SDK	wwwroot/examples/contacto.html
Seed demo	Activo en desarrollo
Producción	No desplegada todavía

Estado actual

La aplicación está funcionando como entorno local. IIS, SQL Server real, dominio público, SSL y SMTP productivo son componentes de despliegue futuro.

Modelo local

El ambiente local usa la siguiente composición:

ASP.NET Core local
+ SQL Server LocalDB
+ Swagger
+ SDK estático desde wwwroot
+ SMTP local / Mailpit

Servicio local	Uso
API local	Ejecutar y probar CentralForms.Api.
SQL Server LocalDB	Persistir formularios, submissions, tokens CSRF e integration logs en desarrollo.
Swagger	Probar endpoints manualmente.
SDK JS	Validar integración desde HTML local.
SMTP local	Probar envío de correos sin usar un proveedor real.

LocalDB

LocalDB es válido solo para desarrollo local. No debe usarse con IIS, QA, staging ni producción.

Modelo objetivo para servidor

Para QA, staging o producción, el modelo recomendado es:

Windows Server
+ IIS
+ .NET Hosting Bundle
+ SQL Server real
+ SMTP externo
+ HTTPS

Componente	Requisito
Sistema operativo	Windows Server
Hosting	IIS con Application Pool dedicado
Runtime	.NET Hosting Bundle compatible con net10.0
Base de datos	SQL Server Express, Standard o Enterprise
Configuración	appsettings.Production.json o variables de entorno
Email	SMTP real, Mailtrap, Resend o proveedor corporativo
Seguridad	HTTPS obligatorio
Swagger	Restringido o deshabilitado en producción
Logs	IIS logs, logs de aplicación e IntegrationLogs

Ambientes

Ambiente	API	Base de datos	Email	Swagger	Observación
Local	ASP.NET Core local	LocalDB	localhost:1025 / Mailpit	Habilitado	Ambiente actual
QA / Staging	IIS recomendado	SQL Server real	Mailtrap o SMTP real	Habilitado o restringido	Pendiente
Producción	IIS recomendado	SQL Server real	SMTP real autorizado	Restringido o deshabilitado	Pendiente

Topología objetivo

Aplicación consumidora
        |
        | HTTPS
        v
CentralForms API en IIS
        |
        | EF Core
        v
SQL Server
        |
        +--> SMTP externo
        |
        +--> Webhook externo

Requisitos de servidor

Para desplegar CentralForms fuera del entorno local se requiere:

• Windows Server.
• IIS habilitado.
• .NET Hosting Bundle compatible con net10.0.
• SQL Server real.
• Certificado SSL válido.
• Proveedor SMTP o sandbox autorizado.
• Permisos para crear Application Pool.
• Permisos para publicar la aplicación.
• Acceso a logs IIS y Event Viewer.
• Política de backup de base de datos.

SQL Server

Desarrollo local

La configuración local usa LocalDB:

Server=(localdb)\MSSQLLocalDB;Database=CentralFormsDb;Trusted_Connection=True;MultipleActiveResultSets=true

Servidor

En IIS se debe usar una instancia real de SQL Server:

.\SQLEXPRESS
localhost
SERVIDOR_SQL
SERVIDOR_SQL\INSTANCIA

Ejemplo de connection string para servidor:

Server=SERVIDOR_SQL;Database=CentralFormsDb;User Id=USUARIO_SQL;Password=PASSWORD_SQL;TrustServerCertificate=True;MultipleActiveResultSets=true

No usar LocalDB en IIS

LocalDB depende del usuario interactivo de Windows. Una aplicación publicada en IIS ejecuta bajo el Application Pool, por lo que debe usar SQL Server real.

Configuración de aplicación

Configuración	Local	Servidor
Ambiente	Development	Production
Connection string	LocalDB	SQL Server real
Swagger	Habilitado	Restringido o deshabilitado
Seed demo	Activo	Desactivado
Email	SMTP local / Mailpit	SMTP real
Secrets	Demo / local	Variables de entorno o mecanismo seguro

Secretos

No versionar passwords SMTP, API Keys, Admin Keys ni connection strings productivas con credenciales reales.

IIS

Configuración recomendada para publicación futura:

Elemento	Valor recomendado
Application Pool	CentralForms.Api
.NET CLR Version	No Managed Code
Managed Pipeline Mode	Integrated
Identity	ApplicationPoolIdentity
Physical Path	C:\inetpub\wwwroot\CentralForms.Api
HTTPS Binding	Obligatorio fuera de local

Scripts de base de datos

Ejecutar en orden para preparar un ambiente:

sql/deploy/00-create-database.sql
sql/deploy/01-create-schema.sql
sql/deploy/02-seed-demo.sql
sql/deploy/03-add-demo-destinations.sql
sql/deploy/04-verify-deploy.sql

Script opcional para pruebas desde Swagger en IIS local:

sql/deploy/05-add-localhost-iis-origins.sql

Seed demo

Los scripts demo son útiles para local, QA o demostraciones. En producción deben revisarse antes de ejecutarse.

Rutas relevantes

Ruta	Uso
CentralForms.Api/	Proyecto principal de API
CentralForms.Api/Properties/launchSettings.json	Perfiles locales
CentralForms.Api/wwwroot/sdk/	SDK JavaScript
CentralForms.Api/wwwroot/examples/	Ejemplos locales
CentralForms.Infrastructure/Migrations/	Migraciones EF Core
sql/deploy/	Scripts SQL
scripts/	Scripts de publicación y utilidades
publish/CentralForms.Api	Salida esperada de publicación
C:\inetpub\wwwroot\CentralForms.Api	Ruta sugerida en IIS

Servicios externos

Servicio	Uso	Estado
Mailpit	Captura SMTP local	Recomendado local
Mailtrap	Sandbox SMTP	Opcional QA
Resend / SMTP corporativo	Envío productivo	Pendiente
Webhook externo	Integración con CRM, ERP u otros sistemas	Según cliente
DNS / dominio	URL pública de API	Pendiente
Certificado SSL	HTTPS	Pendiente fuera de local

Seguridad de infraestructura

Área	Criterio
HTTPS	Obligatorio fuera de local
Swagger	No exponer públicamente en producción
SQL Server	Usar usuario con permisos mínimos necesarios
Secrets	Usar variables de entorno o mecanismo seguro
Firewall	Exponer solo puertos requeridos
Logs	No registrar secretos ni tokens completos
Webhooks	Validar URL, timeout y manejo de errores

Validación de ambiente

Antes de considerar un ambiente listo, validar:

Validación	Resultado esperado
API inicia	Sin errores de runtime
/health responde	Servicio disponible
SQL Server conecta	Lectura y escritura correctas
Swagger carga	Solo si está habilitado
SDK JS responde	Archivo disponible
SMTP funciona	Resultado visible en IntegrationLogs
Webhook funciona	Resultado visible en IntegrationLogs
HTTPS activo	Certificado válido
Logs disponibles	IIS, aplicación e integration logs accesibles

Pendientes

Pendiente	Prioridad
Definir servidor QA/Staging	Alta
Definir servidor producción	Alta
Definir dominio público de API	Alta
Configurar certificado SSL	Alta
Definir proveedor SMTP productivo	Alta
Definir política de backups	Alta
Definir retención de logs	Media
Definir monitoreo y alertas	Media