88 lines
3.1 KiB
Markdown
88 lines
3.1 KiB
Markdown
# 📦 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 |