# 📦 SISTEMA DE GESTIÓN DE INVENTARIO Y ENVÍO DE ARTÍCULOS

Sistema web desarrollado en **Django** para la gestión integral de inventarios de artículos (carpas, equipos, etc.), control de stock, asignación a unidades militares y generación de reportes PDF con comprobantes de envío.

---

## 📋 Tabla de Contenidos

- [📌 Características Principales](#-características-principales)
- [🛠️ Stack Tecnológico](#️-stack-tecnológico)
- [🗃️ Modelos de Datos](#️-modelos-de-datos)
- [📦 Requisitos Previos](#-requisitos-previos)
- [⚙️ Instalación y Configuración](#️-instalación-y-configuración)
- [▶️ Ejecución del Servidor](#️-ejecución-del-servidor)
- [📖 Uso del Sistema](#-uso-del-sistema)
- [🔐 Autenticación](#-autenticación)
- [📊 Módulos del Sistema](#-módulos-del-sistema)
- [📄 Generación de Reportes PDF](#-generación-de-reportes-pdf)
- [🔄 Flujo de Trabajo](#-flujo-de-trabajo)
- [🔒 Seguridad](#-seguridad)
- [🛠️ Mantenimiento](#️-mantenimiento)
- [💡 Posibles Mejoras](#-posibles-mejoras)
- [📁 Estructura del Proyecto](#-estructura-del-proyecto)

---

## 📌 Características Principales

- ✅ Gestión completa de artículos (CRUD: Crear, Leer, Actualizar, Eliminar)
- ✅ Control de stock con actualización automática
- ✅ Gestión de unidades militares
- ✅ Envío de artículos a unidades con validación de stock
- ✅ Historial de movimientos por unidad
- ✅ Generación de comprobantes PDF de envío
- ✅ Reportes PDF por unidad con todos los artículos recibidos
- ✅ Autenticación de usuarios (login/logout)
- ✅ Interfaz responsive y amigable
- ✅ Eliminación masiva de comprobantes

---

## 🛠️ Stack Tecnológico

| Tecnología | Versión | Uso |
|------------|---------|-----|
| **Python** | 3.8+ | Lenguaje backend |
| **Django** | 5.0.4 | Framework web |
| **SQLite** | 3 | Base de datos (por defecto) |
| **xhtml2pdf** | Última | Generación de PDFs |
| **HTML5/CSS3** | - | Frontend |
| **Bootstrap** | 5 | Estilos y componentes |
| **Git** | - | Control de versiones |

---

## 🗃️ Modelos de Datos

| Modelo | Descripción | Campos principales |
|--------|-------------|-------------------|
| `Articulo` | Artículos del inventario | artículo, descripción, cantidad, fecha |
| `Unidad` | Unidades militares | nombreUnidad, comandante, ubicación, teléfono |
| `ArticuloUnidad` | Registro de envíos | movimiento, articulo, unidad, cantidad, fecha_salida |
| `PruebaUnidad` | Historial por unidad | movimiento, articulo, unidad, cantidad, fecha_salida |

### Relaciones
- `Unidad` ↔ `Articulo`: Relación ManyToMany a través de `ArticuloUnidad`
- `PruebaUnidad`: Historial independiente para reportes por unidad

---

## 📦 Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

- **Python** 3.8 o superior
- **pip** (gestor de paquetes de Python)
- **Git** (opcional, para clonar el repositorio)
- **Virtualenv** (recomendado)

---

## ⚙️ Instalación y Configuración

### 1. Clonar el repositorio

```bash
git clone https://git.ejercito.mil.ve/maom/ProyectoTransporte.git
cd ProyectoTransporte