Sistema de Gestión Bibliotecaria - BibliotecaForm

Un sistema completo de gestión bibliotecaria desarrollado en C# con Windows Forms, con interfaz MDI moderna y gestión avanzada de sesiones.

.NET Framework SQL Server Windows Forms License

BibliotecaForm es un sistema de gestión de bibliotecas robusto y fácil de usar, desarrollado en C# con Windows Forms. Ofrece una interfaz MDI moderna y funcionalidades completas para la administración de libros, usuarios y préstamos, ideal para pequeñas y medianas bibliotecas.

Este proyecto nació de la necesidad de contar con una herramienta eficiente y visualmente atractiva para la gestión bibliotecaria, enfocándose en la experiencia del usuario y la solidez funcional.

📋 Tabla de Contenidos

✨ Características Principales

📸 Capturas de Pantalla

Aquí algunas vistas de la aplicación:

Inicio de SesiónPanel de AdministradorCatálogo de Libros (Usuario)
Inicio de Sesión
Panel de Administrador
Catálogo de Libros
Vista de PréstamosRealizar un PréstamoCatálogo (Invitado)
Vista de Préstamos
Realizar un Préstamo
Catálogo Invitado

🛠️ Tecnologías Utilizadas

ComponenteTecnologíaVersiónCaracterísticas
LenguajeC#7.0+POO, Eventos, Delegates
Framework.NET Framework4.6.2 / 4.8WinForms, ADO.NET
Interfaz de UsuarioWindows Forms-MDI Interface, Timers, Custom Controls
Base de DatosMicrosoft SQL Server2019+Stored Procedures, Parámetros SQL
ORM/Acceso a DatosADO.NET-SqlConnection, SqlCommand, SqlDataAdapter
ArquitecturaMDI (Multiple Document Interface)-Navegación Fluida, Gestión de Sesiones
Gestión de EstadoSistema de Configuración Global-Persistencia de Sesiones, Cadenas Centralizadas
IDE RecomendadoVisual Studio2019+IntelliSense, Designer, Debugging

💻 Requisitos del Sistema

Requisitos Mínimos

Requisitos de Desarrollo

🚀 Instalación y Configuración

1. Clonar el Repositorio

POWERSHELL 
git clone https://github.com/J0SE-ESC0BAR/BibliotecaForms.git 
cd BibliotecaFrom

2. Configurar Base de Datos

  1. Abre SQL Server Management Studio (SSMS).

  2. Conéctate a tu instancia de SQL Server.

  3. Ejecuta los siguientes scripts SQL en el orden indicado. Puedes encontrarlos en la carpeta SQL QUERYS BibliotecaForm/:

    • Creacion de BibliotecaFrom.sql (para crear la base de datos y las tablas).
    • Datos de las tablas BibliotecaForm.sql (para poblar las tablas con datos iniciales).
    • Procedimientos Almacenado BibliotecaFrom.sql (para crear los procedimientos almacenados necesarios).

    Ejemplo de cómo ejecutar un script en SSMS:

    • Abre el archivo .sql con SSMS (Archivo > Abrir > Archivo).
    • Asegúrate de que la base de datos correcta esté seleccionada en el desplegable de bases de datos disponibles (debería ser BibliotecaFrom después de ejecutar el primer script, o master para el primer script).
    • Haz clic en el botón “Ejecutar” (o presiona F5).

3. Configurar Cadena de Conexión

Edita el archivo Program.cs (aproximadamente en la línea 14) para apuntar a tu servidor de SQL Server.

Modifica la variable CadenaConexion dentro de la clase Configuracion:

CSHARP 
public static class Configuracion
{
    // Ejemplo: Si SQL Server está en la misma máquina y usas autenticación de Windows:
    public static string CadenaConexion = "Server=NOMBRE_DE_TU_SERVIDOR;Database=BibliotecaFrom;Trusted_Connection=True;";
    // Ejemplo: Si SQL Server Express está en la misma máquina:
    // public static string CadenaConexion = "Server=.\\SQLEXPRESS;Database=BibliotecaFrom;Trusted_Connection=True;";
    
    // Sistema de gestión de sesiones globales
    public static int IdUsuarioActual = 0;
    public static int IdAdministradorActual = 0;
}

Nota: Reemplaza NOMBRE_DE_TU_SERVIDOR con el nombre de tu instancia de SQL Server. Si usas SQL Server Express, comúnmente es .\\SQLEXPRESS o (localdb)\\MSSQLLocalDB.

4. Compilar y Ejecutar

  1. Abre el archivo BibliotecaFrom.sln con Visual Studio.
  2. Asegúrate de que el proyecto BibliotecaFrom esté configurado como proyecto de inicio.
  3. Presiona Ctrl + F5 o haz clic en el botón “Iniciar” (el triángulo verde) para compilar y ejecutar la aplicación.

Alternativamente, desde la línea de comandos (PowerShell o CMD) en la raíz del proyecto:

POWERSHELL 
msbuild BibliotecaFrom.sln /t:Rebuild /p:Configuration=Release
# Luego puedes encontrar el ejecutable en: bin\\Release\\BibliotecaFrom.exe
# o para Debug:
msbuild BibliotecaFrom.sln /t:Rebuild /p:Configuration=Debug
# Luego puedes encontrar el ejecutable en: bin\\Debug\\BibliotecaFrom.exe

🏗️ Arquitectura del Sistema

BibliotecaForm implementa una arquitectura MDI (Multiple Document Interface) moderna con gestión avanzada de sesiones y navegación fluida para garantizar la separación de responsabilidades y facilitar el mantenimiento:

Diagrama de Flujo de la Aplicación

    graph TD
    A[🚀 Inicio de la Aplicación] --> B{🏠 FrmMenuPrincipal MDI}
    B -- 👤 Usuario --> C{🔍 Sesión Activa?}
    B -- 👨‍💼 Administrador --> D{🔍 Sesión Admin Activa?}
    B -- "👁️ Libros (Visitante)" --> E["📖 FrmLibros (Modo Visitante)"]
    
    C -- "✅ Sí" --> F["📚 FrmLibros (Modo Usuario)"]
    C -- "❌ No" --> G[🔑 FrmUsuario]
    D -- "✅ Sí" --> H[⚙️ FrmAdministrarBiblioteca]
    D -- "❌ No" --> I[🔐 FrmAdministrador]
    
    G -- "✅ Login Exitoso" --> J[💾 Guardar Sesión] --> F
    G -- "📝 Registrarse" --> K[📋 FrmRegistrarse]
    I -- "✅ Login Admin" --> L[💾 Guardar Sesión Admin] --> H
    I -- "📝 Registrarse" --> K
    
    F -- "📤 Prestar Libro" --> M[📋 FrmPrestar]
    F -- "📊 Ver Préstamos" --> N[📜 FrmVerprestamos]
    H -- "➕ Agregar Libro" --> O[📚 FrmAgregarLibro]
    H -- "👥 Ver Usuarios" --> P["👤 Panel Usuarios con Selección"]
    H -- "📖 Ver Libros" --> Q["📚 Panel Libros con Gestión"]
    H -- "📋 Ver Préstamos" --> R["📊 Panel Préstamos con Estados"]
    
    M -- "🎫 Ticket Generado" --> F
    N -- "🔴 Alertas Vencimiento" --> F
    P -- "🗑️ Eliminar (Click-to-Select)" --> H
    Q -- "🗑️ Eliminar con Validación" --> H
    R -- "🗑️ Gestión con Códigos Color" --> H
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style H fill:#fff3e0
    style F fill:#e8f5e8
    style J fill:#c8e6c9
    style L fill:#c8e6c9

Arquitectura de Capas con Gestión de Estado

    graph TB
    subgraph "🎨 Capa de Presentación MDI"
        MDI[Contenedor MDI Principal]
        MenuLateral[Menú Lateral Expandible]
        Forms[Formularios Hijos Sin Bordes]
        Timers[Timers de Animación]
    end
    
    subgraph "🔄 Capa de Gestión de Estado"
        ConfigGlobal[Configuración Global]
        SesionUsuario[Gestión de Sesiones]
        NavegacionMDI[Navegación MDI]
    end
    
    subgraph "⚡ Capa de Lógica de Negocio"
        Auth[Autenticación Avanzada]
        Validation[Validaciones con Alertas]
        Business[Reglas de Negocio]
        FormateoUI[Formateo DataGridView]
    end
    
    subgraph "💾 Capa de Acceso a Datos"
        ADO[ADO.NET con Parámetros]
        Stored[Procedimientos Almacenados]
        ConexionGlobal[Cadena Conexión Centralizada]
    end
    
    subgraph "🗄️ Capa de Datos"
        SQLServer[(SQL Server)]
    end
    
    MDI --> ConfigGlobal
    MenuLateral --> SesionUsuario
    Forms --> NavegacionMDI
    Timers --> MenuLateral
    
    ConfigGlobal --> Auth
    SesionUsuario --> Validation
    NavegacionMDI --> Business
    FormateoUI --> Forms
    
    Auth --> ConexionGlobal
    Validation --> ADO
    Business --> Stored
    ConexionGlobal --> SQLServer
    ADO --> SQLServer
    Stored --> SQLServer

🔧 Módulos y Funcionalidades

🏠 1. Menú Principal MDI (FrmMenuPrincipal)

Centro de control con interfaz MDI moderna

Menú Principal

Características Principales:

Funcionalidades Avanzadas:

CSHARP 
// Gestión automática de sesiones
private void btnUsuario_Click(object sender, EventArgs e)
{
    if (Configuracion.IdUsuarioActual > 0)
    {
        // Sesión activa - ir directamente al catálogo
        FrmLibros libros = new FrmLibros(Configuracion.IdUsuarioActual);
        AbrirFormulario(libros);
    }
    else
    {
        // Sin sesión - mostrar login
        FrmUsuario usuario = new FrmUsuario();
        AbrirFormulario(usuario);
    }
}

// Animación del menú lateral
private void BtnCambiarTamanoMenu_Click(object sender, EventArgs e)
{
    if (panelMenu.Width > 60)
    {
        timerCerrar.Start(); // Colapsar menú
        // Ocultar texto, solo iconos
        btnUsuario.Text = "";
        btnLibros.Text = "";
    }
    else
    {
        timerAbrir.Start(); // Expandir menú
        // Restaurar texto completo
        btnUsuario.Text = "Usuario";
        btnLibros.Text = "Libros";
    }
}

🔑 2. Autenticación de Usuario con Gestión de Sesiones (FrmUsuario)

Sistema de login avanzado para usuarios regulares

Login Usuario

Funcionalidades Mejoradas:

Flujo de Autenticación Mejorado:

CSHARP 
private void btnIngresar_Click(object sender, EventArgs e)
{
    string consulta = "SELECT ID_Usuario FROM Usuario WHERE usuario = @usuario AND Contraseña = @contraseña";
    
    using (SqlConnection conexion = new SqlConnection(cadenaConexion))
    {
        SqlCommand comando = new SqlCommand(consulta, conexion);
        comando.Parameters.AddWithValue("@usuario", txtUsuario.Text);
        comando.Parameters.AddWithValue("@contraseña", txtContraseña.Text);
        
        object resultado = comando.ExecuteScalar();
        if (resultado != null)
        {
            int idUsuario = (int)resultado;
            // Guardar sesión globalmente
            Configuracion.IdUsuarioActual = idUsuario;
            
            // Navegación MDI
            FrmLibros libros = new FrmLibros(idUsuario);
            FrmMenuPrincipal principal = this.MdiParent as FrmMenuPrincipal;
            principal?.AbrirFormulario(libros);
        }
    }
}

🔐 3. Autenticación de Administrador con Sesión Persistente (FrmAdministrador)

Acceso privilegiado con gestión avanzada de sesiones

Login Admin

Características Especiales:

Autenticación de Administrador:

CSHARP 
private void btnIngresar_Click(object sender, EventArgs e)
{
    string consulta = "SELECT COUNT(*) FROM Usuario WHERE usuario = @usuario AND Contraseña = @contraseña AND Administrador = 1";
    
    using (SqlConnection conexion = new SqlConnection(Configuracion.CadenaConexion))
    {
        SqlCommand comando = new SqlCommand(consulta, conexion);
        comando.Parameters.AddWithValue("@usuario", txtUsuario.Text);
        comando.Parameters.AddWithValue("@contraseña", txtContraseña.Text);
        
        int cantidad = (int)comando.ExecuteScalar();
        if (cantidad > 0)
        {
            // Guardar sesión de administrador
            Configuracion.IdAdministradorActual = 1; // Marcar sesión activa
            
            // Abrir panel de administración
            FrmAdministrarBiblioteca adm = new FrmAdministrarBiblioteca();
            FrmMenuPrincipal principal = this.MdiParent as FrmMenuPrincipal;
            principal?.AbrirFormulario(adm);
        }
    }
}

📝 4. Registro de Usuario (FrmRegistrarse)

Sistema de registro con validaciones

Registro Usuario

Campos del Formulario:

CampoTipoRequeridoValidación
Nombre CompletoText✅Mínimo 3 caracteres
DirecciónText✅-
TeléfonoText✅Formato numérico
CorreoEmail✅Formato email válido
UsuarioText✅Único en BD
ContraseñaPassword✅Mínimo 6 caracteres
Es AdministradorCheckbox❌Código secreto requerido

Funcionalidades:

📚 5. Catálogo de Libros Mejorado (FrmLibros)

Núcleo del sistema con interfaz profesional

Catálogo de Libros

Modos de Funcionamiento Avanzados:

👁️ Modo Visitante

👤 Modo Usuario Autenticado

Mejoras de Interfaz:

Configuración Visual Avanzada:

CSHARP 
private void ConfigurarDataGridView()
{
    // Estilo profesional
    dgvMostrar.BorderStyle = BorderStyle.None;
    dgvMostrar.AlternatingRowsDefaultCellStyle.BackColor = Color.FromArgb(238, 239, 249);
    dgvMostrar.DefaultCellStyle.SelectionBackColor = Color.FromArgb(35, 56, 205);
    dgvMostrar.DefaultCellStyle.SelectionForeColor = Color.WhiteSmoke;
    
    // Header estilizado
    dgvMostrar.ColumnHeadersDefaultCellStyle.BackColor = Color.FromArgb(18, 26, 54);
    dgvMostrar.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
    dgvMostrar.ColumnHeadersDefaultCellStyle.Font = new Font("Arial Rounded MT Bold", 10);
    
    // Configuración de columnas optimizada
    if (dgvMostrar.Columns.Contains("tituloLibro"))
    {
        dgvMostrar.Columns["tituloLibro"].HeaderText = "Libro";
        dgvMostrar.Columns["tituloLibro"].FillWeight = 25;
    }
}

// Formateo con código de colores para disponibilidad
private void dgvMostrar_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
{
    if (dgvMostrar.Columns[e.ColumnIndex].Name == "disponible" && e.Value != null)
    {
        bool disponible = Convert.ToBoolean(e.Value);
        if (disponible)
        {
            e.CellStyle.ForeColor = Color.Green;
            e.CellStyle.Font = new Font(e.CellStyle.Font, FontStyle.Bold);
            e.Value = "Sí";
        }
        else
        {
            e.CellStyle.ForeColor = Color.Red;
            e.CellStyle.Font = new Font(e.CellStyle.Font, FontStyle.Bold);
            e.Value = "No";
        }
    }
}

📋 6. Gestión de Préstamos (FrmPrestar)

Sistema inteligente de tickets para gestión de préstamos

Préstamos

Funcionalidades Avanzadas:

Flujo de Préstamo Mejorado:

  1. 📖 Selección Inteligente: Libro seleccionado desde el catálogo con validación automática
  2. 👤 Usuario Automático: Identificación del usuario logueado desde sesión global
  3. 📅 Configuración de Fechas: Fecha de préstamo automática y devolución calculada
  4. 🔍 Validaciones Múltiples: Verificación de disponibilidad, usuario activo y límites
  5. 💾 Registro Completo: Guardado en tabla Prestamo con transacciones seguras
  6. 🎫 Ticket Generado: Comprobante único con código de seguimiento
  7. 🔄 Actualización Automática: Refresh del catálogo con nuevo estado de disponibilidad

Validaciones Avanzadas:

Implementación del Sistema de Tickets:

CSHARP 
private void btnPrestar_Click(object sender, EventArgs e)
{
    try
    {
        // Validación de disponibilidad en tiempo real
        string consultaDisponibilidad = "SELECT COUNT(*) FROM Prestamo WHERE ID_Libro = @idLibro AND fecha_devolucion >= GETDATE()";
        
        // Registro del préstamo con transacción
        string insertPrestamo = "INSERT INTO Prestamo (ID_Usuario, ID_Libro, fecha_prestamo, fecha_devolucion) VALUES (@idUsuario, @idLibro, @fechaPrestamo, @fechaDevolucion)";
        
        using (SqlConnection conexion = new SqlConnection(Configuracion.CadenaConexion))
        {
            conexion.Open();
            using (SqlTransaction transaccion = conexion.BeginTransaction())
            {
                // Ejecutar préstamo con validaciones
                SqlCommand comando = new SqlCommand(insertPrestamo, conexion, transaccion);
                comando.Parameters.AddWithValue("@idUsuario", Configuracion.IdUsuarioActual);
                comando.Parameters.AddWithValue("@idLibro", idLibroSeleccionado);
                comando.Parameters.AddWithValue("@fechaPrestamo", DateTime.Now);
                comando.Parameters.AddWithValue("@fechaDevolucion", dtpDevolucion.Value);
                
                int resultado = comando.ExecuteNonQuery();
                if (resultado > 0)
                {
                    transaccion.Commit();
                    // Generar ticket único
                    GenerarTicketPrestamo();
                    MessageBox.Show("✅ Préstamo registrado exitosamente. Ticket generado.", "Préstamo Exitoso");
                }
            }
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"❌ Error al procesar préstamo: {ex.Message}", "Error");
    }
}

📜 7. Historial de Préstamos (FrmVerprestamos)

Panel avanzado de préstamos con alertas de vencimiento

Historial de Préstamos

Funcionalidades Mejoradas:

Información Detallada Mostrada:

Acciones Avanzadas Disponibles:

Sistema de Alertas Visuales:

CSHARP 
private void dgvPrestamos_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
{
    if (dgvPrestamos.Columns[e.ColumnIndex].Name == "fecha_devolucion" && e.Value != null)
    {
        DateTime fechaDevolucion = Convert.ToDateTime(e.Value);
        DateTime hoy = DateTime.Now.Date;
        TimeSpan diferencia = fechaDevolucion.Date - hoy;
        
        // Sistema de códigos de colores
        if (diferencia.Days < 0)
        {
            // Vencido - Rojo
            e.CellStyle.BackColor = Color.FromArgb(255, 235, 235);
            e.CellStyle.ForeColor = Color.DarkRed;
            e.CellStyle.Font = new Font(e.CellStyle.Font, FontStyle.Bold);
        }
        else if (diferencia.Days <= 2)
        {
            // Próximo a vencer - Amarillo
            e.CellStyle.BackColor = Color.FromArgb(255, 248, 220);
            e.CellStyle.ForeColor = Color.DarkOrange;
            e.CellStyle.Font = new Font(e.CellStyle.Font, FontStyle.Bold);
        }
        else
        {
            // Vigente - Verde
            e.CellStyle.BackColor = Color.FromArgb(235, 255, 235);
            e.CellStyle.ForeColor = Color.DarkGreen;
        }
        
        // Formato de fecha legible
        e.Value = fechaDevolucion.ToString("dd/MM/yyyy");
        e.FormattingApplied = true;
    }
}

Consulta Optimizada con JOIN:

CSHARP 
string consulta = @"
    SELECT 
        p.ID_Prestamo,
        p.ID_Libro,
        l.tituloLibro,
        l.autor,
        l.año_publicacion,
        p.fecha_prestamo,
        p.fecha_devolucion,
        CASE 
            WHEN p.fecha_devolucion < GETDATE() THEN 'Vencido'
            WHEN DATEDIFF(day, GETDATE(), p.fecha_devolucion) <= 2 THEN 'Próximo a Vencer'
            ELSE 'Vigente'
        END AS Estado
    FROM Prestamo p
    INNER JOIN Libro l ON p.ID_Libro = l.id_libro
    WHERE p.ID_Usuario = @idUsuario
    ORDER BY p.fecha_devolucion ASC";

⚙️ 8. Panel de Administración (FrmAdministrarBiblioteca)

Centro de control administrativo con selección automática y gestión contextual

Panel de Administración

Funcionalidades Globales del Panel:

Pestañas de Gestión Avanzada:

👥 Gestión de Usuarios con Selección Inteligente

CSHARP 
// Selección automática en DataGridView de usuarios
private void dgvUsuarios_CellClick(object sender, DataGridViewCellEventArgs e)
{
    if (e.RowIndex >= 0)
    {
        DataGridViewRow fila = dgvUsuarios.Rows[e.RowIndex];
        idUsuarioSeleccionado = Convert.ToInt32(fila.Cells["ID_Usuario"].Value);
        
        // Activar botón de eliminación
        btnEliminarUsuario.Enabled = true;
        btnEliminarUsuario.Text = $"Eliminar Usuario (ID: {idUsuarioSeleccionado})";
        
        // Mostrar información detallada
        lblUsuarioSeleccionado.Text = $"Seleccionado: {fila.Cells["nombreCompleto"].Value}";
    }
}

📚 Gestión de Libros con Control de Inventario

CSHARP 
// Validación antes de eliminar libro
private void btnEliminarLibro_Click(object sender, EventArgs e)
{
    if (idLibroSeleccionado > 0)
    {
        // Verificar préstamos activos
        string consultaValidacion = "SELECT COUNT(*) FROM Prestamo WHERE ID_Libro = @idLibro AND fecha_devolucion >= GETDATE()";
        
        using (SqlConnection conexion = new SqlConnection(Configuracion.CadenaConexion))
        {
            SqlCommand comando = new SqlCommand(consultaValidacion, conexion);
            comando.Parameters.AddWithValue("@idLibro", idLibroSeleccionado);
            
            int prestamosActivos = (int)comando.ExecuteScalar();
            
            if (prestamosActivos > 0)
            {
                MessageBox.Show($"❌ No se puede eliminar. El libro tiene {prestamosActivos} préstamo(s) activo(s).", 
                              "Validación", MessageBoxButtons.OK, MessageBoxIcon.Warning);
                return;
            }
            
            // Proceder con eliminación si está libre
            EliminarLibroSeguro();
        }
    }
}

📊 Gestión de Préstamos con Estados Avanzados

Sistema de Estados Visuales:

CSHARP 
private void ConfigurarDataGridViewPrestamos()
{
    // Estilo profesional para préstamos
    dgvPrestamos.BorderStyle = BorderStyle.None;
    dgvPrestamos.AlternatingRowsDefaultCellStyle.BackColor = Color.FromArgb(240, 248, 255);
    
    // Formateo de fechas con estados
    dgvPrestamos.CellFormatting += (sender, e) =>
    {
        if (e.ColumnIndex == dgvPrestamos.Columns["fecha_devolucion"].Index && e.Value != null)
        {
            DateTime fechaDevolucion = Convert.ToDateTime(e.Value);
            DateTime hoy = DateTime.Now.Date;
            
            if (fechaDevolucion < hoy)
            {
                // Vencido - Fondo rojo
                e.CellStyle.BackColor = Color.FromArgb(255, 230, 230);
                e.CellStyle.ForeColor = Color.DarkRed;
            }
            else if ((fechaDevolucion - hoy).Days <= 3)
            {
                // Próximo a vencer - Fondo amarillo
                e.CellStyle.BackColor = Color.FromArgb(255, 255, 200);
                e.CellStyle.ForeColor = Color.DarkOrange;
            }
        }
    };
}

Consulta Integrada para Panel Administrativo:

CSHARP 
string consultaCompleta = @"
    SELECT 
        p.ID_Prestamo,
        u.nombreCompleto AS Usuario,
        l.tituloLibro AS Libro,
        l.autor AS Autor,
        p.fecha_prestamo,
        p.fecha_devolucion,
        CASE 
            WHEN p.fecha_devolucion < GETDATE() THEN 'Vencido'
            WHEN DATEDIFF(day, GETDATE(), p.fecha_devolucion) <= 3 THEN 'Por Vencer'
            ELSE 'Vigente'
        END AS Estado,
        DATEDIFF(day, GETDATE(), p.fecha_devolucion) AS DiasRestantes
    FROM Prestamo p
    INNER JOIN Usuario u ON p.ID_Usuario = u.ID_Usuario
    INNER JOIN Libro l ON p.ID_Libro = l.id_libro
    ORDER BY p.fecha_devolucion ASC";

➕ 9. Agregar Libro (FrmAgregarLibro)

Expansión del catálogo

Agregar Libro

Formulario de Libro:

CampoTipoDescripción
📖 TítuloTextBoxNombre del libro
✍️ AutorTextBoxAutor(es) del libro
📅 AñoNumericUpDownAño de publicación
📄 ContenidoRichTextBoxDescripción/resumen

Validaciones:

🗄️ Base de Datos

Diagrama Entidad-Relación (ERD)

    erDiagram
    Usuario {
        int ID_Usuario PK "Identificador único del usuario"
        varchar nombreCompleto "Nombre completo del usuario"
        varchar direccion "Dirección del usuario"
        varchar telefono "Número de teléfono"
        varchar Correo "Correo electrónico"
        varchar usuario "Nombre de usuario único"
        varchar Contraseña "Contraseña encriptada"
        int Administrador "Flag: 1=Admin, 0=Usuario"
    }

    Libro {
        int id_libro PK "Identificador único del libro"
        varchar tituloLibro "Título del libro"
        varchar autor "Autor(es) del libro"
        varchar año_publicacion "Año de publicación"
        text contenido "Descripción o resumen"
    }

    Prestamo {
        int ID_Prestamo PK "Identificador único del préstamo"
        int ID_Usuario FK "Referencia al usuario"
        int ID_Libro FK "Referencia al libro"
        date fecha_prestamo "Fecha de inicio del préstamo"
        date fecha_devolucion "Fecha límite de devolución"
    }

    Usuario ||--o{ Prestamo : "realiza"
    Libro ||--o{ Prestamo : "es_prestado_en"

Scripts de Base de Datos

El proyecto incluye scripts SQL organizados en la carpeta SQL QUERYS BibliotecaForm/:

ScriptPropósitoOrden de Ejecución
Creacion de BibliotecaFrom.sql🏗️ Estructura de BD1️⃣
Datos de las tablas BibliotecaForm.sql📊 Datos iniciales2️⃣
Procedimientos Almacenado BibliotecaFrom.sql⚙️ Stored Procedures3️⃣

Estructura Detallada de Tablas

👤 Tabla Usuario

SQL 
CREATE TABLE Usuario (
    ID_Usuario int IDENTITY(1,1) PRIMARY KEY,
    nombreCompleto varchar(100) NOT NULL,
    direccion varchar(200) NOT NULL,
    telefono varchar(20) NOT NULL,
    Correo varchar(100) NOT NULL UNIQUE,
    usuario varchar(50) NOT NULL UNIQUE,
    Contraseña varchar(100) NOT NULL,
    Administrador int DEFAULT 0 CHECK (Administrador IN (0,1))
);

📚 Tabla Libro

SQL 
CREATE TABLE Libro (
    id_libro int IDENTITY(1,1) PRIMARY KEY,
    tituloLibro varchar(200) NOT NULL,
    autor varchar(100) NOT NULL,
    año_publicacion varchar(4) NOT NULL,
    contenido text
);

📋 Tabla Prestamo

SQL 
CREATE TABLE Prestamo (
    ID_Prestamo int IDENTITY(1,1) PRIMARY KEY,
    ID_Usuario int NOT NULL,
    ID_Libro int NOT NULL,
    fecha_prestamo date NOT NULL DEFAULT GETDATE(),
    fecha_devolucion date NOT NULL,
    FOREIGN KEY (ID_Usuario) REFERENCES Usuario(ID_Usuario),
    FOREIGN KEY (ID_Libro) REFERENCES Libro(id_libro),
    CHECK (fecha_devolucion > fecha_prestamo)
);

Configuración de Conexión

La cadena de conexión se configura en Program.cs:

CSHARP 
public static class Configuracion
{
    // Configuración para SQL Server local
    public static string CadenaConexion = "Server=localhost\\SERVERDEV;Database=BibliotecaFrom;Trusted_Connection=True;";
    
    // Alternativas de configuración:
    // SQL Server Express LocalDB
    // "Server=(localdb)\\MSSQLLocalDB;Database=BibliotecaFrom;Trusted_Connection=True;"
    
    // SQL Server con autenticación
    // "Server=servidor;Database=BibliotecaFrom;User Id=usuario;Password=contraseña;"
}

📁 Estructura del Proyecto

Estructura Principal

TEXT 
BibliotecaFrom/
├── 📄 BibliotecaFrom.sln          # Archivo de solución de Visual Studio
├── 📄 BibliotecaFrom.csproj       # Archivo de proyecto C#
├── 📄 App.config                  # Configuración de la aplicación
├── 📄 Program.cs                  # Punto de entrada de la aplicación
├── 📄 README.md                   # Documentación del proyecto
│
├── 🖼️ Formularios Windows Forms/
│   ├── FrmMenuPrincipal.*         # Menú principal de la aplicación
│   ├── FrmUsuario.*               # Autenticación de usuarios
│   ├── FrmAdministrador.*         # Autenticación de administradores
│   ├── FrmRegistrarse.*           # Registro de nuevos usuarios
│   ├── FrmLibros.*                # Catálogo y gestión de libros
│   ├── FrmPrestar.*               # Sistema de préstamos
│   ├── FrmVerprestamos.*          # Historial de préstamos del usuario
│   ├── FrmAdministrarBiblioteca.* # Panel de administración
│   └── FrmAgregarLibro.*          # Formulario para agregar libros
│
├── 🗄️ SQL QUERYS BibliotecaForm/
│   ├── Creacion de BibliotecaFrom.sql           # Script de creación de BD
│   ├── Datos de las tablas BibliotecaForm.sql   # Datos iniciales
│   └── Procedimientos Almacenado BibliotecaFrom.sql # Stored Procedures
│
├── 🎨 Resources/                   # Recursos gráficos
│   ├── 1BNS.png                   # Logo principal
│   ├── admin_person_user_man_2839.png
│   ├── agregar libros.jpg
│   ├── prestamos.jpg
│   ├── regis.png
│   └── registrarse.jpg
│
└── ⚙️ Properties/                  # Propiedades del proyecto
    ├── AssemblyInfo.cs            # Información del ensamblado
    ├── Resources.Designer.cs      # Recursos embebidos
    ├── Resources.resx
    ├── Settings.Designer.cs       # Configuraciones
    └── Settings.settings

Descripción de Archivos Clave

Archivo/CarpetaDescripción
Program.csPunto de entrada: Configuración inicial y lanzamiento de la aplicación
Frm*.csFormularios: Lógica de negocio de cada ventana
Frm*.Designer.csDiseño UI: Código generado automáticamente para la interfaz
Frm*.resxRecursos: Imágenes, textos y configuraciones específicas del formulario
SQL QUERYS BibliotecaForm/Scripts de BD: Todos los scripts necesarios para configurar la base de datos
Resources/Recursos Gráficos: Imágenes e iconos utilizados en la interfaz
App.configConfiguración: Cadenas de conexión y configuraciones de la aplicación

🚀 Uso de la Aplicación

👁️ Modo Visitante (Sin registro)

  1. Ejecutar la aplicación → BibliotecaFrom.exe
  2. Seleccionar → Ver Libros
  3. Explorar el catálogo completo de libros disponibles
  4. Visualizar información detallada de cada libro

👤 Modo Usuario Regular

📝 Registro de Nuevo Usuario

  1. Menú Principal → Usuario → Registrarse
  2. Completar formulario:
    • Nombre completo
    • Dirección
    • Teléfono
    • Correo electrónico
    • Nombre de usuario (único)
    • Contraseña (mínimo 6 caracteres)
  3. Confirmar registro

🔑 Iniciar Sesión

  1. Menú Principal → Usuario
  2. Ingresar credenciales (usuario y contraseña)
  3. Acceder al catálogo con funcionalidades completas

📚 Gestionar Préstamos

  1. Seleccionar libro del catálogo
  2. Solicitar préstamo → Prestar Libro
  3. Configurar fechas de préstamo y devolución
  4. Confirmar préstamo y recibir ticket
  5. Ver préstamos activos → Ver Préstamos
  6. Cancelar préstamo si es necesario

👨‍💼 Modo Administrador

🔐 Acceso Administrativo

  1. Menú Principal → Administrador
  2. Ingresar credenciales de administrador
  3. Acceder al panel de administración

⚙️ Panel de Administración

➕ Agregar Nuevo Libro

  1. Panel de Admin → Agregar Libro
  2. Completar información:
    • Título del libro
    • Autor(es)
    • Año de publicación
    • Descripción/contenido
  3. Validar y guardar en el catálogo

🛠️ Guía de Desarrollo

Configuración del Entorno

Prerrequisitos

Configuración Inicial

  1. Clonar repositorio:

    POWERSHELL 
    git clone <repository-url>
cd BibliotecaFrom

  2. Configurar Base de Datos:

    SQL 
    -- En SSMS, ejecutar en orden:
-- 1. SQL QUERYS BibliotecaForm\Creacion de BibliotecaFrom.sql
-- 2. SQL QUERYS BibliotecaForm\Datos de las tablas BibliotecaForm.sql
-- 3. SQL QUERYS BibliotecaForm\Procedimientos Almacenado BibliotecaFrom.sql

  3. Configurar cadena de conexión en Program.cs:

    CSHARP 
    public static string CadenaConexion = "Server=TU_SERVIDOR;Database=BibliotecaFrom;Trusted_Connection=True;";

  4. Compilar y ejecutar:

    POWERSHELL 
    # Desde Visual Studio: F5 o Ctrl+F5
# O desde línea de comandos:
dotnet build
dotnet run

Arquitectura de Código

Patrón de Diseño

El proyecto sigue una arquitectura de capas simple pero efectiva:

    graph TB
    subgraph "🎨 Presentación (UI Layer)"
        Forms["Windows Forms<br/>- FrmMenuPrincipal<br/>- FrmUsuario<br/>- FrmAdministrador<br/>- etc."]
    end
    
    subgraph "⚡ Lógica de Negocio (Business Layer)"
        Validation["Validaciones<br/>- Autenticación<br/>- Reglas de Préstamo<br/>- Validación de Datos"]
        Business["Procesos de Negocio<br/>- Gestión de Préstamos<br/>- Control de Usuarios<br/>- Gestión de Catálogo"]
    end
    
    subgraph "💾 Acceso a Datos (Data Layer)"
        DataAccess["ADO.NET<br/>- SqlConnection<br/>- SqlCommand<br/>- SqlDataAdapter"]
        StoredProcs["Stored Procedures<br/>- Consultas Optimizadas<br/>- Operaciones CRUD"]
    end
    
    subgraph "🗄️ Base de Datos (Data Storage)"
        Database["SQL Server<br/>- Tabla Usuario<br/>- Tabla Libro<br/>- Tabla Prestamo"]
    end
    
    Forms --> Validation
    Forms --> Business
    Validation --> DataAccess
    Business --> DataAccess
    DataAccess --> StoredProcs
    StoredProcs --> Database
    DataAccess --> Database

Convenciones de Código

Extensión del Sistema

Agregar Nuevo Formulario

  1. Crear formulario: Right-click proyecto → Add → Windows Form
  2. Diseñar interfaz usando el Designer de Visual Studio
  3. Implementar lógica en el archivo .cs
  4. Conectar navegación desde otros formularios

Agregar Nueva Funcionalidad de BD

  1. Modificar esquema de base de datos si es necesario
  2. Crear/Modificar stored procedures
  3. Actualizar capa de acceso a datos
  4. Implementar lógica de negocio
  5. Crear/Modificar formularios UI

🤝 Contribución

Las contribuciones son bienvenidas. Si deseas mejorar este proyecto:

  1. Haz un Fork del repositorio.
  2. Crea una nueva rama (git checkout -b feature/nueva-funcionalidad).
  3. Realiza tus cambios y haz commit (git commit -am 'Añadir nueva funcionalidad').
  4. Sube tus cambios a la rama (git push origin feature/nueva-funcionalidad).
  5. Abre un Pull Request.

📜 Licencia

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

🧑‍💻 Autor

Desarrollado con ❤️ por J0SE-ESC0BAR.

Puedes encontrarme en: