ProyectoFinal EV1 PIA

Proyecto Final EV1 PIA - Sistema de Gestión de Animes (Anime Manager)

Este proyecto implementa una arquitectura completa de software distribuido para la gestión de un catálogo de animes. El sistema integra múltiples interfaces de usuario (Consola, WPF, MAUI), una API RESTful centralizada, persistencia flexible (MySQL/Memoria) y capacidades de Inteligencia Artificial mediante el protocolo MCP (Model Context Protocol).

Contexto y Arquitectura

El sistema sigue una arquitectura por capas desacoplada, diseñada para maximizar la mantenibilidad y escalabilidad.

Backend (Backend.API)

• Tecnología: ASP.NET Core Web API (.NET 10).
• Controladores: Endpoints RESTful para gestión de datos, autenticación y chat IA.
• Seguridad: Implementación de JWT (JSON Web Tokens) para proteger endpoints.
• Persistencia (Open/Closed Principle):

- Sistema flexible que permite cambiar entre almacenamiento en Memoria (LINQ) y MySQL sin modificar el código cliente. - Implementación del patrón Repository. - Configuración inicial mediante appsettings.json (equivalente moderno a App.config).

• MCP & IA:

- Servidor MCP: Integrado en la API para exponer herramientas de datos (búsqueda, estadísticas, etc.). - Cliente MCP: Servicio de chat con doble enrutamiento: 1. Enrutador de Reglas: Procesa comandos predefinidos (saludos, ayuda) de forma inmediata. 2. Enrutador LLM: Utiliza un modelo de lenguaje (vía LM Studio) para interpretar consultas naturales y ejecutar herramientas sobre la BBDD.

Frontend

El proyecto cuenta con tres aplicaciones cliente que consumen la misma API:

1. Consola (Frontend.Console):

- Interfaz de línea de comandos (CLI). - Menú interactivo para CRUD y autenticación.

1. Escritorio WPF (Frontend.WPF):

- Gestión visual completa (Master/Detail). - Ventana de Chat dedicada con soporte para renderizado de respuestas.

1. Móvil/Escritorio MAUI (Frontend.MAUI):

- Aplicación multiplataforma moderna. - Navegación nativa y diseño adaptativo.

Guía de Instalación y Ejecución

Prerrequisitos

• .NET 10 SDK
• MySQL Server (opcional si se usa solo Memoria)
• LM Studio (para las funcionalidades de IA) cargando un modelo compatible (ej. Llama-3, Mistral) y corriendo el servidor local en puerto 1234.

Configuración

1. Navega a Backend.API/appsettings.json.
2. Configura la cadena de conexión MySqlConnection para tu base de datos MySQL (si aplica).
3. Verifica la configuración UseMySQL (true para MySQL / false para Memoria).

Creación de la Base de Datos (Requerido para modo MySQL)

IMPORTANTE: Si vas a usar el modo MySQL ("UseMySQL": true), debes crear la base de datos antes de iniciar la aplicación. De lo contrario, el sistema dará error al intentar conectarse.

Ejecuta el siguiente script en tu servidor MySQL:

-- Crear la base de datos
DROP DATABASE IF EXISTS AnimeDB;
CREATE DATABASE AnimeDB;
USE AnimeDB;

-- Tabla de Animes
CREATE TABLE Animes (
    MyAnimeListId INT PRIMARY KEY,
    Title VARCHAR(255),
    Description TEXT,
    ImageUrl VARCHAR(500),
    Type VARCHAR(50),
    Episodes DOUBLE,
    Status VARCHAR(100),
    Premiered VARCHAR(100),
    ReleasedYear DOUBLE,
    Genres VARCHAR(500),
    Studios VARCHAR(255),
    Score DOUBLE,
    Popularity INT
);

-- Tabla de Usuarios
CREATE TABLE Users (
    Id INT AUTO_INCREMENT PRIMARY KEY,
    Username VARCHAR(100) NOT NULL UNIQUE,
    Password VARCHAR(255) NOT NULL,
    Role VARCHAR(50) DEFAULT 'User'
);

-- Usuario Administrador (password: root)
INSERT INTO Users (Username, Password, Role) 
VALUES ('root', '4813494d137e1631bba301d5acab6e7bb7aa74ce1185d456565ef51d737677b2', 'Admin');

Ejecución

1. Iniciar Backend:

   cd Backend.API
   dotnet run

La API estará disponible en https://localhost:7123/swagger.

1. Iniciar Cliente (ej. WPF):

Abrir una nueva terminal:

   cd Frontend.WPF
   dotnet run

Tecnologías Usadas

• C# / .NET 10
• Entity Framework Core (ORM)
• JWT Bearer Authentication
• WPF (Windows Presentation Foundation)
• .NET MAUI (Multi-platform App UI)
• Newtonsoft.Json / System.Text.Json
• Http Client Factory
• MCP (Model Context Protocol): Implementación personalizada para conectar LLMs con datos estructurados.

Notas de Implementación

• La funcionalidad de IA requiere que LM Studio esté ejecutándose y aceptando peticiones en localhost:1234.
• El sistema de persistencia en Memoria es volátil y se reinicia con la aplicación.