Merge pull request #53 from iJosueeh/dev

Dev

Author: iJosueeh

IDEA.md

@@ -0,0 +1,15 @@
+**Project Name:** MediTrack
+**Description:** A specialized Inventory Management System designed for Health Clinics (Postas de Salud). It ensures the constant availability of critical medical supplies, optimizes batch traceability, and facilitates decision-making through a high-fidelity visual interface.
+
+**Tech Stack Context:** 
+- Core & UI: Java 21 (LTS) with JavaFX 21.
+- UI Framework: AtlantaFX (Primer Theme) for a modern, Fluent/Minimalist design, utilizing Ikonli for iconography.
+- Database: SQL Server running in a Docker Container.
+- Build & Testing: Maven, JUnit 5 for logic/integration testing, and GitHub Actions for CI.
+
+**Core Domain Rules & Constraints:**
+- Inventory Algorithm: All dispensing logic MUST strictly implement the FEFO (First Expire, First Out) algorithm to ensure efficient batch usage.
+- Data Integrity: Inventory movements (Inputs, Outputs, Attentions) must be handled via strict ACID transactions.
+- Traceability: The system must enforce sequential, descriptive identifiers per venue (e.g., CAT-001, PAC-001-000001).
+- Security: Access must be strictly controlled via Role-Based Access Control (RBAC) with dynamic management of venue managers.
+- Integration: Patient clinical records and attention history must be deeply integrated into the dispensing flow, not treated as an isolated module.

README.md

@@ -1,95 +1,64 @@
 <h1 align="center">🏥 MediTrack</h1>
 <p align="center">
-  <strong>Sistema Especializado de Gestión de Inventario para Postas de Salud</strong>
+  <em>Sistema de Gestión de Inventario para Postas de Salud</em>
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Java-21-orange?style=for-the-badge&logo=openjdk" alt="Java">
-  <img src="https://img.shields.io/badge/JavaFX-21-blue?style=for-the-badge" alt="JavaFX">
-  <img src="https://img.shields.io/badge/Maven-Build-green?style=for-the-badge&logo=apache-maven" alt="Maven">
-  <img src="https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-brightgreen?style=for-the-badge&logo=github-actions" alt="CI/CD">
+  <img src="https://img.shields.io/badge/Java-21-orange?style=flat-square&logo=openjdk" alt="Java">
+  <img src="https://img.shields.io/badge/JavaFX-21-blue?style=flat-square" alt="JavaFX">
+  <img src="https://img.shields.io/badge/AtlantaFX-Primer-6C63FF?style=flat-square" alt="AtlantaFX">
+  <img src="https://img.shields.io/badge/SQL%20Server-CC2927?style=flat-square&logo=microsoft-sql-server&logoColor=white" alt="SQL Server">
+  <img src="https://img.shields.io/badge/Maven-3.9-C71A36?style=flat-square&logo=apache-maven&logoColor=white" alt="Maven">
 </p>
 
 ---
 
-### 📝 Descripción
-**MediTrack** es una solución robusta diseñada específicamente para la administración eficiente de recursos médicos en **Postas de Salud**. Su objetivo es garantizar la disponibilidad constante de suministros críticos, optimizar la trazabilidad de lotes y facilitar la toma de decisiones mediante una interfaz intuitiva de alta fidelidad visual.
+## 📝 Descripción
 
----
-
-### ✨ Características Destacadas
-
-| Característica | Detalle |
-| :--- | :--- |
-| **📦 Catálogo de Productos** | Registro completo de medicamentos con códigos DIGEMID, categorías y unidades de medida. |
-| **🧪 Dispensación Inteligente** | Algoritmo **FEFO** (First Expire, First Out) automático para asegurar el uso eficiente de lotes. |
-| **💊 Transacciones ACID** | Motor de movimientos de inventario (Entradas/Salidas/Atenciones) con integridad total de datos. |
-| **👥 Gestión de Pacientes** | Registro clínico y consulta de historial de atenciones integrado en el flujo de dispensación. |
-| **🆔 IDs Secuenciales** | Sistema de identificadores legibles y descriptivos por sede (`CAT-001`, `PAC-001-000001`). |
-| **🛡️ Seguridad & Usuarios** | Control de acceso basado en roles (RBAC) con identificación dinámica de jefaturas. |
-| **📊 Dashboard Dinámico** | Métricas en tiempo real de salud de inventario, stock crítico y actividad diaria. |
-| **🏢 Gestión de Sedes** | Control centralizado de múltiples postas médicas y sus responsables. |
-| **🖥️ Interfaz Moderna** | Experiencia de usuario optimizada con *AtlantaFX* (Primer Theme) y soporte completo para **UTF-8**. |
+MediTrack administra recursos médicos en postas de salud. Garantiza disponibilidad de suministros, trazabilidad de lotes y toma de decisiones mediante una interfaz de escritorio moderna.
 
----
-
-### 🛠️ Stack Tecnológico
+## 🛠️ Stack
 
-- **Core:** Java 21 (LTS)
-- **UI:** JavaFX 21 + **AtlantaFX** (Fluent/Minimalist Design)
-- **Iconos:** Ikonli (FontAwesome 5 Packs)
-- **Database:** SQL Server (Docker Container)
-- **Testing:** JUnit 5 (Pruebas de Integración y Lógica)
-- **Build & CI:** Maven + GitHub Actions
+- ☕ **Core:** Java 21 (Eclipse Adoptium)
+- 🎨 **UI:** JavaFX 21 + AtlantaFX (Primer Theme)
+- 🎯 **Iconos:** Ikonli (FontAwesome 5)
+- 🗄️ **Base de datos:** SQL Server (Docker)
+- 🔨 **Build:** Maven + GitHub Actions
 
----
+## 🚀 Inicio Rápido
 
-### 🚀 Guía de Inicio Rápido
-
-#### Requisitos
-- [JDK 21+](https://adoptium.net/)
-- [Maven 3.8+](https://maven.apache.org/download.cgi)
-- [Docker & Docker Compose](https://www.docker.com/)
-
-#### Configuración de la Base de Datos (Docker)
-Este proyecto utiliza SQL Server en un contenedor Docker para facilitar el desarrollo.
+**Requisitos:** JDK 21+, Maven 3.8+, Docker
 
 ```bash
-# 1. Crear archivo .env a partir del template (ya realizado por el asistente)
-# cp .env.template .env
-
-# 2. Iniciar el contenedor de la base de datos
+# 1. Levantar SQL Server
 docker-compose up -d
-```
-*Nota: El primer inicio ejecuta automáticamente `meditrack_init.sql` que crea las tablas, agrega columnas faltantes (si actualiza desde una versión anterior) y carga los datos iniciales. Espere unos 45 segundos antes de ejecutar la aplicación.*
-
-*Para actualizar una base de datos existente, simplemente reinicie el contenedor con `docker-compose down && docker-compose up -d` - el script detectará y agregará automáticamente las columnas/tablas faltantes.*
 
-#### Instalación y Ejecución
-```bash
-# 1. Compilar el proyecto
+# 2. Compilar y ejecutar
 ./mvnw clean compile
-
-# 2. Ejecutar la aplicación
 ./mvnw javafx:run
 ```
 
-#### Ejecución de Pruebas
-```bash
-./mvnw test
-```
+> 💡 En Windows usar `mvnw.cmd`. El primer inicio tarda ~45s en inicializar la BD.
 
----
+## 📂 Estructura
 
-### 📂 Documentación Técnica
-Para una inmersión profunda en el desarrollo, consulta nuestras guías:
+```
+src/main/java/.../meditrackapp/
+├── 📦 application/        # Casos de uso
+├── ⚙️  core/               # Config y utilidades
+├── 🧩 domain/             # Entidades y lógica de negocio
+├── 📋 features/           # Módulos (auth, inventory, patients, users...)
+├── 🔌 infrastructure/     # Persistencia JDBC
+└── 🧩 shared/             # Sidebar, navbar, componentes comunes
+```
+
+## 📖 Documentación
 
-*   📘 [**Arquitectura**](./docs/ARCHITECTURE.md): Estructura de paquetes, estrategia de IDs y transaccionalidad.
-*   📋 [**Requerimientos Funcionales**](./docs/FUNCTIONAL_REQUIREMENTS.md): Estado actual de implementación de los módulos.
-*   🎨 [**Guía de Diseño**](./docs/UI_GUIDE.md): Paleta de colores y componentes UI.
-*   🧪 [**Testing y CI**](./docs/TESTING_CI.md): Estrategia de pruebas y automatización.
+- 📘 [Arquitectura](./docs/ARCHITECTURE.md)
+- 📋 [Requerimientos Funcionales](./docs/FUNCTIONAL_REQUIREMENTS.md)
+- 🎨 [Guía de Diseño UI](./docs/UI_GUIDE.md)
+- 🧪 [Testing y CI](./docs/TESTING_CI.md)
 
 ---
-<p align="center">
-  Diseñado con 💙 para la mejora de la Salud Pública | 2026
-</p>
+
+<p align="center"><sub>© 2026 MediTrack — Diseñado con 💙 para la Salud Pública</sub></p>

docker-compose.yml

@@ -12,6 +12,7 @@ services:
       - DB_NAME=${DB_NAME}
       - DB_USER=${DB_USER}
       - DB_PASSWORD=${DB_PASSWORD}
+      - TZ=America/Lima
     command: >
       /bin/bash -c "
         /opt/mssql/bin/sqlservr &

src/main/java/com/utp/meditrackapp/core/util/DateTimeProvider.java

@@ -0,0 +1,15 @@
+package com.utp.meditrackapp.core.util;
+
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+
+public final class DateTimeProvider {
+
+    private static final ZoneId LIMA_ZONE = ZoneId.of("America/Lima");
+
+    private DateTimeProvider() {}
+
+    public static LocalDateTime now() {
+        return LocalDateTime.now(LIMA_ZONE);
+    }
+}

src/main/java/com/utp/meditrackapp/domain/entities/Sede.java

@@ -1,5 +1,7 @@
 package com.utp.meditrackapp.domain.entities;
 
+import com.utp.meditrackapp.core.util.DateTimeProvider;
+
 import java.time.LocalDateTime;
 
 /**
@@ -65,7 +67,7 @@ public void toggleEstado() {
     public void bloquear(String motivo) {
         this.isBloqueada = 1;
         this.motivoBloqueo = motivo;
-        this.fechaBloqueo = LocalDateTime.now();
+        this.fechaBloqueo = DateTimeProvider.now();
     }
 
     /**

src/main/java/com/utp/meditrackapp/features/attentions/ui/AtencionController.java

@@ -292,6 +292,11 @@ protected void onBuscarAtenciones() {
                 showAlert(Alert.AlertType.INFORMATION, "Sin resultados", "No se encontraron pacientes con: " + query);
                 return;
             }
+            if (pacientes.size() >= 5) {
+                showAlert(Alert.AlertType.INFORMATION, "Búsqueda limitada",
+                    "Se mostraron las primeras 5 coincidencias para \"" + query + "\".\n"
+                    + "Sea más específico (use DNI o nombre completo) para refinar.");
+            }
             if (pacientes.size() == 1) {
                 cargarAtencionesPaciente(pacientes.get(0));
             } else {
@@ -312,8 +317,11 @@ private Paciente mostrarSelectorPaciente(List<Paciente> pacientes) {
             .collect(Collectors.toList());
         ChoiceDialog<String> dialog = new ChoiceDialog<>(opciones.get(0), opciones);
         dialog.setTitle("Seleccionar Paciente");
-        dialog.setHeaderText("Se encontraron múltiples pacientes:");
-        dialog.setContentText("Seleccione:");
+        String hint = pacientes.size() >= 5
+            ? "Se encontraron múltiples pacientes (máx. 5 coincidencias mostradas)."
+            : "Se encontraron " + pacientes.size() + " pacientes:";
+        dialog.setHeaderText(hint);
+        dialog.setContentText("Seleccione uno:");
         dialog.initModality(javafx.stage.Modality.APPLICATION_MODAL);
         dialog.initOwner(rootPane.getScene().getWindow());
         Optional<String> result = dialog.showAndWait();
@@ -507,6 +515,11 @@ protected void onBuscarPacienteDisp() {
                 showAlert(Alert.AlertType.INFORMATION, "Sin resultados", "No se encontraron pacientes con: " + query);
                 return;
             }
+            if (pacientes.size() >= 5) {
+                showAlert(Alert.AlertType.INFORMATION, "Búsqueda limitada",
+                    "Se mostraron las primeras 5 coincidencias para \"" + query + "\".\n"
+                    + "Sea más específico (use DNI o nombre completo) para refinar.");
+            }
             if (pacientes.size() == 1) {
                 selectPacienteDisp(pacientes.get(0));
             } else {

src/main/java/com/utp/meditrackapp/features/users/ui/UsuarioController.java

@@ -443,6 +443,8 @@ private void setupActionsColumn() {
                 btnDelete.setMinWidth(26);
                 btnDelete.setMaxWidth(26);
                 btnDelete.setOnAction(e -> handleDeleteUser(getTableView().getItems().get(getIndex())));
+
+                box.getStyleClass().add("actions-cell");
             }
 
             @Override

src/main/java/com/utp/meditrackapp/infrastructure/persistence/jdbc/JdbcAtencionRepository.java

@@ -2,6 +2,7 @@
 
 import com.utp.meditrackapp.core.config.DatabaseConfig;
 import com.utp.meditrackapp.core.models.enums.EntidadPrefix;
+import com.utp.meditrackapp.core.util.DateTimeProvider;
 import com.utp.meditrackapp.core.util.IdGenerator;
 import com.utp.meditrackapp.core.validation.SedeAccessValidator;
 import com.utp.meditrackapp.domain.entities.Atencion;
@@ -31,14 +32,15 @@ public Atencion save(Connection conn, Atencion atencion) {
                 atencion.setId(IdGenerator.generateSedeDependentId(conn, "atenciones", EntidadPrefix.ATENCION, atencion.getSedeId(), 6));
             }
 
-            String sql = "INSERT INTO atenciones (id, sede_id, paciente_id, usuario_id, numero_receta, medico, fecha_atencion) VALUES (?, ?, ?, ?, ?, ?, GETDATE())";
+            String sql = "INSERT INTO atenciones (id, sede_id, paciente_id, usuario_id, numero_receta, medico, fecha_atencion) VALUES (?, ?, ?, ?, ?, ?, ?)";
             try (PreparedStatement ps = conn.prepareStatement(sql)) {
                 ps.setString(1, atencion.getId());
                 ps.setString(2, atencion.getSedeId());
                 ps.setString(3, atencion.getPacienteId());
                 ps.setString(4, atencion.getUsuarioId());
                 ps.setString(5, atencion.getNumeroReceta());
                 ps.setString(6, atencion.getMedico());
+                ps.setTimestamp(7, Timestamp.valueOf(DateTimeProvider.now()));
                 ps.executeUpdate();
             }
         } catch (SQLException e) {

src/main/java/com/utp/meditrackapp/infrastructure/persistence/jdbc/JdbcDashboardRepository.java

@@ -1,6 +1,7 @@
 package com.utp.meditrackapp.infrastructure.persistence.jdbc;
 
 import com.utp.meditrackapp.core.config.DatabaseConfig;
+import com.utp.meditrackapp.core.util.DateTimeProvider;
 import com.utp.meditrackapp.core.validation.SedeAccessValidator;
 import com.utp.meditrackapp.domain.ports.out.DashboardRepository;
 
@@ -56,7 +57,7 @@ public int getLotesPorVencerCount(int dias) {
         String sedeId = SedeAccessValidator.getSedeParaConsulta();
 
         StringBuilder sql = new StringBuilder(
-            "SELECT COUNT(*) as total FROM lotes WHERE fecha_vencimiento <= DATEADD(day, ?, GETDATE()) AND fecha_vencimiento >= GETDATE()"
+            "SELECT COUNT(*) as total FROM lotes WHERE fecha_vencimiento <= DATEADD(day, ?, ?) AND fecha_vencimiento >= ?"
         );
 
         if (sedeId != null) {
@@ -65,8 +66,11 @@ public int getLotesPorVencerCount(int dias) {
 
         try (Connection conn = dbConfig.getConnection();
              PreparedStatement ps = conn.prepareStatement(sql.toString())) {
+            java.sql.Timestamp now = Timestamp.valueOf(DateTimeProvider.now());
             int i = 1;
             ps.setInt(i++, dias);
+            ps.setTimestamp(i++, now);
+            ps.setTimestamp(i++, now);
             if (sedeId != null) {
                 ps.setString(i++, sedeId);
             }
@@ -140,7 +144,7 @@ public int getVolumenMovimientos(int dias) {
         String sedeId = SedeAccessValidator.getSedeParaConsulta();
 
         StringBuilder sql = new StringBuilder(
-            "SELECT COUNT(*) as total FROM movimientos WHERE fecha_registro >= DATEADD(day, -?, GETDATE())"
+            "SELECT COUNT(*) as total FROM movimientos WHERE fecha_registro >= DATEADD(day, -?, ?)"
         );
 
         if (sedeId != null) {
@@ -151,6 +155,7 @@ public int getVolumenMovimientos(int dias) {
              PreparedStatement ps = conn.prepareStatement(sql.toString())) {
             int i = 1;
             ps.setInt(i++, dias);
+            ps.setTimestamp(i++, Timestamp.valueOf(DateTimeProvider.now()));
             if (sedeId != null) {
                 ps.setString(i++, sedeId);
             }
@@ -173,7 +178,7 @@ public List<Map<String, Object>> getTendenciaInventario(int meses) {
             "  SUM(CASE WHEN m.tipo_id = 'MOV-T-01' THEN m.cantidad ELSE 0 END) - " +
             "  SUM(CASE WHEN m.tipo_id = 'MOV-T-02' THEN m.cantidad ELSE 0 END) as total " +
             "FROM movimientos m " +
-            "WHERE m.fecha_registro >= DATEADD(month, -?, GETDATE()) "
+            "WHERE m.fecha_registro >= DATEADD(month, -?, ?) "
         );
 
         if (sedeId != null) {
@@ -186,6 +191,7 @@ public List<Map<String, Object>> getTendenciaInventario(int meses) {
              PreparedStatement ps = conn.prepareStatement(sql.toString())) {
             int i = 1;
             ps.setInt(i++, meses);
+            ps.setTimestamp(i++, Timestamp.valueOf(DateTimeProvider.now()));
             if (sedeId != null) {
                 ps.setString(i++, sedeId);
             }

src/main/java/com/utp/meditrackapp/infrastructure/persistence/jdbc/JdbcMovimientoRepository.java

@@ -2,6 +2,7 @@
 
 import com.utp.meditrackapp.core.config.DatabaseConfig;
 import com.utp.meditrackapp.core.models.enums.EntidadPrefix;
+import com.utp.meditrackapp.core.util.DateTimeProvider;
 import com.utp.meditrackapp.core.util.IdGenerator;
 import com.utp.meditrackapp.core.validation.SedeAccessValidator;
 import com.utp.meditrackapp.domain.entities.Movimiento;
@@ -31,7 +32,7 @@ public Movimiento save(Connection conn, Movimiento movimiento) {
             }
 
             String sql = "INSERT INTO movimientos (id, tipo_id, motivo_id, sede_id, usuario_id, lote_id, cantidad, observacion, fecha_registro) " +
-                         "VALUES (?, ?, ?, ?, ?, ?, ?, ?, GETDATE())";
+                         "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)";
 
             try (PreparedStatement ps = conn.prepareStatement(sql)) {
                 ps.setString(1, movimiento.getId());
@@ -42,6 +43,7 @@ public Movimiento save(Connection conn, Movimiento movimiento) {
                 ps.setString(6, movimiento.getLoteId());
                 ps.setInt(7, movimiento.getCantidad());
                 ps.setString(8, movimiento.getObservacion());
+                ps.setTimestamp(9, Timestamp.valueOf(DateTimeProvider.now()));
                 ps.executeUpdate();
             }
         } catch (SQLException e) {