first commit

README.md

@@ -0,0 +1,44 @@
+# 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.