← Portfolio El proyecto
Capítulo 09

Diseño

El stack, las decisiones de arquitectura, las clases y el despliegue del sistema.

9.1Stack tecnológico

BACK-END

TECNOLOGÍAVERSIÓNDESCRIPCIÓNMOTIVO
.Net (C#).Net 6Marco de desarrollo de código abierto, con tooling integrado de build y testing para proyectos web, mobile y API.Robustez Escalabilidad
ASP.Net.Net 6Favorece las buenas prácticas la monitorización y el testing, aportando numerosas herramientas, librerías y utilidades.Robustez Escalabilidad
Sql Server8.12.1Motor de base de datos de Microsoft, con integración directa con .NET y buen rendimiento en consultas complejas.Rendimiento

FRONT-END

TECNOLOGÍAVERSIÓNDESCRIPCIÓNMOTIVO
JavaScript, HTML, Css, BootstrapECMAScript 6Lenguaje del front-end; junto con HTML y CSS arma una interfaz dinámica y liviana.Ligero y Dinámico

9.2Librerías de frontend

Estas sí son parte del producto entregado; las herramientas que el equipo usó para construirlo (IDE, gestión de proyecto, testing) están en el capítulo de Gestión.

Bootstrap

Framework CSS y JavaScript para el desarrollo de interfaces web responsivas y atractivas.

AnyChart

Biblioteca de gráficos y visualizaciones.

CSS Progress Wizard

Componente de formulario con asistente.

Chart.js

Biblioteca de gráficos.

DataTables.js

Biblioteca de tablas HTML avanzadas.

9.3Arquitectura

El diseño sigue Domain-Driven Design (DDD), para que el modelo de código refleje el lenguaje del negocio de gestión de proyectos de arquitectura, sobre arquitectura limpia (hexagonal, de Robert C. Martin y Alistair Cockburn) que separa el código en las cuatro capas independientes de abajo.

En el front-end, ASP MVC entrega HTML estilizado con Bootstrap, y jQuery cubre la manipulación del DOM y las llamadas AJAX donde hace falta actualizar la página sin recargarla.

Las cuatro capas

1

Capa de dominio

Contiene las entidades y la lógica de negocio central de la aplicación.

Aquí se definen los objetos y las reglas que representan el problema que se está resolviendo.

Es el núcleo del sistema y no debe depender de ninguna otra capa.

2

Capa de negocios

Implementa la lógica de negocio, las validaciones y las reglas de la aplicación.

Coordina la interacción entre la capa de dominio y las demás capas.

Proporciona servicios y casos de uso que consume la capa de vistas.

3

Capa de infraestructura

Maneja la comunicación con servicios externos y el acceso a datos.

Combina Entity Framework, un ORM Code First, para las operaciones estándar, y Dapper para las consultas donde el rendimiento importa más que la abstracción.

La base de datos es SQL Server, elegida por su integración directa con .NET, su rendimiento y sus funcionalidades avanzadas de consulta con Transact-SQL.

4

Capa de vistas

Contiene la presentación de la interfaz de usuario.

Recibe las interacciones del usuario y las envía a la capa de negocios.

Recibe los datos de la capa de negocios y los muestra al usuario.

Principios SOLID aplicados

Responsabilidad única

Cada clase de dominio (Usuario, Cliente, Proyecto, Tarea) resuelve un solo motivo de cambio, sin mezclar reglas de negocio con acceso a datos.

Abierto/cerrado

Los servicios de negocio se extienden agregando nuevas implementaciones, por ejemplo un nuevo tipo de informe, sin modificar el código ya probado.

Sustitución de Liskov

Las clases del tipo Repository pueden intercambiarse sin alterar el comportamiento esperado por la capa de negocios que las consume.

Segregación de interfaces

Los ViewModels exponen a cada vista solo los datos que efectivamente necesita, en vez de forzarla a depender de una entidad de dominio completa.

Inversión de dependencias

Los Servicios Singleton y Transient se inyectan por interfaz, de modo que la capa de negocios no depende de una implementación concreta de infraestructura.

9.4Decisiones de arquitectura (ADR)

Las decisiones concretas que se desprenden de la arquitectura de arriba, antes de bajar a las clases que las ponen en práctica.

ADR-01

Arquitectura limpia por capas con Domain-Driven Design

Aceptado

Contexto

El dominio del estudio mezcla reglas de negocio concretas (tipologías, estados de proyecto, honorarios según el Colegio de Arquitectos) con una interfaz que dos tipos de usuario muy distintos van a consumir: el equipo interno y el cliente. Sin una separación clara, esas reglas terminan repetidas o mezcladas con el código de presentación.

Decisión

Adoptar Domain-Driven Design sobre una arquitectura limpia (hexagonal, de Robert C. Martin y Alistair Cockburn) de cuatro capas independientes: dominio, negocios, infraestructura y vistas, cada una descripta en la sección de Arquitectura de este capítulo.

Consecuencias

  • Las reglas de negocio quedan concentradas en la capa de dominio y de negocios, reutilizables tanto para las vistas del usuario interno como para el Portal del cliente.
  • El equipo necesita disciplina para no filtrar lógica de negocio hacia la capa de vistas, algo más exigente que escribir todo en los controladores.
  • La capa de infraestructura queda aislada, lo que habilitó después la decisión híbrida de acceso a datos (ver ADR-02).
ADR-02

ORM híbrido: Entity Framework (Code First) + Dapper

Aceptado

Contexto

El dominio a persistir es relativamente simple (Usuario, Cliente, Proyecto, Tarea, Cobro), pero varias pantallas (gráficos de avance, Gantt/PERT, reportes de cobros) dependen de consultas de lectura más pesadas, donde el mapeo objeto-relacional completo de un ORM agrega overhead sin aportar valor.

Decisión

Usar Entity Framework Code First para las operaciones CRUD estándar de la capa de infraestructura, y Dapper para las consultas de lectura donde el rendimiento importa más que la abstracción.

Consecuencias

  • Las consultas de reporting corren más rápido al evitar el tracking y la generación de SQL genérico de EF.
  • La capa de infraestructura mantiene dos formas de acceder a los datos, lo que exige disciplina para no duplicar lógica de mapeo entre ambas.
  • Dapper se usa solo para lectura, nunca para escritura: el modelo de dominio sigue centralizado en las entidades de EF, evitando inconsistencias.

9.5Diagrama de clases

El diagrama de clases modela cuatro clases de dominio principales: Usuario (con sus roles), Cliente, Proyecto y Estadísticas; esta última no persiste datos propios, sino que calcula agregados sobre las demás.

Proyecto es la clase con más relaciones: conecta con Cliente, Tipología, Servicio, Tarea y Cobro.

1 0..* tiene 1 0..* responsable de Usuario nombreapellidonúmero de usuarioDNIcorreo y teléfonorol Cliente nombreapellidonúmero de clienteDNIdirección Proyecto nombreclientetipologíaestadopresupuestousuario responsable Estadísticas No persiste datos propios: calcula agregados sobre Usuario, Cliente y Proyecto.
Clases principales del dominio, con sus atributos y las asociaciones documentadas en el Modelado.

9.6Paquetes del sistema

Esas mismas clases, agrupadas por el área del estudio a la que sirven en vez de por capa técnica:

En ArqStudio, los paquetes agrupan las clases por el área del estudio a la que sirven, no por capa técnica; cada paquete, a su vez, se apoya en las cuatro capas de arquitectura descritas más arriba.

ArqStudio 1. Cuentas 1.1 Usuario 1.2 Cliente 1.3 Roles y permisos 1.4 Direcciones 2. Operación deproyectos 2.1 Proyecto 2.2 Tipología 2.3 Servicio 2.4 Tarea 2.5 Hub (compromisosy adjuntos) 3. Administración 3.1 Presupuesto 3.2 Cobro 3.3 Estadísticas
Paquetes de ArqStudio, agrupados por área del estudio a la que sirven.

9.7Diagrama de despliegue

Estaciones dedesarrollo Router Switch HOSTING Servidor deaplicación Windows Server + IIS Servidor de basede datos SQL Server Backup
Infraestructura de despliegue: hosting, router, switch, servidores de BD/app y backup.

Con la arquitectura y el diseño ya definidos, el próximo capítulo cuenta cómo el equipo organizó el trabajo para construirlo: Metodología.