adas-core/adas-core.Application/Customizations/NursePlan/CalculatedObservations.cs

using adas_core.Application.Services.Interfaces;
using adas_core.Domain.Enums;
using adas_core.Domain.Models;
using adas_core.Domain.Models.Pumps;
using Microsoft.Extensions.DependencyInjection;
using MongoDB.Bson;

namespace adas_core.Application.Customizations.NursePlan;

/// <summary>
/// Provides calculated observations by leveraging services obtained from the injected service provider.
/// </summary>
public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
{
    private readonly Lazy<IObservationService> _observationService =
        new(serviceProvider.GetRequiredService<IObservationService>);

    /// <summary>
    /// Asynchronously calculates the active bolus for the specified patient.
    /// </summary>
    /// <param name="patientId">The unique identifier of the patient whose active bolus is to be calculated.</param>
    /// <exception cref="System.NotImplementedException">Thrown when the method is invoked, as the calculation logic has not yet been implemented.</exception>
    public Task CalculateActiveBolus(ObjectId patientId)
    {
        throw new NotImplementedException();
    }

    /// <summary>
    /// Asynchronously maps the provided PumpObservation, returning the input instance as the mapping result.
    /// </summary>
    /// <param name="pumpObservation">The PumpObservation to be mapped.</param>
    /// <returns>A task containing the mapped PumpObservation.</returns>
    public async Task<PumpObservation> Map(PumpObservation pumpObservation)
    {
        return await Task.FromResult(pumpObservation);

    }

    /// <summary>
    /// Asynchronously calculates a medicine observation for the specified patient based on their active medicines.
    /// </summary>
    /// <param name="activeMedicines">The collection of medicines currently active for the patient.</param>
    /// <param name="patientId">The identifier of the patient whose medicine observation is being calculated.</param>
    /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
    public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
    {
        throw new NotImplementedException();
    }

    /// <summary>
    /// Asynchronously resolves time inconsistencies between the supplied observation and the most recent previous observation, returning a corrected observation or <c>null</c> when no correction is required.
    /// </summary>
    /// <param name="newObservation">The new patient observation whose timestamps may need to be reconciled with the last recorded observation.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the fixed <see cref="PatientObservation"/>, or <c>null</c> when no time inconsistency is detected.</returns>
    /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
    public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
    {
        throw new NotImplementedException();
    }

    /// <summary>
    /// Asynchronously retrieves the active treatment records associated with the specified patient.
    /// </summary>
    /// <param name="id">The unique identifier of the patient whose active treatments are being queried.</param>
    /// <returns>A task representing the asynchronous operation, containing a collection of active PatientTreatment entries, which may include null values, for the specified patient.</returns>
    /// <exception cref="NotImplementedException">The method has not yet been implemented.</exception>
    public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
    {
        throw new NotImplementedException();
    }

    /// <summary>
    /// Returns the provided patient observation wrapped in a completed task without modification.
    /// </summary>
    /// <param name="obs">The patient observation to return.</param>
    /// <param name="onlyByName">Reserved flag that is not used in the current implementation.</param>
    /// <returns>A completed task containing the provided observation.</returns>
    public Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
    {
        return Task.FromResult(obs)!;
    }

    /// <summary>
    /// Maps a patient treatment to its target representation asynchronously, returning the provided treatment instance unchanged.
    /// </summary>
    /// <param name="treatment">The patient treatment to map.</param>
    /// <returns>A task containing the mapped patient treatment.</returns>
    public Task<PatientTreatment> Map(PatientTreatment treatment)
    {
        return Task.FromResult(treatment);
    }

    /// <summary>
    /// Maps a <see cref="PatientDiagnosis"/> instance to a completed task containing the same instance.
    /// </summary>
    /// <param name="diagnosis">The patient diagnosis to be returned as a completed task result.</param>
    /// <returns>A completed <see cref="Task{PatientDiagnosis}"/> containing the provided diagnosis.</returns>
    public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
    {
        return Task.FromResult(diagnosis);
    }


    /// <summary>
    /// Returns the provided <paramref name="obs"/> as-is, ignoring the <paramref name="alarmToInsert"/> parameter.
    /// </summary>
    /// <param name="obs">The patient observation to return.</param>
    /// <param name="alarmToInsert">The patient observation alarm; not used in the current implementation.</param>
    /// <returns>A completed task containing the original <paramref name="obs"/>.</returns>
    public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
    {
        return Task.FromResult(obs);
    }

    /// <summary>
    /// Sends an alarm notification based on the specified patient observation, name, and optional alarm code.
    /// </summary>
    /// <param name="obs">The patient observation that triggers the alarm.</param>
    /// <param name="name">The name associated with the alarm.</param>
    /// <param name="code">The optional alarm code identifying the alarm type.</param>
    public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
    {
        return Task.CompletedTask;
    }

    /// <summary>
    /// Returns the provided patient observation list unchanged as a pre-mapping step, typically used as a hook before further mapping or insertion operations.
    /// </summary>
    /// <param name="listToInsert">The list of patient observations to be pre-mapped.</param>
    /// <returns>A completed <see cref="Task{TResult}"/> containing the original list of patient observations.</returns>
    public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
    {
        return Task.FromResult(listToInsert);
    }
}