73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
# 🚛 SISTEMA DE GESTIÓN DE INVENTARIO Y ASIGNACIÓN DE VEHÍCULOS
|
||
|
||
Sistema web desarrollado en **Django** para la gestión integral de inventarios de vehículos administrativos y tácticos, asignación a unidades militares, control de historial y generación de reportes PDF.
|
||
|
||
---
|
||
|
||
## 📋 Tabla de Contenidos
|
||
|
||
- [📌 Características Principales](#-características-principales)
|
||
- [🗃️ 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)
|
||
- [📊 Dashboard Principal](#-dashboard-principal)
|
||
- [📋 CRUDs disponibles](#-cruds-disponibles)
|
||
- [🔄 Asignación de Vehículos](#-asignación-de-vehículos)
|
||
- [📄 Generación de Reportes PDF](#-generación-de-reportes-pdf)
|
||
- [🔒 Seguridad y Sesiones](#-seguridad-y-sesiones)
|
||
- [🛠️ Mantenimiento y Backup](#️-mantenimiento-y-backup)
|
||
- [💡 Posibles Mejoras](#-posibles-mejoras)
|
||
- [📁 Estructura del Proyecto](#-estructura-del-proyecto)
|
||
|
||
---
|
||
|
||
## 📌 Características Principales
|
||
|
||
- Gestión completa de inventarios (administrativo y táctico).
|
||
- CRUD de unidades, directores y grupos de trabajo (subjefes).
|
||
- Asignación temporal y definitiva de vehículos a unidades.
|
||
- Historial de asignaciones archivadas.
|
||
- Generación de reportes PDF con xhtml2pdf.
|
||
- Autenticación de usuarios y cierre de sesión automático por inactividad.
|
||
- Dashboard con contadores actualizados en tiempo real (AJAX).
|
||
- Interfaz responsive con Bootstrap.
|
||
|
||
---
|
||
|
||
## 🗃️ Modelos de Datos
|
||
|
||
| Modelo | Descripción |
|
||
|--------|-------------|
|
||
| `Directores` | Datos del director (grado, nombre, cargo) |
|
||
| `Subjefes` | Grupo de trabajo asociado a un director |
|
||
| `Unidades` | Unidades militares que reciben vehículos |
|
||
| `InventarioAdministrativo` | Vehículos administrativos |
|
||
| `InventarioTactico` | Vehículos tácticos |
|
||
| `AsignacionAdministrativa` | Asignación temporal de vehículos administrativos |
|
||
| `AsignadaUnidadAdministrativa` | Historial permanente de asignaciones administrativas |
|
||
| `AsignacionTactica` | Asignación temporal de vehículos tácticos |
|
||
| `AsignadaUnidadTactica` | Historial permanente de asignaciones tácticas |
|
||
|
||
---
|
||
|
||
## 📦 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)
|
||
- **SQLite** (incluido por defecto en Django) o **PostgreSQL/MySQL** (opcional)
|
||
|
||
---
|
||
|
||
## ⚙️ Instalación y Configuración
|
||
|
||
### 1. Clonar el repositorio
|
||
|
||
```bash
|
||
git clone https://git.ejercito.mil.ve/repo/tu-repositorio.git
|
||
cd nombre-del-proyecto |