Inventario IT 🖥️

Inventario IT es un sistema de gestión de inventario de hardware diseñado para ser poblado tanto por scripts automáticos como por gestión manual. Permite tener un registro centralizado y detallado de todos los equipos informáticos de una organización, sus componentes y su historial de cambios.

El sistema se compone de un backend RESTful API desarrollado en ASP.NET Core y un frontend interactivo de tipo SPA (Single Page Application) construido con React, TypeScript y Vite.

---

🚀 Funcionalidades Principales

El sistema está diseñado en torno a la gestión y visualización de activos de TI, con un fuerte énfasis en la calidad y consistencia de los datos.

📋 Módulo de Equipos

• Vista Principal Centralizada: Una tabla paginada, con capacidad de búsqueda y filtrado por sector, que muestra todos los equipos del inventario.
• Detalle Completo del Equipo: Al hacer clic en un equipo, se abre una vista detallada con toda su información:
  • Datos Principales: Hostname, IP, MAC, OS, etc.
  • Componentes Asociados: Lista detallada de discos, módulos de RAM, usuarios asociados,CPU, Motherboard, RAM instalada, etc.
  • Estado en Tiempo Real: Indicador visual que muestra si el equipo está En línea o Sin conexión mediante un ping.
  • Historial de Cambios: Un registro cronológico de todas las modificaciones realizadas en el equipo.
• Acciones Remotas:
  • Wake On Lan (WOL): 🚀 Botón para enviar un "Magic Packet" a través de un servidor SSH y encender un equipo de forma remota.

✍️ Gestión Manual vs. Automática

• Origen de Datos: El sistema diferencia entre datos generados por scripts automáticos (⚙️ Automático) y los introducidos manualmente (⌨️ Manual).
• Protección de Datos: Las entradas automáticas están protegidas contra modificaciones o eliminaciones desde la UI, asegurando la integridad de los datos recopilados en campo.
• CRUD Completo para Entradas Manuales:
  • Creación de nuevos equipos con sus propiedades básicas.
  • Edición de los campos principales de un equipo manual.
  • Asociación manual de componentes (Discos, RAM, Usuarios).
  • Eliminación segura de equipos y componentes de origen manual.

🗂️ Módulo de Administración

• Gestión de Sectores: Un CRUD completo para crear, editar y eliminar los sectores o departamentos de la organización.
• Limpieza de Datos Maestros: Una potente herramienta para asegurar la consistencia de los datos.
  • Visualización de Valores Únicos: Permite ver todos los valores distintos existentes para un tipo de componente (ej: Microsoft Windows 10 Pro, w10, Windows 10) y cuántos equipos usan cada uno.
  • Unificación de Valores: ✏️ Permite reemplazar todas las instancias de un valor incorrecto (ej: w10) por uno correcto (ej: Microsoft Windows 10 Pro) en toda la base de datos con un solo clic.
  • Eliminación de Registros Maestros: 🗑️ Permite eliminar componentes maestros (ej: un módulo de RAM) que ya no están en uso por ningún equipo.

🎨 UI/UX

• Interfaz Moderna y Responsiva: Construida con Vite, React y TypeScript para una experiencia rápida y fluida.
• Notificaciones en Tiempo Real: El sistema utiliza react-hot-toast para dar feedback instantáneo sobre el estado de las operaciones (Cargando, Éxito, Error).
• Consistencia de Datos Mejorada: Uso de campos de autocompletado que sugieren valores existentes para campos como CPU, OS y Motherboard, reduciendo errores humanos.
• Validación de Entradas: Validación de formato en tiempo real para campos críticos como la MAC Address, con auto-formateo para ayudar al usuario.

---

🛠️ Stack Tecnológico

Backend (backend/)

• Framework: ASP.NET Core 9
• Lenguaje: C#
• Acceso a Datos: Dapper (Micro ORM)
• Base de Datos: Microsoft SQL Server
• Comandos Remotos: Renci.SshNet para ejecución de comandos SSH (Wake On Lan)

Frontend (frontend/)

• Framework/Librería: React 19
• Lenguaje: TypeScript
• Gestión de Tabla: TanStack Table v8
• Notificaciones: React Hot Toast
• Tooltips: React Tooltip
• Build Tool: Vite

---

🚀 Puesta en Marcha (Getting Started)

Siga estos pasos para configurar y ejecutar el proyecto en un entorno de desarrollo local.

Prerrequisitos

• .NET SDK 9.0 o superior.
• Node.js v20.x o superior (con npm).
• Microsoft SQL Server (2019 o superior) y SQL Server Management Studio (SSMS).
• Un editor de código como Visual Studio Code.

1. Clonar el Repositorio

git clone <URL_DEL_REPOSITORIO_GITEA>
cd nombre-del-repositorio

2. Configuración de la Base de Datos

1. Abra SSMS y conecte a su instancia de SQL Server.
2. Cree una nueva base de datos llamada InventarioDB.
3. Ejecute el script dboInventarioDB.txt (ubicado en la raíz del proyecto o en la carpeta backend/) sobre la base de datos recién creada. Esto creará todas las tablas, relaciones y claves necesarias.

3. Configuración del Backend

1. Navegue al directorio del backend: cd backend.

2. Abra el archivo appsettings.json.

3. Modifique la ConnectionString para que apunte a su instancia de SQL Server, asegurándose de que el usuario (User Id y Password) tenga permisos sobre la base de datos InventarioDB.

   "ConnectionStrings": {
     "DefaultConnection": "Server=NOMBRE_SU_SERVIDOR;Database=InventarioDB;User Id=su_usuario_sql;Password=su_contraseña;TrustServerCertificate=True"
   }
   

4. En el mismo archivo, configure las credenciales del servidor SSH que se usará para la función Wake On Lan en la sección SshSettings.

   "SshSettings": {
     "Host": "",
     "Port": ,
     "User": "",
     "Password": ""
   }
   

5. Instale las dependencias y ejecute el backend:

   dotnet restore
   dotnet run
   

   La API estará disponible en http://localhost:5198 y la UI de Swagger en la misma URL.

4. Configuración del Frontend

1. En una nueva terminal, navegue al directorio del frontend: cd frontend.
2. Instale las dependencias:

   npm install
   

3. El frontend ya está configurado para apuntar a la URL del backend (http://localhost:5198) en el archivo SimpleTable.tsx. Si ha cambiado el puerto del backend, deberá actualizar esta constante BASE_URL.
4. Ejecute el frontend en modo de desarrollo:

   npm run dev
   

   La aplicación web estará disponible en http://localhost:5173 (o el puerto que indique Vite).

---