Documentación Técnica
API Banco Sol
Guía técnica de despliegue, arquitectura y configuración
del Backend desarrollado en .NET 8
Ver Swagger
1. Arquitectura General
El sistema está compuesto por dos servicios principales ejecutándose dentro del mismo
servidor virtual (VPS), ambos encapsulados en contenedores Docker:
- API Backend desarrollada en .NET 8
- Base de Datos PostgreSQL
Ambos servicios se comunican entre sí mediante una red Docker privada,
garantizando seguridad, aislamiento y comunicación directa.
2. Infraestructura
- Servidor: VPS Linux
- Contenedorización: Docker
- Backend: ASP.NET Core (.NET 8)
- Base de Datos: PostgreSQL
- ORM: Entity Framework Core
- Migraciones: Entity Framework Core Migrations
3. Red Docker
[ API (.NET 8) ] ---- Docker Network ---- [ PostgreSQL ]
4. Configuración de la Base de Datos
Host=postgres-db;
Port=5432;
Database=bancosol_db;
Username=postgres;
Password=********;
5. Configuración de la API
- Cadena de conexión por variables de entorno
- Sin credenciales hardcodeadas
- Uso de hostname del contenedor
6. Manejo de Configuración
- Variables de entorno
- appsettings.{Environment}.json
- appsettings.json
7. Migraciones de Base de Datos
Las migraciones garantizan la alineación total entre el modelo y la base de datos.
8. Flujo de Despliegue
- Build de imagen Docker
- Inicio de PostgreSQL
- Creación de red Docker
- Levantamiento de servicios
- Ejecución de migraciones
- API disponible
9. Seguridad
- DB no expuesta
- Red privada Docker
- Separación de responsabilidades
Conclusión
La arquitectura es segura, reproducible y alineada a buenas prácticas modernas.