ProyectoParte/README.md
2026-08-19 14:51:41 -04:00

4.5 KiB

Sistema de Parte Numérico - Gestión Militar

Título

Sistema de Parte Numérico

Descripción

El Sistema de Parte Numérico es una aplicación web diseñada específicamente para llevar el control, registro y seguimiento diario del estatus del personal en organizaciones con estructura jerárquica militar. Su objetivo principal es automatizar el proceso administrativo del tradicional "Pase de Lista", permitiendo una gestión centralizada y precisa del estado de fuerza de la unidad.

La plataforma facilita la clasificación del talento humano agrupándolos por su respectiva categoría (Oficiales Generales, Oficiales Superiores, Oficiales Subalternos y Tropa Profesional). Además, permite registrar de manera dinámica diversas situaciones o estatus (Disponible, Reposo, P.D.S.C., F.T.C., Permisos, Comisiones, etc.), llevando un control riguroso de las fechas de salida y de presentación esperada para aquellos profesionales que se encuentran de falta.

Stack Tecnológico

Este proyecto está construido con un stack tecnológico moderno, robusto y liviano, ideal para despliegues rápidos y alto rendimiento sin la carga de frameworks pesados:

Backend (Servidor y Lógica de Negocio):

  • Python 3: Lenguaje principal de la lógica del servidor, permitiendo un código limpio y eficiente.
  • Flask (v3.0+): Micro-framework web utilizado para construir y exponer la API REST, servir las plantillas fundamentales y gestionar las rutas de la aplicación de manera sencilla.
  • SQLite3: Motor de base de datos relacional ligero, implementado directamente para el almacenamiento local. Se inicializa en modo WAL (Write-Ahead Logging) para garantizar altos flujos de concurrencia de lectura y escritura.

Frontend (Interfaz de Usuario):

  • HTML5 & CSS3: Estructuración semántica de la información y la vista.
  • JavaScript (Vanilla): Manejo de la interactividad en el navegador, control del modal CRUD, alertas y consumo mediante peticiones fetch hacia la API REST.
  • Tailwind CSS (Vía CDN): Framework de utilidades centrado en clases CSS para aplicar un diseño atractivo, adaptable a dispositivos móviles e impecable, garantizando una excelente experiencia de usuario (UX/UI).

Librerías y Recursos Adicionales:

  • SheetJS (xlsx): Biblioteca especializada encargada de convertir listados y exportarlos en limpio al formato estándar de Microsoft Excel del lado del cliente, y para procesar las cargas masivas desde hojas de cálculo.

Biografía y Alcance

Este proyecto es producto del análisis, desarrollo e ingeniería en busca de soluciones digitales prácticas para resolver problemas cotidianos de la administración militar. Diseñado para simplificar el flujo de trabajo de la Sección de Personal o Ayudantía, esta herramienta reemplaza antiguos y tediosos apuntes manuales para integrarlos en una plataforma que consolida automáticamente las cifras y da un estatus real para la toma de decisiones por parte de la cadena de mando.

(Nota: Puedes adaptar este segmento resaltando tu experiencia y visión si se requiere en mayor profundidad).

Utilidad

El Sistema de Parte Numérico aporta soluciones directas en el día a día operativo:

  • Optimización del Tiempo: Reduce drásticamente las horas-hombre empleadas en consolidar listados, verificar personal y calcular sumatorias manuales gracias a su Panel de Control (Dashboard) en tiempo real.
  • Transparencia y Precisión: Evita la duplicidad de registros o las discrepancias en el cálculo de "Disponibles vs. Faltas"; el sistema provee totalizaciones automatizadas y agrupadas por categorías.
  • Trazabilidad Inmediata de "Faltas": Otorga la plena seguridad de saber rápidamente la justificación detrás de la ausencia del personal (vacaciones, permiso, reposo, comisión, etc.), indicando cuándo iniciaron su ausencia y cuándo corresponde la incorporación a la unidad.
  • Eficiencia en la Carga de Datos: Incorpora un mecanismo de importación de datos masivos; un archivo de Excel es todo lo que se necesita para comenzar a operar el sistema con todo el personal inscrito de una sola vez.
  • Reportes Institucionales al Instante: Permite exportar informes al instante tanto en PDF (para presentación formal o impresión veloz) como en Excel (para análisis e integración de hojas de cálculo de personal).
  • Organización Garantizada: El "Pase de Lista" permanece estrictamente ordenado mediante el sistema de antigüedad (jerarquía, grados, y orden de listado) haciendo fácil localizar cualquier miembro del personal.