Aplicación de Gestión de Productos con .NET y Svelte

Este proyecto es un ejemplo educativo que muestra cómo crear una aplicación web completa utilizando .NET para el backend y Svelte para el frontend, implementando patrones de diseño modernos y buenas prácticas de desarrollo.

Descripción del Proyecto

La aplicación permite gestionar un catálogo de productos con operaciones CRUD (Crear, Leer, Actualizar, Eliminar) a través de diferentes interfaces:

API REST: Ofrece endpoints para manipular productos a través de HTTP
Backoffice (MVC): Interfaz administrativa basada en ASP.NET MVC
Frontoffice (Svelte): Interfaz de usuario moderna construida con SvelteKit

Arquitectura del Proyecto

El proyecto sigue una arquitectura en capas con los siguientes componentes:

- Products.sln                 # Solución principal
- Products.Common/             # DTOs, excepciones y tipos compartidos
- Products.Business/           # Lógica de negocio, servicios y repositorios
- Products.API/                # API REST
- Products.Backoffice/         # Aplicación MVC para administración
- Products.Frontoffice/        # Frontend con Svelte

Patrón de Arquitectura

Diseño por Capas: Separación clara de responsabilidades entre capas
Patrón Repositorio: Abstracción del acceso a datos
Inyección de Dependencias: Acoplamiento débil entre componentes
MVC (Model-View-Controller): Para la aplicación Backoffice
REST: Para la API de servicios

Tecnologías Utilizadas

Backend

.NET 9: Framework base para el desarrollo
ASP.NET Core: Para la API REST y aplicación MVC
Entity Framework Core: ORM para acceso a datos
AutoMapper: Para mapeo entre objetos de dominio y DTOs
Newtonsoft.Json: Para serialización/deserialización JSON
In-Memory Database: Para almacenamiento de datos (en este ejemplo educativo)

Frontend

SvelteKit: Framework para la creación de la interfaz de usuario
TypeScript: Para tipado estático en el frontend
Axios: Para comunicación HTTP con la API
Zod: Para validación de datos en el cliente

DevOps

Docker: Para contenerización de la aplicación
Fly.io: Ejemplo de despliegue en la nube

Patrones de Diseño Implementados

DTO (Data Transfer Objects): Para transferencia de datos entre capas
Repositorio: Para abstracción del acceso a datos
Servicios: Para encapsular la lógica de negocio
Middleware: Para manejo centralizado de excepciones
CORS: Configuración para permitir solicitudes cross-origin
Enumeraciones: Para tipos de datos con valores predefinidos (Colores)

Configuración del Entorno de Desarrollo

Requisitos Previos

.NET 9 SDK
Node.js (v20.x o superior)

Pasos para Ejecutar el Proyecto

Clonar el Repositorio:

git clone <url-del-repositorio>
cd Products

Restaurar Paquetes NuGet:
```
dotnet restore
```
Ejecutar la API REST:
```
dotnet run --project Products.API
```

La API estará disponible en: https://localhost:7234 (o http://localhost:5192)

Ejecutar la Aplicación Backoffice (MVC):

dotnet run --project Products.Backoffice

La aplicación MVC estará disponible en: https://localhost:7103

Ejecutar la Aplicación Frontoffice (Svelte):
```
cd Products.Frontoffice
npm install
npm run dev
```
La aplicación Svelte estará disponible en: http://localhost:5173

Estructura del Código

Products.Common

Contiene elementos compartidos:

Dtos/: Objetos de transferencia de datos
Types/: Enumeraciones y tipos personalizados
Exceptions/: Excepciones personalizadas

Products.Business

Contiene la lógica de negocio:

Domain/: Entidades de dominio
Service/: Servicios que implementan la lógica de negocio
Repository/: Acceso a datos
Persistence/: Contexto de Entity Framework
AutoMapperProfiles/: Configuración de mapeo entre entidades y DTOs

Products.API

API REST:

Controllers/: Endpoints de la API
Middlewares/: Configuración de middleware para manejo de excepciones

Products.Backoffice

Aplicación MVC:

Controllers/: Controladores MVC
Views/: Vistas Razor
Models/: ViewModels específicos para la UI

Products.Frontoffice

Aplicación Svelte:

src/routes/: Páginas y componentes
src/lib/: Utilidades, stores y lógica compartida
src/lib/api.ts: Cliente de la API REST

Aspectos Educativos del Proyecto

Este proyecto sirve como referencia para aprender sobre:

Arquitectura en Capas: Separación de responsabilidades
API REST: Principios y buenas prácticas
Inyección de Dependencias: Configuración y uso en .NET
Entity Framework Core: Configuración básica y seeds
Manejo de Excepciones: Middleware centralizado
Validación de Datos: Tanto en backend como frontend
Frontend Moderno: Integración con frameworks modernos (Svelte)
Serialización/Deserialización: Conversión entre objetos y JSON
Enumeraciones: Uso en C# y TypeScript
Patrones de Repositorio y Servicio: Implementación práctica

Despliegue

El proyecto incluye un Dockerfile para contenerización y puede ser desplegado en servicios como Fly.io:

fly deploy

Un ejemplo de despliegue está disponible en: https://tsi-products.fly.dev/

Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

Nota: Este proyecto es principalmente educativo y está diseñado para demostrar conceptos y patrones en un entorno simplificado. Algunas prácticas pueden necesitar ser adaptadas para aplicaciones de producción a gran escala.

README.md 5.8 KB Cronologia Originale