whatsapp/classes/lab/Enfermera.php

<?php
/**
 * Enfermera — Gestión del personal de enfermería (domicilios).
 */

require_once __DIR__ . '/../../classes/Database.php';
require_once __DIR__ . '/ActividadAdmin.php';

class Enfermera {

    private Database $db;
    private ActividadAdmin $log;

    public function __construct() {
        $this->db  = Database::getInstance();
        $this->log = new ActividadAdmin();
    }

    // ─────────────────────────────────────────────────────────────────────────
    // CRUD
    // ─────────────────────────────────────────────────────────────────────────

    /**
     * Lista de enfermeras activas/todas.
     */
    public function listar(bool $soloActivas = true): array {
        $where = $soloActivas ? 'WHERE is_active = 1' : '';
        return $this->db->fetchAll("
            SELECT
                e.*,
                (SELECT COUNT(*) FROM lab_asignaciones a
                    JOIN lab_domicilios d ON d.id = a.domicilio_id
                    WHERE a.enfermera_id = e.id
                      AND d.fecha_programada = CURDATE()
                      AND a.estado NOT IN ('liberada','completada')
                ) AS domicilios_hoy
            FROM lab_enfermeras e
            $where
            ORDER BY e.nombre_completo ASC
        ");
    }

    /**
     * Enfermera por ID.
     */
    public function obtener(int $id): ?array {
        return $this->db->fetch(
            'SELECT * FROM lab_enfermeras WHERE id = ?',
            [$id]
        ) ?: null;
    }

    /**
     * Crear enfermera.
     */
    public function crear(array $datos, ?int $adminId = null): int {
        $campos = $this->filtrarCampos($datos);
        $id     = $this->db->insert('lab_enfermeras', $campos);
        $this->log->registrar($adminId, 'enfermeras', 'crear', $id, $campos);
        return $id;
    }

    /**
     * Actualizar enfermera.
     */
    public function actualizar(int $id, array $datos, ?int $adminId = null): bool {
        $campos = $this->filtrarCampos($datos);
        $ok     = $this->db->update('lab_enfermeras', $campos, 'id = ?', [$id]);
        $this->log->registrar($adminId, 'enfermeras', 'editar', $id, $campos);
        return $ok > 0;
    }

    /**
     * Desactivar (soft-delete).
     */
    public function desactivar(int $id, ?int $adminId = null): bool {
        $ok = $this->db->update('lab_enfermeras', ['is_active' => 0], 'id = ?', [$id]);
        $this->log->registrar($adminId, 'enfermeras', 'desactivar', $id);
        return $ok > 0;
    }

    // ─────────────────────────────────────────────────────────────────────────
    // Agenda
    // ─────────────────────────────────────────────────────────────────────────

    /**
     * Agenda completa de una enfermera (domicilios asignados con detalle).
     *
     * @param int    $enfermeraId
     * @param string $fecha  YYYY-MM-DD, por defecto hoy
     */
    public function agenda(int $enfermeraId, string $fecha = ''): array {
        $fecha = $fecha ?: date('Y-m-d');
        return $this->db->fetchAll("
            SELECT
                d.id                  AS domicilio_id,
                d.fecha_programada,
                d.hora_programada,
                d.estado              AS domicilio_estado,
                d.direccion,
                d.barrio,
                d.ciudad,
                d.indicaciones_dir,
                d.notas_admin,
                d.tipo_servicio,
                d.examenes_solicitados,
                d.tipo_cliente,
                d.seguro_nombre,
                p.id                  AS paciente_id,
                p.nombre_completo     AS paciente_nombre,
                p.telefono            AS paciente_telefono,
                p.email               AS paciente_email,
                p.fecha_nacimiento    AS paciente_fecha_nacimiento,
                p.tipo_documento      AS paciente_tipo_documento,
                p.numero_documento    AS paciente_numero_documento,
                p.eps                 AS paciente_eps,
                a.estado              AS asignacion_estado,
                a.id                  AS asignacion_id
            FROM  lab_asignaciones a
            JOIN  lab_domicilios  d ON d.id = a.domicilio_id
            JOIN  lab_pacientes   p ON p.id = d.paciente_id
            WHERE a.enfermera_id      = ?
              AND d.fecha_programada  = ?
            ORDER BY d.hora_programada ASC
        ", [$enfermeraId, $fecha]);
    }

    /**
     * Carga de trabajo por período: domicilios asignados por día.
     */
    public function cargaTrabajo(int $enfermeraId, string $desde, string $hasta): array {
        return $this->db->fetchAll("
            SELECT
                d.fecha_programada,
                COUNT(*) AS total,
                SUM(d.estado = 'completado') AS completados
            FROM  lab_asignaciones a
            JOIN  lab_domicilios d ON d.id = a.domicilio_id
            WHERE a.enfermera_id = ?
              AND d.fecha_programada BETWEEN ? AND ?
            GROUP BY d.fecha_programada
            ORDER BY d.fecha_programada ASC
        ", [$enfermeraId, $desde, $hasta]);
    }

    // ─────────────────────────────────────────────────────────────────────────
    // Helpers
    // ─────────────────────────────────────────────────────────────────────────

    private function filtrarCampos(array $datos): array {
        $permitidos = [
            'numero_documento', 'tipo_documento', 'nombre_completo',
            'telefono', 'telefono_alt', 'email',
            'zona', 'notas', 'is_active',
        ];
        return array_intersect_key($datos, array_flip($permitidos));
    }
}