=== 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) ===

adas-core.Application/Services/ArchivePatientCarePlanService.cs

@@ -29,6 +29,8 @@ public class ArchivePatientCarePlanService(
     /// </summary>
     /// <param name="patient">The patient care plan to be archived and inserted.</param>
     /// <returns>The inserted patient care plan, or <see langword="null"/> if no plan was provided.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation states the method returns 'null if no plan was provided', but the code unconditionally returns the patient parameter and would throw a NullReferenceException rather than returning null." -->
     public async Task<PatientCarePlan?> InsertOneAsync(PatientCarePlan patient)
     {
         await archivedPatientRepository.InsertOneAsync(patient);
@@ -43,6 +45,7 @@ public class ArchivePatientCarePlanService(
     /// Asynchronously inserts a batch of archived patient care plans into the repository and creates an audit log entry for each one using the current HTTP context user.
     /// </summary>
     /// <param name="patientCarePla">The list of patient care plans to insert and audit.</param>
+    /// <!-- aidoc:v1 sig=8b81a0b body=1bbcfc7 -->
     public async Task InsertManyAsync(List<PatientCarePlan> patientCarePla)
     {
         await archivedPatientRepository.InsertManyAsync(patientCarePla);
@@ -61,6 +64,7 @@ public class ArchivePatientCarePlanService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived care plans are being searched.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientCarePlan"/> for the patient, or null if no records are found.</returns>
+    /// <!-- aidoc:v1 sig=33d98b1 body=3b1387d -->
     public async Task<List<PatientCarePlan>?> FindByPatientId(ObjectId patientId)
     {
         return await archivedPatientRepository.FindByPatientId(patientId);
@@ -72,6 +76,7 @@ public class ArchivePatientCarePlanService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived care plans are being retrieved.</param>
     /// <returns>A list of <see cref="PatientCarePlan"/> entries for the patient, or <c>null</c> if no records exist.</returns>
+    /// <!-- aidoc:v1 sig=9198094 body=3b1387d -->
     public async Task<List<PatientCarePlan>?> FindByPatientId(string patientId)
     {
         return await archivedPatientRepository.FindByPatientId(patientId);
@@ -83,6 +88,7 @@ public class ArchivePatientCarePlanService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived care plans are being searched.</param>
     /// <returns>A list of <see cref="PatientCarePlan"/> objects for the specified patient, or null if no records are found.</returns>
+    /// <!-- aidoc:v1 sig=be43759 body=7006868 -->
     public async Task<List<PatientCarePlan>?> FindByPatientNumber(string patientId)
     {
         return await archivedPatientRepository.FindByPatientNumber(patientId);
@@ -92,6 +98,7 @@ public class ArchivePatientCarePlanService(
     /// Retrieves all archived patient care plans by delegating to the archived patient repository.
     /// </summary>
     /// <returns>A task that resolves to a list of <see cref="PatientCarePlan"/> objects representing all archived patient care plans.</returns>
+    /// <!-- aidoc:v1 sig=e5c3065 body=a2e9669 -->
     public Task<List<PatientCarePlan>> FindAll()
     {
         return archivedPatientRepository.FindAll();