=== Summary: 675 files | 7 generated | 484 fresh | 4605 untracked | 4268 adopted | 355 marked | 466 validated-ok | 2+0 stale (sig+body) | 0 skipped | 0 failed | elapsed 11:08:11.442 (40091.44s) ===

2026-06-28 02:50:05 -07:00
parent a19fb90902
commit 586f02a2ca
654 changed files with 5260 additions and 0 deletions
@@ -14,6 +14,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="id">The unique identifier of the entity to delete.</param>
    /// <returns>A task that represents the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=0112d17 -->
    Task Delete(ObjectId id);

    /// <summary>
@@ -21,6 +22,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="pointOfCare">The point of care entity containing the updated data.</param>
    /// <returns>A task representing the asynchronous operation, containing the updated point of care, or null if no matching record was found.</returns>
+    /// <!-- aidoc:v1 sig=6e2aa0e -->
    Task<PointOfCare?> Update(PointOfCare pointOfCare);

    /// <summary>
@@ -28,22 +30,26 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="id">The unique identifier of the unit to update.</param>
    /// <param name="unit">The unit data to apply to the existing record.</param>
+    /// <!-- aidoc:v1 sig=d59a50c -->
    Task UpdateUnit(ObjectId id, Unit unit);
    /// <summary>
    /// Retrieves all PointOfCare records asynchronously.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a list of all PointOfCare entries.</returns>
+    /// <!-- aidoc:v1 sig=8074bfb -->
    Task<List<PointOfCare>> GetAll();

    /// <summary>
    /// Asynchronously retrieves all PointOfCare configurations.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="PointOfCare"/> configurations.</returns>
+    /// <!-- aidoc:v1 sig=b9af568 -->
    Task<List<PointOfCare>> GetAllConfigs();
    /// <summary>
    /// Asynchronously retrieves all point-of-care location information.
    /// </summary>
    /// <returns>A task representing the asynchronous operation, containing a list of all <see cref="PointOfCare"/> locations.</returns>
+    /// <!-- aidoc:v1 sig=c0c2738 -->
    Task<List<PointOfCare>> GetAllLocationInfo();

    /// <summary>
@@ -51,6 +57,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="id">The unique identifier of the point of care configuration to update.</param>
    /// <param name="configuration">The new configuration data to apply.</param>
+    /// <!-- aidoc:v1 sig=92922a6 -->
    Task UpdateConfiguration(ObjectId id, PointOfCareConfiguration configuration);

    /// <summary>
@@ -58,12 +65,14 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="id">The unique identifier of the <see cref="PointOfCare"/> to look up.</param>
    /// <returns>A task that represents the asynchronous lookup operation. The task result contains the matching <see cref="PointOfCare"/> if found, or null when no entity with the specified identifier exists.</returns>
+    /// <!-- aidoc:v1 sig=f01a187 -->
    Task<PointOfCare?> FindById(ObjectId id);
    /// <summary>
    /// Retrieves a <see cref="PointOfCare"/> entity by its identifier, including all of its associated configuration data.
    /// </summary>
    /// <param name="id">The <see cref="ObjectId"/> of the <see cref="PointOfCare"/> to locate.</param>
    /// <returns>A task that yields the matching <see cref="PointOfCare"/> with its full configuration, or <c>null</c> if no entity is found for the supplied identifier.</returns>
+    /// <!-- aidoc:v1 sig=810206b -->
    Task<PointOfCare?> FindByIdAllConfig(ObjectId id);

    /// <summary>
@@ -71,6 +80,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="unit">The unique identifier of the unit whose PointOfCare records should be retrieved.</param>
    /// <returns>A task that returns a collection of PointOfCare records for the specified unit, or <c>null</c> if no records are found.</returns>
+    /// <!-- aidoc:v1 sig=d969dd8 -->
    Task<IEnumerable<PointOfCare>?> FindAllByUnitId(ObjectId unit);

    /// <summary>
@@ -78,6 +88,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="room">The room identifier used to look up the associated Points of Care.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable of Points of Care found for the given room, or <c>null</c> if no matching results are found.</returns>
+    /// <!-- aidoc:v1 sig=4637691 -->
    Task<IEnumerable<PointOfCare>?> FindByRoom(string room);

    /// <summary>
@@ -85,6 +96,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="bed">The bed identifier used to look up the associated points of care.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="PointOfCare"/> instances matching the bed, or <c>null</c> if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=604796d -->
    Task<IEnumerable<PointOfCare>?> FindByBed(string bed);

    /// <summary>
@@ -92,6 +104,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="unitIds">The list of unit identifiers used to look up the associated points of care.</param>
    /// <returns>A task that represents the asynchronous operation, containing the list of points of care matching the provided unit identifiers.</returns>
+    /// <!-- aidoc:v1 sig=f8dba62 -->
    Task<List<PointOfCare>> FindAllByUnitIds(List<ObjectId> unitIds);

    /// <summary>
@@ -103,6 +116,7 @@ public interface IPointOfCareService
    /// <param name="fillPatientData">When <c>true</c>, associated patient data is included in the result; when <c>false</c>, only the point of care information is returned.</param>
    /// <param name="ct">Token to cancel the asynchronous operation.</param>
    /// <returns>A task that yields the <see cref="PointOfCare"/> corresponding to the given identifier, or <c>null</c> if it is not found.</returns>
+    /// <!-- aidoc:v1 sig=815317f -->
    Task<PointOfCare?> GetInfo(ObjectId id, LocaleEnum? locale = null, bool fillPatientData = true, CancellationToken ct = default);

    /// <summary>
@@ -110,12 +124,14 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="pointOfCare">The <see cref="PointOfCare"/> entity to be inserted.</param>
    /// <returns>A <see cref="Task{PointOfCare}"/> containing the inserted <see cref="PointOfCare"/>, or <c>null</c> if the insertion was not performed.</returns>
+    /// <!-- aidoc:v1 sig=de1c6f7 -->
    Task<PointOfCare?> InsertPointOfCare(PointOfCare pointOfCare);
    /// <summary>
    /// Retrieves the Point of Care associated with the specified patient identifier.
    /// </summary>
    /// <param name="patientId">The unique identifier of the patient whose Point of Care is being looked up.</param>
    /// <returns>A task that yields the <see cref="PointOfCare"/> associated with the patient, or <c>null</c> if no Point of Care is found for the given patient identifier.</returns>
+    /// <!-- aidoc:v1 sig=c43c4f3 -->
    Task<PointOfCare?> FindPoCByPatientId(ObjectId patientId);

    /// <summary>
@@ -124,6 +140,7 @@ public interface IPointOfCareService
    /// <param name="id">The unique identifier of the entity whose Point of Care status will be updated.</param>
    /// <param name="status">The Point of Care status to assign to the entity.</param>
    /// <returns>A task that represents the asynchronous status update operation.</returns>
+    /// <!-- aidoc:v1 sig=486326c -->
    Task SetPointOfCareStatus(ObjectId id, StatusEnum.PointOfCare status);

    /// <summary>
@@ -133,6 +150,7 @@ public interface IPointOfCareService
    /// <param name="poc">The point-of-care status used to filter the results.</param>
    /// <param name="excludeVirtual">When <c>true</c>, virtual points of care are excluded from the results; otherwise, they are included.</param>
    /// <returns>A task that returns the matching collection of <see cref="PointOfCare"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=078d6e7 -->
    Task<IEnumerable<PointOfCare>> FindByUnitAndStatus(ObjectId unitId, StatusEnum.PointOfCare poc,
            bool excludeVirtual = false);

@@ -140,6 +158,7 @@ public interface IPointOfCareService
    /// Checks the next admission for the specified patient location.
    /// </summary>
    /// <param name="patientLocation">The optional identifier of the patient location to check.</param>
+    /// <!-- aidoc:v1 sig=050dfd4 -->
    void CheckNextAdmission(ObjectId? patientLocation);
    /// <summary>
    /// Retrieves a <see cref="PointOfCare"/> associated with the specified bed and unit identifier, returning <c>null</c> when no matching record is found.
@@ -147,11 +166,13 @@ public interface IPointOfCareService
    /// <param name="bed">The bed identifier used to locate the point of care.</param>
    /// <param name="unitId">The MongoDB <see cref="ObjectId"/> of the unit the point of care belongs to.</param>
    /// <returns>A <see cref="Task{T}"/> that resolves to the matching <see cref="PointOfCare"/> or <c>null</c> if no record matches the supplied bed and unit.</returns>
+    /// <!-- aidoc:v1 sig=b2740c6 -->
    Task<PointOfCare?> FindByBedAndUnitId(string? bed, ObjectId? unitId);
    /// <summary>
    /// Updates the relay configuration associated with the specified point-of-care device.
    /// </summary>
    /// <param name="poc">The point-of-care device whose relay configuration should be updated.</param>
+    /// <!-- aidoc:v1 sig=a1848f1 -->
    Task UpdateRelayConfig(PointOfCare poc);
    /// <summary>
    /// Asynchronously retrieves the Point of Care (PoC) associated with the specified patient number.
@@ -159,6 +180,7 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="patientNumber">The unique patient number used to look up the associated Point of Care.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="PointOfCare"/> if found, or <c>null</c> if no match exists.</returns>
+    /// <!-- aidoc:v1 sig=ea5395f -->
    Task<PointOfCare?> FindPoCByPatientNumber(string patientNumber);

    /// <summary>
@@ -166,43 +188,51 @@ public interface IPointOfCareService
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose PoCs should be counted.</param>
    /// <returns>A task that represents the asynchronous operation, containing the total number of PoCs linked to the given unit.</returns>
+    /// <!-- aidoc:v1 sig=41f9c5e -->
    Task<long> CountPoCsByUnitId(ObjectId unitId);
    /// <summary>
    /// Asynchronously retrieves the total number of virtual Proofs of Concept (PoCs) associated with the specified unit.
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose virtual PoCs should be counted.</param>
    /// <returns>A <see cref="Task{Int64}"/> that represents the asynchronous operation, containing the count of virtual PoCs for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=2a40a4f -->
    Task<long> CountVirtualPoCsByUnitId(ObjectId unitId);
    /// <summary>
    /// Retrieves a paginated collection of Points of Care based on the provided filter.
    /// </summary>
    /// <param name="filter">The pagination parameters used to control page size and page number.</param>
    /// <returns>A task that represents the asynchronous operation, containing the paginated response of Points of Care.</returns>
+    /// <!-- aidoc:v1 sig=6ceec7c -->
    Task<PaginationResponse<PointOfCare>> GetPaginatedPoCs(PaginationFilter filter);
    /// <summary>
    /// Deletes all PoCs associated with the specified unit identifier.
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose PoCs should be removed.</param>
+    /// <!-- aidoc:v1 sig=2c44a9e -->
    Task DeletePoCsByUnitId(ObjectId unitId);
    /// <summary>
    /// Asynchronously retrieves the set of all camera identifiers that are currently in use.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a HashSet of ObjectId values representing the cameras currently in use.</returns>
+    /// <!-- aidoc:v1 sig=5635e4a -->
    Task<HashSet<ObjectId>> FindAllIdCamerasInUse();
    /// <summary>
    /// Asynchronously retrieves the set of all ID relays that are currently in use.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="HashSet{ObjectId}"/> of the ID relays currently in use.</returns>
+    /// <!-- aidoc:v1 sig=a6e513b -->
    Task<HashSet<ObjectId>> FindAllIdRelaysInUse();
    /// <summary>
    /// Asynchronously retrieves the set of all ID beacons currently in use.
    /// </summary>
    /// <returns>A task containing a <see cref="HashSet{ObjectId}"/> of the ID beacons that are active or in use.</returns>
+    /// <!-- aidoc:v1 sig=3084f59 -->
    Task<HashSet<ObjectId>> FindAllIdBeaconsInUse();
    /// <summary>
    /// Retrieves all Point of Care entries associated with the specified unit, including their related devices.
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose Point of Care entries should be retrieved.</param>
    /// <returns>A task that represents the asynchronous operation. The task result contains a collection of Point of Care entries with their devices, or <c>null</c> if no entries are found for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=dbf2769 -->
    Task<IEnumerable<PointOfCare>?> FindAllByUnitIdWithDevices(ObjectId unitId);
 }