📦 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
- 🛠️ Stack Tecnológico
- 🗃️ Modelos de Datos
- 📦 Requisitos Previos
- ⚙️ Instalación y Configuración
- ▶️ Ejecución del Servidor
- 📖 Uso del Sistema
- 🔐 Autenticación
- 📊 Módulos del Sistema
- 📄 Generación de Reportes PDF
- 🔄 Flujo de Trabajo
- 🔒 Seguridad
- 🛠️ Mantenimiento
- 💡 Posibles Mejoras
- 📁 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 deArticuloUnidadPruebaUnidad: 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
git clone https://git.ejercito.mil.ve/maom/ProyectoTransporte.git
cd ProyectoTransporte