diff --git a/adas-core.Application/Customizations/BD/CalculatedObservations.cs b/adas-core.Application/Customizations/BD/CalculatedObservations.cs
index ddccb59a..566ad128 100644
--- a/adas-core.Application/Customizations/BD/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/BD/CalculatedObservations.cs
@@ -14,6 +14,7 @@ namespace adas_core.Application.Customizations.BD;
 /// <remarks>
 /// This type is instantiated with a primary constructor that accepts an <see cref="IServiceProvider"/> to resolve its dependencies.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c3598e8 -->
 public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
 {
     private readonly ILogger<CalculatedObservations> _logger =
@@ -29,6 +30,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The patient observation to map.</param>
     /// <param name="onlyByName">Indicates whether the mapping should match observations by name only.</param>
     /// <returns>A <see cref="Task{T}"/> containing the provided observation.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The method returns Task<T?> (nullable), but the documentation references Task{T} (non-nullable Task<T>)." -->
     public Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         return Task.FromResult(obs)!;
@@ -39,6 +42,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="treatment">The patient treatment instance to map.</param>
     /// <returns>A completed <see cref="Task{PatientTreatment}"/> containing the provided treatment.</returns>
+    /// <!-- aidoc:v1 sig=adce250 body=cf46cd2 -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         return Task.FromResult(treatment);
@@ -49,6 +53,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="diagnosis">The <see cref="PatientDiagnosis"/> instance to map.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the provided <see cref="PatientDiagnosis"/>.</returns>
+    /// <!-- aidoc:v1 sig=8ddf601 body=ad326e6 -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         return Task.FromResult(diagnosis);
@@ -59,6 +64,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The pump observation to be mapped.</param>
     /// <returns>The mapped pump observation.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=9b6ad6e -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         if (pumpObservation.Code == "IHE PCD-04")
@@ -71,6 +77,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="activeMedicines">The list of active medicines associated with the patient.</param>
     /// <param name="patientId">The unique identifier of the patient for whom the observations are calculated.</param>
+    /// <!-- aidoc:v1 sig=b7a50a4 body=6805ef5 -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -81,6 +88,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose active bolus is being calculated.</param>
     /// <returns>A task that represents the asynchronous calculation of the active bolus.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary and returns description state that the method 'calculates' the active bolus, but the body only returns Task.CompletedTask and performs no calculation." -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -92,6 +101,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="id">The unique <see cref="ObjectId"/> identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IEnumerable{PatientTreatment}"/> of nullable <see cref="PatientTreatment"/> entries for the patient's active treatments.</returns>
     /// <exception cref="NotImplementedException">Thrown to indicate that the method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -103,6 +113,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="newObservation">The new patient observation to be reconciled against the last stored observation.</param>
     /// <returns>A task that yields the time-corrected <see cref="PatientObservation"/>, or <c>null</c> when no correction is required or no prior observation exists.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -114,6 +125,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped before insertion.</param>
     /// <returns>A task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -126,6 +138,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="alarmToInsert">The source alarm to be inserted/mapped into the observation.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> that represents the asynchronous mapping operation, returning the resulting patient observation.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=405db8e body=bfa6f2f -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         throw new NotImplementedException();
@@ -139,6 +152,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="code">The optional alarm code that categorizes the alarm; may be null.</param>
     /// <returns>A task that represents the asynchronous alarm sending operation.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -152,6 +166,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The pump observation containing the alarm state, type, timestamps, and identifiers used to build the alarm patient observation.</param>
     /// <returns>A completed <see cref="Task"/> representing the insert operation, which never faults since exceptions are caught internally.</returns>
+    /// <!-- aidoc:v1 sig=8716f6b body=6590257 -->
     private Task CreatePumpAlarmObservation(PumpObservation pumpObservation)
     {
         PatientObservation patientObservationAlarm = new()
diff --git a/adas-core.Application/Customizations/CHUO/CalculatedObservations.cs b/adas-core.Application/Customizations/CHUO/CalculatedObservations.cs
index e336105c..be68b0c2 100644
--- a/adas-core.Application/Customizations/CHUO/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/CHUO/CalculatedObservations.cs
@@ -14,6 +14,7 @@ namespace adas_core.Application.Customizations.CHUO;
 /// <remarks>
 /// Instances are constructed with an <see cref="IServiceProvider"/> used to resolve dependencies required by the implementation.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c3598e8 -->
 public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
 {
     private readonly ILogger<CalculatedObservations> _logger =
@@ -23,6 +24,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// Asynchronously calculates the active bolus for the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus is being calculated.</param>
+    /// <!-- aidoc:v1 sig=7d38721 body=6805ef5 -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -33,6 +35,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A <see cref="Task{PumpObservation}"/> containing the provided pump observation.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -43,6 +46,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The identifier of the patient for whom the observation is calculated.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "Method body returns Task.CompletedTask and does not actually perform any medicine observation calculation; the summary describes intended/pending behavior." -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -55,6 +60,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="newObservation">The new patient observation to compare and reconcile against the last stored observation.</param>
     /// <returns>A task that yields the corrected <see cref="PatientObservation"/>, or <c>null</c> when no time inconsistency is found.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -66,6 +72,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="id">The unique identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of nullable <see cref="PatientTreatment"/> objects representing the patient's active treatments.</returns>
     /// <exception cref="NotImplementedException">Thrown to indicate that the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -77,6 +84,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The patient observation to map.</param>
     /// <param name="onlyByName">Indicates whether mapping should be performed by name only.</param>
     /// <returns>A task containing the provided observation.</returns>
+    /// <!-- aidoc:v1 sig=21d06c4 body=8f6255b -->
     public Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         _logger.LogTrace("Mapping {name} observation {obs}", obs.Name, obs);
@@ -91,6 +99,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="treatment">The patient treatment to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -102,6 +111,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task representing the asynchronous operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown because the mapping logic has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -113,6 +123,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped prior to insertion.</param>
     /// <returns>A completed task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -124,6 +135,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The existing patient observation to be returned.</param>
     /// <param name="alarmToInsert">The alarm to be associated with the observation (currently not applied).</param>
     /// <returns>A completed <see cref="Task{PatientObservation}"/> containing the original observation.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -135,6 +147,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The patient observation that triggers the alarm.</param>
     /// <param name="name">The name of the alarm to send.</param>
     /// <param name="code">The optional alarm code providing additional classification for the alarm.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=missing_returns
+    ///      "Method returns Task but no <returns> tag is present to describe the asynchronous result." -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         return Task.CompletedTask;
diff --git a/adas-core.Application/Customizations/H12O/UCIN/CalculatedObservations.cs b/adas-core.Application/Customizations/H12O/UCIN/CalculatedObservations.cs
index c64f833c..8f3f05c9 100644
--- a/adas-core.Application/Customizations/H12O/UCIN/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/H12O/UCIN/CalculatedObservations.cs
@@ -17,6 +17,7 @@ namespace adas_core.Application.Customizations.H12O.UCIN;
 /// raw observations and active <see cref="PatientTreatment"/> entries, using the catalogue of
 /// codes, groups, and types configured in <see cref="ApiSettings"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private readonly List<string> _complexityObservations =
@@ -87,6 +88,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// ONi, ventilation modes, ECMO, and notes indicating medication) from <see cref="ApiSettings"/>.
     /// </summary>
     /// <param name="serviceProvider">The application's service provider used to resolve the required dependencies and configuration.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "The summary lists the configured catalogues loaded from ApiSettings but omits SurgeryText, which is also loaded in the constructor." -->
     public CalculatedObservations(IServiceProvider serviceProvider)
     {
         _observationService = serviceProvider.GetRequiredService<Lazy<IObservationService>>(); //observationService;
@@ -159,6 +162,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// A <see cref="Task{T}"/> that resolves to the (possibly transformed) observation, or
     /// <see langword="null"/> when the input observation has no name.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The documentation states the method resolves to null 'when the input observation has no name', but the early-exit branch returns the original `obs`, not null." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName) where T : BasePatientObservation
     {
         // Early exit: if the observation has no name, there's nothing to map
@@ -244,6 +249,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="treatment">The <see cref="PatientTreatment"/> to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation. The task result contains the processed <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="ArgumentNullException">Thrown when the <paramref name="treatment"/> parameter is <c>null</c>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "ArgumentNullException is documented but the method body never throws it; no null check exists for the treatment parameter, so a null argument would result in a NullReferenceException, not ArgumentNullException." -->
     public async Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         if (treatment.SingleDose)
@@ -316,6 +323,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A task containing the same <see cref="PumpObservation"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -330,6 +338,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="activeMedicines">The list of active <see cref="Medicine"/> instances currently associated with the patient.</param>
     /// <param name="patientId">The unique identifier of the patient.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=299c0fe body=f6867d8 -->
     public async Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         await CalculateMedicineObservation(activeMedicines, [], new PatientTreatment { PatientId = patientId });
@@ -342,6 +351,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=2aadb2d body=f1796c6 -->
     public async Task CalculateActiveBolus(ObjectId patientId)
     {
         // SIN RXA
@@ -395,6 +405,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique identifier of the patient.</param>
     /// <returns>A collection of active <see cref="PatientTreatment"/> objects for the patient.</returns>
+    /// <!-- aidoc:v1 sig=1c9e799 body=2a62eb7 -->
     public async Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         var activeTreatments = await _treatmentService.Value.GetActiveTreatmentsByPatient(id);
@@ -409,6 +420,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="diagnosis">The <see cref="PatientDiagnosis"/> to map.</param>
     /// <returns>A task containing the same <see cref="PatientDiagnosis"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=8ddf601 body=ad326e6 -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         return Task.FromResult(diagnosis);
@@ -425,6 +437,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// A task that represents the asynchronous operation. The task result contains the fixed
     /// <see cref="PatientObservation"/> if the input had a valid name; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states the trigger is when the new observation arrives with the 'same (down-to-the-second) timestamp', but the code's DateTime.Compare >= 0 condition also triggers the shift when the new observation's truncated time is strictly earlier than the last observation's." -->
     public async Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         if (string.IsNullOrEmpty(newObservation.Name))
@@ -460,6 +474,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped.</param>
     /// <returns>A task containing the original list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -473,6 +488,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation that triggered the alarm.</param>
     /// <param name="alarmToInsert">The alarm metadata to be inserted alongside the observation.</param>
     /// <returns>A task containing the same <see cref="PatientObservation"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -487,6 +503,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="code">The optional alarm code from <see cref="AlarmEnum.Name"/>.</param>
     /// <returns>Never returns a result.</returns>
     /// <exception cref="NotImplementedException">Always thrown because alarm dispatch is not implemented in the UCIN customization.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -501,6 +518,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <returns>A task that represents the asynchronous insert operation.</returns>
     /// <exception cref="InvalidCastException">Thrown when <paramref name="obs"/> cannot be cast to <see cref="PatientObservation"/>.</exception>
     /// <exception cref="Exception">Rethrown after the underlying exception is written to the console for diagnostics.</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary states 'Errors are logged' but the code uses Console.WriteLine for exception output, not the _logger. The companion <exception> tag correctly describes console output, so the summary is mildly inconsistent with the actual behavior." -->
     public async Task CheckSurgeryExpired(BasePatientObservation obs)
     {
         try
@@ -536,6 +555,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation expected to be a <see cref="PatientObservation"/>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the (possibly time-shifted) base patient observation.</returns>
+    /// <!-- aidoc:v1 sig=02a8359 body=9a6b741 -->
     public async Task<BasePatientObservation> CheckObsExistsAndIncrementTime(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -559,6 +579,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation expected to be a <see cref="PatientObservation"/>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the (possibly time-shifted) base patient observation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims the method is for 'temperature observations', but the code contains no temperature-specific logic — it works for any observation type passed in, using whatever Name is on the observation." -->
     public async Task<BasePatientObservation> CheckObsWithSameTimeExistsAndIncrementTime(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -579,6 +601,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The observation that triggered the calculation (one of <c>AirPressure_Mean</c>, <c>FiO2</c>, or <c>PaO2</c>).</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=3429ff2 body=103e384 -->
     public async Task CalculateOxygenationIndex(BasePatientObservation obs)
     {
         var toSearchList = new List<string>();
@@ -655,6 +678,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The single-dose treatment whose end time is to be calculated.</param>
     /// <returns>The same <see cref="PatientTreatment"/> instance with its <c>EndTime</c> updated.</returns>
+    /// <!-- aidoc:v1 sig=271263e body=4ddb3f4 -->
     private static PatientTreatment CalculateSingleDoseEndDate(PatientTreatment treatment)
     {
         /* Deprecated calc finish treatment date on shift end. Now every treatment single dose is last 8 Hours
@@ -690,6 +714,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The treatment whose medicines should be checked.</param>
     /// <returns>A task that represents the asynchronous check operation.</returns>
+    /// <!-- aidoc:v1 sig=26b9617 body=0b5d20b -->
     public async Task CheckTreatmentMedicines(PatientTreatment treatment)
     {
         //sI TIENE UNA NOTA CON NPT SON DE TIPO NUTRICIÓN PARENTERAL Y SUMAN 1
@@ -784,6 +809,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The treatment to inspect for NPT indicators, or <see langword="null"/>.</param>
     /// <returns>A task that resolves to a <see cref="Medicine"/> instance describing the parenteral nutrition, or an unnamed, untyped instance when no NPT notes are present.</returns>
+    /// <!-- aidoc:v1 sig=d078407 body=3e76d41 -->
     private static Task<Medicine> CalculateParentalNutritionMedicine(PatientTreatment? treatment)
     {
         List<string> medicineType = [];
@@ -818,6 +844,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="medicines">The medicines to add or remove depending on <c>OrderControl</c>.</param>
     /// <param name="treatment">The treatment that triggered the recalculation.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=0ed4852 body=363a6db -->
     public async Task CalculateMedicineObservation(List<Medicine> activeMedicines, List<Medicine> medicines,
         PatientTreatment treatment)
     {
@@ -876,6 +903,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="activeMedicines">The list of active medicines used to derive the risk level.</param>
     /// <param name="treatment">The treatment that triggered the recalculation.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=b13c549 body=24f69f5 -->
     private async Task CalculateErMedication(List<Medicine> activeMedicines, PatientTreatment treatment)
     {
         //var activeTreatments = treatmentService.Value.GetActiveTreatmentsByPatient(treatment.patientid);
@@ -908,6 +936,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="activeMedicines">The list of active medicines to evaluate.</param>
     /// <returns>A task that resolves to the integer risk level (0–5).</returns>
+    /// <!-- aidoc:v1 sig=3c6a3b1 body=606ffd9 -->
     private static Task<int> CalculateErMedicineLevels(List<Medicine> activeMedicines)
     {
         var ironVitaminDCodes = new List<string> { "374424002", "175041000140104" };
@@ -964,6 +993,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The respiratory-mode observation expected to be a <see cref="PatientObservation"/>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=a32f888 body=5994877 -->
     public async Task CalculateVentilationMode(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -998,6 +1028,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (expected to be a <see cref="PatientObservation"/>).</param>
     /// <returns>A task that resolves to the same base patient observation that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=dbb815a body=5ae4249 -->
     public async Task<BasePatientObservation> CalculateAsistResp(BasePatientObservation obs)
     {
         //Comprobar si hay un resp_type más nuevo y si no lo hay ignorar
@@ -1057,6 +1088,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The treatment whose ECMO state is being applied.</param>
     /// <returns>A task that represents the asynchronous recalculation operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation states 'In every case the change is followed by a complexity recalculation via CalculateComplexity', but the default case returns early without calling CalculateComplexity." -->
     private async Task CalculateComplexityOnEcmo(PatientTreatment treatment)
     {
         var ecmoObs = new PatientObservation
@@ -1102,6 +1135,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The base patient observation that triggered the recalculation.</param>
     /// <param name="ignoreObs">When <see langword="true"/>, the supplied <paramref name="obs"/> is not added to the calculation inputs (useful for synthetic observations like ECMO).</param>
     /// <returns>A task that resolves to the same base patient observation that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=b7809c7 body=cf3438b -->
     public async Task<BasePatientObservation> CalculateComplexity(BasePatientObservation obs, bool ignoreObs = false)
     {
         try
@@ -1278,6 +1312,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// early because the incoming observation is a duplicate insert (in which case the caller should
     /// not overwrite the stored observation).
     /// </returns>
+    /// <!-- aidoc:v1 sig=09f61b3 body=4d3947c -->
     public async Task<BasePatientObservation?> CalculateIntravenousLineObservation(BasePatientObservation obs)
     {
         try
@@ -1413,6 +1448,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation whose value represents the patient's weight.</param>
     /// <returns>A task that resolves to the integer complexity contribution (0–7).</returns>
+    /// <!-- aidoc:v1 sig=a79c349 body=4c9b390 -->
     private async Task<int> CalculateWeight(BasePatientObservation obs)
     {
         var complexityValueOfWeight = 0;
@@ -1445,6 +1481,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation expected to be a <see cref="PatientObservation"/> with a numeric value.</param>
     /// <returns>A task that resolves to the (possibly converted) base patient observation.</returns>
+    /// <!-- aidoc:v1 sig=18ad5f6 body=5d01118 -->
     public Task<BasePatientObservation> ParseWeight(BasePatientObservation obs)
     {
         if (obs is not PatientObservation pobs || !double.TryParse(pobs.Value.ToString(), out var dValue))
@@ -1471,6 +1508,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// derived from whichever type is supplied.
     /// </param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=9488dd5 body=f704b41 -->
     public async Task CalculateMonitor(object monitorObservation)
     {
         var monitorValue = 0;
@@ -1545,6 +1583,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The treatment that triggered the recalculation.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=a3bb931 body=d219f09 -->
     private async Task CalculateSurgery(PatientTreatment treatment)
     {
         var surgeryScore = 0;
@@ -1596,6 +1635,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="patientId">The unique identifier of the patient.</param>
     /// <param name="newTreatment">The optional new treatment to be included in the active-bolus set.</param>
     /// <returns>A task that resolves to the list of treatments currently counted as active boluses.</returns>
+    /// <!-- aidoc:v1 sig=401adb8 body=c80c23f -->
     private async Task<List<PatientTreatment>> GetActiveBolus(ObjectId patientId, PatientTreatment? newTreatment)
     {
         var treatmentsProcessed = new List<PatientTreatment>();
@@ -1660,6 +1700,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The treatment that triggered the recalculation and should be included in the active-bolus set.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=493996c body=3ef85e3 -->
     private async Task CalculateBolus(PatientTreatment treatment)
     {
         var activeBolus = await GetActiveBolus(treatment.PatientId, treatment);
@@ -1686,6 +1727,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the alert evaluation (<c>TAm</c>, <c>Age_Gestational</c>, or <c>Age_Gestational_Fixed</c>).</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=857f5e0 body=0bf2cd4 -->
     public async Task CalculateTAmAlert(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -1749,6 +1791,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (<c>Temp_Patient</c> or <c>Temp_Incubator</c>).</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=f3ac5ae body=4120ebf -->
     public async Task CalculateTempGradient(BasePatientObservation obs)
     {
         List<PatientObservation> tempRetrievedesFromBd;
diff --git a/adas-core.Application/Customizations/HGM/CalculatedObservations.cs b/adas-core.Application/Customizations/HGM/CalculatedObservations.cs
index 59a2b41e..ea3c5800 100644
--- a/adas-core.Application/Customizations/HGM/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/HGM/CalculatedObservations.cs
@@ -14,6 +14,7 @@ namespace adas_core.Application.Customizations.HGM;
 /// <summary>
 /// Represents a collection of calculated observations, providing a concrete implementation of the <see cref="ICalculatedObservations"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private readonly List<string> _highFrequencyVentilation = [];
@@ -51,6 +52,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <param name="onlyByName">Flag indicating whether the mapping should be restricted to name-based criteria.</param>
     /// <returns>The mapped patient observation, or the original observation if no applicable mapping is found.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "The onlyByName parameter is documented as a 'Flag indicating whether the mapping should be restricted to name-based criteria,' but the parameter is never used in the method body. The switch statement processes cases based on name regardless of this flag." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         if (string.IsNullOrEmpty(obs.Name)) return obs;
@@ -72,6 +75,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="treatment">The <see cref="PatientTreatment"/> instance to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="System.NotImplementedException">Thrown to indicate that the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -83,6 +87,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping logic has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -93,6 +98,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A completed task containing the provided <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -104,6 +110,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus is calculated.</param>
     /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=7d38721 body=bfa6f2f -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -115,6 +122,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="activeMedicines">The list of active medicines currently associated with the patient.</param>
     /// <param name="patientId">The unique identifier of the patient for whom the observation is being calculated.</param>
     /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=b7a50a4 body=bfa6f2f -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -126,6 +134,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="newObservation">The new patient observation to reconcile against the last recorded observation.</param>
     /// <returns>A task that returns the corrected <see cref="PatientObservation"/>, or <c>null</c> when no last observation is available to compare against.</returns>
     /// <exception cref="System.NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -137,6 +146,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="id">The identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that yields a collection of active <see cref="PatientTreatment"/> entries for the patient.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -147,6 +157,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped.</param>
     /// <returns>A completed task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -158,6 +169,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to return as the mapped result.</param>
     /// <param name="alarmToInsert">The patient observation alarm to be considered during mapping.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> containing the provided <paramref name="obs"/>.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -171,6 +183,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="code">The optional alarm code identifying the alarm type.</param>
     /// <returns>A task that represents the asynchronous alarm sending operation.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as it is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -180,6 +193,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates and persists the ventilation mode (<c>Resp_Type</c>) for a patient observation by mapping the observed value against known high-frequency, invasive, and non-invasive ventilation vocabularies, defaulting to <c>None</c> when the value is empty or unrecognized.
     /// </summary>
     /// <param name="obs">The base patient observation whose value is used to derive the respiration type; it is cast to <see cref="PatientObservation"/> to access the value.</param>
+    /// <!-- aidoc:v1 sig=dd5b490 body=f8d6b73 -->
     private async Task CalculateVentilationMode(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
diff --git a/adas-core.Application/Customizations/HPAZ/CalculatedObservations.cs b/adas-core.Application/Customizations/HPAZ/CalculatedObservations.cs
index acacd293..9be31de1 100644
--- a/adas-core.Application/Customizations/HPAZ/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/HPAZ/CalculatedObservations.cs
@@ -17,6 +17,7 @@ namespace adas_core.Application.Customizations.HPAZ;
 /// <remarks>
 /// This class implements the <see cref="ICalculatedObservations"/> contract, exposing the behavior defined by that interface while relying on constructor-injected services for its operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c3598e8 -->
 public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
 {
     private readonly Lazy<IAlarmService> _alarmService = serviceProvider.GetRequiredService<Lazy<IAlarmService>>();
@@ -42,6 +43,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// 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>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'calculates the active bolus', but the body only returns Task.CompletedTask without performing any calculation." -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -52,6 +55,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The unique identifier of the patient whose medicine observations are being calculated.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method calculates medicine observations based on active medicines, but the body only returns Task.CompletedTask and performs no calculation." -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -63,6 +68,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of active <see cref="PatientTreatment"/> records for the patient, or an empty collection if none exist.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'Retrieves the active treatments associated with the specified patient identifier,' but the implementation unconditionally returns an empty collection without performing any retrieval or checking the id parameter." -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         return Task.FromResult<IEnumerable<PatientTreatment?>>(new List<PatientTreatment?>());
@@ -75,6 +82,10 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="source">Observation</param>
     /// <param name="onlyByName">True if the observation needs to generate an alert</param>
     /// <returns>Mapped observation</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Summary states 'inserts it if needed', but the method body contains no insertion logic — it only maps/processes the observation and returns it." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "onlyByName is documented as 'True if the observation needs to generate an alert', but the in-code comment states 'No generamos alertas si viene onlyByName' (alerts are NOT generated when onlyByName is true), and the parameter is never actually used in the method body." -->
     public async Task<T?> Map<T>(T source, bool onlyByName) where T : BasePatientObservation
     {
         _logger.LogDebug("Mapping {obsName} mode observation {obs}", source.Name, source);
@@ -113,6 +124,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The source <see cref="PumpObservation"/> to map.</param>
     /// <returns>A task that represents the asynchronous mapping operation. The task result contains the mapped <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method maps to a 'new PumpObservation instance', but the code returns the same pumpObservation instance unchanged." -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         try
@@ -212,6 +225,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="treatment">The <see cref="PatientTreatment"/> to be mapped.</param>
     /// <returns>A task representing the asynchronous operation, containing the mapped <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown in all cases because the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -223,6 +237,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="diagnosis">The <see cref="PatientDiagnosis"/> to be mapped.</param>
     /// <returns>A task that represents the asynchronous operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown to indicate that the mapping logic has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -234,6 +249,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="newObservation">The new patient observation to validate and potentially adjust for time consistency.</param>
     /// <returns>The patient observation with its time corrected if a time inconsistency was detected, otherwise the original observation.</returns>
+    /// <!-- aidoc:v1 sig=2b42b30 body=3a31920 -->
     public async Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         if (string.IsNullOrEmpty(newObservation.Name))
@@ -267,6 +283,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="listToMap">The list of patient observations to process for mapping and blue code calculation.</param>
     /// <returns>The original list of patient observations passed to the method.</returns>
+    /// <!-- aidoc:v1 sig=655d2ec body=afe534e -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToMap)
     {
         var mappedObsList = listToMap
@@ -290,6 +307,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The target <see cref="PatientObservation"/> instance that will be updated with values from the alarm.</param>
     /// <param name="alarmToInsert">The source <see cref="PatientObservationAlarm"/> whose values are applied to <paramref name="obs"/>.</param>
     /// <returns>A completed <see cref="Task{PatientObservation}"/> containing the updated <paramref name="obs"/>.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=9a22777 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         if (!string.IsNullOrEmpty(alarmToInsert.EventId))
@@ -310,6 +328,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="name">The name of the alarm to be sent.</param>
     /// <param name="code">The optional alarm code identifying the type of alarm.</param>
     /// <exception cref="System.NotImplementedException">Thrown because the method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=9d68c3e body=bfa6f2f -->
     Task ICalculatedObservations.SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -323,6 +342,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="name">The name of the alarm.</param>
     /// <param name="code">The optional alarm code identifier.</param>
     /// <param name="type">The type of alarm to send.</param>
+    /// <!-- aidoc:v1 sig=cd9926e body=38786f6 -->
     private async Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code, AlarmEnum.Type type)
     {
         await _alarmService.Value.SendAlarm(obs, name, code, AlarmEnum.Severity.None, type);
@@ -334,6 +354,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="obs">Observation</param>
     /// <returns>True if it needs to be ignored</returns>
+    /// <!-- aidoc:v1 sig=9343b34 body=bfb9ed9 -->
     private bool CheckIfObservationIsOlderAndShouldBeIgnored(PatientObservation obs)
     {
         if (obs.Time.ToUniversalTime().AddMinutes(_apiSettings.IgnoreCalcObservationsOlderInMinutesThan) <
@@ -354,6 +375,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pobs">The patient observation whose alarm configuration should be resolved; its <c>Name</c> and <c>PatientId</c> are used to locate the configuration.</param>
     /// <returns>The same <see cref="PatientObservation"/> instance with its <c>Alarm</c> property populated from the matching configuration, or <c>null</c> when no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=4d79a28 body=efca777 -->
     private async Task<PatientObservation> CheckAlarmConfig(PatientObservation pobs)
     {
         var configObs = await _configObservationService.Get(new PatientObservation
@@ -373,6 +395,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="name">The alarm code used to identify the type of alarm; it is set as the <c>Code</c> and used to compose the <c>Name</c>.</param>
     /// <param name="pobs">The source patient observation whose value, patient identifier, time, and alarm flag are copied into the new alarm observation.</param>
     /// <returns>A new <see cref="PatientObservation"/> configured as an ADAS alarm observation based on the provided source.</returns>
+    /// <!-- aidoc:v1 sig=235b1d9 body=27fc0a4 -->
     private static PatientObservation CreateAlarmObservation(string name, PatientObservation pobs)
     {
         return new PatientObservation
@@ -391,6 +414,10 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     ///     Checks if a blue code observation Lists needs to be generated and inserts it.
     /// </summary>
     /// <param name="obsList"></param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The method does not 'generate' or 'insert' a blue code observation list; it evaluates clinical conditions (FC, SpO2, TAm) and calls SendBlueCode to trigger a notification. The summary misrepresents both the action and the outcome." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The <param name='obsList'> tag has no description." -->
     public async Task CalculateBlueCodeList(List<PatientObservation?>? obsList)
     {
         //Las 3 observaciones vienen siempre juntas en el mismo mensaje
@@ -461,6 +488,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// Sends a Blue Code alarm for the given patient observation. If the observation is null, the method returns without taking any action; otherwise it creates the corresponding alarm observation, validates it against the alarm configuration, persists it, and dispatches the alarm as an automatically triggered Blue alarm.
     /// </summary>
     /// <param name="pobs">The patient observation that triggers the Blue Code alarm; when null, the method short-circuits without processing.</param>
+    /// <!-- aidoc:v1 sig=5b6ce3f body=c8aa765 -->
     private async Task SendBlueCode(PatientObservation? pobs)
     {
         if (pobs == null)
@@ -486,6 +514,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="obs">The base patient observation value whose ventilation mode will be calculated and normalized.</param>
     /// <returns>The patient observation with the normalized ventilation mode value.</returns>
+    /// <!-- aidoc:v1 sig=0a38ecd body=8d45d84 -->
     private BasePatientObservationValue CalculateVentilationMode(BasePatientObservationValue obs)
     {
         var value = obs is PatientObservationAlarm oAlarm ? oAlarm.Value
@@ -508,6 +537,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="obs">The patient observation to evaluate; non-<see cref="PatientObservation"/> instances are returned unchanged.</param>
     /// <returns>The original observation, with its <c>Time</c> adjusted by one second when a matching observation is found.</returns>
+    /// <!-- aidoc:v1 sig=a546fa4 body=b8e5fa3 -->
     private async Task<BasePatientObservationValue> CheckObsWithSameTimeExistsAndIncrementTime(
             BasePatientObservationValue obs)
     {
@@ -529,6 +559,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="obs">The newly received patient observation that triggered the calculation; its Name must be either "FiO2" or "Sattc".</param>
     /// <param name="name">The name of the observation, used to determine whether <paramref name="obs"/> is the FiO2 or the Sattc value.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states the calculation is 'logged and skipped' when the insertion conditions are not met, but only the FiO2 == 0 case triggers a log message; other skip conditions (expired observations, unparseable values, null complementary observation, sat > 97) silently skip without logging." -->
     private async Task CalculateSf(BasePatientObservationValue obs, string name)
     {
         try
@@ -590,6 +622,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     ///     calculation if they are not
     ///     in database then  does nothing.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The parameters 'obs' (BasePatientObservationValue containing the triggering observation) and 'name' (the name of the observation being processed, used to switch on which value was provided) are not documented." -->
     public async Task CalculateOxygenationIndex(BasePatientObservationValue obs, string name)
     {
         var toSearchList = new List<string>();
@@ -665,6 +699,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="obs">The current patient observation that initiated the calculation; provides the patient identifier and timestamp used for the resulting observation.</param>
     /// <param name="name">The name of the observation in <paramref name="obs"/>, expected to be either <c>FiO2</c> or <c>PaO2_Tidal</c>, which determines how the counterpart value is resolved.</param>
+    /// <!-- aidoc:v1 sig=1b41d79 body=5e03ddd -->
     private async Task CalculatePf(BasePatientObservationValue obs, string name)
     {
         try
@@ -729,6 +764,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="name">The alarm identifier used to build the observation <c>Code</c> and <c>Name</c>.</param>
     /// <param name="pumpObservation">The pump data source providing rack/auxiliary info, drug name, time, and optional patient id.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> that yields the resulting observation, or <c>null</c> when the alarm configuration check rejects it.</returns>
+    /// <!-- aidoc:v1 sig=adcd93c body=8ef1fe1 -->
     private async Task<PatientObservation?> CreatePumpAlarmObservation(string name,
             PumpObservation pumpObservation)
     {
diff --git a/adas-core.Application/Customizations/HRYC/CalculatedObservations.cs b/adas-core.Application/Customizations/HRYC/CalculatedObservations.cs
index 2a223921..9aafa59e 100644
--- a/adas-core.Application/Customizations/HRYC/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/HRYC/CalculatedObservations.cs
@@ -18,6 +18,7 @@ namespace adas_core.Application.Customizations.HRYC;
 /// Resp_Type, and Hour_Balance) from incoming raw observations and active configurations loaded from
 /// <see cref="ApiSettings"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private readonly IOptions<ApiSettings> _apiSettings;
@@ -42,6 +43,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// from <see cref="ApiSettings"/>.
     /// </summary>
     /// <param name="serviceProvider">The application's service provider used to resolve the required dependencies and configuration.</param>
+    /// <!-- aidoc:v1 sig=409f903 body=cf624d7 -->
     public CalculatedObservations(IServiceProvider serviceProvider)
     {
         _observationService = serviceProvider.GetRequiredService<Lazy<IObservationService>>(); //observationService;
@@ -86,6 +88,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// A <see cref="Task{T}"/> that resolves to the (possibly transformed) observation,
     /// or <see langword="null"/> when the input observation has no name.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation claims the method returns null 'when the input observation has no name', but the method always returns the (possibly transformed) obs parameter; the code never returns null, so the null branch described in <returns> does not exist." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName) where T : BasePatientObservation
     {
         _logger.LogTrace("Mapping {name} observation {obs}", obs.Name, obs);
@@ -148,6 +152,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="treatment">The treatment to map.</param>
     /// <returns>Never returns a result.</returns>
     /// <exception cref="NotImplementedException">Always thrown because treatment mapping is not implemented in the HRYC customization.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -161,6 +166,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A task containing the same <see cref="PumpObservation"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -174,6 +180,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="activeMedicines">The list of active medicines (ignored).</param>
     /// <param name="patientId">The unique identifier of the patient (ignored).</param>
     /// <returns>A completed task.</returns>
+    /// <!-- aidoc:v1 sig=b7a50a4 body=6805ef5 -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -185,6 +192,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient (ignored).</param>
     /// <returns>A completed task.</returns>
+    /// <!-- aidoc:v1 sig=7d38721 body=6805ef5 -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -196,6 +204,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique identifier of the patient (ignored).</param>
     /// <returns>A completed task containing an empty <see cref="IEnumerable{PatientTreatment}"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The cref references IEnumerable{PatientTreatment}, but the actual return type is IEnumerable{PatientTreatment?} (element type is nullable)." -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         return Task.FromResult(new List<PatientTreatment?>().AsEnumerable());
@@ -207,6 +217,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="diagnosis">The <see cref="PatientDiagnosis"/> to map.</param>
     /// <returns>A task containing the same <see cref="PatientDiagnosis"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=8ddf601 body=ad326e6 -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         return Task.FromResult(diagnosis);
@@ -224,6 +235,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// A task that resolves to the (possibly time-shifted) <see cref="PatientObservation"/>.
     /// Returns the input unchanged when its <c>Name</c> is null or empty, logging the error.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary states the time is shifted 'when it arrives with the same (down-to-the-second) timestamp' as the latest observation, but the code actually shifts whenever the last observation's second-truncated time is greater than OR equal to the new observation's (DateTime.Compare >= 0), i.e., it also corrects cases where the new observation arrives earlier than the latest one." -->
     public async Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         if (string.IsNullOrEmpty(newObservation.Name))
@@ -262,6 +275,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// A task that resolves to the resulting list of observations (with <c>Vent_Rate</c> removed
     /// when it was inserted synchronously, or the original list otherwise).
     /// </returns>
+    /// <!-- aidoc:v1 sig=e508c09 body=d3232c6 -->
     public async Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         var ventRate = listToInsert.FirstOrDefault(obs => obs.Name == "MDC_VENT_RESP_RATE");
@@ -312,6 +326,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation that triggered the alarm.</param>
     /// <param name="alarmToInsert">The alarm metadata to be inserted alongside the observation.</param>
     /// <returns>A task containing the same <see cref="PatientObservation"/> instance that was passed in.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -327,6 +342,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="code">The optional alarm code from <see cref="AlarmEnum.Name"/>.</param>
     /// <returns>Never returns a result.</returns>
     /// <exception cref="NotImplementedException">Always thrown because this overload is not used in the HRYC customization.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -339,6 +355,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> whose <c>Name</c> is <c>NEWS</c>.</param>
     /// <returns>A task that represents the asynchronous alarm evaluation.</returns>
+    /// <!-- aidoc:v1 sig=a2f90ec body=b1f8d11 -->
     private async Task CalculateNews(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -382,6 +399,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The base patient observation that triggered the alarm (used to derive <c>PatientId</c> and <c>Time</c>).</param>
     /// <param name="name">The <see cref="AlarmEnum.Name"/> describing the alarm kind (for example, <c>NewsOff</c>, <c>NewsWarning</c>, <c>NewsAlert</c>).</param>
     /// <returns>A task that represents the asynchronous alarm dispatch.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states 'The alarm observation is always persisted', but the method returns early without calling InsertObservation when configObs is null (and also when an exception is thrown), so persistence is not guaranteed." -->
     private async Task SendAlarm(BasePatientObservation obs, AlarmEnum.Name name)
     {
         var pobs = (PatientObservation)obs;
@@ -444,6 +463,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="color">The beacon colour to apply.</param>
     /// <param name="patient">The patient whose associated beacon should be updated.</param>
+    /// <!-- aidoc:v1 sig=aced090 body=6297307 -->
     private void SendBeaconCode(AlarmEnum.BeaconColor color, Patient patient)
     {
         if (!patient.PointOfCareId.HasValue)
@@ -478,6 +498,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (<c>SpO2</c>, <c>FiO2</c>, or <c>FR</c>).</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "Documentation states observations must be 'within the last 10 minutes', but the code checks `o.Time.CompareTo(DateTime.UtcNow.AddMinutes(10)) <= 0` (10 minutes in the future), which is a much more permissive check that allows any past observation and does not enforce a 10-minute-ago cutoff." -->
     private async Task CalculateIrox(BasePatientObservation obs)
     {
         try
@@ -560,6 +582,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (<c>FR</c> or <c>Vent_Rate</c>).</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=0c7e3f7 body=e68f279 -->
     private async Task CalculateRespRate(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -627,6 +650,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Hydric_Balance</c>.</param>
     /// <returns>A task that resolves to the (possibly time-shifted) base patient observation.</returns>
+    /// <!-- aidoc:v1 sig=443610d body=4a73250 -->
     private async Task<BasePatientObservation> CalculateHydricBalance(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -650,6 +674,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Hour_Balance</c>.</param>
     /// <returns>A task that resolves to the (possibly time-shifted) base patient observation.</returns>
+    /// <!-- aidoc:v1 sig=23cf188 body=8e46c30 -->
     private async Task<BasePatientObservation> CalculateHourBalance(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -677,6 +702,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Hydric_Balance</c>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=721b70b body=271caec -->
     private async Task CalculateHydricBalanceCalculated(BasePatientObservation obs)
     {
         //Hydric_Balance_Calculated 
@@ -753,6 +779,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Resp_Mode</c>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "Summary references identifier 'InvasiveVentilation' (in <c> tags) but the actual field is '_codesForInvasiveVentilation'." -->
     private async Task CalculateVentilationMode(BasePatientObservation obs)
     {
         _logger.LogDebug("CalculateVentilationMode {obs}", obs);
@@ -800,6 +828,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Weight_Current</c>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=cb420e5 body=6df7b22 -->
     private async Task CalculateWeight_DiffObservation(BasePatientObservation obs)
     {
         var toSearchList = new List<string>();
@@ -839,6 +868,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (<c>Diuresis</c> or <c>Weight_Current</c>).</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=c96d1b4 body=0dfe456 -->
     private async Task CalculateDiureis_WeightObservation(BasePatientObservation obs)
     {
         var toSearchList = new List<string>();
@@ -891,6 +921,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>AllergiesObs</c> and a collection-valued <c>Value</c> of <see cref="PatientAllergiesValue"/>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=16bb26b body=661f911 -->
     private async Task CalculateAllergiesObservation(BasePatientObservation obs)
     {
         try
@@ -967,6 +998,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>DrainagesObs</c> and a <see cref="PatientDrainagesValue"/>-typed <c>Value</c>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=2e0f71d body=98b8c9e -->
     private async Task CalculateDrainagesObservation(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;
@@ -1013,6 +1045,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation (<c>PEEP</c> or <c>Pleateu_Pressure</c>).</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=fe22b05 body=bc944b3 -->
     private async Task CalculateDelta_PressureObservation(BasePatientObservation obs)
     {
         var toSearchList = new List<string>();
@@ -1071,6 +1104,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation, expected to be a <see cref="PatientObservation"/> with <c>Name</c> <c>Daily_Balance</c>.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=e959764 body=2322c22 -->
     private async Task CalculateDaily_BalanceObservation(BasePatientObservation obs)
     {
         if (obs.Time.ToLocalTime().Hour == 8)
@@ -1098,6 +1132,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <see langword="true"/> when the observation has an <c>Expires</c> value and the current time
     /// is past the expiration instant; otherwise, <see langword="false"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=c7c5c82 body=4c62b98 -->
     private static bool CheckExpired(PatientObservation obs)
     {
         if (obs.Expires == null) return false;
diff --git a/adas-core.Application/Customizations/HUVH/UCIA/CalculatedObservations.cs b/adas-core.Application/Customizations/HUVH/UCIA/CalculatedObservations.cs
index 05682e36..3b5d6545 100644
--- a/adas-core.Application/Customizations/HUVH/UCIA/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/HUVH/UCIA/CalculatedObservations.cs
@@ -15,6 +15,7 @@ namespace adas_core.Application.Customizations.HUVH.UCIA;
 /// Represents a concrete implementation of the <see cref="ICalculatedObservations"/> interface,
 /// providing functionality to manage a collection of calculated observations.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private const string CodingSystem = "ADAS";
@@ -67,6 +68,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose active bolus should be calculated.</param>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the calculation logic has not yet been implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "The summary states that the method 'calculates the active bolus', but the body only throws NotImplementedException and performs no calculation; the <exception> tag mitigates this by noting the logic is not yet implemented." -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -79,6 +82,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to map; may be replaced with the result of the matched asynchronous calculation when applicable.</param>
     /// <param name="onlyByName">Indicates whether the mapping should be performed using only the observation's name.</param>
     /// <returns>The processed patient observation, potentially updated by the applicable calculation.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=mentions_removed_behavior
+    ///      "The <param name=\"onlyByName\"> describes behavior ('Indicates whether the mapping should be performed using only the observation's name'), but the parameter is never referenced anywhere in the method body; the dispatching always relies solely on the observation's name regardless of this flag." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         if (obs.Name is "PSI" or "RASS" or "TS") _ = CalculateOverSedation(obs);
@@ -106,6 +111,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment to map and update.</param>
     /// <returns>The patient treatment with its order control set according to the evaluated business rules.</returns>
+    /// <!-- aidoc:v1 sig=442a6e8 body=e1bed22 -->
     public async Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         var order = treatment.PlacerOrder?.EntityIdentifier; //aquí almacenamos el número de orden
@@ -130,6 +136,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A completed task containing the provided <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -141,6 +148,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="activeMedicines">The list of currently active medicines assigned to the patient.</param>
     /// <param name="patientId">The unique identifier of the patient whose medication categories will be checked.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims the method 'calculates medicine observations', but the implementation only invokes CheckMedicationCategories and returns Task.CompletedTask; no observation calculation is performed." -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         //Esto viene del schedulerService para chequear los medicamentos activos
@@ -154,6 +163,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments should be retrieved.</param>
     /// <returns>A collection of <see cref="PatientTreatment"/> objects representing the patient's active treatments.</returns>
+    /// <!-- aidoc:v1 sig=1c9e799 body=2a62eb7 -->
     public async Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         var activeTreatments = await _treatmentService.Value.GetActiveTreatmentsByPatient(id);
@@ -167,6 +177,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="diagnosis">The <see cref="PatientDiagnosis"/> to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping logic has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -179,6 +190,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="newObservation">The new patient observation whose timestamp should be adjusted to avoid time inconsistencies with prior observations.</param>
     /// <returns>The patient observation, with its <c>Time</c> adjusted when a time collision is detected, or the original observation when its name is null or empty.</returns>
+    /// <!-- aidoc:v1 sig=2b42b30 body=04118be -->
     public async Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         if (string.IsNullOrEmpty(newObservation.Name))
@@ -211,6 +223,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to pre-map before insertion.</param>
     /// <returns>A completed task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -222,6 +235,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to be returned as the mapping result.</param>
     /// <param name="alarmToInsert">The patient observation alarm intended to be associated with the observation.</param>
     /// <returns>A task containing the patient observation.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -235,6 +249,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="code">The optional alarm code categorizing the alarm, or null if no code is specified.</param>
     /// <returns>A task that represents the asynchronous alarm sending operation.</returns>
     /// <exception cref="NotImplementedException">Thrown to indicate that the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -246,6 +261,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation to evaluate for the rehabilitation alarm condition.</param>
     /// <returns>The observation with its status set to Alert when the six previous rehabilitation observations also fall within the 0-2 range; otherwise the observation is returned as-is.</returns>
+    /// <!-- aidoc:v1 sig=4d51d03 body=02faf98 -->
     private async Task<BasePatientObservation> CalculateRehabilitationAlarm(BasePatientObservation obs)
     {
         //En rojo si el grado es de 0 a 2 incluidos, por más de 7 días
@@ -270,6 +286,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The incoming base patient observation; only <see cref="PatientObservation"/> instances whose
     /// <c>Name</c> is "Diuresis" or "Weight" are processed, otherwise the method returns without changes.</param>
+    /// <!-- aidoc:v1 sig=a9e1f01 body=35f930e -->
     private async Task CalculateDiuresis(BasePatientObservation obs)
     {
         // Calculado como el sumatorio de la Diuresis de las últimas 6h 
@@ -350,6 +367,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates the ROX Index by dividing the SpO2/FiO2 ratio by the respiratory rate (FR) and persists the result as a new <c>Rox_Index</c> observation. The method supports both directions of the calculation: when the incoming observation is the SpO2/FiO2 ratio, it retrieves the latest FR, and vice versa. It silently returns if the observation is not a <c>PatientObservation</c>, if the observation name is not recognized, if the required paired observation cannot be found, if its value cannot be parsed, or if the FR value is zero (to avoid division by zero).
     /// </summary>
     /// <param name="obs">The base patient observation that triggers the ROX index calculation. Only observations named <c>SpO2_FiO2_Ratio</c> or <c>FR</c> are processed; any other type or name is ignored.</param>
+    /// <!-- aidoc:v1 sig=b303a48 body=1e098ad -->
     private async Task CalculateRoxIndex(BasePatientObservation obs)
     {
         // Cálculo dividiendo el ratio SpO2/FiO2 entre la FR
@@ -402,6 +420,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates the driving pressure for a patient as the difference between Pmeset and PEEP when a new Pmeset or PEEP observation is provided. Looks up the complementary observation to obtain the missing value, then creates and persists a "Driving_Pressure" observation. Returns early if the input is not a PatientObservation, the observation name is neither Pmeset nor PEEP, the complementary observation cannot be found, or its value cannot be parsed as an integer.
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation; expected to represent a Pmeset or PEEP measurement.</param>
+    /// <!-- aidoc:v1 sig=b3a7d66 body=19b29eb -->
     private async Task CalculateDrivingPressure(BasePatientObservation obs)
     {
         //Diferencia entre la Pmeset y la PEEP
@@ -458,6 +477,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The observation that triggered the evaluation; its value must be numeric and it is ignored if <paramref name="patientId"/> is provided (e.g., when invoked from a treatment context).</param>
     /// <param name="patientId">The patient identifier when the evaluation is triggered by a treatment event; when null, it is derived from <paramref name="obs"/>.</param>
+    /// <!-- aidoc:v1 sig=28b0d06 body=65c1f9b -->
     private async Task CalculateOverAnalgesia(BasePatientObservation? obs, ObjectId? patientId = null)
     {
         // Mandar observación 'SOBREANALGESIA'
@@ -537,6 +557,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation to evaluate and potentially transform.</param>
     /// <returns>A task that yields the observation, with its value normalized to "ECMO" when the original value is one of the recognized ECMO variants.</returns>
+    /// <!-- aidoc:v1 sig=5673ebb body=65604a9 -->
     private Task<BasePatientObservation> CalculateEcmoLocation(BasePatientObservation obs)
     {
         //Las opciones pueden ser VV, VA o ECMO.
@@ -564,6 +585,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// anything.
     /// </summary>
     /// <param name="obs">The incoming patient observation whose name drives the ventilation mode calculation.</param>
+    /// <!-- aidoc:v1 sig=dd5b490 body=76605b5 -->
     private async Task CalculateVentilationMode(BasePatientObservation obs)
     {
         //- Si llega valor de PI pero NO COMPL, el tipo de ventilación es VMNI
@@ -619,6 +641,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The triggering patient observation used to evaluate the sedation state. When provided, its name and value drive the initial validation; when null, the method relies on the <paramref name="patientId"/> parameter (typically from a treatment update).</param>
     /// <param name="patientId">Optional identifier of the patient to evaluate. If null, it is derived from <paramref name="obs"/>; otherwise, the method performs a full evaluation using the patient's recent observations.</param>
+    /// <!-- aidoc:v1 sig=0a9014e body=8a7e50f -->
     private async Task CalculateOverSedation(BasePatientObservation? obs, ObjectId? patientId = null)
     {
         //Mandar observación 'SOBRESEDACIÓN'
@@ -700,6 +723,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment to evaluate; may be null.</param>
     /// <returns><c>true</c> if the treatment has a start time and was started more than 24 hours ago; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee619c2 body=c94e0d4 -->
     private static bool ExceedsAnalgesiaThreshold(PatientTreatment? treatment)
     {
         // Perfusiones de morfina, remifentanilo o fentanilo sostenidas > 24 h
@@ -713,6 +737,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment to evaluate, or <c>null</c>.</param>
     /// <returns><c>true</c> if the treatment is not <c>null</c> and any requested medication exceeds its defined sedation threshold; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=5aa55d0 body=d2a9955 -->
     private static bool ExceedsSedationThreshold(PatientTreatment? treatment)
     {
         return (treatment != null &&
@@ -729,6 +754,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment whose patient is used to look up the list of active treatments to evaluate.</param>
     /// <returns>A task that returns the list of active patient treatments that were not discontinued.</returns>
+    /// <!-- aidoc:v1 sig=4f3a796 body=a702644 -->
     private async Task<List<PatientTreatment>> CheckExpiredPatientTreatments(PatientTreatment treatment)
     {
         //si el tratamiento ha expirado actualizamos el OrderControl a DC y devolvemos las que siguen activas
@@ -757,6 +783,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// further validation.
     /// </summary>
     /// <param name="treatment">The patient treatment whose requested medicines will be checked against the patient's active medicines.</param>
+    /// <!-- aidoc:v1 sig=e762e81 body=63b9252 -->
     private async Task CheckTreatmentMedicines(PatientTreatment treatment)
     {
         var newMedicines = (await Task.WhenAll(treatment.RequestedGiveCodes
@@ -785,6 +812,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose medication categories are being evaluated and linked to the created observations.</param>
     /// <param name="uniqueMedicines">The distinct list of medicines to be checked against the predefined category reference lists.</param>
+    /// <!-- aidoc:v1 sig=ef6fae4 body=be6580c -->
     private void CheckMedicationCategories(ObjectId patientId, List<Medicine> uniqueMedicines)
     {
         var medicationCategories = new Dictionary<string, List<string>?>
@@ -821,6 +849,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="medications">The collection of medications whose names will be stored as the observation values.</param>
     /// <param name="patientId">The identifier of the patient the observation belongs to.</param>
     /// <param name="obsName">The name used to group and look up the previous observation for the same concept.</param>
+    /// <!-- aidoc:v1 sig=c1a952c body=987bc59 -->
     private async Task CreateMedicationMultivalueObservation(IEnumerable<Medicine?> medications, ObjectId patientId,
             string obsName)
     {
diff --git a/adas-core.Application/Customizations/HUVH/UCIN/CalculatedObservations.cs b/adas-core.Application/Customizations/HUVH/UCIN/CalculatedObservations.cs
index 08a7bfc4..d1ecc5f7 100644
--- a/adas-core.Application/Customizations/HUVH/UCIN/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/HUVH/UCIN/CalculatedObservations.cs
@@ -16,6 +16,7 @@ namespace adas_core.Application.Customizations.HUVH.UCIN;
 /// Represents a concrete implementation of the <see cref="ICalculatedObservations"/> interface,
 /// providing a collection of calculated observation data.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private const string Spo2PreObservationName = "SpO2";
@@ -61,6 +62,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus is calculated.</param>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=7d38721 body=bfa6f2f -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -73,6 +75,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to be mapped, which may be transformed depending on its name.</param>
     /// <param name="onlyByName">Indicates whether the mapping should be performed using only the observation name.</param>
     /// <returns>The mapped patient observation, potentially enriched with computed values, wrapped in a task.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The 'onlyByName' parameter is documented as controlling whether 'the mapping should be performed using only the observation name,' but the parameter is never referenced in the method body, so passing a value for it has no effect on the mapping behavior." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         if (obs.Name is "Intervention_In" or "Intervention_Out") await CalculateInterventionMultiValueObservation(obs);
@@ -105,6 +109,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment to map, including its placer order, end time, and medicines.</param>
     /// <returns>The mapped <see cref="PatientTreatment"/> with its order control type and medicines updated.</returns>
+    /// <!-- aidoc:v1 sig=442a6e8 body=e1bed22 -->
     public async Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         var order = treatment.PlacerOrder?.EntityIdentifier; //aquí almacenamos el número de orden
@@ -129,6 +134,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A completed <see cref="Task{TResult}"/> containing the provided <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -140,6 +146,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="activeMedicines">The list of active medicines from which distinct medication names are extracted to build the observation value.</param>
     /// <param name="patientId">The identifier of the patient for whom the medication observation is calculated and stored.</param>
+    /// <!-- aidoc:v1 sig=299c0fe body=8145436 -->
     public async Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         var medicineObs = new PatientObservation
@@ -171,6 +178,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique <see cref="ObjectId"/> of the patient whose active treatments should be fetched.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IEnumerable{T}"/> of nullable <see cref="PatientTreatment"/> instances for the patient.</returns>
+    /// <!-- aidoc:v1 sig=1c9e799 body=2a62eb7 -->
     public async Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         var activeTreatments = await _treatmentService.Value.GetActiveTreatmentsByPatient(id);
@@ -184,6 +192,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="diagnosis">The source <see cref="PatientDiagnosis"/> instance to be mapped.</param>
     /// <returns>A <see cref="Task{PatientDiagnosis}"/> that represents the asynchronous mapping operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="T:System.NotImplementedException">Thrown when the method is invoked, as the mapping logic has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -195,6 +204,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="newObservation">The new patient observation whose time may be adjusted to follow the most recent observation for the same patient and measurement.</param>
     /// <returns>The patient observation with a corrected time if a time conflict was detected, or the original observation if no adjustment was needed or the name was invalid.</returns>
+    /// <!-- aidoc:v1 sig=2b42b30 body=04118be -->
     public async Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         if (string.IsNullOrEmpty(newObservation.Name))
@@ -227,6 +237,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to pre-map.</param>
     /// <returns>A task that represents the asynchronous operation, containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -238,6 +249,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation that the alarm is to be associated with.</param>
     /// <param name="alarmToInsert">The alarm intended to be inserted into the observation.</param>
     /// <returns>A task containing the patient observation, returned as-is.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -250,6 +262,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="name">The name associated with the alarm.</param>
     /// <param name="code">The optional alarm code categorizing the type of alarm to be sent.</param>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -261,6 +274,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Returns without creating a record when the observation is not a <see cref="PatientObservation"/> or when its name does not match any of the supported scales.
     /// </summary>
     /// <param name="obs">The source patient observation used to derive the pain scale; only instances of <see cref="PatientObservation"/> with a supported name (ALPS, NPASS_Sedation, NPASS_Analgesia) are processed.</param>
+    /// <!-- aidoc:v1 sig=f89cebc body=f5dfb0c -->
     private async Task CalculatePainScale(BasePatientObservation obs)
     {
         if (obs is not PatientObservation pobs) return;
@@ -314,6 +328,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The base patient observation to process.</param>
     /// <returns>The original <see cref="BasePatientObservation"/> if it is not a <see cref="PatientObservation"/>; otherwise, the <see cref="PatientObservation"/> with its value set to the locally formatted observation time.</returns>
+    /// <!-- aidoc:v1 sig=479318b body=e536a62 -->
     private static BasePatientObservation CalculateLastDefecationValue(BasePatientObservation obs)
     {
         if (obs is not PatientObservation pobs) return obs;
@@ -332,6 +347,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates and persists a multi-value observation by appending the current value to the existing list of values for the corresponding "Multivalue" observation. Expirates the previous multi-value observation before inserting the new one.
     /// </summary>
     /// <param name="obs">The base patient observation used to derive the multi-value observation; it must be a <see cref="PatientObservation"/> with a non-empty name and a string value.</param>
+    /// <!-- aidoc:v1 sig=d821a40 body=264c069 -->
     private async Task CalculateMultiValueObservation(BasePatientObservation obs)
     {
         //El valor de la observación es un array de strings
@@ -388,6 +404,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates and persists a multi-value observation that aggregates the active intervention groups (e.g., devices, routes) for a patient based on incoming "<c>_In</c>" and "<c>_Out</c>" observations. Handles the insertion of new groups (with special duplicate prevention for respiratory devices) and the removal of groups when a corresponding "Out" event is received, expiring the previous multi-value observation and inserting a new one when the resulting set is not empty.
     /// </summary>
     /// <param name="obs">The base patient observation that triggered the calculation; expected to be a <see cref="PatientObservation"/> with a non-empty name and a string value representing the intervention group.</param>
+    /// <!-- aidoc:v1 sig=25ac55d body=191bd88 -->
     private async Task CalculateInterventionMultiValueObservation(BasePatientObservation obs)
     {
         if (obs is not PatientObservation pobs || string.IsNullOrEmpty(obs.Name) ||
@@ -478,6 +495,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="valueObs">Observation text from which the leading token is taken as the candidate intervention code.</param>
     /// <param name="r">When the method returns true, contains the resolved intervention's type, name, and group; otherwise null.</param>
     /// <returns><c>true</c> if a matching intervention was found; <c>false</c> if the code is not numeric or the lookup yields no result.</returns>
+    /// <!-- aidoc:v1 sig=d3884cf body=1ea9ac7 -->
     private bool GetInterventionValue(string valueObs, out (string type, string Name, string Group)? r)
     {
         var code = valueObs.Split(" ")[0]; //
@@ -506,6 +524,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calcula la complejidad del paciente en función de las observaciones registradas.
     /// </summary>
     /// <param name="obs">Observación del paciente que se va a evaluar para recalcular su complejidad.</param>
+    /// <!-- aidoc:v1 sig=4545d3a body=a6e9e71 -->
     private async Task CalculateComplexity(BasePatientObservation obs)
     {
         var pobs = obs as PatientObservation;
@@ -575,6 +594,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="observationName">The name of the multivalue observation to look up and calculate complexity for.</param>
     /// <param name="observation">An optional pre-loaded observation that overrides the database lookup when supplied.</param>
     /// <returns>The aggregated complexity value for the observation, or 0 if no observation or values are found.</returns>
+    /// <!-- aidoc:v1 sig=cdba6ba body=3c7e7fd -->
     private async Task<int> CalculateMultivalueObservationComplexityValue(ObjectId patientId, string observationName,
             PatientObservation? observation = null)
     {
@@ -602,6 +622,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="patientId">The identifier of the patient whose newborn weight complexity is being calculated.</param>
     /// <param name="pobs">An optional patient observation to use instead of the latest stored one; if provided with "kg" units, its value is converted.</param>
     /// <returns>The calculated newborn weight complexity value, or 0 when no valid value is available.</returns>
+    /// <!-- aidoc:v1 sig=85b6f46 body=c89d98c -->
     private async Task<int> CalculateWeightNewBornValue(ObjectId patientId, PatientObservation? pobs = null)
     {
         var result =
@@ -644,6 +665,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The patient observation containing the weight value to parse and convert.</param>
     /// <returns>The patient observation with the value converted to grams, or the original observation if the value could not be parsed.</returns>
+    /// <!-- aidoc:v1 sig=2d84953 body=d947a19 -->
     private PatientObservation ParseWeight(PatientObservation obs)
     {
         if (!double.TryParse(obs.Value.ToString(), out var dValue))
@@ -664,6 +686,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="obs">The incoming patient observation (either a pre or post SpO2 measurement) used to drive the calculation and identify the counterpart observation.</param>
     /// <returns>A task that represents the asynchronous insert of the derived observations.</returns>
+    /// <!-- aidoc:v1 sig=7f9be58 body=e3f6858 -->
     private async Task CalculateSaturation_DiffObservation(BasePatientObservation obs)
     {
         var toSearchList = new List<string>();
@@ -726,6 +749,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment being evaluated, used to locate the existing record by its placer order entity identifier and to persist the updated state.</param>
     /// <returns>A task that yields the list of active patient treatments for the patient that are not the same placer order as the supplied treatment.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary claims to 'check for expired patient treatments' but the code calls GetActiveTreatmentsByPatient (active, not expired) and sets DC when t.EndTime > DateTime.UtcNow (future, not past), making the word 'expired' contradictory to the documented condition 'end time is in the future'." -->
     private async Task<List<PatientTreatment>> CheckExpiredPatientTreatments(PatientTreatment treatment)
     {
         //si el tratamiento ha expirado actualizamos el OrderControl a DC y devolvemos las que siguen activas
@@ -763,6 +788,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// medicines remain after filtering.
     /// </summary>
     /// <param name="treatment">The patient treatment whose requested give codes are inspected for medicines, nutrition items, and vasoactive drugs.</param>
+    /// <!-- aidoc:v1 sig=e762e81 body=6f65d8e -->
     private async Task CheckTreatmentMedicines(PatientTreatment treatment)
     {
         var newMedicines = new List<Medicine>();
@@ -825,6 +851,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="value">The feeding type value to record; if it contains "parenteral" (case-insensitive), the observation is stored as a parenteral entry.</param>
     /// <param name="patientId">The identifier of the patient to whom the observation belongs.</param>
+    /// <!-- aidoc:v1 sig=7b17fa3 body=af49d06 -->
     private async Task CreateNutritionObservation(string value, ObjectId patientId)
     {
         var nutritionObs = new PatientObservation
diff --git a/adas-core.Application/Customizations/NursePlan/CalculatedObservations.cs b/adas-core.Application/Customizations/NursePlan/CalculatedObservations.cs
index eae9f0ce..df245c4f 100644
--- a/adas-core.Application/Customizations/NursePlan/CalculatedObservations.cs
+++ b/adas-core.Application/Customizations/NursePlan/CalculatedObservations.cs
@@ -10,6 +10,7 @@ namespace adas_core.Application.Customizations.NursePlan;
 /// <summary>
 /// Provides calculated observations by leveraging services obtained from the injected service provider.
 /// </summary>
+/// <!-- aidoc:v1 sig=c3598e8 -->
 public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
 {
     private readonly Lazy<IObservationService> _observationService =
@@ -20,6 +21,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </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>
+    /// <!-- aidoc:v1 sig=7d38721 body=bfa6f2f -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -30,6 +32,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The PumpObservation to be mapped.</param>
     /// <returns>A task containing the mapped PumpObservation.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -42,6 +45,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=b7a50a4 body=bfa6f2f -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -53,6 +57,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -64,6 +69,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -75,6 +81,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=21d06c4 body=9f66f26 -->
     public Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         return Task.FromResult(obs)!;
@@ -85,6 +92,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="treatment">The patient treatment to map.</param>
     /// <returns>A task containing the mapped patient treatment.</returns>
+    /// <!-- aidoc:v1 sig=adce250 body=cf46cd2 -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         return Task.FromResult(treatment);
@@ -95,6 +103,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </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>
+    /// <!-- aidoc:v1 sig=8ddf601 body=ad326e6 -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         return Task.FromResult(diagnosis);
@@ -107,6 +116,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -118,6 +128,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <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>
+    /// <!-- aidoc:v1 sig=90426a4 body=6805ef5 -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         return Task.CompletedTask;
@@ -128,6 +139,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </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>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
diff --git a/adas-core.Application/Exceptions/APIRequestException.cs b/adas-core.Application/Exceptions/APIRequestException.cs
index cb73352d..745814be 100644
--- a/adas-core.Application/Exceptions/APIRequestException.cs
+++ b/adas-core.Application/Exceptions/APIRequestException.cs
@@ -4,4 +4,5 @@
 /// Represents errors that occur during API request processing, wrapping a descriptive message.
 /// </summary>
 /// <param name="message">The message that describes the error.</param>
+/// <!-- aidoc:v1 sig=fff099b -->
 public class ApiRequestException(string message) : Exception($"Api request exception: {message}");
\ No newline at end of file
diff --git a/adas-core.Application/Exceptions/BadRequestException.cs b/adas-core.Application/Exceptions/BadRequestException.cs
index 6142a5a2..fb2bd1d6 100644
--- a/adas-core.Application/Exceptions/BadRequestException.cs
+++ b/adas-core.Application/Exceptions/BadRequestException.cs
@@ -6,12 +6,14 @@ namespace adas_core.Application.Exceptions;
 /// Represents an exception that is thrown when a bad or invalid request is received.
 /// It serves as a specialized error type derived from the base <see cref="Exception"/> class for signaling client-side request failures.
 /// </summary>
+/// <!-- aidoc:v1 sig=aec5b9f -->
 public class BadRequestException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="BadRequestException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message defined in <see cref="HttpEnum.ErrorMessage"/> that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=2324fae body=4448e1d -->
     public BadRequestException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -20,6 +22,7 @@ public class BadRequestException : Exception
     /// Initializes a new instance of the <see cref="BadRequestException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=3d6c688 body=4448e1d -->
     public BadRequestException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/ConflictException.cs b/adas-core.Application/Exceptions/ConflictException.cs
index 0ca24e73..9228f7cf 100644
--- a/adas-core.Application/Exceptions/ConflictException.cs
+++ b/adas-core.Application/Exceptions/ConflictException.cs
@@ -5,12 +5,14 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents an exception that is thrown when a conflict is encountered, such as a resource state mismatch or a duplicate entry.
 /// </summary>
+/// <!-- aidoc:v1 sig=5cdb505 -->
 public class ConflictException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="ConflictException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message that describes the conflict.</param>
+    /// <!-- aidoc:v1 sig=d19960d body=4448e1d -->
     public ConflictException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -19,6 +21,7 @@ public class ConflictException : Exception
     /// Initializes a new instance of the <see cref="ConflictException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=6025bd5 body=4448e1d -->
     public ConflictException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/CustomArgumentException.cs b/adas-core.Application/Exceptions/CustomArgumentException.cs
index 874d2088..74fbafac 100644
--- a/adas-core.Application/Exceptions/CustomArgumentException.cs
+++ b/adas-core.Application/Exceptions/CustomArgumentException.cs
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception extends the base <see cref="Exception"/> class to provide a domain-specific error type for argument validation failures.
 /// </remarks>
+/// <!-- aidoc:v1 sig=434a4a5 -->
 public class CustomArgumentException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="CustomArgumentException"/> class with the specified error message.
     /// </summary>
     /// <param name="message">The error message from the <see cref="HttpEnum.ErrorMessage"/> enumeration.</param>
+    /// <!-- aidoc:v1 sig=9c6bb9a body=4448e1d -->
     public CustomArgumentException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -22,6 +24,7 @@ public class CustomArgumentException : Exception
     /// Initializes a new instance of the <see cref="CustomArgumentException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=cee336d body=4448e1d -->
     public CustomArgumentException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/ForbbidenException.cs b/adas-core.Application/Exceptions/ForbbidenException.cs
index d27d1cdb..85953e58 100644
--- a/adas-core.Application/Exceptions/ForbbidenException.cs
+++ b/adas-core.Application/Exceptions/ForbbidenException.cs
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception is intended to signal that a requested action violates access rules or restrictions, allowing callers to handle forbidden scenarios distinctly from other error conditions.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2024892 -->
 public class ForbbidenException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="ForbbidenException"/> class with a specified error message from the <see cref="HttpEnum.ErrorMessage"/> enumeration.
     /// </summary>
     /// <param name="message">The <see cref="HttpEnum.ErrorMessage"/> enumeration value whose integer representation is used as the exception message.</param>
+    /// <!-- aidoc:v1 sig=75787d6 body=4448e1d -->
     public ForbbidenException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -22,6 +24,7 @@ public class ForbbidenException : Exception
     /// Initializes a new instance of the <see cref="ForbbidenException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=545f359 body=4448e1d -->
     public ForbbidenException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/InvalidFormatException.cs b/adas-core.Application/Exceptions/InvalidFormatException.cs
index 2896a24c..56965c83 100644
--- a/adas-core.Application/Exceptions/InvalidFormatException.cs
+++ b/adas-core.Application/Exceptions/InvalidFormatException.cs
@@ -5,12 +5,15 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents the exception that is thrown when data is encountered in a format that is not valid or expected.
 /// </summary>
+/// <!-- aidoc:v1 sig=e46b8ff -->
 public class InvalidFormatException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="InvalidFormatException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The parameter is of type HttpEnum.ErrorMessage (an enum), not an error message string. It is documented as 'The error message that describes the reason for the exception', which mischaracterizes its role." -->
     public InvalidFormatException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -19,6 +22,7 @@ public class InvalidFormatException : Exception
     /// Initializes a new instance of the <see cref="InvalidFormatException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The error message that describes the reason for the exception.</param>
+    /// <!-- aidoc:v1 sig=8a27f52 body=4448e1d -->
     public InvalidFormatException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/NotFoundException.cs b/adas-core.Application/Exceptions/NotFoundException.cs
index 6fe77ef3..5cae3504 100644
--- a/adas-core.Application/Exceptions/NotFoundException.cs
+++ b/adas-core.Application/Exceptions/NotFoundException.cs
@@ -5,11 +5,13 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Represents an exception that is thrown when a requested resource or item cannot be found.
 /// </summary>
+/// <!-- aidoc:v1 sig=f498fe7 -->
 public class NotFoundException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="NotFoundException"/> class.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b8adfe9 body=4448e1d -->
     public NotFoundException()
     {
     }
@@ -18,6 +20,7 @@ public class NotFoundException : Exception
     /// Initializes a new instance of the <see cref="NotFoundException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=0fdd1b4 body=4448e1d -->
     public NotFoundException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -26,6 +29,7 @@ public class NotFoundException : Exception
     /// Initializes a new instance of the <see cref="NotFoundException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=63e1946 body=4448e1d -->
     public NotFoundException(string message) : base(message)
     {
     }    
diff --git a/adas-core.Application/Exceptions/TokenException.cs b/adas-core.Application/Exceptions/TokenException.cs
index 508c7925..467b09c3 100644
--- a/adas-core.Application/Exceptions/TokenException.cs
+++ b/adas-core.Application/Exceptions/TokenException.cs
@@ -4,4 +4,5 @@
 /// Represents an exception that is thrown when a token-related error occurs.
 /// </summary>
 /// <param name="message">The message that describes the error.</param>
+/// <!-- aidoc:v1 sig=d6b0f80 -->
 public class TokenException(string message) : Exception(message);
\ No newline at end of file
diff --git a/adas-core.Application/Exceptions/UnauthorizedException.cs b/adas-core.Application/Exceptions/UnauthorizedException.cs
index 4dbbfeb0..96a39d83 100644
--- a/adas-core.Application/Exceptions/UnauthorizedException.cs
+++ b/adas-core.Application/Exceptions/UnauthorizedException.cs
@@ -5,12 +5,14 @@ namespace adas_core.Application.Exceptions;
 /// <summary>
 /// Exception thrown when a user lacks authorization to perform an operation.
 /// </summary>
+/// <!-- aidoc:v1 sig=c33e8e4 -->
 public class UnauthorizedException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="UnauthorizedException"/> class.
     /// </summary>
     /// <param name="message">The error message associated with the exception.</param>
+    /// <!-- aidoc:v1 sig=0488051 body=4448e1d -->
     public UnauthorizedException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -19,6 +21,7 @@ public class UnauthorizedException : Exception
     /// Initializes a new instance of the <see cref="UnauthorizedException"/> class.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=f0581f2 body=4448e1d -->
     public UnauthorizedException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Exceptions/UnprocessableEntityException.cs b/adas-core.Application/Exceptions/UnprocessableEntityException.cs
index 7cdefa2e..f8a87eba 100644
--- a/adas-core.Application/Exceptions/UnprocessableEntityException.cs
+++ b/adas-core.Application/Exceptions/UnprocessableEntityException.cs
@@ -8,12 +8,14 @@ namespace adas_core.Application.Exceptions;
 /// <remarks>
 /// This exception is typically used to signal that a request or entity was understood but could not be processed, similar to the semantics of an HTTP 422 (Unprocessable Entity) response.
 /// </remarks>
+/// <!-- aidoc:v1 sig=70bdc1a -->
 public class UnprocessableEntityException : Exception
 {
     /// <summary>
     /// Initializes a new instance of the <see cref="UnprocessableEntityException"/> class with a specified error message enum.
     /// </summary>
     /// <param name="message">The error message enum containing the error code.</param>
+    /// <!-- aidoc:v1 sig=c2da948 body=4448e1d -->
     public UnprocessableEntityException(HttpEnum.ErrorMessage message) : base(((int)message).ToString())
     {
     }
@@ -22,6 +24,7 @@ public class UnprocessableEntityException : Exception
     /// Initializes a new instance of the <see cref="UnprocessableEntityException"/> class with a specified error message.
     /// </summary>
     /// <param name="message">The message that describes the error.</param>
+    /// <!-- aidoc:v1 sig=cc0f943 body=4448e1d -->
     public UnprocessableEntityException(string message) : base(message)
     {
     }
diff --git a/adas-core.Application/Providers/AdasProvider.cs b/adas-core.Application/Providers/AdasProvider.cs
index 05b38503..c5a5c712 100644
--- a/adas-core.Application/Providers/AdasProvider.cs
+++ b/adas-core.Application/Providers/AdasProvider.cs
@@ -29,6 +29,7 @@ public class AdasProvider(IOptions<ProvidersSettings> providerSettings, IHttpCli
     /// </summary>
     /// <param name="patient">The patient for whom observations are being calculated.</param>
     /// <returns>A task that represents the asynchronous operation, returning a list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=ab999e4 body=ac14195 -->
     public override async Task<List<PatientObservation>> GetObservations(Patient patient)
     {
         var calculatedObservations = new List<PatientObservation>();
@@ -88,6 +89,7 @@ public class AdasProvider(IOptions<ProvidersSettings> providerSettings, IHttpCli
     /// </summary>
     /// <param name="medicationPredict">The list of ADAS medication prediction results to be serialized. Only the first five entries are included.</param>
     /// <returns>A string containing the selected medication prediction entries joined by the "^" delimiter.</returns>
+    /// <!-- aidoc:v1 sig=4474eb5 body=ea7295b -->
     private static string ParseAdasMedicationsToMedicationObservation(
             List<ResultModelPredictMedicationAdas> medicationPredict)
     {
@@ -100,6 +102,7 @@ public class AdasProvider(IOptions<ProvidersSettings> providerSettings, IHttpCli
     /// </summary>
     /// <param name="patientNumber">The unique identifier of the patient whose ADAS stay prediction is being requested.</param>
     /// <returns>A task containing the deserialized <see cref="ResultModelPredictOfStayAdas"/> result on success, or null if the patient number is null, the response is unsuccessful, or the call throws.</returns>
+    /// <!-- aidoc:v1 sig=7c8fb5e body=5aa481c -->
     private async Task<ResultModelPredictOfStayAdas?> GetPredictOfStay(string? patientNumber)
     {
         if (patientNumber == null)
@@ -140,6 +143,7 @@ public class AdasProvider(IOptions<ProvidersSettings> providerSettings, IHttpCli
     /// </summary>
     /// <param name="patientNumber">The unique identifier of the patient whose ADAS medication predictions are being retrieved.</param>
     /// <returns>A task containing a list of <see cref="ResultModelPredictMedicationAdas"/> with the predicted medication data, or null if the request fails or the patient number is null.</returns>
+    /// <!-- aidoc:v1 sig=1381cb8 body=f17df11 -->
     private async Task<List<ResultModelPredictMedicationAdas>?> GetPredictMedications(string? patientNumber)
     {
         if (patientNumber == null)
@@ -176,6 +180,7 @@ public class AdasProvider(IOptions<ProvidersSettings> providerSettings, IHttpCli
     /// Creates a new <see cref="HttpClient"/> instance and configures it with the configured base address URL.
     /// </summary>
     /// <returns>An <see cref="HttpClient"/> with its <see cref="HttpClient.BaseAddress"/> set to the configured <c>Url</c>.</returns>
+    /// <!-- aidoc:v1 sig=12d10b8 body=3c7c671 -->
     private HttpClient GetClient()
     {
         var client = HttpClientFactory.CreateClient();
diff --git a/adas-core.Application/Providers/BaseProvider.cs b/adas-core.Application/Providers/BaseProvider.cs
index b11ae8c8..19a4e195 100644
--- a/adas-core.Application/Providers/BaseProvider.cs
+++ b/adas-core.Application/Providers/BaseProvider.cs
@@ -21,5 +21,6 @@ public abstract class BaseProvider(
     /// </summary>
     /// <param name="patient">The patient whose observations are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservation"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=a880577 -->
     public abstract Task<List<PatientObservation>> GetObservations(Patient patient);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IAdmissionRepository.cs b/adas-core.Application/Repositories/Interfaces/IAdmissionRepository.cs
index 06d21b4b..28213a24 100644
--- a/adas-core.Application/Repositories/Interfaces/IAdmissionRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IAdmissionRepository.cs
@@ -12,12 +12,14 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// Deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
 
     /// <summary>
     /// Updates the specified admission record asynchronously.
     /// </summary>
     /// <param name="admission">The admission entity containing the updated information.</param>
+    /// <!-- aidoc:v1 sig=1180a0b -->
     Task Update(Admission admission);
 
     /// <summary>
@@ -25,6 +27,7 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="id">The unique identifier of the entity whose location is to be updated.</param>
     /// <param name="newLocation">The identifier of the new location to assign to the entity.</param>
+    /// <!-- aidoc:v1 sig=a4e527f -->
     Task UpdateLocation(ObjectId id, ObjectId newLocation);
 
     /// <summary>
@@ -32,12 +35,14 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="id">The unique identifier of the patient to update.</param>
     /// <param name="patient">The patient object containing the updated information to apply.</param>
+    /// <!-- aidoc:v1 sig=afe7c06 -->
     Task UpdatePatient(ObjectId id, Person patient);
 
     /// <summary>
     /// Asynchronously retrieves all admission records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{Admission}"/> with all available admissions.</returns>
+    /// <!-- aidoc:v1 sig=7eecf14 -->
     Task<IEnumerable<Admission>> FindAll();
 
     /// <summary>
@@ -45,6 +50,7 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the <see cref="Admission"/> to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Admission"/>, or <c>null</c> if no admission exists with the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=1fe8488 -->
     Task<Admission?> FindById(ObjectId id);
 
     /// <summary>
@@ -52,6 +58,7 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="nhc">The NHC (clinical history number) used to look up the admission.</param>
     /// <returns>A task that resolves to the matching <see cref="Admission"/>, or <c>null</c> if no admission is found for the given NHC.</returns>
+    /// <!-- aidoc:v1 sig=c8b26b9 -->
     Task<Admission?> FindByNhc(string nhc);
 
     //Task<IEnumerable<Admission>?> FindByUnit(string unit);
@@ -61,6 +68,7 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="location">The patient location used to filter and find the relevant admissions.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of admissions matching the given location.</returns>
+    /// <!-- aidoc:v1 sig=c1ce2c3 -->
     Task<List<Admission>> FindByLocation(PatientLocation location);
 
     /// <summary>
@@ -68,12 +76,14 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// </summary>
     /// <param name="origin">The origin value used to filter the admissions.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of matching admissions, or <c>null</c> if no admissions are found for the given origin.</returns>
+    /// <!-- aidoc:v1 sig=ed6ddde -->
     Task<IEnumerable<Admission>?> FindByOrigin(string origin);
     /// <summary>
     /// Asynchronously inserts a new <see cref="Admission"/> record into the data store and returns the resulting entity.
     /// </summary>
     /// <param name="origin">The <see cref="Admission"/> entity to be inserted.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing the inserted <see cref="Admission"/>, or <c>null</c> if no result is returned.</returns>
+    /// <!-- aidoc:v1 sig=2b0177a -->
     Task<Admission?> InsertOneAsyncAndReturn(Admission origin);
     /// <summary>
     /// Searches for an admission matching the specified patient number and unit, returning a distinct result.
@@ -81,30 +91,35 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// <param name="patientNumber">The patient's identifier used to locate the admission.</param>
     /// <param name="unitId">The unique identifier of the unit to filter the search.</param>
     /// <returns>A <see cref="Admission"/> if a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=fb125ed -->
     Task<Admission?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId);
     /// <summary>
     /// Asynchronously retrieves a list of admissions associated with the specified unit, excluding Point of Care (PoC) entries.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose admissions are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Admission"/> records linked to the given unit, with PoC entries excluded.</returns>
+    /// <!-- aidoc:v1 sig=609220d -->
     Task<List<Admission>> GetAdmissionByUnitIdWithOutPoC(ObjectId unitId);
     /// <summary>
     /// Retrieves a list of admissions associated with the specified point of care identifier.
     /// </summary>
     /// <param name="pocId">The unique identifier of the point of care used to filter the admissions.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of admissions matching the specified point of care identifier.</returns>
+    /// <!-- aidoc:v1 sig=3e416fe -->
     Task<List<Admission>> FindByPointOfCareId(ObjectId pocId);
     /// <summary>
     /// Asynchronously retrieves a list of admissions associated with the specified unit identifiers.
     /// </summary>
     /// <param name="unitIds">The list of unit identifiers used to look up the corresponding admissions.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of admissions matching the provided unit identifiers.</returns>
+    /// <!-- aidoc:v1 sig=050b604 -->
     Task<List<Admission>> FindByUnitIds(List<ObjectId> unitIds);
     /// <summary>
     /// Asynchronously counts the number of records associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit used to filter the records.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the count of matching records.</returns>
+    /// <!-- aidoc:v1 sig=e0dfc62 -->
     Task<long> CountByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -114,6 +129,7 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// <param name="opt">The data transfer object containing the new master list option values to apply.</param>
     /// <param name="typeName">The name of the option type to be updated.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of admissions affected by the update.</returns>
+    /// <!-- aidoc:v1 sig=fc94c14 -->
     Task<IEnumerable<Admission>> UpdateMasterListOption(List<ObjectId> unitIds, UpdateOptionMasterListDto opt,
             string typeName);
 
@@ -124,11 +140,13 @@ public interface IAdmissionRepository : IMongoRepository<Admission>
     /// <param name="opt">The option to be removed from the master list.</param>
     /// <param name="typeName">The name of the type associated with the master list option.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of <see cref="Admission"/> records affected by the deletion.</returns>
+    /// <!-- aidoc:v1 sig=248078c -->
     Task<IEnumerable<Admission>> DeleteMasterListOption(List<ObjectId> unitIds, OptionList opt, string typeName);
     /// <summary>
     /// Asynchronously deletes admissions associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose admissions will be deleted.</param>
     /// <returns>A task that represents the asynchronous operation, containing a value indicating the result of the deletion.</returns>
+    /// <!-- aidoc:v1 sig=cb6488e -->
     Task<bool> DeleteAdmissionsByUnitId(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IAlarmRepository.cs b/adas-core.Application/Repositories/Interfaces/IAlarmRepository.cs
index d73bd766..b1790a79 100644
--- a/adas-core.Application/Repositories/Interfaces/IAlarmRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IAlarmRepository.cs
@@ -13,6 +13,7 @@ public interface IAlarmRepository : IMongoRepository<PatientObservationAlarm>
     /// <param name="patientId">The unique identifier of the patient whose last observations should be aggregated.</param>
     /// <param name="filterObservations">An optional list of fields used to restrict which observation types are included in the aggregation; when null, all available observations are considered.</param>
     /// <returns>A task that resolves to the list of aggregated <see cref="PatientObservationAlarm"/> entries representing the patient's latest observations.</returns>
+    /// <!-- aidoc:v1 sig=b862090 -->
     Task<List<PatientObservationAlarm>> AggregatedPatientLastObservationsByField(ObjectId patientId,
             List<Field>? filterObservations = null);
 
@@ -23,6 +24,7 @@ public interface IAlarmRepository : IMongoRepository<PatientObservationAlarm>
     /// <param name="filterObservations">An optional list of fields used to restrict which observations are considered. If null, no field-based filtering is applied.</param>
     /// <param name="configAlarm">The list of configuration observation definitions used to build and aggregate the resulting alarms.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of aggregated <see cref="PatientObservationAlarm"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=e1ec5ad -->
     Task<List<PatientObservationAlarm>> AggregatedPatientNotExpiredObservationsByField(ObjectId patientId,
             List<Field>? filterObservations, List<ConfigObservation> configAlarm);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IAppointmentArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IAppointmentArchiveRepository.cs
index 22cc6be8..7631c986 100644
--- a/adas-core.Application/Repositories/Interfaces/IAppointmentArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IAppointmentArchiveRepository.cs
@@ -8,16 +8,19 @@ public interface IAppointmentArchiveRepository
     /// Asynchronously inserts a single patient appointment into the underlying data store.
     /// </summary>
     /// <param name="patientAppointment">The patient appointment entity to be persisted.</param>
+    /// <!-- aidoc:v1 sig=1116668 -->
     Task InsertOneAsync(PatientAppointment patientAppointment);
     /// <summary>
     /// Asynchronously deletes records that have a date earlier than the specified cutoff date.
     /// </summary>
     /// <param name="date">The cutoff date; records dated before this value will be removed.</param>
+    /// <!-- aidoc:v1 sig=350661d -->
     Task DeleteBeforeDate(DateTime date);
     /// <summary>
     /// Inserts a batch of patient appointments asynchronously, typically as part of a bulk import or synchronization process.
     /// </summary>
     /// <param name="appointment">The collection of patient appointments to be inserted.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing a long value that represents the result of the batch insertion.</returns>
+    /// <!-- aidoc:v1 sig=5df04bf -->
     Task<long> InsertBatch(IEnumerable<PatientAppointment> appointment);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IAppointmentRepository.cs b/adas-core.Application/Repositories/Interfaces/IAppointmentRepository.cs
index 226dd1ed..c035f932 100644
--- a/adas-core.Application/Repositories/Interfaces/IAppointmentRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IAppointmentRepository.cs
@@ -12,17 +12,20 @@ public interface IAppointmentRepository : IMongoRepository<PatientAppointment>
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose appointments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> objects for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=44280ba -->
     Task<List<PatientAppointment>> GetByPatient(ObjectId patientId);
 
     /// <summary>
     /// Asynchronously inserts a single patient appointment record into the data store.
     /// </summary>
     /// <param name="appointment">The patient appointment entity to be inserted.</param>
+    /// <!-- aidoc:v1 sig=43c09a3 -->
     new Task InsertOneAsync(PatientAppointment appointment);
     /// <summary>
     /// Updates an existing patient appointment asynchronously.
     /// </summary>
     /// <param name="appointment">The patient appointment containing the updated information.</param>
+    /// <!-- aidoc:v1 sig=75991de -->
     Task Update(PatientAppointment appointment);
     /// <summary>
     /// Updates the <see cref="ObjectId"/> field identified by <paramref name="nameId"/> across many records, replacing the existing value <paramref name="oldId"/> with the new value <paramref name="id"/>.
@@ -30,22 +33,26 @@ public interface IAppointmentRepository : IMongoRepository<PatientAppointment>
     /// <param name="nameId">The name of the field that contains the <see cref="ObjectId"/> to update.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign to matching records.</param>
     /// <param name="oldId">The current <see cref="ObjectId"/> value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
     /// <summary>
     /// Asynchronously deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The ObjectId of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=9f8dfa3 -->
     new Task DeleteAsync(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a cursor of <see cref="PatientAppointment"/> records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique <see cref="ObjectId"/> of the patient whose appointments are being queried.</param>
     /// <returns>A <see cref="Task{IAsyncCursor{PatientAppointment}}"/> that yields the matching patient appointments; the cursor may be empty if no appointments are found for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=2d5cd9f -->
     Task<IAsyncCursor<PatientAppointment>> FindByPatientIdAsync(ObjectId patientId);
     /// <summary>
     /// Asynchronously deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique ObjectId of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=1e79565 -->
     Task DeleteByPatientId(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves a <see cref="PatientAppointment"/> matching the specified patient identifier and visit number.
@@ -53,6 +60,7 @@ public interface IAppointmentRepository : IMongoRepository<PatientAppointment>
     /// <param name="patientId">The unique identifier of the patient whose appointment should be located.</param>
     /// <param name="visitNumber">The visit number used to identify the specific appointment for the patient.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="PatientAppointment"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=60947c5 -->
     Task<PatientAppointment?> FindByPatientAndVisitNumber(ObjectId patientId, string visitNumber);
     /// <summary>
     /// Asynchronously retrieves a patient appointment matching the specified patient identifier and appointment reason.
@@ -61,17 +69,20 @@ public interface IAppointmentRepository : IMongoRepository<PatientAppointment>
     /// <param name="patientId">The unique identifier of the patient whose appointment should be located.</param>
     /// <param name="appointmentReason">The appointment reason used to filter the lookup, or <c>null</c> to match any reason.</param>
     /// <returns>A <see cref="Task{PatientAppointment}"/> that resolves to the matching <see cref="PatientAppointment"/>, or <c>null</c> if none exists.</returns>
+    /// <!-- aidoc:v1 sig=e3683e7 -->
     Task<PatientAppointment?> FindByPatientAndReason(ObjectId patientId, string? appointmentReason);
     /// <summary>
     /// Retrieves a list of patient appointments associated with the specified location.
     /// </summary>
     /// <param name="location">The patient location used to filter and retrieve matching appointments.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> entries for the given location.</returns>
+    /// <!-- aidoc:v1 sig=8d1c435 -->
     Task<List<PatientAppointment>> FindByLocation(PatientLocation location);
     /// <summary>
     /// Asynchronously retrieves the list of patient appointments associated with the specified point of care.
     /// </summary>
     /// <param name="poc">The point of care used to filter the patient appointments.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of patient appointments for the given point of care.</returns>
+    /// <!-- aidoc:v1 sig=2cf49d9 -->
     Task<List<PatientAppointment>> FindByPoC(PointOfCare poc);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IArchivePatientCarePlanRepository.cs b/adas-core.Application/Repositories/Interfaces/IArchivePatientCarePlanRepository.cs
index 1bad7c2c..b88bf1de 100644
--- a/adas-core.Application/Repositories/Interfaces/IArchivePatientCarePlanRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IArchivePatientCarePlanRepository.cs
@@ -10,23 +10,27 @@ public interface IArchivePatientCarePlanRepository : IMongoRepository<PatientCar
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans should be retrieved.</param>
     /// <returns>A task that returns a list of <see cref="PatientCarePlan"/> objects for the given patient, or <c>null</c> when no care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=5c4d553 -->
     Task<List<PatientCarePlan>?> FindByPatientId(ObjectId patientId);
     /// <summary>
     /// Retrieves the list of patient care plans associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientCarePlan"/> for the given patient, or <c>null</c> if no care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=6cb79cd -->
     Task<List<PatientCarePlan>?> FindByPatientId(string patientId);
     /// <summary>
     /// Asynchronously retrieves the list of care plans associated with the specified patient number, returning <c>null</c> when no matching care plans are found.
     /// </summary>
     /// <param name="patientId">The patient number used to look up the associated care plans.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> entries for the patient, or <c>null</c> if none exist.</returns>
+    /// <!-- aidoc:v1 sig=e73ac89 -->
     Task<List<PatientCarePlan>?> FindByPatientNumber(string patientId);
     /// <summary>
     /// Asynchronously retrieves all patient care plans from the data store.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="PatientCarePlan"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=83af170 -->
     Task<List<PatientCarePlan>> FindAll();
 
     /// <summary>
@@ -36,6 +40,7 @@ public interface IArchivePatientCarePlanRepository : IMongoRepository<PatientCar
     /// <param name="oldPatientPatientId">An optional legacy patient ID string used as an additional lookup criterion.</param>
     /// <param name="oldPatientPatientNumber">An optional legacy patient number string used as an additional lookup criterion.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing a nullable list of <see cref="PatientCarePlan"/> records, or <c>null</c> if no matching care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=d0b7192 -->
     Task<List<PatientCarePlan>?> FindByIds(ObjectId oldPatientId, string? oldPatientPatientId,
             string? oldPatientPatientNumber);
 
@@ -43,5 +48,6 @@ public interface IArchivePatientCarePlanRepository : IMongoRepository<PatientCar
     /// Asynchronously inserts a collection of patient care plans into the underlying data store.
     /// </summary>
     /// <param name="patientCarePla">The list of <see cref="PatientCarePlan"/> records to be inserted.</param>
+    /// <!-- aidoc:v1 sig=fea7cc8 -->
     Task InsertManyAsync(List<PatientCarePlan> patientCarePla);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IAuthorityRepository.cs b/adas-core.Application/Repositories/Interfaces/IAuthorityRepository.cs
index 90b7cf3e..82b5511a 100644
--- a/adas-core.Application/Repositories/Interfaces/IAuthorityRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IAuthorityRepository.cs
@@ -10,46 +10,54 @@ public interface IAuthorityRepository : IMongoRepository<Authorization>
     /// </summary>
     /// <param name="authId">The unique identifier of the authorization to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="Authorization"/> that matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=65df479 -->
     public Task<Authorization> GetById(ObjectId authId);
     /// <summary>
     /// Creates a new authority assignment for the specified user with the given role name.
     /// </summary>
     /// <param name="roleName">The name of the role to assign as the new authority.</param>
     /// <param name="userId">The identifier of the user to whom the authority will be assigned.</param>
+    /// <!-- aidoc:v1 sig=45c3591 -->
     void CreateNewAuthority(string roleName, ObjectId userId);
     /// <summary>
     /// Retrieves the list of authorizations (authorities/permissions) associated with the specified user.
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose authorities are being requested.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the list of <see cref="Authorization"/> entries assigned to the user.</returns>
+    /// <!-- aidoc:v1 sig=1476a1a -->
     public Task<List<Authorization>> GetUserAuthorities(ObjectId userId);
     /// <summary>
     /// Asynchronously retrieves all available authorizations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="Authorization"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=dd351e0 -->
     public Task<List<Authorization>> GetAllAuthorities();
     /// <summary>
     /// Asynchronously deletes all authorities associated with the specified user.
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose authorities will be removed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if authorities were deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=f6a59e6 -->
     public Task<bool> DeleteAllAuthoritiesByUser(ObjectId userId);
     /// <summary>
     /// Deletes all authorities associated with the specified unit.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose authorities should be removed.</param>
     /// <returns>A task that resolves to <c>true</c> if the authorities were successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1f7fa45 -->
     Task<bool> DeleteAllAuthoritiesByUnit(ObjectId unitId);
     /// <summary>
     /// Deletes all authorities associated with the specified display identifier.
     /// </summary>
     /// <param name="displayId">The identifier of the display whose related authorities should be removed.</param>
     /// <returns>A task that resolves to a boolean indicating the outcome of the deletion operation.</returns>
+    /// <!-- aidoc:v1 sig=f1cb547 -->
     Task<bool> DeleteAllAuthoritiesByDisplay(ObjectId displayId);
     /// <summary>
     /// Retrieves a list of authorizations associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose authorizations are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects matching the provided unit identifier.</returns>
+    /// <!-- aidoc:v1 sig=82be9e3 -->
     Task<List<Authorization>> GetByUnitId(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/ICameraRepository.cs b/adas-core.Application/Repositories/Interfaces/ICameraRepository.cs
index aa044190..c85db4dc 100644
--- a/adas-core.Application/Repositories/Interfaces/ICameraRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/ICameraRepository.cs
@@ -12,30 +12,35 @@ public interface ICameraRepository : IMongoRepository<Camera>
     /// </summary>
     /// <param name="cameraId">The unique identifier of the camera to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Camera"/>, or <c>null</c> if no camera is found with the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=fbf139f -->
     Task<Camera?> GetById(ObjectId cameraId);
     /// <summary>
     /// Asynchronously retrieves a camera by its name, returning <c>null</c> if no matching camera is found.
     /// </summary>
     /// <param name="name">The name of the camera to look up.</param>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the matching <see cref="Camera"/>, or <c>null</c> if no camera with the specified name exists.</returns>
+    /// <!-- aidoc:v1 sig=6a4834c -->
     Task<Camera?> GetByName(string name);
     /// <summary>
     /// Retrieves the list of <see cref="Camera"/> objects associated with the specified configuration relays.
     /// </summary>
     /// <param name="configurationRelayList">The list of <see cref="ObjectId"/> values identifying the configuration relays whose cameras should be returned.</param>
     /// <returns>A <see cref="List{Camera}"/> containing the cameras linked to the provided configuration relays; returns an empty list when no matching cameras are found.</returns>
+    /// <!-- aidoc:v1 sig=4523ee6 -->
     List<Camera> GetCameraInList(List<ObjectId> configurationRelayList);
     /// <summary>
     /// Retrieves a paginated, fluent queryable collection of cameras based on the supplied pagination filter.
     /// </summary>
     /// <param name="request">The pagination filter containing the page number and page size used to page the camera results.</param>
     /// <returns>An <see cref="IFindFluent{Camera, Camera}"/> representing the paged query of cameras.</returns>
+    /// <!-- aidoc:v1 sig=f9540cc -->
     IFindFluent<Camera, Camera> GetPaginatedCameras(PaginationFilter request);
     /// <summary>
     /// Inserts a new camera record into the data store and returns the persisted entity, or <c>null</c> if the camera could not be inserted.
     /// </summary>
     /// <param name="camera">The <see cref="Camera"/> instance containing the data to be inserted.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the inserted <see cref="Camera"/>, or <c>null</c> when the insertion is not performed.</returns>
+    /// <!-- aidoc:v1 sig=1baa756 -->
     Task<Camera?> InsertOneCamera(Camera camera);
     /// <summary>
     /// Asynchronously updates an existing camera identified by the specified object identifier.
@@ -43,11 +48,13 @@ public interface ICameraRepository : IMongoRepository<Camera>
     /// <param name="objectId">The unique identifier of the camera to update.</param>
     /// <param name="camera">The camera object containing the updated information.</param>
     /// <returns>A task that represents the asynchronous update operation. The task result contains the updated <see cref="Camera"/>, or <c>null</c> if no camera with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=85a936b -->
     Task<Camera?> UpdateCameraAsync(ObjectId objectId, Camera camera);
     /// <summary>
     /// Asynchronously searches for cameras whose name matches the specified text.
     /// </summary>
     /// <param name="textToSearch">The text used to filter cameras by name.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Camera"/> objects matching the search criteria.</returns>
+    /// <!-- aidoc:v1 sig=b1c98a2 -->
     Task<List<Camera>> GetSearchByNameCameras(string textToSearch);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IConfigObservationRepository.cs b/adas-core.Application/Repositories/Interfaces/IConfigObservationRepository.cs
index 95101666..2c3c60c2 100644
--- a/adas-core.Application/Repositories/Interfaces/IConfigObservationRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IConfigObservationRepository.cs
@@ -11,6 +11,7 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation to locate.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ConfigObservation"/> if found, or <c>null</c> if no observation matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=1d4cd90 -->
     Task<ConfigObservation?> FindById(ObjectId id);
 
     /// <summary>
@@ -19,6 +20,7 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// </summary>
     /// <param name="configObservation">The configuration observation containing the updated values to persist.</param>
     /// <returns>A task that resolves to the updated <see cref="ConfigObservation"/>, or <c>null</c> if the observation does not exist.</returns>
+    /// <!-- aidoc:v1 sig=58909e3 -->
     Task<ConfigObservation?> Update(ConfigObservation configObservation);
 
     /// <summary>
@@ -26,18 +28,21 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result contains the deleted configuration observation, or <c>null</c> if no observation with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=ae833b9 -->
     Task<ConfigObservation?> Delete(ObjectId id);
 
     /// <summary>
     /// Asynchronously retrieves all available identifiers, returning them as a list of <see cref="ObjectId"/> values.
     /// </summary>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing a list of all <see cref="ObjectId"/> instances found.</returns>
+    /// <!-- aidoc:v1 sig=2b29fbf -->
     Task<List<ObjectId>> FindAllIds();
 
     /// <summary>
     /// Retrieves all configuration observations available in the system.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="ConfigObservation"/> instances.</returns>
+    /// <!-- aidoc:v1 sig=4aacd78 -->
     Task<ICollection<ConfigObservation>> FindAll();
 
     /// <summary>
@@ -45,28 +50,33 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// </summary>
     /// <param name="id">The identifier used to look up the configuration names.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of configuration names.</returns>
+    /// <!-- aidoc:v1 sig=e20bf71 -->
     Task<List<string>> GetConfigNames(string id);
     /// <summary>
     /// Asynchronously retrieves the list of available configuration names.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing the list of configuration names.</returns>
+    /// <!-- aidoc:v1 sig=45b7793 -->
     Task<List<string>> GetConfigNames();
     /// <summary>
     /// Asynchronously retrieves the total count of items.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing the total count as a <see cref="long"/>.</returns>
+    /// <!-- aidoc:v1 sig=25063b3 -->
     Task<long> Count();
     /// <summary>
     /// Retrieves a paginated collection of configuration observations based on the specified filter.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the page size, page number, and any additional criteria used to retrieve the observations.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="ConfigObservation"/> items that match the pagination criteria.</returns>
+    /// <!-- aidoc:v1 sig=6003918 -->
     Task<ICollection<ConfigObservation>> GetPaginatedItems(PaginationFilter filter);
     /// <summary>
     /// Retrieves a configuration observation that matches the specified name.
     /// </summary>
     /// <param name="name">The name of the configuration observation to find.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching ConfigObservation if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=8fdec03 -->
     Task<ConfigObservation?> FindByName(string name);
     /// <summary>
     /// Retrieves a <see cref="ConfigObservation"/> matching the specified coding system and code.
@@ -74,18 +84,21 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// <param name="codingSystem">The coding system identifier used to look up the configuration observation.</param>
     /// <param name="code">The code value within the specified coding system used to look up the configuration observation.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigObservation"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=8d72db9 -->
     Task<ConfigObservation?> GetByCodeSysAndCode(string? codingSystem, string? code);
     /// <summary>
     /// Asynchronously inserts the specified configuration observation item and returns the persisted entity.
     /// </summary>
     /// <param name="configObservationItem">The configuration observation to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing the inserted <see cref="ConfigObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=6699d0c -->
     Task<ConfigObservation> InsertOneAsyncAndReturn(ConfigObservation configObservationItem);
     /// <summary>
     /// Asynchronously retrieves all <see cref="ConfigObservation"/> records matching the specified name.
     /// </summary>
     /// <param name="name">The name used to look up the configuration observations.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="ConfigObservation"/> objects matching the given name, or an empty list if none are found.</returns>
+    /// <!-- aidoc:v1 sig=4081b04 -->
     Task<List<ConfigObservation>> FindAllByName(string name);
 
     /// <summary>
@@ -96,6 +109,7 @@ public interface IConfigObservationRepository : IMongoRepository<ConfigObservati
     /// <param name="name">The name used to look up the configuration observation item, or <see langword="null"/> if not specified.</param>
     /// <param name="originalName">The original name used to look up the configuration observation item, or <see langword="null"/> if not specified.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigObservation"/> item, or <see langword="null"/> if no item matches the specified criteria.</returns>
+    /// <!-- aidoc:v1 sig=2c7c75f -->
     Task<ConfigObservation?> GetSingleConfigObservationItem(string? code, string? codingSystem, string? name,
             string? originalName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IConfigPumpsRepository.cs b/adas-core.Application/Repositories/Interfaces/IConfigPumpsRepository.cs
index c061ed21..5dfd2dc5 100644
--- a/adas-core.Application/Repositories/Interfaces/IConfigPumpsRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IConfigPumpsRepository.cs
@@ -10,11 +10,13 @@ public interface IConfigPumpsRepository : IMongoRepository<ConfigPumps>
     /// </summary>
     /// <param name="id">The unique identifier of the configuration to look up.</param>
     /// <returns>A task that yields the matching ConfigPumps instance, or null if no configuration is found for the specified id.</returns>
+    /// <!-- aidoc:v1 sig=394bbbd -->
     Task<ConfigPumps?> FindById(string id);
     /// <summary>
     /// Retrieves all pump configurations asynchronously.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ConfigPumps"/> if found, or <c>null</c> if no configurations are available.</returns>
+    /// <!-- aidoc:v1 sig=d87df07 -->
     Task<List<ConfigPumps>?> GetAllConfigs();
 
     /// <summary>
@@ -22,11 +24,13 @@ public interface IConfigPumpsRepository : IMongoRepository<ConfigPumps>
     /// </summary>
     /// <param name="config">The pumps configuration to be persisted.</param>
     /// <returns>A task that resolves to the updated <see cref="ConfigPumps"/> instance, or <see langword="null"/> if the configuration could not be found.</returns>
+    /// <!-- aidoc:v1 sig=4bd2a84 -->
     Task<ConfigPumps?> UpdateConfig(ConfigPumps config);
     /// <summary>
     /// Asynchronously deletes the specified pump configuration.
     /// </summary>
     /// <param name="config">The pump configuration to delete.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the configuration was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=2400a34 -->
     Task<bool> DeleteConfig(ConfigPumps config);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IConfigUnitsRepository.cs b/adas-core.Application/Repositories/Interfaces/IConfigUnitsRepository.cs
index c9d86c0a..dc6aabc5 100644
--- a/adas-core.Application/Repositories/Interfaces/IConfigUnitsRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IConfigUnitsRepository.cs
@@ -10,5 +10,6 @@ public interface IConfigUnitsRepository : IMongoRepository<ConfigUnits>
     /// </summary>
     /// <param name="id">The unique identifier of the configuration unit to look up.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="ConfigUnits"/> or <c>null</c> if no entity is found.</returns>
+    /// <!-- aidoc:v1 sig=6cffb54 -->
     Task<ConfigUnits?> FindById(string id);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDeviceRepository.cs b/adas-core.Application/Repositories/Interfaces/IDeviceRepository.cs
index de13c229..bda99a8f 100644
--- a/adas-core.Application/Repositories/Interfaces/IDeviceRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDeviceRepository.cs
@@ -11,24 +11,28 @@ public interface IDeviceRepository : IMongoRepository<Device>
     /// </summary>
     /// <param name="deviceDtoMacAddr">The MAC address used to look up the device.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="Device"/> or null when no device is found.</returns>
+    /// <!-- aidoc:v1 sig=c887f30 -->
     Task<Device?> FindByMacAddr(string deviceDtoMacAddr);
     /// <summary>
     /// Finds and returns the device matching the specified serial number, or <c>null</c> if no matching device is found.
     /// </summary>
     /// <param name="deviceDtoSerialNumber">The serial number used to look up the device.</param>
     /// <returns>A <see cref="Device"/> instance if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=2bc0894 -->
     Task<Device?> FindBySerialNumber(string deviceDtoSerialNumber);
     /// <summary>
     /// Asynchronously finds a device by its unique identifier (UUID) and returns the matching device, or null if no device is found.
     /// </summary>
     /// <param name="deviceDtoUuid">The UUID string used to look up the device.</param>
     /// <returns>A <see cref="Task{Device}"/> that resolves to the matching <see cref="Device"/>, or null when no device matches the provided UUID.</returns>
+    /// <!-- aidoc:v1 sig=d0a473e -->
     Task<Device?> FindByUuid(string deviceDtoUuid);
     /// <summary>
     /// Retrieves a device by its unique key identifier.
     /// </summary>
     /// <param name="deviceDtoKey">The key identifier of the device to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Device"/> if a matching device is found, or <c>null</c> if no device corresponds to the specified key.</returns>
+    /// <!-- aidoc:v1 sig=f846571 -->
     Task<Device?> FindByKey(string deviceDtoKey);
     /// <summary>
     /// Updates the statistics of an existing device identified by the specified identifier.
@@ -36,5 +40,6 @@ public interface IDeviceRepository : IMongoRepository<Device>
     /// <param name="id">The unique identifier of the device whose statistics will be updated.</param>
     /// <param name="deviceExist">The device data transfer object representing the existing device to be updated.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=d3d9745 -->
     Task UpdateDeviceStats(ObjectId id,DeviceDto deviceExist);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDiagnosisArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IDiagnosisArchiveRepository.cs
index c8f94d33..c3a545e8 100644
--- a/adas-core.Application/Repositories/Interfaces/IDiagnosisArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDiagnosisArchiveRepository.cs
@@ -9,16 +9,19 @@ public interface IDiagnosisArchiveRepository
     /// </summary>
     /// <param name="patientDiagnosis">The patient diagnosis entity to be persisted.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=2e5fbfe -->
     Task InsertOneAsync(PatientDiagnosis patientDiagnosis);
     /// <summary>
     /// Asynchronously deletes items that occurred before the specified cutoff date.
     /// </summary>
     /// <param name="date">The cutoff date; items dated prior to this value will be deleted.</param>
+    /// <!-- aidoc:v1 sig=350661d -->
     Task DeleteBeforeDate(DateTime date);
     /// <summary>
     /// Inserts a batch of patient diagnosis records into the data store.
     /// </summary>
     /// <param name="diagnosis">The collection of <see cref="PatientDiagnosis"/> entities to insert.</param>
     /// <returns>A <see cref="Task{TResult}"/> representing the asynchronous operation, containing the result of the batch insertion.</returns>
+    /// <!-- aidoc:v1 sig=ad12097 -->
     Task<long> InsertBatch(IEnumerable<PatientDiagnosis> diagnosis);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDiagnosisRepository.cs b/adas-core.Application/Repositories/Interfaces/IDiagnosisRepository.cs
index 27dd3065..f21b6b3b 100644
--- a/adas-core.Application/Repositories/Interfaces/IDiagnosisRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDiagnosisRepository.cs
@@ -11,17 +11,20 @@ public interface IDiagnosisRepository : IMongoRepository<PatientDiagnosis>
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose diagnoses are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientDiagnosis"/> objects for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=5d93ade -->
     Task<List<PatientDiagnosis>> GetByPatient(ObjectId patientId);
 
     /// <summary>
     /// Asynchronously inserts a single patient diagnosis record into the data store.
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis entity to insert.</param>
+    /// <!-- aidoc:v1 sig=f01c3df -->
     new Task InsertOneAsync(PatientDiagnosis diagnosis);
     /// <summary>
     /// Asynchronously deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=9f8dfa3 -->
     new Task DeleteAsync(ObjectId id);
     /// <summary>
     /// Updates many records by replacing the existing <see cref="ObjectId"/> identified by <paramref name="oldId"/> with the new <see cref="ObjectId"/> <paramref name="id"/>, scoped to the specified <paramref name="nameId"/>.
@@ -29,17 +32,20 @@ public interface IDiagnosisRepository : IMongoRepository<PatientDiagnosis>
     /// <param name="nameId">The identifier of the field or collection on which the update is performed.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
     /// <summary>
     /// Asynchronously finds all patient diagnoses associated with the specified patient identifier, returning a cursor to iterate over the matching documents.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose diagnoses should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an IAsyncCursor of PatientDiagnosis that yields the matching documents.</returns>
+    /// <!-- aidoc:v1 sig=61b15db -->
     Task<IAsyncCursor<PatientDiagnosis>> FindByPatientIdAsync(ObjectId patientId);
     /// <summary>
     /// Asynchronously deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique <see cref="ObjectId"/> of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=1e79565 -->
     Task DeleteByPatientId(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves the <see cref="PatientDiagnosis"/> associated with the specified patient, diagnosis code, and coding system.
@@ -49,5 +55,6 @@ public interface IDiagnosisRepository : IMongoRepository<PatientDiagnosis>
     /// <param name="diagnosisCode">The diagnosis code to match. May be null.</param>
     /// <param name="codingSystem">The coding system of the diagnosis code (for example, ICD-10 or SNOMED). May be null.</param>
     /// <returns>A task that resolves to the matching <see cref="PatientDiagnosis"/>, or null if no diagnosis matches the given criteria.</returns>
+    /// <!-- aidoc:v1 sig=56ca4f7 -->
     Task<PatientDiagnosis?> FindByPatientIdAndCode(ObjectId patientId, string? diagnosisCode, string? codingSystem);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDischargeRepository.cs b/adas-core.Application/Repositories/Interfaces/IDischargeRepository.cs
index 6779e7f1..902553df 100644
--- a/adas-core.Application/Repositories/Interfaces/IDischargeRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDischargeRepository.cs
@@ -12,12 +12,14 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// Deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
 
     /// <summary>
     /// Asynchronously updates an existing discharge record.
     /// </summary>
     /// <param name="discharge">The discharge entity containing the updated information to be persisted.</param>
+    /// <!-- aidoc:v1 sig=2ea41b6 -->
     Task Update(Discharge discharge);
 
     /// <summary>
@@ -25,6 +27,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="id">The unique identifier of the object whose unit will be updated.</param>
     /// <param name="unit">The new unit value to assign to the object.</param>
+    /// <!-- aidoc:v1 sig=e209b77 -->
     Task UpdateUnit(ObjectId id, string unit);
 
     /// <summary>
@@ -32,12 +35,14 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="id">The unique identifier of the patient to update.</param>
     /// <param name="patient">The patient object containing the updated information to be applied to the existing record.</param>
+    /// <!-- aidoc:v1 sig=7d687d6 -->
     Task UpdatePatient(ObjectId id, Patient patient);
 
     /// <summary>
     /// Asynchronously retrieves all discharge records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of all <see cref="Discharge"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=f3aa8a3 -->
     Task<IEnumerable<Discharge>> FindAll();
 
     /// <summary>
@@ -45,6 +50,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="id">The unique identifier of the discharge record to find.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Discharge"/> if a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=cbc5b2e -->
     Task<Discharge?> FindById(ObjectId id);
 
     /// <summary>
@@ -52,6 +58,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="unit">The unit identifier used to filter the discharge records.</param>
     /// <returns>A task that represents the asynchronous operation. The result is an <see cref="IEnumerable{T}"/> of <see cref="Discharge"/> containing the matching records, or <see langword="null"/> when no records are found.</returns>
+    /// <!-- aidoc:v1 sig=43b920c -->
     Task<IEnumerable<Discharge>?> FindByUnit(string unit);
 
     /// <summary>
@@ -59,6 +66,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="unitId">The ObjectId of the unit whose associated records will be counted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the count of records for the specified unit.</returns>
+    /// <!-- aidoc:v1 sig=e0dfc62 -->
     Task<long> CountByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -66,6 +74,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="destination">The destination identifier used to look up matching discharge records.</param>
     /// <returns>A task that yields an <see cref="IEnumerable{Discharge}"/> of matching discharge records, or <c>null</c> if no records are found for the given destination.</returns>
+    /// <!-- aidoc:v1 sig=9eb7a6c -->
     Task<IEnumerable<Discharge>?> FindByDestination(string destination);
 
     /// <summary>
@@ -74,12 +83,14 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="service">The service identifier used to look up matching discharge records.</param>
     /// <returns>A task that represents the asynchronous operation. The result is an <see cref="IEnumerable{T}"/> of <see cref="Discharge"/> entries for the specified service, or <c>null</c> if none are found.</returns>
+    /// <!-- aidoc:v1 sig=24de989 -->
     Task<IEnumerable<Discharge>?> FindByService(string service);
     /// <summary>
     /// Asynchronously retrieves a collection of <see cref="Discharge"/> records associated with the specified unit identifiers.
     /// </summary>
     /// <param name="unitIds">The collection of unit identifiers used to look up the matching discharges. May be <c>null</c>.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="Discharge"/> objects, or <c>null</c> when no matching discharges are available.</returns>
+    /// <!-- aidoc:v1 sig=29c7c15 -->
     Task<IEnumerable<Discharge>?> GetDischargesByUnitIds(IEnumerable<ObjectId>? unitIds);
 
 
@@ -88,12 +99,14 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="location">The patient location used to look up the associated discharge record.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Discharge"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=8da289b -->
     Task<Discharge?> GetDischargeByLocation(PatientLocation location);
     /// <summary>
     /// Retrieves the discharge record associated with the specified patient identifier, or <see langword="null"/> if no discharge exists for that patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose discharge record is being requested.</param>
     /// <returns>A <see cref="Task{Discharge}"/> that resolves to the matching <see cref="Discharge"/>, or <see langword="null"/> when no record is found.</returns>
+    /// <!-- aidoc:v1 sig=201be7c -->
     Task<Discharge?> GetByPatientId(ObjectId patientId);
 
     /// <summary>
@@ -101,12 +114,14 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// </summary>
     /// <param name="pocId">The point-of-care identifier used to look up the associated discharges.</param>
     /// <returns>A task that returns an <see cref="IEnumerable{T}"/> of <see cref="Discharge"/> records, or <see langword="null"/> if no discharges are found for the given point-of-care identifier.</returns>
+    /// <!-- aidoc:v1 sig=dd4639c -->
     Task<IEnumerable<Discharge>?> FindByPoCId(ObjectId pocId);
     /// <summary>
     /// Retrieves the discharge associated with the specified point of care identifier.
     /// </summary>
     /// <param name="poc">The identifier of the point of care used to look up the discharge.</param>
     /// <returns>A task that returns the matching <see cref="Discharge"/> if one is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=5c6cb4c -->
     Task<Discharge?> GetDischargeByPointOfCareId(ObjectId poc);
 
     /// <summary>
@@ -116,6 +131,7 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// <param name="opt">The update option master list data transfer object containing the new option details.</param>
     /// <param name="typeName">The name of the type to which the master list option applies.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of updated Discharge records.</returns>
+    /// <!-- aidoc:v1 sig=03334e1 -->
     Task<IEnumerable<Discharge>> UpdateMasterListOption(List<ObjectId> unitIds, UpdateOptionMasterListDto opt,
             string typeName);
 
@@ -126,11 +142,13 @@ public interface IDischargeRepository : IMongoRepository<Discharge>
     /// <param name="opt">The master list option to delete.</param>
     /// <param name="typeName">The type name associated with the option.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of <see cref="Discharge"/> objects resulting from the deletion.</returns>
+    /// <!-- aidoc:v1 sig=5d8584d -->
     Task<IEnumerable<Discharge>> DeleteMasterListOption(List<ObjectId> unitIds, OptionList opt, string typeName);
     /// <summary>
     /// Deletes the entity associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose associated record should be removed.</param>
     /// <returns>A task that represents the asynchronous operation. The result is <c>true</c> if a record was deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=7032be4 -->
     Task<bool> DeleteByUnitId(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDisplayCardConfigRepository.cs b/adas-core.Application/Repositories/Interfaces/IDisplayCardConfigRepository.cs
index 195c4052..ca1313c4 100644
--- a/adas-core.Application/Repositories/Interfaces/IDisplayCardConfigRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDisplayCardConfigRepository.cs
@@ -10,29 +10,34 @@ public interface IDisplayCardConfigRepository : IMongoRepository<CardConfig>
     /// Asynchronously retrieves all available card configurations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="CardConfig"/> items.</returns>
+    /// <!-- aidoc:v1 sig=7c46da8 -->
     Task<List<CardConfig>> GetAll();
     /// <summary>
     /// Retrieves a card configuration by its unique identifier, returning <c>null</c> when no matching configuration is found.
     /// </summary>
     /// <param name="configId">The unique identifier of the card configuration to look up.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="CardConfig"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=10fd753 -->
     Task<CardConfig?> GetById(ObjectId configId);
     /// <summary>
     /// Asynchronously inserts a new <see cref="CardConfig"/> into the data store and returns the persisted record, which may include database-generated values.
     /// </summary>
     /// <param name="config">The <see cref="CardConfig"/> instance to insert.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the inserted <see cref="CardConfig"/>, or <c>null</c> if the record could not be persisted.</returns>
+    /// <!-- aidoc:v1 sig=ba19ca3 -->
     Task<CardConfig?> InsertOneAsyncAndReturn(CardConfig config);
     /// <summary>
     /// Updates a single <see cref="CardConfig"/> record based on the provided configuration.
     /// </summary>
     /// <param name="config">The <see cref="CardConfig"/> to update. May be <c>null</c> to indicate no update payload was provided.</param>
     /// <returns>A task that resolves to an <see cref="UpdateResponse{T}"/> containing the updated <see cref="CardConfig"/>, or <c>null</c> if no matching record was found.</returns>
+    /// <!-- aidoc:v1 sig=1c7016f -->
     Task<UpdateResponse<CardConfig?>> UpdateOne(CardConfig? config);
     /// <summary>
     /// Deletes a single card configuration identified by the specified identifier, returning the removed configuration when found.
     /// </summary>
     /// <param name="configId">The unique identifier of the card configuration to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result contains the deleted <see cref="CardConfig"/>, or <c>null</c> if no configuration with the specified identifier exists.</returns>
+    /// <!-- aidoc:v1 sig=06062fe -->
     Task<CardConfig?> DeleteOne(ObjectId configId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDisplayChartConfigRepository.cs b/adas-core.Application/Repositories/Interfaces/IDisplayChartConfigRepository.cs
index ae7d01df..486579bf 100644
--- a/adas-core.Application/Repositories/Interfaces/IDisplayChartConfigRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDisplayChartConfigRepository.cs
@@ -10,29 +10,34 @@ public interface IDisplayChartConfigRepository : IMongoRepository<ChartConfig>
     /// Asynchronously retrieves all chart configurations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ChartConfig"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=69d54d6 -->
     Task<List<ChartConfig>> GetAll();
     /// <summary>
     /// Asynchronously retrieves a <see cref="ChartConfig"/> by its unique identifier, returning null if no matching configuration is found.
     /// </summary>
     /// <param name="configId">The identifier of the chart configuration to look up.</param>
     /// <returns>A task that yields the matching <see cref="ChartConfig"/>, or null when no configuration exists for the specified id.</returns>
+    /// <!-- aidoc:v1 sig=0f66137 -->
     Task<ChartConfig?> GetById(ObjectId configId);
     /// <summary>
     /// Asynchronously inserts a new chart configuration into the data store and returns the persisted entity, which may be null if no record is produced.
     /// </summary>
     /// <param name="config">The chart configuration to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing the inserted <see cref="ChartConfig"/> or null when the operation yields no result.</returns>
+    /// <!-- aidoc:v1 sig=ff330b7 -->
     Task<ChartConfig?> InsertOneAsyncAndReturn(ChartConfig config);
     /// <summary>
     /// Updates a single chart configuration and returns the operation result wrapped in an update response.
     /// </summary>
     /// <param name="config">The chart configuration to update. May be null.</param>
     /// <returns>A task containing the update response with the updated chart configuration, which may be null.</returns>
+    /// <!-- aidoc:v1 sig=5d67082 -->
     Task<UpdateResponse<ChartConfig?>> UpdateOne(ChartConfig? config);
     /// <summary>
     /// Deletes a single chart configuration identified by its unique identifier. Returns the deleted configuration, or <see langword="null"/> if no matching configuration was found.
     /// </summary>
     /// <param name="configId">The unique identifier of the chart configuration to delete.</param>
     /// <returns>A task that resolves to the deleted <see cref="ChartConfig"/>, or <see langword="null"/> if no configuration with the specified id exists.</returns>
+    /// <!-- aidoc:v1 sig=7690568 -->
     Task<ChartConfig?> DeleteOne(ObjectId configId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDisplayConfigRepository.cs b/adas-core.Application/Repositories/Interfaces/IDisplayConfigRepository.cs
index 9ec0d716..02c68294 100644
--- a/adas-core.Application/Repositories/Interfaces/IDisplayConfigRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDisplayConfigRepository.cs
@@ -15,18 +15,21 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// Asynchronously retrieves all display configurations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="DisplayConfig"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=0650c45 -->
     Task<List<DisplayConfig>> GetAll();
     /// <summary>
     /// Retrieves a paginated set of <see cref="DisplayConfig"/> entities projected as <see cref="DisplayConfigSummary"/>.
     /// </summary>
     /// <param name="request">The pagination filter applied to the query.</param>
     /// <returns>An <see cref="IFindFluent{TDocument, TProjection}"/> that produces the paginated <see cref="DisplayConfigSummary"/> results.</returns>
+    /// <!-- aidoc:v1 sig=5cd5916 -->
     IFindFluent<DisplayConfig, DisplayConfigSummary> GetAllPaginated(PaginationFilter request);
     /// <summary>
     /// Asynchronously retrieves the list of display configurations that match the specified display type.
     /// </summary>
     /// <param name="type">The display type used to filter the returned display configurations.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="DisplayConfig"/> entries matching the specified type.</returns>
+    /// <!-- aidoc:v1 sig=2f20b32 -->
     Task<List<DisplayConfig>> GetByType(DisplayConfigEnums.DisplayType type);
     /// <summary>
     /// Retrieves a <see cref="DisplayConfig"/> entity by its unique identifier asynchronously.
@@ -34,6 +37,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// </summary>
     /// <param name="id">The unique identifier of the display configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="DisplayConfig"/> if found, or <c>null</c> if no matching record exists.</returns>
+    /// <!-- aidoc:v1 sig=938724e -->
     Task<DisplayConfig?> GetById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves the default <see cref="DisplayConfig"/> for the specified display type.
@@ -41,12 +45,14 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// </summary>
     /// <param name="type">The display type used to look up the default configuration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the default <see cref="DisplayConfig"/> for the given type, or <c>null</c> if no default exists.</returns>
+    /// <!-- aidoc:v1 sig=691190f -->
     Task<DisplayConfig?> GetDefault(DisplayConfigEnums.DisplayType type);
     /// <summary>
     /// Asynchronously inserts a new <see cref="DisplayConfig"/> and returns the persisted entity, typically populated with any server-generated values.
     /// </summary>
     /// <param name="config">The <see cref="DisplayConfig"/> to insert.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the inserted <see cref="DisplayConfig"/>, or <see langword="null"/> when no result is returned.</returns>
+    /// <!-- aidoc:v1 sig=93c23df -->
     Task<DisplayConfig?> InsertOneAsyncAndReturn(DisplayConfig config);
     /// <summary>
     /// Updates the smart display configuration identified by the specified ID with the provided new configuration.
@@ -54,6 +60,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="displayConfigId">The unique identifier of the smart display configuration to update.</param>
     /// <param name="newDisplayConfig">The new smart display configuration to apply.</param>
     /// <returns>A task that represents the asynchronous update operation, containing the updated smart display configuration, or null if no configuration with the given ID was found.</returns>
+    /// <!-- aidoc:v1 sig=5c60d9b -->
     Task<SmartDisplay?> UpdateSmartDisplay(ObjectId displayConfigId, SmartDisplay? newDisplayConfig);
 
     /// <summary>
@@ -63,6 +70,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="newDisplayConfig">The new display nurse configuration data, or null if not provided.</param>
     /// <param name="nurseObs">The list of nurse observations to associate with the configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="DisplayNurse"/> or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=317dda3 -->
     Task<DisplayNurse?> UpdateDisplayNurse(ObjectId displayConfigId, DisplayNurseDto? newDisplayConfig,
             List<string> nurseObs);
 
@@ -73,6 +81,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="unitId">The identifier of the unit whose default display configuration is being requested.</param>
     /// <param name="displayType">The display type used to filter the configuration lookup.</param>
     /// <returns>A task containing the matching <see cref="DisplayConfig"/>, or <c>null</c> if no default configuration is found for the given unit and display type.</returns>
+    /// <!-- aidoc:v1 sig=c1f0b10 -->
     Task<DisplayConfig?> GetDefaultByUnitIdAndType(ObjectId unitId, DisplayConfigEnums.DisplayType displayType);
     /// <summary>
     /// Asynchronously updates the color configuration for the specified config display entry.
@@ -80,6 +89,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The unique identifier of the config display whose color configuration will be updated.</param>
     /// <param name="colorConfig">The new color configuration to apply to the config display.</param>
     /// <returns>A task that resolves to <c>true</c> if the color configuration was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=603eb76 -->
     Task<bool> UpdateConfigColor(ObjectId objectIdConfigDisplay, ColorConfig colorConfig);
     /// <summary>
     /// Updates the home banner configuration identified by the specified config display ObjectId with the provided list of banner items.
@@ -87,6 +97,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The ObjectId of the config display whose home banner set will be updated.</param>
     /// <param name="bannerItems">The collection of banner items to apply to the home banner set.</param>
     /// <returns>A task that resolves to <c>true</c> if the home banner set was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a96cf5b -->
     Task<bool> UpdateSetHomeBanner(ObjectId objectIdConfigDisplay, List<BannerItem> bannerItems);
     /// <summary>
     /// Updates the base display configuration identified by the specified object identifier with the provided configuration data.
@@ -94,6 +105,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The object identifier of the configuration display entry to update.</param>
     /// <param name="baseConfig">The new base display configuration values to apply.</param>
     /// <returns>A task that represents the asynchronous operation. The result is <c>true</c> if the update succeeded; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=93fc07a -->
     Task<bool> UpdateBaseConfig(ObjectId objectIdConfigDisplay, DisplayConfig baseConfig);
     /// <summary>
     /// Updates an existing header configuration associated with the specified configuration display identifier.
@@ -101,6 +113,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The unique identifier of the configuration display whose header configuration is being updated.</param>
     /// <param name="headerConfig">The new header configuration values to apply.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the header configuration was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=979f311 -->
     Task<bool> UpdateHeaderConfig(ObjectId objectIdConfigDisplay, HeaderConfig headerConfig);
     /// <summary>
     /// Updates the hospital name associated with the specified display configuration.
@@ -108,6 +121,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The identifier of the display configuration to update.</param>
     /// <param name="name">The new hospital name to apply to the display configuration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update succeeded; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=519223f -->
     Task<bool> UpdateDisplayConfigHospitalName(ObjectId objectIdConfigDisplay, string name);
     /// <summary>
     /// Updates the field list associated with the specified configuration display.
@@ -115,29 +129,34 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="objectIdConfigDisplay">The identifier of the configuration display whose field list is being updated.</param>
     /// <param name="fields">The list of fields to apply to the configuration display.</param>
     /// <returns>A task that resolves to <c>true</c> if the field list was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=62079e1 -->
     Task<bool> UpdateFieldList(ObjectId objectIdConfigDisplay, List<Field> fields);
     /// <summary>
     /// Deletes a display configuration identified by the specified object ID.
     /// </summary>
     /// <param name="objectIdConfigDisplay">The object ID of the display configuration to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result contains the deleted display configuration, or null if no configuration was found with the specified ID.</returns>
+    /// <!-- aidoc:v1 sig=f04bba3 -->
     Task<DisplayConfig?> DeleteDisplayConfig(ObjectId objectIdConfigDisplay);
     /// <summary>
     /// Retrieves all display configurations in a compact, minimal representation.
     /// </summary>
     /// <returns>A task containing a list of <see cref="DisplayConfigMinimalResponse"/> objects representing the display configurations.</returns>
+    /// <!-- aidoc:v1 sig=784f030 -->
     Task<List<DisplayConfigMinimalResponse>> GetAllCompact();
     /// <summary>
     /// Retrieves all object identifiers associated with the specified card configuration identifier.
     /// </summary>
     /// <param name="cardConfigId">The identifier of the card configuration whose related objects should be returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ObjectId"/> values linked to the given card configuration.</returns>
+    /// <!-- aidoc:v1 sig=4ca5d28 -->
     Task<List<ObjectId>> GetAllByCardConfigId(ObjectId cardConfigId);
     /// <summary>
     /// Asynchronously retrieves a list of ObjectIds associated with the specified card configuration that are marked as rotating.
     /// </summary>
     /// <param name="cardConfigId">The ObjectId of the card configuration used to filter the results.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of ObjectIds that match the given card configuration and rotating criteria.</returns>
+    /// <!-- aidoc:v1 sig=59e1336 -->
     Task<List<ObjectId>> GetAllByCardConfigIdAndRotating(ObjectId cardConfigId);
     /// <summary>
     /// Updates the card configuration identifier for the specified display configuration and result.
@@ -145,6 +164,7 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="displayConfigId">The identifier of the display configuration whose card configuration will be updated.</param>
     /// <param name="resultId">The identifier of the result associated with the card configuration update.</param>
     /// <returns>A task that resolves to <c>true</c> if the update succeeded; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=5aceeda -->
     Task<bool> UpdateCardConfigId(ObjectId? displayConfigId, ObjectId? resultId);
     /// <summary>
     /// Adds a chart identifier to the specified display configuration asynchronously.
@@ -152,18 +172,21 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="displayConfigId">The identifier of the display configuration to which the chart ID will be added, or <c>null</c> when no specific configuration is targeted.</param>
     /// <param name="newChartIdToAdd">The chart identifier to add.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the chart identifier was successfully added; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e08471c -->
     Task<bool> AddChartId(ObjectId? displayConfigId, ObjectId newChartIdToAdd);
     /// <summary>
     /// Updates the configuration of a chart that was previously deleted, using the specified identifier.
     /// </summary>
     /// <param name="deletedId">The identifier of the deleted chart configuration to update.</param>
     /// <returns>A task that represents the asynchronous update operation, containing the result of the update.</returns>
+    /// <!-- aidoc:v1 sig=dd3d4a9 -->
     Task<UpdateResult> UpdateDeletedChartConfig(ObjectId deletedId);
     /// <summary>
     /// Asynchronously retrieves the chart configuration associated with the specified chart object identifier.
     /// </summary>
     /// <param name="objectIdConfigChart">The unique object identifier of the chart configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="ChartConfig"/> associated with the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=4913157 -->
     Task<ChartConfig> GetChartConfig(ObjectId objectIdConfigChart);
     /// <summary>
     /// Asynchronously updates the detail configuration identifier, associating it with the specified result identifier.
@@ -171,11 +194,13 @@ public interface IDisplayConfigRepository : IMongoRepository<DisplayConfig>
     /// <param name="displayConfigId">The nullable identifier of the display configuration to update.</param>
     /// <param name="resultId">The nullable identifier of the result to associate with the configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=461a960 -->
     Task<bool> UpdateDetailConfigId(ObjectId? displayConfigId, ObjectId? resultId);
     /// <summary>
     /// Asynchronously retrieves a list of identifiers associated with the specified card detail base configuration.
     /// </summary>
     /// <param name="baseConfigId">The identifier of the card detail base configuration to filter by.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ObjectId"/> values matching the provided base configuration identifier.</returns>
+    /// <!-- aidoc:v1 sig=370fbe0 -->
     Task<List<ObjectId>> GetAllByCardDetailConfigId(ObjectId baseConfigId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDisplayDetailConfigRepository.cs b/adas-core.Application/Repositories/Interfaces/IDisplayDetailConfigRepository.cs
index 3390d550..f5d2b543 100644
--- a/adas-core.Application/Repositories/Interfaces/IDisplayDetailConfigRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDisplayDetailConfigRepository.cs
@@ -10,6 +10,7 @@ public interface IDisplayDetailConfigRepository : IMongoRepository<CardDetailsCo
     /// Asynchronously retrieves all card details configurations from the data source.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="CardDetailsConfig"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=b4de920 -->
     Task<List<CardDetailsConfig>> GetAll();
     /// <summary>
     /// Retrieves a <see cref="CardDetailsConfig"/> by its unique identifier.
@@ -17,23 +18,27 @@ public interface IDisplayDetailConfigRepository : IMongoRepository<CardDetailsCo
     /// </summary>
     /// <param name="configId">The identifier of the card details configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="CardDetailsConfig"/> or <see langword="null"/> if not found.</returns>
+    /// <!-- aidoc:v1 sig=a624128 -->
     Task<CardDetailsConfig?> GetById(ObjectId configId);
     /// <summary>
     /// Asynchronously inserts a new card details configuration and returns the inserted entity.
     /// </summary>
     /// <param name="config">The card details configuration to insert.</param>
     /// <returns>A task representing the asynchronous operation, containing the inserted <see cref="CardDetailsConfig"/>, or <c>null</c> if no entity was returned.</returns>
+    /// <!-- aidoc:v1 sig=6ff78fc -->
     Task<CardDetailsConfig?> InsertOneAsyncAndReturn(CardDetailsConfig config);
     /// <summary>
     /// Updates a single card details configuration record asynchronously.
     /// </summary>
     /// <param name="config">The card details configuration to update. May be <see langword="null"/>.</param>
     /// <returns>A task that represents the asynchronous operation, containing the update response with the updated <see cref="CardDetailsConfig"/> or <see langword="null"/> when no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=00357b8 -->
     Task<UpdateResponse<CardDetailsConfig?>> UpdateOne(CardDetailsConfig? config);
     /// <summary>
     /// Deletes a single <see cref="CardDetailsConfig"/> identified by its unique identifier.
     /// </summary>
     /// <param name="configId">The unique identifier of the <see cref="CardDetailsConfig"/> to delete.</param>
     /// <returns>A task that represents the asynchronous operation, containing the deleted <see cref="CardDetailsConfig"/>, or <c>null</c> if no matching configuration was found.</returns>
+    /// <!-- aidoc:v1 sig=e53d89f -->
     Task<CardDetailsConfig?> DeleteOne(ObjectId configId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IDisplayRepository.cs b/adas-core.Application/Repositories/Interfaces/IDisplayRepository.cs
index 3e8d16c1..ef7cae2c 100644
--- a/adas-core.Application/Repositories/Interfaces/IDisplayRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IDisplayRepository.cs
@@ -14,6 +14,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// Retrieves every display stored in the collection.
     /// </summary>
     /// <returns>A <see cref="Task{List{Display}}"/> representing the asynchronous operation. The task result contains all displays, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=d9b5d50 -->
     Task<List<Display>> GetAll();
       
 
@@ -22,6 +23,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="pointOfCare">The <see cref="PointOfCare"/> to filter by.</param>
     /// <returns>A <see cref="Task{List{Display}}"/> representing the asynchronous operation. The task result contains the matching displays, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=04ec30c -->
     Task<List<Display>> GetByPointOfCare(PointOfCare pointOfCare);
 
     // Task<List<Display>> GetByUser();
@@ -31,6 +33,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="name">The display name to look up.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the <see cref="Display"/> if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=02f4c9c -->
     Task<Display?> GetByName(string name);
 
     /// <summary>
@@ -38,6 +41,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the display to retrieve.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the <see cref="Display"/> if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=3467c35 -->
     Task<Display?> GetById(ObjectId id);
 
     /// <summary>
@@ -45,6 +49,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the display to retrieve.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the <see cref="Display"/> with its config populated if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=ae957ab -->
     Task<Display?> GetByIdWithConfigDisplay(ObjectId id);
 
     /// <summary>
@@ -52,6 +57,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the unit.</param>
     /// <returns>A <see cref="Task{List{Display}}"/> representing the asynchronous operation. The task result contains the matching displays, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=a786839 -->
     Task<List<Display>> GetByUnitId(ObjectId id);
 
     /// <summary>
@@ -59,6 +65,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the display configuration to filter by.</param>
     /// <returns>A <see cref="Task{List{Display}}"/> representing the asynchronous operation. The task result contains the matching displays, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=da68f5b -->
     Task<List<Display>> GetByConfigId(ObjectId id);
 
     /// <summary>
@@ -67,6 +74,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// <param name="objectId">The <see cref="ObjectId"/> of the display to update.</param>
     /// <param name="listPocObId">The new list of <see cref="ObjectId"/> values representing the point-of-cares to associate with the display.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the updated <see cref="Display"/> if the update succeeded; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=48f0e68 -->
     Task<Display?> UpdatePointOfCareList(ObjectId objectId, List<ObjectId> listPocObId);
 
     /// <summary>
@@ -75,6 +83,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// <param name="oldDisplayId">The <see cref="ObjectId"/> of the display whose configuration should be replaced.</param>
     /// <param name="newDisplayConfigCast">The new <see cref="DisplayConfig"/> instance to assign to the display.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the updated <see cref="Display"/> if the update succeeded; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=a68edd4 -->
     Task<Display?> UpdateConfig(ObjectId oldDisplayId, DisplayConfig newDisplayConfigCast);
 
     /// <summary>
@@ -83,6 +92,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// <param name="objectIdDisplay">The <see cref="ObjectId"/> of the display to update.</param>
     /// <param name="objectIdConfigDisplay">The <see cref="ObjectId"/> of the display-config preset to associate.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the updated <see cref="Display"/> if the update succeeded; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=6061a62 -->
     Task<Display?> UpdateConfigPreset(ObjectId objectIdDisplay, ObjectId objectIdConfigDisplay);
 
     /// <summary>
@@ -91,6 +101,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// <param name="display">The <see cref="Display"/> instance to update. Its <see cref="ObjectId"/> is used to identify the document.</param>
     /// <param name="name">The new display name.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the updated <see cref="Display"/>.</returns>
+    /// <!-- aidoc:v1 sig=43f880c -->
     Task<Display> UpdateName(Display display, string name);
 
     /// <summary>
@@ -98,6 +109,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="filter">The <see cref="PaginationFilter"/> containing pagination and filter criteria.</param>
     /// <returns>An <see cref="IFindFluent{Display, Display}"/> instance that can be used to further refine and execute the query.</returns>
+    /// <!-- aidoc:v1 sig=35cf2af -->
     IFindFluent<Display, Display> GetPaginatedDisplays(PaginationFilter filter);
 
     /// <summary>
@@ -105,6 +117,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="displayConfigId">The <see cref="ObjectId"/> of the display configuration to check for usage.</param>
     /// <returns>A <see cref="Task{Int64}"/> representing the asynchronous operation. The task result contains the number of displays referencing the configuration.</returns>
+    /// <!-- aidoc:v1 sig=ddb0904 -->
     Task<long> IsDisplayConfigInUse(ObjectId displayConfigId);
 
     /// <summary>
@@ -113,6 +126,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// <param name="objectId">The <see cref="ObjectId"/> of the display to update.</param>
     /// <param name="displayConfigId">The new <see cref="ObjectId"/> of the display configuration to associate with the display.</param>
     /// <returns>A <see cref="Task{Display}"/> representing the asynchronous operation. The task result contains the updated <see cref="Display"/> if the update succeeded; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=53467c7 -->
     Task<Display?> UpdateConfigId(ObjectId objectId, ObjectId displayConfigId);
 
     /// <summary>
@@ -120,6 +134,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="unitId">The <see cref="ObjectId"/> of the unit.</param>
     /// <returns>A <see cref="Task{Int64}"/> representing the asynchronous operation. The task result contains the number of displays for the unit.</returns>
+    /// <!-- aidoc:v1 sig=e0dfc62 -->
     Task<long> CountByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -127,6 +142,7 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="unitId">The <see cref="ObjectId"/> of the unit whose displays should be removed.</param>
     /// <returns>A <see cref="Task{Boolean}"/> representing the asynchronous operation. The task result is <see langword="true"/> when at least one display was deleted; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=903a910 -->
     Task<bool> DeleteManyByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -134,5 +150,6 @@ public interface IDisplayRepository : IMongoRepository<Display>
     /// </summary>
     /// <param name="configId">The <see cref="ObjectId"/> of the card configuration to filter by.</param>
     /// <returns>A <see cref="Task{List{Display}}"/> representing the asynchronous operation. The task result contains the matching displays, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=7885fbb -->
     Task<List<Display>> GetByCardConfigId(ObjectId configId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IHistoricalConfigChangesRepository.cs b/adas-core.Application/Repositories/Interfaces/IHistoricalConfigChangesRepository.cs
index b0ee6f55..5813bfe8 100644
--- a/adas-core.Application/Repositories/Interfaces/IHistoricalConfigChangesRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IHistoricalConfigChangesRepository.cs
@@ -12,6 +12,7 @@ public interface IHistoricalConfigChangesRepository : IMongoRepository<Historica
     /// </summary>
     /// <param name="id">The unique identifier of the historical configuration changes record to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="HistoricalConfigChanges"/> record, or null if no record with the specified identifier exists.</returns>
+    /// <!-- aidoc:v1 sig=32618a1 -->
     Task<HistoricalConfigChanges?> FindById(ObjectId id);
 
     /// <summary>
@@ -19,6 +20,7 @@ public interface IHistoricalConfigChangesRepository : IMongoRepository<Historica
     /// </summary>
     /// <param name="historicalConfigChange">The historical config change entity containing the values to persist.</param>
     /// <returns>A task that represents the asynchronous update operation. The result is the updated historical config change, or <c>null</c> if the record was not found.</returns>
+    /// <!-- aidoc:v1 sig=febe8cf -->
     Task<HistoricalConfigChanges?> Update(HistoricalConfigChanges historicalConfigChange);
 
     /// <summary>
@@ -27,24 +29,28 @@ public interface IHistoricalConfigChangesRepository : IMongoRepository<Historica
     /// </summary>
     /// <param name="id">The unique identifier of the historical configuration change to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation, containing the deleted <see cref="HistoricalConfigChanges"/> record, or <c>null</c> if no matching record exists.</returns>
+    /// <!-- aidoc:v1 sig=08b33f1 -->
     Task<HistoricalConfigChanges?> Delete(ObjectId id);
 
     /// <summary>
     /// Asynchronously retrieves a list of all object identifiers.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of ObjectId values.</returns>
+    /// <!-- aidoc:v1 sig=2b29fbf -->
     Task<List<ObjectId>> FindAllIds();
 
     /// <summary>
     /// Asynchronously retrieves all historical configuration changes.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="HistoricalConfigChanges"/> records.</returns>
+    /// <!-- aidoc:v1 sig=0d065db -->
     Task<ICollection<HistoricalConfigChanges>> FindAll();
     /// <summary>
     /// Asynchronously inserts a new <see cref="HistoricalConfigChanges"/> record into the data store.
     /// </summary>
     /// <param name="patientObservation">The historical config change entity to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing the inserted <see cref="HistoricalConfigChanges"/> entity, or <c>null</c> if the insertion did not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=caa51e2 -->
     new Task<HistoricalConfigChanges?> InsertOneAsync(HistoricalConfigChanges patientObservation);
 
     /// <summary>
@@ -53,6 +59,7 @@ public interface IHistoricalConfigChangesRepository : IMongoRepository<Historica
     /// <param name="cfgType">The configuration type used to filter the historical changes.</param>
     /// <param name="num">The maximum number of recent changes to return. Defaults to 10.</param>
     /// <returns>A task that returns a collection of historical configuration changes matching the specified type, ordered from most recent.</returns>
+    /// <!-- aidoc:v1 sig=36bb7c3 -->
     Task<ICollection<HistoricalConfigChanges>> FindLastHistoricalConfigChangesByType(
             DisplayConfigEnums.ConfigTypes cfgType, int num = 10);
 
@@ -63,6 +70,7 @@ public interface IHistoricalConfigChangesRepository : IMongoRepository<Historica
     /// <param name="cfgType">Optional. The configuration type to filter the results by. If null, changes across all configuration types are returned.</param>
     /// <param name="num">The maximum number of historical changes to return. Defaults to 10.</param>
     /// <returns>A task representing the asynchronous operation, containing a collection of historical configuration changes for the user.</returns>
+    /// <!-- aidoc:v1 sig=e9b2c45 -->
     Task<ICollection<HistoricalConfigChanges>> FindLastHistoricalConfigChangesByUser(string user,
             DisplayConfigEnums.ConfigTypes? cfgType = null, int num = 10);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/ILightBeaconRepository.cs b/adas-core.Application/Repositories/Interfaces/ILightBeaconRepository.cs
index cf88029f..18189d2d 100644
--- a/adas-core.Application/Repositories/Interfaces/ILightBeaconRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/ILightBeaconRepository.cs
@@ -12,35 +12,41 @@ public interface ILightBeaconRepository : IMongoRepository<LightBeacon>
     /// </summary>
     /// <param name="configurationRelayList">The collection of configuration relay <see cref="ObjectId"/> values used to look up the corresponding light beacons.</param>
     /// <returns>A <see cref="List{LightBeacon}"/> containing the light beacons matching the provided configuration relay identifiers; returns an empty list if no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=74d25d3 -->
     List<LightBeacon> GetLightBeaconInList(List<ObjectId> configurationRelayList);
     /// <summary>
     /// Retrieves a light beacon by its associated relay identifier.
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay used to look up the corresponding light beacon.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="LightBeacon"/>, or <c>null</c> if no beacon is found for the specified relay.</returns>
+    /// <!-- aidoc:v1 sig=53103f5 -->
     Task<LightBeacon?> GetById(ObjectId relayId);
     /// <summary>
     /// Asynchronously retrieves a <see cref="LightBeacon"/> by its name.
     /// </summary>
     /// <param name="name">The name of the light beacon to look up.</param>
     /// <returns>A task that returns the matching <see cref="LightBeacon"/>, or <c>null</c> if no beacon with the specified name is found.</returns>
+    /// <!-- aidoc:v1 sig=8fe6fa2 -->
     Task<LightBeacon?> GetByName(string name);
     /// <summary>
     /// Asynchronously inserts a new LightBeacon and returns the persisted entity, or null if the insertion did not produce a result.
     /// </summary>
     /// <param name="beacon">The LightBeacon entity to insert.</param>
     /// <returns>A task containing the inserted LightBeacon, or null when no entity was returned by the underlying operation.</returns>
+    /// <!-- aidoc:v1 sig=a792e57 -->
     Task<LightBeacon?> InsertOneAsyncAndReturn(LightBeacon beacon);
     /// <summary>
     /// Retrieves a paginated, queryable collection of light beacons (relays) based on the supplied pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter that controls paging parameters applied to the relay list.</param>
     /// <returns>An <see cref="IFindFluent{LightBeacon, LightBeacon}"/> exposing the paginated relay result set for further querying or enumeration.</returns>
+    /// <!-- aidoc:v1 sig=c985c38 -->
     IFindFluent<LightBeacon, LightBeacon> GetPaginatedRelays(PaginationFilter filter);
     /// <summary>
     /// Asynchronously retrieves a list of <see cref="LightBeacon"/> objects whose name matches the specified search text.
     /// </summary>
     /// <param name="textToSearch">The text used to search for matching <see cref="LightBeacon"/> entries by name.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="LightBeacon"/> objects that match the search criteria.</returns>
+    /// <!-- aidoc:v1 sig=2c88e45 -->
     Task<List<LightBeacon>> GetSearchByName(string textToSearch);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IMasterListRepository.cs b/adas-core.Application/Repositories/Interfaces/IMasterListRepository.cs
index b74437c2..e17f3b2d 100644
--- a/adas-core.Application/Repositories/Interfaces/IMasterListRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IMasterListRepository.cs
@@ -12,11 +12,13 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// Deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
     /// <summary>
     /// Asynchronously updates the specified collection of items.
     /// </summary>
     /// <param name="list">The collection of items to update.</param>
+    /// <!-- aidoc:v1 sig=85228bb -->
     Task Update(T list);
     /// <summary>
     /// Asynchronously retrieves an entity identified by the specified <paramref name="id"/>, optionally resolving localized content using the given <paramref name="locale"/>. Returns <c>null</c> when no matching entity is found.
@@ -24,6 +26,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the entity to look up.</param>
     /// <param name="locale">The optional locale used to resolve localized fields of the retrieved entity.</param>
     /// <returns>A task that yields the matching entity, or <c>null</c> if the entity is not found.</returns>
+    /// <!-- aidoc:v1 sig=96a4e49 -->
     Task<T?> FindById(ObjectId id, LocaleEnum? locale);
     /// <summary>
     /// Asynchronously retrieves an entity of type <typeparamref name="T"/> by its unique identifier.
@@ -31,6 +34,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// </summary>
     /// <param name="id">The unique identifier of the entity to locate.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the entity of type <typeparamref name="T"/> if found, or <c>null</c> otherwise.</returns>
+    /// <!-- aidoc:v1 sig=b0b0918 -->
     Task<T?> FindById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves an <see cref="OptionList"/> item identified by the specified master and option identifiers for the given locale.
@@ -40,6 +44,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="optionId">The identifier of the specific option item to retrieve within the master scope.</param>
     /// <param name="locale">The locale used to select the localized version of the option item.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="OptionList"/>, or <c>null</c> if no item is found.</returns>
+    /// <!-- aidoc:v1 sig=353f501 -->
     Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId, LocaleEnum locale);
     /// <summary>
     /// Asynchronously retrieves an <see cref="OptionList"/> identified by the given master and option identifiers.
@@ -47,17 +52,20 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="masterId">The identifier of the master record that owns the option list.</param>
     /// <param name="optionId">The identifier of the specific option item to locate within the master.</param>
     /// <returns>A <see cref="Task{OptionList}"/> that yields the matching <see cref="OptionList"/>, or <c>null</c> when no item is found.</returns>
+    /// <!-- aidoc:v1 sig=ff21f84 -->
     Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId);
     /// <summary>
     /// Asynchronously retrieves all items of type T.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of all items of type T.</returns>
+    /// <!-- aidoc:v1 sig=48c919f -->
     Task<IEnumerable<T>> GetAll();
     /// <summary>
     /// Retrieves all master list entries without applying optional filters or including related option data.
     /// Used to fetch the complete set of master list records for scenarios such as full enumeration or bulk operations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IEnumerable{MasterListDto}"/> with all available master list entries.</returns>
+    /// <!-- aidoc:v1 sig=5929589 -->
     Task<IEnumerable<MasterListDto>> GetAllWithoutOptions();
     /// <summary>
     /// Asynchronously finds and returns an entity of type <typeparamref name="T"/> matching the specified <paramref name="name"/>.
@@ -65,6 +73,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// </summary>
     /// <param name="name">The name used to look up the entity.</param>
     /// <returns>A task that represents the asynchronous lookup, containing the matched entity of type <typeparamref name="T"/> or <c>null</c> if no match exists.</returns>
+    /// <!-- aidoc:v1 sig=f5a2991 -->
     Task<T?> FindByName(string name);
     /// <summary>
     /// Retrieves a master list of option list entries filtered by the specified identifier and an optional text search that performs a contains match.
@@ -72,6 +81,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The identifier used to scope the option list entries to be returned.</param>
     /// <param name="textSearch">An optional text used to filter entries whose content contains the specified value; may be null to skip text-based filtering.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="OptionList"/> entries that match the identifier and the optional text search criteria.</returns>
+    /// <!-- aidoc:v1 sig=807ba8d -->
     Task<List<OptionList>> GetMasterListByIdAndTextSearchContaining(ObjectId id, string? textSearch);
     /// <summary>
     /// Asynchronously adds a <see cref="FilterOptionListElement"/> to the master option list identified by the given <see cref="ObjectId"/>.
@@ -79,6 +89,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The identifier of the master option list to which the element will be added.</param>
     /// <param name="opt">The filter option list element to add to the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the resulting <see cref="OptionList"/>, or <c>null</c> if no list is returned.</returns>
+    /// <!-- aidoc:v1 sig=07eea1e -->
     Task<OptionList?> AddOptionToMasterList(ObjectId id, FilterOptionListElement opt);
     /// <summary>
     /// Updates an existing master list option identified by the specified identifier using the provided option data and locale, returning the updated option list.
@@ -87,6 +98,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="newOpt">The new option list data to apply to the master list option.</param>
     /// <param name="locale">The locale used for the update operation.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="OptionList"/> if found, or <c>null</c> if no matching master list option exists.</returns>
+    /// <!-- aidoc:v1 sig=69ad188 -->
     Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList newOpt, LocaleEnum locale);
     /// <summary>
     /// Updates an existing master list option identified by the given id with the provided data, returning the updated option or null if no matching option is found.
@@ -94,6 +106,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the master list option to update.</param>
     /// <param name="newOpt">The new option data to replace the existing master list option.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated <see cref="OptionList"/>, or null if no option with the specified id exists.</returns>
+    /// <!-- aidoc:v1 sig=7c563ac -->
     Task<OptionList?> UpdateFullMasterListOption(ObjectId id, OptionList newOpt);
     /// <summary>
     /// Updates an existing master list option identified by the specified id with the provided new option data.
@@ -101,6 +114,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the master list option to update.</param>
     /// <param name="newOpt">The new option data to apply to the existing master list option.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="OptionList"/>, or <c>null</c> if no matching option was found.</returns>
+    /// <!-- aidoc:v1 sig=1f17447 -->
     Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList newOpt);
     /// <summary>
     /// Deletes a master list option identified by the specified option ID.
@@ -108,6 +122,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The identifier of the master list containing the option to delete.</param>
     /// <param name="deleteOptId">The identifier of the option to be deleted from the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean indicating whether the option was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=2e650f2 -->
     Task<bool> DeleteMasterListOption(ObjectId id, ObjectId deleteOptId);
     /// <summary>
     /// Updates the option details of an existing entry in the master list identified by the specified id.
@@ -115,6 +130,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the master list entry to update.</param>
     /// <param name="opt">The update payload containing the new option details to apply.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated master list details, or null if no matching entry is found.</returns>
+    /// <!-- aidoc:v1 sig=1d0803c -->
     Task<UpdateMasterListDetailsDto?> UpdateOptionDetailsToMasterList(ObjectId id, UpdateMasterListDetailsDto opt);
     /// <summary>
     /// Updates the name of an existing master list identified by the specified identifier.
@@ -122,6 +138,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the master list to update.</param>
     /// <param name="name">The new name to assign to the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the master list was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a2d47b2 -->
     Task<bool> UpdateMasterListName(ObjectId id, string name);
     /// <summary>
     /// Asynchronously updates the description of a master list identified by the specified identifier.
@@ -129,6 +146,7 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The unique identifier of the master list to update.</param>
     /// <param name="description">The new description to set for the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <see langword="true"/> if the update was successful; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=d9584a6 -->
     Task<bool> UpdateMasterListDescription(ObjectId id, string description);
     /// <summary>
     /// Asynchronously removes the specified option from the master list associated with the given identifier.
@@ -136,12 +154,14 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The identifier of the master list from which the option will be removed.</param>
     /// <param name="oldOpt">The option to be removed from the master list.</param>
     /// <returns>A task that represents the asynchronous removal operation. The task result contains true if the option was successfully removed; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=f049a15 -->
     Task<bool> RemoveMasterListOption(ObjectId id, OptionList oldOpt);
     /// <summary>
     /// Retrieves a paginated master list using the specified pagination filter, returning a fluent queryable result.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the paging criteria applied to the master list query.</param>
     /// <returns>An <see cref="IFindFluent{TDocument, TProjection}"/> that represents the paginated queryable master list.</returns>
+    /// <!-- aidoc:v1 sig=6bbc1e5 -->
     IFindFluent<T, T> GetPaginatedMasterList(PaginationFilter filter);
     /// <summary>
     /// Retrieves a paginated collection of options associated with the specified list identifier, applying the provided pagination filter to control the result set.
@@ -149,11 +169,13 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="filter">The pagination filter defining page size, page number, and related pagination constraints.</param>
     /// <param name="listId">The unique identifier of the list whose options should be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="OptionList"/> items for the requested page.</returns>
+    /// <!-- aidoc:v1 sig=f5b427c -->
     Task<List<OptionList>> GetPaginatedOptions(PaginationFilter filter, ObjectId listId);
     /// <summary>
     /// Asynchronously counts the number of items and returns the total.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the total count of items.</returns>
+    /// <!-- aidoc:v1 sig=cabd009 -->
     Task<int> Count();
     /// <summary>
     /// Retrieves a master list of <see cref="OptionList"/> entries identified by the given id, optionally applying the provided search and filtering options.
@@ -161,5 +183,6 @@ public interface IMasterListRepository<T> : IMongoRepository<T> where T : Master
     /// <param name="id">The identifier of the master list to retrieve.</param>
     /// <param name="filterOption">Optional filter criteria used to narrow the returned options. May be <c>null</c> to return the full list without additional filtering.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="OptionList"/> items that match the specified id and filter, or an empty list if no matching entries are found.</returns>
+    /// <!-- aidoc:v1 sig=437ba17 -->
     Task<List<OptionList>> GetMasterListByIdAndSearchOptions(ObjectId id, FilterOptionListElement? filterOption);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IMedicineRepository.cs b/adas-core.Application/Repositories/Interfaces/IMedicineRepository.cs
index 6d7cbb2b..65873920 100644
--- a/adas-core.Application/Repositories/Interfaces/IMedicineRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IMedicineRepository.cs
@@ -12,6 +12,7 @@ public interface IMedicineRepository : IMongoRepository<Medicine>
     /// </summary>
     /// <param name="code">The code used to look up the medicine.</param>
     /// <returns>A task that returns the matching <see cref="Medicine"/> if found, or <c>null</c> if no medicine matches the specified code.</returns>
+    /// <!-- aidoc:v1 sig=27e988f -->
     Task<Medicine?> GetMedicine(string code);
 
     /// <summary>
@@ -19,17 +20,20 @@ public interface IMedicineRepository : IMongoRepository<Medicine>
     /// </summary>
     /// <param name="codeNotes">The list of codes or notes used to look up the medicines.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of matching medicines.</returns>
+    /// <!-- aidoc:v1 sig=2a2f753 -->
     Task<List<Medicine>> GetMedicineByCodeOrNote(List<string> codeNotes);
     /// <summary>
     /// Retrieves a <see cref="Medicine"/> entity by its name asynchronously.
     /// </summary>
     /// <param name="name">The name of the medicine to look up.</param>
     /// <returns>A <see cref="Task{Medicine}"/> that resolves to the matching <see cref="Medicine"/>, or <c>null</c> if no medicine with the specified name is found.</returns>
+    /// <!-- aidoc:v1 sig=2bab729 -->
     Task<Medicine?> GetMedicineByName(string name);
     /// <summary>
     /// Asynchronously retrieves all medicines from the data source.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Medicine"/> objects; an empty list is returned when no medicines are found.</returns>
+    /// <!-- aidoc:v1 sig=84b2421 -->
     Task<List<Medicine>> GetAll();
     /// <summary>
     /// Retrieves a medicine entity by its unique identifier from the data store.
@@ -37,29 +41,34 @@ public interface IMedicineRepository : IMongoRepository<Medicine>
     /// </summary>
     /// <param name="medicineId">The unique <see cref="ObjectId"/> of the medicine to retrieve.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the matching <see cref="Medicine"/> if found, or <see langword="null"/> when no record exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=a87fd1e -->
     Task<Medicine?> GetMedicineById(ObjectId medicineId);
     /// <summary>
     /// Asynchronously creates and posts a new medicine entry, returning the persisted <see cref="Medicine"/> on success or <c>null</c> when no result is produced.
     /// </summary>
     /// <param name="medicine">The medicine entity to be created and submitted.</param>
     /// <returns>A task that resolves to the newly created <see cref="Medicine"/>, or <c>null</c> if the operation does not yield a result.</returns>
+    /// <!-- aidoc:v1 sig=9decc93 -->
     Task<Medicine?> PostMedicine(Medicine medicine);
     /// <summary>
     /// Updates an existing medicine record with the provided information.
     /// </summary>
     /// <param name="medicine">The medicine entity containing the updated data, typically identified by its primary key.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Medicine"/>, or <c>null</c> if no matching medicine was found.</returns>
+    /// <!-- aidoc:v1 sig=2ae8490 -->
     Task<Medicine?> UpdateMedicine(Medicine medicine);
     /// <summary>
     /// Asynchronously deletes a medicine record from the data store using the specified identifier.
     /// </summary>
     /// <param name="medicineId">The unique identifier of the medicine to delete.</param>
+    /// <!-- aidoc:v1 sig=44a1285 -->
     Task DeleteMedicineById(ObjectId medicineId);
     /// <summary>
     /// Builds a MongoDB aggregation pipeline that retrieves the distinct values for the specified field.
     /// </summary>
     /// <param name="field">The name of the field whose distinct values should be queried.</param>
     /// <returns>An <see cref="IAggregateFluent{BsonDocument}"/> representing the distinct field data query.</returns>
+    /// <!-- aidoc:v1 sig=ec965d8 -->
     IAggregateFluent<BsonDocument> GetDistinctFieldDataQuery(string field);
 
     /// <summary>
@@ -67,5 +76,6 @@ public interface IMedicineRepository : IMongoRepository<Medicine>
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to control the result set.</param>
     /// <returns>A fluent query interface for the paginated medicines.</returns>
+    /// <!-- aidoc:v1 sig=c603913 -->
     IFindFluent<Medicine, Medicine> GetPaginatedMedicines(PaginationFilter filter);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IMongoRepository.cs b/adas-core.Application/Repositories/Interfaces/IMongoRepository.cs
index 401d90af..99d18d44 100644
--- a/adas-core.Application/Repositories/Interfaces/IMongoRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IMongoRepository.cs
@@ -11,23 +11,27 @@ public interface IMongoRepository<T>
     /// Gets the name of the collection.
     /// </summary>
     /// <returns>The name of the collection.</returns>
+    /// <!-- aidoc:v1 sig=a1be5ef -->
     string GetCollectionName();
     /// <summary>
     /// Asynchronously inserts a single object of type <typeparamref name="T"/>.
     /// </summary>
     /// <param name="obj">The object to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=f786cc1 -->
     Task InsertOneAsync(T obj);
     /// <summary>
     /// Asynchronously deletes the entity identified by the specified identifier and returns the deleted entity.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
     /// <returns>A task that represents the asynchronous operation, containing the deleted entity of type <typeparamref name="T"/>, or <c>null</c> if no matching entity was found.</returns>
+    /// <!-- aidoc:v1 sig=e29699e -->
     Task<T?> DeleteAsync(ObjectId id);
     /// <summary>
     /// Asynchronously updates an existing document identified by the specified identifier with the provided object data.
     /// </summary>
     /// <param name="id">The unique identifier of the document to update.</param>
     /// <param name="obj">The object containing the updated values to persist.</param>
+    /// <!-- aidoc:v1 sig=3e43209 -->
     Task UpdateOneAsync(ObjectId id, T obj);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/INoticeRepository.cs b/adas-core.Application/Repositories/Interfaces/INoticeRepository.cs
index 688ecc7e..19b16d27 100644
--- a/adas-core.Application/Repositories/Interfaces/INoticeRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/INoticeRepository.cs
@@ -9,39 +9,46 @@ public interface INoticeRepository : IMongoRepository<Notice>
     /// Deletes the entity identified by the specified <see cref="ObjectId"/>.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
     /// <summary>
     /// Asynchronously updates an existing notice with the provided information.
     /// </summary>
     /// <param name="notice">The notice entity containing the updated data to be persisted.</param>
+    /// <!-- aidoc:v1 sig=3841eb4 -->
     Task Update(Notice notice);
     /// <summary>
     /// Asynchronously retrieves all notices.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of all <see cref="Notice"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=f8ca02f -->
     Task<IEnumerable<Notice>> FindAll();
     /// <summary>
     /// Retrieves a <see cref="Notice"/> by its unique identifier. Returns <c>null</c> when no matching notice is found.
     /// </summary>
     /// <param name="id">The identifier of the notice to look up.</param>
     /// <returns>A task that yields the matching <see cref="Notice"/>, or <c>null</c> if no notice exists for the specified <paramref name="id"/>.</returns>
+    /// <!-- aidoc:v1 sig=da1f6f5 -->
     Task<Notice?> FindById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves the collection of notices that match the specified date.
     /// </summary>
     /// <param name="date">The date used to filter the notices to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="Notice"/> objects for the specified date, or <c>null</c> if no matching notices are found.</returns>
+    /// <!-- aidoc:v1 sig=aaaf476 -->
     Task<IEnumerable<Notice>?> FindByDate(DateTime date);
     /// <summary>
     /// Asynchronously retrieves the <see cref="Notice"/> entries that match the specified type.
     /// </summary>
     /// <param name="type">The notice type used to filter the lookup.</param>
     /// <returns>A task containing the matching <see cref="Notice"/> items, or <c>null</c> when no results are available.</returns>
+    /// <!-- aidoc:v1 sig=64b3426 -->
     Task<IEnumerable<Notice>?> FindByType(string type);
     /// <summary>
     /// Asynchronously retrieves the <see cref="Notice"/> entities associated with the specified display identifier.
     /// </summary>
     /// <param name="displayId">The display identifier used to locate the matching notices.</param>
     /// <returns>A task that yields the collection of matching <see cref="Notice"/> items, or <c>null</c> if no notices are found.</returns>
+    /// <!-- aidoc:v1 sig=08d036f -->
     Task<IEnumerable<Notice>?> FindByDisplayId(ObjectId displayId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IObservationArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IObservationArchiveRepository.cs
index 07180bea..60813684 100644
--- a/adas-core.Application/Repositories/Interfaces/IObservationArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IObservationArchiveRepository.cs
@@ -9,17 +9,20 @@ public interface IObservationArchiveRepository : IMongoRepository<PatientObserva
     /// Asynchronously inserts a single <see cref="PatientObservation"/> into the data store.
     /// </summary>
     /// <param name="patientObservation">The patient observation to insert.</param>
+    /// <!-- aidoc:v1 sig=a11df0e -->
     new Task InsertOneAsync(PatientObservation patientObservation);
     /// <summary>
     /// Deletes the records that have a date earlier than the specified cutoff date.
     /// </summary>
     /// <param name="date">The cutoff date; records dated before this value will be removed.</param>
+    /// <!-- aidoc:v1 sig=350661d -->
     Task DeleteBeforeDate(DateTime date);
     /// <summary>
     /// Asynchronously inserts a batch of patient observation records into the underlying data store.
     /// </summary>
     /// <param name="observations">The collection of <see cref="PatientObservation"/> entities to be inserted.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous insert operation, returning a <see cref="long"/> value (such as the number of affected rows or a generated identifier) produced by the batch insertion.</returns>
+    /// <!-- aidoc:v1 sig=713717d -->
     Task<long> InsertBatch(IEnumerable<PatientObservation> observations);
 
     /// <summary>
@@ -30,6 +33,7 @@ public interface IObservationArchiveRepository : IMongoRepository<PatientObserva
     /// <param name="lastDate">The cutoff date; only observations on or before this date are considered.</param>
     /// <param name="filterObservations">An optional list of observation names to restrict the results to; pass an empty or null list to include all observations.</param>
     /// <returns>A task that resolves to a list of <see cref="PatientObservation"/> entries representing the aggregated last observations matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=1fb9a10 -->
     Task<List<PatientObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num, DateTime lastDate,
             List<string> filterObservations);
 
@@ -38,5 +42,6 @@ public interface IObservationArchiveRepository : IMongoRepository<PatientObserva
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose observations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservation"/> records for the patient.</returns>
+    /// <!-- aidoc:v1 sig=644a6c3 -->
     Task<List<PatientObservation>> FindAllFromPatient(ObjectId patientId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IObservationRepository.cs b/adas-core.Application/Repositories/Interfaces/IObservationRepository.cs
index d2b5126c..49896994 100644
--- a/adas-core.Application/Repositories/Interfaces/IObservationRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IObservationRepository.cs
@@ -15,6 +15,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="patientId">The identifier of the patient whose observations will be aggregated.</param>
     /// <param name="groupedField">The field used to group the patient's observations during aggregation.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of BSON documents with the aggregated results.</returns>
+    /// <!-- aidoc:v1 sig=6bf1b3d -->
     Task<List<BsonDocument>> AggregatedPatientGroupedObservations(ObjectId patientId, GroupedField groupedField);
 
     /// <summary>
@@ -26,6 +27,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="num">The maximum number of most recent observations to return.</param>
     /// <param name="filterObservations">An optional list of observation identifiers used to restrict the returned results; if null, no filter is applied.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of the patient's most recent <see cref="PatientObservation"/> records.</returns>
+    /// <!-- aidoc:v1 sig=eaa55e7 -->
     Task<List<PatientObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num,
             List<string>? filterObservations = null);
 
@@ -37,6 +39,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="lastDate">The cutoff date; only observations on or before this date are considered.</param>
     /// <param name="filterObservations">An optional list of observation names to restrict the results to. If null, no observation-name filter is applied.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of aggregated <see cref="PatientObservation"/> entries that match the criteria.</returns>
+    /// <!-- aidoc:v1 sig=e0e7bb3 -->
     Task<List<PatientObservation>> AggregatedPatientLastObservationsByLastDate(ObjectId patientId, int num,
             DateTime lastDate, List<string>? filterObservations = null);
 
@@ -46,6 +49,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="patientId">The unique identifier of the patient whose observations are being retrieved.</param>
     /// <param name="filterObservations">An optional list of fields to filter the observations by; if null, observations for all fields are returned.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of the latest patient observations grouped by field.</returns>
+    /// <!-- aidoc:v1 sig=50cede3 -->
     Task<List<PatientObservation>> AggregatedPatientLastObservationsByField(ObjectId patientId,
             List<Field>? filterObservations = null);
 
@@ -57,6 +61,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="code">The specific code within the coding system identifying the type of observation to retrieve.</param>
     /// <param name="num">The maximum number of most recent observations to return. Defaults to 2.</param>
     /// <returns>A task that yields a collection of the matching <see cref="PatientObservation"/> records, ordered from most recent to oldest, containing at most <paramref name="num"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=f22fd00 -->
     Task<IEnumerable<PatientObservation>> FindLastObservations(ObjectId patientId, string codingSystem, string code,
             int num = 2);
 
@@ -67,6 +72,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="codingSystem">The coding system used to filter the observations.</param>
     /// <param name="num">The maximum number of recent observations to return. Defaults to 10.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the patient's most recent observations matching the coding system.</returns>
+    /// <!-- aidoc:v1 sig=0970f2d -->
     Task<List<PatientObservation>> FindLastObservationsByCodingSystem(ObjectId patientId, string codingSystem,
             int num = 10);
 
@@ -77,12 +83,14 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The optional name of the observation to filter by. If <c>null</c>, observations of any name are considered.</param>
     /// <param name="date">The cutoff date; only observations recorded strictly before this date are eligible.</param>
     /// <returns>A task that resolves to the matching <see cref="PatientObservation"/> if found, or <c>null</c> if no observation exists before the specified date.</returns>
+    /// <!-- aidoc:v1 sig=2d11f04 -->
     Task<PatientObservation?> FindLastObservationBeforeDate(ObjectId patientId, string? name, DateTime date);
 
     /// <summary>
     /// Asynchronously updates the state of patient observations that have expired, applying the appropriate expiration handling to each item in the provided list.
     /// </summary>
     /// <param name="expiredObservations">The list of patient observations that have expired and require their state to be updated.</param>
+    /// <!-- aidoc:v1 sig=e7ed4fa -->
     Task UpdateExpiredObservations(List<PatientObservation> expiredObservations);
 
     /// <summary>
@@ -92,6 +100,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The optional name of the observation to match; if null, observations of any name are considered.</param>
     /// <param name="date">The date used to match observations recorded on the same day.</param>
     /// <returns>A task that returns a list of matching <see cref="PatientObservation"/> instances, or <c>null</c> if no matching observations are found.</returns>
+    /// <!-- aidoc:v1 sig=c14ce85 -->
     Task<List<PatientObservation>?> FindAnyWithSameDate(ObjectId patientId, string? name, DateTime date);
     /// <summary>
     /// Asynchronously retrieves all patient observations recorded for the specified patient before the given date.
@@ -99,6 +108,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="patientId">The unique identifier of the patient whose observations are being queried.</param>
     /// <param name="date">The cutoff date; only observations recorded prior to this date are returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patient observations found before the specified date.</returns>
+    /// <!-- aidoc:v1 sig=d6e7618 -->
     Task<List<PatientObservation>> FindAnyBeforeDate(ObjectId patientId, DateTime date);
 
     /// <summary>
@@ -108,23 +118,27 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The name used to match the relevant patient observations.</param>
     /// <param name="expires">An optional expiration value in seconds used to control the time window for the lookup; if <c>null</c>, no expiration is applied.</param>
     /// <returns>A task that resolves to a list of the latest unique <see cref="PatientObservation"/> records matching the specified name for the patient. The list is empty if no matching observations are found.</returns>
+    /// <!-- aidoc:v1 sig=cd1a09e -->
     Task<List<PatientObservation>> FindLatestUniqueValuesByName(ObjectId patientId, string name, int? expires);
 
     /// <summary>
     /// Asynchronously inserts a single <see cref="PatientObservation"/> record into the underlying data store.
     /// </summary>
     /// <param name="patientObservation">The patient observation entity to persist.</param>
+    /// <!-- aidoc:v1 sig=a11df0e -->
     new Task InsertOneAsync(PatientObservation patientObservation);
     /// <summary>
     /// Deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The ObjectId of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves the collection of patient observations associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose observations are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IAsyncCursor{TDocument}"/> of <see cref="PatientObservation"/> instances to iterate through the matching records.</returns>
+    /// <!-- aidoc:v1 sig=39ad19b -->
     Task<IAsyncCursor<PatientObservation>> FindByPatientIdAsync(ObjectId patientId);
 
     /// <summary>
@@ -135,6 +149,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="codingSystem">The coding system used to classify the observations (e.g., LOINC, SNOMED).</param>
     /// <param name="name">The name of the observation to filter within the coding system.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields an <see cref="IAsyncCursor{TDocument}"/> streaming the matching <see cref="PatientObservation"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=d7bdee5 -->
     Task<IAsyncCursor<PatientObservation>> FindByPatientIdAndCodingSystemAsync(ObjectId patientId, string codingSystem,
             string name);
 
@@ -143,6 +158,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </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=9f8dfa3 -->
     new Task DeleteAsync(ObjectId id);
     /// <summary>
     /// Asynchronously deletes patient observations older than the specified retention period and returns the records that were removed.
@@ -150,6 +166,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The identifier used to locate the relevant patient observations to be evaluated for deletion.</param>
     /// <param name="retentionPolicyValue">The retention period in days; observations older than this value will be deleted.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the deleted <see cref="PatientObservation"/> records.</returns>
+    /// <!-- aidoc:v1 sig=221fcb6 -->
     Task<List<PatientObservation>> DeleteOlderDaysAsync(string name, int retentionPolicyValue);
     /// <summary>
     /// Asynchronously deletes patient observations based on the specified name and retention policy value.
@@ -157,6 +174,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The name used to identify or filter the patient observations to be deleted.</param>
     /// <param name="retentionPolicyValue">The retention policy threshold value that determines which older observations should be removed.</param>
     /// <returns>A task representing the asynchronous operation, containing the list of patient observations that were deleted.</returns>
+    /// <!-- aidoc:v1 sig=7338971 -->
     Task<List<PatientObservation>> DeleteOlderNumberAsync(string name, int retentionPolicyValue);
     /// <summary>
     /// Asynchronously checks whether a record exists for the specified patient identified by the given system identifier.
@@ -164,6 +182,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="patientid">The unique identifier of the patient whose record is being checked.</param>
     /// <param name="systemId">The system identifier used to look up the patient's record.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if a matching record exists; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d900b6f -->
     Task<bool> ExistBySystemId(ObjectId patientid, string systemId);
     /// <summary>
     /// Asynchronously deletes patient observations older than the specified number of seconds and returns the affected records.
@@ -171,17 +190,20 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The name used to identify the patient observations to filter for deletion.</param>
     /// <param name="value">The age threshold in seconds; observations older than this value will be deleted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of deleted patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5df4a1a -->
     Task<List<PatientObservation>> DeleteOlderSecondsAsync(string name, int value);
     /// <summary>
     /// Retrieves the aggregated active intravenous lines observations for the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose active intravenous lines observations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservation"/> entries representing the patient's active intravenous lines observations, where each entry may be null.</returns>
+    /// <!-- aidoc:v1 sig=d7ee355 -->
     Task<List<PatientObservation?>> AggregatedPatientActiveIntravenousLinesObservations(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves the most recent observation timestamp for every patient, returning a mapping of patient identifiers to their last observation times.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a dictionary where each key is a patient <see cref="ObjectId"/> and the associated value is the date and time of that patient's last observation.</returns>
+    /// <!-- aidoc:v1 sig=cbcaa4c -->
     Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime();
 
     /// <summary>
@@ -189,6 +211,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </summary>
     /// <param name="id">The unique identifier of the patient observation to locate.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> that resolves to the matching <see cref="PatientObservation"/>, or <c>null</c> if no observation exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=1d8d07e -->
     Task<PatientObservation?> FindById(ObjectId id);
 
     /// <summary>
@@ -196,11 +219,13 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose observations are being retrieved.</param>
     /// <returns>A task containing a list of <see cref="PatientObservation"/> objects for the specified patient, or null if no observations are found.</returns>
+    /// <!-- aidoc:v1 sig=331eec2 -->
     Task<List<PatientObservation>?> FindByPatientId(ObjectId id);
     /// <summary>
     /// Updates an existing patient observation with the provided data.
     /// </summary>
     /// <param name="observation">The patient observation containing the updated information to be persisted.</param>
+    /// <!-- aidoc:v1 sig=86309e7 -->
     Task Update(PatientObservation observation);
     /// <summary>
     /// Updates many records by replacing the specified old ObjectId with the new ObjectId identified by the given name.
@@ -208,6 +233,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="nameId">The name identifier used to locate the target collection or field to update.</param>
     /// <param name="id">The new ObjectId to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId that identifies the records to be updated.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 
     /// <summary>
@@ -215,6 +241,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </summary>
     /// <param name="filterObservations">An optional list of observation identifiers used to narrow the result set. May be null or contain null entries.</param>
     /// <returns>A task that resolves to a collection of non-expired <see cref="PatientObservation"/> instances matching the filter criteria.</returns>
+    /// <!-- aidoc:v1 sig=dc784c5 -->
     Task<IEnumerable<PatientObservation>> FindNotExpired(List<string?>? filterObservations);
 
     /// <summary>
@@ -223,6 +250,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="name">The name used to look up the patient observations.</param>
     /// <param name="date">The optional date used to filter the observations; when null, results are not restricted by date.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="PatientObservation"/> entries that match the criteria.</returns>
+    /// <!-- aidoc:v1 sig=239fa0e -->
     Task<IEnumerable<PatientObservation>> FindByName(string name, DateTime? date);
 
     /// <summary>
@@ -230,18 +258,22 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </summary>
     /// <param name="patientObservations">The collection of patient observations to update.</param>
     /// <param name="update">The update definition describing the modifications to apply to each patient observation.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states documents are updated because they 'match the provided update definition', but the update definition describes modifications, not a filter. The method takes an explicit collection of patient observations and applies the update to each, rather than matching documents by the update definition." -->
     Task UpdateMany(IEnumerable<PatientObservation> patientObservations, UpdateDefinition<PatientObservation> update);
 
     /// <summary>
     /// Retrieves all patient observation records.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a collection of <see cref="PatientObservation"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=e3a2156 -->
     Task<IEnumerable<PatientObservation>> FindAll();
 
     /// <summary>
     /// Asynchronously processes and expires the specified configuration observations that have met their expiration criteria.
     /// </summary>
     /// <param name="configObservationsToExpire">The list of configuration observations to expire.</param>
+    /// <!-- aidoc:v1 sig=2a24be0 -->
     Task ExpireExpiredObservations(List<ConfigObservation> configObservationsToExpire);
     //Task<PaginationResponse<PatientObservation>> GetPaginatedObservations(PaginationFilter filter);
 
@@ -250,6 +282,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// </summary>
     /// <param name="filter">The pagination filter that defines the page size, page number, and sorting criteria applied to the observations.</param>
     /// <returns>An <see cref="IFindFluent{TSource, TDocument}"/> for <see cref="PatientObservation"/> that allows further refinement and execution of the paginated query.</returns>
+    /// <!-- aidoc:v1 sig=e6754ed -->
     IFindFluent<PatientObservation, PatientObservation> GetPaginatedObservations(PaginationFilter filter);
 
     /// <summary>
@@ -260,6 +293,7 @@ public interface IObservationRepository : IMongoRepository<PatientObservation>
     /// <param name="endAfter">Optional pagination cursor indicating the number of results to skip.</param>
     /// <param name="num">Optional maximum number of observations to return.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of matching <see cref="PatientObservation"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=ba8e6f1 -->
     Task<IEnumerable<PatientObservation>> FindLastNotExpiredObservatonsByPatient(ObjectId patientId, string name,
             int? endAfter = null, int? num = null);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPatientArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IPatientArchiveRepository.cs
index cacbab35..ff0ef5cd 100644
--- a/adas-core.Application/Repositories/Interfaces/IPatientArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPatientArchiveRepository.cs
@@ -10,12 +10,14 @@ public interface IPatientArchiveRepository : IMongoRepository<Patient>
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <returns>A <see cref="Patient"/> instance if a match is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=fc426b5 -->
     Task<Patient?> FindByPatientNumber(string patientNumber);
 
     /// <summary>
     /// Retrieves all patients from the data source.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Patient"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=350dff6 -->
     Task<List<Patient>> FindAll();
     /// <summary>
     /// Searches for a patient by patient number within a specific distinct unit.
@@ -23,5 +25,6 @@ public interface IPatientArchiveRepository : IMongoRepository<Patient>
     /// <param name="patientNumber">The patient number used to locate the patient.</param>
     /// <param name="unitId">The identifier of the distinct unit in which to perform the search.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=1d70651 -->
     Task<Patient?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPatientCarePlanRepository.cs b/adas-core.Application/Repositories/Interfaces/IPatientCarePlanRepository.cs
index 9284da7d..0805ddcb 100644
--- a/adas-core.Application/Repositories/Interfaces/IPatientCarePlanRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPatientCarePlanRepository.cs
@@ -10,17 +10,20 @@ public interface IPatientCarePlanRepository : IMongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> records for the patient, or an empty list if no care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=6525ef9 -->
     Task<List<PatientCarePlan>> FindByPatientId(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves the list of patient care plans associated with the specified user identifier.
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose patient care plans are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects linked to the specified user.</returns>
+    /// <!-- aidoc:v1 sig=150426f -->
     Task<List<PatientCarePlan>> FindByUserId(ObjectId userId);
     /// <summary>
     /// Asynchronously retrieves all patient care plans from the data store.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of all <see cref="PatientCarePlan"/> records.</returns>
+    /// <!-- aidoc:v1 sig=83af170 -->
     Task<List<PatientCarePlan>> FindAll();
     /// <summary>
     /// Updates all records that reference the specified old ObjectId so they are associated with the new patient ObjectId.
@@ -28,5 +31,6 @@ public interface IPatientCarePlanRepository : IMongoRepository<PatientCarePlan>
     /// <param name="patientid">The string identifier of the patient whose related records will be updated.</param>
     /// <param name="patientId">The new ObjectId that will replace the previous identifier in the matching records.</param>
     /// <param name="oldId">The previous ObjectId whose references should be replaced across the matching records.</param>
+    /// <!-- aidoc:v1 sig=7e33b89 -->
     Task UpdateManyObjectId(string patientid, ObjectId patientId, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPatientRepository.cs b/adas-core.Application/Repositories/Interfaces/IPatientRepository.cs
index e5d2174b..e26012ab 100644
--- a/adas-core.Application/Repositories/Interfaces/IPatientRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPatientRepository.cs
@@ -14,36 +14,42 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// Deletes the item identified by the specified identifier.
     /// </summary>
     /// <param name="id">The identifier of the item to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Patient"/> associated with the specified location, or <see langword="null"/> if no patient is found at that location.
     /// </summary>
     /// <param name="location">The location used to look up the patient.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="Patient"/> if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=f818833 -->
     Task<Patient?> FindByLocation(PatientLocation location);
     /// <summary>
     /// Retrieves a patient by their unique identifier, returning <c>null</c> when no matching patient exists.
     /// </summary>
     /// <param name="id">The unique <see cref="ObjectId"/> of the patient to look up.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the matching <see cref="Patient"/>, or <c>null</c> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=bff0af8 -->
     Task<Patient?> FindById(ObjectId id);
     /// <summary>
     /// Asynchronously updates the location of a patient identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose location is to be updated.</param>
     /// <param name="location">The new patient location data to apply to the existing record.</param>
+    /// <!-- aidoc:v1 sig=80c429e -->
     Task UpdateLocation(ObjectId id, PatientLocation location);
     /// <summary>
     /// Updates the location of the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The identifier of the entity whose location will be updated.</param>
     /// <param name="location">The identifier of the new location to associate with the entity.</param>
+    /// <!-- aidoc:v1 sig=6663fab -->
     Task UpdateLocation(ObjectId id, ObjectId location);
     /// <summary>
     /// Updates the attending doctor for the record identified by the specified id.
     /// </summary>
     /// <param name="id">The identifier of the record whose attending doctor will be updated.</param>
     /// <param name="attendingDoctor">The person to be set as the new attending doctor.</param>
+    /// <!-- aidoc:v1 sig=08253ac -->
     Task UpdateAttendingDoctor(ObjectId id, Person attendingDoctor);
     /// <summary>
     /// Updates the patient data identified by the specified id, optionally updating the patient number when <paramref name="updatePatientNumber"/> is true.
@@ -52,11 +58,13 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="patientNumber">The patient number associated with the patient.</param>
     /// <param name="data">The new person data to apply to the patient record.</param>
     /// <param name="updatePatientNumber">Indicates whether the patient number should be updated; defaults to true.</param>
+    /// <!-- aidoc:v1 sig=c9778ad -->
     Task UpdatePatientData(ObjectId id, string patientNumber, Person data, bool updatePatientNumber = true);
     /// <summary>
     /// Updates the information of an existing patient in the system.
     /// </summary>
     /// <param name="patient">The patient entity containing the updated information to be persisted.</param>
+    /// <!-- aidoc:v1 sig=0688359 -->
     Task Update(Patient patient);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Patient"/> by their unique patient number.
@@ -64,68 +72,83 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the matching <see cref="Patient"/>, or <c>null</c> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=fc426b5 -->
     Task<Patient?> FindByPatientNumber(string patientNumber);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Patient"/> that matches the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient to look up.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=6132bff -->
     Task<Patient?> FindByPatientId(string patientId);
     /// <summary>
     /// Asynchronously retrieves all <see cref="Patient"/> records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Patient"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=350dff6 -->
     Task<List<Patient>> FindAll();
     /// <summary>
     /// Asynchronously retrieves a list of patients associated with the specified point of care.
     /// </summary>
     /// <param name="pointOfCare">The point of care identifier used to filter patients.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=c2cb9ce -->
     Task<List<Patient>> FindByPointOfCare(string pointOfCare);
     /// <summary>
     /// Asynchronously retrieves the list of patients associated with the specified point of care.
     /// </summary>
     /// <param name="pointOfCare">The unique identifier of the point of care used to filter patients.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of patients matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=a0a7e87 -->
     Task<List<Patient>> FindByPointOfCare(ObjectId pointOfCare);
     /// <summary>
     /// Retrieves a patient by their point-of-care identifier, returning <c>null</c> when no matching patient is found.
     /// </summary>
     /// <param name="pointOfCare">The unique identifier of the point-of-care location used to look up the patient.</param>
     /// <returns>A task that resolves to the matching <see cref="Patient"/>, or <c>null</c> if no patient is associated with the specified point-of-care id.</returns>
+    /// <!-- aidoc:v1 sig=dd213b7 -->
     Task<Patient?> FindByPointOfCareId(ObjectId pointOfCare);
     /// <summary>
     /// Asynchronously retrieves a list of patients who have been discharged.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of discharged <see cref="Patient"/> records.</returns>
+    /// <!-- aidoc:v1 sig=16d2227 -->
     Task<List<Patient>> FindDischargedPatients();
     /// <summary>
     /// Updates an existing patient record and returns the updated patient, or <see langword="null"/> if the patient was not found.
     /// </summary>
     /// <param name="updatedPatient">The patient containing the updated information.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Patient"/>, or <see langword="null"/> if no matching patient exists.</returns>
+    /// <!-- aidoc:v1 sig=1b69c26 -->
     Task<Patient?> UpdateOne(Patient updatedPatient);
     /// <summary>
     /// Asynchronously retrieves a list of patients who have an inactive Point of Care (PoC) assignment.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Patient"/> objects with inactive PoC status.</returns>
+    /// <!-- aidoc:v1 sig=1eb056c -->
     Task<List<Patient>> FindInActivePoC();
     /// <summary>
     /// Asynchronously retrieves a list of patients who are currently marked as inactive points of contact (PoC).
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of inactive PoC patients.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The method name 'FindInActivePoC' uses PascalCase with a capital 'A' in 'Active', indicating two separate words 'In Active' (i.e., patients currently in an active PoC status), not 'Inactive'. The documentation describes finding 'inactive PoC' patients, which contradicts the method name." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> description says 'a list of inactive PoC patients', but per the method name's PascalCase the result should be a list of patients in an active PoC." -->
     Task<List<Patient>> FindInInactivePoC();
     /// <summary>
     /// Retrieves a list of patients whose records have not been updated since the specified date.
     /// </summary>
     /// <param name="date">The cutoff date; patients last updated before this date will be included in the result.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Patient"/> objects that have not been updated since the specified date.</returns>
+    /// <!-- aidoc:v1 sig=25a6510 -->
     Task<List<Patient>> FindPatientsNotUpdatedSince(DateTime date);
     /// <summary>
     /// Asynchronously retrieves a patient from the data store by their unique identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if one is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=571fb89 -->
     Task<Patient?> FindByPatientId(ObjectId patientId);
     /// <summary>
     /// Updates the incoming data for the specified patient and returns the updated patient record.
@@ -133,6 +156,7 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="patientId">The unique identifier of the patient whose incoming data should be updated.</param>
     /// <param name="person">The patient object containing the incoming data to apply.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Patient"/>, or <c>null</c> if the patient was not found.</returns>
+    /// <!-- aidoc:v1 sig=367d157 -->
     Task<Patient?> UpdatePatientIncomingData(ObjectId patientId, Patient person);
     /// <summary>
     /// Updates the demographic data of an existing patient identified by the given identifier.
@@ -140,6 +164,7 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="patientId">The unique identifier of the patient whose demographic data is to be updated.</param>
     /// <param name="person">The patient object containing the updated demographic information.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Patient"/>, or <c>null</c> if the patient was not found.</returns>
+    /// <!-- aidoc:v1 sig=381b38d -->
     Task<Patient?> UpdatePatientDemographicData(ObjectId patientId, Patient person);
     /// <summary>
     /// Asynchronously retrieves the patient matching the specified unit and point of care identifier.
@@ -147,12 +172,14 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="unit">The identifier of the unit used to locate the patient.</param>
     /// <param name="pointOfCare">The point of care identifier used together with the unit to locate the patient.</param>
     /// <returns>A task that resolves to the <see cref="Patient"/> associated with the given unit and point of care.</returns>
+    /// <!-- aidoc:v1 sig=47b83cd -->
     Task<Patient> FindByUnitAndPocId(ObjectId unit, ObjectId pointOfCare);
     /// <summary>
     /// Asynchronously retrieves the total count of records associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose associated records should be counted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the total count of matching records.</returns>
+    /// <!-- aidoc:v1 sig=e0dfc62 -->
     Task<long> CountByUnitId(ObjectId unitId);
     /// <summary>
     /// Asynchronously searches for a patient by their patient number within a specific unit, ensuring the patient is associated with a distinct unit.
@@ -160,30 +187,35 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="patientNumber">The unique patient number used to identify the patient.</param>
     /// <param name="unitId">The identifier of the unit to constrain the search to a distinct unit context.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=1d70651 -->
     Task<Patient?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId);
     /// <summary>
     /// Retrieves a paginated, fluent query of patients based on the specified pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter that defines page size, page number, and additional criteria applied to the patient query.</param>
     /// <returns>An <see cref="IFindFluent{Patient, Patient}"/> representing the paginated patient query that can be further composed before execution.</returns>
+    /// <!-- aidoc:v1 sig=206a5f3 -->
     IFindFluent<Patient, Patient> GetPaginatedPatients(PaginationFilter filter);
     /// <summary>
     /// Asynchronously retrieves all patients who have completed procedures, filtering by the number of minutes that have elapsed since the procedure end date for archival purposes.
     /// </summary>
     /// <param name="archiveProcedureEndDateAfterMinutes">The number of minutes after the procedure end date used to determine which finished procedures are eligible for archive retrieval.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of patients with finished procedures matching the archive criteria.</returns>
+    /// <!-- aidoc:v1 sig=d37257e -->
     Task<List<Patient>> FindAllPatientWithFinishedProcedures(int archiveProcedureEndDateAfterMinutes);
     /// <summary>
     /// Asynchronously retrieves all patients whose tests have finished based on the specified archive end date threshold.
     /// </summary>
     /// <param name="archiveTestEndDateAfterMinutes">The number of minutes after which a test is considered finished and eligible for retrieval.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients with finished tests.</returns>
+    /// <!-- aidoc:v1 sig=bde5551 -->
     Task<List<Patient>> FindAllPatientWithFinishedTests(int archiveTestEndDateAfterMinutes);
     /// <summary>
     /// Retrieves all patients whose treatment has been finished and is eligible for archival based on the specified end date threshold.
     /// </summary>
     /// <param name="archiveTreatmentEndDateAfterMinutes">The number of minutes after the treatment end date used as the archival threshold.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients with finished treatments that meet the archival criteria.</returns>
+    /// <!-- aidoc:v1 sig=bef780c -->
     Task<List<Patient>> FindAllPatientWithFinishedTreatment(int archiveTreatmentEndDateAfterMinutes);
     /// <summary>
     /// Updates a master list option for the specified units and returns the patients affected by the change.
@@ -192,6 +224,7 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="opt">The DTO containing the master list option update details.</param>
     /// <param name="typeName">The name of the option type being updated.</param>
     /// <returns>A task that resolves to the list of patients impacted by the master list option update.</returns>
+    /// <!-- aidoc:v1 sig=56aa456 -->
     Task<List<Patient>> UpdateMasterListOption(List<ObjectId> unitIds, UpdateOptionMasterListDto opt, string typeName);
     /// <summary>
     /// Asynchronously retrieves a list of <see cref="Patient"/> objects associated with the specified unit identifiers and patient type.
@@ -199,6 +232,7 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="unitIds">The list of unit identifiers used to filter the patients to be returned.</param>
     /// <param name="typeName">The name of the patient type used to further refine the query results.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing a list of <see cref="Patient"/> objects matching the provided unit identifiers and type.</returns>
+    /// <!-- aidoc:v1 sig=0c3ac7e -->
     Task<List<Patient>> GetPatientsByUnitIds(List<ObjectId> unitIds, string typeName);
     /// <summary>
     /// Deletes the specified master list option and returns the patients affected by its removal.
@@ -207,5 +241,6 @@ public interface IPatientRepository : IMongoRepository<Patient>
     /// <param name="opt">The master list option to remove.</param>
     /// <param name="typeName">The name of the master list type to which the option belongs.</param>
     /// <returns>A task that yields the collection of patients impacted by deleting the master list option.</returns>
+    /// <!-- aidoc:v1 sig=263b587 -->
     Task<IEnumerable<Patient>> DeleteMasterListOption(List<ObjectId> unitIds, OptionList opt, string typeName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPoCMappingRepository.cs b/adas-core.Application/Repositories/Interfaces/IPoCMappingRepository.cs
index 73bee6be..71f97b93 100644
--- a/adas-core.Application/Repositories/Interfaces/IPoCMappingRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPoCMappingRepository.cs
@@ -10,10 +10,12 @@ public interface IPoCMappingRepository
     /// </summary>
     /// <param name="key">The key used to look up the <see cref="PoCMapping"/>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="PoCMapping"/> if found, or <c>null</c> if no mapping exists for the specified key.</returns>
+    /// <!-- aidoc:v1 sig=84febd1 -->
     Task<PoCMapping?> FindByKey(string key);
     /// <summary>
     /// Retrieves the name of the collection associated with the current context or entity.
     /// </summary>
     /// <returns>The collection name as a string.</returns>
+    /// <!-- aidoc:v1 sig=a1be5ef -->
     string GetCollectionName();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPoCSettingsRepository.cs b/adas-core.Application/Repositories/Interfaces/IPoCSettingsRepository.cs
index 05e4e823..e6e67ee3 100644
--- a/adas-core.Application/Repositories/Interfaces/IPoCSettingsRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPoCSettingsRepository.cs
@@ -10,6 +10,7 @@ public interface IPoCSettingsRepository : IMongoRepository<PoCSettings>
     /// Asynchronously deletes the entity identified by the specified <see cref="ObjectId"/>.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
 
     /// <summary>
@@ -17,6 +18,7 @@ public interface IPoCSettingsRepository : IMongoRepository<PoCSettings>
     /// </summary>
     /// <param name="location">The patient location used to look up the corresponding PoC settings.</param>
     /// <returns>A task that returns the matching <see cref="PoCSettings"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=5eb997f -->
     Task<PoCSettings?> FindByLocation(PatientLocation location);
 
     /// <summary>
@@ -24,6 +26,7 @@ public interface IPoCSettingsRepository : IMongoRepository<PoCSettings>
     /// </summary>
     /// <param name="id">The unique identifier of the PoC settings to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The result contains the matching <see cref="PoCSettings"/> if found, or <c>null</c> when no settings exist for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=2527bbc -->
     Task<PoCSettings?> FindById(ObjectId id);
 
     /// <summary>
@@ -31,11 +34,13 @@ public interface IPoCSettingsRepository : IMongoRepository<PoCSettings>
     /// </summary>
     /// <param name="pocSettings">The PoC settings to be applied.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=6d3c931 -->
     Task Update(PoCSettings pocSettings);
 
     /// <summary>
     /// Asynchronously retrieves all <see cref="PoCSettings"/> records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="PoCSettings"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=b718f84 -->
     Task<List<PoCSettings>> FindAll();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPointOfCareRepository.cs b/adas-core.Application/Repositories/Interfaces/IPointOfCareRepository.cs
index 2e44b9ea..4174630c 100644
--- a/adas-core.Application/Repositories/Interfaces/IPointOfCareRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPointOfCareRepository.cs
@@ -14,12 +14,14 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// Asynchronously deletes the entity identified by the specified <paramref name="id"/>.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=0112d17 -->
     Task Delete(ObjectId id);
 
     /// <summary>
     /// Asynchronously updates the specified <see cref="PointOfCare"/> entity.
     /// </summary>
     /// <param name="pointOfCare">The <see cref="PointOfCare"/> instance containing the updated data to be persisted.</param>
+    /// <!-- aidoc:v1 sig=3647fc3 -->
     Task Update(PointOfCare pointOfCare);
 
     /// <summary>
@@ -27,6 +29,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="id">The identifier of the object whose unit will be updated.</param>
     /// <param name="unit">The unit value to apply to the object.</param>
+    /// <!-- aidoc:v1 sig=d53662b -->
     Task UpdateUnitId(ObjectId id, Unit unit);
 
     /// <summary>
@@ -34,6 +37,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="id">The unique identifier of the point of care configuration to update.</param>
     /// <param name="configuration">The new configuration values to apply to the existing point of care record.</param>
+    /// <!-- aidoc:v1 sig=92922a6 -->
     Task UpdateConfiguration(ObjectId id, PointOfCareConfiguration configuration);
 
     /// <summary>
@@ -41,6 +45,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="id">The unique identifier of the point of care to locate.</param>
     /// <returns>A task that yields the matching <see cref="PointOfCare"/>, or <c>null</c> if no record exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=f01a187 -->
     Task<PointOfCare?> FindById(ObjectId id);
 
     /// <summary>
@@ -48,6 +53,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="unit">The <see cref="ObjectId"/> of the unit whose points of care should be returned.</param>
     /// <returns>A task that yields an <see cref="IEnumerable{T}"/> of <see cref="PointOfCare"/> for the matching unit, or <c>null</c> when no results are found.</returns>
+    /// <!-- aidoc:v1 sig=d969dd8 -->
     Task<IEnumerable<PointOfCare>?> FindAllByUnitId(ObjectId unit);
 
     /// <summary>
@@ -55,6 +61,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="room">The room identifier used to look up the corresponding points of care.</param>
     /// <returns>A task that represents the asynchronous operation. The result is a collection of <see cref="PointOfCare"/> matching the specified room, or <see langword="null"/> if no matching points of care are found.</returns>
+    /// <!-- aidoc:v1 sig=4637691 -->
     Task<IEnumerable<PointOfCare>?> FindByRoom(string room);
 
     /// <summary>
@@ -63,6 +70,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// <param name="filter">The filter definition used to match <see cref="PointOfCare"/> entities in the data store.</param>
     /// <param name="projection">An optional projection definition that limits or shapes the fields returned in each result. If <c>null</c>, the full <see cref="PointOfCare"/> entity is returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PointOfCare"/> entities that satisfy the filter. Returns an empty list when no matching entities are found.</returns>
+    /// <!-- aidoc:v1 sig=e2b8c68 -->
     Task<List<PointOfCare>> FindByFilter(FilterDefinition<PointOfCare> filter,
             ProjectionDefinition<PointOfCare>? projection = null);
 
@@ -71,22 +79,26 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="bed">The bed identifier used to look up the associated points of care.</param>
     /// <returns>A task that yields an <see cref="IEnumerable{T}"/> of <see cref="PointOfCare"/> when matches exist, or <c>null</c> if none are found.</returns>
+    /// <!-- aidoc:v1 sig=604796d -->
     Task<IEnumerable<PointOfCare>?> FindByBed(string bed);
     /// <summary>
     /// Asynchronously retrieves all available points of care.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result is a list of <see cref="PointOfCare"/> instances, or <c>null</c> if no points of care are available.</returns>
+    /// <!-- aidoc:v1 sig=78b96d6 -->
     Task<List<PointOfCare>?> GetAll();
     /// <summary>
     /// Retrieves all Point of Care configurations available in the system.
     /// </summary>
     /// <returns>A task containing a list of <see cref="PointOfCare"/> configurations, or <c>null</c> if no configurations are found.</returns>
+    /// <!-- aidoc:v1 sig=2c3ec18 -->
     Task<List<PointOfCare>?> GetAllConfigs();
 
     /// <summary>
     /// Retrieves all Point of Care location information.
     /// </summary>
     /// <returns>A task that resolves to a list of <see cref="PointOfCare"/> locations, or <c>null</c> if no location data is available.</returns>
+    /// <!-- aidoc:v1 sig=591d801 -->
     Task<List<PointOfCare>?> GetAllLocationInfo();
 
     /// <summary>
@@ -95,6 +107,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="pocId">The unique identifier of the Point of Care whose configuration is being requested.</param>
     /// <returns>A task that resolves to the matching <see cref="PointOfCare"/> configuration, or null if no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=d108b88 -->
     Task<PointOfCare?> GetPoCConfiguration(ObjectId pocId);
 
 
@@ -104,6 +117,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// <param name="bed">The bed identifier used to locate the point of care; may be <see langword="null"/>.</param>
     /// <param name="unitId">The identifier of the unit in which the bed is located.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="PointOfCare"/>, or <see langword="null"/> if none is found.</returns>
+    /// <!-- aidoc:v1 sig=bcdaa77 -->
     Task<PointOfCare?> FindByBedAndUnitId(string? bed, ObjectId unitId);
 
     /// <summary>
@@ -111,6 +125,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="patientLocation">The patient location used to look up the corresponding point of care.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="PointOfCare"/>, or <c>null</c> if no point of care is found for the given patient location.</returns>
+    /// <!-- aidoc:v1 sig=9158434 -->
     Task<PointOfCare?> FindByPatientLocation(PatientLocation patientLocation);
 
     /// <summary>
@@ -121,6 +136,7 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// <param name="status">The point-of-care status used to filter the results.</param>
     /// <param name="excludeVirtual">When set to <c>true</c>, virtual points of care are excluded from the returned collection.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{PointOfCare}"/> of points of care matching the specified unit and status.</returns>
+    /// <!-- aidoc:v1 sig=cdc58d5 -->
     Task<IEnumerable<PointOfCare>> FindByUnitAndStatus(ObjectId unitId, StatusEnum.PointOfCare status,
             bool excludeVirtual = false);
 
@@ -129,12 +145,14 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="pocId">The unique identifier of the point of contact whose relay configuration is being updated.</param>
     /// <param name="relayConfig">The collection of relay entries to apply to the configuration.</param>
+    /// <!-- aidoc:v1 sig=c7679db -->
     Task UpdateRelayConfig(ObjectId pocId, List<Relay> relayConfig);
     /// <summary>
     /// Updates the relay configuration for the specified point of configuration (POC) using the provided list of relay configuration identifiers.
     /// </summary>
     /// <param name="pocId">The unique identifier of the point of configuration whose relay configuration will be updated.</param>
     /// <param name="relayConfig">The list of relay configuration identifiers to apply to the specified POC.</param>
+    /// <!-- aidoc:v1 sig=ed2237d -->
     Task UpdateRelayConfig(ObjectId pocId, List<ObjectId> relayConfig);
 
     /// <summary>
@@ -142,24 +160,28 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="filter">The pagination filter that defines paging parameters such as page number and page size.</param>
     /// <returns>An <see cref="IFindFluent{PointOfCare, PointOfCare}"/> representing the paginated query against the PoCs collection.</returns>
+    /// <!-- aidoc:v1 sig=0fe74b2 -->
     IFindFluent<PointOfCare, PointOfCare> GetPaginatedPoCs(PaginationFilter filter);
     /// <summary>
     /// Asynchronously counts the number of entities associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit used to filter the entities to be counted.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing the total count of matching entities.</returns>
+    /// <!-- aidoc:v1 sig=e0dfc62 -->
     Task<long> CountByUnitId(ObjectId unitId);
     /// <summary>
     /// Asynchronously counts the number of virtuals associated with the specified unit.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose virtuals will be counted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the count of virtuals for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=abeaf32 -->
     Task<long> CountVirtualsByUnitId(ObjectId unitId);
     /// <summary>
     /// Deletes multiple records associated with the specified unit identifier asynchronously.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose related records should be deleted.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=903a910 -->
     Task<bool> DeleteManyByUnitId(ObjectId unitId);
     /// <summary>
     /// Retrieves a <see cref="PointOfCare"/> entity by its identifier, including all associated configuration data.
@@ -167,26 +189,31 @@ public interface IPointOfCareRepository : IMongoRepository<PointOfCare>
     /// </summary>
     /// <param name="id">The unique identifier of the point of care to retrieve.</param>
     /// <returns>A task that resolves to the matching <see cref="PointOfCare"/> with all configuration, or <see langword="null"/> if not found.</returns>
+    /// <!-- aidoc:v1 sig=810206b -->
     Task<PointOfCare?> FindByIdAllConfig(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves the set of camera identifiers that are currently in use.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a hash set of <see cref="ObjectId"/> values for all cameras in use.</returns>
+    /// <!-- aidoc:v1 sig=5635e4a -->
     Task<HashSet<ObjectId>> FindAllIdCamerasInUse();
     /// <summary>
     /// Asynchronously retrieves all ID relays that are currently in use, returning them as a hash set for efficient lookup.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a hash set of the <see cref="ObjectId"/> values of all ID relays currently in use.</returns>
+    /// <!-- aidoc:v1 sig=a6e513b -->
     Task<HashSet<ObjectId>> FindAllIdRelaysInUse();
     /// <summary>
     /// Asynchronously retrieves the set of all ID beacons that are currently in use.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="HashSet{ObjectId}"/> with the identifiers of all ID beacons currently in use.</returns>
+    /// <!-- aidoc:v1 sig=3084f59 -->
     Task<HashSet<ObjectId>> FindAllIdBeaconsInUse();
     /// <summary>
     /// Retrieves all points of care associated with the specified unit identifier, including their related devices.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose points of care and associated devices are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of points of care with their associated devices, or <c>null</c> if no points of care are found for the specified unit.</returns>
+    /// <!-- aidoc:v1 sig=dbf2769 -->
     Task<IEnumerable<PointOfCare>?> FindAllByUnitIdWithDevices(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPumpAlarmEventRepository.cs b/adas-core.Application/Repositories/Interfaces/IPumpAlarmEventRepository.cs
index 212f35ec..f16710d2 100644
--- a/adas-core.Application/Repositories/Interfaces/IPumpAlarmEventRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPumpAlarmEventRepository.cs
@@ -9,6 +9,7 @@ public interface IPumpAlarmEventRepository
     /// Asynchronously inserts a pump alarm event into the underlying data store.
     /// </summary>
     /// <param name="alarmEvent">The pump alarm event to be persisted.</param>
+    /// <!-- aidoc:v1 sig=28b5d03 -->
     Task InsertAsync(PumpAlarmEvent alarmEvent);
 
     /// <summary>
@@ -19,6 +20,7 @@ public interface IPumpAlarmEventRepository
     /// <param name="to">Optional end of the date range used to filter the events.</param>
     /// <param name="limit">Optional maximum number of alarm events to return.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of pump alarm events matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=517b04b -->
     Task<IEnumerable<PumpAlarmEvent>> FindByDeviceIdAsync(
             string deviceId,
             DateTime? from = null,
@@ -31,6 +33,7 @@ public interface IPumpAlarmEventRepository
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose last pump alarm event is to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing the most recent <see cref="PumpAlarmEvent"/> for the device, or null if none exists.</returns>
+    /// <!-- aidoc:v1 sig=7150407 -->
     Task<PumpAlarmEvent?> FindLastByDeviceIdAsync(string deviceId);
 
     // cleanup
@@ -38,6 +41,7 @@ public interface IPumpAlarmEventRepository
     /// Deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose records should be deleted.</param>
+    /// <!-- aidoc:v1 sig=1e79565 -->
     Task DeleteByPatientId(ObjectId patientId);
     
     /// <summary>
@@ -47,5 +51,6 @@ public interface IPumpAlarmEventRepository
     /// <param name="newId">The new ObjectId value to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId value used to identify the records to be updated.</param>
     /// <returns>A task that represents the asynchronous operation, containing the number of records that were updated.</returns>
+    /// <!-- aidoc:v1 sig=2ba081a -->
     Task<long> UpdateManyObjectIdByFiledNameAsync(string fieldName, ObjectId newId, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPumpAlarmStateRepository.cs b/adas-core.Application/Repositories/Interfaces/IPumpAlarmStateRepository.cs
index 66f220fc..d7def3d7 100644
--- a/adas-core.Application/Repositories/Interfaces/IPumpAlarmStateRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPumpAlarmStateRepository.cs
@@ -14,6 +14,7 @@ public interface IPumpAlarmStateRepository
     /// <param name="alarmType">The optional alarm type to filter the search by; if <c>null</c>, no alarm type filter is applied.</param>
     /// <param name="alarmCodeMdc">The optional MDC alarm code to further filter the search; if <c>null</c>, no alarm code filter is applied.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the active <see cref="PumpAlarmState"/>, or <c>null</c> if no matching active alarm state exists.</returns>
+    /// <!-- aidoc:v1 sig=d7b60d9 -->
     Task<PumpAlarmState?> FindActiveAsync(
             string deviceId,
             PumpEnum.AlarmType? alarmType,
@@ -24,12 +25,14 @@ public interface IPumpAlarmStateRepository
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose active pump alarm states are being queried.</param>
     /// <returns>A task representing the asynchronous operation, containing a collection of active <see cref="PumpAlarmState"/> entries for the given device.</returns>
+    /// <!-- aidoc:v1 sig=1cb4d36 -->
     Task<IEnumerable<PumpAlarmState>> FindAllActiveByDeviceAsync(string deviceId);
 
     /// <summary>
     /// Inserts a new active pump alarm state or updates the existing one, maintaining the current state for the alarm.
     /// </summary>
     /// <param name="state">The pump alarm state to upsert as the active record.</param>
+    /// <!-- aidoc:v1 sig=3d8bd8b -->
     Task UpsertActiveAsync(PumpAlarmState state);
 
     /// <summary>
@@ -38,6 +41,7 @@ public interface IPumpAlarmStateRepository
     /// <param name="deviceId">The identifier of the device whose alarms should be removed.</param>
     /// <param name="alarmType">The optional alarm type to filter the removal; when null, all alarm types are considered.</param>
     /// <param name="alarmCodeMdc">The optional alarm code (MDC) to further filter the removal; when null, no code filter is applied.</param>
+    /// <!-- aidoc:v1 sig=1a5b895 -->
     Task RemoveAsync(
             string deviceId,
             PumpEnum.AlarmType? alarmType,
@@ -48,6 +52,7 @@ public interface IPumpAlarmStateRepository
     /// Deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=1e79565 -->
     Task DeleteByPatientId(ObjectId patientId);
     
     /// <summary>
@@ -57,5 +62,6 @@ public interface IPumpAlarmStateRepository
     /// <param name="newId">The new <see cref="ObjectId"/> value to assign.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced.</param>
     /// <returns>A <see cref="Task{T}"/> that represents the asynchronous operation. The task result contains the number of documents updated.</returns>
+    /// <!-- aidoc:v1 sig=dd74902 -->
     Task<long> UpdateManyObjectIdByFieldNameAsync(string fieldName, ObjectId newId, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPumpArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IPumpArchiveRepository.cs
index 58d20005..345c937c 100644
--- a/adas-core.Application/Repositories/Interfaces/IPumpArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPumpArchiveRepository.cs
@@ -14,16 +14,20 @@ namespace adas_core.Application.Repositories.Interfaces
         /// <summary>
         /// Inserta una observación de bomba en la colección de archivo.
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "The <param> for 'obs' (PumpObservation) is not documented." -->
         Task InsertAsync(PumpObservation obs);
 
         /// <summary>
         /// Inserta múltiples observaciones en la colección de archivo.
         /// </summary>
+        /// <!-- aidoc:v1 sig=0c99da2 -->
         Task InsertManyAsync(IEnumerable<PumpObservation> observations);
 
         /// <summary>
         /// Búsqueda por paciente para auditoría o restauración.
         /// </summary>
+        /// <!-- aidoc:v1 sig=5956bf6 -->
         Task<IEnumerable<PumpObservation>> FindByPatientIdAsync(ObjectId patientId,
             DateTime? from = null, DateTime? to = null, int? limit = null);
     }
diff --git a/adas-core.Application/Repositories/Interfaces/IPumpObservationRepository.cs b/adas-core.Application/Repositories/Interfaces/IPumpObservationRepository.cs
index bb5c5066..91054d7f 100644
--- a/adas-core.Application/Repositories/Interfaces/IPumpObservationRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPumpObservationRepository.cs
@@ -9,11 +9,13 @@ public interface IPumpObservationRepository
     /// Asynchronously inserts a pump observation into the underlying data store.
     /// </summary>
     /// <param name="obs">The pump observation entity to persist.</param>
+    /// <!-- aidoc:v1 sig=7782312 -->
     Task InsertAsync(PumpObservation obs);
     /// <summary>
     /// Asynchronously inserts a collection of pump observations into the underlying data store.
     /// </summary>
     /// <param name="observations">The collection of <see cref="PumpObservation"/> records to be persisted.</param>
+    /// <!-- aidoc:v1 sig=0c99da2 -->
     Task InsertManyAsync(IEnumerable<PumpObservation> observations);
 
     /// <summary>
@@ -24,6 +26,7 @@ public interface IPumpObservationRepository
     /// <param name="to">Optional inclusive upper bound for the observation timestamp; when null, no upper bound is applied.</param>
     /// <param name="limit">Optional maximum number of observations to return; when null, all matching observations are returned.</param>
     /// <returns>A task that represents the asynchronous operation, yielding an enumerable collection of <see cref="PumpObservation"/> instances matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=3f079d3 -->
     Task<IEnumerable<PumpObservation>> FindByDeviceIdAsync(
             string deviceId,
             DateTime? from = null,
@@ -35,11 +38,13 @@ public interface IPumpObservationRepository
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose last observation is being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the last <see cref="PumpObservation"/> for the device, or <c>null</c> if no observation exists for the given device.</returns>
+    /// <!-- aidoc:v1 sig=2ce7df1 -->
     Task<PumpObservation?> FindLastByDeviceIdAsync(string deviceId);
     /// <summary>
     /// Asynchronously retrieves the most recent observation time for all patients, returning a mapping of patient identifiers to their last observation timestamps.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a dictionary where each key is a patient <see cref="ObjectId"/> and the associated value is the <see cref="DateTime"/> of that patient's last observation.</returns>
+    /// <!-- aidoc:v1 sig=57fe6bb -->
     Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTimeAsync();
 
     /// <summary>
@@ -47,6 +52,7 @@ public interface IPumpObservationRepository
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose pump observations are being queried. May be <see langword="null"/>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the collection of <see cref="PumpObservation"/> items found for the patient, or an empty collection if no observations are found.</returns>
+    /// <!-- aidoc:v1 sig=882efc8 -->
     Task<IEnumerable<PumpObservation>> FindByPatientId(ObjectId? patientId);
 
     /// <summary>
@@ -55,11 +61,13 @@ public interface IPumpObservationRepository
     /// <param name="patientId">The unique identifier of the patient whose observations are being queried.</param>
     /// <param name="num">The maximum number of observations to return. Defaults to 100.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the patient's most recent <see cref="PumpObservation"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=c2169af -->
     Task<List<PumpObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num = 100);
     /// <summary>
     /// Deletes all records associated with the specified patient identifier. If the patient identifier is null, no deletion is performed.
     /// </summary>
     /// <param name="patientId">The optional patient identifier whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=c3af748 -->
     Task DeleteByPatientId(ObjectId? patientId);
     /// <summary>
     /// Asynchronously deletes records older than the specified number of days, optionally filtered by name, and returns the number of items removed.
@@ -67,12 +75,14 @@ public interface IPumpObservationRepository
     /// <param name="days">The age threshold in days; only records older than this value will be deleted.</param>
     /// <param name="name">An optional name used to filter which records are targeted for deletion. If null, deletion applies to all records regardless of name.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing the total count of deleted records.</returns>
+    /// <!-- aidoc:v1 sig=83b8dc2 -->
     Task<long> DeleteOlderThanDaysAsync(int days, string? name = null);
     /// <summary>
     /// Asynchronously deletes items, retaining only the most recent <paramref name="maxCount"/> entries, and returns the number of items that were removed.
     /// </summary>
     /// <param name="maxCount">The maximum number of most recent items to keep after the deletion.</param>
     /// <returns>A task representing the asynchronous operation, containing the count of items that were deleted.</returns>
+    /// <!-- aidoc:v1 sig=2548ed6 -->
     Task<long> DeleteKeepLastNAsync(int maxCount);
     
     /// <summary>
@@ -82,5 +92,6 @@ public interface IPumpObservationRepository
     /// <param name="newId">The new ObjectId value to assign to the field.</param>
     /// <param name="oldId">The optional current ObjectId value used as a filter; when <see langword="null"/>, the update is applied without filtering by the previous value.</param>
     /// <returns>A <see cref="Task{T}"/> that represents the asynchronous operation, containing the number of records updated.</returns>
+    /// <!-- aidoc:v1 sig=88b76ee -->
     Task<long> UpdateManyObjectIdByFieldAsync(string fieldName, ObjectId newId, ObjectId? oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IPumpStateRepository.cs b/adas-core.Application/Repositories/Interfaces/IPumpStateRepository.cs
index 31e36f5b..b6d0efbc 100644
--- a/adas-core.Application/Repositories/Interfaces/IPumpStateRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IPumpStateRepository.cs
@@ -10,17 +10,20 @@ public interface IPumpStateRepository
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose pump state is being looked up.</param>
     /// <returns>A task that resolves to the PumpState if a match is found, or null if no pump state exists for the specified device.</returns>
+    /// <!-- aidoc:v1 sig=ad2e179 -->
     Task<PumpState?> FindByDeviceIdAsync(string deviceId);
 
     /// <summary>
     /// Asynchronously creates or updates a pump state record in the data store.
     /// </summary>
     /// <param name="state">The pump state to be inserted if it does not exist, or updated if it already exists.</param>
+    /// <!-- aidoc:v1 sig=04c1a72 -->
     Task UpsertAsync(PumpState state);
 
     /// <summary>
     /// Asynchronously retrieves all available pump states.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of all <see cref="PumpState"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=46297e3 -->
     Task<IEnumerable<PumpState>> GetAllAsync();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IRecordingAlertArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/IRecordingAlertArchiveRepository.cs
index 86a2507c..99152d13 100644
--- a/adas-core.Application/Repositories/Interfaces/IRecordingAlertArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IRecordingAlertArchiveRepository.cs
@@ -8,16 +8,19 @@ public interface IRecordingAlertArchiveRepository : IMongoRepository<PatientReco
     /// Inserts a new patient recording alert into the underlying data store asynchronously.
     /// </summary>
     /// <param name="recordingAlert">The patient recording alert to be inserted.</param>
+    /// <!-- aidoc:v1 sig=f1cd52e -->
     new Task InsertOneAsync(PatientRecordingAlert recordingAlert);
     /// <summary>
     /// Asynchronously deletes records that have a date earlier than the specified threshold.
     /// </summary>
     /// <param name="date">The cutoff date; records with a date value before this will be removed.</param>
+    /// <!-- aidoc:v1 sig=350661d -->
     Task DeleteBeforeDate(DateTime date);
     /// <summary>
     /// Inserts a batch of <see cref="PatientRecordingAlert"/> entities into the data store in a single operation.
     /// </summary>
     /// <param name="recordingAlerts">The collection of patient recording alerts to insert.</param>
     /// <returns>A task that represents the asynchronous batch insert operation, containing the number of affected or inserted records.</returns>
+    /// <!-- aidoc:v1 sig=9f1ecad -->
     Task<long> InsertBatch(IEnumerable<PatientRecordingAlert> recordingAlerts);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IRecordingAlertRepository.cs b/adas-core.Application/Repositories/Interfaces/IRecordingAlertRepository.cs
index a624e876..de80d771 100644
--- a/adas-core.Application/Repositories/Interfaces/IRecordingAlertRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IRecordingAlertRepository.cs
@@ -12,6 +12,7 @@ public interface IRecordingAlertRepository : IMongoRepository<PatientRecordingAl
     /// <param name="patientId">The unique identifier of the patient whose recent alerts are being retrieved.</param>
     /// <param name="num">The maximum number of recent observations to return.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientRecordingAlert"/> entries for the patient's last observations.</returns>
+    /// <!-- aidoc:v1 sig=8f82904 -->
     Task<List<PatientRecordingAlert>> AggregatedPatientLastObservations(ObjectId patientId, int num);
 
     /// <summary>
@@ -21,17 +22,20 @@ public interface IRecordingAlertRepository : IMongoRepository<PatientRecordingAl
     /// <param name="name">The name of the observation to filter by.</param>
     /// <param name="num">The maximum number of recent observations to return. Defaults to 2.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientRecordingAlert"/> entries representing the matching observations.</returns>
+    /// <!-- aidoc:v1 sig=4c1f7cc -->
     Task<List<PatientRecordingAlert>> FindLastObservations(ObjectId patientId, string name, int num = 2);
     /// <summary>
     /// Asynchronously inserts a single <see cref="PatientRecordingAlert"/> into the underlying data store.
     /// </summary>
     /// <param name="patientRecordingAlert">The patient recording alert to be inserted.</param>
+    /// <!-- aidoc:v1 sig=95f54d7 -->
     new Task InsertOneAsync(PatientRecordingAlert patientRecordingAlert);
     /// <summary>
     /// Asynchronously deletes records older than the specified number of days, identified by the given name.
     /// </summary>
     /// <param name="name">The identifier or key used to locate the records to be evaluated for deletion.</param>
     /// <param name="value">The age threshold, in days, used to determine which records are considered older and eligible for deletion.</param>
+    /// <!-- aidoc:v1 sig=65b0e84 -->
     Task DeleteOlderDaysAsync(string name, int value);
     /// <summary>
     /// Asynchronously deletes a number record matching the specified name and value.
@@ -39,11 +43,14 @@ public interface IRecordingAlertRepository : IMongoRepository<PatientRecordingAl
     /// <param name="name">The name associated with the number to delete.</param>
     /// <param name="value">The numeric value of the record to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Method name 'DeleteOlderNumberAsync' implies deleting a number that is older than the specified value, but the summary describes a simple equality match on name and value, omitting the 'older' comparison semantics." -->
     Task DeleteOlderNumberAsync(string name, int value);
     /// <summary>
     /// Asynchronously deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique <see cref="ObjectId"/> of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=1e79565 -->
     Task DeleteByPatientId(ObjectId patientId);
     /// <summary>
     /// Updates many records by replacing the specified <paramref name="oldId"/> with the new <paramref name="id"/> within the collection identified by <paramref name="nameId"/>.
@@ -51,11 +58,13 @@ public interface IRecordingAlertRepository : IMongoRepository<PatientRecordingAl
     /// <param name="nameId">The name or identifier of the collection in which the update is performed.</param>
     /// <param name="id">The new ObjectId to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId used to locate the records to be updated.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
     /// <summary>
     /// Asynchronously retrieves all patient recording alerts associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose recording alerts are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing an asynchronous cursor over the matching <see cref="PatientRecordingAlert"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=7bf4b99 -->
     Task<IAsyncCursor<PatientRecordingAlert>> FindByPatientIdAsync(ObjectId patientId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IRelayRepository.cs b/adas-core.Application/Repositories/Interfaces/IRelayRepository.cs
index cd075259..bfb62abc 100644
--- a/adas-core.Application/Repositories/Interfaces/IRelayRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IRelayRepository.cs
@@ -13,6 +13,7 @@ public interface IRelayRepository : IMongoRepository<Relay>
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Relay"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=ffa341f -->
     Task<Relay?> GetById(ObjectId relayId);
     /// <summary>
     /// Retrieves the relays of the specified type from the provided configuration relay list.
@@ -20,24 +21,28 @@ public interface IRelayRepository : IMongoRepository<Relay>
     /// <param name="configurationRelayList">The list of relay object identifiers to search through.</param>
     /// <param name="type">The relay type used to filter the configuration relay list.</param>
     /// <returns>A list of relays matching the specified type; an empty list if no relays of that type are found.</returns>
+    /// <!-- aidoc:v1 sig=f35333c -->
     List<Relay> GetRelayByTypeInList(List<ObjectId> configurationRelayList, RelayEnum.Type type);
     /// <summary>
     /// Retrieves the <see cref="Relay"/> objects that correspond to the supplied configuration relay identifiers.
     /// </summary>
     /// <param name="configurationRelayList">The list of <see cref="ObjectId"/> values identifying the configuration relays to look up.</param>
     /// <returns>A <see cref="List{Relay}"/> containing the relays that match the provided configuration relay identifiers.</returns>
+    /// <!-- aidoc:v1 sig=8fbadfa -->
     List<Relay> GetRelayInList(List<ObjectId> configurationRelayList);
     /// <summary>
     /// Retrieves a paginated, filterable query of relays based on the specified pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter used to control paging and additional query criteria for the relay lookup.</param>
     /// <returns>An <see cref="IFindFluent{Relay, Relay}"/> representing the paginated query that can be further refined and executed.</returns>
+    /// <!-- aidoc:v1 sig=af5ebe2 -->
     IFindFluent<Relay, Relay> GetPaginatedRelays(PaginationFilter filter);
     /// <summary>
     /// Asynchronously inserts a single <see cref="Relay"/> record and returns the inserted entity, or <see langword="null"/> if the insertion did not produce a result.
     /// </summary>
     /// <param name="request">The <see cref="Relay"/> entity to be inserted.</param>
     /// <returns>A task that represents the asynchronous insert operation. The result is the inserted <see cref="Relay"/>, or <see langword="null"/> when no relay is returned.</returns>
+    /// <!-- aidoc:v1 sig=4bd4f3e -->
     Task<Relay?> InsertOneRelayAsync(Relay request);
     /// <summary>
     /// Updates an existing relay identified by the specified object identifier.
@@ -45,11 +50,13 @@ public interface IRelayRepository : IMongoRepository<Relay>
     /// <param name="objectId">The unique identifier of the relay to update.</param>
     /// <param name="relay">The relay object containing the updated information.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated relay, or <see langword="null"/> if no relay with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=6c6a3e9 -->
     Task<Relay?> UpdateRelayAsync(ObjectId objectId, Relay relay);
     /// <summary>
     /// Retrieves a relay by its name asynchronously, returning null if no matching relay is found.
     /// </summary>
     /// <param name="requestRelayName">The name of the relay to look up. May be null.</param>
     /// <returns>A task that represents the asynchronous lookup. The task result contains the matching relay, or null if no relay with the specified name exists.</returns>
+    /// <!-- aidoc:v1 sig=78bca23 -->
     Task<Relay?> GetByName(string? requestRelayName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/ISectionRepository.cs b/adas-core.Application/Repositories/Interfaces/ISectionRepository.cs
index 56e407b3..611ef684 100644
--- a/adas-core.Application/Repositories/Interfaces/ISectionRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/ISectionRepository.cs
@@ -10,12 +10,14 @@ public interface ISectionRepository : IMongoRepository<Section>
     /// </summary>
     /// <param name="location">The patient location used to filter the sections.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the list of sections matching the specified patient location.</returns>
+    /// <!-- aidoc:v1 sig=695f16c -->
     Task<List<Section>> FindByLocation(PatientLocation location);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Section"/> by its identifier, returning <c>null</c> when no matching section is found.
     /// </summary>
     /// <param name="id">The identifier of the section to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Section"/>, or <c>null</c> if no section with the specified identifier exists.</returns>
+    /// <!-- aidoc:v1 sig=762067a -->
     Task<Section?> FindById(object id);
     /// <summary>
     /// Asynchronously retrieves the <see cref="Section"/> that matches the specified identifier.
@@ -23,23 +25,27 @@ public interface ISectionRepository : IMongoRepository<Section>
     /// </summary>
     /// <param name="id">The unique identifier of the section to look up.</param>
     /// <returns>A <see cref="Task{Section}"/> that resolves to the matching <see cref="Section"/>, or <c>null</c> if no section is found.</returns>
+    /// <!-- aidoc:v1 sig=5b41cb2 -->
     Task<Section?> FindById(string id);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Section"/> that matches the specified section identifier.
     /// </summary>
     /// <param name="section">The section name or identifier used to look up the matching <see cref="Section"/>.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="Section"/>, or <c>null</c> if no section is found.</returns>
+    /// <!-- aidoc:v1 sig=a21b7e6 -->
     Task<Section?> FindBySection(string section);
     /// <summary>
     /// Asynchronously retrieves the <see cref="Section"/> associated with the specified point of care.
     /// </summary>
     /// <param name="pointOfCare">The point of care identifier used to look up the section.</param>
     /// <returns>A task that returns the matching <see cref="Section"/>, or <c>null</c> if no section is found for the given point of care.</returns>
+    /// <!-- aidoc:v1 sig=ddef70d -->
     Task<Section?> FindByPointOfCare(string pointOfCare);
     /// <summary>
     /// Asynchronously retrieves all sections.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="Section"/> items.</returns>
+    /// <!-- aidoc:v1 sig=9d69dd9 -->
     Task<List<Section>> GetAll();
 
     /// <summary>
@@ -47,6 +53,7 @@ public interface ISectionRepository : IMongoRepository<Section>
     /// </summary>
     /// <param name="section">The section entity containing the updated information.</param>
     /// <returns>A task that represents the asynchronous update operation, containing the updated section, or null if the section was not found.</returns>
+    /// <!-- aidoc:v1 sig=02e0747 -->
     Task<Section?> UpdateSection(Section section);
     //Task<Section?> UpdateSectionItems(Section section);
     //Task<Section?> UpdateSectionConfig(Section section);
@@ -57,5 +64,6 @@ public interface ISectionRepository : IMongoRepository<Section>
     /// </summary>
     /// <param name="section">The <see cref="Section"/> instance to be inserted.</param>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the inserted <see cref="Section"/>, or <see langword="null"/> if no section was inserted.</returns>
+    /// <!-- aidoc:v1 sig=cb4b0b2 -->
     Task<Section?> InsertOneSection(Section section);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IServiceConfigRepository.cs b/adas-core.Application/Repositories/Interfaces/IServiceConfigRepository.cs
index 4e055eed..e13422e5 100644
--- a/adas-core.Application/Repositories/Interfaces/IServiceConfigRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IServiceConfigRepository.cs
@@ -11,11 +11,13 @@ public interface IServiceConfigRepository : IMongoRepository<ServiceConfig>
     /// </summary>
     /// <param name="oid">The unique identifier of the service configuration to look up.</param>
     /// <returns>A <see cref="ServiceConfig"/> matching the provided identifier, or <c>null</c> if no configuration exists for that id.</returns>
+    /// <!-- aidoc:v1 sig=233d53e -->
     Task<ServiceConfig?> FindById(ObjectId oid);
     /// <summary>
     /// Retrieves a <see cref="ServiceConfig"/> by its identifier, returning <see langword="null"/> when no matching configuration is found.
     /// </summary>
     /// <param name="id">The unique identifier of the service configuration to look up.</param>
     /// <returns>A task that resolves to the matching <see cref="ServiceConfig"/>, or <see langword="null"/> if no configuration exists for the given id.</returns>
+    /// <!-- aidoc:v1 sig=9457927 -->
     Task<ServiceConfig?> FindById(string id);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/ITreatmentArchiveRepository.cs b/adas-core.Application/Repositories/Interfaces/ITreatmentArchiveRepository.cs
index 44b7fc1a..9320c537 100644
--- a/adas-core.Application/Repositories/Interfaces/ITreatmentArchiveRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/ITreatmentArchiveRepository.cs
@@ -9,17 +9,20 @@ public interface ITreatmentArchiveRepository
     /// Asynchronously inserts a new patient treatment record into the underlying data store.
     /// </summary>
     /// <param name="patientTreatment">The patient treatment entity to insert.</param>
+    /// <!-- aidoc:v1 sig=95ea25e -->
     Task InsertOneAsync(PatientTreatment patientTreatment);
     /// <summary>
     /// Asynchronously deletes items whose associated date is earlier than the specified cutoff date.
     /// </summary>
     /// <param name="date">The cutoff date; items dated before this value are removed.</param>
+    /// <!-- aidoc:v1 sig=350661d -->
     Task DeleteBeforeDate(DateTime date);
     /// <summary>
     /// Asynchronously inserts a batch of <see cref="PatientTreatment"/> records.
     /// </summary>
     /// <param name="treatments">The collection of patient treatment entities to be inserted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="long"/> value associated with the batch insertion.</returns>
+    /// <!-- aidoc:v1 sig=457cfa9 -->
     Task<long> InsertBatch(IEnumerable<PatientTreatment> treatments);
 
     /// <summary>
@@ -27,5 +30,6 @@ public interface ITreatmentArchiveRepository
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=1ec184e -->
     Task<List<PatientTreatment>> FindAllFromPatient(ObjectId patientId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/ITreatmentRepository.cs b/adas-core.Application/Repositories/Interfaces/ITreatmentRepository.cs
index 583d2c44..5fdf5e54 100644
--- a/adas-core.Application/Repositories/Interfaces/ITreatmentRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/ITreatmentRepository.cs
@@ -12,6 +12,7 @@ public interface ITreatmentRepository : IMongoRepository<PatientTreatment>
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{PatientTreatment}"/> of treatments for the patient; the collection is empty if no treatments are found.</returns>
+    /// <!-- aidoc:v1 sig=905ff5f -->
     Task<IEnumerable<PatientTreatment>> GetByPatientId(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves a patient treatment record from the data store that matches the specified identifier.
@@ -19,35 +20,41 @@ public interface ITreatmentRepository : IMongoRepository<PatientTreatment>
     /// </summary>
     /// <param name="id">The unique <see cref="ObjectId"/> of the patient treatment record to retrieve.</param>
     /// <returns>A <see cref="Task{IAsyncCursor{PatientTreatment}}"/> that yields a cursor containing the matching patient treatment, if any.</returns>
+    /// <!-- aidoc:v1 sig=8d884be -->
     Task<IAsyncCursor<PatientTreatment>> GetById(ObjectId id);
     /// <summary>
     /// Asynchronously inserts a new <see cref="PatientTreatment"/> record into the data store.
     /// </summary>
     /// <param name="treatment">The patient treatment entity to be persisted.</param>
     /// <returns>A <see cref="Task"/> that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=289f9f5 -->
     new Task InsertOneAsync(PatientTreatment treatment);
     /// <summary>
     /// Asynchronously deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=9f8dfa3 -->
     new Task DeleteAsync(ObjectId id);
     /// <summary>
     /// Updates an existing <see cref="PatientTreatment"/> record in the data store asynchronously.
     /// </summary>
     /// <param name="treatment">The <see cref="PatientTreatment"/> entity containing the updated information.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous update operation. The task result contains <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e966e11 -->
     Task<bool> Update(PatientTreatment treatment);
     /// <summary>
     /// Asynchronously retrieves the collection of <see cref="PatientTreatment"/> records associated with the specified patient identifier, returning the results as a cursor for streaming access.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A task that yields an <see cref="IAsyncCursor{TDocument}"/> of <see cref="PatientTreatment"/> records matching the given patient identifier.</returns>
+    /// <!-- aidoc:v1 sig=1be8597 -->
     Task<IAsyncCursor<PatientTreatment>> FindByPatientIdAsync(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves the collection of patient treatments associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of <see cref="PatientTreatment"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=8e33f27 -->
     Task<IEnumerable<PatientTreatment>> FindByPatientId(ObjectId patientId);
 
     /// <summary>
@@ -55,12 +62,14 @@ public interface ITreatmentRepository : IMongoRepository<PatientTreatment>
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose record should be deleted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the record was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=30d6841 -->
     Task<bool> DeleteByPatientId(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves the list of bolus treatments associated with the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose bolus treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> entries representing the patient's bolus treatments.</returns>
+    /// <!-- aidoc:v1 sig=a6b897b -->
     Task<List<PatientTreatment>> FindBolusTreatments(ObjectId patientId);
     /// <summary>
     /// Updates many records that reference a specific ObjectId, replacing the existing ObjectId with a new one.
@@ -69,12 +78,14 @@ public interface ITreatmentRepository : IMongoRepository<PatientTreatment>
     /// <param name="nameId">The name of the field/property that contains the ObjectId reference to be updated.</param>
     /// <param name="id">The new ObjectId value that will replace the existing reference.</param>
     /// <param name="oldId">The current ObjectId value to match and be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
     /// <summary>
     /// Retrieves a paginated, fluent queryable collection of patient treatments based on the provided pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter containing page size, page number, and other pagination criteria.</param>
     /// <returns>An <see cref="IFindFluent{TSource, TDocument}"/> for <see cref="PatientTreatment"/> that supports further fluent query composition and pagination.</returns>
+    /// <!-- aidoc:v1 sig=e758e90 -->
     IFindFluent<PatientTreatment, PatientTreatment> GetPaginatedTreatments(PaginationFilter filter);
     /// <summary>
     /// Asynchronously retrieves a list of active patient treatments for the specified patient, ordered according to the provided ordering criterion.
@@ -82,5 +93,6 @@ public interface ITreatmentRepository : IMongoRepository<PatientTreatment>
     /// <param name="patientId">The unique identifier of the patient whose active treatments are to be retrieved.</param>
     /// <param name="order">The ordering criterion applied to the returned list of treatments.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of active <see cref="PatientTreatment"/> objects for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=d9fb0b1 -->
     Task<List<PatientTreatment>> GetActiveTreatmentsByPatientIdAndOrder(ObjectId patientId, string order);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IUnitRepository.cs b/adas-core.Application/Repositories/Interfaces/IUnitRepository.cs
index fe6cfcfd..cd154e02 100644
--- a/adas-core.Application/Repositories/Interfaces/IUnitRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IUnitRepository.cs
@@ -15,6 +15,7 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// </summary>
     /// <param name="id">The identifier of the <see cref="Unit"/> to locate.</param>
     /// <returns>A task that resolves to the matching <see cref="Unit"/>, or <c>null</c> if no entity is found.</returns>
+    /// <!-- aidoc:v1 sig=ea48821 -->
     Task<Unit?> FindById(object id);
 
     /// <summary>
@@ -22,6 +23,7 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// </summary>
     /// <param name="section">The name of the section to search for.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the unit if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=ede1d64 -->
     Task<Unit?> FindByName(string section);
 
     //Task<Unit?> FindByPointOfCare(PointOfCare pointOfCare);
@@ -29,18 +31,21 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// Asynchronously retrieves all available units and returns them as a list.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Unit"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=8307d85 -->
     Task<List<Unit>> GetAll();
     /// <summary>
     /// Updates an existing unit in the underlying store and returns the updated entity.
     /// </summary>
     /// <param name="section">The unit containing the updated data to persist.</param>
     /// <returns>A task that resolves to the updated <see cref="Unit"/>, or <c>null</c> when the unit cannot be found.</returns>
+    /// <!-- aidoc:v1 sig=a321fce -->
     Task<Unit?> UpdateUnit(Unit section);
     /// <summary>
     /// Inserts a single <see cref="Unit"/> record and returns the inserted entity, or <see langword="null"/> if the insertion did not produce a result.
     /// </summary>
     /// <param name="unit">The <see cref="Unit"/> entity to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation. The task result contains the inserted <see cref="Unit"/>, or <see langword="null"/> when no unit is returned.</returns>
+    /// <!-- aidoc:v1 sig=f7169a1 -->
     Task<Unit?> InsertOneUnit(Unit unit);
     /// <summary>
     /// Retrieves the collection of units associated with the specified master list identifier and master list type.
@@ -48,18 +53,21 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// <param name="id">The unique identifier of the master list whose units should be retrieved.</param>
     /// <param name="masterListType">The type of the master list used to filter or scope the unit lookup.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of units linked to the specified master list.</returns>
+    /// <!-- aidoc:v1 sig=0faf184 -->
     Task<IEnumerable<Unit>> FindByMasterListId(ObjectId id, MasterListType masterListType);
     /// <summary>
     /// Asynchronously retrieves the collection of <see cref="Unit"/> entities associated with the specified master list identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the master list whose units are being requested.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{Unit}"/> with the units linked to the given master list.</returns>
+    /// <!-- aidoc:v1 sig=cf80d78 -->
     Task<IEnumerable<Unit>> FindByMasterListId(ObjectId id);
     /// <summary>
     /// Updates the unit master list based on the provided unit identifiers. Returns the updated <see cref="Unit"/> when the operation succeeds, or <c>null</c> when no matching unit is found.
     /// </summary>
     /// <param name="updateUnitListDto">The data transfer object containing the list of unit identifiers to update.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Unit"/>, or <c>null</c> if no unit was updated.</returns>
+    /// <!-- aidoc:v1 sig=4b7663f -->
     Task<Unit?> UpdateUnitMasterList(UpdateUnitIdListDto updateUnitListDto);
     /// <summary>
     /// Updates the name and title of an existing unit identified by the specified identifier.
@@ -68,6 +76,7 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// <param name="name">The new name to assign to the unit.</param>
     /// <param name="title">The new title to assign to the unit.</param>
     /// <returns>A task that represents the asynchronous update operation. The task result contains the updated <see cref="Unit"/>, or <c>null</c> if the unit was not found.</returns>
+    /// <!-- aidoc:v1 sig=a3c7afb -->
     Task<Unit?> UpdateUnitInfo(ObjectId unitId, string name, string title);
     /// <summary>
     /// Updates the configuration of a unit identified by the specified identifier.
@@ -75,12 +84,14 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// <param name="unitIdParsed">The parsed object identifier of the unit whose configuration will be updated.</param>
     /// <param name="unitConfiguration">The new configuration values to apply to the unit.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the configuration was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=bfe899b -->
     Task<bool> UpdateConfiguration(ObjectId unitIdParsed, UnitConfiguration unitConfiguration);
     /// <summary>
     /// Retrieves a paginated collection of <see cref="Unit"/> records based on the provided pagination criteria.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the page size, page number, and any additional filtering criteria.</param>
     /// <returns>An <see cref="IFindFluent{Unit, Unit}"/> representing the fluent query for the paginated units.</returns>
+    /// <!-- aidoc:v1 sig=4cab03f -->
     IFindFluent<Unit, Unit> GetPaginatedUnits(PaginationFilter filter);
     /// <summary>
     /// Asynchronously counts the number of units associated with the master list identified by the specified identifier and type.
@@ -88,5 +99,6 @@ public interface IUnitRepository : IMongoRepository<Unit>
     /// <param name="id">The unique identifier of the master list whose units should be counted.</param>
     /// <param name="masterListType">The type of the master list used to resolve the appropriate unit collection.</param>
     /// <returns>A task that represents the asynchronous operation, containing the total number of units matching the specified master list.</returns>
+    /// <!-- aidoc:v1 sig=d8cd4b6 -->
     Task<long> CountUnitsByMasterListId(ObjectId id, MasterListType masterListType);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Repositories/Interfaces/IUserRepository.cs b/adas-core.Application/Repositories/Interfaces/IUserRepository.cs
index 057ee5e4..cd607829 100644
--- a/adas-core.Application/Repositories/Interfaces/IUserRepository.cs
+++ b/adas-core.Application/Repositories/Interfaces/IUserRepository.cs
@@ -14,30 +14,35 @@ public interface IUserRepository : IMongoRepository<User>
     /// <param name="username">The username used to look up the user account.</param>
     /// <param name="password">The password used to authenticate the user.</param>
     /// <returns>A task that resolves to the authenticated <see cref="User"/>, or null if no user matches the provided credentials.</returns>
+    /// <!-- aidoc:v1 sig=6f5e55d -->
     Task<User?> GetUser(string username, string password);
     /// <summary>
     /// Retrieves a user by their unique identifier asynchronously.
     /// </summary>
     /// <param name="id">The unique identifier of the user to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="User"/> if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=ab4b64e -->
     Task<User?> GetById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a user matching the specified username. Returns <c>null</c> if no user is found.
     /// </summary>
     /// <param name="name">The username to look up.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="User"/> or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=117d092 -->
     Task<User?> GetByUserName(string name);
     /// <summary>
     /// Asynchronously retrieves a user by their name, returning null if no matching user is found.
     /// </summary>
     /// <param name="name">The name of the user to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the user with the specified name, or null if no matching user exists.</returns>
+    /// <!-- aidoc:v1 sig=c29096f -->
     Task<User?> GetByName(string name);
     /// <summary>
     /// Asynchronously retrieves the user associated with the specified authorities name.
     /// </summary>
     /// <param name="name">The authorities name used to look up the user.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="User"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=9c416d2 -->
     Task<User?> GetByUserAndAuthoritesName(string name);
     /// <summary>
     /// Updates an existing user in the system, optionally updating the user's password when the <paramref name="updatePass"/> flag is set.
@@ -45,16 +50,19 @@ public interface IUserRepository : IMongoRepository<User>
     /// <param name="user">The user entity containing the updated information to be persisted.</param>
     /// <param name="updatePass">A flag indicating whether the user's password should also be updated as part of this operation.</param>
     /// <returns>A task that returns the updated <see cref="User"/> entity, or <c>null</c> if the user was not found.</returns>
+    /// <!-- aidoc:v1 sig=41a6482 -->
     Task<User?> UpdateUser(User user, bool updatePass);
     /// <summary>
     /// Retrieves a paginated, fluent queryable collection of <see cref="User"/> entities based on the supplied pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter that defines paging parameters such as page number and page size.</param>
     /// <returns>An <see cref="IFindFluent{User, User}"/> representing the queryable, paginated user results.</returns>
+    /// <!-- aidoc:v1 sig=b888cec -->
     IFindFluent<User, User> GetPaginatedUsers(PaginationFilter filter);
     /// <summary>
     /// Retrieves the existing system user, creating a new one if it does not already exist.
     /// </summary>
     /// <returns>The existing or newly created system <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=35c711b -->
     Task<User> GetOrCreateSystemUser();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/AdminPanelService.cs b/adas-core.Application/Services/AdminPanelService.cs
index fc66111b..78d5ce8c 100644
--- a/adas-core.Application/Services/AdminPanelService.cs
+++ b/adas-core.Application/Services/AdminPanelService.cs
@@ -45,6 +45,7 @@ public class AdminPanelService(
     /// <param name="patient">The patient to archive.</param>
     /// <returns><c>true</c> if the patient was archived successfully.</returns>
     /// <exception cref="System.Exception">Rethrows any exception thrown by the underlying patient service after logging it to the console.</exception>
+    /// <!-- aidoc:v1 sig=5748d52 body=c9332aa -->
     public async Task<bool> ArchivePatient(Patient patient)
         {
             try
@@ -66,6 +67,7 @@ public class AdminPanelService(
     /// </summary>
     /// <param name="admRequest">The ADMPanel request containing the data used to populate the new patient.</param>
     /// <returns>The newly created <see cref="Patient"/> with its generated identifier.</returns>
+    /// <!-- aidoc:v1 sig=e3b8218 body=5262c4e -->
     public async Task<Patient?> CreatePatient(AdmPanelRequest admRequest)
         {
             var patient = new Patient
@@ -88,6 +90,7 @@ public class AdminPanelService(
     /// <exception cref="Exception">Thrown when the target <c>PointOfCareId</c> is already occupied by another patient.</exception>
     /// <exception cref="NotFoundException">Thrown when the requested <c>PointOfCareId</c> does not exist.</exception>
     /// <returns>The asynchronous <see cref="Task"/> representing the update operation.</returns>
+    /// <!-- aidoc:v1 sig=a5986e8 body=50adbb0 -->
     private async Task UpdateNewPatient(Patient patient, AdmPanelRequest admRequest)
         {
             if (!string.IsNullOrEmpty(admRequest.PatientNumber)) patient.PatientNumber = admRequest.PatientNumber;
@@ -159,6 +162,7 @@ public class AdminPanelService(
     /// <param name="id">The unique identifier of the patient to look up.</param>
     /// <returns>The patient matching the provided identifier.</returns>
     /// <exception cref="NotFoundException">Thrown when no patient is found for the specified identifier.</exception>
+    /// <!-- aidoc:v1 sig=4bd85a6 body=0e8a91a -->
     public async Task<Patient?> FindPatientById(ObjectId id)
         {
             return await patientService.FindById(id) ??
@@ -171,6 +175,7 @@ public class AdminPanelService(
     /// </summary>
     /// <param name="location">The location to search for a patient at.</param>
     /// <returns>A <see cref="Patient"/> if one is found at the specified location; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=63de0aa body=2e39863 -->
     public async Task<Patient?> FindPatientByLocation(PatientLocation location)
         {
             return await patientService.FindByLocation(location);
@@ -182,6 +187,7 @@ public class AdminPanelService(
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <returns>A <see cref="Patient"/> if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=b40610c body=3921bde -->
     public async Task<Patient?> FindPatientByPatientNumber(string patientNumber)
         {
             return await patientService.FindByPatientNumber(patientNumber);
@@ -194,6 +200,7 @@ public class AdminPanelService(
     /// <param name="oldPatient">The existing patient record currently stored in the database that will be updated.</param>
     /// <returns>A task that resolves to <c>true</c> when the patient data is successfully updated.</returns>
     /// <exception cref="ConflictException">Thrown when the request is missing the patient number, the patient payload is null, or the patient payload is empty.</exception>
+    /// <!-- aidoc:v1 sig=5977876 body=627aa0c -->
     public async Task<bool> UpdatePatientData(AdmPanelRequest request, Patient oldPatient)
         {
             //traer el paciente que se quiere actualizar con los valores que tenga en la base de datos a una variable
@@ -264,6 +271,7 @@ public class AdminPanelService(
     /// <param name="request">The admission panel request containing the patient identification data and optional location used to locate the patient.</param>
     /// <returns>The matching <see cref="Patient"/> if found.</returns>
     /// <exception cref="NotFoundException">Thrown when no patient matches the provided request criteria.</exception>
+    /// <!-- aidoc:v1 sig=7119165 body=2f82189 -->
     public async Task<Patient?> FindPatient(AdmPanelRequest request)
         {
             var findByLocation = !request.Location?.IsFullEmpty();
@@ -278,6 +286,7 @@ public class AdminPanelService(
     /// <param name="location">The location used to look up the patient.</param>
     /// <returns>The patient found at the specified location.</returns>
     /// <exception cref="NotFoundException">Thrown when no patient is found for the given location.</exception>
+    /// <!-- aidoc:v1 sig=f2942f8 body=9a2d8fd -->
     public async Task<Patient?> FindByLocation(PatientLocation location)
         {
             return await patientService.FindByLocation(location) ??
@@ -295,6 +304,7 @@ public class AdminPanelService(
     /// <param name="configObservation">The configuration observation containing the data to persist.</param>
     /// <returns>A task that resolves to <c>true</c> when the configuration is created successfully.</returns>
     /// <exception cref="ConflictException">Thrown when the configuration creation fails, indicated by a null result from the service call.</exception>
+    /// <!-- aidoc:v1 sig=78b448d body=4fbc231 -->
     public async Task<bool> CreateConfig(ConfigObservation configObservation)
         {
             _ = await configObservationService.CreateConfig(configObservation) ??
@@ -308,6 +318,7 @@ public class AdminPanelService(
     /// <param name="configObservation">The configuration observation to update.</param>
     /// <returns>A task that resolves to <c>true</c> when the configuration is successfully updated.</returns>
     /// <exception cref="ConflictException">Thrown when the underlying update operation fails, as indicated by a null result from the service.</exception>
+    /// <!-- aidoc:v1 sig=255c09c body=3656b65 -->
     public async Task<bool> UpdateConfig(ConfigObservation configObservation)
         {
             _ = await configObservationService.UpdateConfig(configObservation) ??
@@ -321,6 +332,7 @@ public class AdminPanelService(
     /// <param name="id">The unique identifier of the config observation item to delete.</param>
     /// <returns><c>true</c> when the config observation item is successfully removed.</returns>
     /// <exception cref="ConflictException">Thrown when the removal operation returns a null result, signaling a conflict with the delete request.</exception>
+    /// <!-- aidoc:v1 sig=ffc4d11 body=62f915b -->
     public async Task<bool> DeleteConfigObservationItem(ObjectId id)
         {
             _ = await configObservationService.RemoveConfigItem(id) ??
@@ -338,6 +350,7 @@ public class AdminPanelService(
     /// </summary>
     /// <param name="unit">The unit to be inserted.</param>
     /// <returns>The inserted unit with its associated Point of Care identifiers, or null if the unit could not be inserted.</returns>
+    /// <!-- aidoc:v1 sig=500cf23 body=7ff2f54 -->
     public async Task<Unit?> InsertUnit(Unit unit)
         {
             //Insertamos la unidad y creamos los PoCs por defecto para esa unidad
@@ -375,6 +388,7 @@ public class AdminPanelService(
     /// </summary>
     /// <param name="unit">The unit for which to build the dependency information DTO.</param>
     /// <returns>A task that resolves to a <see cref="UnitInfoDto"/> containing the unit's dependency counts, or <c>null</c> if an error occurs while retrieving the counts.</returns>
+    /// <!-- aidoc:v1 sig=709a3b7 body=bcab092 -->
     public async Task<UnitInfoDto?> GetUnitDependencyDto(Unit unit)
         {
             try
@@ -405,6 +419,12 @@ public class AdminPanelService(
     /// <returns><c>true</c> if the unit and its related resources were successfully deleted; otherwise, <c>false</c> when an error is caught and logged.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit is found for the specified <paramref name="unitId"/>.</exception>
     /// <exception cref="ConflictException">Thrown when the unit has patients assigned to it, preventing deletion.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "NotFoundException is caught by the surrounding catch (Exception e) block and never escapes the method; the method returns false instead." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "ConflictException is caught by the surrounding catch (Exception e) block and never escapes the method; the method returns false instead." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states the method 'Throws' NotFoundException and ConflictException, but the catch-all handler swallows them and converts errors into a false return value." -->
     public async Task<bool> DeleteUnitById(ObjectId unitId)
     {
         try
@@ -455,6 +475,7 @@ public class AdminPanelService(
     /// <param name="medicineId">The unique identifier of the medicine to retrieve.</param>
     /// <returns>The medicine matching the specified identifier.</returns>
     /// <exception cref="NotFoundException">Thrown when no medicine is found with the specified identifier.</exception>
+    /// <!-- aidoc:v1 sig=be77265 body=6784aa2 -->
     public async Task<Medicine?> GetMedicineById(ObjectId medicineId)
         {
             return await medicineService.GetMedicineById(medicineId) ??
@@ -467,6 +488,7 @@ public class AdminPanelService(
     /// <param name="medicine">The medicine to be created.</param>
     /// <returns>The created <see cref="Medicine"/>.</returns>
     /// <exception cref="ConflictException">Thrown when the medicine service fails to create the medicine.</exception>
+    /// <!-- aidoc:v1 sig=25564e2 body=595b03f -->
     public async Task<Medicine?> PostMedicine(Medicine medicine)
         {
             var newMedicine = await medicineService.PostMedicine(medicine) ??
@@ -481,6 +503,7 @@ public class AdminPanelService(
     /// <param name="medicine">The medicine entity containing the updated information to persist.</param>
     /// <returns>The updated <see cref="Medicine"/> returned by the service.</returns>
     /// <exception cref="ConflictException">Thrown when the update operation fails and the service returns a null result.</exception>
+    /// <!-- aidoc:v1 sig=baa8582 body=8e7d69d -->
     public async Task<Medicine?> UpdateMedicine(Medicine medicine)
         {
             var updatedMedicine = await medicineService.UpdateMedicine(medicine) ??
@@ -495,6 +518,8 @@ public class AdminPanelService(
     /// <returns>A task that resolves to <c>true</c> when the medicine has been successfully deleted.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="medicineId"/> is not a valid ObjectId format.</exception>
     /// <exception cref="ConflictException">Thrown when the medicine still exists after the delete operation, indicating the deletion failed.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "Documentation states ConflictException is thrown when the medicine still exists after deletion, but the code (`_ = await ... ?? throw new ConflictException(...)`) actually throws when GetMedicineById returns null, i.e., when the medicine does NOT exist after deletion." -->
     public async Task<bool> DeleteMedicineById(string medicineId)
         {
             if (!ObjectId.TryParse(medicineId, out var objectId))
diff --git a/adas-core.Application/Services/AdmissionService.cs b/adas-core.Application/Services/AdmissionService.cs
index 2256b58a..a4eab572 100644
--- a/adas-core.Application/Services/AdmissionService.cs
+++ b/adas-core.Application/Services/AdmissionService.cs
@@ -44,6 +44,7 @@ public class AdmissionService(
     /// Deletes the specified admission by delegating to the delete operation using the admission's identifier.
     /// </summary>
     /// <param name="admission">The admission entity to delete, identified by its <see cref="Admission.Id"/>.</param>
+    /// <!-- aidoc:v1 sig=bc9e848 body=3ba8fcf -->
     public async Task DeleteAdmissionAsync(Admission admission)
     {
         await DeleteAdmissionByIdAsync(admission.Id);
@@ -53,6 +54,7 @@ public class AdmissionService(
     /// Deletes an admission identified by the given id. If the admission is not found, the operation is skipped and logged; otherwise the admission is removed, any associated point of care is detached (clearing its <c>AdmissionId</c> and <c>Admission</c>) and set to <c>Available</c> when not currently <c>Locked</c> or <c>InUse</c>, a delete broadcast is sent, and an audit log entry is created.
     /// </summary>
     /// <param name="admissionId">The identifier of the admission to delete.</param>
+    /// <!-- aidoc:v1 sig=504429d body=50c3daa -->
     public async Task DeleteAdmissionByIdAsync(ObjectId admissionId)
     {
         var admissionAux = await admissionRepository.FindById(admissionId);
@@ -90,6 +92,7 @@ public class AdmissionService(
     /// Asynchronously deletes all admissions associated with the specified unit identifier by delegating the operation to the admission repository.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose admissions should be removed.</param>
+    /// <!-- aidoc:v1 sig=6db1fa4 body=5f644a1 -->
     public async Task DeleteAdmissionsByUnitId(ObjectId unitId)
     {
         _ = await admissionRepository.DeleteAdmissionsByUnitId(unitId);
@@ -101,6 +104,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admissionId">The unique identifier of the admission to retrieve.</param>
     /// <returns>The matching <see cref="Admission"/> with its <see cref="Admission.PatientLocation"/> populated when applicable, or null if no admission is found.</returns>
+    /// <!-- aidoc:v1 sig=5c1a39b body=869dd3e -->
     public async Task<Admission?> GetAdmissionByIdAsync(ObjectId admissionId)
     {
         var result = await admissionRepository.FindById(admissionId);
@@ -118,6 +122,7 @@ public class AdmissionService(
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="Admission"/> objects with patient location details populated for those linked to a point of care.</returns>
     /// <exception cref="NotFoundException">Thrown when the admission repository returns no results.</exception>
+    /// <!-- aidoc:v1 sig=d4fca15 body=37e0155 -->
     public async Task<IEnumerable<Admission>> GetAdmissionsAsync()
     {
         var resultList = await admissionRepository.FindAll() ??
@@ -141,6 +146,8 @@ public class AdmissionService(
     /// <returns>The newly inserted <see cref="Admission"/>, or <c>null</c> if no result is produced.</returns>
     /// <exception cref="ConflictException">Thrown when an admission with the same NHC already exists, or when the insertion fails to return a result.</exception>
     /// <exception cref="NotFoundException">Thrown when the specified Point of Care does not exist.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "The <returns> tag says 'or null if no result is produced', but the code uses `?? throw new ConflictException(...)` so the method never returns null — it throws instead. The null-return path does not exist." -->
     public async Task<Admission?> InsertAdmission(Admission admission)
     {
         var admissionAux = await admissionRepository.FindByNhc(admission.Nhc);
@@ -183,6 +190,7 @@ public class AdmissionService(
     /// If the admission is not found, the method returns without making changes; point of care lookups are only applied when a <c>PointOfCareId</c> is present and yields a result.
     /// </summary>
     /// <param name="admission">The admission entity containing the updated information to persist.</param>
+    /// <!-- aidoc:v1 sig=ca4e183 body=25ff85a -->
     public async Task UpdateAdmissionAsync(Admission admission)
     {
         var oldAdmission = await admissionRepository.FindById(admission.Id);
@@ -212,6 +220,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admission">The admission data used to create the patient and populate location, diagnosis, allergies, and other attributes.</param>
     /// <param name="isNew">When <c>false</c>, the admission record is deleted after a successful patient insertion; when <c>true</c>, the admission is retained.</param>
+    /// <!-- aidoc:v1 sig=f69ed33 body=b929523 -->
     public async Task AdmitPatient(Admission admission, bool isNew = false)
     {
         if (admission.PointOfCareId == null)
@@ -329,6 +338,7 @@ public class AdmissionService(
     /// Returns a patient to the admissions workflow by creating a new admission record, removing any existing discharge, and archiving the patient. Validates that the patient and its associated unit exist before proceeding, and only builds the admission when a point of care is assigned.
     /// </summary>
     /// <param name="patientId">The identifier of the patient to be returned to admissions.</param>
+    /// <!-- aidoc:v1 sig=17907a9 body=0185562 -->
     public async Task ReturnPatientToAdmissions(ObjectId patientId)
     {
         var patient = await patientService.FindById(patientId);
@@ -383,6 +393,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient to be returned to admissions.</param>
     /// <param name="adm">The admission context used to resolve the unit and point of care for the new admission record.</param>
+    /// <!-- aidoc:v1 sig=13b57d7 body=732c8f7 -->
     public async Task ReturnPatientToAdmissions(ObjectId patientId, Admission adm)
     {
         var patient = await patientService.FindById(patientId);
@@ -437,6 +448,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="location">The patient location used to filter admissions.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of admissions matching the specified location, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=4d1cb29 body=1520dd9 -->
     public async Task<List<Admission>> GetAdmissionByLocation(PatientLocation location)
     {
         try
@@ -456,6 +468,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="pocId">The identifier of the point of care whose admissions should be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing the list of admissions for the given point of care, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=24794e8 body=d8a4124 -->
     public async Task<List<Admission>> GetAdmissionByPointOfCareId(ObjectId pocId)
     {
         try
@@ -482,6 +495,7 @@ public class AdmissionService(
     /// <param name="pocId">The identifier of the point of care whose admissions will be retrieved.</param>
     /// <param name="locale">The locale used to translate the admission fields.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of admissions with their fields translated to the specified locale.</returns>
+    /// <!-- aidoc:v1 sig=2f28a6c body=8c5b998 -->
     public async Task<List<Admission>> GetAdmissionByPointOfCareIdAndLocale(ObjectId pocId, LocaleEnum locale)
     {
         var admissions = await GetAdmissionByPointOfCareId(pocId);
@@ -500,6 +514,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose admissions (without PoC) are being requested.</param>
     /// <returns>A task that returns a list of <see cref="Admission"/> objects for the given unit, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=a0f7f96 body=714008c -->
     public async Task<List<Admission>> GetAdmissionByUnitIdWithOutPoC(ObjectId unitId)
     {
         try
@@ -520,6 +535,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose admissions should be counted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the number of admissions for the given unit, or 0 if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=d15b339 body=27c30bc -->
     public async Task<long> CountAdmissionsByUnitId(ObjectId unitId)
     {
         try
@@ -540,6 +556,7 @@ public class AdmissionService(
     /// <param name="patientNumber">The unique patient number used as the primary search key.</param>
     /// <param name="unitId">The identifier of the unit used to filter the archived patient and admission searches.</param>
     /// <returns>A <see cref="PatientSearch"/> aggregating the current patient, archived patient, and admission data, including flags indicating whether the patient exists only in the archive and whether any of the three sources returned a result.</returns>
+    /// <!-- aidoc:v1 sig=b6a87e4 body=624e811 -->
     public async Task<PatientSearch?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId)
     {
         var patient = await patientService.FindByPatientNumber(patientNumber);
@@ -570,6 +587,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="patientNumber">The patient's clinical record number (NHC) used to look up the admission.</param>
     /// <returns>A task that resolves to the matching <see cref="Admission"/> if found, or <c>null</c> when no admission exists for the given patient number.</returns>
+    /// <!-- aidoc:v1 sig=3fe6f66 body=9a0b8ac -->
     public Task<Admission?> GetAdmissionByPatientNumber(string patientNumber)
     {
         return admissionRepository.FindByNhc(patientNumber);
@@ -581,6 +599,7 @@ public class AdmissionService(
     /// <param name="opt">The master list update options to apply to the matching admissions.</param>
     /// <param name="unitList">The collection of units whose admissions are affected by the update.</param>
     /// <param name="typeName">The name of the master list type being modified.</param>
+    /// <!-- aidoc:v1 sig=b539b7b body=000b050 -->
     public async Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList,
             string typeName)
     {
@@ -601,6 +620,7 @@ public class AdmissionService(
     /// <param name="opt">The master list option to remove from the admissions.</param>
     /// <param name="unitList">The collection of units whose admissions will be processed for the deletion.</param>
     /// <param name="typeName">The name of the option type being deleted.</param>
+    /// <!-- aidoc:v1 sig=cb62e44 body=c1573d6 -->
     public async Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName)
     {
         var unitIds = unitList.Select(x => x.Id).ToList();
@@ -622,6 +642,7 @@ public class AdmissionService(
     /// Required fields (Nhc, Origin, and Diagnosis) are validated before insert and update operations, and the method exits early when the admission or any required value is missing.
     /// </summary>
     /// <param name="apiRequest">The API request containing the admission payload and the operation type to execute.</param>
+    /// <!-- aidoc:v1 sig=229d8cd body=9f05a36 -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         try
@@ -681,6 +702,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="apiRequest">The API request to persist.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -691,6 +713,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admission">The current admission containing the updated PointOfCare identifier.</param>
     /// <param name="oldAdmission">The previous admission state used to identify the original PointOfCare to release.</param>
+    /// <!-- aidoc:v1 sig=4fcd57d body=2365bd2 -->
     private async Task HandlePointOfCareChange(Admission admission, Admission oldAdmission)
     {
         // Check if PointOfCare has changed.
@@ -747,6 +770,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="pointOfCareId">The identifier of the point of care whose status will be updated.</param>
     /// <param name="status">The new status to assign to the point of care.</param>
+    /// <!-- aidoc:v1 sig=2c82bd3 body=69fe4f4 -->
     private async Task SetPointOfCareStatus(ObjectId pointOfCareId, StatusEnum.PointOfCare status)
     {
         var pointOfCare = await pointOfCareService.FindById(pointOfCareId);
@@ -761,6 +785,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admission">The admission record to broadcast.</param>
     /// <param name="operation">The operation type associated with the broadcast.</param>
+    /// <!-- aidoc:v1 sig=c26bb38 body=b6386c1 -->
     private async void SendAdmissionBroadcast(Admission admission, OperationType operation)
     {
         try
@@ -783,6 +808,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admission">The admission whose broadcast is being sent; its Point of Care is used to select subscribers and locale-specific content.</param>
     /// <param name="operation">The type of operation to send to the subscribers.</param>
+    /// <!-- aidoc:v1 sig=078ad3d body=8427094 -->
     private async Task SendAdmissionBroadcastByPoC(Admission admission, OperationType operation)
     {
         if (!admission.PointOfCareId.HasValue)
@@ -821,6 +847,7 @@ public class AdmissionService(
     /// </summary>
     /// <param name="admission">The admission to broadcast, which supplies the target unit identifier.</param>
     /// <param name="operation">The operation type associated with the broadcast message.</param>
+    /// <!-- aidoc:v1 sig=d37a566 body=b40a845 -->
     private async Task SendAdmissionByUnitId(Admission admission, OperationType operation)
     {
         if (admission.UnitId == ObjectId.Empty)
@@ -855,6 +882,7 @@ public class AdmissionService(
     /// <param name="admission">The admission whose reference names will be updated with localized values.</param>
     /// <param name="locale">The locale used to retrieve the appropriate master list translations.</param>
     /// <returns>The same <see cref="Admission"/> instance with its localized reference names applied when available.</returns>
+    /// <!-- aidoc:v1 sig=0afb3a4 body=2138792 -->
     private async Task<Admission> GetAdmissionWithLocale(Admission admission, LocaleEnum locale)
     {
         var unit = await unitService.FindById(admission.UnitId);
diff --git a/adas-core.Application/Services/AlarmService.cs b/adas-core.Application/Services/AlarmService.cs
index cfe9d0ff..a7c34aae 100644
--- a/adas-core.Application/Services/AlarmService.cs
+++ b/adas-core.Application/Services/AlarmService.cs
@@ -21,6 +21,7 @@ namespace adas_core.Application.Services;
 /// Provides the concrete implementation of the <see cref="IAlarmService"/> contract,
 /// encapsulating the business logic for managing and processing alarms within the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=060faf3 -->
 public class AlarmService : IAlarmService
 {
     private readonly IAlarmRepository _alarmRepository;
@@ -122,6 +123,7 @@ public class AlarmService : IAlarmService
     /// <param name="apiRequest">The API request containing patient, location, observation, and alarm data to process.</param>
     /// <exception cref="InvalidFormatException">Thrown when both the patient number and location unit name are missing.</exception>
     /// <exception cref="ApiRequestException">Thrown when the API request type is not valid for observations.</exception>
+    /// <!-- aidoc:v1 sig=229d8cd body=405bafb -->
     public async Task SaveRequest(ApiRequest apiRequest)
         {
             if (
@@ -178,6 +180,7 @@ public class AlarmService : IAlarmService
     /// Asynchronously saves the specified API request by delegating to the underlying save operation.
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
+    /// <!-- aidoc:v1 sig=655d140 body=fe3d8b2 -->
     public async Task SaveRequestAsync(ApiRequest apiRequest)
         {
             await SaveRequest(apiRequest);
@@ -190,6 +193,7 @@ public class AlarmService : IAlarmService
     /// <param name="obs">The patient observation alarm to be mapped.</param>
     /// <param name="onlyByName">If true, mapping is performed by name only; otherwise the full mapping is applied.</param>
     /// <returns>A mapped <see cref="PatientObservationAlarm"/> if both mapping steps succeed; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=78ca950 body=5f19c29 -->
     public async Task<PatientObservationAlarm?> MapObservation(PatientObservationAlarm obs, bool onlyByName = false)
         {
             try
@@ -229,6 +233,7 @@ public class AlarmService : IAlarmService
     /// <param name="patientId">The identifier of the patient whose last observations should be retrieved.</param>
     /// <param name="filterObservations">An optional list of fields used to restrict which observations are returned; when null, no field filter is applied.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the patient's last <see cref="PatientObservationAlarm"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=a25fefd body=4cd8879 -->
     public async Task<List<PatientObservationAlarm>> FindLastObservationsByField(ObjectId patientId,
             List<Field>? filterObservations = null)
         {
@@ -244,6 +249,7 @@ public class AlarmService : IAlarmService
     /// <param name="filterObservations">The list of fields used to filter the observations included in the aggregation.</param>
     /// <param name="configAlarm">The list of alarm configurations that define the criteria applied during the aggregation.</param>
     /// <returns>A task that resolves to a list of the latest non-expired <see cref="PatientObservationAlarm"/> entries matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=2739a83 body=5e76a47 -->
     public async Task<List<PatientObservationAlarm>> FindLastValuesNotExpired(ObjectId patientId,
             List<Field> filterObservations, List<ConfigObservation> configAlarm)
         {
@@ -258,6 +264,7 @@ public class AlarmService : IAlarmService
     /// </summary>
     /// <param name="obs">The patient observation alarm to be mapped by name.</param>
     /// <returns>A task that returns the mapped <see cref="PatientObservationAlarm"/> if a matching configuration is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=5372879 body=c476eb8 -->
     public async Task<PatientObservationAlarm?> MapObservationsByName(PatientObservationAlarm obs)
         {
             return await _configObservationService.Map(obs, true);
@@ -271,6 +278,7 @@ public class AlarmService : IAlarmService
     /// <param name="patient">The patient the alarms are associated with.</param>
     /// <param name="messageTime">The message time assigned to each alarm.</param>
     /// <param name="observationData">Optional parent observation metadata applied to all alarms in the batch.</param>
+    /// <!-- aidoc:v1 sig=c249a9d body=81d79c0 -->
     public async Task ProcessAlarmObservations(List<PatientObservationAlarm> alarmObservations,
             List<PatientObservation> observations, Patient patient,
             DateTime messageTime, ObservationData? observationData = null)
@@ -398,6 +406,7 @@ public class AlarmService : IAlarmService
     /// <param name="obs">The patient observation alarm to insert.</param>
     /// <param name="persistObs">Indicates whether the observation should be persisted to the repository. Defaults to true and is forced to false if the observation's <c>Persist</c> property is false.</param>
     /// <param name="mapObs">Indicates whether the observation should be mapped before being processed. Set to false only when the observation originates from the inner refactor job.</param>
+    /// <!-- aidoc:v1 sig=a04333a body=d8cb988 -->
     private async Task InsertObservation(PatientObservationAlarm obs, bool persistObs = true, bool mapObs = true)
         {
             try
@@ -436,6 +445,7 @@ public class AlarmService : IAlarmService
     /// Skips observations without a name and returns silently when the associated patient cannot be resolved from the observation or the patient service.
     /// </summary>
     /// <param name="obs">The patient observation to be sent to matching subscribers as an alarm operation.</param>
+    /// <!-- aidoc:v1 sig=52a60f2 body=dc24760 -->
     private async Task SendObsBroadcast(BasePatientObservation obs)
         {
             if (obs.Name == null) return;
@@ -473,6 +483,7 @@ public class AlarmService : IAlarmService
     /// Evaluates alarm configuration rules for a patient observation and, when matching conditions and preconditions are satisfied, generates a new alert observation, logs it, and triggers the corresponding alarm notification.
     /// </summary>
     /// <param name="obs">The patient observation whose value is evaluated against configured alert rules and preconditions.</param>
+    /// <!-- aidoc:v1 sig=a86f464 body=bee7a9f -->
     public async Task CheckObservationAlarm(PatientObservation obs)
     {
         //ConfigObservations
@@ -551,6 +562,7 @@ public class AlarmService : IAlarmService
     /// <param name="config">The configuration observation providing the coding system, code, name, and alarm settings.</param>
     /// <param name="type">The status type to assign to the new observation.</param>
     /// <returns>A new <see cref="PatientObservation"/> populated with the merged values from the source observation and configuration.</returns>
+    /// <!-- aidoc:v1 sig=91e2989 body=7ec15fe -->
     private static PatientObservation CreateNewObservation(PatientObservation obs, ConfigObservation config,
             StatusEnum.Type type)
         {
@@ -572,6 +584,7 @@ public class AlarmService : IAlarmService
     /// </summary>
     /// <param name="pobs">The patient observation whose alarm configuration will be checked and updated.</param>
     /// <returns>The patient observation with the configured alarm applied, or with a null alarm if no configuration was found.</returns>
+    /// <!-- aidoc:v1 sig=4d79a28 body=efca777 -->
     private async Task<PatientObservation> CheckAlarmConfig(PatientObservation pobs)
         {
             var configObs = await _configObservationService.Get(new PatientObservation
@@ -596,6 +609,10 @@ public class AlarmService : IAlarmService
     /// <param name="type"></param>
     /// <exception cref="ArgumentOutOfRangeException"></exception>
     /// <returns>New alarm created</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Method returns Task (void async), not a 'New alarm created'. There is no return value produced." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The 'type' parameter has an empty <param> tag with no description, while name/code/severity are described." -->
     public async Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code, AlarmEnum.Severity severity,
         AlarmEnum.Type type)
     {
@@ -775,6 +792,8 @@ public class AlarmService : IAlarmService
     /// </summary>
     /// <param name="source">The patient observation value used to look up the alarm configuration and identify the target patient.</param>
     /// <param name="name">The name associated with the observation, used for logging and alarm context.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The 'name' parameter is documented as 'used for logging and alarm context', but the method body never references it; all logging uses obs.PatientId and obs.Name instead." -->
     public async Task CalculateAlarmTest(BasePatientObservationValue source, string name)
         {
             if (source is not PatientObservation obs) return;
@@ -824,6 +843,7 @@ public class AlarmService : IAlarmService
     /// </summary>
     /// <param name="color">The beacon color to transmit to the light beacon service.</param>
     /// <param name="patient">The patient whose associated point of care device should display the beacon color.</param>
+    /// <!-- aidoc:v1 sig=1b6b9f9 body=c0fe279 -->
     private Task SendBeaconCode(AlarmEnum.BeaconColor color, Patient patient)
         {
             if (!patient.PointOfCareId.HasValue)
@@ -862,6 +882,12 @@ public class AlarmService : IAlarmService
     /// <param name="endAfter"></param>
     /// <param name="severity"></param>
     /// <param name="type"></param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary is empty and does not describe what the method does (starts a recording based on patient, POC, and alarm data)." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "Method returns Task but no <returns> tag is present." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "No documentation for what each parameter represents (patientId, recording, alarmName, alarmDescription, endAfter, severity, type are all undocumented beyond a placeholder or a single line)." -->
     private async Task StartRecording(ObjectId patientId, DateTime eventTime, AlarmItem? recording,
         AlarmEnum.Name? alarmName, AlarmEnum.Severity severity, string? alarmDescription, int? endAfter,
         AlarmEnum.Type type = AlarmEnum.Type.Manual)
@@ -896,6 +922,7 @@ public class AlarmService : IAlarmService
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose relay should be powered on.</param>
     /// <param name="type">The type of relay to power on, used to locate the matching configuration in the point of care's relay list.</param>
+    /// <!-- aidoc:v1 sig=7ecd7ee body=04cade6 -->
     private async Task RelayPowerOn(ObjectId patientId, RelayEnum.Type type)
         {
             try
@@ -922,6 +949,7 @@ public class AlarmService : IAlarmService
     /// Starts a periodic background timer that retrieves the list of locations and periodically checks for expired alarms, using a semaphore to ensure thread-safe execution. 
     /// Logs any errors encountered during timer initialization or execution without rethrowing them.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fac87dc body=29b2aa2 -->
     private async void StartTimer()
     {
         try
@@ -957,6 +985,7 @@ public class AlarmService : IAlarmService
     /// Asynchronously checks for expired alarms by running the beacon and relay expiration checks in parallel.
     /// </summary>
     /// <param name="pocList">The list of points of care to be evaluated for expired beacon alarms.</param>
+    /// <!-- aidoc:v1 sig=e77aa4b body=99bc6c5 -->
     private async Task CheckExpiredAlarms(List<PointOfCare> pocList)
     {
         _logger.LogTrace("Checking Expired Alarms Started");
@@ -981,6 +1010,7 @@ public class AlarmService : IAlarmService
     /// the still-valid observations.
     /// </summary>
     /// <param name="pocList">The list of points of care whose beacons should be turned off when no alarms are active.</param>
+    /// <!-- aidoc:v1 sig=5baf90c body=8c4d364 -->
     private async Task CheckExpiredBeaconsAsync(List<PointOfCare> pocList)
         {
             await _beaconListSemaphore.WaitAsync();
@@ -1050,6 +1080,7 @@ public class AlarmService : IAlarmService
     /// patients without an assigned <c>PointOfCareId</c> are processed, and the relay alarm list is
     /// synchronized under a lock with the filtered non-expired observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6193459 body=f16dcb9 -->
     private async Task CheckExpiredRelayAsync()
     {
         var now = DateTime.UtcNow;
diff --git a/adas-core.Application/Services/AlertValuesService.cs b/adas-core.Application/Services/AlertValuesService.cs
index c0055c28..b3bc0759 100644
--- a/adas-core.Application/Services/AlertValuesService.cs
+++ b/adas-core.Application/Services/AlertValuesService.cs
@@ -11,6 +11,7 @@ namespace adas_core.Application.Services;
 /// Provides an implementation of the IAlertValuesService interface for managing alert values
 /// using a configuration observation repository.
 /// </summary>
+/// <!-- aidoc:v1 sig=9cef6b0 -->
 public class AlertValuesService(IConfigObservationRepository alertValueRepository) : IAlertValuesService
 {
     /// <summary>
@@ -20,6 +21,7 @@ public class AlertValuesService(IConfigObservationRepository alertValueRepositor
     /// <param name="key">The unique identifier of the configuration observation to retrieve.</param>
     /// <returns>The matching <see cref="ConfigObservation"/> if found.</returns>
     /// <exception cref="NotFoundException">Thrown when no configuration observation exists for the specified <paramref name="key"/>.</exception>
+    /// <!-- aidoc:v1 sig=2645546 body=5ae5bf7 -->
     public async Task<ConfigObservation?> FindByKey(ObjectId key)
         {
             return await alertValueRepository.FindById(key) ??
diff --git a/adas-core.Application/Services/AppointmentService.cs b/adas-core.Application/Services/AppointmentService.cs
index c34e1708..d1048f2a 100644
--- a/adas-core.Application/Services/AppointmentService.cs
+++ b/adas-core.Application/Services/AppointmentService.cs
@@ -47,6 +47,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="apiRequest">The API request containing the patient number, location, type, observations, diagnosis, and related data to be processed.</param>
     /// <exception cref="ApiRequestException">Thrown when the <paramref name="apiRequest"/> has a null or empty patient number.</exception>
+    /// <!-- aidoc:v1 sig=229d8cd body=bb59333 -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         if (string.IsNullOrEmpty(apiRequest.PatientNumber))
@@ -91,6 +92,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="apiRequest">The API request containing the HL7 message type, timestamp, and appointment payload to process.</param>
     /// <param name="patient">The patient associated with the request; if null, the method returns without processing.</param>
+    /// <!-- aidoc:v1 sig=21c9ac7 body=f7a7db6 -->
     public async Task ProcessApiRequest(ApiRequest apiRequest, Patient? patient)
     {
         if (patient == null)
@@ -232,6 +234,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -241,6 +244,7 @@ public class AppointmentService(
     /// Archives the specified patient by delegating the operation to <see cref="ArchiveByPatientId"/> using the patient's identifier.
     /// </summary>
     /// <param name="patient">The patient to be archived.</param>
+    /// <!-- aidoc:v1 sig=0afe718 body=be01ba0 -->
     public async Task Archive(Patient patient)
     {
         await ArchiveByPatientId(patient.Id);
@@ -250,6 +254,7 @@ public class AppointmentService(
     /// Archives all appointments associated with the specified patient by copying them to the appointment archive repository and then deleting them from the source collection.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose appointments should be archived.</param>
+    /// <!-- aidoc:v1 sig=3385472 body=fb8a531 -->
     public async Task ArchiveByPatientId(ObjectId id)
     {
         logger.LogDebug("Archive Appointments by patientId {id}", id);
@@ -268,6 +273,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose appointments are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=c45e6c0 body=eb5edef -->
     public async Task<List<PatientAppointment>> GetByPatient(ObjectId patientId)
     {
         return await appointmentRepository.GetByPatient(patientId);
@@ -280,6 +286,7 @@ public class AppointmentService(
     /// <param name="patientId">The unique identifier of the patient whose appointments are being queried.</param>
     /// <param name="ct">Cancellation token used to cancel the asynchronous operation.</param>
     /// <returns>A task that resolves to a list of <see cref="PatientAppointment"/> instances scheduled for today; an empty list is returned when no appointments match.</returns>
+    /// <!-- aidoc:v1 sig=ad66c0d body=a065213 -->
     public async Task<List<PatientAppointment>> GetTodayByPatient(
             ObjectId patientId,
             CancellationToken ct = default)
@@ -320,6 +327,7 @@ public class AppointmentService(
     /// <param name="pocId">The identifier of the point of care whose appointments should be retrieved.</param>
     /// <param name="ct">A cancellation token to cancel the asynchronous operation.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of patient appointments scheduled for today at the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=0c69a88 body=57eddae -->
     public async Task<List<PatientAppointment>> GetTodayByPoc(
             ObjectId pocId,
             CancellationToken ct = default)
@@ -361,6 +369,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose appointments are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an async cursor over the matching <see cref="PatientAppointment"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=737aa7b body=e468a16 -->
     public Task<IAsyncCursor<PatientAppointment>> FindByPatientIdAsync(ObjectId patientId)
     {
         return appointmentRepository.FindByPatientIdAsync(patientId);
@@ -371,6 +380,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="location">The location used to filter the patient appointments.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patient appointments for the specified location.</returns>
+    /// <!-- aidoc:v1 sig=0baed42 body=32f1684 -->
     public async Task<List<PatientAppointment>> FindByLocation(PatientLocation location)
     {
         return await appointmentRepository.FindByLocation(location);
@@ -381,6 +391,7 @@ public class AppointmentService(
     /// Deletes all appointments associated with the specified patient identifier, invalidates the appointments cache, and records the action in the audit log.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose appointments will be deleted.</param>
+    /// <!-- aidoc:v1 sig=09e4e41 body=de0ba10 -->
     public async Task DeleteByPatientId(ObjectId id)
     {
         var patientApp = await FindByPatientIdAsync(id);
@@ -399,6 +410,7 @@ public class AppointmentService(
     /// <param name="nameId">The identifier used to scope which appointment records are affected by the update.</param>
     /// <param name="id">The new ObjectId that will replace the existing one in the matching records.</param>
     /// <param name="oldId">The current ObjectId to be replaced in the matching records.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=413cf37 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await appointmentRepository.UpdateManyObjectId(nameId, id, oldId);
@@ -409,6 +421,7 @@ public class AppointmentService(
     /// </summary>
     /// <param name="appointment">The patient appointment whose resource groups and locations will be broadcast to subscribers.</param>
     /// <param name="operationType">The optional operation type describing the change performed on the appointment; passed along to the subscriber message.</param>
+    /// <!-- aidoc:v1 sig=db962d9 body=b404485 -->
     private async Task SendBroadcast(PatientAppointment appointment, OperationType? operationType)
     {
         //RECORRE LOS DIFERENTES LOCATIONS DE LA CITA
diff --git a/adas-core.Application/Services/ArchivePatientCarePlanService.cs b/adas-core.Application/Services/ArchivePatientCarePlanService.cs
index c98ad904..8d34bb1f 100644
--- a/adas-core.Application/Services/ArchivePatientCarePlanService.cs
+++ b/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();
diff --git a/adas-core.Application/Services/ArchivePatientObservationsService.cs b/adas-core.Application/Services/ArchivePatientObservationsService.cs
index 73d88ff9..761dac66 100644
--- a/adas-core.Application/Services/ArchivePatientObservationsService.cs
+++ b/adas-core.Application/Services/ArchivePatientObservationsService.cs
@@ -20,6 +20,7 @@ public class ArchivePatientObservationsService(IObservationArchiveRepository arc
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived observations are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of archived <see cref="PatientObservation"/> records for the patient.</returns>
+    /// <!-- aidoc:v1 sig=dc5c962 body=1b4970c -->
     public async Task<List<PatientObservation>> FindArchivedPatientObservationsFromPatient(ObjectId patientId)
     {
         return await archivedPatientObservationService.FindAllFromPatient(patientId);
diff --git a/adas-core.Application/Services/ArchivedPatientService.cs b/adas-core.Application/Services/ArchivedPatientService.cs
index 8928c870..326ef1c4 100644
--- a/adas-core.Application/Services/ArchivedPatientService.cs
+++ b/adas-core.Application/Services/ArchivedPatientService.cs
@@ -10,12 +10,14 @@ namespace adas_core.Application.Services;
 /// <remarks>
 /// This class uses an <see cref="IPatientArchiveRepository"/> to perform operations on archived patient records, following the repository pattern.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d476f9b -->
 public class ArchivedPatientService(IPatientArchiveRepository archivedPatientRepository) : IArchivedPatientService
 {
     /// <summary>
     /// Retrieves all archived patients by delegating to the archived patient repository.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of all archived <see cref="Patient"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=3e765a0 body=6db7118 -->
     public async Task<List<Patient>> FindAllPatients()
     {
         return await archivedPatientRepository.FindAll();
diff --git a/adas-core.Application/Services/ArchivedPatientTreatmentService.cs b/adas-core.Application/Services/ArchivedPatientTreatmentService.cs
index 36063634..90eb04ed 100644
--- a/adas-core.Application/Services/ArchivedPatientTreatmentService.cs
+++ b/adas-core.Application/Services/ArchivedPatientTreatmentService.cs
@@ -17,6 +17,7 @@ public class ArchivedPatientTreatmentService(ITreatmentArchiveRepository archive
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived treatments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> records for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=d06a1c8 body=542ec4b -->
     public async Task<List<PatientTreatment>> FindAllPatientTreatmentsByPatient(ObjectId patientId)
     {
         return await archivedPatientTreatmentService.FindAllFromPatient(patientId);
diff --git a/adas-core.Application/Services/AuthService.cs b/adas-core.Application/Services/AuthService.cs
index 7dd2b9a1..b71f1817 100644
--- a/adas-core.Application/Services/AuthService.cs
+++ b/adas-core.Application/Services/AuthService.cs
@@ -16,6 +16,7 @@ namespace adas_core.Application.Services;
 /// Provides an implementation of the <see cref="IAuthService"/> interface, offering
 /// authentication-related services to consuming components.
 /// </summary>
+/// <!-- aidoc:v1 sig=c025df9 -->
 public class AuthService : IAuthService
 {
     private readonly IAuthorityRepository _authorityRepository;
@@ -49,6 +50,7 @@ public class AuthService : IAuthService
     /// Asynchronously obtains a login token from the recording API using the configured client credentials and caches it for reuse via <see cref="AuthUtils"/>.
     /// </summary>
     /// <returns>A <see cref="LoginResponse"/> containing the authentication token when the request succeeds and the response is valid; otherwise, <c>null</c> if the API URL is not configured, the request fails, the returned token is empty, or an exception is caught and logged.</returns>
+    /// <!-- aidoc:v1 sig=6d8b512 body=bfaf63a -->
     public async Task<LoginResponse?> GetLoginResponse()
     {
         try
@@ -100,6 +102,7 @@ public class AuthService : IAuthService
     /// Otherwise, attempts a fresh login and returns the new token, falling back to an empty string when no token is obtained.
     /// </summary>
     /// <returns>A task that resolves to the authentication token, or an empty string if the token could not be obtained.</returns>
+    /// <!-- aidoc:v1 sig=2e832cc body=0ab9bf1 -->
     public async Task<string> GetToken()
     {
         var loginResponse = AuthUtils.Instance.GetLoginResponse();
@@ -115,6 +118,7 @@ public class AuthService : IAuthService
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose authorizations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects for the specified unit.</returns>
+    /// <!-- aidoc:v1 sig=37cf403 body=9b4aba2 -->
     public async Task<List<Authorization>> GetByUnitId(ObjectId unitId)
     {
         return await _authorityRepository.GetByUnitId(unitId);
@@ -125,6 +129,7 @@ public class AuthService : IAuthService
     /// </summary>
     /// <param name="id">The unique identifier of the user whose authorities are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> entries for the user.</returns>
+    /// <!-- aidoc:v1 sig=7b40daa body=48ea4d9 -->
     public async Task<List<Authorization>> GetUserAuthorities(ObjectId id)
     {
         return await _authorityRepository.GetUserAuthorities(id);
@@ -135,6 +140,7 @@ public class AuthService : IAuthService
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose authorities are to be removed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the deletion was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d4333b3 body=ae8ffe1 -->
     public async Task<bool> DeleteByUnitId(ObjectId unitId)
     {
         return await _authorityRepository.DeleteAllAuthoritiesByUnit(unitId);
@@ -145,6 +151,7 @@ public class AuthService : IAuthService
     /// </summary>
     /// <param name="displayId">The unique identifier of the display whose related authorities should be removed.</param>
     /// <returns>A task that resolves to <c>true</c> if authorities were successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=87a9f41 body=fa867f0 -->
     public async Task<bool> DeleteByDisplayId(ObjectId displayId)
     {
         return await _authorityRepository.DeleteAllAuthoritiesByDisplay(displayId);
@@ -153,6 +160,7 @@ public class AuthService : IAuthService
     /// <summary>
     /// Ensures the authentication utilities are initialized with a valid login token. Returns early if the recording API URL is not configured; otherwise, requests a new token when the current one is missing or expired, and updates the shared <see cref="AuthUtils"/> instance with the refreshed response when successful.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e577d60 body=e927320 -->
     private async Task InstanceAuthUtils()
     {
         if (_recordingSettings.RecordingApiUrl.IsEmpty())
diff --git a/adas-core.Application/Services/Caching/CacheDispatcher.cs b/adas-core.Application/Services/Caching/CacheDispatcher.cs
index 09aac7a3..94ee7d60 100644
--- a/adas-core.Application/Services/Caching/CacheDispatcher.cs
+++ b/adas-core.Application/Services/Caching/CacheDispatcher.cs
@@ -12,6 +12,7 @@ namespace adas_core.Application.Services.Caching
     /// según CacheSettings y la entidad del key.
     /// Implementa ICacheService y delega en el backend elegido.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9f15289 -->
     public class CacheDispatcher(
         RedisService redis,
         CacheService memory,
@@ -27,6 +28,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The cache key used to determine the entity type and the corresponding cache backend.</param>
         /// <returns>The <see cref="ICacheService"/> instance that should handle caching for the supplied key.</returns>
+        /// <!-- aidoc:v1 sig=26395d4 body=a1c4c59 -->
         private ICacheService SelectBackend(string key)
                 {
                     var entity = CacheKeyClassifier.Classify(key);
@@ -56,6 +58,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="gf">The grouped field whose name contributes to the key.</param>
         /// <param name="patientId">The identifier of the patient associated with the grouped observation.</param>
         /// <returns>A formatted key string in the form <c>GroupedObs:{patientId}:{gf.Name}</c>.</returns>
+        /// <!-- aidoc:v1 sig=72c65a6 -->
         private static string BuildGroupedKey(GroupedField gf, ObjectId patientId)
                     => $"GroupedObs:{patientId}:{gf.Name}";
 
@@ -65,6 +68,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="groupedField">The grouped field used to derive the cache key.</param>
         /// <param name="patientId">The patient identifier used to derive the cache key.</param>
         /// <returns>The <see cref="ICacheService"/> backend associated with the built grouped key.</returns>
+        /// <!-- aidoc:v1 sig=2461014 -->
         private ICacheService SelectBackend(GroupedField groupedField, ObjectId patientId)
                     => SelectBackend(BuildGroupedKey(groupedField, patientId));
 
@@ -78,6 +82,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">An optional time-to-live duration for the cached object. If null, the backend's default expiration is applied.</param>
         /// <param name="cancellationToken">A token to observe while waiting for the operation to complete.</param>
         /// <returns>A task that represents the asynchronous operation, containing the retrieved or newly created object of type <typeparamref name="T"/>.</returns>
+        /// <!-- aidoc:v1 sig=5407b21 -->
         public Task<T> GetOrSetObjectAsync<T>(
                     string key,
                     Func<Task<T>> factory,
@@ -94,6 +99,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="loader">An asynchronous function that produces the value to cache when no existing entry is found.</param>
         /// <param name="ttl">An optional time-to-live duration after which the cached entry expires. If null, the backend's default TTL is used.</param>
         /// <returns>A task that represents the asynchronous operation, containing the cached or loaded string value, or null if no value could be obtained.</returns>
+        /// <!-- aidoc:v1 sig=0bd9db4 -->
         public Task<string?> GetOrSetValueAsync(
                     string key,
                     Func<Task<string>> loader,
@@ -113,6 +119,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">An optional time-to-live applied to the cached object. When <c>null</c>, the backend's default expiration is used.</param>
         /// <param name="cancellationToken">The token to observe for canceling the asynchronous operation.</param>
         /// <returns>A task that represents the asynchronous get-or-set operation, containing the retrieved or newly created object.</returns>
+        /// <!-- aidoc:v1 sig=c950b98 -->
         public Task<T> GetOrSetObjectAsync<T>(
                     GroupedField groupedField,
                     ObjectId patientId,
@@ -129,6 +136,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key used to select the backend and identify the value to set.</param>
         /// <param name="value">The value to associate with the specified key.</param>
+        /// <!-- aidoc:v1 sig=3796865 -->
         public void SetValue(string key, string value)
                     => SelectBackend(key).SetValue(key, value);
 
@@ -137,6 +145,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key used to select the backend and retrieve the associated value.</param>
         /// <returns>The value associated with the key, or <c>null</c> if the selected backend returns no value.</returns>
+        /// <!-- aidoc:v1 sig=f39f53d -->
         public string? GetValue(string key)
                     => SelectBackend(key).GetValue(key);
 
@@ -146,6 +155,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The identifier used to select the appropriate backend and to look up the object.</param>
         /// <param name="upd">Indicates whether the underlying backend should perform an update during retrieval. Defaults to <c>true</c>.</param>
         /// <returns>A task that represents the asynchronous retrieval operation, containing the object of type <typeparamref name="T"/> or <c>null</c> if not found.</returns>
+        /// <!-- aidoc:v1 sig=15709a1 -->
         public Task<T?> GetObjectAsync<T>(string key, bool upd = true)
                     => SelectBackend(key).GetObjectAsync<T>(key, upd);
 
@@ -157,6 +167,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="obj">The object to store in the selected backend.</param>
         /// <param name="upd">Indicates whether an update operation should be performed. Defaults to <c>true</c>.</param>
         /// <returns>A task that represents the asynchronous store operation.</returns>
+        /// <!-- aidoc:v1 sig=9d84645 -->
         public Task SetObjectAsync<T>(string key, T obj, bool upd = true)
                     => SelectBackend(key).SetObjectAsync(key, obj, upd);
 
@@ -167,6 +178,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">An optional time-to-live applied to the object; if null, the backend's default is used.</param>
         /// <param name="upd">A flag indicating whether the retrieval should update the object's state (e.g., refresh expiration).</param>
         /// <returns>A task containing the deserialized object, or null if the object is not found in the selected backend.</returns>
+        /// <!-- aidoc:v1 sig=4675112 -->
         public Task<T?> GetObjectAsync<T>(string key, TimeSpan? ttl, bool upd)
                     => SelectBackend(key).GetObjectAsync<T>(key, ttl, upd);
 
@@ -178,6 +190,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">The optional time-to-live duration for the stored object.</param>
         /// <param name="upd">Indicates whether to update an existing entry or create a new one.</param>
         /// <returns>A task that represents the asynchronous set operation.</returns>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Generic type parameter T (the type of the object being stored) is not documented" -->
         public Task SetObjectAsync<T>(string key, T obj, TimeSpan? ttl, bool upd)
                     => SelectBackend(key).SetObjectAsync(key, obj, ttl, upd);
 
@@ -186,6 +200,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The identifier of the object to delete, also used to resolve the responsible backend.</param>
         /// <returns>A task that represents the asynchronous delete operation.</returns>
+        /// <!-- aidoc:v1 sig=0dde5af -->
         public Task DeleteObjectAsync(string key)
                     => SelectBackend(key).DeleteObjectAsync(key);
 
@@ -194,12 +209,14 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="pattern">The pattern used to match entries for deletion in both storage backends.</param>
         /// <returns>The combined total number of entries deleted from Redis and in-memory storage.</returns>
+        /// <!-- aidoc:v1 sig=fa6dca4 -->
         public async Task<long> DeleteByPatternAsync(string pattern)
                     => await redis.DeleteByPatternAsync(pattern) + await memory.DeleteByPatternAsync(pattern);
 
         /// <summary>
         /// Clears all cached data from both the in-memory cache and the Redis cache, ensuring that stale entries are removed across all configured cache providers.
         /// </summary>
+        /// <!-- aidoc:v1 sig=d5e5e8c body=c0791ef -->
         public void CleanCache()
                 {
                     memory.CleanCache();
diff --git a/adas-core.Application/Services/Caching/CacheService.cs b/adas-core.Application/Services/Caching/CacheService.cs
index 03cdc7fe..9f48a99d 100644
--- a/adas-core.Application/Services/Caching/CacheService.cs
+++ b/adas-core.Application/Services/Caching/CacheService.cs
@@ -10,6 +10,7 @@ namespace adas_core.Application.Services.Caching
     /// mediante LockManagerService + InMemoryLockProvider.
     /// Compatible con la interfaz ICacheService incluyendo GetOrSet.
     /// </summary>
+    /// <!-- aidoc:v1 sig=53daded -->
     public class CacheService(LockManagerService lockManager) : ICacheService
     {
         private readonly ConcurrentDictionary<string, object> _mem = new();
@@ -21,6 +22,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="gf">The grouped field whose name is included in the key.</param>
         /// <param name="patientId">The identifier of the patient the key is scoped to.</param>
         /// <returns>A formatted key string in the form <c>GroupedObs:{patientId}:{gf.Name}</c>.</returns>
+        /// <!-- aidoc:v1 sig=72c65a6 -->
         private static string BuildGroupedKey(GroupedField gf, ObjectId patientId)
                     => $"GroupedObs:{patientId}:{gf.Name}";
 
@@ -34,6 +36,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">Optional time-to-live associated with the cached object.</param>
         /// <param name="cancellationToken">A token to observe for cancellation requests.</param>
         /// <returns>The cached or newly created object of type <typeparamref name="T"/>.</returns>
+        /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+        ///      "The `ttl` parameter is documented as 'Optional time-to-live associated with the cached object', but the method body never uses `ttl`—the cache assignment `_mem[key] = created;` has no TTL/expiration handling, so readers will be misled into believing the TTL is honored." -->
         public async Task<T> GetOrSetObjectAsync<T>(
                     string key,
                     Func<Task<T>> factory,
@@ -71,6 +75,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="loader">The asynchronous function invoked to load the value when no cached entry exists for the key.</param>
         /// <param name="ttlOverride">An optional time span that overrides the default time-to-live for the cached value.</param>
         /// <returns>The cached or newly loaded string value, or <c>null</c> when the underlying cache entry is absent or cannot be cast to a string.</returns>
+        /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+        ///      "The <returns> text claims the method returns null 'when the underlying cache entry ... cannot be cast to a string', but the explicit cast (string?)result would throw InvalidCastException rather than yield null in that case." -->
         public async Task<string?> GetOrSetValueAsync(
                     string key,
                     Func<Task<string>> loader,
@@ -94,6 +100,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">Optional time-to-live for the cached entry.</param>
         /// <param name="cancellationToken">Token used to cancel the asynchronous operation.</param>
         /// <returns>A task containing the cached or newly created object.</returns>
+        /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+        ///      "The `ttl` parameter is documented as 'Optional time-to-live for the cached entry', but it is never referenced in the method body — no TTL is applied to the stored entry, and the lock timeout is hardcoded to 5 seconds. A reader would expect their TTL value to be honored, but it is effectively ignored." -->
         public async Task<T> GetOrSetObjectAsync<T>(
                     GroupedField groupedField,
                     ObjectId patientId,
@@ -131,6 +139,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key that identifies where the value will be stored.</param>
         /// <param name="value">The value to associate with the specified key.</param>
+        /// <!-- aidoc:v1 sig=f3491fe -->
         public void SetValue(string key, string value)
                     => _mem[key] = value;
 
@@ -140,6 +149,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key used to look up the value in the underlying store.</param>
         /// <returns>The string representation of the stored value if the key exists; otherwise, <c>null</c>.</returns>
+        /// <!-- aidoc:v1 sig=7a34703 -->
         public string? GetValue(string key)
                     => _mem.TryGetValue(key, out var v) ? v.ToString() : null;
 
@@ -150,6 +160,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The cache key used to look up the stored object.</param>
         /// <param name="updateExpiration">Indicates whether the entry's expiration should be refreshed on access. Not currently used by this implementation.</param>
         /// <returns>A <see cref="Task{T}"/> containing the cached value cast to <typeparamref name="T"/>, or <c>null</c> if no entry exists for the given key.</returns>
+        /// <!-- aidoc:v1 sig=5046896 body=6902631 -->
         public Task<T?> GetObjectAsync<T>(string key, bool updateExpiration = true)
                 {
                     return Task.FromResult(
@@ -163,6 +174,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The cache key under which the object will be stored.</param>
         /// <param name="obj">The object to store in the cache.</param>
         /// <param name="updateExpiration">Indicates whether the cache entry's expiration should be refreshed.</param>
+        /// <!-- aidoc-review:v1 severity=medium kind=mentions_removed_behavior
+        ///      "The updateExpiration parameter is documented as indicating whether the cache entry's expiration should be refreshed, but the method body never references this parameter, so the documented behavior does not occur." -->
         public Task SetObjectAsync<T>(string key, T obj, bool updateExpiration = true)
                 {
                     _mem[key] = obj!;
@@ -176,6 +189,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttlOverride">An optional time-to-live override accepted by this overload but ignored when delegating to the underlying retrieval call.</param>
         /// <param name="upd">A flag indicating whether the retrieval should trigger an update on the stored object.</param>
         /// <returns>A task that represents the asynchronous operation, containing the retrieved object of type <typeparamref name="T"/> or <c>null</c> if no object is found for the given key.</returns>
+        /// <!-- aidoc:v1 sig=773648d -->
         public Task<T?> GetObjectAsync<T>(string key, TimeSpan? ttlOverride, bool upd)
                     => GetObjectAsync<T>(key, upd);
 
@@ -187,6 +201,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttlOverride">An optional time-to-live override for the stored entry; not applied by this overload.</param>
         /// <param name="upd">A flag indicating whether the operation should update an existing entry.</param>
         /// <returns>A task that represents the asynchronous set operation.</returns>
+        /// <!-- aidoc:v1 sig=874b6ce -->
         public Task SetObjectAsync<T>(string key, T obj, TimeSpan? ttlOverride, bool upd)
                     => SetObjectAsync(key, obj, upd);
 
@@ -196,6 +211,7 @@ namespace adas_core.Application.Services.Caching
         /// Asynchronously removes the object associated with the specified key from the in-memory store. The operation succeeds silently whether or not the key exists.
         /// </summary>
         /// <param name="key">The identifier of the object to delete.</param>
+        /// <!-- aidoc:v1 sig=93555f0 body=00affc5 -->
         public Task DeleteObjectAsync(string key)
                 {
                     _mem.TryRemove(key, out _);
@@ -207,6 +223,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="pattern">The pattern to match against cache keys. Asterisk (*) characters are removed and the remaining text is used as a substring match.</param>
         /// <returns>A task that represents the asynchronous operation, containing the count of entries that were removed.</returns>
+        /// <!-- aidoc:v1 sig=a8cca2e body=81413d3 -->
         public Task<long> DeleteByPatternAsync(string pattern)
                 {
                     var p = pattern.Replace("*", "");
@@ -223,6 +240,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Clears all entries from the in-memory cache, removing any previously stored data.
         /// </summary>
+        /// <!-- aidoc:v1 sig=8762842 -->
         public void CleanCache() => _mem.Clear();
     }
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Caching/InMemoryLockProvider.cs b/adas-core.Application/Services/Caching/InMemoryLockProvider.cs
index a74ad58d..df27c8c5 100644
--- a/adas-core.Application/Services/Caching/InMemoryLockProvider.cs
+++ b/adas-core.Application/Services/Caching/InMemoryLockProvider.cs
@@ -8,6 +8,7 @@ namespace adas_core.Application.Services.Caching
     /// Se basa en SemaphoreSlim y solo controla concurrencia DENTRO del proceso.
     /// Para CacheService (in-memory).
     /// </summary>
+    /// <!-- aidoc:v1 sig=ea44018 -->
     public class InMemoryLockProvider : ILockProvider
     {
         private readonly ConcurrentDictionary<string, SemaphoreSlim> _locks = new(StringComparer.Ordinal);
@@ -15,6 +16,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Crea u obtiene un semáforo asociado a la clave.
         /// </summary>
+        /// <!-- aidoc:v1 sig=af8b85d body=29079e4 -->
         private SemaphoreSlim GetOrCreate(string key)
         {
             return _locks.GetOrAdd(key, _ => new SemaphoreSlim(1, 1));
@@ -23,6 +25,12 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Intenta adquirir el lock por clave.
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'key' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'timeout' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+        ///      "Return value (bool indicating acquisition success) is not documented" -->
         public async Task<bool> AcquireAsync(string key, TimeSpan timeout)
         {
             var sem = GetOrCreate(key);
@@ -42,6 +50,8 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Libera el lock (si existe y no está ya liberado).
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "The 'key' parameter is not documented; only a <summary> is provided, with no <param name=\"key\"> tag describing the lock identifier." -->
         public Task ReleaseAsync(string key)
         {
             if (!_locks.TryGetValue(key, out var sem)) 
diff --git a/adas-core.Application/Services/Caching/LockManagerService.cs b/adas-core.Application/Services/Caching/LockManagerService.cs
index 843c1c10..c3ce7db7 100644
--- a/adas-core.Application/Services/Caching/LockManagerService.cs
+++ b/adas-core.Application/Services/Caching/LockManagerService.cs
@@ -8,6 +8,10 @@ namespace adas_core.Application.Services.Caching
     /// CacheService lo usará para evitar condiciones de carrera en GetOrSet.
     /// Funciona igual para locks locales o distribuidos.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "Constructor parameter 'logger' (ILogger<LockManagerService>) is not documented." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "Constructor parameter 'provider' (ILockProvider) is not documented." -->
     public class LockManagerService(
         ILogger<LockManagerService> logger,
         ILockProvider provider)
@@ -15,6 +19,18 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Ejecuta una función que devuelve un valor bajo un lock por clave.
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'key' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'timeout' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'action' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'cancellationToken' is not documented" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+        ///      "Method returns Task<T> via action delegate, but no <returns> tag is present" -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+        ///      "TimeoutException is thrown when the lock cannot be acquired within the timeout, but no <exception> tag is present" -->
         public async Task<T> WithLockAsync<T>(
             string key,
             TimeSpan timeout,
@@ -57,6 +73,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Version Task (sin valor).
         /// </summary>
+        /// <!-- aidoc:v1 sig=3facc4e body=59bc0c3 -->
         public Task WithLockAsync(
             string key,
             TimeSpan timeout,
@@ -77,6 +94,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Libera el lock y registra posibles errores sin interrumpir el flujo.
         /// </summary>
+        /// <!-- aidoc:v1 sig=88f2f04 body=608f118 -->
         private async Task SafeReleaseAsync(string key)
         {
             try
diff --git a/adas-core.Application/Services/Caching/NoCacheService.cs b/adas-core.Application/Services/Caching/NoCacheService.cs
index 026412cb..55b0ec58 100644
--- a/adas-core.Application/Services/Caching/NoCacheService.cs
+++ b/adas-core.Application/Services/Caching/NoCacheService.cs
@@ -9,6 +9,7 @@ namespace adas_core.Application.Services.Caching
     /// No almacena nada, no devuelve nada y no interfiere con el flujo.
     /// Se usa cuando el CacheMode es "None".
     /// </summary>
+    /// <!-- aidoc:v1 sig=2b881c5 -->
     public class NoCacheService : ICacheService
     {
         /// <summary>
@@ -16,6 +17,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The identifier used to reference the value.</param>
         /// <param name="value">The value intended to be associated with the key.</param>
+        /// <!-- aidoc:v1 sig=c91035b body=4448e1d -->
         public void SetValue(string key, string value)
                 {
                     // No hacer nada
@@ -27,6 +29,8 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key used to look up the associated value.</param>
         /// <returns>The value associated with <paramref name="key"/>, or <c>null</c> if no value is found.</returns>
+        /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+        ///      "The summary states the method 'retrieves' a value for the specified key, but the body unconditionally returns null and performs no retrieval/lookup logic. The <returns> tag also implies a non-null value path that the code cannot produce." -->
         public string? GetValue(string key)
                 {
                     return null;
@@ -38,6 +42,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The identifier of the object to retrieve.</param>
         /// <param name="updateExpiration">Indicates whether the expiration of the entry should be updated upon retrieval.</param>
         /// <returns>A <see cref="Task{T}"/> that represents the asynchronous retrieval, containing the object associated with the key or the default value of <typeparamref name="T"/> if not found.</returns>
+        /// <!-- aidoc:v1 sig=5046896 body=772039d -->
         public Task<T?> GetObjectAsync<T>(string key, bool updateExpiration = true)
                 {
                     return Task.FromResult<T?>(default);
@@ -50,6 +55,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The unique identifier used to store and later retrieve the object.</param>
         /// <param name="obj">The object to store in the data store.</param>
         /// <param name="updateExpiration">Indicates whether the expiration time of the cached entry should be updated. Defaults to true.</param>
+        /// <!-- aidoc:v1 sig=255c42a body=6805ef5 -->
         public Task SetObjectAsync<T>(string key, T obj, bool updateExpiration = true)
                 {
                     return Task.CompletedTask;
@@ -63,6 +69,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttlOverride">An optional time-to-live value that, when provided, overrides the default expiration for the entry.</param>
         /// <param name="updateExpiration">Indicates whether the expiration of the entry should be refreshed upon a successful retrieval.</param>
         /// <returns>A <see cref="Task{T}"/> that represents the asynchronous operation, containing the retrieved object or <c>null</c> if no value is found.</returns>
+        /// <!-- aidoc:v1 sig=efdd78f body=772039d -->
         public Task<T?> GetObjectAsync<T>(string key, TimeSpan? ttlOverride, bool updateExpiration)
                 {
                     return Task.FromResult<T?>(default);
@@ -76,6 +83,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttlOverride">An optional time-to-live value that overrides the default expiration period; <c>null</c> uses the default.</param>
         /// <param name="updateExpiration">A value indicating whether the expiration time should be updated.</param>
         /// <returns>A task that represents the asynchronous set operation.</returns>
+        /// <!-- aidoc:v1 sig=25d628c body=6805ef5 -->
         public Task SetObjectAsync<T>(string key, T obj, TimeSpan? ttlOverride, bool updateExpiration)
                 {
                     return Task.CompletedTask;
@@ -87,6 +95,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="pattern">The pattern used to identify the items to delete.</param>
         /// <returns>A <see cref="Task{Int64}"/> representing the asynchronous operation, with a result of 0 indicating that no items were deleted.</returns>
+        /// <!-- aidoc:v1 sig=a8cca2e body=14896de -->
         public Task<long> DeleteByPatternAsync(string pattern)
                 {
                     return Task.FromResult(0L);
@@ -98,6 +107,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The identifier of the object to delete.</param>
         /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
+        /// <!-- aidoc:v1 sig=93555f0 body=6805ef5 -->
         public Task DeleteObjectAsync(string key)
                 {
                     return Task.CompletedTask;
@@ -106,6 +116,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Performs a cleanup operation on the cache. Currently, this method has no implementation and does not perform any cleanup actions.
         /// </summary>
+        /// <!-- aidoc:v1 sig=d5e5e8c body=4448e1d -->
         public void CleanCache()
                 {
                     // Nada que limpiar
@@ -142,6 +153,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="loader">The asynchronous function used to load the value.</param>
         /// <param name="ttl">An optional time-to-live duration for the value.</param>
         /// <returns>A task that represents the asynchronous operation, containing the loaded value as a nullable string.</returns>
+        /// <!-- aidoc:v1 sig=02351fc body=f2ab08b -->
         public async Task<string?> GetOrSetValueAsync(
                     string key,
                     Func<Task<string>> loader,
diff --git a/adas-core.Application/Services/Caching/RedisLockProvider.cs b/adas-core.Application/Services/Caching/RedisLockProvider.cs
index 4f857a13..0553381d 100644
--- a/adas-core.Application/Services/Caching/RedisLockProvider.cs
+++ b/adas-core.Application/Services/Caching/RedisLockProvider.cs
@@ -8,6 +8,7 @@ namespace adas_core.Application.Services.Caching
     /// Lock distribuido en Redis. Usa token por adquisición (owner)
     /// y liberación segura con script Lua: borra la key solo si el valor coincide.
     /// </summary>
+    /// <!-- aidoc:v1 sig=db4fe1b -->
     public class RedisLockProvider(Func<IDatabase?> getDatabase) : ILockProvider
     {
         private readonly string _prefix = "lock:";
@@ -31,6 +32,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The identifier of the resource to lock.</param>
         /// <param name="timeout">The maximum duration to keep retrying before giving up.</param>
         /// <returns><c>true</c> if the lock was successfully acquired; otherwise, <c>false</c>.</returns>
+        /// <!-- aidoc:v1 sig=4b91964 body=b8dd956 -->
         public async Task<bool> AcquireAsync(string key, TimeSpan timeout)
                 {
                     var redis = getDatabase();
@@ -58,6 +60,7 @@ namespace adas_core.Application.Services.Caching
         /// Asynchronously releases the token associated with the specified key by removing it from the in-memory token store and executing a Lua release script against Redis. If the key is not found in the local store, or the Redis database is unavailable, the method returns without performing any further action.
         /// </summary>
         /// <param name="key">The identifier of the token to release.</param>
+        /// <!-- aidoc:v1 sig=03497b0 body=db68b0e -->
         public async Task ReleaseAsync(string key)
                 {
                     if (!_tokens.TryRemove(key, out var token))
diff --git a/adas-core.Application/Services/Caching/RedisService.cs b/adas-core.Application/Services/Caching/RedisService.cs
index b7f91f4f..263a4bed 100644
--- a/adas-core.Application/Services/Caching/RedisService.cs
+++ b/adas-core.Application/Services/Caching/RedisService.cs
@@ -16,6 +16,7 @@ namespace adas_core.Application.Services.Caching
     /// <summary>
     /// Represents a Redis-based implementation of the <see cref="ICacheService"/> interface for caching operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a3787ed -->
     public class RedisService : ICacheService
     {
         private readonly ILogger<RedisService> _logger;
@@ -59,6 +60,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">Optional time-to-live duration for the cached object. If null, the cache default is used.</param>
         /// <param name="cancellationToken">The token used to cancel the asynchronous operation.</param>
         /// <returns>A task that represents the asynchronous operation, containing the cached or newly created object.</returns>
+        /// <!-- aidoc:v1 sig=df20281 body=dc4ffdf -->
         public async Task<T> GetOrSetObjectAsync<T>(
                     string key,
                     Func<Task<T>> factory,
@@ -100,6 +102,8 @@ namespace adas_core.Application.Services.Caching
         /// <param name="loader">The asynchronous function invoked to produce the value when it is not present in the cache.</param>
         /// <param name="ttl">Optional time-to-live applied to the cached value; if not provided, the default caching policy is used.</param>
         /// <returns>The cached value when available, or the value produced by the loader when the cache is empty or Redis is unavailable.</returns>
+        /// <!-- aidoc-review:v1 severity=medium kind=mentions_removed_behavior
+        ///      "The ttl parameter is documented as 'applied to the cached value', but the code never references or passes ttl to SetValue; the parameter is unused in the method body." -->
         public async Task<string?> GetOrSetValueAsync(
                     string key,
                     Func<Task<string>> loader,
@@ -136,6 +140,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="gf">The grouped field whose name is used to identify the observation group.</param>
         /// <param name="patientId">The identifier of the patient the observation belongs to.</param>
         /// <returns>A formatted string key combining the <c>GroupedObs</c> prefix, the patient identifier, and the grouped field name.</returns>
+        /// <!-- aidoc:v1 sig=72c65a6 -->
         private static string BuildGroupedKey(GroupedField gf, ObjectId patientId)
                     => $"GroupedObs:{patientId}:{gf.Name}";
 
@@ -148,6 +153,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttl">Optional time-to-live applied to the stored cache entry. If null, no expiration is set.</param>
         /// <param name="cancellationToken">Token used to cancel the distributed lock operation.</param>
         /// <returns>The cached object if present, otherwise the object produced by <paramref name="factory"/>.</returns>
+        /// <!-- aidoc:v1 sig=f122a12 body=a3fec17 -->
         public async Task<T> GetOrSetObjectAsync<T>(
                     GroupedField groupedField,
                     ObjectId patientId,
@@ -190,6 +196,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key under which the value will be stored.</param>
         /// <param name="value">The string value to persist.</param>
+        /// <!-- aidoc:v1 sig=fb46470 -->
         public void SetValue(string key, string value)
                     => _database?.StringSet(key, value, GetEntityTtl(key), true);
 
@@ -198,6 +205,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The identifier of the value to look up in the data store.</param>
         /// <returns>The stored string value, or <c>null</c> if the key does not exist or the data store is unavailable.</returns>
+        /// <!-- aidoc:v1 sig=39e4be0 body=3910e79 -->
         public string? GetValue(string key)
                 {
                     var val = _database?.StringGet(key);
@@ -214,6 +222,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="updateExpiration">When <c>true</c> (the default), resets the key's time-to-live to the configured entity TTL on a successful read, implementing sliding expiration.</param>
         /// <returns>A <see cref="Task{T}"/> containing the deserialized object, or <c>default</c> if Redis is unavailable or the key is missing/empty.</returns>
         /// <exception cref="Exception">Thrown when the stored JSON payload cannot be deserialized into <typeparamref name="T"/>; the original exception is wrapped and rethrown.</exception>
+        /// <!-- aidoc:v1 sig=a7a96b7 body=6c885c8 -->
         public async Task<T?> GetObjectAsync<T>(string key, bool updateExpiration = true)
                 {
                     if (!_isRedisAvailable)
@@ -248,6 +257,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="key">The key under which the object will be stored.</param>
         /// <param name="obj">The object to store.</param>
         /// <param name="updateExpiration">Indicates whether the expiration time of the entry should be updated.</param>
+        /// <!-- aidoc:v1 sig=2dac8a4 -->
         public async Task SetObjectAsync<T>(
                     string key,
                     T obj,
@@ -261,6 +271,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="obj">The object to serialize and persist to Redis.</param>
         /// <param name="ttlOverride">An optional time-to-live override; when null, the entity's default TTL is applied.</param>
         /// <param name="updateExpiration">Flag indicating whether the expiration should be updated.</param>
+        /// <!-- aidoc:v1 sig=b181b67 body=11fd650 -->
         public async Task SetObjectAsync<T>(
                     string key,
                     T obj,
@@ -283,6 +294,7 @@ namespace adas_core.Application.Services.Caching
         /// When the Redis backend is unavailable, the call is skipped silently as a no-op fallback.
         /// </summary>
         /// <param name="key">The unique identifier of the cached object to remove.</param>
+        /// <!-- aidoc:v1 sig=884f4b6 body=00b8917 -->
         public async Task DeleteObjectAsync(string key)
                 {
                     if (_isRedisAvailable)
@@ -295,6 +307,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="pattern">The pattern used to match Redis keys to be deleted.</param>
         /// <returns>The number of keys that were deleted.</returns>
+        /// <!-- aidoc:v1 sig=691e7ee body=f96f2c9 -->
         public async Task<long> DeleteByPatternAsync(string pattern)
                 {
                     if (!_isRedisAvailable || _server == null)
@@ -311,6 +324,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Clears all cached data by flushing the underlying server database. If the server instance is <see langword="null"/>, the call is safely skipped as a no-op.
         /// </summary>
+        /// <!-- aidoc:v1 sig=f510ade -->
         public void CleanCache()
                     => _server?.FlushDatabase();
 
@@ -321,6 +335,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The cache key used to classify the entity type and determine the applicable TTL.</param>
         /// <returns>A <see cref="TimeSpan"/> representing the configured TTL, or <c>null</c> if the resolved seconds value is not positive.</returns>
+        /// <!-- aidoc:v1 sig=be2ec4a body=d7d015b -->
         private TimeSpan? GetEntityTtl(string key)
                 {
                     var entity = CacheKeyClassifier.Classify(key);
@@ -341,6 +356,7 @@ namespace adas_core.Application.Services.Caching
         /// </summary>
         /// <param name="key">The key identifying the entity whose TTL presence is being checked.</param>
         /// <returns><c>true</c> if a TTL value is found for the specified key; otherwise, <c>false</c>.</returns>
+        /// <!-- aidoc:v1 sig=9f4c827 -->
         private bool ShouldRenewTtl(string key)
                     => GetEntityTtl(key) != null;
 
@@ -349,6 +365,7 @@ namespace adas_core.Application.Services.Caching
         /// <summary>
         /// Initializes the Redis connection for caching by connecting asynchronously, obtaining the database and server, and marking the connection as available on success. Returns early without establishing a connection when the configured Redis connection string is null, and logs any exception that occurs during initialization without rethrowing, leaving the connection marked as unavailable.
         /// </summary>
+        /// <!-- aidoc:v1 sig=819c56e body=e2d6e2b -->
         private async Task InitializeRedisConnectionAsync()
                 {
                     _isRedisAvailable = false;
@@ -377,6 +394,7 @@ namespace adas_core.Application.Services.Caching
         /// <param name="ttlOverride">An optional time-to-live override; not applied by this overload.</param>
         /// <param name="updateExpiration">When true, the expiration of the cached entry is refreshed on retrieval.</param>
         /// <returns>A task that resolves to the cached object, or null if no entry exists for the specified key.</returns>
+        /// <!-- aidoc:v1 sig=dc7158d -->
         public Task<T?> GetObjectAsync<T>(string key, TimeSpan? ttlOverride, bool updateExpiration)
                     => GetObjectAsync<T>(key, updateExpiration);
     }
diff --git a/adas-core.Application/Services/CalculatedObservationsService.cs b/adas-core.Application/Services/CalculatedObservationsService.cs
index cb04f05f..179be900 100644
--- a/adas-core.Application/Services/CalculatedObservationsService.cs
+++ b/adas-core.Application/Services/CalculatedObservationsService.cs
@@ -11,6 +11,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Implements the <see cref="ICalculatedObservationsService"/> contract, providing a service for working with calculated observations.
 /// </summary>
+/// <!-- aidoc:v1 sig=955972a -->
 public class CalculatedObservationsService : ICalculatedObservationsService
 {
     private static ICalculatedObservations? _service;
@@ -78,6 +79,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// <param name="obs">The patient observation to map.</param>
     /// <param name="onlyByName">When <c>true</c>, restricts the mapping to lookups by name only.</param>
     /// <returns>The mapped <see cref="PatientObservation"/>, or <c>null</c> when the service yields no result; the input <paramref name="obs"/> is returned unchanged when no mapping service is configured.</returns>
+    /// <!-- aidoc:v1 sig=4b4df54 body=a7f1fb2 -->
     public virtual async Task<PatientObservation?> Map(PatientObservation obs, bool onlyByName = false)
     {
         if (_service == null) return obs;
@@ -94,6 +96,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// <param name="obs">The patient observation alarm to be mapped.</param>
     /// <param name="onlyByName">When true, restricts the mapping to a name-based lookup only.</param>
     /// <returns>The mapped <see cref="PatientObservationAlarm"/>, or <c>null</c> if the service mapped it to null, or the original <paramref name="obs"/> when no service is configured.</returns>
+    /// <!-- aidoc:v1 sig=550b0f3 body=a7f1fb2 -->
     public virtual async Task<PatientObservationAlarm?> Map(PatientObservationAlarm obs, bool onlyByName = false)
     {
         if (_service == null) return obs;
@@ -110,6 +113,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="obs">The pump observation to be mapped.</param>
     /// <returns>A task that yields the mapped <see cref="PumpObservation"/>, or <see langword="null"/> if no mapping service is available.</returns>
+    /// <!-- aidoc:v1 sig=b69cb93 body=75e8a34 -->
     public virtual async Task<PumpObservation?> Map(PumpObservation obs)
     {
         if (_service == null) return null;
@@ -122,6 +126,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="obs">The <see cref="PatientRecordingAlert"/> instance to be mapped.</param>
     /// <returns>The mapped <see cref="PatientRecordingAlert"/>, the original <paramref name="obs"/> if no service is available, or <c>null</c> if the service returned no result.</returns>
+    /// <!-- aidoc:v1 sig=3678681 body=9648481 -->
     public async Task<PatientRecordingAlert?> Map(PatientRecordingAlert obs)
     {
         if (_service == null) return obs;
@@ -137,6 +142,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="treatment">The patient treatment instance to be mapped or transformed.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the mapped <see cref="PatientTreatment"/> or <c>null</c> if the service returns no result.</returns>
+    /// <!-- aidoc:v1 sig=b468f2f body=1c73c0e -->
     public async Task<PatientTreatment?> Map(PatientTreatment treatment)
     {
         if (_service == null) return treatment;
@@ -149,6 +155,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task that yields the mapped <see cref="PatientDiagnosis"/>, or <c>null</c> if the underlying service returns no result.</returns>
+    /// <!-- aidoc:v1 sig=fd30fa4 body=5966a0e -->
     public virtual async Task<PatientDiagnosis?> Map(PatientDiagnosis diagnosis)
     {
         if (_service == null) return diagnosis;
@@ -162,6 +169,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The unique identifier of the patient whose medicine observations are being calculated.</param>
+    /// <!-- aidoc:v1 sig=0dfd9f3 body=65bf3e9 -->
     public virtual async Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         if (_service != null) await _service.CalculateMedicineObservation(activeMedicines, patientId);
@@ -172,6 +180,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// If the service dependency is not initialized, the call is skipped silently as a no-op fallback.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus opiates calculation is performed.</param>
+    /// <!-- aidoc:v1 sig=e30b38f body=a756e48 -->
     public async Task CalculateBolusOpiates(ObjectId patientId)
     {
         if (_service != null) await _service.CalculateActiveBolus(patientId);
@@ -183,6 +192,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments should be retrieved.</param>
     /// <returns>A task that yields the collection of active <see cref="PatientTreatment"/> entries for the patient, or an empty list when the service is unavailable.</returns>
+    /// <!-- aidoc:v1 sig=4caccd9 body=3a62497 -->
     public virtual async Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         if (_service != null) return await _service.GetActiveTreatmentsByPatient(id);
@@ -194,6 +204,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be mapped.</param>
     /// <returns>A task containing the mapped list of patient observations, or an empty list if no service is configured.</returns>
+    /// <!-- aidoc:v1 sig=8d07ed3 body=5a2680c -->
     public virtual async Task<List<PatientObservation>> MapList(List<PatientObservation> listToInsert)
     {
         if (_service != null) return await _service.PreMapList(listToInsert);
@@ -206,6 +217,7 @@ public class CalculatedObservationsService : ICalculatedObservationsService
     /// <param name="observation">The patient observation onto which the source alarm will be mapped.</param>
     /// <param name="observationAlarm">The source alarm to be applied to the observation.</param>
     /// <returns>The <see cref="PatientObservation"/> produced by the service mapping, or the original <paramref name="observation"/> when no service is configured.</returns>
+    /// <!-- aidoc:v1 sig=20c558b body=7b3984c -->
     public virtual async Task<PatientObservation> MapSourceAlarm(PatientObservation observation,
             PatientObservationAlarm observationAlarm)
     {
diff --git a/adas-core.Application/Services/CameraService.cs b/adas-core.Application/Services/CameraService.cs
index 244dd1f0..a1e3cc63 100644
--- a/adas-core.Application/Services/CameraService.cs
+++ b/adas-core.Application/Services/CameraService.cs
@@ -15,6 +15,7 @@ namespace adas_core.Application.Services;
 /// <remarks>
 /// This service implements <see cref="ICameraService"/> and serves as the application-layer entry point for camera functionality.
 /// </remarks>
+/// <!-- aidoc:v1 sig=6d5b4e8 -->
 public class CameraService(ILogger<CameraService> logger, ICameraRepository cameraRepository, IPointOfCareService pointOfCareService) : ICameraService
 {
     private ICameraRepository _cameraRepository = cameraRepository;
@@ -24,6 +25,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay used to look up the camera.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Camera"/>, or null if no camera is found.</returns>
+    /// <!-- aidoc:v1 sig=b585cc5 body=450c6f8 -->
     public Task<Camera?> GetById(ObjectId relayId)
     {
         return _cameraRepository.GetById(relayId);
@@ -33,6 +35,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// </summary>
     /// <param name="configurationRelayList">The list of configuration relay identifiers used to look up the corresponding cameras.</param>
     /// <returns>A <see cref="List{Camera}"/> containing the cameras linked to the provided configuration relay identifiers.</returns>
+    /// <!-- aidoc:v1 sig=63176e6 body=610970a -->
     public List<Camera> GetCameraInList(List<ObjectId> configurationRelayList)
     {
         return _cameraRepository.GetCameraInList(configurationRelayList);
@@ -43,6 +46,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// </summary>
     /// <param name="filter">The pagination filter that controls page number, page size, and optional filtering criteria such as the in-use flag.</param>
     /// <returns>A paginated response containing the requested cameras, the current page metadata, and the total document count; if no data is found, an empty paginated response is returned.</returns>
+    /// <!-- aidoc:v1 sig=6103643 body=d38962d -->
     public async Task<PaginationResponse<Camera>> GetPaginatedCameras(PaginationFilter filter)
     {
         var usedCameraIds = await pointOfCareService.FindAllIdCamerasInUse();
@@ -91,6 +95,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// <returns>The inserted camera, or null if the insertion did not return a result.</returns>
     /// <exception cref="System.Exception">Thrown when the camera name is null.</exception>
     /// <exception cref="System.Exception">Thrown when a camera with the same name already exists.</exception>
+    /// <!-- aidoc:v1 sig=79f6b28 body=dcffae0 -->
     public async Task<Camera?> InsertCamera(Camera camera)
     {
         if (camera.Name == null) throw new Exception("Camera name cannot be null");
@@ -105,6 +110,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// <param name="objectId">The unique identifier of the camera to update.</param>
     /// <param name="camera">The camera data containing the updated values.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Camera"/>, or <c>null</c> if no camera with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=b7e4a05 body=a5d1055 -->
     public async Task<Camera?> UpdateCameraById(ObjectId objectId, Camera camera)
     {
         return await _cameraRepository.UpdateCameraAsync(objectId, camera);
@@ -115,6 +121,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// </summary>
     /// <param name="objectId">The unique identifier of the camera to delete.</param>
     /// <returns><c>true</c> if the camera was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=38e3ead body=afabb83 -->
     public async Task<bool> DeleteCamera(ObjectId objectId)
     {
         try
@@ -138,6 +145,7 @@ public class CameraService(ILogger<CameraService> logger, ICameraRepository came
     /// </summary>
     /// <param name="textToSearch">The search text used to find cameras by name.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Camera"/> objects that match the search criteria.</returns>
+    /// <!-- aidoc:v1 sig=a584e66 body=7c6677d -->
     public async Task<List<Camera>> GetSearchByNameCameras(string textToSearch)
     {
         return await _cameraRepository.GetSearchByNameCameras(textToSearch);
diff --git a/adas-core.Application/Services/ConfigObservationService.cs b/adas-core.Application/Services/ConfigObservationService.cs
index 2721fe1c..cd0cbc3c 100644
--- a/adas-core.Application/Services/ConfigObservationService.cs
+++ b/adas-core.Application/Services/ConfigObservationService.cs
@@ -27,6 +27,7 @@ namespace adas_core.Application.Services;
 /// <remarks>
 /// Acts as the default service type that fulfills the configuration observation interface.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b6374e4 -->
 public class ConfigObservationService : IConfigObservationService
 {
     private static readonly ConcurrentDictionary<ObjectId, ConfigObservationCached> CachedConfigObservations = new();
@@ -96,6 +97,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="ct">A token to monitor for cancellation requests.</param>
     /// <returns>A collection of all <see cref="ConfigObservation"/> entries, sourced from cache when available or from the repository otherwise.</returns>
+    /// <!-- aidoc:v1 sig=c20c545 body=6a29098 -->
     public async Task<ICollection<ConfigObservation>> GetAllConfigs(CancellationToken ct = default)
     {
 
@@ -115,6 +117,7 @@ public class ConfigObservationService : IConfigObservationService
     /// Retrieves a compact representation of all configuration observations by returning the total item count.
     /// </summary>
     /// <returns>A <see cref="ConfigObservationDto"/> containing the total number of configuration observations.</returns>
+    /// <!-- aidoc:v1 sig=42b2f1f body=5519b7f -->
     public async Task<ConfigObservationDto> GetAllCompact()
     {
         var count = await _configObservationRepository.Count();
@@ -126,6 +129,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="filter">The pagination filter containing the requested page number and page size used to retrieve the items and populate the response metadata.</param>
     /// <returns>A <see cref="PaginationResponse{ConfigObservation}"/> containing the items for the requested page and the total count of all available items.</returns>
+    /// <!-- aidoc:v1 sig=6f51347 body=9b21a36 -->
     public async Task<PaginationResponse<ConfigObservation>> GetPaginatedItems(PaginationFilter filter)
     {
         var result = await _configObservationRepository.GetPaginatedItems(filter);
@@ -141,6 +145,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation to retrieve.</param>
     /// <returns>The configuration observation matching the specified identifier, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=1821829 body=5e45c12 -->
     public async Task<ConfigObservation?> GetConfigById(ObjectId id)
     {
         return await _configObservationRepository.FindById(id) ?? null;
@@ -151,6 +156,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="id">The identifier used to look up the related configuration names.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of configuration names matching the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=cff8c0e body=4d4999a -->
     public async Task<List<string>> GetConfigNames(string id)
     {
         return await _configObservationRepository.GetConfigNames(id);
@@ -160,6 +166,7 @@ public class ConfigObservationService : IConfigObservationService
     /// Retrieves the list of configuration names from the configuration observation repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of configuration names.</returns>
+    /// <!-- aidoc:v1 sig=fee3cef body=35d2c7e -->
     public async Task<List<string>> GetConfigNames()
     {
         return await _configObservationRepository.GetConfigNames();
@@ -172,6 +179,8 @@ public class ConfigObservationService : IConfigObservationService
     /// <typeparam name="T">The patient observation type, constrained to <see cref="BasePatientObservation"/>.</typeparam>
     /// <param name="obs">The patient observation for which the retention action is being evaluated.</param>
     /// <returns>A task containing the resolved <see cref="ObservatitonRetentionResult"/>, or null when no configuration is available.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The method's return type is nullable, but the code always returns a non-null ObservatitonRetentionResult (falling back to NoDelete/null-policy-value), never null. The doc claims it returns null when no configuration is available, which is incorrect." -->
     public async Task<ObservatitonRetentionResult?> RetentionActions<T>(T obs) where T : BasePatientObservation
     {
         var conf = await Get(obs);
@@ -192,6 +201,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="min">The optional minimum reference value included in the mapping.</param>
     /// <param name="max">The optional maximum reference value included in the mapping.</param>
     /// <returns>A task that resolves to the <see cref="StatusEnum.Type"/> computed from the mapped observation, or <see cref="StatusEnum.Type.Ok"/> when no applicable configuration or mapping status is found.</returns>
+    /// <!-- aidoc:v1 sig=2998c17 body=c347213 -->
     public async Task<StatusEnum.Type> GroupedObservationStatus(GroupedField groupedField,
             GroupedObservationEnum.Result result,
             string name, object value, double? min, double? max)
@@ -228,6 +238,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <param name="onlyByName">If <c>true</c>, the configuration lookup is performed by name only; otherwise the full lookup is used.</param>
     /// <returns>The mapped observation, the original observation when unknown observations are allowed, or <c>null</c> when mapping is ignored or the configuration is invalid.</returns>
+    /// <!-- aidoc:v1 sig=adab269 body=bb82b7b -->
     public async Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         var conf = onlyByName ? await Get(obs, onlyByName) : await Get(obs);
@@ -253,6 +264,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation to remove.</param>
     /// <returns>The removed <see cref="ConfigObservation"/> if it was found and deleted; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=93970f8 body=d775460 -->
     public async Task<ConfigObservation?> RemoveConfigItem(ObjectId id)
     {
         var item = await _configObservationRepository.FindById(id);
@@ -272,6 +284,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="treatment">The patient treatment whose requested give codes are resolved against the configuration store.</param>
     /// <returns>The original <see cref="PatientTreatment"/> if a valid configuration is found, or <c>null</c> when the treatment should be discarded.</returns>
+    /// <!-- aidoc:v1 sig=b468f2f body=f7cc310 -->
     public async Task<PatientTreatment?> Map(PatientTreatment treatment)
     {
         ConfigObservation? conf = null;
@@ -292,6 +305,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="obs">The patient observation whose matching configuration should be resolved.</param>
     /// <param name="onlyByName">When <c>true</c>, the lookup is restricted to matching by <see cref="BasePatientObservation.Name"/> only; otherwise matching also considers code, coding system, and parent observation data.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the matched <see cref="ConfigObservation"/> processed via <c>Process</c>, or <c>null</c> if no configuration items are available or no match is found.</returns>
+    /// <!-- aidoc:v1 sig=887109c body=724c8ab -->
     public async Task<ConfigObservation?> Get<T>(T obs, bool onlyByName = false)
             where T : BasePatientObservation
     {
@@ -369,6 +383,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="codingSystem">The coding system identifier used to filter the observation. May be <see langword="null"/>.</param>
     /// <param name="code">The code value used to filter the observation. May be <see langword="null"/>.</param>
     /// <returns>A processed <see cref="ConfigObservation"/> if a match is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=35cb21e body=8c37456 -->
     public async Task<ConfigObservation?> GetByCodeSysAndCode(string? codingSystem, string? code)
     {
         var filteredResult = await _configObservationRepository.GetByCodeSysAndCode(codingSystem, code);
@@ -384,6 +399,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="name">The name of the configuration to look up; if null or empty, the method returns <c>null</c>.</param>
     /// <returns>A <see cref="ConfigObservation"/> when a matching configuration is found and successfully processed; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=2eba3bf body=dd0b407 -->
     public async Task<ConfigObservation?> Get(string? name)
     {
         if (string.IsNullOrEmpty(name)) return null;
@@ -406,6 +422,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="configObservationItem">The configuration observation payload containing the identifier of the record to update.</param>
     /// <returns>The updated <see cref="ConfigObservation"/>.</returns>
     /// <exception cref="NotFoundException">Thrown when no configuration observation exists for the supplied id.</exception>
+    /// <!-- aidoc:v1 sig=9196090 body=719174b -->
     public async Task<ConfigObservation?> UpdateConfig(ConfigObservation configObservationItem)
     {
         // if (!configObservationItem.Id.HasValue)
@@ -429,6 +446,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="name">The name used to look up the configuration observation items.</param>
     /// <returns>A collection of <see cref="ConfigObservation"/> items matching the specified name.</returns>
     /// <exception cref="NotFoundException">Thrown when no configuration observation items are found for the given name.</exception>
+    /// <!-- aidoc:v1 sig=9b9901d body=5a60f64 -->
     public async Task<IEnumerable<ConfigObservation>?> GetConfigObservationItem(string name)
     {
         var configObservationItems = await _configObservationRepository.FindAllByName(name);
@@ -448,6 +466,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="originalName">The original name of the configuration observation item.</param>
     /// <returns>The matching <see cref="ConfigObservation"/> item.</returns>
     /// <exception cref="NotFoundException">Thrown when no matching configuration observation item is found.</exception>
+    /// <!-- aidoc:v1 sig=3639116 body=123e8de -->
     public async Task<ConfigObservation?> GetSingleConfigObservationItem(string? code, string? codingSystem,
             string? name, string? originalName)
     {
@@ -466,6 +485,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="configObservationItem">The configuration observation item to delete; its identifier is used to locate the existing record.</param>
     /// <returns>A task that resolves to <c>true</c> when the item is successfully deleted.</returns>
     /// <exception cref="ConflictException">Thrown when no configuration observation is found with the specified identifier, or when the underlying delete operation fails.</exception>
+    /// <!-- aidoc:v1 sig=ec35183 body=8a9a0b4 -->
     public async Task<bool> DeleteSingleConfigObservationItem(ConfigObservation configObservationItem)
     {
         var configObservation = await _configObservationRepository.FindById(configObservationItem.Id) ??
@@ -489,6 +509,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="name">The name used to filter configuration observation items.</param>
     /// <returns>A collection of <see cref="ConfigObservation"/> items matching the specified name.</returns>
+    /// <!-- aidoc:v1 sig=6809b70 body=c80c2e5 -->
     public async Task<IEnumerable<ConfigObservation>> GetConfigObservationItemsByName(string name)
     {
         return await _configObservationRepository.FindAllByName(name);
@@ -500,6 +521,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="configObservation">The configuration observation entity to persist.</param>
     /// <returns>The created <see cref="ConfigObservation"/> if the operation succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when a configuration observation with the same identifier already exists.</exception>
+    /// <!-- aidoc:v1 sig=d966188 body=7d8c724 -->
     public async Task<ConfigObservation?> CreateConfig(ConfigObservation configObservation)
     {
 
@@ -520,6 +542,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="itemName">The name of the configuration item to remove.</param>
     /// <returns>The removed <see cref="ConfigObservation"/>, or <c>null</c> if the repository did not return a result.</returns>
     /// <exception cref="ConflictException">Thrown when no configuration item is found with the specified name.</exception>
+    /// <!-- aidoc:v1 sig=f100c88 body=ec848a3 -->
     public async Task<ConfigObservation?> RemoveConfigItem(string itemName)
     {
         var configObservation = await GetConfigByName(itemName) ??
@@ -543,6 +566,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="configObservationId">The unique identifier of the configuration observation to retrieve.</param>
     /// <returns>The configuration observation obtained from cache or repository, or a new empty instance when no matching record exists.</returns>
+    /// <!-- aidoc:v1 sig=f3c60d4 body=645b284 -->
     public async Task<ConfigObservation?> GetConfig(ObjectId configObservationId)
     {
         RefreshCachedConfigObservations();
@@ -570,6 +594,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="name">The case-insensitive name of the configuration observation to look up.</param>
     /// <returns>The matching <see cref="ConfigObservation"/>, or <c>null</c> if not found or the name is invalid.</returns>
+    /// <!-- aidoc:v1 sig=b4fcdb3 body=2875d2c -->
     public async Task<ConfigObservation?> GetConfigByName(string name)
     {
         if (string.IsNullOrWhiteSpace(name)) return null;
@@ -602,6 +627,7 @@ public class ConfigObservationService : IConfigObservationService
     /// Removes expired entries from the cached configuration observations when a refresh timeout is configured,
     /// performing an early return if no refresh timeout is set.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1aa90f3 body=0a408f4 -->
     private void RefreshCachedConfigObservations()
     {
         if (!_refreshTimeout.HasValue) return;
@@ -620,6 +646,7 @@ public class ConfigObservationService : IConfigObservationService
     /// </summary>
     /// <param name="confItem">The configuration observation to process. Its retention policy and retention policy value are updated in place.</param>
     /// <returns>A task containing the processed <see cref="ConfigObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=d6edc85 body=6ba1090 -->
     private Task<ConfigObservation> Process(ConfigObservation confItem)
     {
         confItem.RetentionPolicy ??= _defaultRetentionPolicy;
@@ -641,6 +668,7 @@ public class ConfigObservationService : IConfigObservationService
     /// If no refresh timeout is set, the method returns without performing any cleanup.
     /// Any exceptions encountered during the cleanup are caught and logged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3e4c66 body=bb82f36 -->
     private void RefreshCachedConfigObservationKeys()
     {
         try
@@ -670,6 +698,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <param name="obs">The observation instance to enrich with configuration values. Modified in place.</param>
     /// <param name="conf">The configuration observation providing thresholds, colors, expiration, and other settings to apply.</param>
     /// <returns>The mapped observation, returned as-is when the observation's coding system is configured to skip status calculation.</returns>
+    /// <!-- aidoc:v1 sig=4cafe53 body=3ca4d27 -->
     private async Task<T?> MapConf<T>(T obs, ConfigObservation conf) where T : BasePatientObservation
     {
         _logger.LogTrace("Mapping observation: {obs}", obs);
@@ -819,6 +848,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <remarks>
     /// This type is intended to be used internally to store and reuse configuration observation results.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=9f92750 -->
     private class ConfigObservationCached
     {
         public DateTime NextRefresh { get; set; }
@@ -828,6 +858,7 @@ public class ConfigObservationService : IConfigObservationService
     /// <summary>
     /// Represents a private cache entry for configuration observation keys, used to store and retrieve previously computed key values associated with configuration observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=280cb2a -->
     private class ConfigObservationKeyCached
     {
         public DateTime NextRefresh { get; set; }
diff --git a/adas-core.Application/Services/ConfigPumpsService.cs b/adas-core.Application/Services/ConfigPumpsService.cs
index a6dd56d1..62ef8a72 100644
--- a/adas-core.Application/Services/ConfigPumpsService.cs
+++ b/adas-core.Application/Services/ConfigPumpsService.cs
@@ -40,6 +40,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="obs">The pump observation to map, containing the alarm type used for configuration lookup.</param>
     /// <returns>The mapped pump observation, or the original observation when mapping is skipped or the configuration lookup yields no result.</returns>
+    /// <!-- aidoc:v1 sig=daf9ea9 body=b1d8856 -->
     public async Task<PumpObservation> Map(PumpObservation obs)
     {
         if (!_configPumpsRequired) return obs;
@@ -57,6 +58,7 @@ public class ConfigPumpsService(
     /// Retrieves all available pump configurations from the underlying repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ConfigPumps"/> if any are available, or <c>null</c> when no configurations exist.</returns>
+    /// <!-- aidoc:v1 sig=23fc0df body=05ec99d -->
     public async Task<List<ConfigPumps>?> GetAllPumpConfigs()
     {
         return await configPumpsRepository.GetAllConfigs();
@@ -68,6 +70,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="id">The unique identifier of the pump configuration to retrieve.</param>
     /// <returns>A <see cref="ConfigPumps"/> instance if a matching configuration is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=d9bd34a body=d1db9d5 -->
     public async Task<ConfigPumps?> GetPumpConfigById(string id)
     {
         return await configPumpsRepository.FindById(id);
@@ -78,6 +81,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="id">The unique identifier of the config pump to look up.</param>
     /// <returns>A task that resolves to the list of <see cref="ConfigPumpItem"/> entries, or <c>null</c> if the config pump does not exist.</returns>
+    /// <!-- aidoc:v1 sig=68a23c4 body=0689fc9 -->
     public async Task<List<ConfigPumpItem>?> GetConfigItems(string id)
     {
         var result = await configPumpsRepository.FindById(id);
@@ -91,6 +95,7 @@ public class ConfigPumpsService(
     /// <param name="pumpConfig">The pump configuration to update, identified by its <see cref="ConfigPumps.Id"/>.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated <see cref="ConfigPumps"/>.</returns>
     /// <exception cref="ConflictException">Thrown when the update operation fails.</exception>
+    /// <!-- aidoc:v1 sig=373d0cc body=519fb70 -->
     public async Task<ConfigPumps?> UpdatePumpConfig(ConfigPumps pumpConfig)
     {
         var oldPumpConfig = configPumpsRepository.FindById(pumpConfig.Id);
@@ -106,6 +111,8 @@ public class ConfigPumpsService(
     /// <param name="pumpConfig">The pump configuration to insert.</param>
     /// <returns>The inserted <see cref="ConfigPumps"/> on success; otherwise, <c>null</c> when an error occurs during the operation.</returns>
     /// <exception cref="ConflictException">Thrown when the inserted configuration cannot be found in the repository after insertion.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "ConflictException is documented as thrown, but it is raised inside a try block whose catch handler logs it and returns null, so the exception never propagates to the caller." -->
     public async Task<ConfigPumps?> InsertPumpConfig(ConfigPumps pumpConfig)
     {
         try
@@ -128,6 +135,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="config">The <see cref="ConfigPumps"/> instance representing the pump configuration to delete.</param>
     /// <returns>A task that resolves to <c>true</c> when the configuration is deleted and the audit log is recorded; <c>false</c> when the delete operation fails or an exception occurs.</returns>
+    /// <!-- aidoc:v1 sig=5589ecb body=49cc999 -->
     public async Task<bool> DeletePumpConfig(ConfigPumps config)
     {
         try
@@ -156,6 +164,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="obs">The pump observation for which to evaluate the retention policy.</param>
     /// <returns>A task containing the retention result with the applicable policy and associated value, or a default NoDelete result when no policy is configured.</returns>
+    /// <!-- aidoc:v1 sig=57930e3 body=186775f -->
     public async Task<ObservatitonRetentionResult?> RetentionActions(PumpObservation obs)
     {
         //TODO sacarlo de la configuración específica de Bombas
@@ -171,6 +180,7 @@ public class ConfigPumpsService(
     /// <param name="obs">The pump observation that will receive the UI configuration.</param>
     /// <param name="conf">The configuration source whose UI configuration is applied to <paramref name="obs"/> when present.</param>
     /// <returns>A completed <see cref="Task{PumpObservation}"/> containing the updated observation.</returns>
+    /// <!-- aidoc:v1 sig=ad0f0ed body=76b8f24 -->
     private static Task<PumpObservation> MapConf(PumpObservation obs, ConfigPumpItem conf)
     {
         if (conf.UiConfiguration != null && conf.UiConfiguration.Count != 0)
@@ -184,6 +194,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="alarmType">The string representation of the alarm type to look up; if it cannot be parsed into a valid <see cref="PumpEnum.AlarmType"/>, the method returns <c>null</c>.</param>
     /// <returns>A <see cref="ConfigPumpItem"/> whose <c>AlarmType</c> matches the parsed value, or <c>null</c> if parsing fails or no matching item is found.</returns>
+    /// <!-- aidoc:v1 sig=bc81e4a body=6b0def6 -->
     private async Task<ConfigPumpItem?> Get(string alarmType)
     {
         if (!Enum.TryParse(alarmType, out PumpEnum.AlarmType alarmTypeParsed))
@@ -198,6 +209,7 @@ public class ConfigPumpsService(
     /// </summary>
     /// <param name="pobs">The pump observation whose <c>MessageType</c> is used to locate the corresponding configuration entry.</param>
     /// <returns>A <see cref="ConfigPumpItem"/> matching the observation's message type, or <c>null</c> if the configuration is unavailable or no matching item exists.</returns>
+    /// <!-- aidoc:v1 sig=41e31d5 body=63aa76f -->
     private async Task<ConfigPumpItem?> Get(PumpObservation pobs)
     {
         var config = await GetConfig();
@@ -208,6 +220,7 @@ public class ConfigPumpsService(
     /// Returns a null list if the underlying configuration is not available.
     /// </summary>
     /// <returns>A task containing a list of <see cref="ConfigPumpItem"/> objects, or <c>null</c> if the configuration could not be retrieved.</returns>
+    /// <!-- aidoc:v1 sig=e2506bb body=a5ff078 -->
     public async Task<List<ConfigPumpItem>?> Get()
     {
         var result = await GetConfig();
@@ -220,6 +233,7 @@ public class ConfigPumpsService(
     /// Falls back to fetching from the repository when the cache is missing or stale, and returns <c>null</c> if an error occurs during retrieval.
     /// </summary>
     /// <returns>A task containing the <see cref="ConfigPumps"/> instance if available; otherwise, <c>null</c> when the repository lookup fails.</returns>
+    /// <!-- aidoc:v1 sig=5717dca body=174bbb3 -->
     private async Task<ConfigPumps?> GetConfig()
     {
         try
diff --git a/adas-core.Application/Services/ConfigUnitsService.cs b/adas-core.Application/Services/ConfigUnitsService.cs
index 36330d0b..e10e91f6 100644
--- a/adas-core.Application/Services/ConfigUnitsService.cs
+++ b/adas-core.Application/Services/ConfigUnitsService.cs
@@ -37,6 +37,7 @@ public class ConfigUnitsService(
     /// </summary>
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <returns>The mapped observation when a matching unit configuration is resolved; otherwise, the original observation.</returns>
+    /// <!-- aidoc:v1 sig=2c52e52 body=2db877e -->
     public async Task<T> Map<T>(T obs) where T : BasePatientObservation
     {
         if (!_configUnitsRequired) return obs;
@@ -52,6 +53,7 @@ public class ConfigUnitsService(
     /// </summary>
     /// <param name="obs">The <see cref="PumpObservation"/> to be mapped.</param>
     /// <returns>The mapped <see cref="PumpObservation"/>, returned as-is when units configuration is not required or after pump value mapping otherwise.</returns>
+    /// <!-- aidoc:v1 sig=daf9ea9 body=c2e84ce -->
     public async Task<PumpObservation> Map(PumpObservation obs)
     {
         if (!_configUnitsRequired) return obs;
@@ -68,6 +70,7 @@ public class ConfigUnitsService(
     /// <summary>
     ///     Recorre recursivamente las propiedades del objeto para encontrar y convertir PumpValues.
     /// </summary>
+    /// <!-- aidoc:v1 sig=01209a6 body=958cccd -->
     private async Task MapPumpValues(object? targetObject)
     {
         if (targetObject == null) return;
@@ -106,6 +109,7 @@ public class ConfigUnitsService(
     /// <param name="obs">The base patient observation to which the configured unit value will be applied.</param>
     /// <param name="conf">The configuration unit item whose <c>Value</c> is used as the unit to assign.</param>
     /// <returns>The input observation, with <c>Units</c> set from <paramref name="conf"/> when applicable, or the unchanged observation when it is not a <see cref="PatientObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=ef286fc body=8674339 -->
     private T MapConf<T>(T obs, ConfigUnitItem conf) where T : BasePatientObservation
     {
         if (obs is not PatientObservation pobs) return obs;
@@ -122,6 +126,7 @@ public class ConfigUnitsService(
     /// </summary>
     /// <param name="code">The unique code identifier of the configuration unit item to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigUnitItem"/>, or null if the configuration is unavailable or no item is found.</returns>
+    /// <!-- aidoc:v1 sig=b153e30 body=ca52840 -->
     public async Task<ConfigUnitItem?> Get(string code)
     {
         var result = await GetConfig();
@@ -138,6 +143,7 @@ public class ConfigUnitsService(
     /// A <see cref="Task{TResult}"/> containing the cached or freshly fetched <see cref="ConfigUnits"/>, or
     /// <c>null</c> if the repository lookup fails.
     /// </returns>
+    /// <!-- aidoc:v1 sig=982237a body=0843e00 -->
     private async Task<ConfigUnits?> GetConfig()
     {
         try
diff --git a/adas-core.Application/Services/DefaultCalculatedObservations.cs b/adas-core.Application/Services/DefaultCalculatedObservations.cs
index 1be375d3..1d91094d 100644
--- a/adas-core.Application/Services/DefaultCalculatedObservations.cs
+++ b/adas-core.Application/Services/DefaultCalculatedObservations.cs
@@ -9,6 +9,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Provides the default implementation of the <see cref="ICalculatedObservations"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=9026718 -->
 public class DefaultCalculatedObservations : ICalculatedObservations
 {
     /// <summary>
@@ -16,6 +17,8 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient, used as the basis for the observation calculation.</param>
     /// <param name="patientId">The identifier of the patient whose medicine observations are being calculated.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'calculates medicine observations', but the body only returns Task.CompletedTask without performing any calculation or observation logic." -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
         {
             return Task.CompletedTask;
@@ -25,6 +28,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// Calculates the active bolus for the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose active bolus is being calculated.</param>
+    /// <!-- aidoc:v1 sig=7d38721 body=6805ef5 -->
     public Task CalculateActiveBolus(ObjectId patientId)
         {
             return Task.CompletedTask;
@@ -36,6 +40,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to map.</param>
     /// <param name="onlyByName">A flag indicating whether mapping should be performed by name only.</param>
     /// <returns>A completed <see cref="Task{T}"/> containing the provided observation.</returns>
+    /// <!-- aidoc:v1 sig=84684f5 body=9f66f26 -->
     public Task<T?> Map<T>(T obs, bool onlyByName) where T : BasePatientObservation
         {
             return Task.FromResult(obs)!;
@@ -46,6 +51,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="treatment">The patient treatment to map.</param>
     /// <returns>A <see cref="Task{PatientTreatment}"/> that completes with the supplied <paramref name="treatment"/>.</returns>
+    /// <!-- aidoc:v1 sig=adce250 body=cf46cd2 -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
         {
             return Task.FromResult(treatment);
@@ -57,6 +63,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments are being retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing an enumerable collection of the patient's active treatments, or an empty collection if none are found.</returns>
+    /// <!-- aidoc:v1 sig=db74f82 body=69cdec0 -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
         {
             return Task.FromResult<IEnumerable<PatientTreatment?>>(new List<PatientTreatment?>());
@@ -67,6 +74,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to map.</param>
     /// <returns>A task that represents the asynchronous operation, containing the provided patient diagnosis.</returns>
+    /// <!-- aidoc:v1 sig=8ddf601 body=ad326e6 -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
         {
             return Task.FromResult(diagnosis);
@@ -78,6 +86,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// <param name="pumpObservation">The source <see cref="PumpObservation"/> to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PumpObservation"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping logic has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=98ff725 body=bfa6f2f -->
     public Task<PumpObservation> Map(PumpObservation pumpObservation)
         {
             throw new NotImplementedException();
@@ -88,6 +97,8 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="newObservation">The new patient observation to evaluate for time consistency with the prior observation.</param>
     /// <returns>A task that represents the asynchronous operation, containing the provided patient observation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states the method 'processes a new patient observation to address potential time inconsistency with the previous observation', but the implementation simply returns the input observation unchanged without any processing or time-inconsistency handling." -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
         {
             return Task.FromResult<PatientObservation?>(newObservation);
@@ -98,6 +109,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped.</param>
     /// <returns>A completed task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
         {
             return Task.FromResult(listToInsert);
@@ -110,6 +122,7 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to be returned by the mapping.</param>
     /// <param name="alarmToInsert">The patient observation alarm intended to be associated with the observation.</param>
     /// <returns>A completed <see cref="Task{TResult}"/> containing the <see cref="PatientObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
         {
             return Task.FromResult(obs);
@@ -122,6 +135,8 @@ public class DefaultCalculatedObservations : ICalculatedObservations
     /// <param name="name">The name associated with the alarm being sent.</param>
     /// <param name="code">The optional alarm code that categorizes the type of alarm; may be null when no specific code applies.</param>
     /// <exception cref="NotImplementedException">Thrown in all cases, as the method has not been implemented yet.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The summary states the method 'sends an alarm notification', but the method body only throws NotImplementedException and never sends anything." -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
         {
             throw new NotImplementedException();
diff --git a/adas-core.Application/Services/DeviceService.cs b/adas-core.Application/Services/DeviceService.cs
index 91c039c1..54fc05f8 100644
--- a/adas-core.Application/Services/DeviceService.cs
+++ b/adas-core.Application/Services/DeviceService.cs
@@ -13,6 +13,7 @@ namespace adas_core.Application.Services;
 /// Provides the concrete implementation of the <see cref="IDeviceService"/> contract,
 /// handling device-related service operations defined by the interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=16670f2 -->
 public class DeviceService : IDeviceService
 {
     private readonly IDeviceRepository _deviceRepository;
@@ -53,6 +54,7 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="dto">The data transfer object containing the device information to convert.</param>
     /// <returns>A new <see cref="Device"/> entity populated with the values from the supplied DTO.</returns>
+    /// <!-- aidoc:v1 sig=178c6f2 body=778e6dd -->
     public Device ToEntity(DeviceDto dto)
         {
             return new Device()
@@ -78,6 +80,8 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="deviceDto">The data transfer object containing the device information to be mapped and stored.</param>
     /// <returns>The created <see cref="Device"/> entity after successful insertion, or <see langword="null"/> if the device could not be created.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation states the method returns null 'if the device could not be created', but the code has no such null return path—it always returns the non-null device entity after insertion." -->
     public async Task<Device?> Create(DeviceDto deviceDto)
         {
             var device = ToEntity(deviceDto);
@@ -93,6 +97,7 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="objectId">The unique identifier of the object to delete.</param>
     /// <returns>A task that resolves to <c>true</c> if the object was deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=346f3e0 body=6d416f7 -->
     public async Task<bool> Delete(ObjectId objectId)
         {
             return await _deviceRepository.DeleteAsync(objectId) != null;
@@ -103,6 +108,8 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="deviceDto">The data transfer object containing the updated device information.</param>
     /// <returns>The updated <see cref="Device"/> entity, or <c>null</c> if no device is returned.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "The documentation states 'or null if no device is returned', but the implementation always returns the device produced by ToEntity with no null return path." -->
     public async Task<Device?> Update(DeviceDto deviceDto)
         {
             var device = ToEntity(deviceDto);
@@ -116,6 +123,7 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="deviceDto">The data transfer object containing the device information from the event, used for lookup and creation.</param>
     /// <returns>The existing or newly created <see cref="Device"/> associated with the event.</returns>
+    /// <!-- aidoc:v1 sig=12e98a9 body=1a956d8 -->
     public async Task<Device?> ReceiveEvent(DeviceDto deviceDto)
         {
             Device? deviceExist = null;
@@ -168,6 +176,7 @@ public class DeviceService : IDeviceService
     /// </summary>
     /// <param name="deviceExist">The existing device whose configured action settings determine which action to execute.</param>
     /// <param name="deviceDto">The incoming device event payload providing the click type that triggers the action.</param>
+    /// <!-- aidoc:v1 sig=818bb69 body=1d9bf5b -->
     private async Task ManageDeviceButton(Device deviceExist, DeviceDto deviceDto)
         {
             if (deviceExist.Settings?.Action?.Type != null && deviceDto.Event?.ClickType != null)
@@ -193,6 +202,7 @@ public class DeviceService : IDeviceService
     /// <param name="settingsAction">The device action containing the configuration observation and the per-click-type alarm values to use.</param>
     /// <param name="eventClickType">The click event that triggered the action, which determines which value from the device action is sent.</param>
     /// <param name="deviceExistPointOfCareIds">The list of point of care identifiers whose patients should receive the alarm.</param>
+    /// <!-- aidoc:v1 sig=f9291cd body=9b90588 -->
     private async Task SendAlarmOnAction(
             DeviceAction settingsAction,
             ClickType eventClickType,
@@ -256,6 +266,7 @@ public class DeviceService : IDeviceService
     /// <param name="eventClickType">The type of click event that triggered the action; selects which value (single, double, or hold) is assigned to the observation.</param>
     /// <param name="deviceExistPointOfCareIds">The list of point of care identifiers whose resolved patients will receive the generated observation.</param>
     /// <returns>A task that represents the asynchronous send operation; no meaningful business result is returned.</returns>
+    /// <!-- aidoc:v1 sig=4c6f5ee body=ef5e8c7 -->
     private async Task SendObservationOnAction(
             DeviceAction settingsAction,
             ClickType eventClickType,
diff --git a/adas-core.Application/Services/DiagnosisService.cs b/adas-core.Application/Services/DiagnosisService.cs
index f2af030d..42b72f9f 100644
--- a/adas-core.Application/Services/DiagnosisService.cs
+++ b/adas-core.Application/Services/DiagnosisService.cs
@@ -19,6 +19,7 @@ namespace adas_core.Application.Services;
 /// Provides the implementation of the <see cref="IDiagnosisService"/> contract,
 /// offering diagnosis-related operations as defined by the interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=c73da26 -->
 public class DiagnosisService : IDiagnosisService
 {
     private readonly ILocalAuditService _auditService;
@@ -104,6 +105,7 @@ public class DiagnosisService : IDiagnosisService
     /// Archives the specified patient by delegating to the archival routine keyed by the patient's identifier.
     /// </summary>
     /// <param name="patient">The patient to be archived. Its <c>Id</c> is used to locate the record to archive.</param>
+    /// <!-- aidoc:v1 sig=0afe718 body=be01ba0 -->
     public async Task Archive(Patient patient)
         {
             await ArchiveByPatientId(patient.Id);
@@ -113,6 +115,7 @@ public class DiagnosisService : IDiagnosisService
     /// Archives all diagnoses associated with the specified patient by copying them to the diagnosis archive repository and then deleting the original records.
     /// </summary>
     /// <param name="id">The identifier of the patient whose diagnoses will be archived.</param>
+    /// <!-- aidoc:v1 sig=3385472 body=3d03acb -->
     public async Task ArchiveByPatientId(ObjectId id)
         {
             _logger.LogDebug("Archive Diagnoses by Patient Id {id}", id);
@@ -130,6 +133,7 @@ public class DiagnosisService : IDiagnosisService
     /// Deletes all diagnoses associated with the specified patient identifier and records an audit log entry capturing the previous state of the records.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose diagnoses should be deleted.</param>
+    /// <!-- aidoc:v1 sig=09e4e41 body=d64c5ea -->
     public async Task DeleteByPatientId(ObjectId id)
         {
             _logger.LogDebug("Delete Diagnoses by Patient Id {id}", id);
@@ -143,6 +147,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose diagnoses are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientDiagnosis"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=4ed162d body=4bb31fe -->
     public async Task<List<PatientDiagnosis>> GetByPatientId(ObjectId patientId)
         {
             var diagnosis = await _diagnosisRepository.GetByPatient(patientId);
@@ -156,6 +161,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=3385bba body=5d13d47 -->
     public Task SaveRequest(ApiRequest apiRequest)
         {
             return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest, null); }));
@@ -166,6 +172,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="apiRequest">The API request instance to persist.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=5d13d47 -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
         {
             return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest, null); }));
@@ -177,6 +184,7 @@ public class DiagnosisService : IDiagnosisService
     /// <param name="apiRequest">The API request containing the observation codes, values, message time, and optional observation time used to build the diagnosis.</param>
     /// <param name="patient">The patient associated with the diagnosis, whose identifier is assigned to the new <see cref="PatientDiagnosis"/>.</param>
     /// <returns>A task that represents the asynchronous insertion of the resulting <see cref="PatientDiagnosis"/>.</returns>
+    /// <!-- aidoc:v1 sig=feeab82 body=75feb1d -->
     public async Task ProcessDiagnosisObservation(ApiRequest apiRequest, Patient patient)
         {
             _logger.LogDebug("INSERT DiagnosisObservation from obsservation");
@@ -248,6 +256,7 @@ public class DiagnosisService : IDiagnosisService
     /// <param name="apiRequest">The API request containing the type, patient identifiers, location, and observation data to be processed.</param>
     /// <param name="patient">An optional pre-resolved patient; when null, the patient is resolved via the patient service using the request data.</param>
     /// <exception cref="ApiRequestException">Thrown when both the patient number and the location unit name are missing from the request, or when the request type is not valid for diagnosis processing.</exception>
+    /// <!-- aidoc:v1 sig=272fe2f body=50c8fbd -->
     public async Task SaveRequest(ApiRequest apiRequest, Patient? patient)
         {
             if (patient == null)
@@ -319,6 +328,7 @@ public class DiagnosisService : IDiagnosisService
     /// <param name="diagnosis">The list of patient diagnoses to be processed and inserted.</param>
     /// <param name="patient">The patient whose identifier is assigned to each diagnosis entry.</param>
     /// <param name="messageTime">The timestamp assigned to each diagnosis entry during processing.</param>
+    /// <!-- aidoc:v1 sig=2e0a847 body=03c844f -->
     public async Task ProcessDiagnosis(List<PatientDiagnosis> diagnosis, Patient patient, DateTime messageTime)
         {
             _logger.LogDebug("INSERT DiagnosisObservation from diagnosis");
@@ -337,6 +347,7 @@ public class DiagnosisService : IDiagnosisService
     /// <param name="nameId">The name of the identifier field used to locate the records to update.</param>
     /// <param name="id">The new ObjectId to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId to be replaced in the matching records.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=3281a42 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
         {
             await _diagnosisRepository.UpdateManyObjectId(nameId, id, oldId);
@@ -347,6 +358,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose diagnoses are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientDiagnosis"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=3f1244f body=f584950 -->
     public async Task<List<PatientDiagnosis>> GetByPatient(ObjectId id)
         {
             return await _diagnosisRepository.GetByPatient(id);
@@ -357,6 +369,7 @@ public class DiagnosisService : IDiagnosisService
     /// If the diagnosis cannot be mapped (returns null), the insert and broadcast operations are skipped.
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to insert.</param>
+    /// <!-- aidoc:v1 sig=f1354a6 body=fcec185 -->
     public async Task Insert(PatientDiagnosis diagnosis)
         {
             _logger.LogDebug("Insert {diagnosis}", diagnosis);
@@ -374,6 +387,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>The mapped <see cref="PatientDiagnosis"/> produced by the calculated observations mapper, or <see langword="null"/> if the diagnosis was ignored.</returns>
+    /// <!-- aidoc:v1 sig=0440056 body=83aaa02 -->
     private async Task<PatientDiagnosis?> MapDiagnosis(PatientDiagnosis diagnosis)
         {
             var diagnosis2 = await _calculatedObservations.Value.Map(diagnosis);
@@ -386,6 +400,7 @@ public class DiagnosisService : IDiagnosisService
     /// Sends a patient diagnosis broadcast to all subscribers whose registered location matches the patient's location (unit, room, and bed). Returns early without broadcasting if the patient cannot be found.
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis payload to broadcast to the matching subscribers.</param>
+    /// <!-- aidoc:v1 sig=47e7826 body=f462d51 -->
     private async Task SendBroadcast(PatientDiagnosis diagnosis)
         {
             var patient = await _patientService.Value.FindById(diagnosis.PatientId);
@@ -412,6 +427,7 @@ public class DiagnosisService : IDiagnosisService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose diagnosis records are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an asynchronous cursor over the matching <see cref="PatientDiagnosis"/> records.</returns>
+    /// <!-- aidoc:v1 sig=01cba99 body=5a86d75 -->
     public Task<IAsyncCursor<PatientDiagnosis>> FindByPatientIdAsync(ObjectId patientId)
         {
             return _diagnosisRepository.FindByPatientIdAsync(patientId);
@@ -424,6 +440,7 @@ public class DiagnosisService : IDiagnosisService
     /// A broadcast is dispatched asynchronously after a successful insert or update.
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to persist.</param>
+    /// <!-- aidoc:v1 sig=92e37f1 body=456e290 -->
     public async Task InsertDiagnosis(PatientDiagnosis diagnosis)
         {
             try
diff --git a/adas-core.Application/Services/DischargeService.cs b/adas-core.Application/Services/DischargeService.cs
index 2f2893df..0542a2f1 100644
--- a/adas-core.Application/Services/DischargeService.cs
+++ b/adas-core.Application/Services/DischargeService.cs
@@ -22,6 +22,7 @@ namespace adas_core.Application.Services;
 /// This service acts as the default in-memory or infrastructure-backed implementation
 /// of the discharge operations defined by <see cref="IDischargeService"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=61bd286 -->
 public class DischargeService : IDischargeService
 {
     private readonly ILocalAuditService _auditService;
@@ -80,6 +81,10 @@ public class DischargeService : IDischargeService
     /// discharge status), and otherwise falls back to deleting the discharge by its identifier.
     /// </summary>
     /// <param name="discharge">The discharge entity to be deleted.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The summary describes validation of MedicalDischarge, AdminDischarge, and discharge status, but the entire validation block is commented out; the method only calls DeleteDischargeByIdAsync." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The documented behavior of validating and 'falling back' to deletion by id does not match the actual code, which unconditionally deletes by id." -->
     public async Task DeleteDischargeAsync(Discharge discharge)
     {
         //var patient = await _patientServiceLazy.Value.FindById(discharge.PatientId);
@@ -97,6 +102,7 @@ public class DischargeService : IDischargeService
     /// Deletes a discharge record by its identifier. If the discharge is not found, an error is logged and the operation is skipped; otherwise the record is removed, an audit log entry is created, and a delete broadcast is sent.
     /// </summary>
     /// <param name="dischargeId">The unique identifier of the discharge to delete.</param>
+    /// <!-- aidoc:v1 sig=0e0285f body=b646cb5 -->
     public async Task DeleteDischargeByIdAsync(ObjectId dischargeId)
     {
         try
@@ -132,6 +138,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose discharge records will be counted.</param>
     /// <returns>A task representing the asynchronous operation, containing the total number of discharges for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=da93389 body=a6241d6 -->
     public async Task<long> CountDischargesByUnitId(ObjectId unitId)
     {
         return await _dischargeRepository.CountByUnitId(unitId);
@@ -146,6 +153,7 @@ public class DischargeService : IDischargeService
     /// information if a point of care is linked; otherwise the discharge as stored.</returns>
     /// <exception cref="NotFoundException">Thrown when no discharge is found for the specified
     /// <paramref name="dischargeId"/>.</exception>
+    /// <!-- aidoc:v1 sig=12c2e8b body=3015bf8 -->
     public async Task<Discharge?> GetDischargeByIdAsync(ObjectId dischargeId)
     {
         var result = await _dischargeRepository.FindById(dischargeId) ??
@@ -163,6 +171,7 @@ public class DischargeService : IDischargeService
     /// Asynchronously retrieves all discharge records from the repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of <see cref="Discharge"/> records.</returns>
+    /// <!-- aidoc:v1 sig=f526f77 body=05958d1 -->
     public async Task<IEnumerable<Discharge>> GetDischargesAsync()
     {
         return await _dischargeRepository.FindAll();
@@ -173,6 +182,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose discharge record should be retrieved.</param>
     /// <returns>A <see cref="Discharge"/> object populated with patient location information when a point of care is associated, or <c>null</c> if no discharge is found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=9c55b11 body=305bfa7 -->
     public async Task<Discharge?> GetDischargeByPatientId(ObjectId patientId)
     {
         try
@@ -202,6 +212,7 @@ public class DischargeService : IDischargeService
     /// <param name="discharge">The discharge entity to be inserted.</param>
     /// <returns>The persisted <see cref="Discharge"/> entity retrieved from the repository after insertion.</returns>
     /// <exception cref="ConflictException">Thrown when the inserted discharge cannot be found by its identifier, indicating that the creation failed.</exception>
+    /// <!-- aidoc:v1 sig=5b13f28 body=682f5de -->
     public async Task<Discharge?> InsertDischarge(Discharge discharge)
     {
         await _dischargeRepository.InsertOneAsync(discharge);
@@ -220,6 +231,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="location">The patient location used to look up the associated discharge record.</param>
     /// <returns>A <see cref="Discharge"/> if one is found for the given location; otherwise, <c>null</c> when an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=d6f8db9 body=ac06f0e -->
     public async Task<Discharge?> GetDischargeByLocation(PatientLocation location)
     {
         try
@@ -240,6 +252,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="poc">The point of care identifier used to look up the discharge record.</param>
     /// <returns>A <see cref="Discharge"/> with the patient location populated when available, or <c>null</c> if the discharge is not found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=add61b9 body=16738ca -->
     public async Task<Discharge?> GetDischargeByPointOfCareId(ObjectId poc)
     {
         try
@@ -269,6 +282,7 @@ public class DischargeService : IDischargeService
     /// <param name="location">The ObjectId identifying the point of care (location) whose discharge record should be retrieved.</param>
     /// <param name="dataLocale">The locale used to localize the discharge data when the associated unit is found.</param>
     /// <returns>A <see cref="Task{Discharge}"/> containing the localized discharge, the unmodified discharge when its unit cannot be found, or <c>null</c> when no discharge exists for the specified location.</returns>
+    /// <!-- aidoc:v1 sig=4f9546e body=52d6c63 -->
     public async Task<Discharge?> GetDischargeByPointOfCareIdWithLocale(ObjectId location, LocaleEnum dataLocale)
     {
         var discharge = await GetDischargeByPointOfCareId(location);
@@ -284,6 +298,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="discharge">The discharge entity to be updated.</param>
     /// <exception cref="ConflictException">Thrown when no discharge is found with the specified identifier, preventing the update from proceeding.</exception>
+    /// <!-- aidoc:v1 sig=93dfb9f body=eba9c68 -->
     public async Task UpdateDischargeAsync(Discharge discharge)
     {
         var oldDischarge = await GetDischargeByIdAsync(discharge.Id) ??
@@ -300,6 +315,10 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="apiRequest">The API request containing the discharge payload and the operation type to perform.</param>
     /// <!-- aidoc:v1 sig=229d8cd body=acbd395 -->
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "The summary does not mention that the patient is always updated via _patientServiceLazy.Value.Update(apiRequest.Discharge.Patient) before the switch on apiRequest.Type is evaluated." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary states the method 'logs an error when the discharge or patient is null', but when apiRequest.Discharge?.Patient is null the method simply returns silently without logging anything." -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         try
@@ -367,6 +386,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
     /// <returns>A task that completes when the request has been saved.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -378,6 +398,7 @@ public class DischargeService : IDischargeService
     /// </summary>
     /// <param name="discharge">The discharge whose point of care is used to locate matching subscribers and whose data is sent in the broadcast.</param>
     /// <param name="operation">The operation type associated with the outgoing message sent to each subscriber.</param>
+    /// <!-- aidoc:v1 sig=f5450d6 body=93e2063 -->
     public async void SendDischargeBroadcast(Discharge discharge, OperationType operation)
     {
         try
@@ -419,6 +440,7 @@ public class DischargeService : IDischargeService
     /// <param name="opt">The master list update options to apply to the discharges.</param>
     /// <param name="unitList">The collection of units whose associated discharges will be updated.</param>
     /// <param name="typeName">The name of the master list type used to target the update.</param>
+    /// <!-- aidoc:v1 sig=b539b7b body=09153b7 -->
     public async Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList,
             string typeName)
     {
@@ -440,6 +462,8 @@ public class DischargeService : IDischargeService
     /// <param name="opt">The option list entry to be removed from the patient master list.</param>
     /// <param name="unitList">The collection of units whose identifiers are used to scope the deletion.</param>
     /// <param name="typeName">The name of the master list type/category to which the option belongs.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary's parenthetical '(only when the updated discharge record is found)' reads as applying to both the audit log creation and the broadcasting, but in the code the audit log is always created for every discharge while only the broadcast is gated by the dischargeUpdated != null check." -->
     public async Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName)
     {
         var unitIds = unitList.Select(x => x.Id).ToList();
@@ -457,6 +481,7 @@ public class DischargeService : IDischargeService
     /// Asynchronously deletes all discharge records associated with the specified unit identifier by delegating the operation to the discharge repository.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose discharge records should be removed.</param>
+    /// <!-- aidoc:v1 sig=0d2c782 body=6f86d40 -->
     public async Task DeleteDischargesByUnitId(ObjectId unitId)
     {
         await _dischargeRepository.DeleteByUnitId(unitId);
@@ -471,6 +496,7 @@ public class DischargeService : IDischargeService
     /// <param name="discharge">Discharge instance whose option names may be translated in place.</param>
     /// <param name="locale">Target locale used to load the appropriate master list; when set to <see cref="LocaleEnum.Default"/>, the discharge is returned without changes.</param>
     /// <returns>The same <paramref name="discharge"/> instance, with translated option names when a matching locale-specific entry is found.</returns>
+    /// <!-- aidoc:v1 sig=f16a2d5 body=4eee788 -->
     private async Task<Discharge> GetDischargeWithLocale(Unit? unit, Discharge discharge, LocaleEnum locale)
     {
         if (unit == null)
diff --git a/adas-core.Application/Services/DisplayConfigService.cs b/adas-core.Application/Services/DisplayConfigService.cs
index 690c78ae..eaec6f6e 100644
--- a/adas-core.Application/Services/DisplayConfigService.cs
+++ b/adas-core.Application/Services/DisplayConfigService.cs
@@ -43,6 +43,7 @@ public class DisplayConfigService(
     /// Configurations for which the minimal display section cannot be resolved are excluded from the result.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of enriched <see cref="DisplayConfig"/> items, omitting any entries that could not be enriched.</returns>
+    /// <!-- aidoc:v1 sig=fb4ed8e body=326606c -->
     public async Task<List<DisplayConfig>> GetAll()
     {
         var result = await displayConfigRepository.GetAll();
@@ -62,6 +63,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number, page size, and any filtering criteria used to retrieve and paginate the display configurations.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{T}"/> with the compact display configurations, current page metadata, and total document count.</returns>
+    /// <!-- aidoc:v1 sig=002d362 body=84e79e3 -->
     public async Task<PaginationResponse<DisplayConfigMinimalResponse>> GetAllCompactPaginated(PaginationFilter filter)
     {
         var result = displayConfigRepository.GetAllPaginated(filter);
@@ -89,6 +91,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="type">The display type used to filter the configurations.</param>
     /// <returns>A list of enriched display configurations; entries whose display section could not be resolved are omitted.</returns>
+    /// <!-- aidoc:v1 sig=8122d6c body=df89bc5 -->
     public async Task<List<DisplayConfig>> GetByType(DisplayConfigEnums.DisplayType type)
     {
         var result = await displayConfigRepository.GetByType(type);
@@ -109,6 +112,7 @@ public class DisplayConfigService(
     /// <param name="id">The unique identifier of the display configuration to retrieve.</param>
     /// <returns>The display configuration with the minimal display section applied.</returns>
     /// <exception cref="NotFoundException">Thrown when no display configuration exists for the specified <paramref name="id"/>.</exception>
+    /// <!-- aidoc:v1 sig=4cfefba body=08ef01d -->
     public async Task<DisplayConfig> GetById(ObjectId id)
     {
         return await AddDisplaySectionMinimal(await displayConfigRepository.GetById(id)) ??
@@ -122,6 +126,7 @@ public class DisplayConfigService(
     /// <param name="unitId">The unit identifier used to look up the default configuration.</param>
     /// <param name="displayType">The display type used to look up the default configuration.</param>
     /// <returns>The current configuration, the default configuration, the merged configuration, or null when neither is available.</returns>
+    /// <!-- aidoc:v1 sig=0ea6132 body=a8d8a9b -->
     public async Task<DisplayConfig?> GetById(ObjectId? configId, ObjectId unitId,
             DisplayConfigEnums.DisplayType displayType)
     {
@@ -160,6 +165,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="config">The display configuration to insert.</param>
     /// <returns>The inserted display configuration, or null if no entity was returned by the repository.</returns>
+    /// <!-- aidoc:v1 sig=819b413 body=1c53329 -->
     public async Task<DisplayConfig?> InsertOne(DisplayConfig config)
     {
         await auditService.CreateAuditLogAsync(httpContextAccessor.HttpContext?.User!, null, config);
@@ -171,6 +177,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="config">The DTO containing the hospital and display type used to build the new configuration entity.</param>
     /// <returns>The inserted <see cref="DisplayConfig"/> entity, or <c>null</c> if the repository did not return a result.</returns>
+    /// <!-- aidoc:v1 sig=cbcb8f5 body=bb5bdb9 -->
     public async Task<DisplayConfig?> InsertOneMinimal(CreateDisplayConfigDto config)
     {
         DisplayConfig newDisplayConfig;
@@ -198,6 +205,7 @@ public class DisplayConfigService(
     /// Inserts test records for the DisplayNurse and SmartDisplay display configuration types into the repository and returns the inserted DisplayNurse record.
     /// </summary>
     /// <returns>The inserted <see cref="DisplayConfig"/> instance of type DisplayNurse.</returns>
+    /// <!-- aidoc:v1 sig=76d5040 body=e85a5cb -->
     public async Task<DisplayConfig> InsertOneTest()
     {
         var d = new DisplayNurse
@@ -220,6 +228,7 @@ public class DisplayConfigService(
     /// <param name="newDisplayConfig">The new configuration payload, deserialized internally into the appropriate DTO based on its <c>Type</c>.</param>
     /// <returns>The updated <see cref="DisplayConfig"/> when the corresponding update succeeds; otherwise the method throws.</returns>
     /// <exception cref="NotFoundException">Thrown when the configuration's <c>Type</c> is not handled, or when the underlying update returns no result.</exception>
+    /// <!-- aidoc:v1 sig=2b3fe79 body=c609b50 -->
     public async Task<DisplayConfig?> UpdateConfig(ObjectId displayConfigId, object newDisplayConfig)
     {
         var baseType = JsonConvert.DeserializeObject<DisplayConfigDto>(newDisplayConfig.ToString()!);
@@ -273,6 +282,7 @@ public class DisplayConfigService(
     /// <param name="objectIdConfigDisplay">The unique identifier of the display configuration whose field list is being updated.</param>
     /// <param name="fields">The collection of fields to be associated with the display configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean value indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=ef23768 body=bc5d2e7 -->
     public Task<bool> UpdateFieldList(ObjectId objectIdConfigDisplay, List<Field> fields)
     {
         return displayConfigRepository.UpdateFieldList(objectIdConfigDisplay, fields);
@@ -285,6 +295,7 @@ public class DisplayConfigService(
     /// <param name="colorConfig">The new color configuration to apply to the display.</param>
     /// <returns>True if the color configuration was updated successfully; otherwise, false.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration identified by <paramref name="objectIdConfigDisplay"/> cannot be found before or after the update.</exception>
+    /// <!-- aidoc:v1 sig=c59a5d8 body=8b0bc38 -->
     public async Task<bool> UpdateConfigColor(ObjectId objectIdConfigDisplay, ColorConfig colorConfig)
     {
         var oldDisplayConfig = await displayConfigRepository.GetById(objectIdConfigDisplay) ??
@@ -311,6 +322,7 @@ public class DisplayConfigService(
     /// <param name="headerConfig">The new header configuration to apply to the display configuration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration is not found before the update, or when the updated display configuration cannot be retrieved afterwards.</exception>
+    /// <!-- aidoc:v1 sig=14b1151 body=bd5d30d -->
     public async Task<bool> UpdateHeaderConfig(ObjectId objectIdConfigDisplay, HeaderConfig headerConfig)
     {
         var oldDisplayConfig = await displayConfigRepository.GetById(objectIdConfigDisplay) ??
@@ -330,6 +342,7 @@ public class DisplayConfigService(
     /// <param name="bannerItems">The list of banner items to set for the home banner.</param>
     /// <returns>A task that resolves to <c>true</c> if the update succeeds; otherwise, <c>false</c>.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration cannot be found before or after the update.</exception>
+    /// <!-- aidoc:v1 sig=cb31e5c body=ded0de7 -->
     public async Task<bool> UpdateSetHomeBanner(ObjectId objectIdConfigDisplay, List<BannerItem> bannerItems)
     {
         var oldDisplayConfig = await displayConfigRepository.GetById(objectIdConfigDisplay) ??
@@ -348,6 +361,7 @@ public class DisplayConfigService(
     /// <param name="baseConfig">The display configuration containing the updated values, identified by its <see cref="DisplayConfig.Id"/>.</param>
     /// <returns>A task that represents the asynchronous operation. The result indicates whether the update was successful.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration with the specified identifier does not exist before or after the update.</exception>
+    /// <!-- aidoc:v1 sig=f59f75b body=9ad2987 -->
     public async Task<bool> UpdateBaseConfig(DisplayConfig baseConfig)
     {
         var oldDisplayConfig = await displayConfigRepository.GetById(baseConfig.Id) ??
@@ -367,6 +381,7 @@ public class DisplayConfigService(
     /// <param name="name">The new hospital name to apply to the display configuration.</param>
     /// <returns>A task that resolves to <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration identified by <paramref name="objectIdConfigDisplay"/> cannot be found before or after the update.</exception>
+    /// <!-- aidoc:v1 sig=d760b75 body=888c314 -->
     public async Task<bool> UpdateDisplayConfigHospitalName(ObjectId objectIdConfigDisplay, string name)
     {
         var oldDisplayConfig = await displayConfigRepository.GetById(objectIdConfigDisplay) ??
@@ -385,6 +400,7 @@ public class DisplayConfigService(
     /// <param name="objectIdConfigDisplay">The identifier of the display configuration to delete.</param>
     /// <returns>A task that resolves to <c>true</c> if the configuration was successfully deleted; otherwise, <c>false</c>.</returns>
     /// <exception cref="ConflictException">Thrown when no default configuration is found for the related display type, or when reassigning a display to the default configuration fails.</exception>
+    /// <!-- aidoc:v1 sig=700a83c body=6b3dfef -->
     public async Task<bool> DeleteDisplayConfig(ObjectId objectIdConfigDisplay)
     {
         var displays = await displayService.Value.GetByConfigId(objectIdConfigDisplay);
@@ -413,6 +429,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="objectIdConfigDisplay">The identifier of the configuration display whose locations are being retrieved.</param>
     /// <returns>A task that returns a list of <see cref="DisplayConfigLocationDto"/> items for the given configuration display.</returns>
+    /// <!-- aidoc:v1 sig=252e572 body=b3e689c -->
     public async Task<List<DisplayConfigLocationDto>> GetDisplayConfigLocations(ObjectId objectIdConfigDisplay)
     {
         return await displayService.Value.GetDisplayConfigLocations(objectIdConfigDisplay);
@@ -422,6 +439,7 @@ public class DisplayConfigService(
     /// Asynchronously retrieves a compact list of all display configurations from the repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="DisplayConfigMinimalResponse"/> objects representing the compact display configuration data.</returns>
+    /// <!-- aidoc:v1 sig=c9c53b0 body=61092a4 -->
     public async Task<List<DisplayConfigMinimalResponse>> GetAllCompact()
     {
         return await displayConfigRepository.GetAllCompact();
@@ -434,6 +452,7 @@ public class DisplayConfigService(
     /// <param name="configType">The display type of the configuration to create; determines which template subtype is expected and produced.</param>
     /// <param name="configHospital">The hospital to associate with the newly created configuration.</param>
     /// <returns>The inserted <see cref="DisplayConfig"/> when the template is found and matches the requested type; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=e4369ae body=d8b0ca1 -->
     public async Task<DisplayConfig?> InsertOneWithTemplate(string objectId,
             DisplayConfigEnums.DisplayType configType, string? configHospital)
     {
@@ -491,6 +510,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="baseConfig">The card configuration to update.</param>
     /// <returns>True if the update was applied (repository reported changes); otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=2fc94b7 body=dc034f3 -->
     public async Task<bool> UpdateCardConfig(CardConfig baseConfig)
     {
         var result = await displayCardConfigRepository.UpdateOne(baseConfig);
@@ -520,6 +540,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="baseConfig">The card detail configuration to update, identified by its <c>Id</c>.</param>
     /// <returns>A task that resolves to <c>true</c> when the update affected one or more records; <c>false</c> when no changes were made.</returns>
+    /// <!-- aidoc:v1 sig=0e8ea62 body=ea85ef1 -->
     public async Task<bool> UpdateDetailConfig(CardDetailsConfig baseConfig)
     {
         var result = await displayDetailConfigRepository.UpdateOne(baseConfig);
@@ -535,6 +556,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="baseConfig">The chart configuration to be updated.</param>
     /// <returns>A task that resolves to <c>true</c> if the update changed at least one record; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=c679975 body=ad4b9cc -->
     public async Task<bool> UpdateChartConfig(ChartConfig baseConfig)
     {
         var result = await displayChartRepository.UpdateOne(baseConfig);
@@ -548,6 +570,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="objectIdConfigDisplay">The object ID of the chart configuration display to delete.</param>
     /// <returns><c>true</c> if the chart configuration was successfully deleted; <c>false</c> if no matching configuration was found.</returns>
+    /// <!-- aidoc:v1 sig=9d99eb7 body=79681f0 -->
     public async Task<bool> DeleteChartConfig(ObjectId objectIdConfigDisplay)
     {
         var res = await displayChartRepository.DeleteOne(objectIdConfigDisplay);
@@ -565,6 +588,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="objectIdConfigChart">The unique identifier of the chart configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ChartConfig"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=7ec5c6d body=0fb37c4 -->
     public async Task<ChartConfig?> GetChartConfig(ObjectId objectIdConfigChart)
     {
         return await displayChartRepository.GetById(objectIdConfigChart);
@@ -575,6 +599,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The DTO containing the detail configuration to insert and, optionally, the ID of the display configuration to associate it with.</param>
     /// <returns>The newly inserted <see cref="CardDetailsConfig"/>, or <c>null</c> when no detail configuration is provided in the DTO.</returns>
+    /// <!-- aidoc:v1 sig=68e8234 body=c2b345a -->
     public async Task<CardDetailsConfig?> InsertCardDetailConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto)
     {
         if (updateDisplayConfigNameDto.DetailConfig == null) return null;
@@ -596,6 +621,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the chart configuration to insert and, optionally, the target display configuration identifier.</param>
     /// <returns>The inserted <see cref="ChartConfig"/>, or <c>null</c> if the supplied chart configuration is <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=416a744 body=c958187 -->
     public async Task<ChartConfig?> InsertChartConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto)
     {
         if (updateDisplayConfigNameDto.ChartConfig == null) return null;
@@ -616,6 +642,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The DTO containing the card configuration to insert and, optionally, the display configuration id to associate it with.</param>
     /// <returns>The inserted <see cref="CardConfig"/>, or <c>null</c> when the provided card configuration is null.</returns>
+    /// <!-- aidoc:v1 sig=148185d body=cda36fc -->
     public async Task<CardConfig?> InsertCardConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto)
     {
         if (updateDisplayConfigNameDto.CardConfig == null) return null;
@@ -635,6 +662,7 @@ public class DisplayConfigService(
     /// Asynchronously retrieves all card configurations from the display card config repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="CardConfig"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=5559d88 body=f0a2a43 -->
     public async Task<List<CardConfig>> GetCardConfigAll()
     {
         return await displayCardConfigRepository.GetAll();
@@ -645,6 +673,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="id">The unique identifier of the card configuration to retrieve.</param>
     /// <returns>The matching <see cref="CardConfig"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=5561120 body=747b0df -->
     public async Task<CardConfig?> GetCardConfigById(ObjectId id)
     {
         return await displayCardConfigRepository.GetById(id);
@@ -656,6 +685,7 @@ public class DisplayConfigService(
     /// </summary>
     /// <param name="type">The display type used to look up the default configuration.</param>
     /// <returns>A <see cref="DisplayConfig"/> representing the default configuration for the specified type, or <see langword="null"/> if no default is found.</returns>
+    /// <!-- aidoc:v1 sig=467920d body=17622e6 -->
     public async Task<DisplayConfig?> GetDefaultConfig(DisplayConfigEnums.DisplayType type)
     {
         return await displayConfigRepository.GetDefault(type);
@@ -668,6 +698,7 @@ public class DisplayConfigService(
     /// <param name="unitId">The identifier of the unit whose default display configuration is being requested.</param>
     /// <param name="displayType">The display type used to filter the default configuration lookup.</param>
     /// <returns>A <see cref="DisplayConfig"/> instance if a default is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=1db1561 body=6a6c951 -->
     private async Task<DisplayConfig?> GetDefaultByUnitIdAndType(ObjectId unitId,
             DisplayConfigEnums.DisplayType displayType)
     {
@@ -682,6 +713,7 @@ public class DisplayConfigService(
     /// <param name="displayConfig">The display configuration to augment with minimal display section data, or <see langword="null"/>.</param>
     /// <returns>The updated <see cref="DisplayConfig"/>, or <see langword="null"/> if the input was <see langword="null"/>.</returns>
     /// <exception cref="NotFoundException">Thrown when the display configuration cannot be found in the repository by its identifier.</exception>
+    /// <!-- aidoc:v1 sig=ddfc93e body=861af41 -->
     private async Task<DisplayConfig?> AddDisplaySectionMinimal(DisplayConfig? displayConfig)
     {
         if (displayConfig == null) return null;
@@ -715,6 +747,7 @@ public class DisplayConfigService(
     /// Updates the chart configuration to mark the specified entry as deleted by delegating to the display configuration repository.
     /// </summary>
     /// <param name="deletedId">The identifier of the chart configuration entry to mark as deleted.</param>
+    /// <!-- aidoc:v1 sig=f32f258 body=1f20989 -->
     private async Task UpdateDeletedChartConfig(ObjectId deletedId)
     {
         await displayConfigRepository.UpdateDeletedChartConfig(deletedId);
@@ -726,6 +759,7 @@ public class DisplayConfigService(
     /// <param name="displayConfigId">The identifier of the display configuration to which the chart ID will be associated. May be null.</param>
     /// <param name="resultId">The identifier of the chart result to add to the display configuration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean indicating whether the chart ID was successfully added.</returns>
+    /// <!-- aidoc:v1 sig=ffcdc08 body=2ef8f3d -->
     private async Task<bool> AddChartId(ObjectId? displayConfigId, ObjectId resultId)
     {
         var result = await displayConfigRepository.AddChartId(displayConfigId, resultId);
@@ -738,6 +772,7 @@ public class DisplayConfigService(
     /// <param name="displayConfigId">The identifier of the display configuration to update, or null to skip.</param>
     /// <param name="resultId">The identifier of the result to associate with the card configuration, or null to skip.</param>
     /// <returns>A task that resolves to true if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=6b4fc3b body=b6c033c -->
     private async Task<bool> UpdateCardConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         var result = await displayConfigRepository.UpdateCardConfigId(displayConfigId, resultId);
@@ -750,6 +785,7 @@ public class DisplayConfigService(
     /// <param name="displayConfigId">The display configuration identifier to associate with the result, or <c>null</c> if not specified.</param>
     /// <param name="resultId">The result identifier whose detail configuration should be updated, or <c>null</c> if not specified.</param>
     /// <returns>A task that resolves to <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e79ee9d body=4def5c3 -->
     private async Task<bool> UpdateDetailConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         var result = await displayConfigRepository.UpdateDetailConfigId(displayConfigId, resultId);
@@ -764,6 +800,7 @@ public class DisplayConfigService(
     /// <param name="displayConfigId">The identifier of the display configuration whose change should be broadcast to related subscribers.</param>
     /// <param name="operationType">The type of operation performed on the configuration (e.g., create, update, delete) to convey to subscribers.</param>
     /// <param name="newDisplayConfig">The new display configuration payload to send to subscribers, or null if not applicable for the operation.</param>
+    /// <!-- aidoc:v1 sig=e43b436 body=ea33ca3 -->
     private async void SendDisplayConfigBroadcast(ObjectId displayConfigId, OperationType operationType,
             object? newDisplayConfig)
     {
@@ -793,6 +830,7 @@ public class DisplayConfigService(
     /// <param name="displayConfigId">The identifier of the display configuration used to look up the associated displays and to broadcast the global update.</param>
     /// <param name="newDisplayConfig">The new SmartDisplay configuration to propagate to subscribers, or null when not available.</param>
     /// <param name="oldDisplayConfig">The previous SmartDisplay configuration used to build the update payload, or null when not available.</param>
+    /// <!-- aidoc:v1 sig=4dce3cf body=6f25e75 -->
     private async void SendSmartDisplayConfigBroadcast(ObjectId displayConfigId, SmartDisplay? newDisplayConfig,
         SmartDisplay? oldDisplayConfig)
     {
@@ -827,6 +865,7 @@ public class DisplayConfigService(
     /// <param name="subscribers">The list of WebSocket subscribers that will receive the display configuration update messages.</param>
     /// <param name="oldDisplayDisplayConfig">The previous smart display configuration, or null if there is no prior configuration to compare against.</param>
     /// <param name="newDisplayDisplayConfig">The new smart display configuration whose values will be sent to subscribers.</param>
+    /// <!-- aidoc:v1 sig=0563a96 body=4372a38 -->
     private void SendSmartDisplayConfigUpdate(List<WsSubscriber> subscribers,
             SmartDisplay? oldDisplayDisplayConfig, SmartDisplay? newDisplayDisplayConfig)
     {
diff --git a/adas-core.Application/Services/DisplayService.cs b/adas-core.Application/Services/DisplayService.cs
index e8a8d111..46fee8dd 100644
--- a/adas-core.Application/Services/DisplayService.cs
+++ b/adas-core.Application/Services/DisplayService.cs
@@ -57,6 +57,7 @@ public class DisplayService(
     /// <param name="display">The display to insert. Its <c>DisplayConfigId</c> is assigned from the resolved default configuration.</param>
     /// <returns>The inserted <see cref="Display"/> with its <c>DisplayConfigId</c> populated.</returns>
     /// <exception cref="NotFoundException">Thrown when no default configuration is found for the specified display type.</exception>
+    /// <!-- aidoc:v1 sig=9e0b693 body=032ec82 -->
     public async Task<Display> InsertOne(Display display)
     {
         var defaultConfig = await displayConfigService.GetDefaultConfig(display.Type) ??
@@ -71,6 +72,7 @@ public class DisplayService(
     /// Inserts a test Display record into the repository and records a corresponding audit log entry using the current HTTP context user.
     /// </summary>
     /// <returns>The newly created <see cref="Display"/> entity.</returns>
+    /// <!-- aidoc:v1 sig=4ec9793 body=0fdb428 -->
     public async Task<Display> InsertOneTest()
     {
         var d = new Display
@@ -92,6 +94,7 @@ public class DisplayService(
     /// Retrieves all displays from the repository and maps them to a compact representation.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="DisplayMinimalDto"/> with the mapped display data.</returns>
+    /// <!-- aidoc:v1 sig=d065c6f body=4d0461d -->
     public async Task<List<DisplayMinimalDto>> GetAllCompact()
     {
         var result = await displayRepository.GetAll();
@@ -106,6 +109,7 @@ public class DisplayService(
     /// <param name="userName">The user name used to filter the display items, or <see langword="null"/> to retrieve all items.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Display"/> items.</returns>
     /// <exception cref="NotImplementedException">The method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=7a39576 body=bfa6f2f -->
     public Task<List<Display>> GetAll(string? userName)
     {
         throw new NotImplementedException();
@@ -116,6 +120,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to determine the slice of results to return.</param>
     /// <returns>A <see cref="Task{PaginationResponse{Display}}"/> containing the requested page of displays, the current page number, the page size, and the total number of documents.</returns>
+    /// <!-- aidoc:v1 sig=5ace491 body=5778d73 -->
     public async Task<PaginationResponse<Display>> GetPaginatedDisplays(PaginationFilter filter)
     {
         var result = displayRepository.GetPaginatedDisplays(filter);
@@ -138,6 +143,7 @@ public class DisplayService(
     /// <param name="userName">The username whose displays should be retrieved; when null, the method returns an empty list.</param>
     /// <returns>A task that yields a list of <see cref="DisplayWithPermissionsDto"/> containing the displays the user can access along with their permissions.</returns>
     /// <exception cref="ForbbidenException">Thrown when permissions for a unit-scoped display cannot be obtained for the user.</exception>
+    /// <!-- aidoc:v1 sig=3460ae9 body=04cbe7e -->
     public async Task<List<DisplayWithPermissionsDto>> GetAllByUser(string? userName)
     {
         var start = DateTime.Now;
@@ -208,6 +214,7 @@ public class DisplayService(
     /// <param name="displayId">The identifier of the display to look up, compared as a string.</param>
     /// <param name="perms">The collection of display-with-permissions entries to search through.</param>
     /// <returns><c>true</c> if a non-null display with a matching identifier is found; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=3e72746 body=367999b -->
     private static bool FindDisplayInPerms(string displayId, List<DisplayWithPermissionsDto> perms)
     {
         return perms.Any(p => p.Display != null && p.Display.Id.ToString() == displayId);
@@ -219,6 +226,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="type">The display type used to filter the display configurations.</param>
     /// <returns>A list of displays matching the specified type, each with its related configuration assigned; an empty list is returned when no displays are found.</returns>
+    /// <!-- aidoc:v1 sig=37f36bb body=aac9b72 -->
     public async Task<List<Display>> GetByType(DisplayConfigEnums.DisplayType type)
     {
         var configs = await displayConfigService.GetByType(type);
@@ -238,6 +246,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="pointOfCare">The point of care used to filter the displays.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the list of displays matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=ad8af85 body=9447333 -->
     public async Task<List<Display>> GetByPointOfCare(PointOfCare pointOfCare)
     {
         return await displayRepository.GetByPointOfCare(pointOfCare);
@@ -248,6 +257,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="configId">The configuration identifier used to look up the associated displays.</param>
     /// <returns>A task that returns the list of <see cref="Display"/> objects matching the given configuration identifier.</returns>
+    /// <!-- aidoc:v1 sig=1ceff79 body=c343dde -->
     public Task<List<Display>> GetByConfigId(ObjectId configId)
     {
         return displayRepository.GetByConfigId(configId);
@@ -258,6 +268,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="configId">The unique identifier of the card configuration used to look up the associated displays.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Display"/> objects matching the provided card configuration identifier.</returns>
+    /// <!-- aidoc:v1 sig=c38a1bb body=4696c61 -->
     public Task<List<Display>> GetByCardConfigId(ObjectId configId)
     {
         return displayRepository.GetByCardConfigId(configId);
@@ -269,6 +280,7 @@ public class DisplayService(
     /// <param name="name">The name of the display to look up.</param>
     /// <returns>The <see cref="Display"/> that matches the specified name.</returns>
     /// <exception cref="NotFoundException">Thrown when no display is found for the given name.</exception>
+    /// <!-- aidoc:v1 sig=58df1bb body=33a5e00 -->
     public async Task<Display?> GetByName(string name)
     {
         return await displayRepository.GetByName(name) ??
@@ -280,6 +292,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="id">The unique identifier of the display to retrieve.</param>
     /// <returns>The matching <see cref="Display"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=06fe2a7 body=bf712b4 -->
     public async Task<Display?> GetById(ObjectId id)
     {
         return await displayRepository.GetById(id);
@@ -292,6 +305,7 @@ public class DisplayService(
     /// <param name="localeEnum">The locale used to localize the related point-of-care information.</param>
     /// <returns>A <see cref="DisplayWithPermissionsDto"/> containing the display and its associated permissions.</returns>
     /// <exception cref="NotFoundException">Thrown when the current user cannot be identified from the JWT or when no display is found for the specified <paramref name="id"/>.</exception>
+    /// <!-- aidoc:v1 sig=4aa342c body=756b4f9 -->
     public async Task<DisplayWithPermissionsDto> GetByIdWithPermissions(ObjectId id, LocaleEnum localeEnum)
     {
         var username = JwtHelper.GetUsernameFromPrincipal(httpContextAccessor.HttpContext?.User!) ??
@@ -333,6 +347,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose displays should be counted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the total number of displays for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=db66b12 body=1dd1fbe -->
     public async Task<long> CountDisplaysByUnitId(ObjectId unitId)
     {
         return await displayRepository.CountByUnitId(unitId);
@@ -353,6 +368,7 @@ public class DisplayService(
     /// <param name="fillDisplayConfig">If true, retrieves the full display including its configuration (cached); otherwise retrieves the base display.</param>
     /// <param name="ct">Cancellation token to cancel the operation.</param>
     /// <returns>The requested <see cref="Display"/>, or <c>null</c> if no display is found for the given id.</returns>
+    /// <!-- aidoc:v1 sig=7a4d82f body=f266015 -->
     public async Task<Display?> GetInfo(ObjectId id,
         string? userName,
         List<Authorization>? authorizations,
@@ -429,6 +445,8 @@ public class DisplayService(
     /// <param name="id">The identifier of the display to load.</param>
     /// <param name="ct">The cancellation token used to cancel the asynchronous operation.</param>
     /// <returns>The <see cref="Display"/> with its configuration populated, or <c>null</c> if no display exists for the given <paramref name="id"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The ct parameter is documented as 'used to cancel the asynchronous operation', but the method never passes ct to displayRepository.GetById, displayConfigService.GetById, or displayConfigService.GetCardConfigById, so the token has no effect on cancellation." -->
     private async Task<Display?> BuildDisplayWithConfig(ObjectId id, CancellationToken ct)
     {
         var display = await displayRepository.GetById(id);
@@ -465,6 +483,7 @@ public class DisplayService(
     /// <param name="userName">The username used to look up the user and their authorities; if null, an empty list is returned.</param>
     /// <param name="authorizations">Optional pre-fetched list of user authorities; when null, authorities are retrieved from the authority service.</param>
     /// <returns>A task that resolves to a list of <see cref="MinimalDisplaySection"/> items accessible to the user and matching the specified display type.</returns>
+    /// <!-- aidoc:v1 sig=64d7b66 body=cc129cf -->
     public async Task<List<MinimalDisplaySection>> GetDisplaySectionByUser(
             DisplayConfigEnums.DisplayType type,
             ObjectId? currentDisplay,
@@ -539,6 +558,7 @@ public class DisplayService(
     /// Asynchronously retrieves all display configurations of type DisplayNurse and SmartDisplay, mapping them into minimal display sections and grouping them within a display list DTO.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a MinimalDisplayListDto with the populated DisplayNurse and SmartDisplay collections.</returns>
+    /// <!-- aidoc:v1 sig=208d6c6 body=b473ad8 -->
     public async Task<MinimalDisplayListDto> GetAllDisplaySection()
     {
         var minimalDisplayListDto = new MinimalDisplayListDto();
@@ -572,6 +592,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose displays should be returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Display"/> objects for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=61f7d68 body=08a2310 -->
     public async Task<List<Display>> GetByUnitId(ObjectId unitId)
     {
         return await displayRepository.GetByUnitId(unitId);
@@ -584,6 +605,8 @@ public class DisplayService(
     /// <param name="excludeVirtual">When set to <c>true</c>, virtual points of care are excluded from the result; otherwise, they are included.</param>
     /// <returns>A <see cref="PocAndUnitDto"/> containing the available points of care and their associated unit details.</returns>
     /// <exception cref="NotFoundException">Thrown when a unit associated with one of the resolved display identifiers cannot be found.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "NotFoundException is thrown inside the try block but immediately caught by the generic catch(Exception) handler, which logs the error and returns an empty PocAndUnitDto. The exception never propagates to the caller, so documenting it as thrown is misleading." -->
     public async Task<PocAndUnitDto> GetAllAvailablePoc(List<string> displayIds, bool excludeVirtual = false)
     {
         try
@@ -635,6 +658,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="id">The ObjectId of the display whose points of care should be retrieved.</param>
     /// <returns>A list of points of care linked to the display, or an empty list if the display cannot be found or if an error is encountered.</returns>
+    /// <!-- aidoc:v1 sig=9215df7 body=d5eaca6 -->
     public async Task<List<PointOfCare>> GetAllPocsByDisplayId(ObjectId id)
     {
         try
@@ -664,6 +688,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="displayConfigId">The identifier of the display configuration whose locations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="DisplayConfigLocationDto"/> objects with display and unit information.</returns>
+    /// <!-- aidoc:v1 sig=0895dcd body=e5b010a -->
     public async Task<List<DisplayConfigLocationDto>> GetDisplayConfigLocations(ObjectId displayConfigId)
     {
         var displays = await GetByConfigId(displayConfigId);
@@ -687,6 +712,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="displayConfigId">The unique identifier of the display configuration to check.</param>
     /// <returns><c>true</c> if the display configuration is referenced by at least one entity; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=685c5f5 body=f4b630c -->
     public async Task<bool> IsDisplayConfigInUse(ObjectId displayConfigId)
     {
         return await displayRepository.IsDisplayConfigInUse(displayConfigId) > 0;
@@ -708,6 +734,7 @@ public class DisplayService(
     /// <returns>The updated <see cref="Display"/> instance after the point of care list change.</returns>
     /// <exception cref="NotFoundException">Thrown when no display exists for the specified <paramref name="objectId"/>.</exception>
     /// <exception cref="ConflictException">Thrown when the point of care list update cannot be persisted.</exception>
+    /// <!-- aidoc:v1 sig=68b108f body=41d1e6a -->
     public async Task<Display?> UpdatePointOfCareList(ObjectId objectId, List<ObjectId> listPocObId)
     {
         var oldDisplay = await displayRepository.GetById(objectId) ??
@@ -729,6 +756,10 @@ public class DisplayService(
     /// <param name="oldDisplay">The existing display whose configuration will be updated.</param>
     /// <param name="newDisplayConfig">The new configuration to apply, or <c>null</c> if no update is provided.</param>
     /// <returns>The updated <see cref="Display"/> if the configuration was successfully applied; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method returns null 'if the provided configuration type is not supported,' but newDisplayConfigCast is initialized to a non-null default and the code proceeds to the repository call for any non-null cast result, including unsupported types." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary groups broadcast, audit log creation, and cache invalidation together as happening 'on a successful update,' but cache invalidation occurs whenever a valid config type is provided, even if the repository update returns null." -->
     public async Task<Display?> UpdateConfig(Display oldDisplay, DisplayConfig? newDisplayConfig)
     {
         var newDisplayConfigCast = new DisplayConfig();
@@ -766,6 +797,7 @@ public class DisplayService(
     /// <param name="oldDisplay">The display whose configuration ID is being updated.</param>
     /// <param name="configId">The new configuration ID to assign to the display.</param>
     /// <returns>The updated display, or <c>null</c> if the display was not found.</returns>
+    /// <!-- aidoc:v1 sig=a4c5a08 body=1c84331 -->
     public async Task<Display?> UpdateConfigId(Display oldDisplay, ObjectId configId)
     {
         var displayToReturn = await displayRepository.UpdateConfigId(oldDisplay.Id, configId);
@@ -787,6 +819,8 @@ public class DisplayService(
     /// <returns>The updated <see cref="Display"/> entity, or <c>null</c> if the update could not be completed.</returns>
     /// <exception cref="NotFoundException">Thrown when the update result or the resolved configuration is <c>null</c>.</exception>
     /// <exception cref="InvalidFormatException">Thrown when the configuration type is not one of the handled display types.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "Documentation states the method returns 'null if the update could not be completed', but the code throws NotFoundException when result is null, never actually returning null to the caller." -->
     public async Task<Display?> UpdateConfigPreset(ObjectId objectIdDisplay, ObjectId objectIdConfigDisplay)
     {
         var oldConfig = await displayConfigService.GetById(objectIdConfigDisplay);
@@ -824,6 +858,7 @@ public class DisplayService(
     /// <param name="name">The new name to assign to the display.</param>
     /// <returns>The updated <see cref="Display"/> instance, or <c>null</c> if the update could not be performed.</returns>
     /// <exception cref="NotFoundException">Thrown when no display is found for the specified <paramref name="id"/>.</exception>
+    /// <!-- aidoc:v1 sig=18e4a50 body=b0ad3f7 -->
     public async Task<Display?> UpdateName(ObjectId id, string name)
     {
         var display = await displayRepository.GetById(id) ??
@@ -846,6 +881,7 @@ public class DisplayService(
     /// <param name="id">The unique identifier of the display to delete.</param>
     /// <returns>A task that resolves to <c>true</c> when the display has been successfully deleted.</returns>
     /// <exception cref="NotFoundException">Thrown when no display is found for the specified <paramref name="id"/>.</exception>
+    /// <!-- aidoc:v1 sig=328e872 body=46f2b0a -->
     public async Task<bool> DeleteDisplay(ObjectId id)
     {
         var display = await displayRepository.GetById(id) ??
@@ -865,6 +901,7 @@ public class DisplayService(
     /// Deletes all displays associated with the specified unit identifier, invalidates the displays cache, and removes related authority data for the unit.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose displays and related authority data will be removed.</param>
+    /// <!-- aidoc:v1 sig=bd663aa body=28edafe -->
     public async Task DeleteDisplaysByUnitId(ObjectId unitId)
     {
         await displayRepository.DeleteManyByUnitId(unitId);
@@ -883,6 +920,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="subscribers">The list of WebSocket subscribers that will receive the smart display configuration update.</param>
     /// <param name="config">The smart display configuration to broadcast. May be <c>null</c> if no configuration is provided.</param>
+    /// <!-- aidoc:v1 sig=57faa95 body=71328cd -->
     private void SendSmartDisplayBroadcast(List<WsSubscriber> subscribers, SmartDisplay? config)
     {
         foreach (var subscriber in subscribers)
@@ -894,6 +932,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="subscribers">The list of WebSocket subscribers that will receive the nurse display configuration update.</param>
     /// <param name="config">The nurse display configuration to broadcast, which may be <c>null</c>.</param>
+    /// <!-- aidoc:v1 sig=6730073 body=809b5d8 -->
     private void SendNurseDisplayBroadcast(List<WsSubscriber> subscribers, DisplayNurse? config)
     {
         foreach (var subscriber in subscribers)
@@ -906,6 +945,7 @@ public class DisplayService(
     /// </summary>
     /// <param name="display">The display whose subscribers will receive the broadcast; used to filter the subscriber list by its identifier.</param>
     /// <param name="operation">The type of operation being broadcast, which determines the action taken on matching subscribers.</param>
+    /// <!-- aidoc:v1 sig=30dad01 body=bbd0711 -->
     private void SendDisplayBroadcast(Display display, OperationType operation)
     {
         var subscribers = subscribersService.GetSubscribers().Where(s =>
diff --git a/adas-core.Application/Services/FileService.cs b/adas-core.Application/Services/FileService.cs
index 1b27430e..e698db77 100644
--- a/adas-core.Application/Services/FileService.cs
+++ b/adas-core.Application/Services/FileService.cs
@@ -14,6 +14,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Provides a concrete implementation of the <see cref="IFileService"/> contract for performing file-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=52eb70b -->
 public class FileService : IFileService
 {
     private readonly string? _assetsDirectory;
@@ -47,6 +48,7 @@ public class FileService : IFileService
     /// </summary>
     /// <param name="files">The collection of uploaded form files to be written to the update directory.</param>
     /// <returns>A task that resolves to true when every file is successfully copied, or false when the update directory is not configured.</returns>
+    /// <!-- aidoc:v1 sig=8b3261f body=f4c95cd -->
     public async Task<bool> CopyUpdateFiles(ICollection<IFormFile> files)
     {
         if (string.IsNullOrWhiteSpace(_updateDirectory)) return false;
@@ -66,6 +68,7 @@ public class FileService : IFileService
     /// <param name="files">The collection of uploaded form files to persist to the assets directory.</param>
     /// <param name="themeParse">The asset theme used to determine the subdirectory in which the files will be stored.</param>
     /// <returns>A task that resolves to <c>true</c> when the files are successfully written, or <c>false</c> when the assets directory path is not configured.</returns>
+    /// <!-- aidoc:v1 sig=6ee9410 body=8680e5a -->
     public async Task<bool> UploadAssetFiles(ICollection<IFormFile> files, FileEnum.AssetTheme themeParse)
     {
         if (string.IsNullOrWhiteSpace(_assetsDirectory)) return false;
@@ -87,6 +90,7 @@ public class FileService : IFileService
     /// </summary>
     /// <param name="themeParse">The theme used to locate the corresponding subdirectory within the assets directory.</param>
     /// <returns>A list of <see cref="AssetDto"/> objects containing the name, extension, and full path of each file found; an empty list if the assets directory is not configured or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=0de5997 body=8f16929 -->
     public List<AssetDto> GetAllAssetFile(FileEnum.AssetTheme themeParse)
     {
         try
@@ -125,6 +129,7 @@ public class FileService : IFileService
     /// </summary>
     /// <param name="directoryPath">The path of the directory to search for files.</param>
     /// <returns>A list of file paths found in the directory, or an empty list if the directory does not exist or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=c3be2b5 body=d2272c4 -->
     public List<string> GetFilesInDirectory(string directoryPath)
     {
         List<string> fileList = [];
diff --git a/adas-core.Application/Services/GroupedObservationService.cs b/adas-core.Application/Services/GroupedObservationService.cs
index 2c07937d..f8a635d5 100644
--- a/adas-core.Application/Services/GroupedObservationService.cs
+++ b/adas-core.Application/Services/GroupedObservationService.cs
@@ -17,6 +17,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Provides a concrete implementation of <see cref="IGroupedObservationService"/> for managing and exposing grouped observation data.
 /// </summary>
+/// <!-- aidoc:v1 sig=d252f21 -->
 public class GroupedObservationService : IGroupedObservationService
 {
     private readonly CacheSettings? _cacheSettings;
@@ -61,6 +62,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="cacheIsChecked">When <c>true</c>, the cache is bypassed and observations are always recomputed; when <c>false</c>, results are obtained through the cache with the configured TTL.</param>
     /// <param name="ct">Token used to cancel the asynchronous operation.</param>
     /// <returns>A <see cref="Task{GroupedObservation}"/> containing the patient id, group, name, and the list of computed <see cref="GroupedObservationObs"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=17d649b body=5ba5a2e -->
     public async Task<GroupedObservation> GenerateGroupedObservation(
         ObjectId patientId,
         GroupedField groupedField,
@@ -357,6 +359,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="obs">The new patient observation to be incorporated into the grouped observation.</param>
     /// <param name="timeZoneId">The time zone identifier used when a full recalculation is required. Defaults to "Romance Standard Time".</param>
     /// <returns>A task that resolves to the generated <see cref="GroupedObservation"/> for the patient, either from an incrementally updated cache entry or from a full recalculation.</returns>
+    /// <!-- aidoc:v1 sig=63421dc body=6b8c46b -->
     public async Task<GroupedObservation> GenerateGroupedObservation(
             ObjectId patientId,
             GroupedField groupedField,
@@ -408,6 +411,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="num">The maximum number of recent observations to return. Defaults to 2.</param>
     /// <param name="filterObservations">An optional list of observation identifiers used to restrict the result set. When null, no filtering is applied.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservation"/> entries representing the patient's most recent observations.</returns>
+    /// <!-- aidoc:v1 sig=6f6283b body=92c1221 -->
     public async Task<List<PatientObservation>> FindLastObservations(ObjectId patientId, int num = 2,
             List<string>? filterObservations = null)
     {
@@ -420,6 +424,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// </summary>
     /// <param name="ws">The grouped subscriber context that supplies the group, names, regularity, max window, and cache key used to derive the next observations.</param>
     /// <returns>A <see cref="GroupedObservation"/> containing the resulting observations adjusted to the configured time window based on <see cref="GroupedObservationEnum.Regularity"/> (Minute, Second, or default hour-based).</returns>
+    /// <!-- aidoc:v1 sig=b957e8f body=3a63489 -->
     public async Task<GroupedObservation> CreateNextEmptyObs(WsSubscriberGrouped ws)
     {
         var gf = new GroupedField
@@ -525,6 +530,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="result">The existing grouped observation documents to be completed with missing intervals.</param>
     /// <param name="groupedField">The grouping configuration that defines the names, maximum number of intervals, regularity and result types to use when generating the placeholders.</param>
     /// <returns>A list of <see cref="BsonDocument"/> entries ordered by time, containing the original data and any added zero-valued filler entries for missing intervals.</returns>
+    /// <!-- aidoc:v1 sig=b15a145 body=b74a0fe -->
     public List<BsonDocument> FillHours(List<BsonDocument> result, GroupedField groupedField)
     {
         var now = DateTime.UtcNow;
@@ -725,6 +731,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="groupedField">The grouped field containing either a list of names to iterate over or a single name used as fallback when the list is empty.</param>
     /// <param name="patientId">The identifier of the patient whose observations are being calculated.</param>
     /// <returns>A task that returns a list of BsonDocument containing the calculated last filled observations.</returns>
+    /// <!-- aidoc:v1 sig=685bef7 body=8a6adf3 -->
     public async Task<List<BsonDocument>> CalculateLastFilledObservations(List<BsonDocument> result,
             GroupedField groupedField, ObjectId patientId)
     {
@@ -751,6 +758,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="patientId">The patient identifier used to query the last observation before the earliest expected date.</param>
     /// <param name="name">The name assigned to the generated BsonDocument <c>_id</c> entries.</param>
     /// <returns>The result list with missing time-slot entries filled using the last-filled value, ordered by time.</returns>
+    /// <!-- aidoc:v1 sig=3627386 body=09800ac -->
     private async Task<List<BsonDocument>> LastFilledCalc(List<BsonDocument> result, GroupedField groupedField,
             ObjectId patientId, string? name)
     {
@@ -875,6 +883,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="shiftGroupObservations">The list of shift observations to be aggregated.</param>
     /// <param name="groupedField">The grouped field configuration whose Result property determines whether a Sum aggregation is applied.</param>
     /// <returns>A list of <see cref="BsonDocument"/> containing the aggregated shift observations, or the original list when no Sum operation is required.</returns>
+    /// <!-- aidoc:v1 sig=37e3bfd body=e1601ec -->
     public List<BsonDocument> CalculateShiftObservations(List<BsonDocument> shiftGroupObservations,
             GroupedField groupedField)
     {
@@ -923,6 +932,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// grouped into half-hour intervals and enriched with a "halfhour" field in place.</param>
     /// <returns>The same <see cref="List{BsonDocument}"/> instance with the "halfhour" field populated
     /// according to the half-hour grouping rules.</returns>
+    /// <!-- aidoc:v1 sig=9daf918 body=efd69f0 -->
     public List<BsonDocument> CalculateHalfHourObservations(List<BsonDocument> result)
     {
         //HalfHour añadir que se rellenen las horas que no existen
@@ -1000,6 +1010,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="result">The list of aggregated BsonDocuments to enrich; each document is modified in place to include the day and shift elements.</param>
     /// <param name="groupedField">The grouping configuration providing the ordered list of shift start times used to determine the assigned shift.</param>
     /// <returns>The same <paramref name="result"/> list with day and shift elements added to each successfully processed document.</returns>
+    /// <!-- aidoc:v1 sig=f6df652 body=c517b3e -->
     public List<BsonDocument> GenerateShiftObservations(List<BsonDocument> result, GroupedField groupedField)
     {
         result.ForEach(item =>
@@ -1095,6 +1106,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="obs">The patient observation to match against or insert into the group.</param>
     /// <param name="groupedField">The grouped field providing the regularity, result aggregation types, maximum retention count, and shift configuration.</param>
     /// <returns>The updated list of grouped observations, limited to entries whose time is within the allowed date range.</returns>
+    /// <!-- aidoc:v1 sig=cca5083 body=147be01 -->
     private List<GroupedObservationObs> LocateCurrentObsInGroup(List<GroupedObservationObs> group,
             PatientObservation obs, GroupedField groupedField)
     {
@@ -1241,6 +1253,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="currentObsDate">The observation date whose time of day is evaluated against the configured shifts.</param>
     /// <param name="groupedFieldStartTimeShift">The list of shift start time strings used to build the shift intervals; must contain at least one entry to produce a result.</param>
     /// <returns>The zero-based index of the matching shift, -1 if no shift matches, or null if <paramref name="groupedFieldStartTimeShift"/> is empty.</returns>
+    /// <!-- aidoc:v1 sig=d71f06d body=ef631e3 -->
     private int? GetShift(DateTime currentObsDate, List<string> groupedFieldStartTimeShift)
     {
         if (groupedFieldStartTimeShift.Count == 0) return null;
@@ -1264,6 +1277,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// </summary>
     /// <param name="groupedFieldStartTimeShift">A list of time span string representations to be parsed and adjusted.</param>
     /// <returns>A list of TimeSpan values where each entry is the original time plus one minute, or the subsequent time span if adding one minute would exceed it.</returns>
+    /// <!-- aidoc:v1 sig=1b7da10 body=741054c -->
     private List<TimeSpan> GetTimeSpan(List<string> groupedFieldStartTimeShift)
     {
         List<TimeSpan> timeSpans = [];
@@ -1294,6 +1308,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="min">The optional minimum bound used in the status evaluation.</param>
     /// <param name="max">The optional maximum bound used in the status evaluation.</param>
     /// <returns>A task that resolves to the <see cref="StatusEnum.Type"/> representing the status of the grouped observation.</returns>
+    /// <!-- aidoc:v1 sig=8c95413 body=a79f912 -->
     private async Task<StatusEnum.Type> GroupedObservationStatus(GroupedField groupedField,
             GroupedObservationEnum.Result result, string name, object value, double? min, double? max)
     {
@@ -1306,6 +1321,7 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="obs">The grouped observation containing the timestamp of the last recorded observation.</param>
     /// <param name="gf">The grouped field whose regularity (second, minute, hour, or day) defines the time unit used in the calculation.</param>
     /// <returns>A tuple containing the number of times left to create an empty observation (the ceiling of the elapsed time in the selected unit) and the multiplier factor associated with the regularity unit.</returns>
+    /// <!-- aidoc:v1 sig=dcb9cc9 body=13579ae -->
     private (int timesLeft, int multiplierFactor) TimesLeftToCreateEmptyObs(GroupedObservationObs obs, GroupedField gf)
     {
         var currentDateTime = DateTime.Now;
@@ -1346,6 +1362,8 @@ public class GroupedObservationService : IGroupedObservationService
     /// <param name="gf">The grouped field providing the list of result property names to copy and the regularity used to determine shift handling.</param>
     /// <param name="seconsToAdd">The number of seconds to add to the source observation's time for the new observation.</param>
     /// <returns>A new <see cref="GroupedObservationObs"/> populated with values derived from <paramref name="sourceObs"/>; when the regularity is <see cref="GroupedObservationEnum.Regularity.Shift"/>, the shift date and shift are also assigned.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> description states the new observation is 'populated with values derived from sourceObs', but the code sets each property in gf.Result to a defaultValue of (0, sourceObs.Time) and never copies the actual values from sourceObs. The retrieved sourceObs value is only used to mutate sourceObs (resetting its inner Time), not to populate lastObs." -->
     private GroupedObservationObs CreateNextObs(GroupedObservationObs sourceObs, GroupedField gf, int seconsToAdd)
     {
         var lastObs = new GroupedObservationObs
diff --git a/adas-core.Application/Services/HistoricalConfigChangesService.cs b/adas-core.Application/Services/HistoricalConfigChangesService.cs
index 167a8492..6c6b1f65 100644
--- a/adas-core.Application/Services/HistoricalConfigChangesService.cs
+++ b/adas-core.Application/Services/HistoricalConfigChangesService.cs
@@ -30,6 +30,7 @@ public class HistoricalConfigChangesService(
     /// Deletes a historical configuration change record by its identifier and creates an audit log entry recording the deletion.
     /// </summary>
     /// <param name="id">The unique identifier of the historical configuration change to delete.</param>
+    /// <!-- aidoc:v1 sig=86555ed body=001920f -->
     public async Task DeleteHistoricalConfigChange(ObjectId id)
     {
         var filter = Builders<HistoricalConfigChanges>.Filter.Eq("_id", id);
@@ -44,6 +45,7 @@ public class HistoricalConfigChangesService(
     /// </summary>
     /// <param name="configType">The configuration type used to look up the last historical change.</param>
     /// <returns>The most recent <see cref="HistoricalConfigChanges"/> entry, or <c>null</c> if no changes exist for the given type.</returns>
+    /// <!-- aidoc:v1 sig=c35ac55 body=bbcde5b -->
     public async Task<HistoricalConfigChanges?> FindLastConfigChanges(DisplayConfigEnums.ConfigTypes configType)
     {
         var result = await historicalConfigChangesRepository.FindLastHistoricalConfigChangesByType(configType);
@@ -57,6 +59,7 @@ public class HistoricalConfigChangesService(
     /// </summary>
     /// <param name="id">The unique identifier of the historical configuration change to retrieve.</param>
     /// <returns>The matching <see cref="HistoricalConfigChanges"/> record, or null if no record is found.</returns>
+    /// <!-- aidoc:v1 sig=7f8de28 body=46df3de -->
     public async Task<HistoricalConfigChanges?> Get(ObjectId id)
     {
         return await historicalConfigChangesRepository.FindById(id);
@@ -66,6 +69,7 @@ public class HistoricalConfigChangesService(
     /// Retrieves all historical configuration changes from the repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a collection of all <see cref="HistoricalConfigChanges"/> records.</returns>
+    /// <!-- aidoc:v1 sig=f0919e8 body=6a8aec9 -->
     public async Task<ICollection<HistoricalConfigChanges>> GetAll()
     {
         return await historicalConfigChangesRepository.FindAll();
@@ -77,6 +81,7 @@ public class HistoricalConfigChangesService(
     /// <param name="type">The configuration type used to filter the historical changes.</param>
     /// <param name="num">The maximum number of recent changes to return. Defaults to 10.</param>
     /// <returns>A collection of the latest <see cref="HistoricalConfigChanges"/> entries matching the specified type.</returns>
+    /// <!-- aidoc:v1 sig=eb58afd body=9a8ae02 -->
     public async Task<ICollection<HistoricalConfigChanges>> GetByType(DisplayConfigEnums.ConfigTypes type, int num = 10)
     {
         return await historicalConfigChangesRepository.FindLastHistoricalConfigChangesByType(type, num);
@@ -90,6 +95,7 @@ public class HistoricalConfigChangesService(
     /// <param name="configTypes">Optional filter for the configuration type; when null, all configuration types are included.</param>
     /// <param name="num">The maximum number of historical change entries to return. Defaults to 10.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of the user's historical configuration changes.</returns>
+    /// <!-- aidoc:v1 sig=a9c5b43 body=8f686c3 -->
     public async Task<ICollection<HistoricalConfigChanges>> GetByUser(string user,
             DisplayConfigEnums.ConfigTypes? configTypes = null, int num = 10)
     {
@@ -103,6 +109,7 @@ public class HistoricalConfigChangesService(
     /// <param name="historicalConfigChanges">The historical configuration change entity to insert.</param>
     /// <returns>The inserted <see cref="HistoricalConfigChanges"/> entity, or null if the operation fails.</returns>
     /// <exception cref="ConflictException">Thrown when the repository returns null after the insert operation.</exception>
+    /// <!-- aidoc:v1 sig=06deefb body=1a2682f -->
     public async Task<HistoricalConfigChanges?> InsertOne(HistoricalConfigChanges historicalConfigChanges)
     {
         try
@@ -127,6 +134,10 @@ public class HistoricalConfigChangesService(
     /// <param name="historicalConfigChanges">The historical configuration change entity containing the updated values to persist.</param>
     /// <returns>The updated <see cref="HistoricalConfigChanges"/> entity on success, or <c>null</c> if an error occurs during the operation.</returns>
     /// <exception cref="ConflictException">Thrown when no existing historical configuration change is found with the specified <c>Id</c>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "ConflictException is thrown inside the try block but immediately caught by the outer catch (Exception ex), which logs and returns null. The exception never propagates to callers, so documenting it as thrown is misleading." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states 'If the record is not found, a ConflictException is thrown', but in practice the throw is swallowed by the catch block and the method returns null with a logged error." -->
     public async Task<HistoricalConfigChanges?> UpdateHistoricalConfigChange(
             HistoricalConfigChanges historicalConfigChanges)
     {
@@ -155,6 +166,7 @@ public class HistoricalConfigChangesService(
     /// <param name="configType">The type of configuration that was changed.</param>
     /// <param name="newConfig">The new configuration value after the change.</param>
     /// <param name="oldConfig">The previous configuration value before the change.</param>
+    /// <!-- aidoc:v1 sig=dd55e13 body=56cb363 -->
     public async Task LogConfigChanged(string user, DisplayConfigEnums.ConfigTypes configType, string newConfig,
             string oldConfig)
     {
diff --git a/adas-core.Application/Services/Interfaces/IAPIRequestService.cs b/adas-core.Application/Services/Interfaces/IAPIRequestService.cs
index 488275a6..f677c706 100644
--- a/adas-core.Application/Services/Interfaces/IAPIRequestService.cs
+++ b/adas-core.Application/Services/Interfaces/IAPIRequestService.cs
@@ -8,10 +8,12 @@ public interface IApiRequestService
     /// Asynchronously persists the specified <see cref="ApiRequest"/>.
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
+    /// <!-- aidoc:v1 sig=24f178e -->
     Task SaveRequestAsync(ApiRequest apiRequest);
     /// <summary>
     /// Asynchronously saves the specified API request.
     /// </summary>
     /// <param name="apiRequest">The API request to persist.</param>
+    /// <!-- aidoc:v1 sig=274a023 -->
     Task SaveRequest(ApiRequest apiRequest);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IAdminPanelService.cs b/adas-core.Application/Services/Interfaces/IAdminPanelService.cs
index d68abdd5..cdc8e34c 100644
--- a/adas-core.Application/Services/Interfaces/IAdminPanelService.cs
+++ b/adas-core.Application/Services/Interfaces/IAdminPanelService.cs
@@ -13,12 +13,14 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit to delete.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the unit was successfully deleted; otherwise, <c>false</c> if the unit was not found.</returns>
+    /// <!-- aidoc:v1 sig=3dcac9a -->
     Task<bool> DeleteUnitById(ObjectId unitId);
     /// <summary>
     /// Inserts a new <see cref="Unit"/> into the data store and returns the inserted entity.
     /// </summary>
     /// <param name="unit">The <see cref="Unit"/> to insert.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the inserted <see cref="Unit"/>, or <see langword="null"/> if the insert could not be completed.</returns>
+    /// <!-- aidoc:v1 sig=9d5e322 -->
     Task<Unit?> InsertUnit(Unit unit);
 
     #region Patient
@@ -28,18 +30,21 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="apiRequest">The admin panel request containing the data needed to create the patient.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Patient"/>, or <c>null</c> if no patient was created.</returns>
+    /// <!-- aidoc:v1 sig=9a79f3c -->
     Task<Patient?> CreatePatient(AdmPanelRequest apiRequest);
     /// <summary>
     /// Asynchronously retrieves the patient associated with the specified location.
     /// </summary>
     /// <param name="location">The location used to look up the associated patient.</param>
     /// <returns>A task that resolves to the <see cref="Patient"/> found at the given location, or <c>null</c> if no patient is associated with that location.</returns>
+    /// <!-- aidoc:v1 sig=bfbcfb4 -->
     Task<Patient?> FindPatientByLocation(PatientLocation location);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Patient"/> by their unique patient number.
     /// </summary>
     /// <param name="patientNumber">The unique identifier of the patient to look up.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="Patient"/>, or <c>null</c> if no patient is found with the specified number.</returns>
+    /// <!-- aidoc:v1 sig=088434b -->
     Task<Patient?> FindPatientByPatientNumber(string patientNumber);
 
     /// <summary>
@@ -48,6 +53,7 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="id">The unique identifier of the patient to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the patient if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=0210ac7 -->
     Task<Patient?> FindPatientById(ObjectId id);
 
     //List<person> FindAllPatient();
@@ -57,6 +63,7 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="request">The admission panel request containing the search criteria used to locate the patient.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="Patient"/> if found, or <c>null</c> otherwise.</returns>
+    /// <!-- aidoc:v1 sig=c3d3d62 -->
     Task<Patient?> FindPatient(AdmPanelRequest request);
     /// <summary>
     /// Asynchronously retrieves the dependency information DTO for the specified <paramref name="unit"/>.
@@ -64,6 +71,7 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="unit">The unit for which to retrieve dependency information.</param>
     /// <returns>A <see cref="Task{UnitInfoDto}"/> that yields the unit dependency DTO, or <c>null</c> if none is found.</returns>
+    /// <!-- aidoc:v1 sig=4a1eecb -->
     Task<UnitInfoDto?> GetUnitDependencyDto(Unit unit);
 
     /// <summary>
@@ -71,6 +79,7 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="request">The admission panel request containing the patient location details to update.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=82018b5 -->
     Task<bool> UpdatePatientLocation(AdmPanelRequest request);
     /// <summary>
     /// Updates the patient data based on the provided admission panel request, using the existing patient record as a reference.
@@ -78,12 +87,14 @@ public interface IAdminPanelService
     /// <param name="request">The admission panel request containing the updated patient data.</param>
     /// <param name="oldPatient">The existing patient record to be updated.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the patient data was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=72c8ec4 -->
     Task<bool> UpdatePatientData(AdmPanelRequest request, Patient oldPatient);
     /// <summary>
     /// Archives the specified patient, marking them as inactive while preserving their record.
     /// </summary>
     /// <param name="patient">The patient to be archived.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the patient was successfully archived; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=9285b16 -->
     Task<bool> ArchivePatient(Patient patient);
 
     #endregion
@@ -94,18 +105,21 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="configObservation">The observation data used to create the configuration.</param>
     /// <returns>A task that represents the asynchronous create operation, containing a value indicating whether the configuration was created successfully.</returns>
+    /// <!-- aidoc:v1 sig=067bf2d -->
     Task<bool> CreateConfig(ConfigObservation configObservation);
     /// <summary>
     /// Asynchronously updates the configuration based on the provided <see cref="ConfigObservation"/>, applying any required changes derived from the observation data.
     /// </summary>
     /// <param name="configObservation">The observation data used to determine and apply configuration updates.</param>
     /// <returns>A <see cref="Task{Boolean}"/> that represents the asynchronous update operation, containing a value indicating whether the configuration was successfully updated.</returns>
+    /// <!-- aidoc:v1 sig=e4c099d -->
     Task<bool> UpdateConfig(ConfigObservation configObservation);
     /// <summary>
     /// Deletes the configuration observation item identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation item to delete.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the item was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e7902ac -->
     Task<bool> DeleteConfigObservationItem(ObjectId id);
 
     #endregion
@@ -118,24 +132,28 @@ public interface IAdminPanelService
     /// </summary>
     /// <param name="medicineId">The unique <see cref="ObjectId"/> of the medicine to look up.</param>
     /// <returns>A <see cref="Task{Medicine}"/> that resolves to the matching <see cref="Medicine"/>, or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=a87fd1e -->
     Task<Medicine?> GetMedicineById(ObjectId medicineId);
     /// <summary>
     /// Asynchronously creates and persists a new medicine record.
     /// </summary>
     /// <param name="medicine">The medicine entity to be created and posted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the newly created <see cref="Medicine"/>, or <c>null</c> if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=9decc93 -->
     Task<Medicine?> PostMedicine(Medicine medicine);
     /// <summary>
     /// Updates an existing medicine record in the system.
     /// </summary>
     /// <param name="medicine">The medicine entity containing the updated information to be persisted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Medicine"/> if found, or <c>null</c> if the medicine does not exist.</returns>
+    /// <!-- aidoc:v1 sig=2ae8490 -->
     Task<Medicine?> UpdateMedicine(Medicine medicine);
     /// <summary>
     /// Deletes a medicine identified by its unique identifier.
     /// </summary>
     /// <param name="medicineId">The unique identifier of the medicine to delete.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the medicine was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=fe8649a -->
     Task<bool> DeleteMedicineById(string medicineId);
 
     #endregion
diff --git a/adas-core.Application/Services/Interfaces/IAdmissionService.cs b/adas-core.Application/Services/Interfaces/IAdmissionService.cs
index 656597e6..b8e8d23b 100644
--- a/adas-core.Application/Services/Interfaces/IAdmissionService.cs
+++ b/adas-core.Application/Services/Interfaces/IAdmissionService.cs
@@ -14,21 +14,25 @@ public interface IAdmissionService : IApiRequestService
     /// </summary>
     /// <param name="admissionId">The unique identifier of the admission to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="Admission"/> if found, or <c>null</c> if no admission matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=11f3852 -->
     Task<Admission?> GetAdmissionByIdAsync(ObjectId admissionId);
     /// <summary>
     /// Asynchronously deletes an admission record identified by the specified admission ID.
     /// </summary>
     /// <param name="admissionId">The unique identifier of the admission to delete.</param>
+    /// <!-- aidoc:v1 sig=33e47dc -->
     Task DeleteAdmissionByIdAsync(ObjectId admissionId);
     /// <summary>
     /// Asynchronously deletes the specified admission record.
     /// </summary>
     /// <param name="admission">The admission entity to remove.</param>
+    /// <!-- aidoc:v1 sig=f6c9117 -->
     Task DeleteAdmissionAsync(Admission admission);
     /// <summary>
     /// Deletes all admissions associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose admissions will be deleted.</param>
+    /// <!-- aidoc:v1 sig=94c7556 -->
     Task DeleteAdmissionsByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -36,46 +40,54 @@ public interface IAdmissionService : IApiRequestService
     /// </summary>
     /// <param name="admission">The admission entity containing the updated data to be persisted.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=4327caa -->
     Task UpdateAdmissionAsync(Admission admission);
     /// <summary>
     /// Asynchronously retrieves a collection of admissions.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of <see cref="Admission"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=a1ad970 -->
     Task<IEnumerable<Admission>> GetAdmissionsAsync();
     /// <summary>
     /// Asynchronously inserts a new admission record and returns the created entry, or <see langword="null"/> if the insertion was not performed.
     /// </summary>
     /// <param name="admission">The admission entity to be inserted into the data store.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the inserted <see cref="Admission"/>, or <see langword="null"/> when no record is produced.</returns>
+    /// <!-- aidoc:v1 sig=d13b5c5 -->
     Task<Admission?> InsertAdmission(Admission admission);
     /// <summary>
     /// Admits a patient based on the provided admission details, optionally registering the patient as new.
     /// </summary>
     /// <param name="admission">The admission information used to process the patient admission.</param>
     /// <param name="isNew">Indicates whether the patient is being admitted for the first time. Defaults to <c>false</c>.</param>
+    /// <!-- aidoc:v1 sig=9f57e3f -->
     Task AdmitPatient(Admission admission, bool isNew = false);
     /// <summary>
     /// Processes the return of a patient to the admissions workflow, typically used when a patient needs to be re-queued or reinstated for admission processing.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient to be returned to admissions.</param>
+    /// <!-- aidoc:v1 sig=4258668 -->
     Task ReturnPatientToAdmissions(ObjectId patientId);
     /// <summary>
     /// Asynchronously returns a patient to the admissions workflow using the specified admission record.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient being returned to admissions.</param>
     /// <param name="adm">The admission record associated with the patient being returned.</param>
+    /// <!-- aidoc:v1 sig=d4a135f -->
     Task ReturnPatientToAdmissions(ObjectId patientId, Admission adm);
     /// <summary>
     /// Retrieves a list of admissions associated with the specified patient location.
     /// </summary>
     /// <param name="location">The patient location used to filter the admissions.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of admissions for the given location.</returns>
+    /// <!-- aidoc:v1 sig=b81f02e -->
     Task<List<Admission>> GetAdmissionByLocation(PatientLocation location);
     /// <summary>
     /// Asynchronously retrieves the list of admissions associated with the specified point of care identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the point of care used to filter the admissions.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Admission"/> objects matching the specified point of care id, or an empty list if no admissions are found.</returns>
+    /// <!-- aidoc:v1 sig=dc63c5a -->
     Task<List<Admission>> GetAdmissionByPointOfCareId(ObjectId id);
     /// <summary>
     /// Retrieves the list of admissions associated with the specified point of care, localized for the given locale.
@@ -83,18 +95,21 @@ public interface IAdmissionService : IApiRequestService
     /// <param name="pocId">The identifier of the point of care whose admissions are being queried.</param>
     /// <param name="locale">The locale used to localize the returned admission data.</param>
     /// <returns>A task that resolves to the list of admissions matching the point of care and locale; an empty list when no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=9479688 -->
     Task<List<Admission>> GetAdmissionByPointOfCareIdAndLocale(ObjectId pocId, LocaleEnum locale);
     /// <summary>
     /// Retrieves a list of admissions associated with the specified unit identifier, excluding any Point of Care (PoC) related admissions.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose admissions should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of admissions for the specified unit, excluding PoC admissions.</returns>
+    /// <!-- aidoc:v1 sig=609220d -->
     Task<List<Admission>> GetAdmissionByUnitIdWithOutPoC(ObjectId unitId);
     /// <summary>
     /// Asynchronously counts the number of admissions associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The MongoDB ObjectId of the unit whose admissions should be counted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the total count of admissions for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=d273b51 -->
     Task<long> CountAdmissionsByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -103,12 +118,14 @@ public interface IAdmissionService : IApiRequestService
     /// <param name="patientNumber">The patient number used to identify the patient.</param>
     /// <param name="unitId">The identifier of the unit in which the patient is being searched.</param>
     /// <returns>A task that returns the matching <see cref="PatientSearch"/> if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=3a4d9fd -->
     Task<PatientSearch?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId);
     /// <summary>
     /// Retrieves the admission record associated with the specified patient number, returning <c>null</c> when no matching admission is found.
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the admission.</param>
     /// <returns>A task that resolves to the matching <see cref="Admission"/>, or <c>null</c> if no admission exists for the given patient number.</returns>
+    /// <!-- aidoc:v1 sig=c602701 -->
     Task<Admission?> GetAdmissionByPatientNumber(string patientNumber);
 
     /// <summary>
@@ -118,6 +135,7 @@ public interface IAdmissionService : IApiRequestService
     /// <param name="unitList">The collection of units associated with the master list item change.</param>
     /// <param name="typeName">The name of the type used to identify the master list item category.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=6d7dd8e -->
     Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList, string typeName);
     /// <summary>
     /// Deletes a patient master list item identified by the specified options, units, and type name.
@@ -125,5 +143,6 @@ public interface IAdmissionService : IApiRequestService
     /// <param name="opt">The option list used to identify the master list item to delete.</param>
     /// <param name="unitList">The collection of units associated with the master list item.</param>
     /// <param name="typeName">The name of the type associated with the master list item.</param>
+    /// <!-- aidoc:v1 sig=bbc71d1 -->
     Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IAlarmService.cs b/adas-core.Application/Services/Interfaces/IAlarmService.cs
index 301634ba..8b64303f 100644
--- a/adas-core.Application/Services/Interfaces/IAlarmService.cs
+++ b/adas-core.Application/Services/Interfaces/IAlarmService.cs
@@ -14,6 +14,7 @@ public interface IAlarmService : IApiRequestService
     /// <param name="patientId">The identifier of the patient whose last observations should be retrieved.</param>
     /// <param name="filterObservations">An optional list of fields to restrict the returned observations; when null, no field filter is applied.</param>
     /// <returns>A task that resolves to the list of the patient's most recent <see cref="PatientObservationAlarm"/> records.</returns>
+    /// <!-- aidoc:v1 sig=db70ab6 -->
     public Task<List<PatientObservationAlarm>> FindLastObservationsByField(ObjectId patientId,
             List<Field>? filterObservations = null);
 
@@ -24,6 +25,7 @@ public interface IAlarmService : IApiRequestService
     /// <param name="dataAlarmfields">The list of fields used to identify and filter the patient observation alarm data.</param>
     /// <param name="configAlarm">The list of configuration observations that define the alarm criteria, including expiration rules.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of the latest non-expired <see cref="PatientObservationAlarm"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=cee772b -->
     Task<List<PatientObservationAlarm>> FindLastValuesNotExpired(ObjectId patientId, List<Field> dataAlarmfields,
             List<ConfigObservation> configAlarm);
 
@@ -33,12 +35,14 @@ public interface IAlarmService : IApiRequestService
     /// <param name="obs">The patient observation alarm to be mapped.</param>
     /// <param name="onlyByName">When true, limits the mapping to lookups performed by name only.</param>
     /// <returns>A task that resolves to the mapped patient observation alarm, or null if no corresponding alarm is found.</returns>
+    /// <!-- aidoc:v1 sig=a6ed4ac -->
     public Task<PatientObservationAlarm?> MapObservation(PatientObservationAlarm obs, bool onlyByName = false);
     /// <summary>
     /// Maps the given patient observation alarm to a corresponding record by name, returning a null result when no matching observation is found.
     /// </summary>
     /// <param name="obs">The patient observation alarm to be mapped by name.</param>
     /// <returns>A task containing the mapped <see cref="PatientObservationAlarm"/>, or <c>null</c> if no matching observation exists.</returns>
+    /// <!-- aidoc:v1 sig=bc68e0c -->
     public Task<PatientObservationAlarm?> MapObservationsByName(PatientObservationAlarm obs);
 
     /// <summary>
@@ -46,6 +50,7 @@ public interface IAlarmService : IApiRequestService
     /// </summary>
     /// <param name="source">The base patient observation value used as input for the alarm evaluation.</param>
     /// <param name="name">The name that identifies the alarm test to be calculated.</param>
+    /// <!-- aidoc:v1 sig=6689f69 -->
     Task CalculateAlarmTest(BasePatientObservationValue source, string name);
 
     /// <summary>
@@ -57,6 +62,7 @@ public interface IAlarmService : IApiRequestService
     /// <param name="severity">The severity level assigned to the alarm.</param>
     /// <param name="type">The type category of the alarm.</param>
     /// <returns>A task that represents the asynchronous alarm sending operation.</returns>
+    /// <!-- aidoc:v1 sig=1e4624b -->
     Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code, AlarmEnum.Severity severity,
             AlarmEnum.Type type);
 
@@ -64,6 +70,7 @@ public interface IAlarmService : IApiRequestService
     /// Asynchronously checks the observation alarm for the specified patient observation.
     /// </summary>
     /// <param name="obs4">The patient observation to evaluate for alarm conditions.</param>
+    /// <!-- aidoc:v1 sig=db0bd32 -->
     Task CheckObservationAlarm(PatientObservation obs4);
 
     /// <summary>
@@ -74,6 +81,7 @@ public interface IAlarmService : IApiRequestService
     /// <param name="patient">The patient to whom the observations and alarms belong.</param>
     /// <param name="messageTime">The timestamp associated with the message being processed.</param>
     /// <param name="observationData">Optional additional observation data used during processing.</param>
+    /// <!-- aidoc:v1 sig=b10b184 -->
     Task ProcessAlarmObservations(List<PatientObservationAlarm> alarmObservations,
             List<PatientObservation> observations, Patient patient,
             DateTime messageTime, ObservationData? observationData = null);
diff --git a/adas-core.Application/Services/Interfaces/IAlertValuesService.cs b/adas-core.Application/Services/Interfaces/IAlertValuesService.cs
index f7481b04..1fae21f5 100644
--- a/adas-core.Application/Services/Interfaces/IAlertValuesService.cs
+++ b/adas-core.Application/Services/Interfaces/IAlertValuesService.cs
@@ -11,5 +11,6 @@ public interface IAlertValuesService
     /// </summary>
     /// <param name="key">The identifier of the configuration observation to look up.</param>
     /// <returns>A task that yields the matching <see cref="ConfigObservation"/>, or <c>null</c> if no record is found.</returns>
+    /// <!-- aidoc:v1 sig=938830c -->
     Task<ConfigObservation?> FindByKey(ObjectId key);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IAppointmentService.cs b/adas-core.Application/Services/Interfaces/IAppointmentService.cs
index c148b462..e9584952 100644
--- a/adas-core.Application/Services/Interfaces/IAppointmentService.cs
+++ b/adas-core.Application/Services/Interfaces/IAppointmentService.cs
@@ -12,12 +12,14 @@ public interface IAppointmentService : IApiRequestService
     /// </summary>
     /// <param name="location">The patient location used to filter and locate the relevant appointments.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> items matching the given location.</returns>
+    /// <!-- aidoc:v1 sig=8d1c435 -->
     Task<List<PatientAppointment>> FindByLocation(PatientLocation location);
     /// <summary>
     /// Retrieves all appointments associated with the specified patient asynchronously.
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose appointments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=44280ba -->
     Task<List<PatientAppointment>> GetByPatient(ObjectId patientId);
     /// <summary>
     /// Retrieves the list of patient appointments scheduled for today for the specified patient.
@@ -25,6 +27,7 @@ public interface IAppointmentService : IApiRequestService
     /// <param name="patientId">The unique identifier of the patient whose appointments are being queried.</param>
     /// <param name="ct">A cancellation token to observe while waiting for the task to complete.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientAppointment"/> entries for the given patient for the current day.</returns>
+    /// <!-- aidoc:v1 sig=4fb06f0 -->
     Task<List<PatientAppointment>> GetTodayByPatient(ObjectId patientId, CancellationToken ct = default);
     /// <summary>
     /// Retrieves the list of patient appointments scheduled for today at the specified point of care.
@@ -32,33 +35,39 @@ public interface IAppointmentService : IApiRequestService
     /// <param name="pocId">The identifier of the point of care whose appointments will be returned.</param>
     /// <param name="ct">The cancellation token used to cancel the asynchronous operation.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of today's patient appointments for the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=b1e7397 -->
     Task<List<PatientAppointment>> GetTodayByPoc(ObjectId pocId, CancellationToken ct = default);
     /// <summary>
     /// Asynchronously finds all <see cref="PatientAppointment"/> records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose appointments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IAsyncCursor{TDocument}"/> for iterating over the matching <see cref="PatientAppointment"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=2d5cd9f -->
     Task<IAsyncCursor<PatientAppointment>> FindByPatientIdAsync(ObjectId patientId);
     /// <summary>
     /// Asynchronously archives the specified patient, marking the record as archived in the system.
     /// </summary>
     /// <param name="patient">The patient whose record should be archived.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Asynchronously archives records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the patient whose related records should be archived.</param>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
     /// <summary>
     /// Deletes a record associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the patient whose related record should be removed.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Processes an incoming API request in the context of the specified patient, handling the required business logic and returning when the processing completes.
     /// </summary>
     /// <param name="apiRequest">The API request to be processed.</param>
     /// <param name="patient">The patient associated with the API request.</param>
+    /// <!-- aidoc:v1 sig=eae6711 -->
     Task ProcessApiRequest(ApiRequest apiRequest, Patient patient);
     /// <summary>
     /// Updates multiple records by replacing the old <see cref="ObjectId"/> with the new one for the field identified by <paramref name="nameId"/>.
@@ -66,5 +75,6 @@ public interface IAppointmentService : IApiRequestService
     /// <param name="nameId">The name of the field whose <see cref="ObjectId"/> value should be updated.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to set on matching records.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IArchivePatientCarePlanService.cs b/adas-core.Application/Services/Interfaces/IArchivePatientCarePlanService.cs
index 118a996b..8cbb07b9 100644
--- a/adas-core.Application/Services/Interfaces/IArchivePatientCarePlanService.cs
+++ b/adas-core.Application/Services/Interfaces/IArchivePatientCarePlanService.cs
@@ -10,24 +10,28 @@ public interface IArchivePatientCarePlanService
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose care plans are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientCarePlan"/> objects if found, or <c>null</c> if no care plans exist for the patient.</returns>
+    /// <!-- aidoc:v1 sig=e64875e -->
     Task<List<PatientCarePlan>?> FindByPatientId(ObjectId id);
     /// <summary>
     /// Retrieves the list of care plans associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose care plans should be retrieved.</param>
     /// <returns>A task that returns a list of <see cref="PatientCarePlan"/> records for the patient, or <c>null</c> if no care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=2001a29 -->
     Task<List<PatientCarePlan>?> FindByPatientId(string id);
     /// <summary>
     /// Retrieves a list of patient care plans associated with the specified patient number.
     /// </summary>
     /// <param name="id">The patient number used to locate the associated care plans.</param>
     /// <returns>A task that returns a list of <see cref="PatientCarePlan"/> for the given patient number, or <c>null</c> if no care plans are found.</returns>
+    /// <!-- aidoc:v1 sig=da83156 -->
     Task<List<PatientCarePlan>?> FindByPatientNumber(string id);
 
     /// <summary>
     /// Asynchronously retrieves all patient care plans.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=83af170 -->
     Task<List<PatientCarePlan>> FindAll();
 
     // Task<PatientCarePlan?> UpdateTreatment(PatientCarePlan patientCarePla, List<OptionList> options);
@@ -37,11 +41,13 @@ public interface IArchivePatientCarePlanService
     /// </summary>
     /// <param name="patientCarePla">The patient care plan to insert.</param>
     /// <returns>A <see cref="Task{PatientCarePlan}"/> that represents the asynchronous insert operation, containing the inserted <see cref="PatientCarePlan"/> or null if no entity was returned.</returns>
+    /// <!-- aidoc:v1 sig=a99067e -->
     Task<PatientCarePlan?> InsertOneAsync(PatientCarePlan patientCarePla);
     /// <summary>
     /// Asynchronously inserts a collection of patient care plans into the data store in a single bulk operation.
     /// </summary>
     /// <param name="patientCarePla">The list of <see cref="PatientCarePlan"/> entities to be inserted.</param>
+    /// <!-- aidoc:v1 sig=fea7cc8 -->
     Task InsertManyAsync(List<PatientCarePlan> patientCarePla);
 
     // Task Update(PatientCarePlan oldPatientCarePla, PatientCarePlan newPatientCarePla);
diff --git a/adas-core.Application/Services/Interfaces/IArchivedPatientObservationService.cs b/adas-core.Application/Services/Interfaces/IArchivedPatientObservationService.cs
index 4678f2c9..3d6d1291 100644
--- a/adas-core.Application/Services/Interfaces/IArchivedPatientObservationService.cs
+++ b/adas-core.Application/Services/Interfaces/IArchivedPatientObservationService.cs
@@ -10,5 +10,6 @@ public interface IArchivedPatientObservationService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose archived observations are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservation"/> objects representing the archived observations for the patient.</returns>
+    /// <!-- aidoc:v1 sig=cedb842 -->
     public Task<List<PatientObservation>> FindArchivedPatientObservationsFromPatient(ObjectId patientId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IArchivedPatientService.cs b/adas-core.Application/Services/Interfaces/IArchivedPatientService.cs
index 09800f67..976dc2fe 100644
--- a/adas-core.Application/Services/Interfaces/IArchivedPatientService.cs
+++ b/adas-core.Application/Services/Interfaces/IArchivedPatientService.cs
@@ -8,5 +8,6 @@ public interface IArchivedPatientService
     /// Asynchronously retrieves all patients from the data store.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all patients.</returns>
+    /// <!-- aidoc:v1 sig=3685411 -->
     public Task<List<Patient>> FindAllPatients();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IArchivedPatientTreatmentService.cs b/adas-core.Application/Services/Interfaces/IArchivedPatientTreatmentService.cs
index 4c775432..859bb2f8 100644
--- a/adas-core.Application/Services/Interfaces/IArchivedPatientTreatmentService.cs
+++ b/adas-core.Application/Services/Interfaces/IArchivedPatientTreatmentService.cs
@@ -10,5 +10,6 @@ public interface IArchivedPatientTreatmentService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=17e4911 -->
     Task<List<PatientTreatment>> FindAllPatientTreatmentsByPatient(ObjectId patientId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IAuthService.cs b/adas-core.Application/Services/Interfaces/IAuthService.cs
index ecd73f17..1bc35772 100644
--- a/adas-core.Application/Services/Interfaces/IAuthService.cs
+++ b/adas-core.Application/Services/Interfaces/IAuthService.cs
@@ -10,34 +10,40 @@ public interface IAuthService
     /// Asynchronously retrieves the current login response, returning <c>null</c> when no login state is available.
     /// </summary>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the current <see cref="LoginResponse"/>, or <c>null</c> if no login response exists.</returns>
+    /// <!-- aidoc:v1 sig=17789be -->
     Task<LoginResponse?> GetLoginResponse();
     /// <summary>
     /// Asynchronously retrieves a token.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the retrieved token string.</returns>
+    /// <!-- aidoc:v1 sig=288a8f8 -->
     Task<string> GetToken();
     /// <summary>
     /// Retrieves a list of authorizations associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose authorizations are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects matching the provided unit identifier.</returns>
+    /// <!-- aidoc:v1 sig=82be9e3 -->
     Task<List<Authorization>> GetByUnitId(ObjectId unitId);
     /// <summary>
     /// Asynchronously deletes the record identified by the specified display identifier.
     /// </summary>
     /// <param name="displayId">The display identifier of the record to delete.</param>
     /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the record was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=9bea906 -->
     Task<bool> DeleteByDisplayId(ObjectId displayId);
     /// <summary>
     /// Asynchronously deletes the entity associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose associated entity should be deleted.</param>
     /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=7032be4 -->
     Task<bool> DeleteByUnitId(ObjectId unitId);
     /// <summary>
     /// Retrieves the list of authorizations associated with the specified user identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the user whose authorizations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of authorizations for the user.</returns>
+    /// <!-- aidoc:v1 sig=884297c -->
     Task<List<Authorization>> GetUserAuthorities(ObjectId id);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ICacheService.cs b/adas-core.Application/Services/Interfaces/ICacheService.cs
index e33faafe..68cb4b35 100644
--- a/adas-core.Application/Services/Interfaces/ICacheService.cs
+++ b/adas-core.Application/Services/Interfaces/ICacheService.cs
@@ -11,12 +11,14 @@ namespace adas_core.Application.Services.Interfaces
         /// </summary>
         /// <param name="key">The identifier used to associate the value.</param>
         /// <param name="value">The value to store for the specified key.</param>
+        /// <!-- aidoc:v1 sig=a3acfbd -->
         void SetValue(string key, string value);
         /// <summary>
         /// Retrieves the string value associated with the specified key.
         /// </summary>
         /// <param name="key">The key used to look up the value.</param>
         /// <returns>The value associated with the key, or <c>null</c> if the key is not found.</returns>
+        /// <!-- aidoc:v1 sig=09e20ab -->
         string? GetValue(string key);
         /// <summary>
         /// Asynchronously retrieves an object associated with the specified <paramref name="key"/>, returning null if no entry is found.
@@ -25,6 +27,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="key">The unique identifier of the object to retrieve.</param>
         /// <param name="updateExpiration">Indicates whether the expiration of the entry should be extended when it is successfully retrieved. Defaults to true.</param>
         /// <returns>A task that represents the asynchronous retrieval operation. The task result contains the object of type <typeparamref name="T"/> associated with the key, or null if no matching entry exists.</returns>
+        /// <!-- aidoc:v1 sig=a85ace8 -->
         Task<T?> GetObjectAsync<T>(string key, bool updateExpiration = true);
         /// <summary>
         /// Asynchronously stores an object of type <typeparamref name="T"/> using the specified key, optionally updating its expiration time.
@@ -33,6 +36,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="key">The identifier under which the object will be stored.</param>
         /// <param name="obj">The object to be stored.</param>
         /// <param name="updateExpiration">Specifies whether the expiration time of the entry should be refreshed. Defaults to true.</param>
+        /// <!-- aidoc:v1 sig=af94cc4 -->
         Task SetObjectAsync<T>(string key, T obj, bool updateExpiration = true);
         /// <summary>
         /// Asynchronously retrieves an object of type <typeparamref name="T"/> associated with the specified <paramref name="key"/>.
@@ -43,6 +47,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="ttlOverride">An optional time-to-live value that overrides the default expiration period; if <see langword="null"/>, the default TTL is used.</param>
         /// <param name="updateExpiration">A value indicating whether the object's expiration should be extended when it is successfully retrieved.</param>
         /// <returns>A <see cref="Task{T}"/> that represents the asynchronous operation, containing the retrieved object of type <typeparamref name="T"/>, or <see langword="null"/> if the object is not found.</returns>
+        /// <!-- aidoc:v1 sig=ef3aa47 -->
         Task<T?> GetObjectAsync<T>(string key, TimeSpan? ttlOverride, bool updateExpiration);
         /// <summary>
         /// Asynchronously stores the specified object associated with the given key, using an optional time-to-live override and expiration update behavior.
@@ -52,21 +57,25 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="ttlOverride">An optional <see cref="TimeSpan"/> that overrides the default time-to-live for the stored object.</param>
         /// <param name="updateExpiration">A value indicating whether the expiration of the stored object should be updated based on the provided TTL.</param>
         /// <returns>A <see cref="Task"/> that represents the asynchronous storage operation.</returns>
+        /// <!-- aidoc:v1 sig=85ff65d -->
         Task SetObjectAsync<T>(string key, T obj, TimeSpan? ttlOverride, bool updateExpiration);
         /// <summary>
         /// Asynchronously deletes an object identified by the specified key.
         /// </summary>
         /// <param name="key">The unique identifier of the object to delete.</param>
+        /// <!-- aidoc:v1 sig=a568485 -->
         Task DeleteObjectAsync(string key);
         /// <summary>
         /// Asynchronously deletes entries matching the specified pattern and returns the number of deleted items.
         /// </summary>
         /// <param name="pattern">The pattern used to match the entries to be deleted.</param>
         /// <returns>A task that represents the asynchronous delete operation. The task result contains the total number of entries that were deleted.</returns>
+        /// <!-- aidoc:v1 sig=d0828a6 -->
         Task<long> DeleteByPatternAsync(string pattern);
         /// <summary>
         /// Clears the application cache, removing all cached entries.
         /// </summary>
+        /// <!-- aidoc:v1 sig=fe89cd5 -->
         void CleanCache();
 
         
@@ -80,6 +89,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="loader">The asynchronous function invoked to produce the value when no cached entry exists for the specified key.</param>
         /// <param name="ttlOverride">An optional time-to-live duration that overrides the default expiration for the cached entry; when <c>null</c>, the default TTL is used.</param>
         /// <returns>A task that represents the asynchronous operation. The result is the cached or freshly loaded string value, or <c>null</c> when no value is available.</returns>
+        /// <!-- aidoc:v1 sig=9201892 -->
         Task<string?> GetOrSetValueAsync(string key, Func<Task<string>> loader, TimeSpan? ttlOverride = null);
         /// <summary>
         /// Asynchronously retrieves an object associated with the specified key from the cache, or invokes the factory to create and cache a new one when the key is not found.
@@ -89,6 +99,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="ttl">The optional expiration period for the cached entry; if null, the default cache lifetime is applied.</param>
         /// <param name="cancellationToken">The token used to cancel the asynchronous operation.</param>
         /// <returns>A task that resolves to the cached or newly created object of type <typeparamref name="T"/>.</returns>
+        /// <!-- aidoc:v1 sig=3a49f2f -->
         Task<T> GetOrSetObjectAsync<T>(
                     string key,
                     Func<Task<T>> factory,
@@ -105,6 +116,7 @@ namespace adas_core.Application.Services.Interfaces
         /// <param name="ttl">The optional time-to-live duration applied to the cached entry.</param>
         /// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
         /// <returns>A task containing the cached or newly created object of type <typeparamref name="T"/>.</returns>
+        /// <!-- aidoc:v1 sig=b6c9631 -->
         Task<T> GetOrSetObjectAsync<T>(
                     GroupedField groupedField,
                     ObjectId patientId,
diff --git a/adas-core.Application/Services/Interfaces/ICalculatedObservations.cs b/adas-core.Application/Services/Interfaces/ICalculatedObservations.cs
index b94939bd..3b16a22d 100644
--- a/adas-core.Application/Services/Interfaces/ICalculatedObservations.cs
+++ b/adas-core.Application/Services/Interfaces/ICalculatedObservations.cs
@@ -13,18 +13,21 @@ public interface ICalculatedObservations
     /// <param name="obs">The source patient observation to be mapped.</param>
     /// <param name="onlyByName">When set to <c>true</c>, the mapping is performed considering only the observation name; otherwise, additional mapping criteria are applied. Defaults to <c>false</c>.</param>
     /// <returns>A <see cref="Task{T}"/> that represents the asynchronous mapping operation. The result is the mapped observation of type <typeparamref name="T"/>, or <c>null</c> when no matching mapping is found.</returns>
+    /// <!-- aidoc:v1 sig=7c2c1e5 -->
     Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation;
     /// <summary>
     /// Asynchronously maps the specified <paramref name="treatment"/> to a <see cref="PatientTreatment"/> result.
     /// </summary>
     /// <param name="treatment">The patient treatment instance to map.</param>
     /// <returns>A task that represents the asynchronous mapping operation. The task result contains the mapped <see cref="PatientTreatment"/>.</returns>
+    /// <!-- aidoc:v1 sig=be008d3 -->
     Task<PatientTreatment> Map(PatientTreatment treatment);
     /// <summary>
     /// Asynchronously maps a <see cref="PatientDiagnosis"/> to a <see cref="PatientDiagnosis"/> representation.
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
+    /// <!-- aidoc:v1 sig=b4c53f0 -->
     Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis);
 
     /// <summary>
@@ -32,6 +35,7 @@ public interface ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The <see cref="PumpObservation"/> to be mapped.</param>
     /// <returns>A <see cref="Task{TResult}"/> representing the asynchronous operation, containing the mapped <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=47d6f99 -->
     Task<PumpObservation> Map(PumpObservation pumpObservation);
 
     /// <summary>
@@ -39,12 +43,14 @@ public interface ICalculatedObservations
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The unique identifier of the patient whose observation is being calculated.</param>
+    /// <!-- aidoc:v1 sig=341d0d1 -->
     Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId);
 
     /// <summary>
     /// 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>
+    /// <!-- aidoc:v1 sig=db92fab -->
     Task CalculateActiveBolus(ObjectId patientId);
 
     /// <summary>
@@ -52,6 +58,7 @@ public interface ICalculatedObservations
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of nullable <see cref="PatientTreatment"/> entries that represent the active treatments for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=9eb0d98 -->
     Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id);
 
     /// <summary>
@@ -59,12 +66,14 @@ public interface ICalculatedObservations
     /// </summary>
     /// <param name="newObservation">The new patient observation to validate and reconcile against the previous observation's time information.</param>
     /// <returns>A task that yields the fixed <see cref="PatientObservation"/>, or <c>null</c> when no time inconsistency is detected or no correction is required.</returns>
+    /// <!-- aidoc:v1 sig=ae6ddc1 -->
     Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation);
     /// <summary>
     /// Performs pre-insertion mapping on a list of patient observations, transforming or preparing the data before it is persisted.
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped prior to insertion.</param>
     /// <returns>A task that represents the asynchronous operation, containing the mapped list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=c6d4218 -->
     Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert);
     /// <summary>
     /// Maps the source alarm onto the specified patient observation and returns the resulting observation.
@@ -72,6 +81,7 @@ public interface ICalculatedObservations
     /// <param name="obs">The patient observation to which the source alarm will be mapped.</param>
     /// <param name="alarmToInsert">The patient observation alarm to insert and map as the source alarm.</param>
     /// <returns>A task representing the asynchronous operation, containing the patient observation with the source alarm mapped.</returns>
+    /// <!-- aidoc:v1 sig=c22dba5 -->
     Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert);
 
     /// <summary>
@@ -80,5 +90,7 @@ public interface ICalculatedObservations
     /// <param name="obs">The patient observation that triggered the alarm.</param>
     /// <param name="name">The name associated with the alarm.</param>
     /// <param name="code">An optional alarm code categorizing the type of alarm to send.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "Method returns Task but no <returns> tag documents the async return value or what completion of the task represents." -->
     Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ICalculatedObservationsService.cs b/adas-core.Application/Services/Interfaces/ICalculatedObservationsService.cs
index e6f28c76..e6aac281 100644
--- a/adas-core.Application/Services/Interfaces/ICalculatedObservationsService.cs
+++ b/adas-core.Application/Services/Interfaces/ICalculatedObservationsService.cs
@@ -12,6 +12,7 @@ public interface ICalculatedObservationsService
     /// <param name="obs">The source <see cref="PatientObservation"/> to be mapped.</param>
     /// <param name="onlyByName">When <c>true</c>, restricts the mapping to be performed by name only; otherwise, additional criteria are used.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> that resolves to the mapped <see cref="PatientObservation"/>, or <c>null</c> if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=41cebf4 -->
     Task<PatientObservation?> Map(PatientObservation obs, bool onlyByName = false);
     /// <summary>
     /// Asynchronously maps a <see cref="PatientObservationAlarm"/> instance, optionally performing the mapping
@@ -23,41 +24,48 @@ public interface ICalculatedObservationsService
     /// full mapping logic is applied. Defaults to <c>false</c>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the mapped
     /// <see cref="PatientObservationAlarm"/>, or <c>null</c> if no mapping is found.</returns>
+    /// <!-- aidoc:v1 sig=2a563ad -->
     Task<PatientObservationAlarm?> Map(PatientObservationAlarm obs, bool onlyByName = false);
     /// <summary>
     /// Maps a <see cref="PatientTreatment"/> instance to a projected <see cref="PatientTreatment"/> representation asynchronously.
     /// </summary>
     /// <param name="treatment">The source <see cref="PatientTreatment"/> to be mapped.</param>
     /// <returns>A <see cref="Task{PatientTreatment}"/> that represents the asynchronous mapping operation. The result is the mapped <see cref="PatientTreatment"/>, or <see langword="null"/> if no mapping could be produced.</returns>
+    /// <!-- aidoc:v1 sig=05e1494 -->
     Task<PatientTreatment?> Map(PatientTreatment treatment);
     /// <summary>
     /// Maps the provided <see cref="PumpObservation"/> to a <see cref="PumpObservation"/> result, returning <see langword="null"/> when no mapping is produced.
     /// </summary>
     /// <param name="obs">The source <see cref="PumpObservation"/> to be mapped.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the mapped <see cref="PumpObservation"/>, or <see langword="null"/> if the mapping yields no result.</returns>
+    /// <!-- aidoc:v1 sig=919e4c3 -->
     Task<PumpObservation?> Map(PumpObservation obs);
     /// <summary>
     /// Asynchronously maps the specified <see cref="PatientRecordingAlert"/> to a resulting <see cref="PatientRecordingAlert"/>, returning <see langword="null"/> when no mapping is produced.
     /// </summary>
     /// <param name="obs">The source <see cref="PatientRecordingAlert"/> instance to map.</param>
     /// <returns>A <see cref="Task{TResult}"/> that contains the mapped <see cref="PatientRecordingAlert"/>, or <see langword="null"/> if the source cannot be mapped.</returns>
+    /// <!-- aidoc:v1 sig=2805400 -->
     Task<PatientRecordingAlert?> Map(PatientRecordingAlert obs);
     /// <summary>
     /// Maps a <see cref="PatientDiagnosis"/> instance to its corresponding representation, returning <see langword="null"/> when no mapping is available.
     /// </summary>
     /// <param name="obs">The source <see cref="PatientDiagnosis"/> to map.</param>
     /// <returns>A <see cref="Task{T}"/> containing the mapped <see cref="PatientDiagnosis"/>, or <see langword="null"/> if the source cannot be mapped.</returns>
+    /// <!-- aidoc:v1 sig=c9284b0 -->
     Task<PatientDiagnosis?> Map(PatientDiagnosis obs);
     /// <summary>
     /// Maps a list of patient observations for insertion, returning the transformed list asynchronously.
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be mapped for insertion.</param>
     /// <returns>A task representing the asynchronous operation, containing the mapped list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=619bfe1 -->
     Task<List<PatientObservation>> MapList(List<PatientObservation> listToInsert);
     /// <summary>
     /// Asynchronously calculates the bolus dose of opiates for the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the bolus opiates calculation is performed.</param>
+    /// <!-- aidoc:v1 sig=859008a -->
     Task CalculateBolusOpiates(ObjectId patientId);
     /// <summary>
     /// Asynchronously calculates medicine observations for a patient based on their active medicines.
@@ -65,12 +73,14 @@ public interface ICalculatedObservationsService
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The unique identifier of the patient.</param>
     /// <returns>A task that represents the asynchronous calculation operation.</returns>
+    /// <!-- aidoc:v1 sig=341d0d1 -->
     Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId);
     /// <summary>
     /// Retrieves the active patient treatments associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of active PatientTreatment entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=9eb0d98 -->
     Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id);
     /// <summary>
     /// Maps a source alarm from a <see cref="PatientObservationAlarm"/> onto a <see cref="PatientObservation"/>, producing an observation enriched with the corresponding alarm information.
@@ -78,5 +88,6 @@ public interface ICalculatedObservationsService
     /// <param name="observation">The patient observation that serves as the base for the mapping.</param>
     /// <param name="observationAlarm">The source alarm whose data is mapped onto the observation.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="PatientObservation"/> populated with the mapped alarm data.</returns>
+    /// <!-- aidoc:v1 sig=1c0c4ce -->
     Task<PatientObservation> MapSourceAlarm(PatientObservation observation, PatientObservationAlarm observationAlarm);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ICameraService.cs b/adas-core.Application/Services/Interfaces/ICameraService.cs
index bb490bc6..bfccb6a3 100644
--- a/adas-core.Application/Services/Interfaces/ICameraService.cs
+++ b/adas-core.Application/Services/Interfaces/ICameraService.cs
@@ -12,24 +12,28 @@ public interface ICameraService
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay used to look up the camera.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Camera"/> if a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=dcfdfde -->
     Task<Camera?> GetById(ObjectId relayId);
     /// <summary>
     /// Retrieves the list of cameras associated with the specified configuration relay identifiers.
     /// </summary>
     /// <param name="configurationRelayList">The list of configuration relay object identifiers used to look up the associated cameras.</param>
     /// <returns>A list of cameras that correspond to the provided configuration relay identifiers.</returns>
+    /// <!-- aidoc:v1 sig=4523ee6 -->
     List<Camera> GetCameraInList(List<ObjectId> configurationRelayList);
     /// <summary>
     /// Retrieves a paginated list of cameras based on the provided pagination filter.
     /// </summary>
     /// <param name="request">The pagination filter containing the page size, page number, and optional search criteria used to query cameras.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{Camera}"/> with the requested page of cameras and pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=3886498 -->
     Task<PaginationResponse<Camera>> GetPaginatedCameras(PaginationFilter request);
     /// <summary>
     /// Inserts a new camera into the system asynchronously.
     /// </summary>
     /// <param name="camera">The camera entity to insert.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the inserted camera with its generated identifier, or <c>null</c> if the camera could not be inserted.</returns>
+    /// <!-- aidoc:v1 sig=7c18638 -->
     Task<Camera?> InsertCamera(Camera camera);
     /// <summary>
     /// Updates an existing camera identified by the specified object identifier with the provided camera data.
@@ -38,17 +42,20 @@ public interface ICameraService
     /// <param name="objectId">The unique identifier of the camera to update.</param>
     /// <param name="camera">The camera data containing the updated values to apply.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated camera, or <see langword="null"/> if the camera was not found.</returns>
+    /// <!-- aidoc:v1 sig=cb8ad73 -->
     Task<Camera?> UpdateCameraById(ObjectId objectId, Camera camera);
     /// <summary>
     /// Deletes a camera identified by the specified object identifier.
     /// </summary>
     /// <param name="objectId">The unique identifier of the camera to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The result is <c>true</c> if the camera was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=7b8b4e5 -->
     Task<bool> DeleteCamera(ObjectId objectId);
     /// <summary>
     /// Asynchronously retrieves a list of cameras whose names match the specified search text.
     /// </summary>
     /// <param name="textToSearch">The text used to search camera names.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Camera"/> objects matching the search criteria; an empty list is returned if no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=b1c98a2 -->
     Task<List<Camera>> GetSearchByNameCameras(string textToSearch);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IClientMessageService.cs b/adas-core.Application/Services/Interfaces/IClientMessageService.cs
index 30b571b3..4b49bf57 100644
--- a/adas-core.Application/Services/Interfaces/IClientMessageService.cs
+++ b/adas-core.Application/Services/Interfaces/IClientMessageService.cs
@@ -13,6 +13,7 @@ public interface IClientMessageService
     /// <param name="type">The optional operation type used to classify the message.</param>
     /// <param name="msg">The optional message payload to be sent.</param>
     /// <returns>A task that represents the asynchronous send operation.</returns>
+    /// <!-- aidoc:v1 sig=3c62336 -->
     Task SendAsync(string receiverId, OperationType? type, object? msg);
     /// <summary>
     /// Asynchronously broadcasts a message of the specified operation type to all connected recipients.
@@ -20,16 +21,20 @@ public interface IClientMessageService
     /// <param name="type">The operation type that classifies the broadcast message.</param>
     /// <param name="msg">The message payload to send, or <c>null</c> when no payload is required.</param>
     /// <returns>A task that represents the asynchronous broadcast operation.</returns>
+    /// <!-- aidoc:v1 sig=e5d4ff6 -->
     Task SendToAllAsync(OperationType type, object? msg);
     /// <summary>
     /// Processes an incoming message within the context of the specified connection.
     /// </summary>
     /// <param name="msg">The message to be processed.</param>
     /// <param name="contextConnectionId">The identifier of the connection context associated with the message.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "Method returns Task (indicating asynchronous processing) but no <returns> tag is present to describe the returned task." -->
     Task ProcessMessage(Message msg, string contextConnectionId);
     /// <summary>
     /// Sends an update message to the specified list of patient location boxes.
     /// </summary>
     /// <param name="boxes">The list of patient locations that will receive the update message.</param>
+    /// <!-- aidoc:v1 sig=4a52d06 -->
     void SendUpdateMessageToBoxes(List<PatientLocation> boxes);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IConfigObservationService.cs b/adas-core.Application/Services/Interfaces/IConfigObservationService.cs
index 407dbe70..3d2f88fa 100644
--- a/adas-core.Application/Services/Interfaces/IConfigObservationService.cs
+++ b/adas-core.Application/Services/Interfaces/IConfigObservationService.cs
@@ -19,6 +19,7 @@ public interface IConfigObservationService
     /// <param name="codingSystem">The coding system used to identify the configuration observation (e.g., ICD, SNOMED).</param>
     /// <param name="code">The code within the given coding system that uniquely identifies the configuration observation.</param>
     /// <returns>A <see cref="ConfigObservation"/> if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=b4251de -->
     Task<ConfigObservation?> GetByCodeSysAndCode(string codingSystem, string code);
     /// <summary>
     /// Asynchronously retrieves a <see cref="ConfigObservation"/> identified by the given name.
@@ -26,6 +27,7 @@ public interface IConfigObservationService
     /// </summary>
     /// <param name="name">The name of the configuration observation to retrieve.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="ConfigObservation"/>, or <see langword="null"/> if no observation is found.</returns>
+    /// <!-- aidoc:v1 sig=f39308c -->
     Task<ConfigObservation?> Get(string name);
 
     /// <summary>
@@ -34,6 +36,7 @@ public interface IConfigObservationService
     /// <param name="obs">The patient observation whose corresponding configuration observation is being requested.</param>
     /// <param name="onlyByName">When <c>true</c>, limits the lookup to a name-based match; otherwise, other matching criteria may be applied.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigObservation"/>, or <c>null</c> if no matching observation is found.</returns>
+    /// <!-- aidoc:v1 sig=5d51beb -->
     Task<ConfigObservation?> Get<T>(T obs, bool onlyByName = false) where T : BasePatientObservation;
     
     /// <summary>
@@ -41,6 +44,7 @@ public interface IConfigObservationService
     /// </summary>
     /// <param name="obs">The patient observation of type <typeparamref name="T"/> on which retention actions will be executed.</param>
     /// <returns>A task that represents the asynchronous retention operation. The task result contains the <see cref="ObservatitonRetentionResult"/> produced by the retention actions, or <c>null</c> when no retention result is produced.</returns>
+    /// <!-- aidoc:v1 sig=67748d9 -->
     Task<ObservatitonRetentionResult?> RetentionActions<T>(T obs) where T : BasePatientObservation;
     /// <summary>
     /// Maps a patient observation to a corresponding target observation of the same type, optionally restricting the lookup to name-based matching only.
@@ -48,12 +52,14 @@ public interface IConfigObservationService
     /// <param name="obs">The source patient observation to be mapped.</param>
     /// <param name="onlyByName">When set to <c>true</c>, the mapping is performed using the observation's name only; otherwise, additional matching criteria are considered. Defaults to <c>false</c>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the mapped patient observation of type <typeparamref name="T"/>, or <c>null</c> if no matching observation is found.</returns>
+    /// <!-- aidoc:v1 sig=7c2c1e5 -->
     Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation;
     /// <summary>
     /// Asynchronously maps the specified <see cref="PatientTreatment"/> to a populated <see cref="PatientTreatment"/> instance, returning <see langword="null"/> when the treatment cannot be resolved.
     /// </summary>
     /// <param name="treatment">The <see cref="PatientTreatment"/> to be mapped.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the mapped <see cref="PatientTreatment"/>, or <see langword="null"/> if no mapping result is available.</returns>
+    /// <!-- aidoc:v1 sig=05e1494 -->
     Task<PatientTreatment?> Map(PatientTreatment treatment);
 
     /// <summary>
@@ -66,6 +72,7 @@ public interface IConfigObservationService
     /// <param name="min">The optional minimum threshold for the value.</param>
     /// <param name="max">The optional maximum threshold for the value.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the evaluated <see cref="StatusEnum.Type"/> for the grouped observation.</returns>
+    /// <!-- aidoc:v1 sig=4f9fc90 -->
     Task<StatusEnum.Type> GroupedObservationStatus(GroupedField groupedField, GroupedObservationEnum.Result result,
             string name, object value, double? min, double? max);
 
@@ -74,64 +81,75 @@ public interface IConfigObservationService
     /// </summary>
     /// <param name="ct">The cancellation token used to cancel the asynchronous operation.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="ConfigObservation"/> objects representing all available configurations.</returns>
+    /// <!-- aidoc:v1 sig=c9e275b -->
     Task<ICollection<ConfigObservation>> GetAllConfigs(CancellationToken ct = default);
     /// <summary>
     /// Retrieves a paginated collection of <see cref="ConfigObservation"/> items based on the supplied filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the page size, page number, and query criteria used to retrieve the configuration observations.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{ConfigObservation}"/> with the requested items and pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=2a96e75 -->
     Task<PaginationResponse<ConfigObservation>> GetPaginatedItems(PaginationFilter filter);
     /// <summary>
     /// Retrieves all configuration observations in a compact format.
     /// </summary>
     /// <returns>A task representing the asynchronous operation that returns a <see cref="ConfigObservationDto"/> containing the compact representation of all configuration observations.</returns>
+    /// <!-- aidoc:v1 sig=474ef97 -->
     Task<ConfigObservationDto> GetAllCompact();
     /// <summary>
     /// Retrieves a configuration observation by its unique identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the configuration observation to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ConfigObservation"/> if a matching record is found, or <c>null</c> if no configuration exists for the specified id.</returns>
+    /// <!-- aidoc:v1 sig=aacda16 -->
     Task<ConfigObservation?> GetConfigById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a list of configuration names associated with the specified identifier.
     /// </summary>
     /// <param name="id">The identifier used to look up the associated configuration names.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of configuration names.</returns>
+    /// <!-- aidoc:v1 sig=e20bf71 -->
     Task<List<string>> GetConfigNames(string id);
     /// <summary>
     /// Asynchronously retrieves the list of available configuration names.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of configuration names.</returns>
+    /// <!-- aidoc:v1 sig=45b7793 -->
     Task<List<string>> GetConfigNames();
     /// <summary>
     /// Updates an existing configuration observation and returns the updated result.
     /// </summary>
     /// <param name="configObservation">The configuration observation containing the data to update.</param>
     /// <returns>A task that resolves to the updated <see cref="ConfigObservation"/>, or <c>null</c> when no matching configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=15fa841 -->
     Task<ConfigObservation?> UpdateConfig(ConfigObservation configObservation);
     /// <summary>
     /// Asynchronously creates a new configuration based on the provided observation data.
     /// </summary>
     /// <param name="configObservation">The observation data used to create the configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing the created <see cref="ConfigObservation"/>, or <c>null</c> if the configuration could not be created.</returns>
+    /// <!-- aidoc:v1 sig=9317e04 -->
     Task<ConfigObservation?> CreateConfig(ConfigObservation configObservation);
     /// <summary>
     /// Asynchronously removes the configuration item with the specified name.
     /// </summary>
     /// <param name="itemName">The name of the configuration item to remove.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="ConfigObservation"/> describing the removed item, or <c>null</c> if no matching item was found.</returns>
+    /// <!-- aidoc:v1 sig=ce6276e -->
     Task<ConfigObservation?> RemoveConfigItem(string itemName);
     /// <summary>
     /// Asynchronously removes the configuration item identified by the specified identifier and returns the resulting observation.
     /// </summary>
     /// <param name="id">The unique identifier of the configuration item to remove.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ConfigObservation"/> describing the removed configuration item, or <c>null</c> if no matching item was found.</returns>
+    /// <!-- aidoc:v1 sig=9730dbb -->
     Task<ConfigObservation?> RemoveConfigItem(ObjectId id);
     /// <summary>
     /// Retrieves the configuration observation items associated with the specified name.
     /// </summary>
     /// <param name="name">The name used to look up the configuration observation items.</param>
     /// <returns>A task that represents the asynchronous operation. The result contains a collection of <see cref="ConfigObservation"/> items matching the provided name, or <c>null</c> if no matching items are found.</returns>
+    /// <!-- aidoc:v1 sig=3cb29fa -->
     Task<IEnumerable<ConfigObservation>?> GetConfigObservationItem(string name);
 
     /// <summary>
@@ -142,6 +160,7 @@ public interface IConfigObservationService
     /// <param name="name">The name of the configuration observation item.</param>
     /// <param name="originalName">The original name of the configuration observation item.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigObservation"/>, or <c>null</c> if no item is found.</returns>
+    /// <!-- aidoc:v1 sig=2c7c75f -->
     Task<ConfigObservation?> GetSingleConfigObservationItem(string? code, string? codingSystem, string? name,
             string? originalName);
 
@@ -150,11 +169,13 @@ public interface IConfigObservationService
     /// </summary>
     /// <param name="configObservationItem">The configuration observation item to be deleted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=1f61b9b -->
     Task<bool> DeleteSingleConfigObservationItem(ConfigObservation configObservationItem);
     /// <summary>
     /// Retrieves configuration observation items that match the specified name.
     /// </summary>
     /// <param name="name">The name used to filter the configuration observation items.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the collection of <see cref="ConfigObservation"/> items matching the specified name.</returns>
+    /// <!-- aidoc:v1 sig=69b9196 -->
     Task<IEnumerable<ConfigObservation>> GetConfigObservationItemsByName(string name);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IConfigPumpsService.cs b/adas-core.Application/Services/Interfaces/IConfigPumpsService.cs
index fb73bade..bf1d61b4 100644
--- a/adas-core.Application/Services/Interfaces/IConfigPumpsService.cs
+++ b/adas-core.Application/Services/Interfaces/IConfigPumpsService.cs
@@ -11,11 +11,13 @@ public interface IConfigPumpsService
     /// </summary>
     /// <param name="obs">The source PumpObservation to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting PumpObservation.</returns>
+    /// <!-- aidoc:v1 sig=e90f6a3 -->
     Task<PumpObservation> Map(PumpObservation obs);
     /// <summary>
     /// Retrieves all available pump configurations from the configuration store.
     /// </summary>
     /// <returns>A task containing a list of <see cref="ConfigPumps"/> with all pump configurations, or <c>null</c> if no configurations are available.</returns>
+    /// <!-- aidoc:v1 sig=02da65c -->
     Task<List<ConfigPumps>?> GetAllPumpConfigs();
     /// <summary>
     /// Asynchronously retrieves the configuration pump items associated with the specified identifier.
@@ -23,36 +25,42 @@ public interface IConfigPumpsService
     /// </summary>
     /// <param name="id">The unique identifier used to look up the configuration items.</param>
     /// <returns>A task containing a list of ConfigPumpItem objects if found, or null if no items exist for the specified id.</returns>
+    /// <!-- aidoc:v1 sig=f88a8a5 -->
     Task<List<ConfigPumpItem>?> GetConfigItems(string id);
     /// <summary>
     /// Asynchronously retrieves the pump configuration that matches the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the pump configuration to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ConfigPumps"/> configuration if found; otherwise, <c>null</c> when no configuration exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=6e00a1d -->
     Task<ConfigPumps?> GetPumpConfigById(string id);
     /// <summary>
     /// Updates the pump configuration asynchronously and returns the updated configuration.
     /// </summary>
     /// <param name="pumpConfig">The pump configuration to update.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="ConfigPumps"/>, or <c>null</c> if the configuration was not found.</returns>
+    /// <!-- aidoc:v1 sig=8810f19 -->
     Task<ConfigPumps?> UpdatePumpConfig(ConfigPumps pumpConfig);
     /// <summary>
     /// Inserts a new pump configuration into the data store.
     /// </summary>
     /// <param name="pumpConfig">The pump configuration to insert.</param>
     /// <returns>The inserted <see cref="ConfigPumps"/> entity, or <c>null</c> if the insertion was not performed.</returns>
+    /// <!-- aidoc:v1 sig=65d91df -->
     Task<ConfigPumps?> InsertPumpConfig(ConfigPumps pumpConfig);
     /// <summary>
     /// Asynchronously deletes the specified pump configuration.
     /// </summary>
     /// <param name="config">The pump configuration to delete.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=ce3f871 -->
     Task<bool> DeletePumpConfig(ConfigPumps config);
     /// <summary>
     /// Asynchronously evaluates and applies retention actions for a pump observation, returning the resulting retention outcome.
     /// </summary>
     /// <param name="obs">The pump observation to process for retention actions.</param>
     /// <returns>A task that represents the asynchronous operation, containing the retention result, or null if no retention action applies.</returns>
+    /// <!-- aidoc:v1 sig=9f98a57 -->
     Task<ObservatitonRetentionResult?> RetentionActions(PumpObservation obs);
     
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IConfigUnitsService.cs b/adas-core.Application/Services/Interfaces/IConfigUnitsService.cs
index 2a3cfd4b..e7b2cd76 100644
--- a/adas-core.Application/Services/Interfaces/IConfigUnitsService.cs
+++ b/adas-core.Application/Services/Interfaces/IConfigUnitsService.cs
@@ -11,11 +11,13 @@ public interface IConfigUnitsService
     /// <typeparam name="T">The specific patient observation type, constrained to <see cref="BasePatientObservation"/>.</typeparam>
     /// <param name="obs">The patient observation instance to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, yielding the mapped patient observation.</returns>
+    /// <!-- aidoc:v1 sig=f302314 -->
     Task<T> Map<T>(T obs) where T : BasePatientObservation;
     /// <summary>
     /// Asynchronously maps the specified <see cref="PumpObservation"/> to a resulting <see cref="PumpObservation"/>.
     /// </summary>
     /// <param name="obs">The pump observation to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=e90f6a3 -->
     Task<PumpObservation> Map(PumpObservation obs);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IDeviceService.cs b/adas-core.Application/Services/Interfaces/IDeviceService.cs
index 71ded200..3f7a448f 100644
--- a/adas-core.Application/Services/Interfaces/IDeviceService.cs
+++ b/adas-core.Application/Services/Interfaces/IDeviceService.cs
@@ -11,18 +11,21 @@ public interface IDeviceService
     /// </summary>
     /// <param name="device">The data transfer object containing the information used to create the device.</param>
     /// <returns>A task that represents the asynchronous create operation. The task result contains the created <see cref="Device"/>, or <see langword="null"/> if the device could not be created.</returns>
+    /// <!-- aidoc:v1 sig=f960817 -->
     Task<Device?> Create(DeviceDto device);
     /// <summary>
     /// Asynchronously deletes the object identified by the specified identifier.
     /// </summary>
     /// <param name="objectId">The unique identifier of the object to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The result is <c>true</c> if the object was deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=9c1b1e3 -->
     Task<bool> Delete(ObjectId objectId);
     /// <summary>
     /// Updates an existing device using the provided data transfer object.
     /// </summary>
     /// <param name="device">The data transfer object containing the updated device information.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated device, or <c>null</c> if the device was not found.</returns>
+    /// <!-- aidoc:v1 sig=74ac7b4 -->
     Task<Device?> Update(DeviceDto device);
     /// <summary>
     /// Processes an incoming event for the specified device and returns the associated <see cref="Device"/>.
@@ -30,5 +33,6 @@ public interface IDeviceService
     /// </summary>
     /// <param name="device">The device data transfer object carrying the event information to be processed.</param>
     /// <returns>A task that represents the asynchronous operation, containing the resolved <see cref="Device"/> or <c>null</c> if no matching device was found.</returns>
+    /// <!-- aidoc:v1 sig=4985fb0 -->
     Task<Device?> ReceiveEvent(DeviceDto device);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IDiagnosisService.cs b/adas-core.Application/Services/Interfaces/IDiagnosisService.cs
index 362419ef..a4f6d11a 100644
--- a/adas-core.Application/Services/Interfaces/IDiagnosisService.cs
+++ b/adas-core.Application/Services/Interfaces/IDiagnosisService.cs
@@ -11,33 +11,39 @@ public interface IDiagnosisService : IApiRequestService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose diagnoses are being retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientDiagnosis"/> records for the specified patient; an empty list is returned if no diagnoses are found.</returns>
+    /// <!-- aidoc:v1 sig=002b366 -->
     Task<List<PatientDiagnosis>> GetByPatientId(ObjectId patientId);
     /// <summary>
     /// Deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Asynchronously archives the specified patient, marking the patient record as archived rather than permanently deleting it.
     /// </summary>
     /// <param name="patient">The patient to archive.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Archives the records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose records will be archived.</param>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
     /// <summary>
     /// Processes a diagnosis observation for the specified patient based on the supplied API request data.
     /// </summary>
     /// <param name="apiRequest">The API request containing the diagnosis observation payload and contextual information to process.</param>
     /// <param name="patient">The patient to whom the diagnosis observation pertains.</param>
+    /// <!-- aidoc:v1 sig=c6a1fc2 -->
     Task ProcessDiagnosisObservation(ApiRequest apiRequest, Patient patient);
     /// <summary>
     /// Persists the specified API request along with its associated patient data.
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
     /// <param name="patient">The patient associated with the API request.</param>
+    /// <!-- aidoc:v1 sig=565473c -->
     Task SaveRequest(ApiRequest apiRequest, Patient patient);
     /// <summary>
     /// Processes the provided list of patient diagnoses for the specified patient at the given message time.
@@ -45,6 +51,7 @@ public interface IDiagnosisService : IApiRequestService
     /// <param name="diagnosis">The list of patient diagnoses to be processed.</param>
     /// <param name="patient">The patient associated with the diagnoses.</param>
     /// <param name="messageTime">The timestamp of the message triggering the diagnosis processing.</param>
+    /// <!-- aidoc:v1 sig=c62208b -->
     Task ProcessDiagnosis(List<PatientDiagnosis> diagnosis, Patient patient, DateTime messageTime);
     /// <summary>
     /// Updates multiple records by replacing the <paramref name="oldId"/> with the new <paramref name="id"/> in the field identified by <paramref name="nameId"/>.
@@ -52,5 +59,6 @@ public interface IDiagnosisService : IApiRequestService
     /// <param name="nameId">The identifier of the field or property whose ObjectId values will be updated.</param>
     /// <param name="id">The new ObjectId value to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId value to be replaced in the matching records.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IDischargeService.cs b/adas-core.Application/Services/Interfaces/IDischargeService.cs
index f6eea063..e0cad345 100644
--- a/adas-core.Application/Services/Interfaces/IDischargeService.cs
+++ b/adas-core.Application/Services/Interfaces/IDischargeService.cs
@@ -14,56 +14,66 @@ public interface IDischargeService : IApiRequestService
     /// </summary>
     /// <param name="dischargeId">The unique identifier of the discharge to look up.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="Discharge"/> if found, or null when no record matches the provided identifier.</returns>
+    /// <!-- aidoc:v1 sig=5d8f706 -->
     Task<Discharge?> GetDischargeByIdAsync(ObjectId dischargeId);
     /// <summary>
     /// Asynchronously counts the number of discharge records associated with the specified unit.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose discharges should be counted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the total number of discharges for the specified unit.</returns>
+    /// <!-- aidoc:v1 sig=f2e3592 -->
     Task<long> CountDischargesByUnitId(ObjectId unitId);
     /// <summary>
     /// Asynchronously deletes a discharge record identified by the specified identifier.
     /// </summary>
     /// <param name="dischargeId">The unique identifier of the discharge to delete.</param>
+    /// <!-- aidoc:v1 sig=717b98a -->
     Task DeleteDischargeByIdAsync(ObjectId dischargeId);
     /// <summary>
     /// Asynchronously deletes the specified discharge record.
     /// </summary>
     /// <param name="discharge">The discharge entity to be removed.</param>
+    /// <!-- aidoc:v1 sig=a368605 -->
     Task DeleteDischargeAsync(Discharge discharge);
     /// <summary>
     /// Asynchronously updates an existing discharge record in the data store.
     /// </summary>
     /// <param name="discharge">The <see cref="Discharge"/> entity containing the updated information to persist.</param>
+    /// <!-- aidoc:v1 sig=5401c24 -->
     Task UpdateDischargeAsync(Discharge discharge);
     /// <summary>
     /// Asynchronously retrieves a collection of discharge records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of <see cref="Discharge"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=41d8002 -->
     Task<IEnumerable<Discharge>> GetDischargesAsync();
     /// <summary>
     /// Inserts a new discharge record into the data store. Returns the inserted <see cref="Discharge"/> entity, or <see langword="null"/> if the record could not be created.
     /// </summary>
     /// <param name="discharge">The <see cref="Discharge"/> entity containing the data to be inserted.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the inserted <see cref="Discharge"/>, or <see langword="null"/> when the insertion does not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=b5ed14b -->
     Task<Discharge?> InsertDischarge(Discharge discharge);
     /// <summary>
     /// Retrieves the discharge record associated with the specified patient location, returning null if no matching discharge is found.
     /// </summary>
     /// <param name="location">The patient location used to look up the discharge record.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Discharge"/> if found, or null if no discharge is associated with the specified location.</returns>
+    /// <!-- aidoc:v1 sig=8da289b -->
     Task<Discharge?> GetDischargeByLocation(PatientLocation location);
     /// <summary>
     /// Retrieves the discharge record associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose discharge record is being requested.</param>
     /// <returns>A <see cref="Task{Discharge}"/> that resolves to the matching <see cref="Discharge"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=baed031 -->
     Task<Discharge?> GetDischargeByPatientId(ObjectId patientId);
     /// <summary>
     /// Retrieves a discharge record associated with the specified point of care location identifier.
     /// </summary>
     /// <param name="location">The ObjectId of the point of care location used to look up the discharge.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Discharge"/> if found, or <c>null</c> if no discharge exists for the specified point of care location.</returns>
+    /// <!-- aidoc:v1 sig=fba113c -->
     Task<Discharge?> GetDischargeByPointOfCareId(ObjectId location);
     /// <summary>
     /// Retrieves the discharge associated with the specified point of care location, returning localized data for the requested locale.
@@ -72,12 +82,14 @@ public interface IDischargeService : IApiRequestService
     /// <param name="location">The identifier of the point of care location whose discharge should be retrieved.</param>
     /// <param name="dataLocale">The locale used to determine the language of the returned discharge data.</param>
     /// <returns>A task containing the matching <see cref="Discharge"/>, or null if no discharge exists for the given location.</returns>
+    /// <!-- aidoc:v1 sig=3b965d9 -->
     Task<Discharge?> GetDischargeByPointOfCareIdWithLocale(ObjectId location, LocaleEnum dataLocale);
     /// <summary>
     /// Sends a broadcast notification for the specified discharge based on the given operation type.
     /// </summary>
     /// <param name="discharge">The discharge entity to be included in the broadcast.</param>
     /// <param name="operation">The type of operation (e.g., create, update, delete) that determines the broadcast context.</param>
+    /// <!-- aidoc:v1 sig=d7c2e1f -->
     void SendDischargeBroadcast(Discharge discharge, OperationType operation);
     /// <summary>
     /// Updates a patient master list item change using the provided update options, applying the change across the specified unit list and master list type.
@@ -85,6 +97,7 @@ public interface IDischargeService : IApiRequestService
     /// <param name="opt">The update options describing the change to apply to the patient master list item.</param>
     /// <param name="unitList">The collection of units to which the master list item change should be applied.</param>
     /// <param name="typeName">The name of the master list type that identifies which list the item belongs to.</param>
+    /// <!-- aidoc:v1 sig=6d7dd8e -->
     Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList, string typeName);
     /// <summary>
     /// Deletes the specified patient master list item associated with the given option list and units.
@@ -93,10 +106,12 @@ public interface IDischargeService : IApiRequestService
     /// <param name="unitList">The collection of units associated with the item to be deleted.</param>
     /// <param name="typeName">The name of the type used to identify the patient master list item.</param>
     /// <returns>A task that represents the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=bbc71d1 -->
     Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName);
     /// <summary>
     /// Deletes discharge records associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose discharge records should be removed.</param>
+    /// <!-- aidoc:v1 sig=df1942b -->
     Task DeleteDischargesByUnitId(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IDisplayConfigService.cs b/adas-core.Application/Services/Interfaces/IDisplayConfigService.cs
index 88250a5c..330303f0 100644
--- a/adas-core.Application/Services/Interfaces/IDisplayConfigService.cs
+++ b/adas-core.Application/Services/Interfaces/IDisplayConfigService.cs
@@ -14,24 +14,28 @@ public interface IDisplayConfigService
     /// Retrieves all display configurations asynchronously.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="DisplayConfig"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=0650c45 -->
     Task<List<DisplayConfig>> GetAll();
     /// <summary>
     /// Retrieves a paginated list of display configurations in a compact (minimal) representation.
     /// </summary>
     /// <param name="request">The pagination filter that controls page size, page number, and sorting criteria.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{T}"/> with the compact display configuration entries.</returns>
+    /// <!-- aidoc:v1 sig=1dc5924 -->
     Task<PaginationResponse<DisplayConfigMinimalResponse>> GetAllCompactPaginated(PaginationFilter request);
     /// <summary>
     /// Retrieves a list of display configurations filtered by the specified display type.
     /// </summary>
     /// <param name="type">The display type used to filter the configurations.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="DisplayConfig"/> objects matching the specified type.</returns>
+    /// <!-- aidoc:v1 sig=2f20b32 -->
     Task<List<DisplayConfig>> GetByType(DisplayConfigEnums.DisplayType type);
     /// <summary>
     /// Asynchronously retrieves a <see cref="DisplayConfig"/> by its identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the display configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="DisplayConfig"/> matching the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=fad8438 -->
     Task<DisplayConfig> GetById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a <see cref="DisplayConfig"/> identified by the specified configuration identifier, unit identifier, and display type.
@@ -40,23 +44,27 @@ public interface IDisplayConfigService
     /// <param name="unitId">The identifier of the unit the display configuration belongs to.</param>
     /// <param name="displayType">The display type used to filter or scope the lookup.</param>
     /// <returns>A <see cref="Task{DisplayConfig}"/> that resolves to the matching <see cref="DisplayConfig"/>, or <c>null</c> if no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=fecb3b8 -->
     Task<DisplayConfig?> GetById(ObjectId? configId, ObjectId unitId, DisplayConfigEnums.DisplayType displayType);
     /// <summary>
     /// Inserts a single display configuration asynchronously and returns the resulting configuration, or null when no record is produced.
     /// </summary>
     /// <param name="config">The display configuration to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation, containing the inserted <see cref="DisplayConfig"/> or null.</returns>
+    /// <!-- aidoc:v1 sig=aa331a5 -->
     Task<DisplayConfig?> InsertOne(DisplayConfig config);
     /// <summary>
     /// Inserts a new display configuration in a minimal fashion and returns the created <see cref="DisplayConfig"/>, or <c>null</c> when no configuration could be produced.
     /// </summary>
     /// <param name="config">The data transfer object containing the values used to create the new display configuration.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the created <see cref="DisplayConfig"/> when successful, or <c>null</c> when no result is available.</returns>
+    /// <!-- aidoc:v1 sig=8e1aa52 -->
     Task<DisplayConfig?> InsertOneMinimal(CreateDisplayConfigDto config);
     /// <summary>
     /// Performs a test insertion operation that returns a <see cref="DisplayConfig"/> instance, used to validate insertion behavior.
     /// </summary>
     /// <returns>A <see cref="Task{DisplayConfig}"/> representing the asynchronous test insertion result.</returns>
+    /// <!-- aidoc:v1 sig=0a20de7 -->
     Task<DisplayConfig> InsertOneTest();
     /// <summary>
     /// Updates the display configuration identified by the specified identifier with the provided new configuration data.
@@ -64,6 +72,7 @@ public interface IDisplayConfigService
     /// <param name="displayConfigId">The unique identifier of the display configuration to update.</param>
     /// <param name="newDisplayConfig">The new display configuration data to apply to the existing configuration.</param>
     /// <returns>The updated <see cref="DisplayConfig"/>, or <c>null</c> if no display configuration with the specified identifier is found.</returns>
+    /// <!-- aidoc:v1 sig=aa86543 -->
     Task<DisplayConfig?> UpdateConfig(ObjectId displayConfigId, object newDisplayConfig);
     /// <summary>
     /// Updates the list of fields associated with the specified configuration display.
@@ -71,6 +80,7 @@ public interface IDisplayConfigService
     /// <param name="objectIdConfigDisplay">The identifier of the configuration display whose field list will be updated.</param>
     /// <param name="fields">The list of fields to be applied to the configuration display.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a value indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=62079e1 -->
     Task<bool> UpdateFieldList(ObjectId objectIdConfigDisplay, List<Field> fields);
     /// <summary>
     /// Updates the color configuration for the specified config display.
@@ -78,6 +88,7 @@ public interface IDisplayConfigService
     /// <param name="objectIdConfigDisplay">The identifier of the config display whose color configuration will be updated.</param>
     /// <param name="colorConfigDto">The color configuration data to apply to the config display.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=965cbeb -->
     Task<bool> UpdateConfigColor(ObjectId objectIdConfigDisplay, ColorConfig colorConfigDto);
     /// <summary>
     /// Asynchronously updates the header configuration associated with the specified config display identifier.
@@ -85,6 +96,7 @@ public interface IDisplayConfigService
     /// <param name="objectIdConfigDisplay">The identifier of the config display whose header configuration will be updated.</param>
     /// <param name="headerConfig">The new header configuration to apply.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=979f311 -->
     Task<bool> UpdateHeaderConfig(ObjectId objectIdConfigDisplay, HeaderConfig headerConfig);
     /// <summary>
     /// Updates the home banner configuration for the specified config display with the provided list of banner items.
@@ -92,12 +104,14 @@ public interface IDisplayConfigService
     /// <param name="objectIdConfigDisplay">The identifier of the config display whose home banner will be updated.</param>
     /// <param name="bannerItems">The list of banner items to set as the home banner configuration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the home banner was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a96cf5b -->
     Task<bool> UpdateSetHomeBanner(ObjectId objectIdConfigDisplay, List<BannerItem> bannerItems);
     /// <summary>
     /// Updates the base display configuration with the specified settings.
     /// </summary>
     /// <param name="baseConfig">The display configuration to apply as the new base configuration.</param>
     /// <returns>A task that represents the asynchronous update operation. The task result contains a boolean value indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=ab543ce -->
     Task<bool> UpdateBaseConfig(DisplayConfig baseConfig);
     /// <summary>
     /// Asynchronously updates the hospital name associated with the specified display configuration.
@@ -105,29 +119,34 @@ public interface IDisplayConfigService
     /// <param name="objectIdConfigDisplay">The identifier of the display configuration whose hospital name will be updated.</param>
     /// <param name="name">The new hospital name to apply to the display configuration.</param>
     /// <returns>A task that resolves to <c>true</c> if the update was applied successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=519223f -->
     Task<bool> UpdateDisplayConfigHospitalName(ObjectId objectIdConfigDisplay, string name);
     /// <summary>
     /// Deletes a display configuration identified by the specified object identifier.
     /// </summary>
     /// <param name="objectIdConfigDisplay">The unique identifier of the display configuration to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result contains a boolean value indicating whether the display configuration was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=8887abf -->
     Task<bool> DeleteDisplayConfig(ObjectId objectIdConfigDisplay);
     /// <summary>
     /// Asynchronously retrieves the default display configuration for the specified display type.
     /// </summary>
     /// <param name="type">The display type used to look up the default configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing the default <see cref="DisplayConfig"/> for the given display type, or <c>null</c> if no default configuration is available.</returns>
+    /// <!-- aidoc:v1 sig=4360847 -->
     Task<DisplayConfig?> GetDefaultConfig(DisplayConfigEnums.DisplayType type);
     /// <summary>
     /// Retrieves the list of display configuration locations associated with the specified configuration display identifier.
     /// </summary>
     /// <param name="objectIdConfigDisplay">The ObjectId of the configuration display whose locations are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of DisplayConfigLocationDto objects for the specified configuration display.</returns>
+    /// <!-- aidoc:v1 sig=38e01cc -->
     Task<List<DisplayConfigLocationDto>> GetDisplayConfigLocations(ObjectId objectIdConfigDisplay);
     /// <summary>
     /// Asynchronously retrieves all display configurations in a compact (minimal) representation.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="DisplayConfigMinimalResponse"/> objects representing the compact display configurations.</returns>
+    /// <!-- aidoc:v1 sig=784f030 -->
     Task<List<DisplayConfigMinimalResponse>> GetAllCompact();
 
     /// <summary>
@@ -137,6 +156,7 @@ public interface IDisplayConfigService
     /// <param name="configType">The type of display configuration template to use for the insertion.</param>
     /// <param name="configHospital">The optional hospital identifier used to scope the configuration; may be null when the configuration is not hospital-specific.</param>
     /// <returns>A task that represents the asynchronous operation, containing the inserted <see cref="DisplayConfig"/>, or null if the configuration could not be created.</returns>
+    /// <!-- aidoc:v1 sig=fd98439 -->
     Task<DisplayConfig?> InsertOneWithTemplate(string objectId,
             DisplayConfigEnums.DisplayType configType, string? configHospital);
 
@@ -145,17 +165,20 @@ public interface IDisplayConfigService
     /// </summary>
     /// <param name="baseConfig">The card configuration to be updated.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean value indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=a78296b -->
     Task<bool> UpdateCardConfig(CardConfig baseConfig);
     /// <summary>
     /// Inserts a new card configuration using the supplied data and returns the resulting <see cref="CardConfig"/>, or null if no card config is created.
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The DTO containing the data used to create the display config card.</param>
     /// <returns>A task that resolves to the inserted <see cref="CardConfig"/>, or null if the insert did not produce a card config.</returns>
+    /// <!-- aidoc:v1 sig=aa15ede -->
     Task<CardConfig?> InsertCardConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto);
     /// <summary>
     /// Asynchronously retrieves all card configurations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="CardConfig"/> items.</returns>
+    /// <!-- aidoc:v1 sig=c76009a -->
     Task<List<CardConfig>> GetCardConfigAll();
     /// <summary>
     /// Retrieves the card configuration associated with the specified identifier.
@@ -163,41 +186,48 @@ public interface IDisplayConfigService
     /// </summary>
     /// <param name="id">The unique identifier of the card configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="CardConfig"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=8c670e5 -->
     Task<CardConfig?> GetCardConfigById(ObjectId id);
     /// <summary>
     /// Asynchronously updates the card details configuration based on the provided base configuration.
     /// </summary>
     /// <param name="baseConfig">The base card details configuration to apply during the update.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean value indicating whether the update was successful.</returns>
+    /// <!-- aidoc:v1 sig=8e7d63d -->
     Task<bool> UpdateDetailConfig(CardDetailsConfig baseConfig);
     /// <summary>
     /// Inserts a new card detail configuration based on the provided display config data.
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The DTO containing the data required to create the card detail configuration.</param>
     /// <returns>A task that resolves to the created <see cref="CardDetailsConfig"/>, or <c>null</c> if the configuration could not be inserted.</returns>
+    /// <!-- aidoc:v1 sig=c90d7b5 -->
     Task<CardDetailsConfig?> InsertCardDetailConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto);
     /// <summary>
     /// Inserts a new chart configuration based on the provided display config card data.
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the details of the chart configuration to create.</param>
     /// <returns>A task that represents the asynchronous operation, containing the newly inserted <see cref="ChartConfig"/>, or <c>null</c> if the insertion was not successful.</returns>
+    /// <!-- aidoc:v1 sig=98c18b3 -->
     Task<ChartConfig?> InsertChartConfig(CreateDisplayConfigCardDto updateDisplayConfigNameDto);
     /// <summary>
     /// Asynchronously updates the chart configuration based on the provided base configuration and returns a value indicating whether the update was successful.
     /// </summary>
     /// <param name="baseConfig">The base chart configuration to apply during the update.</param>
     /// <returns>A task that represents the asynchronous operation. The result is <c>true</c> if the chart configuration was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=115a30f -->
     Task<bool> UpdateChartConfig(ChartConfig baseConfig);
     /// <summary>
     /// Asynchronously deletes a chart configuration identified by the specified configuration display identifier.
     /// </summary>
     /// <param name="objectIdConfigDisplay">The <see cref="ObjectId"/> of the chart configuration display to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation, containing a value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=88cfab6 -->
     Task<bool> DeleteChartConfig(ObjectId objectIdConfigDisplay);
     /// <summary>
     /// Asynchronously retrieves the chart configuration associated with the specified chart identifier.
     /// </summary>
     /// <param name="objectIdConfigChart">The unique identifier of the chart whose configuration should be fetched.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ChartConfig"/> associated with the provided identifier, or <c>null</c> if no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=15bc45a -->
     Task<ChartConfig?> GetChartConfig(ObjectId objectIdConfigChart);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IDisplayService.cs b/adas-core.Application/Services/Interfaces/IDisplayService.cs
index b52404f1..93db9017 100644
--- a/adas-core.Application/Services/Interfaces/IDisplayService.cs
+++ b/adas-core.Application/Services/Interfaces/IDisplayService.cs
@@ -16,6 +16,7 @@ public interface IDisplayService
     /// Asynchronously retrieves all displays in a compact format containing only minimal identifying information.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="DisplayMinimalDto"/> objects representing all available displays in a compact projection.</returns>
+    /// <!-- aidoc:v1 sig=05ec358 -->
     Task<List<DisplayMinimalDto>> GetAllCompact();
     /// <summary>
     /// Retrieves all displays along with their associated permissions for the specified user.
@@ -23,30 +24,35 @@ public interface IDisplayService
     /// </summary>
     /// <param name="userName">The username used to look up the associated displays and permissions. May be null.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="DisplayWithPermissionsDto"/> entries for the user.</returns>
+    /// <!-- aidoc:v1 sig=970fb6e -->
     Task<List<DisplayWithPermissionsDto>> GetAllByUser(string? userName);
     /// <summary>
     /// Asynchronously retrieves a list of <see cref="Display"/> entries filtered by the specified display type.
     /// </summary>
     /// <param name="type">The display type used to filter the returned collection.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Display"/> items matching the specified type.</returns>
+    /// <!-- aidoc:v1 sig=257ad89 -->
     Task<List<Display>> GetByType(DisplayConfigEnums.DisplayType type);
     /// <summary>
     /// Asynchronously retrieves the list of displays associated with the specified point of care.
     /// </summary>
     /// <param name="pointOfCare">The point of care used to filter the displays to be returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Display"/> items linked to the given point of care.</returns>
+    /// <!-- aidoc:v1 sig=04ec30c -->
     Task<List<Display>> GetByPointOfCare(PointOfCare pointOfCare);
     /// <summary>
     /// Retrieves a list of displays associated with the specified configuration identifier.
     /// </summary>
     /// <param name="configId">The unique identifier of the configuration used to filter the displays.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of displays matching the specified configuration identifier.</returns>
+    /// <!-- aidoc:v1 sig=b59323e -->
     Task<List<Display>> GetByConfigId(ObjectId configId);
     /// <summary>
     /// Retrieves a list of <see cref="Display"/> entities associated with the specified card configuration identifier.
     /// </summary>
     /// <param name="configId">The unique identifier of the card configuration whose associated displays are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Display"/> objects linked to the given card configuration.</returns>
+    /// <!-- aidoc:v1 sig=7885fbb -->
     Task<List<Display>> GetByCardConfigId(ObjectId configId);
 
     // Task<List<Display>> GetByUser();
@@ -56,12 +62,14 @@ public interface IDisplayService
     /// </summary>
     /// <param name="name">The name of the display to look up.</param>
     /// <returns>A <see cref="Task{Display}"/> that resolves to the matching <see cref="Display"/>, or <c>null</c> if none is found.</returns>
+    /// <!-- aidoc:v1 sig=02f4c9c -->
     Task<Display?> GetByName(string name);
     /// <summary>
     /// Retrieves a <see cref="Display"/> entity by its unique identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the display to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Display"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=3467c35 -->
     Task<Display?> GetById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a display representation of an entity along with its associated permissions, localized for the specified locale.
@@ -69,12 +77,14 @@ public interface IDisplayService
     /// <param name="id">The unique identifier of the entity to retrieve.</param>
     /// <param name="localeEnum">The locale used to localize the returned display data.</param>
     /// <returns>A task that represents the asynchronous operation, containing the localized display data with permissions.</returns>
+    /// <!-- aidoc:v1 sig=22adc98 -->
     Task<DisplayWithPermissionsDto> GetByIdWithPermissions(ObjectId id, LocaleEnum localeEnum);
     /// <summary>
     /// Asynchronously counts the number of displays associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose displays should be counted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the count of displays linked to the specified unit.</returns>
+    /// <!-- aidoc:v1 sig=c09d0d4 -->
     Task<long> CountDisplaysByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -90,6 +100,7 @@ public interface IDisplayService
     /// <param name="fillDisplayConfig">When <c>true</c>, includes the display configuration in the result.</param>
     /// <param name="ct">Token used to cancel the asynchronous operation.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the <see cref="Display"/> if found, or <c>null</c> if no display matches the specified <paramref name="id"/>.</returns>
+    /// <!-- aidoc:v1 sig=04117d6 -->
     Task<Display?> GetInfo(
             ObjectId id,
             string? userName,
@@ -111,6 +122,7 @@ public interface IDisplayService
     /// <param name="userName">The user name used to resolve user-specific sections, or <c>null</c> if not applicable.</param>
     /// <param name="authorizations">The list of authorizations used to authorize and filter the returned sections, or <c>null</c> if no authorization filtering is required.</param>
     /// <returns>A task that yields the list of <see cref="MinimalDisplaySection"/> instances matching the supplied criteria.</returns>
+    /// <!-- aidoc:v1 sig=1bea901 -->
     Task<List<MinimalDisplaySection>> GetDisplaySectionByUser(
             DisplayConfigEnums.DisplayType type,
             ObjectId? currentDisplay,
@@ -121,12 +133,14 @@ public interface IDisplayService
     /// Asynchronously retrieves all display sections as a minimal display list.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="MinimalDisplayListDto"/> with the display section data.</returns>
+    /// <!-- aidoc:v1 sig=a8be7f7 -->
     Task<MinimalDisplayListDto> GetAllDisplaySection();
     /// <summary>
     /// Retrieves a list of <see cref="Display"/> records associated with the specified unit identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> that identifies the unit whose displays are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="List{Display}"/> of displays linked to the given unit.</returns>
+    /// <!-- aidoc:v1 sig=a786839 -->
     Task<List<Display>> GetByUnitId(ObjectId id);
     /// <summary>
     /// Retrieves all available Points of Contact (POCs) along with their associated unit information, optionally filtered by the provided display identifiers and allowing exclusion of virtual entries.
@@ -134,23 +148,27 @@ public interface IDisplayService
     /// <param name="displayIds">The list of display identifiers used to filter the available POCs.</param>
     /// <param name="excludeVirtual">When set to <c>true</c>, excludes virtual POCs from the results; otherwise, virtual POCs are included.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PocAndUnitDto"/> with the matching POCs and their unit details.</returns>
+    /// <!-- aidoc:v1 sig=1142e26 -->
     Task<PocAndUnitDto> GetAllAvailablePoc(List<string> displayIds, bool excludeVirtual = false);
     /// <summary>
     /// Asynchronously retrieves all Points of Care (POCs) associated with the specified display identifier.
     /// </summary>
     /// <param name="id">The display identifier used to look up the associated Points of Care.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of Points of Care matching the specified display identifier.</returns>
+    /// <!-- aidoc:v1 sig=9c3ab00 -->
     Task<List<PointOfCare>> GetAllPocsByDisplayId(ObjectId id);
     /// <summary>
     /// Inserts a new display record into the data store and returns the persisted entity.
     /// </summary>
     /// <param name="display">The display entity to insert.</param>
     /// <returns>A task that represents the asynchronous operation, containing the inserted <see cref="Display"/>.</returns>
+    /// <!-- aidoc:v1 sig=333acbc -->
     Task<Display> InsertOne(Display display);
     /// <summary>
     /// Asynchronously inserts a single test <see cref="Display"/> record and returns the persisted result.
     /// </summary>
     /// <returns>A <see cref="Task{Display}"/> that represents the asynchronous insert operation, containing the inserted <see cref="Display"/>.</returns>
+    /// <!-- aidoc:v1 sig=eba6c71 -->
     Task<Display> InsertOneTest();
     /// <summary>
     /// Updates the configuration of an existing display using the provided new configuration.
@@ -158,6 +176,7 @@ public interface IDisplayService
     /// <param name="oldDisplay">The current display whose configuration will be updated.</param>
     /// <param name="newDisplayConfig">The new display configuration to apply, or null to leave the configuration unchanged.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Display"/>, or null if the update was not performed.</returns>
+    /// <!-- aidoc:v1 sig=d4b8ee5 -->
     Task<Display?> UpdateConfig(Display oldDisplay, DisplayConfig? newDisplayConfig);
     /// <summary>
     /// Updates the configuration identifier associated with the specified display.
@@ -165,6 +184,7 @@ public interface IDisplayService
     /// <param name="oldDisplay">The existing display whose configuration identifier will be updated.</param>
     /// <param name="configId">The new configuration identifier to associate with the display.</param>
     /// <returns>A task that resolves to the updated <see cref="Display"/>, or <c>null</c> if no result is available.</returns>
+    /// <!-- aidoc:v1 sig=8265f8f -->
     Task<Display?> UpdateConfigId(Display oldDisplay, ObjectId configId);
     /// <summary>
     /// Updates the point of care list associated with the specified object identifier, replacing or merging it with the provided list of point of care object identifiers.
@@ -172,6 +192,7 @@ public interface IDisplayService
     /// <param name="objectId">The identifier of the object whose point of care list is being updated.</param>
     /// <param name="listPocObId">The collection of point of care object identifiers to apply to the target object.</param>
     /// <returns>A task that represents the asynchronous operation, containing the resulting <see cref="Display"/> when the update succeeds, or <c>null</c> when no matching object is found.</returns>
+    /// <!-- aidoc:v1 sig=48f0e68 -->
     Task<Display?> UpdatePointOfCareList(ObjectId objectId, List<ObjectId> listPocObId);
     /// <summary>
     /// Updates the configuration preset associated with the specified display using the provided configuration display.
@@ -179,6 +200,7 @@ public interface IDisplayService
     /// <param name="objectIdDisplay">The unique identifier of the display whose configuration preset will be updated.</param>
     /// <param name="objectIdConfigDisplay">The unique identifier of the configuration display to apply as the preset.</param>
     /// <returns>A task that resolves to the updated <see cref="Display"/>, or <c>null</c> if no matching display is found.</returns>
+    /// <!-- aidoc:v1 sig=6061a62 -->
     Task<Display?> UpdateConfigPreset(ObjectId objectIdDisplay, ObjectId objectIdConfigDisplay);
     /// <summary>
     /// Updates the name of the entity identified by the given identifier and returns the resulting <see cref="Display"/>.
@@ -186,34 +208,40 @@ public interface IDisplayService
     /// <param name="id">The identifier of the entity whose name should be updated.</param>
     /// <param name="name">The new name to apply to the entity.</param>
     /// <returns>A task that represents the asynchronous update operation, containing the updated <see cref="Display"/> or <c>null</c> if no entity was found.</returns>
+    /// <!-- aidoc:v1 sig=67bb64c -->
     Task<Display?> UpdateName(ObjectId id, string name);
     /// <summary>
     /// Retrieves a paginated collection of displays based on the provided filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the page size, page number, and any additional filtering criteria for the display results.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{Display}"/> with the requested page of displays and pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=847a84e -->
     Task<PaginationResponse<Display>> GetPaginatedDisplays(PaginationFilter filter);
     /// <summary>
     /// Asynchronously deletes the display identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the display to delete.</param>
     /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the display was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=5bb6263 -->
     Task<bool> DeleteDisplay(ObjectId id);
     /// <summary>
     /// Retrieves the list of display configuration locations associated with the specified display configuration.
     /// </summary>
     /// <param name="displayConfigId">The unique identifier of the display configuration whose locations are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="DisplayConfigLocationDto"/> objects for the specified display configuration.</returns>
+    /// <!-- aidoc:v1 sig=89491e6 -->
     Task<List<DisplayConfigLocationDto>> GetDisplayConfigLocations(ObjectId displayConfigId);
     /// <summary>
     /// Asynchronously determines whether the specified display configuration is currently in use.
     /// </summary>
     /// <param name="displayConfigId">The identifier of the display configuration to check.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the display configuration is in use; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=387c518 -->
     Task<bool> IsDisplayConfigInUse(ObjectId displayConfigId);
     /// <summary>
     /// Deletes display records associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose displays should be removed.</param>
+    /// <!-- aidoc:v1 sig=6bb1d75 -->
     Task DeleteDisplaysByUnitId(ObjectId unitId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IFileService.cs b/adas-core.Application/Services/Interfaces/IFileService.cs
index a4289992..b2b11f19 100644
--- a/adas-core.Application/Services/Interfaces/IFileService.cs
+++ b/adas-core.Application/Services/Interfaces/IFileService.cs
@@ -13,6 +13,7 @@ public interface IFileService
     /// </summary>
     /// <param name="files">The collection of update files to be copied.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a boolean value indicating whether the copy operation succeeded.</returns>
+    /// <!-- aidoc:v1 sig=53643ff -->
     Task<bool> CopyUpdateFiles(ICollection<IFormFile> files);
     /// <summary>
     /// Uploads the provided asset files categorized by the specified theme, returning a value indicating whether the operation completed successfully.
@@ -20,12 +21,14 @@ public interface IFileService
     /// <param name="files">The collection of uploaded form files to process and store as assets.</param>
     /// <param name="themeParse">The asset theme used to classify and organize the uploaded files.</param>
     /// <returns>A task that resolves to <c>true</c> if the asset files were uploaded successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1b9d2d8 -->
     Task<bool> UploadAssetFiles(ICollection<IFormFile> files, FileEnum.AssetTheme themeParse);
     /// <summary>
     /// Retrieves all asset files for the specified asset theme as a list of asset data transfer objects.
     /// </summary>
     /// <param name="themeParse">The asset theme used to retrieve the corresponding assets.</param>
     /// <returns>A <see cref="List{AssetDto}"/> containing the asset data transfer objects for the specified theme.</returns>
+    /// <!-- aidoc:v1 sig=26bd29d -->
     List<AssetDto> GetAllAssetFile(FileEnum.AssetTheme themeParse);
 
     /// <summary>
@@ -33,5 +36,6 @@ public interface IFileService
     /// </summary>
     /// <param name="directoryPath">The path of the directory from which to retrieve the files.</param>
     /// <returns>A list of strings representing the names of the files in the specified directory.</returns>
+    /// <!-- aidoc:v1 sig=491d1e8 -->
     List<string> GetFilesInDirectory(string directoryPath);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IGroupedObservationService.cs b/adas-core.Application/Services/Interfaces/IGroupedObservationService.cs
index 8b7d2423..0484103c 100644
--- a/adas-core.Application/Services/Interfaces/IGroupedObservationService.cs
+++ b/adas-core.Application/Services/Interfaces/IGroupedObservationService.cs
@@ -16,6 +16,8 @@ public interface IGroupedObservationService
     /// <param name="cacheIsChecked">Indicates whether the cache should be consulted before generating the result. Defaults to <c>false</c>.</param>
     /// <param name="ct">The cancellation token used to cancel the operation.</param>
     /// <returns>A task that represents the asynchronous generation, producing the resulting <see cref="GroupedObservation"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_param_role
+    ///      "Documented default value for timeZoneId has a typo: 'Romence Standard Time' should be 'Romance Standard Time' to match the code" -->
     Task<GroupedObservation> GenerateGroupedObservation(ObjectId id, GroupedField groupedField,
             string timeZoneId = "Romance Standard Time", bool cacheIsChecked = false, CancellationToken ct = default);
 
@@ -30,6 +32,7 @@ public interface IGroupedObservationService
     /// <param name="obs">The patient observation to be processed and grouped.</param>
     /// <param name="timeZoneId">The time zone identifier used when computing date and time values for the grouped observation. Defaults to "Romance Standard Time".</param>
     /// <returns>A <see cref="Task{GroupedObservation}"/> that resolves to the generated grouped observation for the patient.</returns>
+    /// <!-- aidoc:v1 sig=3672d15 -->
     Task<GroupedObservation> GenerateGroupedObservation(ObjectId obsPatientId, GroupedField groupedField,
             List<GroupedObservation.GroupedObservationObs> wsgLastGroupedObservationObs, PatientObservation obs,
             string timeZoneId = "Romance Standard Time");
@@ -41,6 +44,7 @@ public interface IGroupedObservationService
     /// <param name="num">The maximum number of recent observations to return. Defaults to 2.</param>
     /// <param name="filterObservations">An optional list of observation names to include; if null, all observation types are considered.</param>
     /// <returns>A task that resolves to a list of the most recent <see cref="PatientObservation"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=40372b5 -->
     Task<List<PatientObservation>> FindLastObservations(ObjectId patientId, int num = 2,
             List<string>? filterObservations = null);
 
@@ -49,6 +53,7 @@ public interface IGroupedObservationService
     /// </summary>
     /// <param name="ws">The grouped web service subscriber for which the next empty observation is created.</param>
     /// <returns>A task that represents the asynchronous operation, containing the newly created <see cref="GroupedObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=d148522 -->
     Task<GroupedObservation> CreateNextEmptyObs(WsSubscriberGrouped ws);
     /*
      *
diff --git a/adas-core.Application/Services/Interfaces/IHistoricalConfigChangesService.cs b/adas-core.Application/Services/Interfaces/IHistoricalConfigChangesService.cs
index d8c16c78..178b5bec 100644
--- a/adas-core.Application/Services/Interfaces/IHistoricalConfigChangesService.cs
+++ b/adas-core.Application/Services/Interfaces/IHistoricalConfigChangesService.cs
@@ -10,6 +10,7 @@ public interface IHistoricalConfigChangesService
     /// Asynchronously retrieves all historical configuration changes recorded in the system.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of all <see cref="HistoricalConfigChanges"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=89e2dae -->
     Task<ICollection<HistoricalConfigChanges>> GetAll();
     /// <summary>
     /// Asynchronously retrieves a historical configuration change entry by its unique identifier.
@@ -17,6 +18,7 @@ public interface IHistoricalConfigChangesService
     /// </summary>
     /// <param name="id">The unique identifier of the historical configuration change to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="HistoricalConfigChanges"/> or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=4bce1e5 -->
     Task<HistoricalConfigChanges?> Get(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a collection of historical configuration changes filtered by the specified configuration type.
@@ -24,6 +26,7 @@ public interface IHistoricalConfigChangesService
     /// <param name="type">The configuration type used to filter the historical changes.</param>
     /// <param name="num">The maximum number of historical change records to return.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="HistoricalConfigChanges"/> for the specified type.</returns>
+    /// <!-- aidoc:v1 sig=984ce5a -->
     Task<ICollection<HistoricalConfigChanges>> GetByType(DisplayConfigEnums.ConfigTypes type, int num);
 
     /// <summary>
@@ -34,6 +37,7 @@ public interface IHistoricalConfigChangesService
     /// <param name="configTypes">The optional configuration type used to filter the results; if null, changes for all configuration types are returned.</param>
     /// <param name="num">The maximum number of historical configuration change records to return.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of historical configuration changes matching the specified criteria.</returns>
+    /// <!-- aidoc:v1 sig=ceca012 -->
     Task<ICollection<HistoricalConfigChanges>> GetByUser(string user, DisplayConfigEnums.ConfigTypes? configTypes,
             int num);
 
@@ -43,6 +47,7 @@ public interface IHistoricalConfigChangesService
     /// </summary>
     /// <param name="configTypes">The configuration type used to look up the most recent historical changes.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the last <see cref="HistoricalConfigChanges"/> for the specified type, or null if no changes are available.</returns>
+    /// <!-- aidoc:v1 sig=899c410 -->
     Task<HistoricalConfigChanges?> FindLastConfigChanges(DisplayConfigEnums.ConfigTypes configTypes);
 
 
@@ -52,18 +57,21 @@ public interface IHistoricalConfigChangesService
     /// </summary>
     /// <param name="historicalConfigChanges">The historical configuration change entity to be inserted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the inserted <see cref="HistoricalConfigChanges"/> entity, or null if the insertion did not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=ae5c68c -->
     Task<HistoricalConfigChanges?> InsertOne(HistoricalConfigChanges historicalConfigChanges);
     /// <summary>
     /// Updates an existing historical configuration change record with the provided data and returns the updated entity.
     /// </summary>
     /// <param name="historicalConfigChanges">The historical configuration change entity containing the updated values to be persisted.</param>
     /// <returns>A task that resolves to the updated <see cref="HistoricalConfigChanges"/>, or <c>null</c> if the record was not found.</returns>
+    /// <!-- aidoc:v1 sig=f875ebb -->
     Task<HistoricalConfigChanges?> UpdateHistoricalConfigChange(HistoricalConfigChanges historicalConfigChanges);
 
     /// <summary>
     /// Deletes a historical configuration change identified by the specified identifier.
     /// </summary>
     /// <param name="id">The identifier of the historical configuration change to delete.</param>
+    /// <!-- aidoc:v1 sig=b0535af -->
     Task DeleteHistoricalConfigChange(ObjectId id);
 
     /// <summary>
@@ -73,5 +81,6 @@ public interface IHistoricalConfigChangesService
     /// <param name="configType">The type of configuration that was changed.</param>
     /// <param name="newConfig">The new configuration value after the change.</param>
     /// <param name="oldConfig">The previous configuration value before the change.</param>
+    /// <!-- aidoc:v1 sig=6dd04c6 -->
     Task LogConfigChanged(string user, DisplayConfigEnums.ConfigTypes configType, string newConfig, string oldConfig);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ILightBeaconService.cs b/adas-core.Application/Services/Interfaces/ILightBeaconService.cs
index acc6bba0..38889167 100644
--- a/adas-core.Application/Services/Interfaces/ILightBeaconService.cs
+++ b/adas-core.Application/Services/Interfaces/ILightBeaconService.cs
@@ -14,6 +14,7 @@ public interface ILightBeaconService
     /// </summary>
     /// <param name="pocId">The identifier of the point of control that targets the light beacon.</param>
     /// <param name="color">The color to apply to the light beacon.</param>
+    /// <!-- aidoc:v1 sig=4279fa1 -->
     Task SendColor(ObjectId pocId, LightBeaconColor color);
     /// <summary>
     /// Sends a color command to the light beacon of the specified point of care device,
@@ -22,34 +23,41 @@ public interface ILightBeaconService
     /// <param name="pocId">The identifier of the point of care device whose light beacon will be updated.</param>
     /// <param name="color">The color to apply to the light beacon.</param>
     /// <returns>A task that represents the asynchronous color send operation.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "pocId is documented as 'The identifier of the point of care device' but the parameter type is PointOfCare, a full object, not an identifier." -->
     Task SendColor(PointOfCare pocId, LightBeaconColor color);
     /// <summary>
     /// Sends a light beacon broadcast for the specified point of care, setting the beacon to display the specified color.
     /// </summary>
     /// <param name="poc">The point of care device or location whose beacon will be updated.</param>
     /// <param name="color">The color to display on the light beacon.</param>
+    /// <!-- aidoc:v1 sig=7a336c8 -->
     Task SendBeaconBroadcast(PointOfCare poc, LightBeaconColor color);
     /// <summary>
     /// Sends a broadcast signal to the beacon associated with the specified point of care identifier using the given beacon color.
     /// </summary>
     /// <param name="poc">The identifier of the point of care (or beacon) that will receive the broadcast.</param>
     /// <param name="color">The color of the light beacon used for the broadcast.</param>
+    /// <!-- aidoc:v1 sig=4fec682 -->
     Task SendBeaconBroadcast(ObjectId poc, LightBeaconColor color);
     /// <summary>
     /// Asynchronously powers off the LED associated with the specified point of connection identifier.
     /// </summary>
     /// <param name="pocId">The identifier of the point of connection whose LED will be turned off.</param>
+    /// <!-- aidoc:v1 sig=bde6341 -->
     Task PowerOffLed(ObjectId pocId);
     /// <summary>
     /// Asynchronously powers off the LED indicator associated with the specified point of care.
     /// </summary>
     /// <param name="poc">The point of care whose LED indicator should be turned off.</param>
+    /// <!-- aidoc:v1 sig=ce5eefc -->
     Task PowerOffLed(PointOfCare poc);
 
     /// <summary>
     /// Generates a color-coded alert based on the provided patient observation.
     /// </summary>
     /// <param name="obs">The patient observation used to determine the alert level and color.</param>
+    /// <!-- aidoc:v1 sig=5f77447 -->
     void GenerateColorAlert(PatientObservation obs);
 
     //TODO refactor, one patient can have multiple beacons
@@ -58,12 +66,14 @@ public interface ILightBeaconService
     /// </summary>
     /// <param name="pocId">The identifier of the point of care whose light beacon color is being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="LightBeaconColor"/> for the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=0f47559 -->
     public Task<LightBeaconColor> GetColor(ObjectId pocId);
     /// <summary>
     /// Asynchronously retrieves the light beacon color associated with the specified point of care.
     /// </summary>
     /// <param name="poc">The point of care for which to look up the light beacon color.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="LightBeaconColor"/> for the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=2bcbc4b -->
     public Task<LightBeaconColor> GetColor(PointOfCare poc);
     /// <summary>
     /// Updates a single light beacon record in the data store.
@@ -71,23 +81,27 @@ public interface ILightBeaconService
     /// </summary>
     /// <param name="beacon">The light beacon containing the updated values to persist.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="LightBeacon"/>, or <see langword="null"/> if no matching beacon was found.</returns>
+    /// <!-- aidoc:v1 sig=dea8894 -->
     Task<LightBeacon?> UpdateOne(LightBeacon beacon);
     /// <summary>
     /// Inserts a single light beacon into the data store.
     /// </summary>
     /// <param name="beacon">The light beacon entity to insert.</param>
     /// <returns>A task that resolves to the inserted <see cref="LightBeacon"/>, or <c>null</c> when no result is produced.</returns>
+    /// <!-- aidoc:v1 sig=e90c40d -->
     Task<LightBeacon?> InsertOne(LightBeacon beacon);
     /// <summary>
     /// Asynchronously retrieves a paginated collection of light beacons based on the specified pagination filter.
     /// </summary>
     /// <param name="request">The pagination filter containing the criteria used to page the beacon results.</param>
     /// <returns>A task that represents the asynchronous operation, containing a pagination response with the requested light beacons.</returns>
+    /// <!-- aidoc:v1 sig=91c5832 -->
     Task<PaginationResponse<LightBeacon>> GetPaginatedBeacons(PaginationFilter request);
     /// <summary>
     /// Asynchronously searches for light beacons by name using the specified search text.
     /// </summary>
     /// <param name="textToSearch">The text used to search for matching light beacons by name.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="LightBeacon"/> objects matching the search criteria.</returns>
+    /// <!-- aidoc:v1 sig=2c88e45 -->
     Task<List<LightBeacon>> GetSearchByName(string textToSearch);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ILocalAuditService.cs b/adas-core.Application/Services/Interfaces/ILocalAuditService.cs
index d9e36dbd..4a91ff80 100644
--- a/adas-core.Application/Services/Interfaces/ILocalAuditService.cs
+++ b/adas-core.Application/Services/Interfaces/ILocalAuditService.cs
@@ -12,11 +12,13 @@ public interface ILocalAuditService
     /// <param name="dataModified">The modified state of the data after the change. May be null when the action deletes an existing record.</param>
     /// <param name="reason">An optional explanation or justification for the change. Defaults to null when no reason is provided.</param>
     /// <returns>A task that represents the asynchronous creation of the audit log entry.</returns>
+    /// <!-- aidoc:v1 sig=f137579 -->
     Task CreateAuditLogAsync(ClaimsPrincipal? user, object? dataOriginal, object? dataModified, string? reason = null);
     /// <summary>
     /// Asynchronously creates a deep copy of the specified data, producing a new independent instance of the same type.
     /// </summary>
     /// <param name="data">The data instance to be deep copied.</param>
     /// <returns>A task that represents the asynchronous operation, containing the deep-copied instance of type <typeparamref name="T"/>, or <c>null</c> if the copy could not be produced.</returns>
+    /// <!-- aidoc:v1 sig=a6d959a -->
     Task<T?> DeepCopyAsync<T>(T data);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ILockProvider.cs b/adas-core.Application/Services/Interfaces/ILockProvider.cs
index 18f310ed..3b815a25 100644
--- a/adas-core.Application/Services/Interfaces/ILockProvider.cs
+++ b/adas-core.Application/Services/Interfaces/ILockProvider.cs
@@ -10,11 +10,14 @@
         /// <summary>
         /// Intenta adquirir el lock para una clave dentro del timeout.
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+        ///      "The method returns Task<bool> indicating whether the lock was acquired, but the documentation does not describe the return value." -->
         Task<bool> AcquireAsync(string key, TimeSpan timeout);
 
         /// <summary>
         /// Libera el lock para la clave (idempotente).
         /// </summary>
+        /// <!-- aidoc:v1 sig=5956b6c -->
         Task ReleaseAsync(string key);
     }
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IMasterListService.cs b/adas-core.Application/Services/Interfaces/IMasterListService.cs
index 2023a50d..f79d28c9 100644
--- a/adas-core.Application/Services/Interfaces/IMasterListService.cs
+++ b/adas-core.Application/Services/Interfaces/IMasterListService.cs
@@ -13,17 +13,20 @@ public interface IMasterListService<T> where T : MasterList
     /// Asynchronously retrieves the complete master list of items of type <typeparamref name="T"/>.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{T}"/> with all items from the master list.</returns>
+    /// <!-- aidoc:v1 sig=bbf098e -->
     Task<IEnumerable<T>> GetAllMasterList();
     /// <summary>
     /// Retrieves all master list entries, excluding items categorized as options.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="MasterListDto"/> items representing the master list without options.</returns>
+    /// <!-- aidoc:v1 sig=53f27dd -->
     Task<IEnumerable<MasterListDto>> GetAllMasterListWithoutOptions();
     /// <summary>
     /// Retrieves a paginated collection of master list items with their associated options based on the specified pagination filter.
     /// </summary>
     /// <param name="request">The pagination filter containing paging criteria such as page number and page size.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of <see cref="MasterListWithPaginatedOptionsDto"/> items for the requested page.</returns>
+    /// <!-- aidoc:v1 sig=576fdd0 -->
     Task<IEnumerable<MasterListWithPaginatedOptionsDto>> GetAllMasterListWithPaginatedOptions(PaginationFilter request);
     /// <summary>
     /// Retrieves a master list entry identified by the specified <paramref name="id"/>, optionally resolving localized content based on the provided <paramref name="locale"/>. Returns <c>null</c> when no matching entry is found.
@@ -31,6 +34,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The unique identifier of the master list entry to retrieve.</param>
     /// <param name="locale">The optional locale used to resolve localized fields; when <c>null</c>, a default or non-localized representation is returned.</param>
     /// <returns>A task that resolves to the matching master list entry of type <typeparamref name="T"/>, or <c>null</c> if the entry does not exist.</returns>
+    /// <!-- aidoc:v1 sig=fab0bce -->
     Task<T?> GetMasterListById(ObjectId id, LocaleEnum? locale);
 
     /// <summary>
@@ -40,6 +44,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The unique identifier of the master list to retrieve.</param>
     /// <param name="request">The pagination filter used to control the paginated options returned with the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="MasterListWithPaginatedOptionsDto"/> if a matching master list is found, otherwise null.</returns>
+    /// <!-- aidoc:v1 sig=46550b5 -->
     Task<MasterListWithPaginatedOptionsDto?> GetMasterListByIdWithPaginatedOptions(ObjectId id,
             PaginationFilter request);
 
@@ -48,6 +53,7 @@ public interface IMasterListService<T> where T : MasterList
     /// </summary>
     /// <param name="id">The unique identifier of the master list whose option names are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of option names for the specified master list.</returns>
+    /// <!-- aidoc:v1 sig=5b1bec6 -->
     Task<List<string>> GetMasterListOptionsNamesById(ObjectId id);
     /// <summary>
     /// Retrieves a master list of <see cref="OptionList"/> entries filtered by the specified identifier and an optional text search criterion.
@@ -55,6 +61,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The unique identifier used to scope the master list lookup.</param>
     /// <param name="textSearch">An optional text string used to further filter the results; may be <c>null</c> to return all matching entries.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="OptionList"/> items matching the provided identifier and text search.</returns>
+    /// <!-- aidoc:v1 sig=b1e3b91 -->
     Task<List<OptionList>> GetMasterListByIdAndTextSearch(ObjectId id, string? textSearch);
     /// <summary>
     /// Asynchronously retrieves a master list of options associated with the specified identifier, applying the provided search and filter criteria.
@@ -62,29 +69,34 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The identifier used to locate the master list to retrieve.</param>
     /// <param name="filterOption">The filter and search options used to refine the returned list.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="OptionList"/> entries that match the specified id and filter options.</returns>
+    /// <!-- aidoc:v1 sig=74ffbb0 -->
     Task<List<OptionList>> GetMasterListByIdAndSearchOptions(ObjectId id, FilterOptionListElement filterOption);
     /// <summary>
     /// Asynchronously retrieves a master list that matches the specified name.
     /// </summary>
     /// <param name="name">The name used to look up the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The result is the matching master list of type <typeparamref name="T"/>, or <c>null</c> if no master list with the specified name is found.</returns>
+    /// <!-- aidoc:v1 sig=f88b34e -->
     Task<T?> GetMasterListByName(string name);
     /// <summary>
     /// Inserts the specified item into the master list and returns the resulting entry, or <c>null</c> if the operation did not produce a result.
     /// </summary>
     /// <param name="item">The item to insert into the master list.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the inserted item, or <c>null</c> when no result is available.</returns>
+    /// <!-- aidoc:v1 sig=56ebb96 -->
     Task<T?> InsertMasterList(T item);
     /// <summary>
     /// Updates the master list with the specified item.
     /// </summary>
     /// <param name="item">The item to be updated in the master list.</param>
     /// <returns>A task that represents the asynchronous update operation, containing the updated item or <c>null</c> if the update could not be performed.</returns>
+    /// <!-- aidoc:v1 sig=4dd0c3c -->
     Task<T?> UpdateMasterList(T item);
     /// <summary>
     /// Deletes a master list identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the master list to delete.</param>
+    /// <!-- aidoc:v1 sig=5af7c2c -->
     Task DeleteMasterListById(ObjectId id);
     /// <summary>
     /// Adds the specified option element to the master option list identified by the given identifier.
@@ -92,6 +104,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The unique identifier of the master option list to which the option will be added.</param>
     /// <param name="opt">The filter option list element to append to the master list.</param>
     /// <returns>A task that returns the updated <see cref="OptionList"/>, or <c>null</c> if the master list could not be found.</returns>
+    /// <!-- aidoc:v1 sig=07eea1e -->
     Task<OptionList?> AddOptionToMasterList(ObjectId id, FilterOptionListElement opt);
     /// <summary>
     /// Updates an option in a master list, localized for the specified locale, and returns the updated option list.
@@ -101,6 +114,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="typeName">The name of the master list type that owns the option.</param>
     /// <param name="locale">The locale used to resolve or apply localized values.</param>
     /// <returns>A task that returns the updated <see cref="OptionList"/>, or <c>null</c> if the option could not be found.</returns>
+    /// <!-- aidoc:v1 sig=cda7ccb -->
     Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList opt, string typeName, LocaleEnum locale);
     /// <summary>
     /// Updates the full master list option identified by the specified identifier and type name.
@@ -109,6 +123,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="opt">The option list containing the updated values.</param>
     /// <param name="typeName">The name of the type associated with the master list option.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="OptionList"/>, or <c>null</c> if the option was not found.</returns>
+    /// <!-- aidoc:v1 sig=6aed753 -->
     Task<OptionList?> UpdateFullMasterListOption(ObjectId id, OptionList opt, string typeName);
     /// <summary>
     /// Updates a master list option for the specified type with the provided option data.
@@ -117,6 +132,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="opt">The option data to apply to the master list.</param>
     /// <param name="typeName">The name of the master list type containing the option.</param>
     /// <returns>The updated <see cref="OptionList"/>, or null if the option is not found.</returns>
+    /// <!-- aidoc:v1 sig=11de0a9 -->
     Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList opt, string typeName);
     /// <summary>
     /// Asynchronously retrieves an option list item identified by the specified master ID, option ID, and locale.
@@ -125,6 +141,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="optionId">The identifier of the specific option item to find.</param>
     /// <param name="locale">The locale used to retrieve the localized option item.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="OptionList"/> or <c>null</c> if no item is found.</returns>
+    /// <!-- aidoc:v1 sig=353f501 -->
     Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId, LocaleEnum locale);
     /// <summary>
     /// Updates the option details of a master list entry identified by the specified id.
@@ -132,6 +149,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The identifier of the master list entry to update.</param>
     /// <param name="opt">The master list details to apply to the entry.</param>
     /// <returns>A task that returns the updated master list details, or null if no matching entry is found.</returns>
+    /// <!-- aidoc:v1 sig=1d0803c -->
     Task<UpdateMasterListDetailsDto?> UpdateOptionDetailsToMasterList(ObjectId id, UpdateMasterListDetailsDto opt);
     /// <summary>
     /// Updates the name of an existing master list identified by the specified identifier.
@@ -139,6 +157,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The identifier of the master list to update.</param>
     /// <param name="name">The new name to assign to the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the master list was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a2d47b2 -->
     Task<bool> UpdateMasterListName(ObjectId id, string name);
     /// <summary>
     /// Updates the description (name) of a master list entry identified by the specified identifier.
@@ -146,6 +165,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The unique identifier of the master list entry to update.</param>
     /// <param name="name">The new description to apply to the master list entry.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=8d9103c -->
     Task<bool> UpdateMasterListDescription(ObjectId id, string name);
     /// <summary>
     /// Asynchronously removes the specified option from the master list identified by the given id.
@@ -153,17 +173,20 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="id">The identifier of the master list from which the option will be removed.</param>
     /// <param name="oldOpt">The option entry to be removed from the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the option was successfully removed; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=f049a15 -->
     Task<bool> RemoveMasterListOption(ObjectId id, OptionList oldOpt);
     /// <summary>
     /// Asynchronously retrieves the total count of all items in the master list.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the total number of items in the master list.</returns>
+    /// <!-- aidoc:v1 sig=819b090 -->
     Task<int> GetAllMasterListCount();
     /// <summary>
     /// Retrieves a paginated master list of items based on the specified filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter that defines paging parameters such as page number and page size.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated response with the requested master list items.</returns>
+    /// <!-- aidoc:v1 sig=836cb10 -->
     Task<PaginationResponse<T>> GetPaginatedMasterList(PaginationFilter filter);
     /// <summary>
     /// Asynchronously deletes a master list option identified by the supplied identifiers.
@@ -172,6 +195,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="optId">The identifier of the specific option to remove from the master list.</param>
     /// <param name="typeName">The name of the master list type to which the option belongs.</param>
     /// <returns>A task that resolves to <c>true</c> if the option was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=59b3577 -->
     Task<bool> DeleteMasterListOption(ObjectId id, ObjectId optId, string typeName);
 
     /// <summary>
@@ -180,6 +204,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="listFilter">The pagination filter applied to the master list results.</param>
     /// <param name="optionsFilter">The pagination filter applied to the associated options.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated response with master list and options data.</returns>
+    /// <!-- aidoc:v1 sig=95a8b2b -->
     Task<PaginationResponse<MasterListWithPaginatedOptionsDto>> GetPaginatedMasterListWithPaginatedOptions(
             PaginationFilter listFilter, PaginationFilter optionsFilter);
 
@@ -189,6 +214,7 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="filter">The pagination parameters used to control the page size and page index of the returned results.</param>
     /// <param name="listId">The identifier of the list whose options should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{OptionList}"/> with the requested options.</returns>
+    /// <!-- aidoc:v1 sig=0df2157 -->
     Task<PaginationResponse<OptionList>> GetPaginatedOptions(PaginationFilter filter, ObjectId listId);
     /// <summary>
     /// Retrieves the associated list identifier for the given object based on the specified master list types.
@@ -197,11 +223,13 @@ public interface IMasterListService<T> where T : MasterList
     /// <param name="masterListType1">The first master list type used to determine the association.</param>
     /// <param name="masterListType2">The second master list type used to determine the association.</param>
     /// <returns>A task that returns the associated <see cref="ObjectId"/> if found, or <c>null</c> if no association exists.</returns>
+    /// <!-- aidoc:v1 sig=6f6f775 -->
     Task<ObjectId?> GetAssociatedList(ObjectId id, MasterListType masterListType1, MasterListType masterListType2);
     /// <summary>
     /// Retrieves the available options associated with the specified list identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the list whose options are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of option strings for the specified list.</returns>
+    /// <!-- aidoc:v1 sig=f43c75d -->
     Task<List<string>> GetOptionsOfList(ObjectId id);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IMasterListServiceFactory.cs b/adas-core.Application/Services/Interfaces/IMasterListServiceFactory.cs
index 07a91daa..f772f5a2 100644
--- a/adas-core.Application/Services/Interfaces/IMasterListServiceFactory.cs
+++ b/adas-core.Application/Services/Interfaces/IMasterListServiceFactory.cs
@@ -15,12 +15,14 @@ public interface IMasterListServiceFactory
     /// A service object of type <paramref name="serviceType"/>, or <c>null</c> if there is no service
     /// object of that type registered.
     /// </returns>
+    /// <!-- aidoc:v1 sig=8eed041 -->
     object GetService(Type serviceType);
     /// <summary>
     /// Retrieves a service instance from the master list based on the specified service name.
     /// </summary>
     /// <param name="serviceName">The <see cref="MasterListType"/> identifier used to look up the desired service.</param>
     /// <returns>An <see cref="object"/> representing the resolved service, or <see langword="null"/> if no matching service is found.</returns>
+    /// <!-- aidoc:v1 sig=14dc6e0 -->
     object GetService(MasterListType serviceName);
     /// <summary>
     /// Retrieves a typed representation of the specified <paramref name="masterList"/> based on the given <paramref name="masterListType"/>.
@@ -28,12 +30,14 @@ public interface IMasterListServiceFactory
     /// <param name="masterListType">The type that determines how the master list should be converted or filtered.</param>
     /// <param name="masterList">The master list to be returned in a typed form.</param>
     /// <returns>A typed object representing the master list, or <c>null</c> if no matching type is found.</returns>
+    /// <!-- aidoc:v1 sig=c73cdf1 -->
     object? GetTypedMasterList(MasterListType masterListType, MasterList masterList);
     /// <summary>
     /// Gets the specific <see cref="Type"/> associated with the given master list type, mapping the master list category to its corresponding implementation type.
     /// </summary>
     /// <param name="masterListType">The master list type whose associated <see cref="Type"/> should be returned.</param>
     /// <returns>The <see cref="Type"/> that corresponds to the specified <paramref name="masterListType"/>.</returns>
+    /// <!-- aidoc:v1 sig=c05f08e -->
     Type GetMasterListSpecificType(MasterListType masterListType);
     /// <summary>
     /// Inserts a new <see cref="MasterList"/> record based on the specified <paramref name="masterListType"/>.
@@ -41,6 +45,7 @@ public interface IMasterListServiceFactory
     /// <param name="masterListType">The type of master list to insert.</param>
     /// <param name="masterList">The master list entity to be inserted.</param>
     /// <returns>A task that represents the asynchronous insert operation. The result contains the inserted master list data, or <c>null</c> if the insert was not successful.</returns>
+    /// <!-- aidoc:v1 sig=a5d5b54 -->
     Task<object?> InsertMasterList(MasterListType masterListType, MasterList masterList);
     /// <summary>
     /// Asynchronously updates an existing master list entry based on the specified master list type and master list data.
@@ -48,6 +53,7 @@ public interface IMasterListServiceFactory
     /// <param name="masterListType">The type of master list to update, used to determine the target list or category.</param>
     /// <param name="masterList">The master list entity containing the updated data to be persisted.</param>
     /// <returns>A task that represents the asynchronous update operation. The result is an object containing the updated master list information, or <c>null</c> if no matching record was found.</returns>
+    /// <!-- aidoc:v1 sig=6dbb193 -->
     Task<object?> UpdateMasterList(MasterListType masterListType, MasterList masterList);
     /// <summary>
     /// Retrieves a master list entry by its identifier and type, optionally filtered by the specified data locale.
@@ -56,11 +62,13 @@ public interface IMasterListServiceFactory
     /// <param name="masterListId">The unique identifier of the master list entry to retrieve.</param>
     /// <param name="dataLocale">The optional locale used to resolve localized data; when null, no locale filtering is applied.</param>
     /// <returns>A task that yields the matching master list entry as an object, or null if no entry is found.</returns>
+    /// <!-- aidoc:v1 sig=edcfcb0 -->
     Task<object?> GetMasterListById(MasterListType masterListType, ObjectId masterListId, LocaleEnum? dataLocale);
     /// <summary>
     /// Retrieves a list of nurse observation entries as string values.
     /// </summary>
     /// <returns>A <see cref="List{T}"/> of <see cref="string"/> containing the nurse observation data.</returns>
+    /// <!-- aidoc:v1 sig=1c82859 -->
     List<string> StringNurseObs();
     /// <summary>
     /// Retrieves a translated <see cref="Patient"/> based on the provided <paramref name="unit"/> and <paramref name="locale"/>.
@@ -70,6 +78,7 @@ public interface IMasterListServiceFactory
     /// <param name="locale">The target locale for the translation. May be <c>null</c>.</param>
     /// <param name="patient">The patient to be translated. May be <c>null</c>.</param>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the translated <see cref="Patient"/>, or <c>null</c> if no translation is available.</returns>
+    /// <!-- aidoc:v1 sig=096dcea -->
     Task<Patient?> GetPatientTraslated(Unit? unit, LocaleEnum? locale, Patient? patient);
 
     /// <summary>
@@ -81,6 +90,7 @@ public interface IMasterListServiceFactory
     /// <param name="masterListOptionId">The identifier of the master list option to retrieve.</param>
     /// <param name="dataLocale">The optional locale used to localize the returned option data.</param>
     /// <returns>A task that yields the matching master list option as an <see cref="object"/>, or <see langword="null"/> if not found.</returns>
+    /// <!-- aidoc:v1 sig=2952bb7 -->
     Task<object?> GetMasterListOptionById(MasterListType masterListType, ObjectId masterListId,
             ObjectId masterListOptionId,
             LocaleEnum? dataLocale);
diff --git a/adas-core.Application/Services/Interfaces/IMedicineService.cs b/adas-core.Application/Services/Interfaces/IMedicineService.cs
index b1854479..d3926323 100644
--- a/adas-core.Application/Services/Interfaces/IMedicineService.cs
+++ b/adas-core.Application/Services/Interfaces/IMedicineService.cs
@@ -13,83 +13,98 @@ public interface IMedicineService
     /// </summary>
     /// <param name="code">The unique code used to look up the medicine.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="Medicine"/> or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=92ecf01 -->
     Task<Medicine?> GetByCode(string code);
     /// <summary>
     /// Retrieves a list of medicines that match the provided codes or notes.
     /// </summary>
     /// <param name="codeNote">A list of strings representing the codes or notes used to look up medicines.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Medicine"/> objects matching the provided codes or notes.</returns>
+    /// <!-- aidoc:v1 sig=14e1a2b -->
     Task<List<Medicine>> GetByCodeOrNote(List<string> codeNote);
     /// <summary>
     /// Retrieves a medicine by its name, returning null if no matching medicine is found.
     /// </summary>
     /// <param name="name">The name of the medicine to look up.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="Medicine"/> or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=a835f90 -->
     Task<Medicine?> GetByName(string name);
     /// <summary>
     /// Retrieves the medicines associated with the specified patient treatments.
     /// </summary>
     /// <param name="treatments">The collection of patient treatments, which may include null entries, whose medicines are to be obtained.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of medicines linked to the provided treatments.</returns>
+    /// <!-- aidoc:v1 sig=f7f9499 -->
     Task<IEnumerable<Medicine>> GetMedicinesOfTreatments(IEnumerable<PatientTreatment?> treatments);
     /// <summary>
     /// Asynchronously retrieves the collection of active medicines associated with the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose active medicines are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of active <see cref="Medicine"/> records for the patient.</returns>
+    /// <!-- aidoc:v1 sig=60d4b58 -->
     Task<IEnumerable<Medicine>> GetActiveMedicinesByPatient(ObjectId patientId);
     /// <summary>
     /// Retrieves a paginated list of medicines based on the provided filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter containing page size, page number, and optional search criteria.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{T}"/> with the requested <see cref="Medicine"/> items and pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=719bac1 -->
     Task<PaginationResponse<Medicine>> GetPaginatedMedicines(PaginationFilter filter);
     /// <summary>
     /// Asynchronously retrieves all medicines from the data store.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Medicine"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=84b2421 -->
     Task<List<Medicine>> GetAll();
     /// <summary>
     /// Retrieves a medicine by its unique identifier.
     /// </summary>
     /// <param name="medicineId">The unique identifier of the medicine to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="Medicine"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=a87fd1e -->
     Task<Medicine?> GetMedicineById(ObjectId medicineId);
     /// <summary>
     /// Asynchronously posts a new medicine and returns the created medicine, or null if the operation fails.
     /// </summary>
     /// <param name="medicine">The medicine entity to be posted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the posted <see cref="Medicine"/>, or null if the medicine could not be posted.</returns>
+    /// <!-- aidoc:v1 sig=9decc93 -->
     Task<Medicine?> PostMedicine(Medicine medicine);
     /// <summary>
     /// Updates an existing medicine in the data store and returns the updated entity, or <c>null</c> if no matching medicine was found.
     /// </summary>
     /// <param name="medicine">The medicine entity containing the updated values to be persisted.</param>
     /// <returns>A task that represents the asynchronous update operation. The result is the updated <see cref="Medicine"/> when the update succeeds, or <c>null</c> when the medicine does not exist.</returns>
+    /// <!-- aidoc:v1 sig=2ae8490 -->
     Task<Medicine?> UpdateMedicine(Medicine medicine);
     /// <summary>
     /// Deletes a medicine record identified by the specified identifier.
     /// </summary>
     /// <param name="medicineId">The unique identifier of the medicine to delete.</param>
+    /// <!-- aidoc:v1 sig=44a1285 -->
     Task DeleteMedicineById(ObjectId medicineId);
     /// <summary>
     /// Asynchronously retrieves all available types as a list of string identifiers.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of type identifiers.</returns>
+    /// <!-- aidoc:v1 sig=c476963 -->
     Task<List<string>> GetAllTypes();
     /// <summary>
     /// Asynchronously retrieves all available groups, returning their identifiers or names as a list of strings.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of strings representing all groups.</returns>
+    /// <!-- aidoc:v1 sig=060fe47 -->
     Task<List<string>> GetAllGroups();
     /// <summary>
     /// Asynchronously retrieves all available names.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all names.</returns>
+    /// <!-- aidoc:v1 sig=24a3647 -->
     Task<List<string>> GetAllNames();
     /// <summary>
     /// Asynchronously retrieves the complete list of available codes from the data source.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of code strings.</returns>
+    /// <!-- aidoc:v1 sig=9b0f08a -->
     Task<List<string>> GetAllCodes();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/INoticeService.cs b/adas-core.Application/Services/Interfaces/INoticeService.cs
index 13a851a4..4667ba28 100644
--- a/adas-core.Application/Services/Interfaces/INoticeService.cs
+++ b/adas-core.Application/Services/Interfaces/INoticeService.cs
@@ -11,11 +11,13 @@ public interface INoticeService
     /// </summary>
     /// <param name="notice">The notice to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=d29db0d -->
     Task DeleteNoticeAsync(Notice notice);
     /// <summary>
     /// Asynchronously deletes a notice identified by the specified identifier.
     /// </summary>
     /// <param name="noticeId">The unique identifier of the notice to delete.</param>
+    /// <!-- aidoc:v1 sig=d491033 -->
     Task DeleteNoticeByIdAsync(ObjectId noticeId);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Notice"/> entity by its unique identifier from the data store.
@@ -23,6 +25,7 @@ public interface INoticeService
     /// </summary>
     /// <param name="noticeId">The <see cref="ObjectId"/> that uniquely identifies the notice to retrieve.</param>
     /// <returns>A <see cref="Task{T}"/> containing the matching <see cref="Notice"/>, or <see langword="null"/> if no notice is found.</returns>
+    /// <!-- aidoc:v1 sig=ed98d3c -->
     Task<Notice?> GetNoticeByIdAsync(ObjectId noticeId);
     /// <summary>
     /// Asynchronously retrieves a collection of notices filtered by the specified notice type.
@@ -30,37 +33,44 @@ public interface INoticeService
     /// </summary>
     /// <param name="noticeType">The type of notice to filter by.</param>
     /// <returns>A task containing an enumerable of matching <see cref="Notice"/> objects, or null if none are found.</returns>
+    /// <!-- aidoc:v1 sig=532654c -->
     Task<IEnumerable<Notice>?> GetNoticeByTypeAsync(string noticeType);
     /// <summary>
     /// Asynchronously retrieves a collection of notices.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains an enumerable collection of <see cref="Notice"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=d3b0c51 -->
     Task<IEnumerable<Notice>> GetNoticesAsync();
     /// <summary>
     /// Inserts a new notice into the data store.
     /// </summary>
     /// <param name="notice">The notice entity to insert.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the inserted <see cref="Notice"/>, or <c>null</c> if the notice could not be inserted.</returns>
+    /// <!-- aidoc:v1 sig=9bc91b1 -->
     Task<Notice?> InsertNotice(Notice notice);
     /// <summary>
     /// Asynchronously updates an existing notice in the system.
     /// </summary>
     /// <param name="notice">The notice entity containing the updated information to be persisted.</param>
+    /// <!-- aidoc:v1 sig=a1ae02b -->
     Task UpdateNoticeAsync(Notice notice);
     /// <summary>
     /// Persists the provided API request to the data store.
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
+    /// <!-- aidoc:v1 sig=274a023 -->
     Task SaveRequest(ApiRequest apiRequest);
     /// <summary>
     /// Asynchronously persists the specified API request.
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
+    /// <!-- aidoc:v1 sig=24f178e -->
     Task SaveRequestAsync(ApiRequest apiRequest);
     /// <summary>
     /// Asynchronously retrieves the collection of notices associated with the specified display identifier.
     /// </summary>
     /// <param name="displayId">The identifier of the display whose notices should be retrieved.</param>
     /// <returns>A task that returns the notices for the display, or <c>null</c> when no notices are found for the given display.</returns>
+    /// <!-- aidoc:v1 sig=9e0ab44 -->
     Task<IEnumerable<Notice>?> GetNoticesByDisplayId(ObjectId displayId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IObservationDemoService.cs b/adas-core.Application/Services/Interfaces/IObservationDemoService.cs
index c97be5a7..d235fabc 100644
--- a/adas-core.Application/Services/Interfaces/IObservationDemoService.cs
+++ b/adas-core.Application/Services/Interfaces/IObservationDemoService.cs
@@ -12,6 +12,7 @@ public interface IObservationDemoService
     /// <param name="patient">The patient for whom the observations are being generated.</param>
     /// <param name="dataFields">The collection of fields used to drive the observation generation.</param>
     /// <returns>A task representing the asynchronous operation that returns the list of generated patient observations.</returns>
+    /// <!-- aidoc:v1 sig=4891e1c -->
     Task<List<PatientObservation>> GenerateObservationByField(Patient patient, List<Field> dataFields);
     /// <summary>
     /// Generates a grouped observation for the specified patient based on the provided grouped field configuration.
@@ -19,6 +20,7 @@ public interface IObservationDemoService
     /// <param name="patient">The patient for whom the grouped observation is generated.</param>
     /// <param name="groupedField">The grouped field definition that determines the grouping criteria for the observation.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the generated <see cref="GroupedObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=7c0b714 -->
     Task<GroupedObservation> GenerateGroupedObservation(Patient patient, GroupedField groupedField);
     /// <summary>
     /// Generates a list of patient observation alarms for the specified patient based on the provided data alarm fields.
@@ -26,5 +28,6 @@ public interface IObservationDemoService
     /// <param name="patient">The patient for whom the observation alarms are generated.</param>
     /// <param name="dataAlarmfields">The list of fields used to determine and generate the data alarms.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientObservationAlarm"/> objects generated for the patient.</returns>
+    /// <!-- aidoc:v1 sig=f61d9a3 -->
     Task<List<PatientObservationAlarm>> GenerateAlarmByField(Patient patient, List<Field> dataAlarmfields);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IObservationService.cs b/adas-core.Application/Services/Interfaces/IObservationService.cs
index 4601e6a3..bbb8db16 100644
--- a/adas-core.Application/Services/Interfaces/IObservationService.cs
+++ b/adas-core.Application/Services/Interfaces/IObservationService.cs
@@ -19,6 +19,7 @@ public interface IObservationService : IApiRequestService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose observations are to be retrieved.</param>
     /// <returns>A task that returns an <see cref="IAsyncCursor{TDocument}"/> of <see cref="PatientObservation"/> instances for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=39ad19b -->
     Task<IAsyncCursor<PatientObservation>> FindByPatientIdAsync(ObjectId patientId);
 
     /// <summary>
@@ -28,6 +29,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="codingSystem">The coding system used to classify the observations (e.g., LOINC, SNOMED).</param>
     /// <param name="name">The name of the observation to filter by.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IAsyncCursor{TDocument}"/> of <see cref="PatientObservation"/> matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=d7bdee5 -->
     Task<IAsyncCursor<PatientObservation>> FindByPatientIdAndCodingSystemAsync(ObjectId patientId, string codingSystem,
             string name);
 
@@ -38,6 +40,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="num">The maximum number of most recent observations to return. Defaults to 2.</param>
     /// <param name="filterObservations">An optional list of observation codes used to restrict the result set; if null, observations are not filtered by code.</param>
     /// <returns>A task that resolves to a list of the most recent <see cref="PatientObservation"/> entries matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=40372b5 -->
     Task<List<PatientObservation>> FindLastObservations(ObjectId patientId, int num = 2,
             List<string>? filterObservations = null);
 
@@ -45,14 +48,17 @@ public interface IObservationService : IApiRequestService
     /// Updates the status of the provided patient observations that have reached their expiration.
     /// </summary>
     /// <param name="expiredObservations">The list of patient observations to update as expired.</param>
+    /// <!-- aidoc:v1 sig=e7ed4fa -->
     Task UpdateExpiredObservations(List<PatientObservation> expiredObservations);
     /// <summary>
     /// Asynchronously expires observations that are no longer valid and recalculates the dependent data.
     /// </summary>
+    /// <!-- aidoc:v1 sig=209fa1b -->
     Task ExpireObservationsAndRecalculateAsync();
     /// <summary>
     /// Asynchronously expires active alerts and powers off the device.
     /// </summary>
+    /// <!-- aidoc:v1 sig=db747c2 -->
     Task ExpireAlertsAndPowerOffAsync();
 
     /// <summary>
@@ -62,6 +68,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="name">The name of the observation to filter by.</param>
     /// <param name="expires">Optional expiration time in seconds applied to the cached results. If <c>null</c>, no expiration is applied.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of the latest unique <see cref="PatientObservation"/> values matching the specified patient and name.</returns>
+    /// <!-- aidoc:v1 sig=cd1a09e -->
     Task<List<PatientObservation>> FindLatestUniqueValuesByName(ObjectId patientId, string name, int? expires);
 
     /// <summary>
@@ -72,6 +79,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="mapped">Indicates whether the returned observations should be mapped (default true) or returned in their raw form.</param>
     /// <param name="ct">The cancellation token used to cancel the asynchronous operation.</param>
     /// <returns>A task that resolves to a list of the patient's most recent <see cref="PatientObservation"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=5966f87 -->
     Task<List<PatientObservation>> FindLastObservationsByField(ObjectId patientId,
             List<Field>? filterObservations = null, bool mapped = true, CancellationToken ct = default);
 
@@ -80,6 +88,7 @@ public interface IObservationService : IApiRequestService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose intravenous line observations are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of nullable <see cref="PatientObservation"/> entries representing the latest intravenous line observations by location, where individual entries may be <c>null</c> when no data is available.</returns>
+    /// <!-- aidoc:v1 sig=b696654 -->
     Task<List<PatientObservation?>> FindLastIntravenousLinesObservationByLocation(ObjectId patientId);
     /// <summary>
     /// Asynchronously inserts a patient observation, with options to control whether the observation is persisted and whether it is mapped.
@@ -87,6 +96,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="patientObservation">The patient observation to insert.</param>
     /// <param name="persistObs">Indicates whether the observation should be persisted; defaults to <c>true</c>.</param>
     /// <param name="mapObs">Indicates whether the observation should be mapped; defaults to <c>true</c>.</param>
+    /// <!-- aidoc:v1 sig=f65b171 -->
     Task InsertObservation(PatientObservation patientObservation, bool persistObs = true, bool mapObs = true);
     /// <summary>
     /// Inserts the specified patient observation only if it has changed, optionally persisting the observation and applying a mapping during the insert.
@@ -96,22 +106,26 @@ public interface IObservationService : IApiRequestService
     /// <param name="persistObs">Indicates whether the observation should be persisted when it is inserted. Defaults to <c>true</c>.</param>
     /// <param name="mapObs">Indicates whether the observation should be mapped as part of the insert operation. Defaults to <c>true</c>.</param>
     /// <returns>A task that returns <c>true</c> if the observation was inserted because a change was detected; otherwise, <c>false</c> if no insert was performed.</returns>
+    /// <!-- aidoc:v1 sig=2d74a4d -->
     Task<bool> InsertIfChanged(string name, PatientObservation observation, bool persistObs = true, bool mapObs = true);
     /// <summary>
     /// Inserts a new nurse observation for a patient into the underlying data store.
     /// </summary>
     /// <param name="obs">The patient observation data recorded by the nurse to be persisted.</param>
+    /// <!-- aidoc:v1 sig=cbc1b6e -->
     Task InsertNurseObservation(PatientObservation obs);
     /// <summary>
     /// Asynchronously deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Asynchronously archives the specified patient observation, preserving it for historical or compliance purposes while removing it from the active set.
     /// </summary>
     /// <param name="observation">The patient observation to archive.</param>
     /// <returns>A task that represents the asynchronous archive operation.</returns>
+    /// <!-- aidoc:v1 sig=44e255f -->
     Task Archive(PatientObservation observation);
     /// <summary>
     /// Asynchronously maps a <see cref="PatientObservation"/> to a corresponding observation, optionally restricting the lookup to name-based matching. Returns <see langword="null"/> when no matching observation is found.
@@ -119,27 +133,32 @@ public interface IObservationService : IApiRequestService
     /// <param name="obs">The source <see cref="PatientObservation"/> to be mapped.</param>
     /// <param name="onlyByName">When <see langword="true"/>, restricts the lookup to name-based matching; otherwise, the default mapping behavior is applied.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the mapped <see cref="PatientObservation"/>, or <see langword="null"/> if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=6377232 -->
     Task<PatientObservation?> MapObservation(PatientObservation obs, bool onlyByName = false);
     /// <summary>
     /// Asynchronously retrieves the most recent observation time for each patient, returning a mapping of patient identifiers to their last observation timestamps.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a dictionary where each key is a patient <see cref="ObjectId"/> and the associated value is the <see cref="DateTime"/> of that patient's latest observation.</returns>
+    /// <!-- aidoc:v1 sig=cbcaa4c -->
     Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime();
     /// <summary>
     /// Asynchronously maps or looks up a <see cref="PatientObservation"/> based on the name of the provided observation, returning the matching observation or <c>null</c> when no match is found.
     /// </summary>
     /// <param name="obs">The <see cref="PatientObservation"/> whose name is used to perform the mapping or lookup.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> that resolves to the matching <see cref="PatientObservation"/>, or <c>null</c> if no corresponding observation is found.</returns>
+    /// <!-- aidoc:v1 sig=a41fe3f -->
     Task<PatientObservation?> MapObservationsByName(PatientObservation obs);
     /// <summary>
     /// Archives the specified patient, moving their record out of the active set so that it is retained for historical or compliance purposes while no longer appearing in routine operational queries.
     /// </summary>
     /// <param name="patient">The patient whose record is to be archived.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Archives records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose records should be archived.</param>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
 
     /// <summary>
@@ -147,6 +166,7 @@ public interface IObservationService : IApiRequestService
     /// </summary>
     /// <param name="observation">The patient observation containing the updated information.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=325f985 -->
     Task UpdateObservation(PatientObservation observation);
     /// <summary>
     /// Updates the specified identifier field (<paramref name="nameId"/>) across multiple objects, replacing the existing value <paramref name="oldId"/> with the new value <paramref name="id"/>.
@@ -155,24 +175,28 @@ public interface IObservationService : IApiRequestService
     /// <param name="id">The new <see cref="ObjectId"/> value to assign to the field.</param>
     /// <param name="oldId">The current <see cref="ObjectId"/> value to be replaced.</param>
     /// <returns>A task that represents the asynchronous bulk update operation.</returns>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 
     /// <summary>
     /// Asynchronously broadcasts a patient observation to subscribed listeners or endpoints.
     /// </summary>
     /// <param name="obs">The base patient observation to be broadcast.</param>
+    /// <!-- aidoc:v1 sig=875526d -->
     Task SendObsBroadcast(BasePatientObservation obs);
     /// <summary>
     /// Sends a broadcast containing the specified patient observations to the given patient location.
     /// </summary>
     /// <param name="obs">The list of patient observations to include in the broadcast.</param>
     /// <param name="location">The target patient location that will receive the broadcast.</param>
+    /// <!-- aidoc:v1 sig=eba4dc4 -->
     Task SendObsBroadcast(List<PatientObservation> obs, PatientLocation location);
     /// <summary>
     /// Asynchronously sends a broadcast of patient observations to the specified Point of Care (POC) system.
     /// </summary>
     /// <param name="obs">The list of patient observations to be transmitted in the broadcast.</param>
     /// <param name="pocId">The identifier of the Point of Care system that will receive the observations.</param>
+    /// <!-- aidoc:v1 sig=7b85a82 -->
     Task SendObsBroadcast(List<PatientObservation> obs, ObjectId pocId);
 
     /// <summary>
@@ -182,6 +206,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="date">The cutoff date; only observations recorded strictly before this date are considered.</param>
     /// <param name="obsName">The optional name of the observation to filter by, or <c>null</c> to match any observation.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the latest matching <see cref="PatientObservation"/>, or <c>null</c> if none was found before the given date.</returns>
+    /// <!-- aidoc:v1 sig=9dd6e55 -->
     Task<PatientObservation?> FindLastBeforeDate(ObjectId patientId, DateTime date, string? obsName);
 
     /// <summary>
@@ -191,6 +216,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="date">The date used to match observations.</param>
     /// <param name="obsName">The optional observation name used to filter the results. When null, observations are not filtered by name.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of matching <see cref="PatientObservation"/> records, or null when no observations match the criteria.</returns>
+    /// <!-- aidoc:v1 sig=b609e73 -->
     Task<List<PatientObservation>?> FindAnyWithSameDate(ObjectId patientId, DateTime date, string? obsName);
 
     //TODO To implement
@@ -201,6 +227,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="date">The cutoff date; only observations recorded before this date will be returned.</param>
     /// <param name="filterObservations">An optional list of observation identifiers used to restrict the results to specific observation types. When null, all observation types are included.</param>
     /// <returns>A task that resolves to a list of PatientObservation instances matching the criteria.</returns>
+    /// <!-- aidoc:v1 sig=1182280 -->
     Task<List<PatientObservation>> FindAllBeforeDate(ObjectId patientId, DateTime date,
             List<string>? filterObservations = null);
 
@@ -212,6 +239,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="date">The cutoff date; only observations with a timestamp after this value are returned.</param>
     /// <param name="filterObservations">An optional list of observation names to restrict the result to. When <c>null</c> or empty, all observations after the date are returned.</param>
     /// <returns>A <see cref="Task{T}"/> that yields the list of matching <see cref="PatientObservation"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=793de04 -->
     Task<List<PatientObservation>> FindAllAfterDate(ObjectId patientId, DateTime date,
             List<string>? filterObservations = null);
 
@@ -225,6 +253,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="fromArchived">When true, observations are retrieved from archived records; otherwise, only active records are considered.</param>
     /// <param name="filter">An optional pagination filter applied to the result set.</param>
     /// <returns>A task that resolves to a list of <see cref="PatientObservation"/> entries matching the provided criteria.</returns>
+    /// <!-- aidoc:v1 sig=2f8c17f -->
     Task<List<PatientObservation>> FindAllBetweenDates(ObjectId patientId, DateTime? startDate, DateTime? endDate,
             List<string>? filterObservations = null, bool fromArchived = false, PaginationFilter? filter = null);
 
@@ -236,6 +265,7 @@ public interface IObservationService : IApiRequestService
     /// <param name="endAfter">Optional parameter that defines the pagination boundary; when provided, observations are returned starting after this position.</param>
     /// <param name="num">Optional parameter that limits the maximum number of observations returned.</param>
     /// <returns>A task representing the asynchronous operation, containing a collection of matching non-expired <see cref="PatientObservation"/> records; an empty collection is returned if none are found.</returns>
+    /// <!-- aidoc:v1 sig=ba8e6f1 -->
     Task<IEnumerable<PatientObservation>> FindLastNotExpiredObservatonsByPatient(ObjectId patientId, string name,
             int? endAfter = null, int? num = null);
 
@@ -243,12 +273,14 @@ public interface IObservationService : IApiRequestService
     /// <summary>
     /// Checks observations and expires those that meet the expiration criteria.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0d8befa -->
     Task CheckAndExpireObservations();
 
     /// <summary>
     /// Retrieves patient observations that have not been marked as expired but should be, based on their validity period or business rules.
     /// </summary>
     /// <returns>An asynchronous stream of <see cref="PatientObservation"/> instances that are not expired but meet the criteria to be expired.</returns>
+    /// <!-- aidoc:v1 sig=ef73cf5 -->
     IAsyncEnumerable<PatientObservation> FindNotExpiredObservationsShouldBeExpired();
 
 
@@ -259,12 +291,14 @@ public interface IObservationService : IApiRequestService
     /// <param name="patient">The patient associated with the observations.</param>
     /// <param name="messageTime">The timestamp of the message containing the observations.</param>
     /// <param name="observationData">Optional additional data related to the observations.</param>
+    /// <!-- aidoc:v1 sig=26ab597 -->
     void ProcessObservations(List<PatientObservation> observations, Patient patient, DateTime messageTime,
             ObservationData? observationData = null);
 
     /// <summary>
     /// Asynchronously processes and expires observations that have exceeded their validity period.
     /// </summary>
+    /// <!-- aidoc:v1 sig=386e4a2 -->
     Task ExpireObservations();
 
     /// <summary>
@@ -272,16 +306,19 @@ public interface IObservationService : IApiRequestService
     /// </summary>
     /// <param name="observation">The patient observation to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=5bd41b8 -->
     Task InsertSimpleObservation(PatientObservation observation);
     /// <summary>
     /// Asynchronously retrieves a paginated collection of patient observations based on the specified filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter that controls the page size, page number, and any additional query criteria applied to the patient observations.</param>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="PaginationResponse{T}"/> of <see cref="PatientObservation"/> with the requested page of results.</returns>
+    /// <!-- aidoc:v1 sig=55ee5d3 -->
     Task<PaginationResponse<PatientObservation>> GetPaginatedObservations(PaginationFilter filter);
     /// <summary>
     /// Asynchronously saves a nurse observation request.
     /// </summary>
     /// <param name="request">The API request containing the nurse observation data to save.</param>
+    /// <!-- aidoc:v1 sig=bc3f3e7 -->
     Task SaveRequestNurseObsAsync(ApiRequest request);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPatientCarePlanService.cs b/adas-core.Application/Services/Interfaces/IPatientCarePlanService.cs
index cb326089..f6587a4c 100644
--- a/adas-core.Application/Services/Interfaces/IPatientCarePlanService.cs
+++ b/adas-core.Application/Services/Interfaces/IPatientCarePlanService.cs
@@ -11,34 +11,40 @@ public interface IPatientCarePlanService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> records for the given patient.</returns>
+    /// <!-- aidoc:v1 sig=6525ef9 -->
     Task<List<PatientCarePlan>> FindByPatientId(ObjectId patientId);
     /// <summary>
     /// Retrieves a list of patient care plans associated with the specified user identifier.
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose patient care plans are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of patient care plans associated with the user.</returns>
+    /// <!-- aidoc:v1 sig=150426f -->
     Task<List<PatientCarePlan>> FindByUserId(ObjectId userId);
     /// <summary>
     /// Retrieves all patient care plans from the system.
     /// </summary>
     /// <returns>A task containing a list of all <see cref="PatientCarePlan"/> records.</returns>
+    /// <!-- aidoc:v1 sig=83af170 -->
     Task<List<PatientCarePlan>> FindAll();
     /// <summary>
     /// Asynchronously inserts a single patient care plan into the underlying data store.
     /// </summary>
     /// <param name="patientCarePlan">The patient care plan to insert.</param>
+    /// <!-- aidoc:v1 sig=0e9c8f0 -->
     Task InsertOneAsync(PatientCarePlan patientCarePlan);
     /// <summary>
     /// Archives the care plan associated with a finished procedure for the specified patient, processing the provided list of items to be archived.
     /// </summary>
     /// <param name="patientWithFinishedProcedure">The patient whose procedure has been completed and whose care plan should be archived.</param>
     /// <param name="itemsToArchive">The collection of option list items to be archived as part of the care plan archival process.</param>
+    /// <!-- aidoc:v1 sig=7ddd7f6 -->
     Task ArchiveCarePlanFromJob(Patient patientWithFinishedProcedure, List<OptionList> itemsToArchive);
 
     /// <summary>
     /// Asynchronously archives records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientid">The unique identifier of the patient whose records are to be archived.</param>
+    /// <!-- aidoc:v1 sig=af2b0d3 -->
     Task ArchiveByPatientId(ObjectId patientid);
     /// <summary>
     /// Updates the ObjectId references from the specified old identifier to a new one across multiple records associated with the given patient.
@@ -46,5 +52,7 @@ public interface IPatientCarePlanService
     /// <param name="patientid">The string identifier of the patient whose related records will be updated.</param>
     /// <param name="patientId">The ObjectId of the patient used to locate the records to update.</param>
     /// <param name="oldId">The existing ObjectId value to be replaced in the matched records.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary states the method updates references 'to a new one', but the method signature has no parameter for a new ObjectId value; only an oldId is provided for replacement." -->
     Task UpdateManyObjectId(string patientid, ObjectId patientId, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPatientService.cs b/adas-core.Application/Services/Interfaces/IPatientService.cs
index 0f582870..1371f571 100644
--- a/adas-core.Application/Services/Interfaces/IPatientService.cs
+++ b/adas-core.Application/Services/Interfaces/IPatientService.cs
@@ -17,6 +17,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientId">The unique identifier of the patient to find.</param>
     /// <param name="withLocation">When set to <c>true</c>, includes location details in the returned patient; otherwise, only basic patient data is returned.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the found <see cref="Patient"/>, or <c>null</c> if no patient matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=823c22c -->
     Task<Patient?> FindByPatientId(string patientId, bool withLocation = false);
     /// <summary>
     /// Asynchronously retrieves a patient by their unique identifier, applying the specified locale for localized data.
@@ -24,12 +25,14 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientId">The unique identifier of the patient to locate.</param>
     /// <param name="localeEnum">The locale to use when retrieving or formatting localized patient information.</param>
     /// <returns>A task that resolves to the matching patient, or <c>null</c> if no patient is found for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=0b2d8b0 -->
     Task<Patient?> FindByPatientIdWithLocale(string patientId, LocaleEnum localeEnum);
     /// <summary>
     /// Asynchronously retrieves an archived <see cref="Patient"/> matching the specified patient number, returning <c>null</c> when no matching archived record is found.
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the archived patient record.</param>
     /// <returns>A <see cref="Task{Patient}"/> that yields the matching archived <see cref="Patient"/>, or <c>null</c> if no archived patient is found.</returns>
+    /// <!-- aidoc:v1 sig=38fda84 -->
     Task<Patient?> FindByPatientNumberArchived(string patientNumber);
     /// <summary>
     /// Retrieves a patient by their unique patient number, optionally including location information in the result.
@@ -37,6 +40,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <param name="withLocation">When <c>true</c>, location information is included in the returned patient; otherwise, it is omitted.</param>
     /// <returns>A task that yields the matching <see cref="Patient"/> if one is found, or <c>null</c> when no patient matches the given number.</returns>
+    /// <!-- aidoc:v1 sig=d9f5471 -->
     Task<Patient?> FindByPatientNumber(string patientNumber, bool withLocation = false);
     /// <summary>
     /// Asynchronously retrieves a patient associated with the specified location.
@@ -44,12 +48,14 @@ public interface IPatientService : IApiRequestService
     /// </summary>
     /// <param name="location">The patient location used to search for a matching patient. May be <see langword="null"/>.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="Patient"/>, or <see langword="null"/> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=ca2dffa -->
     Task<Patient?> FindByLocation(PatientLocation? location);
     /// <summary>
     /// Asynchronously retrieves a patient associated with the specified Point of Care identifier.
     /// </summary>
     /// <param name="pocId">The ObjectId representing the Point of Care identifier used to look up the patient.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=1336816 -->
     Task<Patient?> FindByPointOfCareId(ObjectId pocId);
     /// <summary>
     /// Asynchronously retrieves a patient identified by the specified unit and point-of-care identifiers.
@@ -57,18 +63,21 @@ public interface IPatientService : IApiRequestService
     /// <param name="unit">The unique identifier of the unit to search within.</param>
     /// <param name="pointOfCare">The unique identifier of the point-of-care associated with the patient.</param>
     /// <returns>A task that yields the matching <see cref="Patient"/>, or <c>null</c> if no patient is found for the given unit and point-of-care.</returns>
+    /// <!-- aidoc:v1 sig=a028676 -->
     Task<Patient?> FindByUnitAndPocId(ObjectId unit, ObjectId pointOfCare);
     /// <summary>
     /// Asynchronously retrieves a list of patients associated with the specified point of care.
     /// </summary>
     /// <param name="pointOfCare">The point of care identifier used to locate matching patients.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Patient"/> objects that match the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=c2cb9ce -->
     Task<List<Patient>> FindByPointOfCare(string pointOfCare);
     /// <summary>
     /// Asynchronously counts the number of patients associated with the specified unit identifier.
     /// </summary>
     /// <param name="unitId">The ObjectId of the unit whose patients should be counted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the total count of patients for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=867c6c1 -->
     Task<long> CountPatientsByUnitId(ObjectId unitId);
 
     /// <summary>
@@ -82,6 +91,7 @@ public interface IPatientService : IApiRequestService
     /// <paramref name="location"/> instead of the patient identifiers.</param>
     /// <returns>A <see cref="Task{Patient}"/> that yields the matching <see cref="Patient"/>, or
     /// <c>null</c> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=9cea35f -->
     Task<Patient?> FindPatient(string? patientId, string? patientNumber, PatientLocation? location,
             bool findByLocation = false);
 
@@ -89,33 +99,39 @@ public interface IPatientService : IApiRequestService
     /// Asynchronously inserts a new patient record into the data store.
     /// </summary>
     /// <param name="patient">The patient entity to be inserted.</param>
+    /// <!-- aidoc:v1 sig=3c6f3e8 -->
     Task Insert(Patient patient);
     /// <summary>
     /// Asynchronously inserts the specified <see cref="Patient"/> into the data store.
     /// </summary>
     /// <param name="patient">The patient entity to be persisted.</param>
+    /// <!-- aidoc:v1 sig=6e78a3b -->
     Task InsertAsync(Patient patient);
     /// <summary>
     /// Archives the specified patient record.
     /// </summary>
     /// <param name="patient">The patient to archive.</param>
+    /// <!-- aidoc:v1 sig=a500807 -->
     Task ArchivePatient(Patient patient);
     /// <summary>
     /// Archives the patient data identified by the specified patient identifier.
     /// </summary>
     /// <param name="patientid">The unique identifier of the patient whose data should be archived.</param>
+    /// <!-- aidoc:v1 sig=1a00b68 -->
     Task ArchivePatientData(ObjectId patientid);
     /// <summary>
     /// Merges the specified patient record with the existing patient identified by the old patient number.
     /// </summary>
     /// <param name="patient">The patient data to merge into the existing record.</param>
     /// <param name="oldPatienNumber">The identifier of the existing patient record to be merged.</param>
+    /// <!-- aidoc:v1 sig=1e8bdc4 -->
     Task MergePatient(Patient patient, string oldPatienNumber);
     /// <summary>
     /// Updates the location of a patient identified by the specified object identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose location will be updated.</param>
     /// <param name="location">The new patient location, or <c>null</c> if no location is provided.</param>
+    /// <!-- aidoc:v1 sig=aa67e50 -->
     Task UpdateLocation(ObjectId id, PatientLocation? location);
     /// <summary>
     /// Updates the attending doctor for the entity identified by the specified identifier.
@@ -123,6 +139,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="id">The identifier of the entity whose attending doctor will be updated.</param>
     /// <param name="doctor">The new attending doctor to assign to the entity.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=c6b59f4 -->
     Task UpdateAttendingDoctor(ObjectId id, Person doctor);
     /// <summary>
     /// Updates the data of an existing patient identified by the given identifier, optionally replacing the patient number when the <paramref name="updatePatientNumber"/> flag is true.
@@ -131,6 +148,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientNumber">The patient number to be applied to the patient.</param>
     /// <param name="data">The person data to assign to the patient.</param>
     /// <param name="updatePatientNumber">Indicates whether the patient number should also be updated; defaults to true.</param>
+    /// <!-- aidoc:v1 sig=c9778ad -->
     Task UpdatePatientData(ObjectId id, string patientNumber, Person data, bool updatePatientNumber = true);
     /// <summary>
     /// Updates the patient data for the specified patient identified by <paramref name="id"/> and <paramref name="patientNumber"/>, applying the changes from the provided <paramref name="patient"/> object. When <paramref name="updatePatientNumber"/> is <c>true</c>, the patient number is also updated as part of the operation; otherwise, only the remaining patient fields are updated.
@@ -140,11 +158,13 @@ public interface IPatientService : IApiRequestService
     /// <param name="patient">The patient object containing the updated data to be applied.</param>
     /// <param name="updatePatientNumber">A flag indicating whether the patient number should also be updated; defaults to <c>true</c>.</param>
     /// <returns>A <see cref="Task"/> that represents the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=d6fb956 -->
     Task UpdatePatientData(ObjectId id, string patientNumber, Patient patient, bool updatePatientNumber = true);
     /// <summary>
     /// Updates the specified patient record.
     /// </summary>
     /// <param name="patient">The patient whose information will be updated.</param>
+    /// <!-- aidoc:v1 sig=0688359 -->
     Task Update(Patient patient);
     /// <summary>
     /// Moves the specified patient from the old point of care to the new point of care.
@@ -153,6 +173,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="newPocId">The identifier of the destination point of care.</param>
     /// <param name="oldPocId">The identifier of the source point of care.</param>
     /// <returns>A task that resolves to <c>true</c> if the move was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=40515dd -->
     Task<bool> Move(Patient patient, ObjectId newPocId, ObjectId oldPocId);
     /// <summary>
     /// Retrieves a patient by their unique identifier, optionally including location information.
@@ -161,6 +182,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="id">The <see cref="ObjectId"/> used to look up the patient.</param>
     /// <param name="withLocation">When <c>true</c>, includes the patient's location data in the result; otherwise, location data is omitted.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the matching <see cref="Patient"/>, or <c>null</c> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=a1146e7 -->
     Task<Patient?> FindById(ObjectId id, bool withLocation = false);
     /// <summary>
     /// Retrieves a <see cref="Box"/> associated with the specified <see cref="PointOfCare"/>, returning <see langword="null"/> when no box is found for the given point of care.
@@ -169,6 +191,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="observations">When <see langword="true"/>, observations are included with the returned box; otherwise, observations are omitted.</param>
     /// <param name="filterObservations">An optional list of observation identifiers used to restrict which observations are loaded when <paramref name="observations"/> is <see langword="true"/>.</param>
     /// <returns>A <see cref="Task{Box}"/> that resolves to the matching <see cref="Box"/>, or <see langword="null"/> if no box exists for the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=8cd91c3 -->
     Task<Box?> GetBox(PointOfCare poc, bool observations = false, List<string>? filterObservations = null);
     /// <summary>
     /// Creates a <see cref="Patient"/> instance from the provided <see cref="ApiRequest"/>, optionally ignoring location information during the creation process.
@@ -176,35 +199,41 @@ public interface IPatientService : IApiRequestService
     /// <param name="apiRequest">The API request containing the data used to construct the patient.</param>
     /// <param name="ignoreLocation">When <c>true</c>, location information is ignored during patient creation. Defaults to <c>false</c>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Patient"/>, or <c>null</c> if the patient could not be created.</returns>
+    /// <!-- aidoc:v1 sig=f7ca273 -->
     Task<Patient?> CreatePatientFromRequest(ApiRequest apiRequest, bool ignoreLocation = false);
     /// <summary>
     /// Asynchronously finds a patient based on the information provided in the specified API request.
     /// </summary>
     /// <param name="apiRequest">The API request containing the data used to look up the patient.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if found, or null if no patient matches the request.</returns>
+    /// <!-- aidoc:v1 sig=9bc220c -->
     Task<Patient?> FindPatientByApiRequest(ApiRequest apiRequest);
     /// <summary>
     /// Archives patients who have no observations recorded since the specified date.
     /// </summary>
     /// <param name="date">The cutoff date; patients without observations after this date are archived.</param>
+    /// <!-- aidoc:v1 sig=ab342f5 -->
     Task ArchivePatientWithoutObservationsSinceDate(DateTime date);
 
     /// <summary>
     /// Archives patient records for patients who have been discharged longer than the specified time threshold.
     /// </summary>
     /// <param name="hoursBeforeArchive">The number of hours a patient must have been discharged before being archived.</param>
+    /// <!-- aidoc:v1 sig=218184e -->
     Task ArchiveDischargedPatients(int hoursBeforeArchive);
     /// <summary>
     /// Retrieves all patients, optionally including their location data when requested.
     /// </summary>
     /// <param name="withLocation">Indicates whether location information should be included in the returned patient records.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Patient"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=4462ed0 -->
     Task<List<Patient>> FindAll(bool withLocation = false);
     /// <summary>
     /// Retrieves a paginated list of patients based on the provided pagination filter.
     /// </summary>
     /// <param name="filter">The pagination filter that defines the paging criteria used to retrieve patients.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{Patient}"/> with the requested page of patients.</returns>
+    /// <!-- aidoc:v1 sig=8405329 -->
     Task<PaginationResponse<Patient>> GetPaginatedPatients(PaginationFilter filter);
 
     /// <summary>
@@ -212,34 +241,40 @@ public interface IPatientService : IApiRequestService
     /// </summary>
     /// <param name="sinceDate">The date used to identify patients that have been inactive since this point in time.</param>
     /// <param name="hoursBeforeArchive">The number of hours of inactivity that must elapse before a discharged patient is archived.</param>
+    /// <!-- aidoc:v1 sig=ac3e223 -->
     Task DischargeInactivePatients(DateTime sinceDate, int hoursBeforeArchive);
     /// <summary>
     /// Updates an existing patient record with the provided patient data. Returns the updated patient, or <c>null</c> if no matching patient was found.
     /// </summary>
     /// <param name="updatedPatient">The patient object containing the updated information to be persisted.</param>
     /// <returns>A <see cref="Task{Patient}"/> that resolves to the updated <see cref="Patient"/>, or <c>null</c> if the patient could not be found.</returns>
+    /// <!-- aidoc:v1 sig=1b69c26 -->
     Task<Patient?> UpdateOne(Patient updatedPatient);
 
     /// <summary>
     /// Sends an asynchronous broadcast notification to inform relevant subscribers or systems about a newly registered patient.
     /// </summary>
     /// <param name="patient">The patient whose information will be included in the broadcast notification.</param>
+    /// <!-- aidoc:v1 sig=8b73b63 -->
     Task SendNewPatientBroadcast(Patient patient);
     /// <summary>
     /// Asynchronously sends a broadcast notification about an update to the specified patient.
     /// </summary>
     /// <param name="patient">The patient whose update information will be broadcast.</param>
+    /// <!-- aidoc:v1 sig=9f4f683 -->
     Task SendPatientUpdateBroadcast(Patient patient);
     /// <summary>
     /// Asynchronously retrieves the list of inactive Patients of Care (PoC), allowing consumers to identify
     /// patients that are no longer active in the system for reporting, cleanup, or follow-up workflows.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of inactive <see cref="Patient"/> records.</returns>
+    /// <!-- aidoc:v1 sig=1eb056c -->
     Task<List<Patient>> FindInActivePoC();
     /// <summary>
     /// Retrieves a list of patients associated with inactive PoC records.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Patient"/> objects associated with inactive PoC records.</returns>
+    /// <!-- aidoc:v1 sig=ace85d3 -->
     Task<List<Patient>> FindInInactivePoC();
 
     /// <summary>
@@ -250,6 +285,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="observations">Indicates whether the patient's observations should be included in the returned patient.</param>
     /// <param name="filterObservations">An optional list of observation identifiers used to filter which observations are returned when <paramref name="observations"/> is <c>true</c>.</param>
     /// <returns>A <see cref="Task{Patient}"/> that resolves to the matching <see cref="Patient"/>, or <c>null</c> if no patient is found for the given point of care.</returns>
+    /// <!-- aidoc:v1 sig=d512c37 -->
     Task<Patient?> GetByPointOfCare(PointOfCare item, bool observations = false,
             List<string>? filterObservations = null);
 
@@ -260,6 +296,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="unit">An optional unit that further filters the lookup.</param>
     /// <param name="localeEnum">An optional locale used to scope the search.</param>
     /// <returns>A task that yields the matching <see cref="Patient"/>, or <c>null</c> when no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=7e6d4de -->
     Task<Patient?> GetByPointOfCareAndLocale(PointOfCare item, Unit? unit, LocaleEnum? localeEnum);
     /// <summary>
     /// Updates the altable (allergy table) information for the specified patient and returns the updated patient.
@@ -268,12 +305,14 @@ public interface IPatientService : IApiRequestService
     /// <param name="altable">The option list containing the altable data to apply to the patient.</param>
     /// <param name="user">The user performing the update, or <c>null</c> when no user context is available.</param>
     /// <returns>A task that resolves to the updated <see cref="Patient"/>, or <c>null</c> if the patient was not found.</returns>
+    /// <!-- aidoc:v1 sig=6bc7695 -->
     Task<Patient?> UpdatePatientAltable(ObjectId patientId, OptionList altable, User? user);
     /// <summary>
     /// Exits a patient identified by the given identifier, optionally archiving the patient record.
     /// </summary>
     /// <param name="id">The unique identifier of the patient to exit.</param>
     /// <param name="archivePatient">When true, the patient record is archived as part of the exit process; when false, archiving is skipped.</param>
+    /// <!-- aidoc:v1 sig=8436023 -->
     Task ExitPatientById(ObjectId id, bool archivePatient = true);
 
     /// <summary>
@@ -285,6 +324,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="user">The user performing the update, or null if not specified.</param>
     /// <param name="carePlanLog">Optional care plan log entries associated with the update.</param>
     /// <returns>A task that returns the updated <see cref="Patient"/>, or null if the patient was not found.</returns>
+    /// <!-- aidoc:v1 sig=003aa16 -->
     Task<Patient?> UpdatePatientMasterList(ObjectId patientId, MasterListType typeName,
             List<OptionList> updatedOptions,
             User? user, List<OptionList>? carePlanLog);
@@ -297,6 +337,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="patient">The patient for whom the nurse care plan is generated and inserted.</param>
     /// <param name="user">The user associated with the care plan generation. May be null.</param>
     /// <returns>A task that completes when the nurse care plan has been generated and inserted.</returns>
+    /// <!-- aidoc:v1 sig=ddba9de -->
     Task GenerateNurseCarePlanAndInsert(MasterListType carePlanType, List<OptionList>? options,
             Patient patient, User? user);
 
@@ -305,6 +346,7 @@ public interface IPatientService : IApiRequestService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose incoming data is being updated.</param>
     /// <param name="person">The patient object containing the incoming data to be applied to the patient record.</param>
+    /// <!-- aidoc:v1 sig=43355e2 -->
     Task UpdatePatientIncomingData(ObjectId patientId, Patient person);
     /// <summary>
     /// Asynchronously updates the demographic data of an existing patient identified by the specified patient identifier.
@@ -312,6 +354,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientId">The unique identifier of the patient whose demographic data is to be updated.</param>
     /// <param name="person">The patient object containing the new demographic information to apply.</param>
     /// <param name="user">The user performing the update operation, or <see langword="null"/> if no user context is available.</param>
+    /// <!-- aidoc:v1 sig=592313b -->
     Task UpdatePatientDemographicData(ObjectId patientId, Patient person, User? user);
     /// <summary>
     /// Searches for a patient by their patient number within a distinct unit.
@@ -319,24 +362,28 @@ public interface IPatientService : IApiRequestService
     /// <param name="patientNumber">The patient number used to identify the patient.</param>
     /// <param name="unitId">The identifier of the distinct unit where the patient is registered.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Patient"/> if found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=1d70651 -->
     Task<Patient?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId);
     /// <summary>
     /// Asynchronously retrieves all patients whose procedures have been finished, filtering based on the specified archive threshold for procedure end times.
     /// </summary>
     /// <param name="archiveProcedureEndDateAfterMinutes">The number of minutes after the procedure end date used as the archive threshold to qualify patients with finished procedures.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Patient"/> objects that match the finished procedures criteria.</returns>
+    /// <!-- aidoc:v1 sig=d37257e -->
     Task<List<Patient>> FindAllPatientWithFinishedProcedures(int archiveProcedureEndDateAfterMinutes);
     /// <summary>
     /// Asynchronously retrieves all patients who have completed a test, using the specified archive window in minutes to determine which tests are considered finished.
     /// </summary>
     /// <param name="archiveTestEndDateAfterMinutes">The time window in minutes applied to the test end date to identify tests that should be treated as finished/archived.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Patient"/> instances with finished tests.</returns>
+    /// <!-- aidoc:v1 sig=650b7bb -->
     Task<List<Patient>> FindAllPatientWithFinishedTest(int archiveTestEndDateAfterMinutes);
     /// <summary>
     /// Retrieves a list of patients whose treatments have finished, based on the specified archive time threshold in minutes after the treatment end date.
     /// </summary>
     /// <param name="archiveTreatmentEndDateAfterMinutes">The number of minutes after the treatment end date used to determine which finished treatments should be included.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of patients with finished treatment matching the specified criteria.</returns>
+    /// <!-- aidoc:v1 sig=bef780c -->
     Task<List<Patient>> FindAllPatientWithFinishedTreatment(int archiveTreatmentEndDateAfterMinutes);
 
     /// <summary>
@@ -346,6 +393,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="person">The patient entity associated with the update.</param>
     /// <param name="personDataChange">The income data changes to apply to the patient.</param>
     /// <param name="user">The user performing the update operation.</param>
+    /// <!-- aidoc:v1 sig=9a965eb -->
     Task UpdatePatientIncomingData(ObjectId patientId, Patient person, PatientIncomeData personDataChange,
             User user);
 
@@ -355,6 +403,7 @@ public interface IPatientService : IApiRequestService
     /// <param name="opt">The update options for the master list item.</param>
     /// <param name="unitList">The collection of units associated with the update.</param>
     /// <param name="typeName">The name of the type used to categorize the master list item.</param>
+    /// <!-- aidoc:v1 sig=6d7dd8e -->
     Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList,
             string typeName);
 
@@ -364,5 +413,6 @@ public interface IPatientService : IApiRequestService
     /// <param name="opt">The option list containing the details of the patient master list item to delete.</param>
     /// <param name="unitList">The collection of units associated with the patient master list item.</param>
     /// <param name="typeName">The name of the type identifying the patient master list item to be deleted.</param>
+    /// <!-- aidoc:v1 sig=bbc71d1 -->
     Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPermissionService.cs b/adas-core.Application/Services/Interfaces/IPermissionService.cs
index 644f1fb6..e108e246 100644
--- a/adas-core.Application/Services/Interfaces/IPermissionService.cs
+++ b/adas-core.Application/Services/Interfaces/IPermissionService.cs
@@ -12,6 +12,7 @@ public interface IPermissionService
     /// <param name="display">The display for which permissions are being evaluated.</param>
     /// <param name="user">The user whose permissions for the display are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="DisplayPermissionTypes"/> granted to the user for the display.</returns>
+    /// <!-- aidoc:v1 sig=ba241eb -->
     public Task<DisplayPermissionTypes> GetPermissionsForDisplay(Display display, User user);
     /// <summary>
     /// Retrieves the display-friendly permission types applicable to the specified user for the given unit.
@@ -19,18 +20,21 @@ public interface IPermissionService
     /// <param name="unitId">The identifier of the unit whose permissions are being queried.</param>
     /// <param name="user">The user whose permissions for the unit should be evaluated.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="DisplayPermissionTypes"/> for the specified unit and user.</returns>
+    /// <!-- aidoc:v1 sig=a645ad9 -->
     public Task<DisplayPermissionTypes> GetPermissionsForUnit(string unitId, User user);
     /// <summary>
     /// Retrieves the panel permission types associated with the specified user.
     /// </summary>
     /// <param name="user">The user whose panel permissions are being queried.</param>
     /// <returns>The <see cref="PanelPermissionTypes"/> granted to the specified user.</returns>
+    /// <!-- aidoc:v1 sig=a5da6a5 -->
     public PanelPermissionTypes GetPermissionsForPanel(User user);
     /// <summary>
     /// Retrieves the panel permission types associated with the specified user.
     /// </summary>
     /// <param name="user">The identifier or name of the user whose panel permissions are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="PanelPermissionTypes"/> granted to the user.</returns>
+    /// <!-- aidoc:v1 sig=7d60015 -->
     public Task<PanelPermissionTypes> GetPermissionsForPanel(string user);
 
     /// <summary>
@@ -41,6 +45,7 @@ public interface IPermissionService
     /// <param name="source">The source permission type considered when evaluating access.</param>
     /// <param name="displayId">The identifier of the display for which access is being checked.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the user has access to the display; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d0c67ae -->
     Task<bool> HasAccessToDisplay(string username, PermissionEnum.RolesType role,
             PermissionEnum.SourcePermissionsEnum source, string displayId);
 
@@ -52,6 +57,7 @@ public interface IPermissionService
     /// <param name="source">The permission source used to resolve the user's access rights.</param>
     /// <param name="unitId">The identifier of the unit to check access against.</param>
     /// <returns>A task that resolves to <c>true</c> if the user has access to the specified unit; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=382550b -->
     Task<bool> HasAccessToUnit(string username, PermissionEnum.RolesType role,
             PermissionEnum.SourcePermissionsEnum source, string unitId);
 
@@ -62,6 +68,7 @@ public interface IPermissionService
     /// <param name="role">The role assigned to the user, used to resolve applicable permissions.</param>
     /// <param name="source">The source permission being checked against the user's access rights.</param>
     /// <returns>A task that resolves to <c>true</c> if the user has access to the panel; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=b661393 -->
     Task<bool> HasAccessToPanel(string username, PermissionEnum.RolesType role,
             PermissionEnum.SourcePermissionsEnum source);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPoCMappingService.cs b/adas-core.Application/Services/Interfaces/IPoCMappingService.cs
index 1fe3a559..833c6612 100644
--- a/adas-core.Application/Services/Interfaces/IPoCMappingService.cs
+++ b/adas-core.Application/Services/Interfaces/IPoCMappingService.cs
@@ -9,5 +9,6 @@ public interface IPoCMappingService
     /// </summary>
     /// <param name="original">The source patient location to map from.</param>
     /// <returns>A task that yields the mapped <see cref="PatientLocation"/>, or <c>null</c> if no mapping result is available.</returns>
+    /// <!-- aidoc:v1 sig=e9beb22 -->
     Task<PatientLocation?> Map(PatientLocation original);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPointOfCareService.cs b/adas-core.Application/Services/Interfaces/IPointOfCareService.cs
index ad90c6f1..4d4912f7 100644
--- a/adas-core.Application/Services/Interfaces/IPointOfCareService.cs
+++ b/adas-core.Application/Services/Interfaces/IPointOfCareService.cs
@@ -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);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPublisherService.cs b/adas-core.Application/Services/Interfaces/IPublisherService.cs
index 1b515c3b..e3ce9473 100644
--- a/adas-core.Application/Services/Interfaces/IPublisherService.cs
+++ b/adas-core.Application/Services/Interfaces/IPublisherService.cs
@@ -7,6 +7,7 @@ public interface IPublisherService
     /// </summary>
     /// <param name="queueName">The name of the queue to create.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <see langword="true"/> if the queue was created successfully; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=8ce64d8 -->
     Task<bool> CreateQueue(string queueName);
     /// <summary>
     /// Asynchronously sends an error message to the specified message queue.
@@ -14,6 +15,7 @@ public interface IPublisherService
     /// <param name="obj">The error payload or message object to be sent to the queue.</param>
     /// <param name="queueName">The name of the target message queue.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean value that indicates whether the message was successfully sent.</returns>
+    /// <!-- aidoc:v1 sig=4c43b3f -->
     Task<bool> SendMessageError(object obj, string queueName);
     /// <summary>
     /// Asynchronously sends the specified object as a message to the named queue.
@@ -21,6 +23,7 @@ public interface IPublisherService
     /// <param name="obj">The object payload to serialize and publish to the queue.</param>
     /// <param name="queueName">The name of the target queue that will receive the message.</param>
     /// <returns>A task that resolves to <c>true</c> if the message was sent successfully, otherwise <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=8eb8873 -->
     Task<bool> SendMessage(object obj, string queueName);
     /// <summary>
     /// Asynchronously sends a message to the specified message queue and returns a value indicating whether the operation succeeded.
@@ -28,5 +31,6 @@ public interface IPublisherService
     /// <param name="message">The message content to be sent to the queue.</param>
     /// <param name="queueName">The name of the target queue where the message will be delivered.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the message was sent successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e20a929 -->
     Task<bool> SendMessage(string message, string queueName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IPumpService.cs b/adas-core.Application/Services/Interfaces/IPumpService.cs
index 07fb3aba..cb6e03ef 100644
--- a/adas-core.Application/Services/Interfaces/IPumpService.cs
+++ b/adas-core.Application/Services/Interfaces/IPumpService.cs
@@ -14,6 +14,7 @@ public interface IPumpService: IApiRequestService
     /// Asynchronously inserts a pump observation record into the underlying data store.
     /// </summary>
     /// <param name="obs">The pump observation to persist.</param>
+    /// <!-- aidoc:v1 sig=dc84e4b -->
     Task InsertPumpObservation(PumpObservation obs);
 
     // Mapping
@@ -22,6 +23,7 @@ public interface IPumpService: IApiRequestService
     /// </summary>
     /// <param name="obs">The source pump observation to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PumpObservation"/> or <c>null</c> if no result is available.</returns>
+    /// <!-- aidoc:v1 sig=825d828 -->
     Task<PumpObservation?> MapPumpObservation(PumpObservation obs);
 
     // Consultas por paciente 
@@ -31,11 +33,13 @@ public interface IPumpService: IApiRequestService
     /// <param name="patientId">The unique identifier of the patient whose pump observations are being queried.</param>
     /// <param name="num">The maximum number of recent observations to return. Defaults to 1.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of the most recent pump observations for the patient, up to the specified count.</returns>
+    /// <!-- aidoc:v1 sig=c6e10b9 -->
     Task<List<PumpObservation>> FindLastPumpObservations(ObjectId patientId, int num = 1);
     /// <summary>
     /// Asynchronously retrieves the most recent observation timestamp for every patient, returning a dictionary keyed by patient identifier.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a dictionary mapping each patient's <see cref="ObjectId"/> to their last observation <see cref="DateTime"/>.</returns>
+    /// <!-- aidoc:v1 sig=cbcaa4c -->
     Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime();
 
     // Gestión de configuración
@@ -44,35 +48,41 @@ public interface IPumpService: IApiRequestService
     /// </summary>
     /// <param name="id">The unique identifier used to look up the configuration pump items.</param>
     /// <returns>A task that resolves to a list of <see cref="ConfigPumpItem"/> objects matching the given identifier, or <c>null</c> when no items are found.</returns>
+    /// <!-- aidoc:v1 sig=0480417 -->
     Task<List<ConfigPumpItem>?> GetItemsById(string id);
     /// <summary>
     /// Asynchronously retrieves the full list of pump configurations from the underlying data source.
     /// </summary>
     /// <returns>A task that resolves to a <see cref="List{ConfigPumps}"/> containing all pump configurations, or <c>null</c> if no configurations are available.</returns>
+    /// <!-- aidoc:v1 sig=b9aae05 -->
     Task<List<ConfigPumps>?> GetAllPumpConfig();
     /// <summary>
     /// Asynchronously retrieves the pump configuration associated with the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the pump configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ConfigPumps"/> instance matching the specified identifier, or <see langword="null"/> if no configuration is found.</returns>
+    /// <!-- aidoc:v1 sig=3958f50 -->
     Task<ConfigPumps?> GetPumpConfigsById(string id);
     /// <summary>
     /// Asynchronously updates the pump configuration.
     /// </summary>
     /// <param name="config">The pump configuration to update.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="ConfigPumps"/> or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=563e48a -->
     Task<ConfigPumps?> UpdatePumpConfig(ConfigPumps config);
     /// <summary>
     /// Inserts a new pump configuration into the system asynchronously.
     /// </summary>
     /// <param name="config">The pump configuration to be inserted.</param>
     /// <returns>A task that represents the asynchronous operation, containing the inserted <see cref="ConfigPumps"/> or <c>null</c> if the insertion fails.</returns>
+    /// <!-- aidoc:v1 sig=7fd9494 -->
     Task<ConfigPumps?> InsertPumpConfig(ConfigPumps config);
     /// <summary>
     /// Deletes the specified pump configuration.
     /// </summary>
     /// <param name="config">The pump configuration to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result is <c>true</c> if the configuration was deleted successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ce3f871 -->
     Task<bool> DeletePumpConfig(ConfigPumps config);
 
     // Paginación 
@@ -82,6 +92,7 @@ public interface IPumpService: IApiRequestService
     /// </summary>
     /// <param name="filter">The pagination filter that defines page size, page number, and any additional filtering criteria applied to the pump observations.</param>
     /// <returns>A task that resolves to a <see cref="PaginationResponse{PumpObservation}"/> containing the matching pump observations, or null when no results are found.</returns>
+    /// <!-- aidoc:v1 sig=f72dd47 -->
     Task<PaginationResponse<PumpObservation>?> GetPaginatedPump(PaginationFilter filter);
 
     // Archivado / limpieza
@@ -89,17 +100,20 @@ public interface IPumpService: IApiRequestService
     /// Asynchronously deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The ObjectId of the patient whose related records should be deleted.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Archives the specified patient, marking the patient record as archived in the system.
     /// </summary>
     /// <param name="patient">The patient to be archived.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Asynchronously archives the data associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose data should be archived.</param>
     /// <returns>A task that represents the asynchronous archive operation.</returns>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
 
     // Mantenimiento ids
@@ -109,5 +123,6 @@ public interface IPumpService: IApiRequestService
     /// <param name="nameId">The name of the field whose ObjectId value should be updated.</param>
     /// <param name="id">The new ObjectId value to assign.</param>
     /// <param name="oldId">The existing ObjectId value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IRecordingAlertService.cs b/adas-core.Application/Services/Interfaces/IRecordingAlertService.cs
index b22926ee..f2d7974c 100644
--- a/adas-core.Application/Services/Interfaces/IRecordingAlertService.cs
+++ b/adas-core.Application/Services/Interfaces/IRecordingAlertService.cs
@@ -12,21 +12,25 @@ public interface IRecordingAlertService : IApiRequestService
     /// <param name="patientId">The identifier of the patient whose recording alerts are being queried.</param>
     /// <param name="num">The maximum number of most recent recording alerts to return. Defaults to 2.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of the patient's most recent recording alerts.</returns>
+    /// <!-- aidoc:v1 sig=452ab2a -->
     Task<List<PatientRecordingAlert>> FindLastRecordingAlert(ObjectId patientId, int num = 2);
     /// <summary>
     /// Deletes records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose related records should be removed.</param>
+    /// <!-- aidoc:v1 sig=d457cb9 -->
     Task DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Asynchronously archives the specified patient, moving their record out of the active set.
     /// </summary>
     /// <param name="patient">The patient to archive.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Archives the records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> identifying the patient whose related records should be archived.</param>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
 
     /// <summary>
@@ -36,5 +40,6 @@ public interface IRecordingAlertService : IApiRequestService
     /// <param name="nameId">The identifier used to select the target records to update.</param>
     /// <param name="id">The new ObjectId value to assign to the matching records.</param>
     /// <param name="oldId">The existing ObjectId value to be replaced in the matching records.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IRecordingService.cs b/adas-core.Application/Services/Interfaces/IRecordingService.cs
index 19a1869c..c5c3f7a5 100644
--- a/adas-core.Application/Services/Interfaces/IRecordingService.cs
+++ b/adas-core.Application/Services/Interfaces/IRecordingService.cs
@@ -15,6 +15,7 @@ public interface IRecordingService : IApiRequestService
     /// <param name="patient">The patient whose recording should be cancelled.</param>
     /// <param name="poc">The point of care associated with the recording to be cancelled.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean value indicating the outcome of the cancel recording request.</returns>
+    /// <!-- aidoc:v1 sig=3c3bc68 -->
     Task<bool> SendCancelRecordingToRecordingApi(Patient patient, PointOfCare poc);
 
     /// <summary>
@@ -31,6 +32,7 @@ public interface IRecordingService : IApiRequestService
     /// <param name="alarmDescription">The description of the alarm, if applicable.</param>
     /// <param name="start">Indicates whether to start the recording (default is true).</param>
     /// <param name="type">The type of alarm (default is Manual).</param>
+    /// <!-- aidoc:v1 sig=aa9d33d -->
     Task SendRecordingDataToQueue(Patient patient, PointOfCare poc, DateTime? date, DateTime? endDate,
             DateTime? eventDate, AlarmEnum.Name? alarmName, AlarmEnum.Severity severity, string? alarmDescription,
             bool start = true, AlarmEnum.Type type = AlarmEnum.Type.Manual);
@@ -42,6 +44,7 @@ public interface IRecordingService : IApiRequestService
     /// <param name="poc">The point of care associated with the recording.</param>
     /// <param name="manualRecording">The manual recording payload to transmit.</param>
     /// <param name="start">A flag indicating whether the recording is being started or stopped.</param>
+    /// <!-- aidoc:v1 sig=102dc90 -->
     Task SendRecordingData(Patient patient, PointOfCare poc, ManualRecording manualRecording, bool start);
 
     /// <summary>
@@ -51,6 +54,7 @@ public interface IRecordingService : IApiRequestService
     /// <param name="poc">The point of care where the recording was taken.</param>
     /// <param name="automaticRecording">The automatic recording data to be sent.</param>
     /// <returns>A task that represents the asynchronous operation, containing a boolean indicating whether the data was sent successfully.</returns>
+    /// <!-- aidoc:v1 sig=0e48f1a -->
     Task<bool> SendAutoRecordingData(Patient patient, PointOfCare poc, RecordingData automaticRecording);
 
     /// <summary>
@@ -58,5 +62,6 @@ public interface IRecordingService : IApiRequestService
     /// </summary>
     /// <param name="roomName">The identifier of the room whose recordings are being requested.</param>
     /// <returns>A task that returns a list of <see cref="RecordingData"/> for the room, or <c>null</c> if no recordings are available.</returns>
+    /// <!-- aidoc:v1 sig=e92f1dd -->
     Task<List<RecordingData>?> GetRecordings(int roomName);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IRelayService.cs b/adas-core.Application/Services/Interfaces/IRelayService.cs
index 47b8c12a..4e118445 100644
--- a/adas-core.Application/Services/Interfaces/IRelayService.cs
+++ b/adas-core.Application/Services/Interfaces/IRelayService.cs
@@ -13,23 +13,27 @@ public interface IRelayService
     /// </summary>
     /// <param name="relay">The relay whose status is being checked.</param>
     /// <returns>A task that represents the asynchronous operation, containing the current <see cref="RelayEnum.Status"/> of the relay.</returns>
+    /// <!-- aidoc:v1 sig=2b11d08 -->
     Task<RelayEnum.Status> CheckRelayStatus(Relay relay);
     /// <summary>
     /// Asynchronously checks the current status of the relay identified by the specified identifier.
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay whose status is being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="RelayEnum.Status"/> of the requested relay.</returns>
+    /// <!-- aidoc:v1 sig=8240e77 -->
     Task<RelayEnum.Status> CheckRelayStatus(ObjectId relayId);
 
     /// <summary>
     /// Powers on the specified relay.
     /// </summary>
     /// <param name="relay">The relay to power on.</param>
+    /// <!-- aidoc:v1 sig=a6937ad -->
     Task PowerOn(Relay relay);
     /// <summary>
     /// Powers off the specified relay by sending a command to deactivate it.
     /// </summary>
     /// <param name="relay">The relay to power off.</param>
+    /// <!-- aidoc:v1 sig=5540326 -->
     Task PowerOff(Relay relay);
     /// <summary>
     /// Sets a manual relay with the specified status for the given point of contact and relay type.
@@ -37,18 +41,21 @@ public interface IRelayService
     /// <param name="status">The status to apply to the manual relay.</param>
     /// <param name="pocId">The identifier of the point of contact associated with the relay.</param>
     /// <param name="type">The type of relay to set manually.</param>
+    /// <!-- aidoc:v1 sig=a56b641 -->
     Task SetManualRelay(RelayEnum.Status status, ObjectId pocId, RelayEnum.Type type);
     /// <summary>
     /// Retrieves a relay by its unique identifier, returning <c>null</c> if no matching relay is found.
     /// </summary>
     /// <param name="relay">The unique identifier of the relay to look up.</param>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the <see cref="Relay"/> if found, or <c>null</c> if no relay matches the provided identifier.</returns>
+    /// <!-- aidoc:v1 sig=89a52df -->
     Task<Relay?> GetById(ObjectId relay);
     /// <summary>
     /// Retrieves the list of <see cref="Relay"/> objects corresponding to the specified collection of relay identifiers.
     /// </summary>
     /// <param name="relayList">The list of <see cref="ObjectId"/> values identifying the relays to retrieve. May be <c>null</c>.</param>
     /// <returns>A <see cref="List{Relay}"/> containing the relays found for the provided identifiers.</returns>
+    /// <!-- aidoc:v1 sig=cab20f9 -->
     List<Relay> GetRelayInList(List<ObjectId>? relayList);
     /// <summary>
     /// Retrieves the relays of a specified type from the provided configuration relay list.
@@ -56,6 +63,7 @@ public interface IRelayService
     /// <param name="configurationRelayList">The list of relay ObjectIds to filter, or null if no configuration relays are available.</param>
     /// <param name="type">The relay type to match against the configuration relays.</param>
     /// <returns>A list of <see cref="Relay"/> objects that match the specified <paramref name="type"/>.</returns>
+    /// <!-- aidoc:v1 sig=ac9918d -->
     List<Relay> GetRelayByTypeInList(List<ObjectId>? configurationRelayList, RelayEnum.Type type);
 
     /// <summary>
@@ -63,12 +71,14 @@ public interface IRelayService
     /// </summary>
     /// <param name="request">The pagination filter containing the criteria used to retrieve the relays.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated response with the requested relays.</returns>
+    /// <!-- aidoc:v1 sig=171773b -->
     Task<PaginationResponse<Relay>> GetPaginatedRelays(PaginationFilter request);
     /// <summary>
     /// Inserts a new relay record based on the provided request data.
     /// </summary>
     /// <param name="request">The relay entity to be inserted.</param>
     /// <returns>A task that resolves to the inserted <see cref="Relay"/>, or <c>null</c> if the insert did not return a value.</returns>
+    /// <!-- aidoc:v1 sig=8e83e60 -->
     Task<Relay?> InsertRelay(Relay request);
     /// <summary>
     /// Updates an existing relay identified by the specified <paramref name="objectId"/> with the provided <paramref name="relay"/> data.
@@ -77,5 +87,6 @@ public interface IRelayService
     /// <param name="objectId">The unique identifier of the relay to update.</param>
     /// <param name="relay">The relay data containing the updated values.</param>
     /// <returns>A task that resolves to the updated <see cref="Relay"/>, or <c>null</c> if the relay was not found.</returns>
+    /// <!-- aidoc:v1 sig=cbb172b -->
     Task<Relay?> UpdateRelayById(ObjectId objectId, Relay relay);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ISendAlertService.cs b/adas-core.Application/Services/Interfaces/ISendAlertService.cs
index 55b3e0be..79ccf966 100644
--- a/adas-core.Application/Services/Interfaces/ISendAlertService.cs
+++ b/adas-core.Application/Services/Interfaces/ISendAlertService.cs
@@ -8,15 +8,18 @@ public interface ISendAlertService
     /// Asynchronously retrieves a list of available queues.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Queue"/> instances.</returns>
+    /// <!-- aidoc:v1 sig=f99b362 -->
     Task<List<Queue>> GetQueues();
     /// <summary>
     /// Retrieves a list of performance records.
     /// </summary>
     /// <returns>A list of <see cref="Performance"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=3205076 -->
     List<Performance> GetPerformance();
     /// <summary>
     /// Retrieves a list of API clients.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="ApiClients"/>.</returns>
+    /// <!-- aidoc:v1 sig=5b1f979 -->
     Task<List<ApiClients>> GetApiClients();
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IServiceConfigService.cs b/adas-core.Application/Services/Interfaces/IServiceConfigService.cs
index 534634e3..1818052f 100644
--- a/adas-core.Application/Services/Interfaces/IServiceConfigService.cs
+++ b/adas-core.Application/Services/Interfaces/IServiceConfigService.cs
@@ -9,5 +9,6 @@ public interface IServiceConfigService
     /// </summary>
     /// <param name="id">The identifier of the service configuration to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="ServiceConfig"/> if found, or <c>null</c> if no configuration exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=86fa8c8 -->
     Task<ServiceConfig?> Get(string id);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ISubscriberGroupedService.cs b/adas-core.Application/Services/Interfaces/ISubscriberGroupedService.cs
index 396490c4..5344fea0 100644
--- a/adas-core.Application/Services/Interfaces/ISubscriberGroupedService.cs
+++ b/adas-core.Application/Services/Interfaces/ISubscriberGroupedService.cs
@@ -11,34 +11,40 @@ public interface ISubscriberGroupedService
     /// Retrieves a list of subscribers organized into groups.
     /// </summary>
     /// <returns>A list of <see cref="WsSubscriberGrouped"/> instances representing the grouped subscribers.</returns>
+    /// <!-- aidoc:v1 sig=f5051ca -->
     List<WsSubscriberGrouped> GetGrouped();
     /// <summary>
     /// Removes grouped observations associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose grouped observations should be removed.</param>
+    /// <!-- aidoc:v1 sig=f293e05 -->
     void RemoveGroupedObsByPatientId(string patientId);
     /// <summary>
     /// Removes a WebSocket subscriber associated with the specified patient based on the provided location.
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose WebSocket subscriber should be removed.</param>
     /// <param name="newLocation">The new patient location used to identify the subscriber to remove, or null to remove without location filtering.</param>
+    /// <!-- aidoc:v1 sig=a9f97d5 -->
     void RemoveWsSubscriberByLocation(string patientId, PatientLocation? newLocation);
     /// <summary>
     /// Removes the specified workstation identifier associated with a patient's WS subscriber entry.
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose WS subscriber entry will be updated.</param>
     /// <param name="wsIdToRemove">The workstation identifier to remove from the patient's WS subscriber entry.</param>
+    /// <!-- aidoc:v1 sig=4add1da -->
     void RemoveWsSubscriberPatientIdAndWsId(string patientId, string wsIdToRemove);
     /// <summary>
     /// Validates the provided <see cref="WsSubscriberGrouped"/> instance to identify empty subscriber groups.
     /// </summary>
     /// <param name="wsl">The subscriber group instance to be checked for empty groups.</param>
     /// <returns>A <see cref="List{String}"/> containing validation messages for any empty subscriber groups found; returns an empty list if all groups are valid.</returns>
+    /// <!-- aidoc:v1 sig=d6864a4 -->
     List<string> CheckEmptySubscriberGroup(WsSubscriberGrouped wsl);
     /// <summary>
     /// Adds a new subscriber together with its associated group information to the system.
     /// </summary>
     /// <param name="wsSubscriberGrouped">The web service representation of the subscriber and its group assignments to be added.</param>
+    /// <!-- aidoc:v1 sig=fdb64fe -->
     void AddSubscriberGrouped(WsSubscriberGrouped wsSubscriberGrouped);
 
     /// <summary>
@@ -49,6 +55,7 @@ public interface ISubscriberGroupedService
     /// <param name="timeZoneId">The time zone identifier used for the observation context.</param>
     /// <param name="connectionId">The connection identifier for the current request or session.</param>
     /// <param name="go">The grouped observation to be checked against the subscription.</param>
+    /// <!-- aidoc:v1 sig=adb6856 -->
     void CheckOnSubscriptionGroup(GroupedField groupedField, ObjectId patientId, string timeZoneId, string connectionId,
             GroupedObservation go);
 
@@ -57,5 +64,6 @@ public interface ISubscriberGroupedService
     /// </summary>
     /// <param name="wsgHashCode">The hash code identifying the group whose last grouped observation should be updated.</param>
     /// <param name="newGroupedObservation">The new grouped observation to set as the last grouped observation in the group.</param>
+    /// <!-- aidoc:v1 sig=3b3409a -->
     void UpdateLastGroupedObsInGroup(string wsgHashCode, GroupedObservation newGroupedObservation);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ISubscribersService.cs b/adas-core.Application/Services/Interfaces/ISubscribersService.cs
index 54e555de..1c241a8d 100644
--- a/adas-core.Application/Services/Interfaces/ISubscribersService.cs
+++ b/adas-core.Application/Services/Interfaces/ISubscribersService.cs
@@ -9,28 +9,33 @@ public interface ISubscribersService
     /// Retrieves the list of subscribers.
     /// </summary>
     /// <returns>A list of <see cref="WsSubscriber"/> instances representing the subscribers.</returns>
+    /// <!-- aidoc:v1 sig=7e137ae -->
     List<WsSubscriber> GetSubscribers();
     /// <summary>
     /// Retrieves a <see cref="WsSubscriber"/> associated with the specified context connection identifier.
     /// </summary>
     /// <param name="contextConnectionId">The unique identifier of the context connection used to look up the subscriber.</param>
     /// <returns>The <see cref="WsSubscriber"/> matching the given connection identifier, or <c>null</c> if no subscriber is found.</returns>
+    /// <!-- aidoc:v1 sig=b24d002 -->
     WsSubscriber? GetById(string contextConnectionId);
     /// <summary>
     /// Retrieves the list of subscribers associated with the specified point of contact (POC) identifier.
     /// </summary>
     /// <param name="pocId">The identifier of the point of contact whose subscribers should be returned.</param>
     /// <returns>A list of <see cref="WsSubscriber"/> instances matching the provided POC identifier.</returns>
+    /// <!-- aidoc:v1 sig=aec8331 -->
     List<WsSubscriber> GetByPocId(ObjectId pocId);
     /// <summary>
     /// Removes a connection identified by the specified context connection identifier.
     /// </summary>
     /// <param name="contextConnectionId">The unique identifier of the connection to remove.</param>
     /// <returns>An integer indicating the result of the removal operation.</returns>
+    /// <!-- aidoc:v1 sig=26b732e -->
     int RemoveConnectionById(string contextConnectionId);
     /// <summary>
     /// Registers the specified WebSocket subscriber to receive notifications or messages.
     /// </summary>
     /// <param name="subscriber">The <see cref="WsSubscriber"/> instance to be added to the collection of subscribers.</param>
+    /// <!-- aidoc:v1 sig=695cf06 -->
     void AddSubscriber(WsSubscriber subscriber);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/ITreatmentService.cs b/adas-core.Application/Services/Interfaces/ITreatmentService.cs
index fc8c953e..4432271f 100644
--- a/adas-core.Application/Services/Interfaces/ITreatmentService.cs
+++ b/adas-core.Application/Services/Interfaces/ITreatmentService.cs
@@ -13,33 +13,39 @@ public interface ITreatmentService : IApiRequestService
     /// Inserts a new <see cref="PatientTreatment"/> record into the underlying data store.
     /// </summary>
     /// <param name="treatment">The patient treatment entity to be added.</param>
+    /// <!-- aidoc:v1 sig=64e0091 -->
     Task Insert(PatientTreatment treatment);
     /// <summary>
     /// Asynchronously deletes an entity associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> representing the unique identifier of the patient whose related entity should be removed.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing <c>true</c> if the deletion was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=fa9d1b9 -->
     Task<bool> DeleteByPatientId(ObjectId id);
     /// <summary>
     /// Asynchronously deletes the entity identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the entity to delete.</param>
+    /// <!-- aidoc:v1 sig=9d4aeba -->
     Task DeleteById(ObjectId id);
     /// <summary>
     /// Archives records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The ObjectId of the patient whose records should be archived.</param>
+    /// <!-- aidoc:v1 sig=e5916ec -->
     Task ArchiveByPatientId(ObjectId id);
     /// <summary>
     /// Archives the specified patient, marking them as archived in the system.
     /// </summary>
     /// <param name="patient">The patient to archive.</param>
+    /// <!-- aidoc:v1 sig=52c2373 -->
     Task Archive(Patient patient);
     /// <summary>
     /// Updates an existing patient treatment record in the system.
     /// </summary>
     /// <param name="patientTreatment">The patient treatment entity containing the updated information to be persisted.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if the treatment was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=fa7946f -->
     Task<bool> UpdateTreatment(PatientTreatment patientTreatment);
     /// <summary>
     /// Updates many records by replacing the specified old ObjectId with the new ObjectId in the field identified by nameId.
@@ -47,42 +53,49 @@ public interface ITreatmentService : IApiRequestService
     /// <param name="nameId">The name of the field that contains the ObjectId to be updated.</param>
     /// <param name="id">The new ObjectId value that will replace the existing one.</param>
     /// <param name="oldId">The existing ObjectId value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=24ef97c -->
     Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId);
     /// <summary>
     /// Retrieves all treatments associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose treatments are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of PatientTreatment objects for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=464e56c -->
     Task<IEnumerable<PatientTreatment>> GetTreatmentsByPatientId(ObjectId id);
     /// <summary>
     /// Retrieves the active treatment records associated with the specified patient identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose active treatments should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of active <see cref="PatientTreatment"/> records, which may include null entries.</returns>
+    /// <!-- aidoc:v1 sig=9eb0d98 -->
     Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a cursor over the <see cref="PatientTreatment"/> records associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments should be returned.</param>
     /// <returns>A <see cref="Task{TResult}"/> yielding an <see cref="IAsyncCursor{TDocument}"/> that iterates the matching <see cref="PatientTreatment"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=1be8597 -->
     Task<IAsyncCursor<PatientTreatment>> FindByPatientIdAsync(ObjectId patientId);
     /// <summary>
     /// Asynchronously retrieves all patient treatments associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="PatientTreatment"/> instances for the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=8e33f27 -->
     Task<IEnumerable<PatientTreatment>> FindByPatientId(ObjectId patientId);
     /// <summary>
     /// Retrieves the list of bolus treatments associated with the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose bolus treatments are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> records representing the patient's bolus treatments.</returns>
+    /// <!-- aidoc:v1 sig=e8ec7d6 -->
     Task<List<PatientTreatment>> GetBolusTreatments(ObjectId patientId);
     /// <summary>
     /// Retrieves a paginated list of patient treatments based on the specified filter criteria.
     /// </summary>
     /// <param name="filter">The pagination filter used to control the page number, page size, and other query options.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated patient treatment results.</returns>
+    /// <!-- aidoc:v1 sig=b165424 -->
     Task<PaginationResponse<PatientTreatment>> GetPaginatedTreatments(PaginationFilter filter);
     /// <summary>
     /// Retrieves the list of active treatments associated with the specified patient, sorted according to the provided order parameter.
@@ -90,5 +103,6 @@ public interface ITreatmentService : IApiRequestService
     /// <param name="patientId">The unique identifier of the patient whose active treatments are being queried.</param>
     /// <param name="order">A string defining the ordering criteria applied to the returned treatments.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of active <see cref="PatientTreatment"/> entries for the patient.</returns>
+    /// <!-- aidoc:v1 sig=d9fb0b1 -->
     Task<List<PatientTreatment>> GetActiveTreatmentsByPatientIdAndOrder(ObjectId patientId, string order);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/Interfaces/IUnitService.cs b/adas-core.Application/Services/Interfaces/IUnitService.cs
index 8b21f112..3d333c40 100644
--- a/adas-core.Application/Services/Interfaces/IUnitService.cs
+++ b/adas-core.Application/Services/Interfaces/IUnitService.cs
@@ -15,11 +15,13 @@ public interface IUnitService
     /// </summary>
     /// <param name="withPocs">Indicates whether the returned units should include their associated POCs.</param>
     /// <returns>A task representing the asynchronous operation, containing the list of units.</returns>
+    /// <!-- aidoc:v1 sig=d5d641e -->
     Task<List<Unit>> GetAll(bool withPocs = false);
     /// <summary>
     /// Asynchronously retrieves a compact list of all units, returning minimal summary information for each unit.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="UnitInfoDto"/> objects with the compact information of all units.</returns>
+    /// <!-- aidoc:v1 sig=85c8e61 -->
     Task<List<UnitInfoDto>> GetAllCompact();
 
     /// <summary>
@@ -27,6 +29,7 @@ public interface IUnitService
     /// </summary>
     /// <param name="id">The unique identifier of the unit to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the compact unit information.</returns>
+    /// <!-- aidoc:v1 sig=ea6d80a -->
     Task<UnitInfoDto> GetOneCompact(ObjectId id);
 
     // Task<Unit?> GetByCodeSysAndCode(string unit);
@@ -35,6 +38,7 @@ public interface IUnitService
     /// </summary>
     /// <param name="unit">The name of the unit to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Unit"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=d855f4f -->
     Task<Unit?> GetByName(string unit);
 
     // Task<Unit?> GetByPointOfCare(PointOfCare pointOfCare);
@@ -46,6 +50,7 @@ public interface IUnitService
     /// <param name="fillLists">When <see langword="true"/>, populates the related lists on the returned unit.</param>
     /// <param name="withPoCs">When <see langword="true"/>, includes the unit's points of contact in the result.</param>
     /// <returns>A task that yields the located <see cref="Unit"/>, or <see langword="null"/> if no unit matches the given id.</returns>
+    /// <!-- aidoc:v1 sig=59363d0 -->
     Task<Unit?> GetInfo(ObjectId id, LocaleEnum? dataLocale, bool fillLists = true, bool withPoCs = false);
     /// <summary>
     /// Retrieves information about a unit identified by the specified <paramref name="id"/>, optionally including related points of contact and devices.
@@ -54,6 +59,7 @@ public interface IUnitService
     /// <param name="withPoCs">Indicates whether related points of contact should be included in the result. Defaults to <c>true</c>.</param>
     /// <param name="withDevices">Indicates whether related devices should be included in the result. Defaults to <c>true</c>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <c>Unit</c> if found, or <c>null</c> if no unit matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=83c1253 -->
     Task<Unit?> GetInfo(ObjectId id, bool withPoCs = true, bool withDevices = true);
 
     /// <summary>
@@ -61,6 +67,7 @@ public interface IUnitService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose unit is being looked up.</param>
     /// <returns>A task that represents the asynchronous lookup, containing the matching <see cref="Unit"/> if found, or <c>null</c> if no unit is associated with the patient.</returns>
+    /// <!-- aidoc:v1 sig=2a55026 -->
     Task<Unit?> FindByPatientId(ObjectId patientId);
 
     // Task<List<Unit>?> FindByLocation(PatientLocation location);
@@ -69,12 +76,14 @@ public interface IUnitService
     /// </summary>
     /// <param name="id">The unique identifier of the <see cref="Unit"/> to retrieve. May be <c>null</c>.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="Unit"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=31e43d9 -->
     Task<Unit?> FindById(ObjectId? id);
     /// <summary>
     /// Asynchronously retrieves a <see cref="Unit"/> entity matching the specified name.
     /// </summary>
     /// <param name="name">The name used to look up the unit. Can be null.</param>
     /// <returns>A task that resolves to the matching <see cref="Unit"/> if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=1e5dd65 -->
     Task<Unit?> FindByName(string? name);
 
     /// <summary>
@@ -84,6 +93,8 @@ public interface IUnitService
     /// <param name="name">The unit name to search for. May be <c>null</c>.</param>
     /// <param name="pocName">The point-of-contact (POC) name to search for. May be <c>null</c>.</param>
     /// <returns>A <see cref="Task{Unit}"/> containing the matched <see cref="Unit"/>, or <c>null</c> if no unit is found.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "<see cref=\"Task{Unit}\"/> should be <see cref=\"Task{Unit?}\"/> to reflect the nullable Unit return type; text correctly describes null result." -->
     Task<Unit?> FindByUnitNameOrPocName(string? name, string? pocName);
 
     //Task<Unit?> FindByPointOfCare(PointOfCare pointOfCare);
@@ -92,12 +103,14 @@ public interface IUnitService
     /// </summary>
     /// <param name="unit">The <see cref="Unit"/> instance to be inserted.</param>
     /// <returns>A task that resolves to the inserted <see cref="Unit"/>, or <c>null</c> if the insertion did not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=dcc73fd -->
     Task<Unit?> InsertOne(Unit unit);
     /// <summary>
     /// Updates the specified unit in the system.
     /// </summary>
     /// <param name="unit">The unit containing the updated information to persist.</param>
     /// <returns>A task that returns the updated <see cref="Unit"/>, or <c>null</c> if the unit was not found.</returns>
+    /// <!-- aidoc:v1 sig=fb3e248 -->
     Task<Unit?> UpdateUnit(Unit unit);
     /// <summary>
     /// Asynchronously retrieves the collection of units associated with the specified master list identifier and master list type.
@@ -106,6 +119,7 @@ public interface IUnitService
     /// <param name="masterListId">The unique identifier of the master list whose units should be retrieved.</param>
     /// <param name="masterListType">The type of the master list used to scope the unit lookup.</param>
     /// <returns>A task that returns an <see cref="IEnumerable{T}"/> of <see cref="Unit"/> when matches exist, or null when no matching units are found.</returns>
+    /// <!-- aidoc:v1 sig=af11dcc -->
     Task<IEnumerable<Unit>?> FindUnitsByMasterListId(ObjectId masterListId, MasterListType masterListType);
     /// <summary>
     /// Asynchronously counts the number of units associated with the specified master list, filtered by the given master list type.
@@ -113,18 +127,21 @@ public interface IUnitService
     /// <param name="masterListId">The unique identifier of the master list whose units should be counted.</param>
     /// <param name="masterListType">The type of the master list used to scope the count to the appropriate unit category.</param>
     /// <returns>A <see cref="Task{Int64}"/> that represents the asynchronous operation, containing the total number of units matching the specified master list.</returns>
+    /// <!-- aidoc:v1 sig=64362ca -->
     Task<long> CountUnitsByMasterListId(ObjectId masterListId, MasterListType masterListType);
     /// <summary>
     /// Asynchronously retrieves the collection of units associated with the specified master list identifier.
     /// </summary>
     /// <param name="masterListId">The identifier of the master list whose units are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing the collection of units that belong to the specified master list.</returns>
+    /// <!-- aidoc:v1 sig=2e9fc3b -->
     Task<IEnumerable<Unit>> FindUnitsByMasterListId(ObjectId masterListId);
     /// <summary>
     /// Updates the unit master list based on the provided unit ID list DTO.
     /// </summary>
     /// <param name="updateUnitListDto">The DTO containing the list of unit IDs to be used for updating the master list.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Unit"/>, or <c>null</c> if the update was not applicable.</returns>
+    /// <!-- aidoc:v1 sig=4b7663f -->
     Task<Unit?> UpdateUnitMasterList(UpdateUnitIdListDto updateUnitListDto);
     /// <summary>
     /// Asynchronously updates the configuration for the specified unit using the provided configuration data.
@@ -132,12 +149,14 @@ public interface IUnitService
     /// <param name="unitIdParsed">The parsed identifier of the unit whose configuration will be updated.</param>
     /// <param name="unitConfiguration">The new configuration values to apply to the unit.</param>
     /// <returns>A task that resolves to <c>true</c> if the configuration was successfully updated; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=bfe899b -->
     Task<bool> UpdateConfiguration(ObjectId unitIdParsed, UnitConfiguration unitConfiguration);
     /// <summary>
     /// Asynchronously deletes a unit identified by the provided <paramref name="unit"/> entity's identifier.
     /// </summary>
     /// <param name="unit">The unit entity whose identifier is used to locate and delete the record.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing a value indicating whether the unit was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=734db28 -->
     Task<bool> DeleteUnitById(Unit unit);
     /// <summary>
     /// Updates the information of an existing unit identified by <paramref name="unitId"/>, including its name, title, and optionally its configuration object ID.
@@ -148,6 +167,7 @@ public interface IUnitService
     /// <param name="title">The new title to assign to the unit.</param>
     /// <param name="configObsId">An optional configuration object ID to associate with the unit.</param>
     /// <returns>A task that yields the updated <see cref="Unit"/>, or <c>null</c> if the unit does not exist.</returns>
+    /// <!-- aidoc:v1 sig=89b9f8d -->
     Task<Unit?> UpdateUnitInfo(ObjectId unitId, string name, string title, string? configObsId = null);
     /// <summary>
     /// Retrieves a paginated list of units based on the provided filter, optionally including their associated points of contact.
@@ -155,5 +175,6 @@ public interface IUnitService
     /// <param name="filter">The pagination filter that defines the page size, page number, and any additional query criteria.</param>
     /// <param name="withPoCs">A flag indicating whether the response should include the points of contact associated with each unit.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated response of units.</returns>
+    /// <!-- aidoc:v1 sig=5b42d0a -->
     Task<PaginationResponse<Unit>> GetPaginatedUnits(PaginationFilter filter, bool withPoCs);
 }
\ No newline at end of file
diff --git a/adas-core.Application/Services/LocalAuditService.cs b/adas-core.Application/Services/LocalAuditService.cs
index 5e797b2d..cae454a1 100644
--- a/adas-core.Application/Services/LocalAuditService.cs
+++ b/adas-core.Application/Services/LocalAuditService.cs
@@ -21,6 +21,7 @@ public class LocalAuditService(
     /// <param name="dataOriginal">The original data before the change.</param>
     /// <param name="dataModified">The modified data after the change.</param>
     /// <param name="reason">An optional reason for the change; when null, the audit log is created without supplying a reason.</param>
+    /// <!-- aidoc:v1 sig=5416223 body=dfb91a0 -->
     public async Task CreateAuditLogAsync(ClaimsPrincipal? user, object? dataOriginal, object? dataModified,
             string? reason)
     {
@@ -48,6 +49,7 @@ public class LocalAuditService(
     /// </summary>
     /// <param name="data">The data to be deep copied.</param>
     /// <returns>A task representing the asynchronous operation, containing the deep copy of the data, or <c>null</c> if both copy methods fail.</returns>
+    /// <!-- aidoc:v1 sig=8c305ad body=f157829 -->
     public async Task<T?> DeepCopyAsync<T>(T data)
     {
         try
diff --git a/adas-core.Application/Services/MasterListService.cs b/adas-core.Application/Services/MasterListService.cs
index f3bc3ac2..dca1880d 100644
--- a/adas-core.Application/Services/MasterListService.cs
+++ b/adas-core.Application/Services/MasterListService.cs
@@ -23,6 +23,7 @@ namespace adas_core.Application.Services;
 /// Acts as the concrete implementation of the <see cref="IMasterListService{T}"/> contract for master list operations.
 /// </summary>
 /// <typeparam name="T">The type of master list entity managed by the service. Must derive from <see cref="MasterList"/> and expose a public parameterless constructor.</typeparam>
+/// <!-- aidoc:v1 sig=6dd13a3 -->
 public class MasterListService<T> : IMasterListService<T> where T : MasterList, new()
 {
     private readonly Lazy<IAdmissionService> _admissionService;
@@ -88,6 +89,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="id">The identifier of the master list to delete.</param>
     /// <exception cref="ConflictException">Thrown when the master list is currently in use and cannot be deleted.</exception>
+    /// <!-- aidoc:v1 sig=bbde86c body=1e4169e -->
     public async Task DeleteMasterListById(ObjectId id)
     {
         var repository = GetRepository();
@@ -133,6 +135,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list to which the option will be added.</param>
     /// <param name="opt">The filter option element to add to the master list.</param>
     /// <returns>The resulting <see cref="OptionList"/> entry if the option is successfully added; <c>null</c> if the master list cannot be found, no result is produced, or an error is encountered during the operation.</returns>
+    /// <!-- aidoc:v1 sig=1602f0d body=c7da593 -->
     public async Task<OptionList?> AddOptionToMasterList(ObjectId id, FilterOptionListElement opt)
     {
         try
@@ -172,6 +175,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="typeName">The type name used when propagating the update to the patient item list.</param>
     /// <param name="locale">The locale used for the master list option update and retrieval of the updated entity for auditing.</param>
     /// <returns>The updated <see cref="OptionList"/>, or <c>null</c> if the update failed, the result was <c>null</c>, or an exception occurred.</returns>
+    /// <!-- aidoc:v1 sig=da045e6 body=6f739c4 -->
     public async Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList opt, string typeName,
             LocaleEnum locale)
     {
@@ -210,6 +214,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="opt">The option containing the new values to apply.</param>
     /// <param name="typeName">The name of the type used when updating the associated patient item list.</param>
     /// <returns>The updated <see cref="OptionList"/> if the operation succeeds, or <c>null</c> if the master list is not found or an exception is thrown.</returns>
+    /// <!-- aidoc:v1 sig=f0915ad body=ec1df57 -->
     public async Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList opt, string typeName)
     {
         try
@@ -249,6 +254,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="opt">The option with the new values to apply to the master list.</param>
     /// <param name="typeName">The name of the entity type used when updating the related patient item list.</param>
     /// <returns>The updated <see cref="OptionList"/> when the operation succeeds; <c>null</c> when the update fails or an error is caught.</returns>
+    /// <!-- aidoc:v1 sig=4a7ad76 body=2986e84 -->
     public async Task<OptionList?> UpdateFullMasterListOption(ObjectId id, OptionList opt, string typeName)
     {
         try
@@ -286,6 +292,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="optId">The identifier of the option to remove from the master list.</param>
     /// <param name="typeName">The name of the type used when cascading the deletion to related patient item lists.</param>
     /// <returns>A task that resolves to <c>true</c> when the option is successfully deleted and the side-effects are applied; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=e654e5f body=b693722 -->
     public async Task<bool> DeleteMasterListOption(ObjectId id, ObjectId optId, string typeName)
     {
         try
@@ -322,6 +329,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list whose option details will be updated.</param>
     /// <param name="opt">The new option details to apply to the master list.</param>
     /// <returns>A task that yields the updated <see cref="UpdateMasterListDetailsDto"/> on success, or <c>null</c> when the update fails or an exception is caught and logged.</returns>
+    /// <!-- aidoc:v1 sig=53d4179 body=f5f38c9 -->
     public async Task<UpdateMasterListDetailsDto?> UpdateOptionDetailsToMasterList(ObjectId id,
             UpdateMasterListDetailsDto opt)
     {
@@ -354,6 +362,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list to rename.</param>
     /// <param name="name">The new name to assign to the master list.</param>
     /// <returns>A task that resolves to <c>true</c> if the master list name was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=5b79a51 body=2b55065 -->
     public async Task<bool> UpdateMasterListName(ObjectId id, string name)
     {
         try
@@ -384,6 +393,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list to update.</param>
     /// <param name="name">The new description to apply to the master list.</param>
     /// <returns>A task that resolves to <c>true</c> if the update succeeded; otherwise, <c>false</c> when the update fails or an exception is caught and logged.</returns>
+    /// <!-- aidoc:v1 sig=f402203 body=2065699 -->
     public async Task<bool> UpdateMasterListDescription(ObjectId id, string name)
     {
         try
@@ -414,6 +424,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list from which the option will be removed.</param>
     /// <param name="oldOpt">The option to remove from the master list.</param>
     /// <returns>A task that resolves to <c>true</c> if the option was successfully removed; <c>false</c> if the operation failed or an error occurred.</returns>
+    /// <!-- aidoc:v1 sig=8de50cd body=2393e14 -->
     public async Task<bool> RemoveMasterListOption(ObjectId id, OptionList oldOpt)
     {
         try
@@ -444,6 +455,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// If an exception occurs during retrieval, the error is logged and an empty collection is returned as a fallback.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains all retrieved entries, or an empty collection if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=438d930 body=23055ad -->
     public async Task<IEnumerable<T>> GetAllMasterList()
     {
         try
@@ -463,6 +475,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// If an error occurs, the exception is logged and an empty collection is returned as a fallback.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="MasterListDto"/> items, or an empty collection if an error is encountered.</returns>
+    /// <!-- aidoc:v1 sig=ff97d15 body=6dc7eab -->
     public async Task<IEnumerable<MasterListDto>> GetAllMasterListWithoutOptions()
     {
         try
@@ -485,6 +498,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="optionId">The identifier of the specific option to locate.</param>
     /// <param name="locale">The locale used to resolve the localized option item.</param>
     /// <returns>A <see cref="Task{T}"/> containing the matching <see cref="OptionList"/>, or <c>null</c> if no item is found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=fdb2628 body=57f7d69 -->
     public async Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId, LocaleEnum locale)
     {
         try
@@ -505,6 +519,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="request">The pagination filter whose page size is applied when building each result entry.</param>
     /// <returns>A task that yields an enumerable of <see cref="MasterListWithPaginatedOptionsDto"/> containing the mapped master lists, or an empty enumerable if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=e2b42f3 body=87dac37 -->
     public async Task<IEnumerable<MasterListWithPaginatedOptionsDto>> GetAllMasterListWithPaginatedOptions(
             PaginationFilter request)
     {
@@ -534,6 +549,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// Returns 0 if an error occurs while accessing the repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the total count of records, or 0 if an error was encountered.</returns>
+    /// <!-- aidoc:v1 sig=c52b4f8 body=ba61e78 -->
     public async Task<int> GetAllMasterListCount()
     {
         try
@@ -555,6 +571,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The unique identifier of the master list to retrieve.</param>
     /// <param name="locale">The optional locale used to localize the retrieved master list.</param>
     /// <returns>The master list of type <typeparamref name="T"/> if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=3e8f3d7 body=947fcc9 -->
     public async Task<T?> GetMasterListById(ObjectId id, LocaleEnum? locale)
     {
         try
@@ -576,6 +593,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The unique identifier of the master list to retrieve.</param>
     /// <param name="request">The pagination filter that determines the page size for the returned options.</param>
     /// <returns>A task that yields a <see cref="MasterListWithPaginatedOptionsDto"/> when the master list is found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=d2dd8ff body=6215360 -->
     public async Task<MasterListWithPaginatedOptionsDto?> GetMasterListByIdWithPaginatedOptions(ObjectId id,
             PaginationFilter request)
     {
@@ -604,6 +622,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="id">The identifier of the master list whose option names are to be retrieved.</param>
     /// <returns>A list of option names for the found master list, or an empty list if the list is not found or an error is encountered.</returns>
+    /// <!-- aidoc:v1 sig=6fb6e81 body=27002bc -->
     public async Task<List<string>> GetMasterListOptionsNamesById(ObjectId id)
     {
         try
@@ -629,6 +648,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier used to locate the master list in the repository.</param>
     /// <param name="textSearch">The optional text search term used to filter the results; may be null.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="OptionList"/> entries that match the specified identifier and text search criteria.</returns>
+    /// <!-- aidoc:v1 sig=a3a824e body=218b0ef -->
     public async Task<List<OptionList>> GetMasterListByIdAndTextSearch(ObjectId id, string? textSearch)
     {
         try
@@ -649,6 +669,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier used to locate the master list.</param>
     /// <param name="filterOption">The filter options applied to narrow the search within the master list.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="OptionList"/> items matching the given criteria.</returns>
+    /// <!-- aidoc:v1 sig=2a76fbd body=1d979f3 -->
     public async Task<List<OptionList>> GetMasterListByIdAndSearchOptions(ObjectId id,
             FilterOptionListElement filterOption)
     {
@@ -661,6 +682,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="name">The name of the master list entry to look up.</param>
     /// <returns>A task that resolves to the matching item of type T, or null when no item is found or the lookup fails.</returns>
+    /// <!-- aidoc:v1 sig=4e2a946 body=4d99da2 -->
     public async Task<T?> GetMasterListByName(string name)
     {
         try
@@ -681,6 +703,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to determine the subset of records to return.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{T}"/> with the paginated data, the current page number, the page size, and the total document count.</returns>
+    /// <!-- aidoc:v1 sig=c6c73b2 body=8453888 -->
     public async Task<PaginationResponse<T>> GetPaginatedMasterList(PaginationFilter filter)
     {
         var repository = GetRepository();
@@ -707,6 +730,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="listFilter">Pagination parameters (page number and page size) used to slice the master list result set.</param>
     /// <param name="optionFilter">Pagination parameters whose page size is applied to the options associated with each returned master list item.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing a <see cref="PaginationResponse{T}"/> of <see cref="MasterListWithPaginatedOptionsDto"/> with the requested page of master lists, their paginated options, the current page metadata, and the total document count.</returns>
+    /// <!-- aidoc:v1 sig=97d48e5 body=dadadb5 -->
     public async Task<PaginationResponse<MasterListWithPaginatedOptionsDto>> GetPaginatedMasterListWithPaginatedOptions(
             PaginationFilter listFilter, PaginationFilter optionFilter)
     {
@@ -741,6 +765,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="filter">The pagination filter that defines the page number and page size to apply to the results.</param>
     /// <param name="listId">The identifier of the list whose options are being retrieved.</param>
     /// <returns>A <see cref="PaginationResponse{OptionList}"/> containing the requested page of options, the current page metadata, and the total count of available options.</returns>
+    /// <!-- aidoc:v1 sig=5a05956 body=0aee55a -->
     public async Task<PaginationResponse<OptionList>> GetPaginatedOptions(PaginationFilter filter, ObjectId listId)
     {
         var repository = GetRepository();
@@ -757,6 +782,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="item">The master list entity to insert.</param>
     /// <returns>The inserted entity retrieved from the repository, or <c>null</c> if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=70bbd79 body=44b9a00 -->
     public async Task<T?> InsertMasterList(T item)
     {
         try
@@ -781,6 +807,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="item">The item to update in the master list.</param>
     /// <returns>The updated item retrieved from the repository, or <c>null</c> if an error occurred during the update.</returns>
+    /// <!-- aidoc:v1 sig=525dfd0 body=7010df2 -->
     public async Task<T?> UpdateMasterList(T item)
     {
         try
@@ -810,6 +837,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="masterListType1">The master list type used to find the unit (e.g., the primary list reference on the unit).</param>
     /// <param name="masterListType2">The master list type that determines which associated list identifier is returned from the resolved unit.</param>
     /// <returns>A task that yields the associated <see cref="ObjectId"/> when a matching list exists, or <c>null</c> when no unit is found or the type is not mapped.</returns>
+    /// <!-- aidoc:v1 sig=e127506 body=2c24e0e -->
     public async Task<ObjectId?> GetAssociatedList(ObjectId id, MasterListType masterListType1,
             MasterListType masterListType2)
     {
@@ -855,6 +883,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="id">The identifier of the list whose options should be retrieved.</param>
     /// <returns>A list of option names belonging to the matching list, or an empty list if the list is not found.</returns>
+    /// <!-- aidoc:v1 sig=ec8c6e3 body=716cd88 -->
     public async Task<List<string>> GetOptionsOfList(ObjectId id)
     {
         var repository = GetRepository();
@@ -869,6 +898,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// Resolves and returns the master list repository instance for the current entity type from the dependency injection service provider.
     /// </summary>
     /// <returns>The <see cref="IMasterListRepository{T}"/> instance retrieved from the configured <see cref="IServiceProvider"/>.</returns>
+    /// <!-- aidoc:v1 sig=d65745e body=789f6e7 -->
     private IMasterListRepository<T> GetRepository()
     {
         return _serviceProvider.GetRequiredService<IMasterListRepository<T>>();
@@ -880,6 +910,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The identifier of the master list whose dependent units and related records need to be updated.</param>
     /// <param name="opt">The update payload describing the master list change to apply to the related patient records.</param>
     /// <param name="typeName">The name of the master list type used to scope the update across the affected services.</param>
+    /// <!-- aidoc:v1 sig=624e0d5 body=c47ad11 -->
     private async Task UpdatePatientItemList(ObjectId id, UpdateOptionMasterListDto opt, string typeName)
     {
         // Necesito saber que unidades tienen el id de lista que estamos modificando
@@ -897,6 +928,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="id">The master list identifier used to locate the units that reference it.</param>
     /// <param name="opt">The option list containing the item to be removed from the affected records.</param>
     /// <param name="typeName">The type name of the master list item to delete.</param>
+    /// <!-- aidoc:v1 sig=4492294 body=9b327f2 -->
     private async Task DeletePatientItemList(ObjectId id, OptionList opt, string typeName)
     {
         // Necesito saber que unidades tienen el id de lista que estamos modificando
@@ -912,6 +944,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// Asynchronously saves the specified API request by offloading the save operation to a background task.
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -921,6 +954,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// Saves the specified API request.
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
+    /// <!-- aidoc:v1 sig=3385bba body=6805ef5 -->
     public Task SaveRequest(ApiRequest apiRequest)
     {
         return Task.CompletedTask;
@@ -932,6 +966,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="masterList">The master list entity triggering the broadcast; its runtime type name is used to determine the master list category.</param>
     /// <param name="operation">The operation performed on the master list, which is sent to each subscriber along with the localized master list options.</param>
+    /// <!-- aidoc:v1 sig=73619af body=f177e6e -->
     private async Task SendMasterListBroadcast(T masterList, OperationType operation)
     {
         try
@@ -974,6 +1009,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// <param name="updatedItem">The new or modified option list item, included in add and update operations.</param>
     /// <param name="oldItem">The previous option list item, included in delete and update operations.</param>
     /// <param name="operation">The operation type that determines the structure of the broadcast message sent to subscribers.</param>
+    /// <!-- aidoc:v1 sig=e48c5b0 body=c41b16d -->
     private async Task SendMasterListItemBroadcast(T masterList, OptionList? updatedItem, OptionList? oldItem,
             OperationType operation)
     {
@@ -1043,6 +1079,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="list">The master list whose associated units should be retrieved. Its identifier and list type are used to look up the related units.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="UnitInfoDto"/> instances for the units linked to the specified list, or an empty list if none exist.</returns>
+    /// <!-- aidoc:v1 sig=e1e565a body=764dda0 -->
     private async Task<List<UnitInfoDto>> IsInUse(T list)
     {
         var units = await _unitService.Value.FindUnitsByMasterListId(list.Id, list.ListType);
@@ -1063,6 +1100,7 @@ public class MasterListService<T> : IMasterListService<T> where T : MasterList,
     /// </summary>
     /// <param name="list">The master list entity whose associated unit count is being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the number of units referencing the master list.</returns>
+    /// <!-- aidoc:v1 sig=83c6ba6 body=a349dfa -->
     private async Task<long> IsInUseCount(T list)
     {
         return await _unitService.Value.CountUnitsByMasterListId(list.Id, list.ListType);
diff --git a/adas-core.Application/Services/MasterListServiceFactory .cs b/adas-core.Application/Services/MasterListServiceFactory .cs
index 7942420a..4466c4c2 100644
--- a/adas-core.Application/Services/MasterListServiceFactory .cs	
+++ b/adas-core.Application/Services/MasterListServiceFactory .cs	
@@ -35,6 +35,7 @@ public class MasterListServiceFactory(
     /// <returns>An object representing the resolved service instance for the requested master list type.</returns>
     /// <exception cref="BadRequestException">Thrown when the type corresponding to <paramref name="serviceName"/> cannot be resolved in the adas_core.Domain.Models.Masters namespace.</exception>
     /// <exception cref="NotFoundException">Thrown when the generic service type cannot be constructed for the resolved type parameter.</exception>
+    /// <!-- aidoc:v1 sig=fb7b709 body=3d6f937 -->
     public object GetService(MasterListType serviceName)
     {
         var typeParameter = Type.GetType($"adas_core.Domain.Models.Masters.{serviceName}, adas-core.Domain") ??
@@ -53,6 +54,7 @@ public class MasterListServiceFactory(
     /// <param name="serviceType">The type of the service to resolve. Must be a generic type based on <c>MasterListService&lt;&gt;</c> to be successfully handled.</param>
     /// <returns>The resolved service instance implementing <see cref="IMasterListService{T}"/> for the corresponding item type.</returns>
     /// <exception cref="System.InvalidOperationException">Thrown when the requested <paramref name="serviceType"/> is not a generic <c>MasterListService&lt;&gt;</c>, or when no implementation of <see cref="IMasterListService{T}"/> can be resolved for the requested item type.</exception>
+    /// <!-- aidoc:v1 sig=614ae51 body=8ee1e7f -->
     public object GetService(Type serviceType)
     {
         // Verifica si el tipo es genérico y está basado en MasterList
@@ -81,6 +83,7 @@ public class MasterListServiceFactory(
     /// </summary>
     /// <param name="masterListType">The enumeration value identifying which master list category to resolve to its concrete type.</param>
     /// <returns>The <see cref="Type"/> that implements the requested master list category, or <see cref="MasterList"/> when no specific type applies.</returns>
+    /// <!-- aidoc:v1 sig=6c365b2 body=880f6dd -->
     public Type GetMasterListSpecificType(MasterListType masterListType)
     {
         // mapear cada valor de MasterListType a su respectivo tipo específico
@@ -118,6 +121,7 @@ public class MasterListServiceFactory(
     /// <param name="masterListType">The discriminator used to resolve the concrete <see cref="MasterList"/> subtype to create.</param>
     /// <param name="masterList">The source <see cref="MasterList"/> whose properties are mapped onto the created specific instance.</param>
     /// <returns>The created specific <see cref="MasterList"/> instance with mapped properties, or null if reflection failed to create the instance.</returns>
+    /// <!-- aidoc:v1 sig=2fcd123 body=40fe8bf -->
     public object? GetTypedMasterList(MasterListType masterListType, MasterList masterList)
     {
         // Obtiene el tipo específico de MasterList basado en masterListType
@@ -141,6 +145,7 @@ public class MasterListServiceFactory(
     /// <param name="masterList">The master list entity to be converted and inserted.</param>
     /// <returns>The result produced by the dynamically invoked <c>InsertMasterList</c> method, or <c>null</c> when the awaited task exposes no result value.</returns>
     /// <exception cref="InvalidOperationException">Thrown when no service is registered for the specified <paramref name="masterListType"/>, when the master list cannot be converted to its expected typed instance, or when the <c>InsertMasterList</c> method cannot be found on the resolved service.</exception>
+    /// <!-- aidoc:v1 sig=bf8421c body=6aa822f -->
     public async Task<object?> InsertMasterList(MasterListType masterListType, MasterList masterList)
     {
         dynamic service = GetService(masterListType) ??
@@ -167,6 +172,7 @@ public class MasterListServiceFactory(
     /// <exception cref="InvalidOperationException">Thrown when no service is registered for the specified <paramref name="masterListType"/>.</exception>
     /// <exception cref="InvalidOperationException">Thrown when the provided <paramref name="masterList"/> cannot be converted to its specific typed master list.</exception>
     /// <exception cref="InvalidOperationException">Thrown when the resolved service does not expose an <c>UpdateMasterList</c> method matching the typed master list argument.</exception>
+    /// <!-- aidoc:v1 sig=d9a7df7 body=d1a68c9 -->
     public async Task<object?> UpdateMasterList(MasterListType masterListType, MasterList masterList)
     {
         dynamic service = GetService(masterListType) ??
@@ -192,6 +198,7 @@ public class MasterListServiceFactory(
     /// <param name="dataLocale">An optional locale used to localize the returned data; may be <c>null</c> when localization is not required.</param>
     /// <returns>A task that resolves to the retrieved master list item as an <see cref="object"/>, or <c>null</c> when the awaited result has no value.</returns>
     /// <exception cref="System.InvalidOperationException">Thrown when no service is registered for the supplied <paramref name="masterListType"/>, or when the target service does not expose a compatible <c>GetMasterListById</c> method matching the expected parameters.</exception>
+    /// <!-- aidoc:v1 sig=f1cc73f body=1ede241 -->
     public async Task<object?> GetMasterListById(MasterListType masterListType, ObjectId masterListId,
             LocaleEnum? dataLocale)
     {
@@ -221,6 +228,7 @@ public class MasterListServiceFactory(
     /// <returns>A task that resolves to the located master list option as an <see cref="object"/>, or <see langword="null"/> if the underlying task produced no result.</returns>
     /// <exception cref="InvalidOperationException">Thrown when no service implementation is registered for the given <paramref name="masterListType"/>.</exception>
     /// <exception cref="InvalidOperationException">Thrown when the resolved service does not expose the expected <c>FindOptionItemById</c> method.</exception>
+    /// <!-- aidoc:v1 sig=ba7db8d body=81e73c2 -->
     public async Task<object?> GetMasterListOptionById(MasterListType masterListType, ObjectId masterListId,
             ObjectId masterListOptionId,
             LocaleEnum? dataLocale)
@@ -248,6 +256,7 @@ public class MasterListServiceFactory(
     /// and appending the fixed observation "PatientIncomingData".
     /// </summary>
     /// <returns>A list of nurse observation names, including all configured manual observations and the fixed "PatientIncomingData" entry.</returns>
+    /// <!-- aidoc:v1 sig=c39c888 body=a74adf6 -->
     public List<string> StringNurseObs()
     {
         var stringNurseObs = new List<string>();
@@ -286,6 +295,7 @@ public class MasterListServiceFactory(
     /// <param name="locale">The target locale for translation; when set to <c>Default</c>, no translation is performed.</param>
     /// <param name="patient">The patient whose option list values will be translated in place.</param>
     /// <returns>A task that resolves to the same <see cref="Patient"/> instance with translated option names, or null if the input patient is null.</returns>
+    /// <!-- aidoc:v1 sig=83910e9 body=96fe28d -->
     public async Task<Patient?> GetPatientTraslated(Unit? unit, LocaleEnum? locale, Patient? patient)
     {
         if (patient == null)
@@ -368,6 +378,7 @@ public class MasterListServiceFactory(
     /// </summary>
     /// <param name="source">The <see cref="MasterList"/> instance whose property values are read.</param>
     /// <param name="destination">The target object that receives the matching property values.</param>
+    /// <!-- aidoc:v1 sig=b6041e3 body=1170a2a -->
     private void MapMasterListProperties(MasterList source, object destination)
     {
         // Obtiene las propiedades del tipo de origen y destino
diff --git a/adas-core.Application/Services/MedicineService.cs b/adas-core.Application/Services/MedicineService.cs
index b9d9be3e..f087787f 100644
--- a/adas-core.Application/Services/MedicineService.cs
+++ b/adas-core.Application/Services/MedicineService.cs
@@ -36,6 +36,7 @@ public class MedicineService(
     /// Retrieves all medicines from the repository asynchronously.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of all <see cref="Medicine"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=6bce187 body=38d3044 -->
     public async Task<List<Medicine>> GetAll()
     {
         return await medicineRepository.GetAll();
@@ -46,6 +47,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="code">The unique code identifier of the medicine to retrieve.</param>
     /// <returns>A <see cref="Medicine"/> instance if a medicine with the specified code exists; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=9f0c493 body=0fd6bb1 -->
     public async Task<Medicine?> GetByCode(string code)
     {
         return await medicineRepository.GetMedicine(code);
@@ -56,6 +58,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="codeNote">A list of strings representing the codes or notes used to search for matching medicines.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Medicine"/> objects that match the specified codes or notes.</returns>
+    /// <!-- aidoc:v1 sig=3cc75c7 body=40ffa28 -->
     public async Task<List<Medicine>> GetByCodeOrNote(List<string> codeNote)
     {
         return await medicineRepository.GetMedicineByCodeOrNote(codeNote);
@@ -67,6 +70,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="name">The name of the medicine to look up.</param>
     /// <returns>A <see cref="Medicine"/> if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=c2409b6 body=1be51c8 -->
     public async Task<Medicine?> GetByName(string name)
     {
         return await medicineRepository.GetMedicineByName(name);
@@ -77,6 +81,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="treatments">The patient treatments to resolve medicines for. Null entries are skipped.</param>
     /// <returns>An enumerable of medicines resolved from the supplied treatments, aggregating types, codes, groups, and notes when a treatment specifies a <c>RequestedGiveTreatment</c> name.</returns>
+    /// <!-- aidoc:v1 sig=c254229 body=d49d316 -->
     public async Task<IEnumerable<Medicine>> GetMedicinesOfTreatments(IEnumerable<PatientTreatment?> treatments)
     {
         var totalMedicines = new List<Medicine>();
@@ -165,6 +170,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose active medicines are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of <see cref="Medicine"/> instances linked to the patient's active treatments.</returns>
+    /// <!-- aidoc:v1 sig=1d2d0a9 body=c9a2dcc -->
     public async Task<IEnumerable<Medicine>> GetActiveMedicinesByPatient(ObjectId patientId)
     {
         var activeTreatments = await treatmentService.GetActiveTreatmentsByPatient(patientId);
@@ -177,6 +183,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to determine which subset of medicines to return.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{Medicine}"/> with the medicines for the requested page, the current page number, the page size, and the total count of medicines matching the query.</returns>
+    /// <!-- aidoc:v1 sig=806bf86 body=f9249ed -->
     public async Task<PaginationResponse<Medicine>> GetPaginatedMedicines(PaginationFilter filter)
     {
         var result = medicineRepository.GetPaginatedMedicines(filter);
@@ -201,6 +208,7 @@ public class MedicineService(
     /// <param name="medicineId">The unique identifier of the medicine to retrieve.</param>
     /// <returns>The <see cref="Medicine"/> entity if found; otherwise, the method throws an exception.</returns>
     /// <exception cref="NotFoundException">Thrown when no medicine is found for the specified <paramref name="medicineId"/>.</exception>
+    /// <!-- aidoc:v1 sig=be77265 body=440a8fa -->
     public async Task<Medicine?> GetMedicineById(ObjectId medicineId)
     {
         return await medicineRepository.GetMedicineById(medicineId) ??
@@ -213,6 +221,7 @@ public class MedicineService(
     /// <param name="medicine">The medicine entity to create.</param>
     /// <returns>The newly created <see cref="Medicine"/> entity.</returns>
     /// <exception cref="ConflictException">Thrown when the repository returns a null result, indicating the creation failed.</exception>
+    /// <!-- aidoc:v1 sig=25564e2 body=3bf2108 -->
     public async Task<Medicine?> PostMedicine(Medicine medicine)
     {
         var result = await medicineRepository.PostMedicine(medicine) ??
@@ -226,6 +235,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="medicine">The medicine entity containing the updated information.</param>
     /// <returns>The updated <see cref="Medicine"/>, or <c>null</c> if the update did not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=baa8582 body=2626b7e -->
     public async Task<Medicine?> UpdateMedicine(Medicine medicine)
     {
         var oldMedicine = GetMedicineById(medicine.Id);
@@ -239,6 +249,7 @@ public class MedicineService(
     /// Captures the existing medicine state prior to deletion to preserve audit trail details.
     /// </summary>
     /// <param name="medicineId">The unique identifier of the medicine to delete.</param>
+    /// <!-- aidoc:v1 sig=ea3ac00 body=1689aa2 -->
     public async Task DeleteMedicineById(ObjectId medicineId)
     {
         var oldMedicine = GetMedicineById(medicineId);
@@ -250,6 +261,7 @@ public class MedicineService(
     /// Asynchronously retrieves all distinct medicine types from the repository. Returns an empty list if an exception occurs during the retrieval process.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of distinct medicine type strings, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=39dbb1c body=e709a32 -->
     public async Task<List<string>> GetAllTypes()
     {
         try
@@ -269,6 +281,7 @@ public class MedicineService(
     /// Returns an empty list if an error occurs while fetching or converting the data.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of distinct group strings, or an empty list if an exception is encountered.</returns>
+    /// <!-- aidoc:v1 sig=fa46f44 body=e246c96 -->
     public async Task<List<string>> GetAllGroups()
     {
         try
@@ -287,6 +300,7 @@ public class MedicineService(
     /// Retrieves all distinct medicine names from the repository asynchronously, returning an empty list if any error occurs during the data retrieval or mapping process.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of medicine names, or an empty list if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=beaf9c9 body=8f4cffa -->
     public async Task<List<string>> GetAllNames()
     {
         try
@@ -306,6 +320,7 @@ public class MedicineService(
     /// Returns an empty list if an exception occurs during retrieval.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of code strings, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=5dbd383 body=c312526 -->
     public async Task<List<string>> GetAllCodes()
     {
         try
@@ -327,6 +342,7 @@ public class MedicineService(
     /// </summary>
     /// <param name="treatment">The patient treatment whose notes are used to derive the parental nutrition medicine.</param>
     /// <returns>A task containing the calculated <see cref="Medicine"/>, or <c>null</c> when no "NPT" note is found or when an error is logged during processing.</returns>
+    /// <!-- aidoc:v1 sig=448874c body=b5dfee6 -->
     private Task<Medicine?> CalculateParentalNutritionMedicine(PatientTreatment treatment)
     {
         Medicine? medicine = null;
diff --git a/adas-core.Application/Services/NoticeService.cs b/adas-core.Application/Services/NoticeService.cs
index 5af6aee2..1d3912dd 100644
--- a/adas-core.Application/Services/NoticeService.cs
+++ b/adas-core.Application/Services/NoticeService.cs
@@ -35,6 +35,7 @@ public class NoticeService(
     /// Deletes the specified notice by delegating to the ID-based deletion routine.
     /// </summary>
     /// <param name="notice">The notice to delete; its <c>Id</c> is used to identify the record to remove.</param>
+    /// <!-- aidoc:v1 sig=8a4d223 body=3e9937f -->
     public async Task DeleteNoticeAsync(Notice notice)
     {
         await DeleteNoticeByIdAsync(notice.Id);
@@ -44,6 +45,7 @@ public class NoticeService(
     /// Deletes a notice identified by its unique ID, creating an audit log entry and broadcasting the deletion when successful. If the notice is not found, the operation is logged and the method returns without making changes; any unexpected exception is logged without being rethrown.
     /// </summary>
     /// <param name="noticeId">The unique identifier of the notice to delete.</param>
+    /// <!-- aidoc:v1 sig=fc4fef5 body=3b2109f -->
     public async Task DeleteNoticeByIdAsync(ObjectId noticeId)
     {
         try
@@ -72,6 +74,7 @@ public class NoticeService(
     /// </summary>
     /// <param name="noticeId">The unique <see cref="ObjectId"/> of the notice to retrieve.</param>
     /// <returns>A <see cref="Notice"/> instance if found; otherwise, <c>null</c> when an exception is thrown during the search.</returns>
+    /// <!-- aidoc:v1 sig=a29748d body=b9afac8 -->
     public async Task<Notice?> GetNoticeByIdAsync(ObjectId noticeId)
     {
         try
@@ -92,6 +95,7 @@ public class NoticeService(
     /// <param name="noticeType">The type of notice to filter the search by.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="Notice"/> objects matching the specified type.</returns>
     /// <exception cref="NotFoundException">Thrown when no notices are found for the specified <paramref name="noticeType"/>.</exception>
+    /// <!-- aidoc:v1 sig=f464ed9 body=32bab14 -->
     public async Task<IEnumerable<Notice>?> GetNoticeByTypeAsync(string noticeType)
     {
         return await noticeRepository.FindByType(noticeType) ??
@@ -102,6 +106,7 @@ public class NoticeService(
     /// Retrieves all notices from the repository asynchronously.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of all <see cref="Notice"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=bb01c16 body=1c55179 -->
     public async Task<IEnumerable<Notice>> GetNoticesAsync()
     {
         return await noticeRepository.FindAll();
@@ -112,6 +117,7 @@ public class NoticeService(
     /// </summary>
     /// <param name="notice">The notice to insert. A new identifier is assigned before persistence.</param>
     /// <returns>The inserted notice with its newly assigned identifier, or null if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=3214327 body=e0c3682 -->
     public async Task<Notice?> InsertNotice(Notice notice)
     {
         try
@@ -138,6 +144,7 @@ public class NoticeService(
     /// </summary>
     /// <param name="notice">The notice entity containing the updated data.</param>
     /// <exception cref="ConflictException">Thrown when the notice cannot be found in the repository.</exception>
+    /// <!-- aidoc:v1 sig=b9bba8f body=19a0acb -->
     public async Task UpdateNoticeAsync(Notice notice)
     {
         try
@@ -158,6 +165,7 @@ public class NoticeService(
     /// Processes an API request to create, update, or delete a notice based on the request type. Validates required fields for new and updated notices, skips processing when the notice or its description is missing, and logs any exceptions encountered.
     /// </summary>
     /// <param name="apiRequest">The API request containing the notice payload and the operation type (NewNotice, UpdateNotice, or DeleteNotice) to perform.</param>
+    /// <!-- aidoc:v1 sig=229d8cd body=c1e382c -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         try
@@ -209,6 +217,7 @@ public class NoticeService(
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -220,6 +229,7 @@ public class NoticeService(
     /// </summary>
     /// <param name="displayId">The ObjectId of the display used to look up associated notices.</param>
     /// <returns>A task containing an <see cref="IEnumerable{T}"/> of <see cref="Notice"/> objects matching the display, or null if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=0f1e6c7 body=ebcd280 -->
     public async Task<IEnumerable<Notice>?> GetNoticesByDisplayId(ObjectId displayId)
     {
         try
@@ -239,6 +249,8 @@ public class NoticeService(
     /// </summary>
     /// <param name="notice">The notice to broadcast. Its <c>DisplayId</c> is used to resolve the target display and its subscribers.</param>
     /// <param name="operation">The operation type that identifies the kind of notice being broadcast and is forwarded to each subscriber.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary states 'any exception thrown while sending is caught and logged,' but the SendAsync calls are invoked fire-and-forget (`_ = clientMessageService.SendAsync(...)`), so exceptions thrown within those tasks are not caught by this method's try/catch and would surface as unobserved task exceptions." -->
     private async void SendNoticeBroadcast(Notice notice, OperationType operation)
     {
         try
diff --git a/adas-core.Application/Services/ObservationDemoService.cs b/adas-core.Application/Services/ObservationDemoService.cs
index 41d08db7..7afc8660 100644
--- a/adas-core.Application/Services/ObservationDemoService.cs
+++ b/adas-core.Application/Services/ObservationDemoService.cs
@@ -26,6 +26,7 @@ public class ObservationDemoService(
     /// <param name="patient">The patient to associate with the generated alarms.</param>
     /// <param name="dataAlarmfields">The list of fields used to look up alarm configurations and produce alarms.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of mapped <see cref="PatientObservationAlarm"/> instances that were successfully resolved.</returns>
+    /// <!-- aidoc:v1 sig=bc2b31e body=f044666 -->
     public async Task<List<PatientObservationAlarm>> GenerateAlarmByField(Patient patient, List<Field> dataAlarmfields)
     {
         var listToReturn = new List<PatientObservationAlarm>();
@@ -87,6 +88,7 @@ public class ObservationDemoService(
     /// <param name="patient">The patient to associate the generated observations with.</param>
     /// <param name="dataFields">The list of fields used to look up observation configurations and drive observation generation.</param>
     /// <returns>A task that returns the list of generated <see cref="PatientObservation"/> instances; entries are omitted when no configuration is found for a field.</returns>
+    /// <!-- aidoc:v1 sig=1045c66 body=1145e03 -->
     public async Task<List<PatientObservation>> GenerateObservationByField(Patient patient, List<Field> dataFields)
     {
         var listToReturn = new List<PatientObservation>();
@@ -161,6 +163,7 @@ public class ObservationDemoService(
     /// <param name="patient">The patient to associate the generated grouped observation with.</param>
     /// <param name="groupedField">The grouped field configuration that defines the names, results, regularity, and maximum number of observations to generate.</param>
     /// <returns>A task that returns the populated <see cref="GroupedObservation"/> containing the generated observations.</returns>
+    /// <!-- aidoc:v1 sig=32f5cfc body=c681ea4 -->
     public async Task<GroupedObservation> GenerateGroupedObservation(Patient patient, GroupedField groupedField)
     {
         if (groupedField.Names.IsNullOrEmpty() && groupedField.Name != null) groupedField.Names.Add(groupedField.Name);
@@ -235,6 +238,7 @@ public class ObservationDemoService(
     /// <param name="firstCof">The configuration observation whose <c>DemoConfig</c> drives the value generation. If null or its <c>DemoConfig</c> is null, the method returns "-".</param>
     /// <param name="prevValue">The previous value, passed through to <c>PickSingleValue</c> as context for the new random value generation.</param>
     /// <returns>A list of generated values when the configuration indicates an array, or a single generated value otherwise. Null is returned when no value could be picked.</returns>
+    /// <!-- aidoc:v1 sig=22e46d9 body=7abbfc1 -->
     private static object? GenerateValueRandom(ConfigObservation? firstCof, object? prevValue)
     {
         if (firstCof?.DemoConfig == null)
@@ -261,6 +265,8 @@ public class ObservationDemoService(
     /// <param name="config">The configuration that defines how the value should be selected, including the list of options, the numeric range, and the selection mode.</param>
     /// <param name="prevValue">The previously selected value, used as the base for percentage-based variation when generating a new numeric value; ignored when no previous integer value is available.</param>
     /// <returns>A randomly selected value from the configured options or a generated numeric value clamped within the defined range; <c>null</c> when the configuration does not allow a value to be produced.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary and returns tag state the method returns null when the options list is empty, but the code throws ArgumentOutOfRangeException via rnd.Next(0) on the empty list rather than returning null." -->
     private static object? PickSingleValue(DemoConfig? config, object? prevValue)
     {
         if (config == null) return null;
diff --git a/adas-core.Application/Services/ObservationService.cs b/adas-core.Application/Services/ObservationService.cs
index b95bee00..4fd34714 100644
--- a/adas-core.Application/Services/ObservationService.cs
+++ b/adas-core.Application/Services/ObservationService.cs
@@ -24,6 +24,7 @@ namespace adas_core.Application.Services;
 /// Provides the concrete implementation of the <see cref="IObservationService"/> contract,
 /// encapsulating the business logic required to manage and expose observation-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=974bc4c -->
 public class ObservationService : IObservationService
 {
     private readonly ICacheService _cacheService;
@@ -170,6 +171,7 @@ public class ObservationService : IObservationService
     /// <param name="num">The maximum number of recent observations to return. Defaults to 2.</param>
     /// <param name="filterObservations">An optional list of observation codes/names used to narrow down which observations are considered.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the patient's most recent <see cref="PatientObservation"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=6f6283b body=92c1221 -->
     public async Task<List<PatientObservation>> FindLastObservations(ObjectId patientId, int num = 2,
             List<string>? filterObservations = null)
     {
@@ -185,6 +187,7 @@ public class ObservationService : IObservationService
     /// <param name="filterObservations">Optional list of fields to filter the aggregated observations by; entries with null or whitespace names are ignored when building the cache key. When null, an empty field set is used.</param>
     /// <param name="ct">Cancellation token forwarded to the cache and repository operations.</param>
     /// <returns>A task containing the list of <see cref="PatientObservation"/> values, either served from cache or freshly aggregated from the repository on a cache miss.</returns>
+    /// <!-- aidoc:v1 sig=06c6fa6 body=f861637 -->
     private async Task<List<PatientObservation>> AggregatedLastObsCached(
             ObjectId patientId,
             List<Field>? filterObservations,
@@ -227,6 +230,7 @@ public class ObservationService : IObservationService
     /// <param name="mapped">When <c>true</c> (default), applies a name-based mapping to each observation; when <c>false</c>, returns the raw results as they come from the cache.</param>
     /// <param name="ct">Cancellation token to cancel the asynchronous operation.</param>
     /// <returns>A task containing the list of patient observations, either as raw cached entries or as mapped values depending on <paramref name="mapped"/>.</returns>
+    /// <!-- aidoc:v1 sig=8272c2c body=9cf7a87 -->
     public async Task<List<PatientObservation>> FindLastObservationsByField(
             ObjectId patientId,
             List<Field>? filterObservations = null,
@@ -256,6 +260,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the mapped <see cref="PatientObservation"/>, or null if no matching mapping is found.</returns>
+    /// <!-- aidoc:v1 sig=5df4888 body=c476eb8 -->
     public async Task<PatientObservation?> MapObservationsByName(PatientObservation obs)
     {
         return await _configObservationService.Map(obs, true);
@@ -267,6 +272,7 @@ public class ObservationService : IObservationService
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <param name="onlyByName">When <c>true</c>, restricts the mapping to name-based lookups only.</param>
     /// <returns>A task containing the mapped <see cref="PatientObservation"/>, or <c>null</c> if the observation is ignored, not found, or an exception is raised during processing.</returns>
+    /// <!-- aidoc:v1 sig=70a9515 body=67bca22 -->
     public async Task<PatientObservation?> MapObservation(PatientObservation obs, bool onlyByName = false)
     {
         try
@@ -311,6 +317,10 @@ public class ObservationService : IObservationService
     /// <param name="obs">Observation</param>
     /// <param name="persistObs"></param>
     /// <param name="mapObs">True if it needs to be inserted</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "mapObs is documented as 'True if it needs to be inserted' but the code shows it controls whether to map the observation via MapObservation" -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "persistObs parameter has no description; it controls whether the observation is persisted to the repository" -->
     public async Task InsertObservation(PatientObservation obs, bool persistObs = true, bool mapObs = true)
     {
         try
@@ -369,6 +379,7 @@ public class ObservationService : IObservationService
     /// Any exception thrown during the operation is caught and logged.
     /// </summary>
     /// <param name="obs">The patient observation provided by the nurse to be mapped, persisted, cached, broadcast, and audited.</param>
+    /// <!-- aidoc:v1 sig=975cc72 body=34767d6 -->
     public async Task InsertNurseObservation(PatientObservation obs)
     {
         try
@@ -416,6 +427,7 @@ public class ObservationService : IObservationService
     /// <param name="persistObs">Indicates whether the new observation should be persisted when inserted.</param>
     /// <param name="mapObs">Indicates whether the new observation should be mapped when inserted.</param>
     /// <returns>A task that resolves to <c>true</c> if the observation was inserted because the value changed, or <c>false</c> if the most recent observation already has the same value and no insertion was made.</returns>
+    /// <!-- aidoc:v1 sig=ca5a8c1 body=049bcaf -->
     public async Task<bool> InsertIfChanged(string name, PatientObservation observation, bool persistObs = true,
             bool mapObs = true)
     {
@@ -434,6 +446,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="obsList">The list of patient observations to send to matching subscribers.</param>
     /// <param name="location">The patient location used to identify subscribers to notify.</param>
+    /// <!-- aidoc:v1 sig=9af0676 body=1e5ea24 -->
     public Task SendObsBroadcast(List<PatientObservation> obsList, PatientLocation location)
     {
         // Display Subscription
@@ -458,6 +471,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="obsList">The collection of patient observations to be sent to the matched subscribers.</param>
     /// <param name="pocId">The point of care identifier used to filter the subscribers by their configured location identifiers.</param>
+    /// <!-- aidoc:v1 sig=2fbfda1 body=8d7eaaa -->
     public Task SendObsBroadcast(List<PatientObservation> obsList, ObjectId pocId)
     {
         // Display Subscription
@@ -479,6 +493,7 @@ public class ObservationService : IObservationService
     /// The method skips the broadcast if the observation has no name, and falls back to looking up the patient by id when it is not included in the observation.
     /// </summary>
     /// <param name="obs">The patient observation to broadcast. May include the patient or require a lookup via <see cref="BasePatientObservation.PatientId"/>.</param>
+    /// <!-- aidoc:v1 sig=1e50a7a body=505987b -->
     public async Task SendObsBroadcast(BasePatientObservation obs)
     {
         if (obs.Name == null) return;
@@ -515,6 +530,10 @@ public class ObservationService : IObservationService
     /// <param name="patient">The patient to whom the observations belong.</param>
     /// <param name="messageTime">The timestamp associated with the source message.</param>
     /// <param name="observationData">Optional parent observation metadata used to populate the parent data of each observation.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "States 'persists them asynchronously through the calculated observations mapping service', but the mapping service only maps observations; actual persistence is performed by InsertObservation in fire-and-forget tasks." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "States 'any errors during processing are logged without being rethrown', but the final Task.WhenAll is fire-and-forget (assigned to `_`), so exceptions thrown by InsertObservation tasks are not caught by the outer try/catch and will not be logged here." -->
     public async void ProcessObservations(List<PatientObservation> observations, Patient patient,
             DateTime messageTime, ObservationData? observationData = null)
     {
@@ -575,6 +594,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="request">The API request containing the nurse observation data to be persisted.</param>
     /// <returns>A task that represents the asynchronous nurse observation save operation.</returns>
+    /// <!-- aidoc:v1 sig=bad7899 body=cf9afd9 -->
     public Task SaveRequestNurseObsAsync(ApiRequest request)
     {
         return Task.Run(() => SaveRequestNurseObs(request));
@@ -589,6 +609,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The incoming API request containing patient/location identifiers, message type, and observation data.</param>
     /// <exception cref="ApiRequestException">Thrown when both the patient number and location are null or empty, or when the request type is not valid for observations.</exception>
+    /// <!-- aidoc:v1 sig=229d8cd body=04a5ed7 -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         if (
@@ -688,6 +709,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=a312b13 -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         //return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -700,6 +722,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose observations are being queried.</param>
     /// <returns>An <see cref="IAsyncCursor{PatientObservation}"/> that iterates over the matching patient observations.</returns>
+    /// <!-- aidoc:v1 sig=3727a3e body=8e212ac -->
     public async Task<IAsyncCursor<PatientObservation>> FindByPatientIdAsync(ObjectId patientId)
     {
         return await _observationRepository.FindByPatientIdAsync(patientId);
@@ -712,6 +735,7 @@ public class ObservationService : IObservationService
     /// <param name="codingSystem">The coding system used to classify the observations.</param>
     /// <param name="name">The name associated with the observations to filter by.</param>
     /// <returns>An asynchronous cursor over the matching <see cref="PatientObservation"/> documents.</returns>
+    /// <!-- aidoc:v1 sig=6e7afc6 body=835e601 -->
     public async Task<IAsyncCursor<PatientObservation>> FindByPatientIdAndCodingSystemAsync(ObjectId patientId,
             string codingSystem, string name)
     {
@@ -724,6 +748,7 @@ public class ObservationService : IObservationService
     /// Any exception encountered during the process is logged and swallowed without being rethrown.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose observations should be deleted.</param>
+    /// <!-- aidoc:v1 sig=09e4e41 body=c5228ee -->
     public async Task DeleteByPatientId(ObjectId id)
     {
         try
@@ -751,6 +776,7 @@ public class ObservationService : IObservationService
     /// Archives a patient observation by persisting it to the archive repository, removing it from the active observations, and invalidating the related cache entries for the patient's latest observations.
     /// </summary>
     /// <param name="observation">The patient observation to be archived.</param>
+    /// <!-- aidoc:v1 sig=026c725 body=ac22ce5 -->
     public async Task Archive(PatientObservation observation)
     {
         await _observationArchiveRepository.InsertOneAsync(observation);
@@ -763,6 +789,7 @@ public class ObservationService : IObservationService
     /// Archives the specified patient by delegating to the archive operation keyed by the patient's identifier.
     /// </summary>
     /// <param name="patient">The patient to be archived. Its identifier is used to locate and archive the corresponding record.</param>
+    /// <!-- aidoc:v1 sig=0afe718 body=be01ba0 -->
     public async Task Archive(Patient patient)
     {
         await ArchiveByPatientId(patient.Id);
@@ -772,6 +799,7 @@ public class ObservationService : IObservationService
     /// Archives all observations associated with the specified patient by copying them into the archive repository with newly generated identifiers, then removes the originals and invalidates the related cache entries.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose observations should be archived.</param>
+    /// <!-- aidoc:v1 sig=3385472 body=a839154 -->
     public async Task ArchiveByPatientId(ObjectId id)
     {
         _logger.LogDebug("Archive Observations by Patient Id {id}", id);
@@ -794,6 +822,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose intravenous lines observations are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientObservation"/> objects, which may include null entries, representing the latest active intravenous lines observations grouped by location.</returns>
+    /// <!-- aidoc:v1 sig=867a12b body=af359b4 -->
     public async Task<List<PatientObservation?>> FindLastIntravenousLinesObservationByLocation(ObjectId patientId)
     {
         return await _observationRepository.AggregatedPatientActiveIntravenousLinesObservations(patientId);
@@ -803,6 +832,7 @@ public class ObservationService : IObservationService
     /// Retrieves the most recent observation time for all patients by delegating to the observation repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a dictionary mapping patient <see cref="ObjectId"/> values to their last observation <see cref="DateTime"/>.</returns>
+    /// <!-- aidoc:v1 sig=115ac00 body=d447d05 -->
     public async Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime()
     {
         return await _observationRepository.FindAllLastPatientObservationTime();
@@ -814,6 +844,7 @@ public class ObservationService : IObservationService
     /// If no observation with the specified identifier is found, the method performs no action.
     /// </summary>
     /// <param name="observation">The patient observation containing the updated data to be persisted.</param>
+    /// <!-- aidoc:v1 sig=c0ac237 body=3e235cb -->
     public async Task UpdateObservation(PatientObservation observation)
     {
         var obs = await _observationRepository.FindById(observation.Id);
@@ -835,6 +866,7 @@ public class ObservationService : IObservationService
     /// <param name="date">The upper bound date; only observations recorded prior to this date are considered.</param>
     /// <param name="obsName">The optional name of the observation to filter by. When <c>null</c>, observations of any name are considered.</param>
     /// <returns>The latest <see cref="PatientObservation"/> recorded before the specified date, or <c>null</c> if none was found.</returns>
+    /// <!-- aidoc:v1 sig=babda83 body=e05ec66 -->
     public async Task<PatientObservation?> FindLastBeforeDate(ObjectId patientId, DateTime date, string? obsName)
     {
         return await _observationRepository.FindLastObservationBeforeDate(patientId, obsName, date);
@@ -848,6 +880,7 @@ public class ObservationService : IObservationService
     /// <param name="date">The date used to find observations recorded on the same day.</param>
     /// <param name="obsName">The optional name of the observation to filter by; when null, observations of any name on the given date are considered.</param>
     /// <returns>A task that resolves to a list of matching <see cref="PatientObservation"/> instances, or null if no observations match the specified criteria.</returns>
+    /// <!-- aidoc:v1 sig=15a1606 body=8af3163 -->
     public async Task<List<PatientObservation>?> FindAnyWithSameDate(ObjectId patientId, DateTime date,
             string? obsName)
     {
@@ -862,6 +895,8 @@ public class ObservationService : IObservationService
     /// <param name="date">The cutoff date; observations recorded before this date will be returned.</param>
     /// <param name="filterObservations">An optional list of observation identifiers to filter the results.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientObservation"/> entries found before the specified date.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The filterObservations parameter is documented as filtering the results, but the method body does not pass it to the repository call (only patientId and date are forwarded), so no filtering actually occurs." -->
     public async Task<List<PatientObservation>> FindAllBeforeDate(ObjectId patientId, DateTime date,
             List<string>? filterObservations = null)
     {
@@ -875,6 +910,7 @@ public class ObservationService : IObservationService
     /// <param name="name">The name of the observation to search for.</param>
     /// <param name="expires">An optional expiration value (in seconds) applied to the query.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the latest unique <see cref="PatientObservation"/> values.</returns>
+    /// <!-- aidoc:v1 sig=fbdab74 body=6467bab -->
     public async Task<List<PatientObservation>> FindLatestUniqueValuesByName(ObjectId patientId, string name,
             int? expires)
     {
@@ -890,6 +926,7 @@ public class ObservationService : IObservationService
     /// <param name="filterObservations">An optional list of observation identifiers used to narrow the returned results.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patient observations matching the criteria.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the implementation has not yet been provided.</exception>
+    /// <!-- aidoc:v1 sig=a2b1d09 body=bfa6f2f -->
     public Task<List<PatientObservation>> FindAllAfterDate(ObjectId patientId, DateTime date,
             List<string>? filterObservations = null)
     {
@@ -904,6 +941,7 @@ public class ObservationService : IObservationService
     /// <param name="endAfter">Optional threshold used to restrict which observations are considered; if null, no end-after filter is applied.</param>
     /// <param name="num">Optional maximum number of observations to return; if null, all matching observations are returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing an enumerable collection of matching <see cref="PatientObservation"/> instances.</returns>
+    /// <!-- aidoc:v1 sig=fa7c1b4 body=d00a4ef -->
     public async Task<IEnumerable<PatientObservation>> FindLastNotExpiredObservatonsByPatient(ObjectId patientId,
             string name, int? endAfter = null, int? num = null)
     {
@@ -916,6 +954,7 @@ public class ObservationService : IObservationService
     ///     current time
     ///     mark as expired in bd.
     /// </summary>
+    /// <!-- aidoc:v1 sig=076e4fe body=3b48a1e -->
     public async Task CheckAndExpireObservations()
     {
         var count = 0;
@@ -940,6 +979,7 @@ public class ObservationService : IObservationService
     /// Updates the repository to mark a list of patient observations as expired, invalidates the corresponding cache entries, and creates audit log entries capturing the pre-update state of each observation.
     /// </summary>
     /// <param name="patientObservations">The list of patient observations to be marked as expired.</param>
+    /// <!-- aidoc:v1 sig=606ff2e body=5f2ea53 -->
     public async Task UpdateExpiredObservations(List<PatientObservation> patientObservations)
     {
         await _observationRepository.UpdateExpiredObservations(patientObservations);
@@ -959,6 +999,7 @@ public class ObservationService : IObservationService
     /// For each candidate observation, the patient is validated; missing patients trigger cleanup of their observations and cached entries. Observations with missing names or unparsable expiration values are skipped, and only those whose expected expiration time (observation time plus configured minutes) has passed are yielded.
     /// </summary>
     /// <returns>An asynchronous stream of <see cref="PatientObservation"/> instances that are not expired in storage but whose effective expiration time has elapsed.</returns>
+    /// <!-- aidoc:v1 sig=08302b5 body=277c7e5 -->
     public async IAsyncEnumerable<PatientObservation> FindNotExpiredObservationsShouldBeExpired()
     {
         var expiringObservations = await _configObservationService.GetAllConfigs();
@@ -1008,6 +1049,7 @@ public class ObservationService : IObservationService
     /// <summary>
     /// Retrieves all observation configurations and expires those whose <c>Expires</c> value is set to a positive number, ignoring configurations with a null or non-positive expiry.
     /// </summary>
+    /// <!-- aidoc:v1 sig=085cd58 body=23edba8 -->
     public async Task ExpireObservations()
     {
         //TODO expire each section
@@ -1022,6 +1064,7 @@ public class ObservationService : IObservationService
     /// <summary>
     /// Expires patient observations that should no longer be active and recalculates the latest observation values per configured field. Sets a global flag while running to signal that expiration is in progress, processes expirations in batches of 1000 to limit memory usage, and clears the patient observations cache once finished; any error is logged and swallowed without rethrowing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b7c6d53 body=adc503e -->
     public async Task ExpireObservationsAndRecalculateAsync()
     {
         try
@@ -1094,6 +1137,7 @@ public class ObservationService : IObservationService
     /// <param name="nameId">The name identifier of the field whose value should be updated across matching records.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign to the matching records.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=46d3367 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await _observationRepository.UpdateManyObjectId(nameId, id, oldId);
@@ -1103,6 +1147,7 @@ public class ObservationService : IObservationService
     /// Inserts a simple patient observation into the repository and records an audit log entry for the operation using the current HTTP context user.
     /// </summary>
     /// <param name="observation">The patient observation to insert.</param>
+    /// <!-- aidoc:v1 sig=983d9dc body=cfd144b -->
     public async Task InsertSimpleObservation(PatientObservation observation)
     {
         await _observationRepository.InsertOneAsync(observation);
@@ -1119,6 +1164,8 @@ public class ObservationService : IObservationService
     /// <param name="fromArchived">When true, queries the archived observation collection; otherwise, queries the active observation collection.</param>
     /// <param name="filter">Optional pagination settings controlling the page number and page size of the returned results.</param>
     /// <returns>A task that resolves to the list of <see cref="PatientObservation"/> records matching the specified criteria.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "startDate is documented as 'inclusive lower bound' but the code uses filterBuilder.Gt(o => o.Time, ...), which is exclusive (strict greater-than). Records with Time == startDate are NOT included in results." -->
     public async Task<List<PatientObservation>> FindAllBetweenDates(
             ObjectId patientId,
             DateTime? startDate = null,
@@ -1174,6 +1221,7 @@ public class ObservationService : IObservationService
     /// Asynchronously processes alert expiration and powers off beacon LEDs for points of care that are not currently in use.
     /// Skips patients located in virtual/moved/deleted/pushed/unknown locations and ignores emulated beacons and configurations with disabled alarms.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e82bf03 body=a65a543 -->
     public async Task ExpireAlertsAndPowerOffAsync()
     {
         try
@@ -1260,6 +1308,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="filter">The pagination filter that specifies the page number and page size used to compute the skip/limit range.</param>
     /// <returns>A <see cref="PaginationResponse{PatientObservation}"/> containing the page of patient observations along with pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=09d4b6c body=3ba0256 -->
     public async Task<PaginationResponse<PatientObservation>> GetPaginatedObservations(PaginationFilter filter)
     {
         var result = _observationRepository.GetPaginatedObservations(filter);
@@ -1284,6 +1333,7 @@ public class ObservationService : IObservationService
     /// or the observation name is empty, and logs any errors that occur during processing.
     /// </summary>
     /// <param name="obs">The patient observation used to resolve the retention policy and identify which records to delete.</param>
+    /// <!-- aidoc:v1 sig=b72421f body=75a9bf8 -->
     private async Task DoRetentionActions(PatientObservation obs)
     {
         try
@@ -1329,6 +1379,7 @@ public class ObservationService : IObservationService
     /// in the group's names or where the group does not consider the observation relevant.
     /// </summary>
     /// <param name="obs">The incoming patient observation used to find and update matching groups.</param>
+    /// <!-- aidoc:v1 sig=6945ee7 body=3ec5c18 -->
     private async void CheckForGroupedObs(PatientObservation obs)
     {
         try
@@ -1387,6 +1438,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The API request containing the observation text, parent data, message time, and additional observations used to build the intravenous line record.</param>
     /// <param name="patient">The patient to associate the resulting observation with.</param>
+    /// <!-- aidoc:v1 sig=6d902c0 body=6131bea -->
     private async Task ProcessIntravenousLinesObservation(ApiRequest apiRequest, Patient patient)
     {
         var isInsertable = false;
@@ -1473,6 +1525,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The API request containing the observation data and coded allergy entries to process.</param>
     /// <param name="patient">The patient associated with the allergies observation being recorded.</param>
+    /// <!-- aidoc:v1 sig=87cd8c3 body=b361033 -->
     private async Task ProcessAllergiesObservation(ApiRequest apiRequest, Patient patient)
     {
         _logger.LogDebug("INSERT AllergiesObservation");
@@ -1582,6 +1635,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The incoming API request whose <c>ObservationData</c> is inspected for the isolation marker text and timestamp.</param>
     /// <param name="patient">The patient associated with the observation, used to assign the patient identifier to the new record.</param>
+    /// <!-- aidoc:v1 sig=3e77398 body=f0f74d8 -->
     private async Task ProcessIsolationObservation(ApiRequest apiRequest, Patient patient)
     {
         if (apiRequest.ObservationData is { Text: "Aislamiento", Time: not null })
@@ -1615,6 +1669,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The incoming API request containing the observation data, observations collection, and message timestamp to be processed.</param>
     /// <param name="patient">The patient associated with the observation; its identifier is stored in the resulting <see cref="PatientObservation"/>.</param>
+    /// <!-- aidoc:v1 sig=0d9f42f body=316c55d -->
     private async Task ProcessPositionObservation(ApiRequest apiRequest, Patient patient)
     {
         if (apiRequest.ObservationData != null &&
@@ -1662,6 +1717,7 @@ public class ObservationService : IObservationService
     /// </summary>
     /// <param name="apiRequest">The API request containing the observation data, time, and the list of observations to be processed.</param>
     /// <param name="patient">The patient associated with the drainage observation being recorded.</param>
+    /// <!-- aidoc:v1 sig=0d44621 body=0ec2fb5 -->
     private async Task ProcessDrainageObservation(ApiRequest apiRequest, Patient patient)
     {
         _logger.LogDebug("INSERT DrainageObservation");
@@ -1742,6 +1798,8 @@ public class ObservationService : IObservationService
     /// <param name="apiRequest">The API request containing the data required to locate the patient and the observations to be saved.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="apiRequest"/> is null.</exception>    
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "ArgumentNullException is documented but the method does not throw it; if apiRequest is null, accessing apiRequest.PatientNumber or apiRequest.Location would throw NullReferenceException" -->
     public async Task SaveRequestNurseObs(ApiRequest apiRequest)
     {
         var patient = await _patientService.FindPatientByApiRequest(apiRequest);
@@ -1768,6 +1826,7 @@ public class ObservationService : IObservationService
     /// <param name="configs">The list of point of care configurations used to locate the configuration associated with the patient.</param>
     /// <param name="obsConfigList">The observation configurations from which the recording end-after time is derived, falling back to <paramref name="defaultValue"/> when no recording alarms are configured.</param>
     /// <param name="defaultValue">The default end-after value applied when no observation configuration specifies a recording alarm.</param>
+    /// <!-- aidoc:v1 sig=9902090 body=5b3f7b2 -->
     private async Task CheckRecordings(Patient patient, List<PointOfCare> configs,
             IEnumerable<ConfigObservation> obsConfigList, int defaultValue)
     {
@@ -1828,6 +1887,7 @@ public class ObservationService : IObservationService
     /// <param name="patient">The patient whose relay state is being evaluated; must have a valid <c>PointOfCareId</c>.</param>
     /// <param name="obsConfigList">Collection of observation configurations used to determine the relay end-after threshold via the <c>OpenDoor</c> alarm.</param>
     /// <param name="defaultValue">Fallback value used for the relay end-after threshold when no <c>OpenDoor</c> alarm configuration is present.</param>
+    /// <!-- aidoc:v1 sig=b9117cf body=d76f723 -->
     private async Task CheckRelay(Patient patient,
             IEnumerable<ConfigObservation> obsConfigList, int defaultValue)
     {
@@ -1874,6 +1934,7 @@ public class ObservationService : IObservationService
     /// <param name="patient">The patient whose beacon state is being evaluated; its identifier and point of care assignment are used to locate recent observations and target the beacon.</param>
     /// <param name="obsConfigList">The list of observation configurations used to determine the maximum beacon end-after value from the alarms that are both enabled and have their beacon enabled, falling back to <paramref name="defaultValue"/> when no configuration matches or the beacon is null.</param>
     /// <param name="defaultValue">The fallback value used for the beacon end-after period when no configuration provides a value or when the matching configuration's beacon is null.</param>
+    /// <!-- aidoc:v1 sig=0dd4f68 body=8372da2 -->
     private async Task CheckBeacon(Patient patient,
             IEnumerable<ConfigObservation> obsConfigList, int defaultValue)
     {
diff --git a/adas-core.Application/Services/PatientCarePlanService.cs b/adas-core.Application/Services/PatientCarePlanService.cs
index 17a50aad..622e90dc 100644
--- a/adas-core.Application/Services/PatientCarePlanService.cs
+++ b/adas-core.Application/Services/PatientCarePlanService.cs
@@ -13,6 +13,7 @@ namespace adas_core.Application.Services;
 /// Provides operations for managing patient care plans, implementing the contract defined by <see cref="IPatientCarePlanService"/>.
 /// Serves as the concrete service layer responsible for handling care plan related business logic.
 /// </summary>
+/// <!-- aidoc:v1 sig=22e8377 -->
 public class PatientCarePlanService : IPatientCarePlanService
 {
     private readonly IArchivePatientCarePlanService _archivePatientCarePlanService;
@@ -55,6 +56,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans are to be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> for the patient, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=9706d89 body=ccd645c -->
     public async Task<List<PatientCarePlan>> FindByPatientId(ObjectId patientId)
         {
             try
@@ -74,6 +76,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose patient care plans are being retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects for the user, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=7520aa9 body=666052d -->
     public async Task<List<PatientCarePlan>> FindByUserId(ObjectId userId)
         {
             try
@@ -92,6 +95,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// Retrieves all patient care plans from the repository, returning an empty list if an error occurs while fetching the data.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects, or an empty list if the retrieval fails.</returns>
+    /// <!-- aidoc:v1 sig=6a558a7 body=19f83a8 -->
     public async Task<List<PatientCarePlan>> FindAll()
         {
             try
@@ -109,6 +113,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// Inserts a new patient care plan into the repository, stamping it with the current UTC time, and records an audit log entry for the operation. Any errors encountered during the insertion or audit logging are caught and logged without rethrowing.
     /// </summary>
     /// <param name="patientCarePlan">The patient care plan entity to be inserted into the repository.</param>
+    /// <!-- aidoc:v1 sig=cbefa20 body=2a84bb1 -->
     public async Task InsertOneAsync(PatientCarePlan patientCarePlan)
         {
             try
@@ -129,6 +134,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// </summary>
     /// <param name="patientWithFinishedProcedure">The patient associated with the finished procedure whose care plan items are being archived.</param>
     /// <param name="itemsToArchive">The list of care plan options to archive.</param>
+    /// <!-- aidoc:v1 sig=6d8145d body=dab75f5 -->
     public async Task ArchiveCarePlanFromJob(Patient patientWithFinishedProcedure, List<OptionList> itemsToArchive)
         {
             var systemUser = await _userRepository.GetOrCreateSystemUser();
@@ -153,6 +159,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// Archives all care plans associated with the specified patient by moving them to the archive service, removing them from the active repository, and creating audit log entries for each archived record.
     /// </summary>
     /// <param name="patientid">The identifier of the patient whose care plans will be archived.</param>
+    /// <!-- aidoc:v1 sig=8a48aa7 body=4ede7e2 -->
     public async Task ArchiveByPatientId(ObjectId patientid)
         {
             var carePlansToArchive = await FindByPatientId(patientid);
@@ -170,6 +177,7 @@ public class PatientCarePlanService : IPatientCarePlanService
     /// <param name="patientid">The unique identifier of the patient whose care plan records will be updated.</param>
     /// <param name="patientId">The new object identifier that will replace the old identifier in the matching care plan records.</param>
     /// <param name="oldId">The existing object identifier to be replaced by the new identifier.</param>
+    /// <!-- aidoc:v1 sig=9a63bf8 body=c2a07bf -->
     public async Task UpdateManyObjectId(string patientid, ObjectId patientId, ObjectId oldId)
         {
             await _patientCarePlanRepository.UpdateManyObjectId(patientid, patientId, oldId);
diff --git a/adas-core.Application/Services/PatientService.cs b/adas-core.Application/Services/PatientService.cs
index e28bd261..deebb67e 100644
--- a/adas-core.Application/Services/PatientService.cs
+++ b/adas-core.Application/Services/PatientService.cs
@@ -27,6 +27,7 @@ namespace adas_core.Application.Services;
 /// Provides a concrete implementation of the <see cref="IPatientService"/> interface,
 /// encapsulating patient-related service operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=10bbe0c -->
 public class PatientService : IPatientService
 {
     private readonly Lazy<IAdmissionService> _admissionService;
@@ -171,6 +172,7 @@ public class PatientService : IPatientService
     /// Inserts a new patient into the repository after validating it. If the patient fails validation, the method returns without performing the insertion. After a successful insert, a new patient broadcast notification is dispatched asynchronously.
     /// </summary>
     /// <param name="patient">The patient entity to be inserted into the repository.</param>
+    /// <!-- aidoc:v1 sig=d1581db body=77e1954 -->
     public async Task Insert(Patient patient)
     {
         if (!CheckPatient(patient))
@@ -189,6 +191,7 @@ public class PatientService : IPatientService
     /// <param name="patientId">The string representation of the patient identifier to parse and look up.</param>
     /// <param name="localeEnum">The locale used to translate the patient data via the master list service.</param>
     /// <returns>A task containing the translated patient, the untranslated patient if the unit is not found, or null if the patient has no associated unit.</returns>
+    /// <!-- aidoc:v1 sig=f4d1347 body=c678377 -->
     public async Task<Patient?> FindByPatientIdWithLocale(string patientId, LocaleEnum localeEnum)
     {
         ObjectId.TryParse(patientId, out var id);
@@ -206,6 +209,7 @@ public class PatientService : IPatientService
     /// On a successful insert, an audit log is created and a broadcast is dispatched to notify other components.
     /// </summary>
     /// <param name="patient">The patient entity to be inserted into the system.</param>
+    /// <!-- aidoc:v1 sig=f6b2b46 body=88c5d39 -->
     public async Task InsertAsync(Patient patient)
     {
         if (!CheckPatient(patient))
@@ -223,6 +227,7 @@ public class PatientService : IPatientService
     /// <param name="newPocId">The identifier of the destination point of care.</param>
     /// <param name="oldPocId">The identifier of the source point of care that the patient is leaving.</param>
     /// <returns>A task that resolves to <c>true</c> when the patient is successfully moved; otherwise, <c>false</c> if the new point of care is null, the old point of care is null, or the new point of care is already in use or locked.</returns>
+    /// <!-- aidoc:v1 sig=39388b7 body=c03ac2e -->
     public async Task<bool> Move(Patient patient, ObjectId newPocId, ObjectId oldPocId)
     {
         var newPoc = await _pointOfCareService.GetInfo(newPocId);
@@ -289,6 +294,7 @@ public class PatientService : IPatientService
     /// <param name="withLocation">When <c>true</c>, enriches the patient with location information such as bed, room, and unit name.</param>
     /// <returns>A <see cref="Task{Patient}"/> containing the found patient, or <c>null</c> if no patient matches the identifier or the identifier is empty.</returns>
     /// <exception cref="NotFoundException">Thrown when the patient has an associated point of care that cannot be found.</exception>
+    /// <!-- aidoc:v1 sig=a22429e body=12ee318 -->
     public async Task<Patient?> FindById(ObjectId id, bool withLocation = false)
     {
         if (id == ObjectId.Empty)
@@ -330,6 +336,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="location">The patient location containing the unit name and bed used to locate the patient.</param>
     /// <returns>A <see cref="Patient"/> if one is found for the given location; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=556acef body=8a73352 -->
     public async Task<Patient?> FindByLocation(PatientLocation? location)
     {
         if (location?.UnitName == null || location.Bed == null)
@@ -347,6 +354,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="pocId">The point of care identifier used to locate the patient.</param>
     /// <returns>A <see cref="Patient"/> if one is found with the specified point of care identifier; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=ddcf124 body=0f46364 -->
     public async Task<Patient?> FindByPointOfCareId(ObjectId pocId)
     {
         return await _patientRepository.FindByPointOfCareId(pocId);
@@ -357,6 +365,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="unitId">The <see cref="ObjectId"/> of the unit whose patients should be counted.</param>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to the number of patients linked to the given unit.</returns>
+    /// <!-- aidoc:v1 sig=783969e body=27e7534 -->
     public async Task<long> CountPatientsByUnitId(ObjectId unitId)
     {
         return await _patientRepository.CountByUnitId(unitId);
@@ -366,6 +375,7 @@ public class PatientService : IPatientService
     /// Archives a patient according to the configured <see cref="OnArchiveAction"/>: either inserts the patient into the archive repository (with the current UTC time as the archive date) or simply performs no archival step. The patient record is then deleted, an audit log entry is created, associated patient data is archived, and if the patient was assigned to a point of care, a delete broadcast is sent and that point of care is set to Available.
     /// </summary>
     /// <param name="patient">The patient to archive. If its <c>DisTime</c> is null, it is set to the current UTC time before further processing.</param>
+    /// <!-- aidoc:v1 sig=f9c9380 body=db59c7e -->
     public async Task ArchivePatient(Patient patient)
     {
         patient.DisTime ??= DateTime.UtcNow;
@@ -402,6 +412,7 @@ public class PatientService : IPatientService
     /// Archives or deletes all data associated with a patient based on the configured <c>OnArchiveAction</c>. When the action is set to <c>Archive</c> (the default), patient observations, treatments, diagnoses, appointments, pumps, recording alerts, and care plans are archived; when set to <c>Delete</c>, observations, treatments, diagnoses, appointments, pumps, and recording alerts are deleted (care plan archival is not performed in this case).
     /// </summary>
     /// <param name="patientid">The <see cref="ObjectId"/> of the patient whose related data should be archived or deleted.</param>
+    /// <!-- aidoc:v1 sig=734ad23 body=6ea277f -->
     public async Task ArchivePatientData(ObjectId patientid)
     {
         _logger.LogDebug("Archiving patient data action: {onArchiveAction} : {patientid}", _onArchiveAction,
@@ -434,6 +445,7 @@ public class PatientService : IPatientService
     /// Updates a patient record in the repository, handling special cases such as resolving duplicated "Sin cama" bed assignments from ICCADB by generating a unique bed identifier, and assigning a patient number when missing. Also creates an audit log comparing the previous and updated patient and asynchronously broadcasts the update.
     /// </summary>
     /// <param name="patient">The patient entity to update.</param>
+    /// <!-- aidoc:v1 sig=f9d52dc body=68e4897 -->
     public async Task Update(Patient patient)
     {
         var oldPatient = await _patientRepository.FindById(patient.Id);
@@ -468,6 +480,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="id">The identifier of the patient whose location will be updated.</param>
     /// <param name="location">The new patient location, or <c>null</c> to abort the update.</param>
+    /// <!-- aidoc:v1 sig=9fbc6f9 body=0a33496 -->
     public async Task UpdateLocation(ObjectId id, PatientLocation? location)
     {
         try
@@ -558,6 +571,7 @@ public class PatientService : IPatientService
     /// <param name="id">The unique identifier of the patient whose attending doctor is being updated.</param>
     /// <param name="doctor">The new attending doctor to assign to the patient.</param>
     /// <exception cref="ConflictException">Thrown when the patient cannot be found by id before or after the update operation.</exception>
+    /// <!-- aidoc:v1 sig=75ae010 body=d0f12e3 -->
     public async Task UpdateAttendingDoctor(ObjectId id, Person doctor)
     {
         var oldPatient = await _patientRepository.FindById(id) ??
@@ -578,6 +592,7 @@ public class PatientService : IPatientService
     /// <param name="data">The new <see cref="Person"/> data to apply to the patient.</param>
     /// <param name="updatePatientNumber">When <c>true</c>, the patient number is also updated; otherwise only the personal data is changed.</param>
     /// <exception cref="ConflictException">Thrown when the patient cannot be found by <paramref name="id"/> either before or after the update operation.</exception>
+    /// <!-- aidoc:v1 sig=06ac587 body=7aeda33 -->
     public async Task UpdatePatientData(ObjectId id, string patientNumber, Person data,
             bool updatePatientNumber = true)
     {
@@ -600,6 +615,7 @@ public class PatientService : IPatientService
     /// <param name="patient">The patient entity containing the updated data.</param>
     /// <param name="updatePatientNumber">Indicates whether the patient number should be updated as part of the operation.</param>
     /// <exception cref="ConflictException">Thrown when the patient cannot be found before or after the update operation.</exception>
+    /// <!-- aidoc:v1 sig=0c07015 body=33d6834 -->
     public async Task UpdatePatientData(ObjectId id, string patientNumber, Patient patient,
             bool updatePatientNumber = true)
     {
@@ -624,6 +640,7 @@ public class PatientService : IPatientService
     /// <param name="patientId">The unique identifier of the patient to retrieve.</param>
     /// <param name="withLocation">When <c>true</c>, additional lookups are performed to populate the patient's bed, room, and unit information; otherwise only the patient record is returned.</param>
     /// <returns>The <see cref="Patient"/> matching the specified identifier, or <c>null</c> if no patient is found.</returns>
+    /// <!-- aidoc:v1 sig=f272074 body=5df30c2 -->
     public async Task<Patient?> FindByPatientId(string patientId, bool withLocation = false)
     {
 
@@ -653,6 +670,7 @@ public class PatientService : IPatientService
     /// <param name="patientNumber">The unique identifier of the patient to look up.</param>
     /// <param name="withLocation">When set to <c>true</c>, populates the returned patient with bed and room information from the point of care and the unit name from the unit service, provided the patient has associated location identifiers.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the matching <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=890ea54 body=8336edf -->
     public async Task<Patient?> FindByPatientNumber(string patientNumber, bool withLocation = false)
     {
         var patient = await _patientRepository.FindByPatientNumber(patientNumber);
@@ -681,6 +699,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the archived patient.</param>
     /// <returns>The archived <see cref="Patient"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=d3378f0 body=aa9384c -->
     public async Task<Patient?> FindByPatientNumberArchived(string patientNumber)
     {
         return await _patientArchiveRepository.FindByPatientNumber(patientNumber);
@@ -695,6 +714,7 @@ public class PatientService : IPatientService
     /// any unexpected failure causes the original exception to be rethrown after logging.
     /// </summary>
     /// <param name="date">The cutoff date; patients with no observations updated after this date will be archived.</param>
+    /// <!-- aidoc:v1 sig=549ade5 body=7f270ff -->
     public async Task ArchivePatientWithoutObservationsSinceDate(DateTime date)
     {
         try
@@ -777,6 +797,7 @@ public class PatientService : IPatientService
     /// and any error encountered during archiving is logged rather than propagated.
     /// </summary>
     /// <param name="hoursBeforeArchive">The number of hours that must elapse after a patient's discharge time before they are eligible for archiving.</param>
+    /// <!-- aidoc:v1 sig=2cc3c13 body=11413f9 -->
     public async Task ArchiveDischargedPatients(int hoursBeforeArchive)
     {
         var disBeforeDate = DateTime.Now.AddHours(-hoursBeforeArchive);
@@ -806,6 +827,7 @@ public class PatientService : IPatientService
     /// <param name="location">The patient location used for a location-based lookup; the search only proceeds when both the unit name and the bed are set, and the location is mapped through the POC mapping service before being applied to the resulting patient.</param>
     /// <param name="findPatientByLocation">When <c>true</c>, allows a location-based lookup even if the corresponding configuration option is disabled.</param>
     /// <returns>The matching <see cref="Patient"/> if found by any of the attempted criteria, or <c>null</c> when no patient can be located.</returns>
+    /// <!-- aidoc:v1 sig=ef50845 body=2a9514b -->
     public async Task<Patient?> FindPatient(string? patientId, string? patientNumber, PatientLocation? location,
             bool findPatientByLocation = false)
     {
@@ -842,6 +864,8 @@ public class PatientService : IPatientService
     /// <param name="observations">Indicates whether related observations should be included in the result.</param>
     /// <param name="filterObservations">Optional list of observation identifiers used to filter observations when they are included.</param>
     /// <returns>A task that resolves to the matching <see cref="Patient"/>, or null if the lookup fails.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The 'observations' and 'filterObservations' parameters are documented as controlling observation inclusion/filtering, but the method body only calls _patientRepository.FindByPointOfCareId(item.Id) and never references either parameter." -->
     public async Task<Patient?> GetByPointOfCare(PointOfCare item, bool observations = false,
             List<string>? filterObservations = null)
     {
@@ -863,6 +887,7 @@ public class PatientService : IPatientService
     /// <param name="unit">The unit used to determine the translation; when <c>null</c>, the patient is returned without translation.</param>
     /// <param name="localeEnum">The target locale for translation; when <c>null</c>, the patient is returned without translation.</param>
     /// <returns>The matching <see cref="Patient"/>, or <c>null</c> if the patient is not found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=fce6f5d body=821f100 -->
     public async Task<Patient?> GetByPointOfCareAndLocale(PointOfCare item, Unit? unit, LocaleEnum? localeEnum)
     {
         try
@@ -885,6 +910,8 @@ public class PatientService : IPatientService
     /// <param name="observations">When true, the most recent observations for the patient are loaded and mapped by name; when false, only patient data is returned.</param>
     /// <param name="filterObservations">Optional list of observation names used to restrict which observations are retrieved; applies only when <paramref name="observations"/> is true.</param>
     /// <returns>A <see cref="Task{Box}"/> containing the populated box. The <c>HasPatient</c> flag is set to false if no patient is found for the point of care, and the box's <c>Observations</c> are populated only when requested.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The <returns> tag references Task{Box} (non-nullable), but the method's actual return type is Task<Box?>. The method never returns null in practice, so the practical meaning is unchanged." -->
     public async Task<Box?> GetBox(PointOfCare poc, bool observations = false,
             List<string>? filterObservations = null)
     {
@@ -931,6 +958,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The patient whose arrival should be broadcast to matching subscribers.</param>
     /// <returns>A completed task once the broadcast has been dispatched.</returns>
+    /// <!-- aidoc:v1 sig=fd19240 body=a90f9bf -->
     public Task SendNewPatientBroadcast(Patient patient)
     {
         var subscribers = new List<WsSubscriber>();
@@ -959,6 +987,7 @@ public class PatientService : IPatientService
     /// If the patient has no point of care id, the update is skipped and an error is logged.
     /// </summary>
     /// <param name="patient">The patient whose update will be broadcast; its point of care id is used to filter subscribers and its unit is used to resolve translations.</param>
+    /// <!-- aidoc:v1 sig=947720c body=71d60b3 -->
     public async Task SendPatientUpdateBroadcast(Patient patient)
     {
         if (!patient.PointOfCareId.HasValue)
@@ -989,6 +1018,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="apiRequest">The API request to be saved.</param>
     /// <returns>A <see cref="Task"/> that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -999,6 +1029,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="apiRequest">The API request containing the ADT type, patient identifiers, locations, and related clinical data to be processed.</param>
     /// <exception cref="ApiRequestException">Thrown when both the patient number and location unit name are missing for non-ICCA requests, or when the request type is not a valid patient ADT type.</exception>
+    /// <!-- aidoc:v1 sig=229d8cd body=bcf1b57 -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         if (string.IsNullOrEmpty(apiRequest.PatientNumber) &&
@@ -1399,6 +1430,7 @@ public class PatientService : IPatientService
     /// <param name="apiRequest">The API request containing the data used to initialize the new patient.</param>
     /// <param name="ignoreLocation">When <c>true</c>, location information from the request is ignored during the patient update.</param>
     /// <returns>The newly created patient.</returns>
+    /// <!-- aidoc:v1 sig=7f3758a body=fdf45d9 -->
     public async Task<Patient?> CreatePatientFromRequest(ApiRequest apiRequest, bool ignoreLocation = false)
     {
         var patient = new Patient
@@ -1417,6 +1449,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="apiRequest">The incoming API request containing the patient identifier, location, facility, request type, and optional person/doctor information used to resolve or create the patient.</param>
     /// <returns>A <see cref="Task{Patient}"/> that resolves to the resolved or newly created <see cref="Patient"/>, or <c>null</c> if the point of care cannot be mapped, the request is not handled, no matching patient is found and creation is disabled, or an error occurs while processing the request.</returns>
+    /// <!-- aidoc:v1 sig=c55d64f body=15f7bac -->
     public async Task<Patient?> FindPatientByApiRequest(ApiRequest apiRequest)
     {
         Patient? patient = null;
@@ -1737,6 +1770,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="withLocation">When <c>true</c>, populates each patient's <see cref="Patient.Bed"/>, <see cref="Patient.Room"/>, and <see cref="Patient.UnitString"/> by looking up the related point of care and unit; when <c>false</c>, returns the patients without performing those lookups.</param>
     /// <returns>A task containing the list of patients, with location fields populated when <paramref name="withLocation"/> is <c>true</c> and the corresponding identifiers are present.</returns>
+    /// <!-- aidoc:v1 sig=9ed8fb2 body=0e56b87 -->
     public async Task<List<Patient>> FindAll(bool withLocation = false)
     {
         var patients = await _patientRepository.FindAll();
@@ -1767,6 +1801,7 @@ public class PatientService : IPatientService
     /// Asynchronously retrieves a list of inactive patients of care (PoC) by delegating to the patient repository.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of inactive <see cref="Patient"/> records.</returns>
+    /// <!-- aidoc:v1 sig=2479e43 body=4a13d43 -->
     public async Task<List<Patient>> FindInActivePoC()
     {
         return await _patientRepository.FindInActivePoC();
@@ -1776,6 +1811,7 @@ public class PatientService : IPatientService
     /// Retrieves a list of patients currently in active Point of Care (PoC).
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing the list of patients in active PoC.</returns>
+    /// <!-- aidoc:v1 sig=1a67064 body=36208e3 -->
     public async Task<List<Patient>> FindInInactivePoC()
     {
         return await _patientRepository.FindInInactivePoC();
@@ -1787,6 +1823,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to calculate the skip and limit for the query.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{Patient}"/> with the patients for the requested page, along with the total count and pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=02d2827 body=88e214b -->
     public async Task<PaginationResponse<Patient>> GetPaginatedPatients(PaginationFilter filter)
     {
         var result = _patientRepository.GetPaginatedPatients(filter);
@@ -1810,6 +1847,7 @@ public class PatientService : IPatientService
     /// <param name="unit">The identifier of the unit to search by.</param>
     /// <param name="pointOfCare">The identifier of the point of care to search by.</param>
     /// <returns>A <see cref="Patient"/> if a match is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=927765b body=f356295 -->
     public async Task<Patient?> FindByUnitAndPocId(ObjectId unit, ObjectId pointOfCare)
     {
         return await _patientRepository.FindByUnitAndPocId(unit, pointOfCare);
@@ -1820,6 +1858,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="pointOfCare">The point of care identifier used to filter patients.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of <see cref="Patient"/> entities matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=c4523a3 body=4e528f1 -->
     public async Task<List<Patient>> FindByPointOfCare(string pointOfCare)
     {
         return await _patientRepository.FindByPointOfCare(pointOfCare);
@@ -1833,6 +1872,8 @@ public class PatientService : IPatientService
     /// <param name="patient">The target patient that will absorb the old patient's data.</param>
     /// <param name="oldPatientNumber">The patient number of the patient to be merged into <paramref name="patient"/>.</param>
     /// <returns>A task representing the asynchronous merge operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states 'if the old patient has a point of care' as the trigger, but the code checks `oldLocation.HasValue` where `oldLocation` was assigned from `patient.PointOfCareId` (the target/new patient), not from the old patient." -->
     public async Task MergePatient(Patient patient, string oldPatientNumber)
     {
         var oldLocation = patient.PointOfCareId; //  sectionService.FindByPatient(patient.id);
@@ -1874,6 +1915,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="sinceDate">The cutoff date used to archive patients who have not had any observations since this time.</param>
     /// <param name="hoursBeforeArchive">The number of hours of inactivity used to determine which discharged and inactive point-of-care patients should be archived.</param>
+    /// <!-- aidoc:v1 sig=54328ba body=397ed49 -->
     public async Task DischargeInactivePatients(DateTime sinceDate, int hoursBeforeArchive)
     {
         try
@@ -1897,6 +1939,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="updatedPatient">The patient object containing the updated information, identified by its Id.</param>
     /// <returns>The updated patient, or null if no matching patient was found or the update did not produce a result.</returns>
+    /// <!-- aidoc:v1 sig=5cf3377 body=975e64a -->
     public async Task<Patient?> UpdateOne(Patient updatedPatient)
     {
         var oldPatient = await _patientRepository.FindById(updatedPatient.Id);
@@ -1912,6 +1955,7 @@ public class PatientService : IPatientService
     /// <param name="altable">The new altable option to assign to the patient.</param>
     /// <param name="user">The user performing the operation, used to attribute the generated nurse observation.</param>
     /// <returns>The updated <see cref="Patient"/>, or <c>null</c> if no patient was found with the specified id.</returns>
+    /// <!-- aidoc:v1 sig=ba8b79d body=376c710 -->
     public async Task<Patient?> UpdatePatientAltable(ObjectId patientId, OptionList altable, User? user)
     {
         var patient = await _patientRepository.FindByPatientId(patientId);
@@ -1986,6 +2030,7 @@ public class PatientService : IPatientService
     /// <param name="id"></param>
     /// <param name="archivePatient"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=a446242 body=7196f4b -->
     public async Task ExitPatientById(ObjectId id, bool archivePatient = true)
     {
         try
@@ -2025,6 +2070,7 @@ public class PatientService : IPatientService
     /// <param name="user">The user performing the update, used for audit purposes and observation generation.</param>
     /// <param name="carePlanLog">An optional list of care plan options used when generating care plans for Treatment, Procedure, and Test list types.</param>
     /// <returns>The updated <see cref="Patient"/> if the operation succeeds; otherwise, <c>null</c> if the patient is not found or an exception is caught.</returns>
+    /// <!-- aidoc:v1 sig=99d957a body=ae3ce1f -->
     public async Task<Patient?> UpdatePatientMasterList(ObjectId patientId, MasterListType typeName,
             List<OptionList> updatedOptions, User? user, List<OptionList>? carePlanLog)
     {
@@ -2150,6 +2196,7 @@ public class PatientService : IPatientService
     /// <param name="options">The list of options to evaluate against the patient's current items; may be null.</param>
     /// <param name="patient">The patient whose care plan is being generated.</param>
     /// <param name="user">The user performing the action; may be null.</param>
+    /// <!-- aidoc:v1 sig=4bf9dea body=9cdb19e -->
     public async Task GenerateNurseCarePlanAndInsert(MasterListType carePlanType, List<OptionList>? options,
             Patient patient, User? user)
     {
@@ -2296,6 +2343,7 @@ public class PatientService : IPatientService
     /// <param name="patientId">The unique identifier of the patient to update.</param>
     /// <param name="person">The patient object containing the updated incoming data.</param>
     /// <exception cref="ConflictException">Thrown when the patient cannot be found by the given identifier, or when the incoming data update operation fails.</exception>
+    /// <!-- aidoc:v1 sig=a6c56e3 body=de5d2fe -->
     public async Task UpdatePatientIncomingData(ObjectId patientId, Patient person)
     {
         var oldPatient = await _patientRepository.FindByPatientId(patientId) ??
@@ -2315,6 +2363,7 @@ public class PatientService : IPatientService
     /// <param name="person">The patient entity containing the updated information to apply.</param>
     /// <param name="patientIncomeData">The patient income information to store as a new observation.</param>
     /// <param name="user">The user performing the operation, recorded as the author of the observation.</param>
+    /// <!-- aidoc:v1 sig=35aee7f body=adb3f38 -->
     public async Task UpdatePatientIncomingData(ObjectId patientId, Patient person,
             PatientIncomeData patientIncomeData, User user)
     {
@@ -2337,6 +2386,7 @@ public class PatientService : IPatientService
     /// <param name="opt">The master list option update data to apply to the patients.</param>
     /// <param name="unitList">The collection of units whose associated patients will have the master list option updated.</param>
     /// <param name="typeName">The name of the master list type used to identify which option to update.</param>
+    /// <!-- aidoc:v1 sig=b539b7b body=162a786 -->
     public async Task UpdatePatientMasterListItemChange(UpdateOptionMasterListDto opt, IEnumerable<Unit> unitList,
             string typeName)
     {
@@ -2359,6 +2409,7 @@ public class PatientService : IPatientService
     /// <param name="opt">The master list option to be removed from patient records.</param>
     /// <param name="unitList">The collection of units whose associated patients will be updated.</param>
     /// <param name="typeName">The name of the master list type from which the option is being deleted.</param>
+    /// <!-- aidoc:v1 sig=cb62e44 body=7318409 -->
     public async Task DeletePatientMasterListItem(OptionList opt, IEnumerable<Unit> unitList, string typeName)
     {
         var unitIds = unitList.Select(x => x.Id).ToList();
@@ -2388,6 +2439,8 @@ public class PatientService : IPatientService
     /// <param name="person">The patient object containing the updated demographic data.</param>
     /// <param name="user">The user performing the update, used for audit logging; may be null.</param>
     /// <exception cref="ConflictException">Thrown when no patient is found for the specified patient ID.</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_param_role
+    ///      "The 'user' parameter is documented as 'used for audit logging', but in the code it is passed to UpdatePatientMasterList calls; the audit log entry instead uses _httpContextAccessor.HttpContext?.User!." -->
     public async Task UpdatePatientDemographicData(ObjectId patientId, Patient person, User? user)
     {
         var oldPatient = await _patientRepository.FindByPatientId(patientId) ??
@@ -2411,6 +2464,7 @@ public class PatientService : IPatientService
     /// <param name="patientNumber">The patient number to search for.</param>
     /// <param name="unitId">The identifier of the unit used to find a patient that is distinct from it.</param>
     /// <returns>A task containing the found <see cref="Patient"/>, or <c>null</c> if no matching patient is found.</returns>
+    /// <!-- aidoc:v1 sig=c4b3389 body=200f3e6 -->
     public Task<Patient?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId)
     {
         return _patientRepository.SearchByPatientNumberAndDistinctUnit(patientNumber, unitId);
@@ -2421,6 +2475,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="archiveProcedureEndDateAfterMinutes">The minimum age, in minutes, of a finished procedure's end date used as the cutoff for including patients in the result.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Patient"/> instances associated with finished procedures matching the specified threshold.</returns>
+    /// <!-- aidoc:v1 sig=8527a2e body=c772e96 -->
     public async Task<List<Patient>> FindAllPatientWithFinishedProcedures(int archiveProcedureEndDateAfterMinutes)
     {
         return await _patientRepository.FindAllPatientWithFinishedProcedures(archiveProcedureEndDateAfterMinutes);
@@ -2431,6 +2486,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="archiveTestEndDateAfterMinutes">The number of minutes after the archive test end date used to determine which finished tests to include.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients with finished tests.</returns>
+    /// <!-- aidoc:v1 sig=30ee17f body=2964041 -->
     public async Task<List<Patient>> FindAllPatientWithFinishedTest(int archiveTestEndDateAfterMinutes)
     {
         return await _patientRepository.FindAllPatientWithFinishedTests(archiveTestEndDateAfterMinutes);
@@ -2441,6 +2497,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="archiveTreatmentEndDateAfterMinutes">The minimum number of minutes that must have elapsed since the treatment end date for a patient to be included in the result.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of patients with finished treatments matching the archive criteria.</returns>
+    /// <!-- aidoc:v1 sig=6b43cdf body=d57d2f6 -->
     public async Task<List<Patient>> FindAllPatientWithFinishedTreatment(int archiveTreatmentEndDateAfterMinutes)
     {
         return await _patientRepository.FindAllPatientWithFinishedTreatment(archiveTreatmentEndDateAfterMinutes);
@@ -2452,6 +2509,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The patient instance to validate before insertion.</param>
     /// <returns><c>true</c> if the patient passes all validation checks; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=6b334f4 body=b0c1885 -->
     private bool CheckPatient(Patient patient)
     {
         //patient.AdmTime ??= DateTime.UtcNow;
@@ -2491,6 +2549,7 @@ public class PatientService : IPatientService
     /// <param name="oldPoc">The optional identifier of the previous point of care; when present, subscribers still associated
     /// with it but not with <paramref name="newPoc"/> are removed from the subscription group.</param>
     /// <param name="patient">The patient whose grouped observations are generated and dispatched to the subscribers.</param>
+    /// <!-- aidoc:v1 sig=48b46da body=5e1c89a -->
     private async Task SendLastGroupedObsToSubscriberByPoc(ObjectId newPoc, ObjectId? oldPoc,
             Patient patient)
     {
@@ -2548,6 +2607,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="newPoc">The Point of Care used to look up the list of relevant subscribers.</param>
     /// <param name="patient">The patient whose last observations are retrieved and forwarded to the subscribers.</param>
+    /// <!-- aidoc:v1 sig=12e14ef body=c278c3c -->
     private async Task SendLastObsToSubscriberByPoc(PointOfCare newPoc, Patient patient)
     {
         // Obtén la lista de suscriptores
@@ -2589,6 +2649,7 @@ public class PatientService : IPatientService
     /// <param name="id">The identifier of the patient whose location will be updated.</param>
     /// <param name="unitId">The identifier of the new unit the patient is being moved to.</param>
     /// <param name="pocId">The identifier of the new point-of-care the patient is being moved to.</param>
+    /// <!-- aidoc:v1 sig=f267994 body=442e412 -->
     private async Task UpdateLocation(ObjectId id, ObjectId unitId, ObjectId pocId)
     {
         try
@@ -2689,6 +2750,8 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="newLocation">New location where patient is getting updated</param>
     /// <param name="patientId">Object Id for patient</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the if-branch triggers on 'DELETED or PUSHED', but the code also checks for 'Moved' as a third condition that triggers the same branch (RemoveGroupedObsByPatientId). A reader would incorrectly assume Moved falls into the else branch." -->
     private void CheckLocationForWsSubscriber(PatientLocation? newLocation, ObjectId? patientId)
     {
         if (patientId == null || newLocation == null) return;
@@ -2712,6 +2775,12 @@ public class PatientService : IPatientService
     ///     <param>hoursBeforeArchive</param>
     ///     .
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says it archives 'all patients who have not updated since', but the code only archives patients who are NOT in an active PoC (`.Where(p => !p.IsInActivePoC())`); the 'InInactivePoC' filter is the defining behavior of the method and is omitted." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "References the method name `ArchiveNotUpdatedSince` inside `<c>`, but the actual method is `ArchiveNotUpdatedPatientsInInactivePoCSince`." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "No proper `<param name=\"hoursBeforeArchive\">` element is declared; the existing `<param>hoursBeforeArchive</param>` is malformed and nested inside `<summary>` rather than being a child parameter element." -->
     public async Task ArchiveNotUpdatedPatientsInInactivePoCSince(int hoursBeforeArchive)
     {
         _logger.LogDebug(
@@ -2736,6 +2805,8 @@ public class PatientService : IPatientService
     /// <param name="patient">The patient associated with the location update.</param>
     /// <param name="location">The patient location information to broadcast.</param>
     /// <param name="pocs">The list of point-of-care location identifiers used to filter eligible subscribers. If null or empty, no broadcast is performed.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The method returns Task but no <returns> tag is present." -->
     public Task SendPatientLocationBroadcast(object patient, PatientLocation location,
             List<ObjectId>? pocs)
     {
@@ -2764,6 +2835,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patientid">The unique identifier of the patient whose attending doctor assignment should be broadcast.</param>
     /// <param name="attendingDoctor">The <see cref="Person"/> representing the doctor now attending the patient, included in the broadcast payload.</param>
+    /// <!-- aidoc:v1 sig=d13f6aa body=65b8601 -->
     private async Task SendPatientAttendingDoctorBroadcast(ObjectId patientid, Person attendingDoctor)
     {
         var patient = await FindById(patientid);
@@ -2794,6 +2866,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patientid">The unique identifier of the patient whose data will be broadcast.</param>
     /// <param name="data">The person data payload to be sent to the matching subscribers.</param>
+    /// <!-- aidoc:v1 sig=06d0d2d body=8761d5c -->
     private async Task SendPatientDataBroadcast(ObjectId patientid, Person data)
     {
         var patient = await FindById(patientid);
@@ -2816,6 +2889,7 @@ public class PatientService : IPatientService
     /// Sends an asynchronous patient update broadcast to all subscribers whose location matches the patient's point of care, grouped by their locale. Falls back to the default locale when a group has no locale key, and translates the patient data per locale before dispatching each message as a fire-and-forget send.
     /// </summary>
     /// <param name="patient">The patient whose information is being broadcast; its <c>PointOfCareId</c> is used to match subscribers and its <c>UnitId</c> is used to resolve the unit for translation.</param>
+    /// <!-- aidoc:v1 sig=c2a5661 body=d73de90 -->
     private async Task SendPatientBroadcast(Patient patient)
     {
         var subscribersGroup =
@@ -2843,6 +2917,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patientid">The unique identifier of the patient whose deletion will be broadcast.</param>
     /// <param name="pocId">The point of care location identifier used to filter the targeted subscribers.</param>
+    /// <!-- aidoc:v1 sig=9bf1b1b body=a401d7f -->
     private Task SendDeletePatientBroadcast(ObjectId patientid, ObjectId pocId)
     {
         var subscribers = _subscribersService.GetSubscribers().Where(s => s.LocationIds.Any(x => x == pocId)).ToList();
@@ -2871,6 +2946,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The patient entity to be updated in place.</param>
     /// <param name="apiRequest">The API request providing the source data for the update.</param>
+    /// <!-- aidoc:v1 sig=4cf567a body=9d597d8 -->
     private void UpdatePatientFromRequestToIdList(Patient patient, ApiRequest apiRequest)
     {
         if (apiRequest.AdmTime.HasValue) patient.AdmTime = apiRequest.AdmTime;
@@ -2910,6 +2986,7 @@ public class PatientService : IPatientService
     /// <param name="apiRequest">The API request containing operational data such as the discharge time used to set the patient's discharge timestamp.</param>
     /// <param name="patient">The patient to be moved, updated with the new point of care, unit, and location information.</param>
     /// <param name="virtualPocEnum">The virtual point of care identifier used to look up the destination bed, room, and unit.</param>
+    /// <!-- aidoc:v1 sig=3f3e524 body=d3f1b47 -->
     private async Task RemovePatientAndSendToVirtualPoc(ApiRequest apiRequest, Patient patient,
             VirtualPointOfCare virtualPocEnum)
     {
@@ -2951,6 +3028,7 @@ public class PatientService : IPatientService
     /// Handles three main cases: creating/updating patients present in ICCA but not in the DB, matching existing patients by number, and moving patients absent from ICCA to a temporal/unknown bed. Also persists patients from ICCA locations that are outside the configured point-of-care boxes, falling back to a default unknown point-of-care when a matching location is not found.
     /// </summary>
     /// <param name="apiRequest">The API request containing the list of ICCA patients to synchronize with the local database.</param>
+    /// <!-- aidoc:v1 sig=48ce95c body=52bb041 -->
     private async Task ProcessIccaSync(ApiRequest apiRequest)
     {
         //var sections = await _sectionService.GetAll();
@@ -3077,6 +3155,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="apiRequest">The API request containing the patient number, patient data, and target location information used for the move operation.</param>
     /// <param name="patient">The optional patient to be moved; if null, a new patient is created from the request.</param>
+    /// <!-- aidoc:v1 sig=6ec4557 body=1b97e64 -->
     private async Task ProcessAdtMovePatient(ApiRequest apiRequest, Patient? patient)
     {
         try
@@ -3234,6 +3313,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="apiRequest"></param>
     /// <returns>The Inserted patient or null.</returns>
+    /// <!-- aidoc:v1 sig=5108cc1 body=2ac8fa1 -->
     private async Task<Patient?> ProcessAdtPatientAdmit(ApiRequest apiRequest)
     {
         Patient? patient;
@@ -3374,6 +3454,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The patient whose properties will be updated with the values from the admission.</param>
     /// <param name="patientInAdmission">The admission record providing the source values to be merged into the patient.</param>
+    /// <!-- aidoc:v1 sig=3ff958f body=1711774 -->
     private async Task MergePatientWithAdmission(Patient patient, Admission patientInAdmission)
     {
         patient.Insulation = patientInAdmission.Insulation;
@@ -3414,6 +3495,8 @@ public class PatientService : IPatientService
     /// <param name="patient">The patient entity to mutate with values coming from the request.</param>
     /// <param name="apiRequest">The incoming API request whose non-empty fields are applied to the patient.</param>
     /// <param name="ignoreLocation">When <c>true</c>, skips unit and point-of-care lookups and any location-based updates.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_param_role
+    ///      "ignoreLocation does not skip the unit lookup itself; _unitService.FindByName is invoked unconditionally. It only suppresses the 'unit not found' warning, the main point-of-care lookup, and the location assignment. The 'sin cama' remap block also runs without checking ignoreLocation, so 'any location-based updates' is not fully accurate." -->
     private async Task UpdatePatientFromRequest(Patient patient, ApiRequest apiRequest,
             bool ignoreLocation = false)
     {
@@ -3507,6 +3590,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The patient whose location will be updated.</param>
     /// <param name="apiRequest">The API request containing the new location information.</param>
+    /// <!-- aidoc:v1 sig=4a3fa9a body=86ff39c -->
     private async Task ProcessUpdatePatientLocationWithOru(Patient patient, ApiRequest apiRequest)
     {
         await UpdateLocation(patient.Id, apiRequest.Location);
@@ -3518,6 +3602,7 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="patient">The incoming patient to be updated with merged data.</param>
     /// <param name="oldPatient">The previous patient record whose missing treatments, procedures and tests are preserved during the merge.</param>
+    /// <!-- aidoc:v1 sig=de7cab7 body=b879387 -->
     public async Task UpdatePatientFromMerge(Patient patient, Patient oldPatient)
     {
         var listObsName = _masterListServiceFactory.StringNurseObs();
@@ -3627,6 +3712,8 @@ public class PatientService : IPatientService
     /// <param name="value">The list of option values for the observation, or null to default to an empty list.</param>
     /// <param name="param name="patientId">The identifier of the patient associated with the observation.</param>
     /// <param name="user">The user creating the observation, whose identifier is assigned to the observation; may be null.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The <param> tag for patientId is malformed as `<param name=\"param name=\"patientId\">`, which breaks the XML and effectively omits the patientId parameter documentation." -->
     private async Task GenerateNurseObsAndInsert(string name, List<OptionList>? value, ObjectId patientId, User? user)
     {
         var obs = GenerateObs(
@@ -3645,6 +3732,7 @@ public class PatientService : IPatientService
     /// <param name="value">The list of <see cref="OptionList"/> values for the observation, or <c>null</c> to use an empty list.</param>
     /// <param name="patientId">The identifier of the patient associated with the observation.</param>
     /// <returns>A new <see cref="PatientObservation"/> populated with the provided data, the current date/time, and manual insert mode.</returns>
+    /// <!-- aidoc:v1 sig=ad36884 body=0603f48 -->
     private PatientObservation GenerateObs(string name, List<OptionList>? value, ObjectId patientId)
     {
         var valueList = value ?? [];
@@ -3664,6 +3752,8 @@ public class PatientService : IPatientService
     /// </summary>
     /// <param name="masterListNameString">The name of the property in <see cref="ListSettings"/> whose associated manual observation name should be returned. Must match the property name exactly.</param>
     /// <returns>The <c>ManualObservationName</c> of the resolved <see cref="ListSettingItem"/>, or a descriptive error string if the property is not found or the property value is not a <see cref="ListSettingItem"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary describes the error messages as 'localized', but the code returns hardcoded Spanish string literals rather than localized resources." -->
     public string GetManualObservationName(string masterListNameString)
     {
         // 1. Obtener el tipo de la clase ListSettings.
diff --git a/adas-core.Application/Services/PermissionService.cs b/adas-core.Application/Services/PermissionService.cs
index 7db76a4c..332f8428 100644
--- a/adas-core.Application/Services/PermissionService.cs
+++ b/adas-core.Application/Services/PermissionService.cs
@@ -34,6 +34,7 @@ public class PermissionService(
     /// <param name="user">The user whose authorizations and roles are evaluated to determine the applicable display permissions.</param>
     /// <returns>A <see cref="Task{DisplayPermissionTypes}"/> containing the display permission configuration corresponding to the matched role.</returns>
     /// <exception cref="ForbbidenException">Thrown when the user has no authorizations available, or when none of the user's authorities match the given display or its unit.</exception>
+    /// <!-- aidoc:v1 sig=d8506c7 body=38a9690 -->
     public async Task<DisplayPermissionTypes> GetPermissionsForDisplay(Display display, User user)
     {
         var authorities = user.Authorization;
@@ -92,6 +93,7 @@ public class PermissionService(
     /// <param name="user">The user whose authorizations and role are used to determine the permissions for the unit.</param>
     /// <returns>A <see cref="Task{DisplayPermissionTypes}"/> that resolves to the permission configuration matching the user's role for the specified unit.</returns>
     /// <exception cref="ForbbidenException">Thrown when the user has no authorizations, or when no authorization entry matches the provided <paramref name="unitId"/>.</exception>
+    /// <!-- aidoc:v1 sig=759c4e6 body=fead12d -->
     public Task<DisplayPermissionTypes> GetPermissionsForUnit(string unitId, User user)
     {
         var authorities = user.Authorization;
@@ -165,6 +167,7 @@ public class PermissionService(
     /// <param name="user">The username of the user whose panel permissions are being requested.</param>
     /// <returns>The <see cref="PanelPermissionTypes"/> that apply to the user based on their authorities.</returns>
     /// <exception cref="ForbbidenException">Thrown when no user is found with the specified username.</exception>
+    /// <!-- aidoc:v1 sig=d26061a body=58fe8bf -->
     public async Task<PanelPermissionTypes> GetPermissionsForPanel(string user)
     {
         var userFound = await userRepository.Value.GetByUserName(user);
@@ -179,6 +182,7 @@ public class PermissionService(
     /// <param name="user">The user whose panel permissions are being resolved; must carry authorization data.</param>
     /// <returns>The <see cref="PanelPermissionTypes"/> associated with the matched role.</returns>
     /// <exception cref="ForbbidenException">Thrown when the user has no authorities or no authority grants panel access.</exception>
+    /// <!-- aidoc:v1 sig=cd8a599 body=982b53f -->
     public PanelPermissionTypes GetPermissionsForPanel(User user)
     {
         var authorities = user.Authorization;
@@ -222,6 +226,7 @@ public class PermissionService(
     /// <param name="source">The source permission context used when evaluating access to the display.</param>
     /// <param name="displayId">The string identifier of the display; must be parseable as an ObjectId or access is denied.</param>
     /// <returns>A task that resolves to true if the user's role and authorities grant access to the specified display; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=90064ea body=c31fd83 -->
     public async Task<bool> HasAccessToDisplay(string username, PermissionEnum.RolesType userRole,
             PermissionEnum.SourcePermissionsEnum source, string displayId)
     {
@@ -246,6 +251,7 @@ public class PermissionService(
     /// <param name="source">The source permission context associated with the access evaluation.</param>
     /// <param name="unitId">The identifier of the unit to check access against.</param>
     /// <returns>A task that resolves to true if the user has the required access to the unit; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=906d082 body=40fc526 -->
     public async Task<bool> HasAccessToUnit(string username, PermissionEnum.RolesType userRole,
             PermissionEnum.SourcePermissionsEnum source, string unitId)
     {
@@ -265,6 +271,8 @@ public class PermissionService(
     /// <param name="userRole">The role required to access the panel.</param>
     /// <param name="source">The source permission context used for the access check.</param>
     /// <returns>true if the user exists and has the required role within the panel; otherwise, false.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The 'source' parameter is documented as 'The source permission context used for the access check', but the parameter is never referenced in the method body." -->
     public async Task<bool> HasAccessToPanel(string username, PermissionEnum.RolesType userRole,
             PermissionEnum.SourcePermissionsEnum source)
     {
@@ -286,6 +294,7 @@ public class PermissionService(
     /// <param name="authorities">The list of authorizations to search; a null or empty value causes the method to return <c>false</c>.</param>
     /// <param name="role">The role to find within the matched authorizations or the display's unit.</param>
     /// <returns><c>true</c> if the role is found in any matched authorization or in the display's unit; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=991ebcc body=1585fe1 -->
     private static bool SearchRoleInDisplay(Display display, List<Authorization>? authorities,
             PermissionEnum.RolesType role)
     {
@@ -309,6 +318,7 @@ public class PermissionService(
     /// <param name="authorities">The list of authorizations to inspect; if <c>null</c>, the method short-circuits and returns <c>false</c>.</param>
     /// <param name="role">The role type to look for within the authorities of the specified unit.</param>
     /// <returns><c>true</c> if an authority exists for <paramref name="unitId"/> with a role equal to <paramref name="role"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=693c67c body=dfaeeb7 -->
     private static bool SearchRoleInUnit(string unitId, List<Authorization>? authorities, PermissionEnum.RolesType role)
     {
         if (authorities == null)
@@ -331,6 +341,8 @@ public class PermissionService(
     /// <param name="role">The role to look for within the panel-authorized entries.</param>
     /// <returns><c>true</c> if at least one entry has <c>PanelAuthorization</c> enabled and matches the specified role; otherwise, <c>false</c>.</returns>
     /// <exception cref="ArgumentException">Thrown when an entry's <c>Rol</c> value cannot be parsed into a valid <see cref="PermissionEnum.RolesType"/>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'Returns false... when an entry has no role mapping', but when auth.Rol is null, the code calls Enum.Parse with string.Empty, which throws ArgumentException rather than returning false." -->
     private static bool SearchRoleInPanel(List<Authorization>? authorities, PermissionEnum.RolesType role)
     {
         if (authorities == null)
diff --git a/adas-core.Application/Services/PoCMappingService.cs b/adas-core.Application/Services/PoCMappingService.cs
index 48d71a80..11f0bbd8 100644
--- a/adas-core.Application/Services/PoCMappingService.cs
+++ b/adas-core.Application/Services/PoCMappingService.cs
@@ -11,6 +11,7 @@ namespace adas_core.Application.Services;
 /// Provides a proof-of-concept implementation of the IPoCMappingService interface,
 /// delivering the mapping functionality defined by that contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=47ed72e -->
 public class PoCMappingService : IPoCMappingService
 {
     private readonly string _key;
@@ -41,6 +42,8 @@ public class PoCMappingService : IPoCMappingService
     /// </summary>
     /// <param name="original">location</param>
     /// <returns>mapped location</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states 'otherwise it returns null', but the code returns the original `PatientLocation` when `newBed` is empty and `_mappingRequired` is false, not always null." -->
     public async Task<PatientLocation?> Map(PatientLocation original)
     {
         var pocMapping = await GetMapping();
@@ -55,6 +58,8 @@ public class PoCMappingService : IPoCMappingService
     ///     Return mapping from cache of database based on refreshTime
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The <returns> tag is empty and does not describe that the method returns a Task<PoCMapping?> (the cached or freshly fetched mapping, or null)." -->
     private async Task<PoCMapping?> GetMapping()
     {
         if (_mapping == null || DateTime.Now > _nextRefresh)
diff --git a/adas-core.Application/Services/PointOfCareService.cs b/adas-core.Application/Services/PointOfCareService.cs
index e617e8e3..1af6f0e5 100644
--- a/adas-core.Application/Services/PointOfCareService.cs
+++ b/adas-core.Application/Services/PointOfCareService.cs
@@ -52,6 +52,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="pointOfCare">The point of care to be inserted; its <c>UnitId</c> is validated against the existing unit and reassigned to the resolved unit's identifier.</param>
     /// <returns>A task that resolves to the newly inserted <see cref="PointOfCare"/>, or <c>null</c> when the referenced unit is not found or the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=bca0a55 body=8473996 -->
     public async Task<PointOfCare?> InsertPointOfCare(PointOfCare pointOfCare)
     {
         try
@@ -81,6 +82,7 @@ public class PointOfCareService(
     /// The deletion is skipped if the record cannot be found or if it is linked to an admission.
     /// </summary>
     /// <param name="id">The unique identifier of the Point of Care record to delete.</param>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=b092e75 -->
     public async Task Delete(ObjectId id)
     {
         var poc = await FindById(id);
@@ -98,6 +100,7 @@ public class PointOfCareService(
     /// Deletes all Points of Care associated with the specified unit identifier and removes the corresponding cached entries.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose Points of Care records will be removed.</param>
+    /// <!-- aidoc:v1 sig=0ae7fa6 body=e4e0ee7 -->
     public async Task DeletePoCsByUnitId(ObjectId unitId)
     {
         await pointOfCareRepository.DeleteManyByUnitId(unitId);
@@ -110,6 +113,7 @@ public class PointOfCareService(
     /// Asynchronously retrieves the set of camera identifiers that are currently in use by delegating to the point of care repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a <see cref="HashSet{ObjectId}"/> of camera identifiers in use.</returns>
+    /// <!-- aidoc:v1 sig=f6346fe body=f9c2e26 -->
     public async Task<HashSet<ObjectId>> FindAllIdCamerasInUse()
     {
         return await pointOfCareRepository.FindAllIdCamerasInUse();
@@ -118,6 +122,7 @@ public class PointOfCareService(
     /// Asynchronously retrieves the set of all ID relay identifiers currently in use by delegating to the point of care repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="HashSet{T}"/> of <see cref="ObjectId"/> values representing the ID relays that are in use.</returns>
+    /// <!-- aidoc:v1 sig=7d4add8 body=33e52a4 -->
     public async Task<HashSet<ObjectId>> FindAllIdRelaysInUse()
     {
         return await pointOfCareRepository.FindAllIdRelaysInUse();
@@ -126,6 +131,7 @@ public class PointOfCareService(
     /// Asynchronously retrieves the set of beacon identifiers that are currently in use from the point of care repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="HashSet{ObjectId}"/> with the identifiers of all beacons in use.</returns>
+    /// <!-- aidoc:v1 sig=7e41dd8 body=03369a7 -->
     public async Task<HashSet<ObjectId>> FindAllIdBeaconsInUse()
     {
         return await pointOfCareRepository.FindAllIdBeaconsInUse();
@@ -137,6 +143,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose points of care are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of <see cref="PointOfCare"/> with their devices, or an empty collection if the repository returns no results.</returns>
+    /// <!-- aidoc:v1 sig=74ce5ed body=1883f5a -->
     public async Task<IEnumerable<PointOfCare>?> FindAllByUnitIdWithDevices(ObjectId unitId)
     {
         var result = await pointOfCareRepository.FindAllByUnitIdWithDevices(unitId);
@@ -151,6 +158,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="pointOfCare">The point of care entity containing the updated information to persist.</param>
     /// <returns>The updated <see cref="PointOfCare"/>, or <c>null</c> if the record was not found after the update.</returns>
+    /// <!-- aidoc:v1 sig=686be32 body=fcf3e9a -->
     public async Task<PointOfCare?> Update(PointOfCare pointOfCare)
     {
         var oldPoc = await pointOfCareRepository.FindById(pointOfCare.Id);
@@ -169,6 +177,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="id">The identifier of the point of care to update.</param>
     /// <param name="unit">The unit to assign to the point of care.</param>
+    /// <!-- aidoc:v1 sig=bd40218 body=687d0e1 -->
     public async Task UpdateUnit(ObjectId id, Unit unit)
     {
         var poc = await FindById(id);
@@ -187,6 +196,7 @@ public class PointOfCareService(
     /// Asynchronously retrieves all points of care from the repository, returning an empty list when the repository yields a null result.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing the list of points of care, or an empty list if none are available.</returns>
+    /// <!-- aidoc:v1 sig=c48e6dc body=e5d1056 -->
     public async Task<List<PointOfCare>> GetAll()
     {
         var c = await pointOfCareRepository.GetAll();
@@ -198,6 +208,7 @@ public class PointOfCareService(
     /// Returns an empty list if the repository result is null.
     /// </summary>
     /// <returns>A list of PointOfCare configurations, or an empty list when no configurations are available.</returns>
+    /// <!-- aidoc:v1 sig=cb7ad06 body=64bfd0c -->
     public async Task<List<PointOfCare>> GetAllConfigs()
     {
         var c = await pointOfCareRepository.GetAllConfigs();
@@ -209,6 +220,7 @@ public class PointOfCareService(
     /// Returns an empty list when the repository yields no results, ensuring callers never receive a null collection.
     /// </summary>
     /// <returns>A task that resolves to a list of <see cref="PointOfCare"/> entries, or an empty list if no locations are found.</returns>
+    /// <!-- aidoc:v1 sig=7c1c627 body=b5ec7ac -->
     public async Task<List<PointOfCare>> GetAllLocationInfo()
     {
         var c = await pointOfCareRepository.GetAllLocationInfo();
@@ -221,6 +233,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to compute the skip offset and limit the number of returned items.</param>
     /// <returns>A <see cref="PaginationResponse{PointOfCare}"/> containing the requested page of points of care, the current page number, page size, and the total document count.</returns>
+    /// <!-- aidoc:v1 sig=e44c6c3 body=1f1be82 -->
     public async Task<PaginationResponse<PointOfCare>> GetPaginatedPoCs(PaginationFilter filter)
     {
         var result = pointOfCareRepository.GetPaginatedPoCs(filter);
@@ -241,6 +254,7 @@ public class PointOfCareService(
     /// <param name="configuration">The new configuration values to persist.</param>
     /// <returns>A task that represents the asynchronous update operation.</returns>
     /// <exception cref="ConflictException">Thrown when no existing Point of Care configuration is found for the specified identifier.</exception>
+    /// <!-- aidoc:v1 sig=1874ae4 body=04cf29d -->
     public async Task UpdateConfiguration(ObjectId id, PointOfCareConfiguration configuration)
     {
         var old = await pointOfCareRepository.GetPoCConfiguration(id) ??
@@ -258,6 +272,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="id">The unique identifier of the point of care to retrieve.</param>
     /// <returns>The matching <see cref="PointOfCare"/> with all configurations, or <c>null</c> if no point of care is found.</returns>
+    /// <!-- aidoc:v1 sig=2826028 body=4c3b92d -->
     public async Task<PointOfCare?> FindById(ObjectId id)
     {
         return await pointOfCareRepository.FindByIdAllConfig(id);
@@ -267,6 +282,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="id">The unique identifier of the point of care to retrieve.</param>
     /// <returns>The matching <see cref="PointOfCare"/> with all configuration when found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=3a998f5 body=4c3b92d -->
     public async Task<PointOfCare?> FindByIdAllConfig(ObjectId id)
     {
         return await pointOfCareRepository.FindByIdAllConfig(id);
@@ -278,6 +294,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="unit">The unique identifier of the unit whose points of care should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of points of care for the given unit, or an empty collection if none are found.</returns>
+    /// <!-- aidoc:v1 sig=1265646 body=83d400d -->
     public async Task<IEnumerable<PointOfCare>?> FindAllByUnitId(ObjectId unit)
     {
         var result = await pointOfCareRepository.FindAllByUnitId(unit);
@@ -292,6 +309,7 @@ public class PointOfCareService(
     /// <param name="poc">The point of care status used to filter the results.</param>
     /// <param name="excludeVirtual">When set to <c>true</c>, virtual points of care are excluded from the returned collection.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the collection of points of care matching the specified unit and status.</returns>
+    /// <!-- aidoc:v1 sig=6b7e346 body=a9f878c -->
     public async Task<IEnumerable<PointOfCare>> FindByUnitAndStatus(ObjectId unitId, StatusEnum.PointOfCare poc,
             bool excludeVirtual = false)
     {
@@ -302,6 +320,7 @@ public class PointOfCareService(
     ///     Check nex admission when patient has exit from poc
     /// </summary>
     /// <param name="patientLocation">PoC id</param>
+    /// <!-- aidoc:v1 sig=825e453 body=dc756f7 -->
     public async void CheckNextAdmission(ObjectId? patientLocation)
     {
         try
@@ -347,6 +366,7 @@ public class PointOfCareService(
     /// <param name="bed">The bed identifier used to locate the point of care.</param>
     /// <param name="unitId">The unit identifier; when <c>null</c>, the method short-circuits and returns <c>null</c>.</param>
     /// <returns>A <see cref="Task{T}"/> containing the matching <see cref="PointOfCare"/>, or <c>null</c> if no input is valid or no record is found.</returns>
+    /// <!-- aidoc:v1 sig=f5e0229 body=ecc3ffd -->
     public async Task<PointOfCare?> FindByBedAndUnitId(string? bed, ObjectId? unitId)
     {
         if (unitId == null || string.IsNullOrEmpty(bed)) return null;
@@ -358,6 +378,7 @@ public class PointOfCareService(
     /// The update, cache invalidation, and audit logging are only performed when <see cref="PointOfCare.Configuration"/> and its <c>RelayIdList</c> are not null.
     /// </summary>
     /// <param name="poc">The Point of Care whose relay configuration will be updated.</param>
+    /// <!-- aidoc:v1 sig=5d59b5d body=b7b7775 -->
     public async Task UpdateRelayConfig(PointOfCare poc)
     {
         var oldPoc = await pointOfCareRepository.GetPoCConfiguration(poc.Id);
@@ -374,6 +395,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="room">The room identifier used to look up matching points of care.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{PointOfCare}"/> of points of care for the given room, or <c>null</c> if no matching points of care are found.</returns>
+    /// <!-- aidoc:v1 sig=d9b8bd7 body=a7c7ece -->
     public async Task<IEnumerable<PointOfCare>?> FindByRoom(string room)
     {
         return await pointOfCareRepository.FindByRoom(room);
@@ -384,6 +406,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="bed">The bed identifier used to look up the associated points of care.</param>
     /// <returns>A task that returns an <see cref="IEnumerable{PointOfCare}"/> of points of care linked to the given bed, or <c>null</c> if no points of care are found.</returns>
+    /// <!-- aidoc:v1 sig=27196b1 body=71b820c -->
     public async Task<IEnumerable<PointOfCare>?> FindByBed(string bed)
     {
         return await pointOfCareRepository.FindByBed(bed);
@@ -394,6 +417,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="unitIds">The list of unit identifiers used to filter the points of care.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of matching points of care.</returns>
+    /// <!-- aidoc:v1 sig=17b231e body=a6cc8e1 -->
     public async Task<List<PointOfCare>> FindAllByUnitIds(List<ObjectId> unitIds)
     {
         var filter = Builders<PointOfCare>.Filter.In(p => p.UnitId, unitIds);
@@ -407,6 +431,7 @@ public class PointOfCareService(
     /// <param name="id">The identifier of the point of care to retrieve.</param>
     /// <param name="fillPatientData">If <c>true</c>, loads and attaches the related patient and admission (when an admission id is present) to the returned point of care.</param>
     /// <returns>A task that yields the <see cref="PointOfCare"/> with resolved related data, or <c>null</c> if no point of care is found for the given id.</returns>
+    /// <!-- aidoc:v1 sig=0a64187 body=c5c8930 -->
     public async Task<PointOfCare?> GetInfo(ObjectId id, bool fillPatientData = true)
     {
         var poc = await FindById(id);
@@ -446,6 +471,7 @@ public class PointOfCareService(
     /// <param name="fillPatientData">When <c>true</c>, enriches the result with unit, patient, and admission data; when <c>false</c>, returns the point of care as-is.</param>
     /// <param name="ct">Token used to cancel the asynchronous operation.</param>
     /// <returns>The retrieved and optionally enriched <see cref="PointOfCare"/>, or <c>null</c> if no point of care is found for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=90b64a6 body=60870a4 -->
     public async Task<PointOfCare?> GetInfo(ObjectId id, LocaleEnum? locale, bool fillPatientData = true,
             CancellationToken ct = default)
     {
@@ -487,6 +513,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose Point of Care is being requested.</param>
     /// <returns>The <see cref="PointOfCare"/> associated with the patient if one is assigned; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=efa0335 body=a99a4ec -->
     public async Task<PointOfCare?> FindPoCByPatientId(ObjectId patientId)
     {
         var patient = await patientService.Value.FindById(patientId);
@@ -501,6 +528,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <returns>A task that represents the asynchronous operation, containing the associated <see cref="PointOfCare"/> if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=f14442d body=02a6db9 -->
     public async Task<PointOfCare?> FindPoCByPatientNumber(string patientNumber)
     {
         var patient = await patientService.Value.FindByPatientNumber(patientNumber);
@@ -514,6 +542,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose PoCs should be counted.</param>
     /// <returns>A task representing the asynchronous operation, containing the total number of PoCs linked to the given unit.</returns>
+    /// <!-- aidoc:v1 sig=5433677 body=692ab9e -->
     public async Task<long> CountPoCsByUnitId(ObjectId unitId)
     {
         return await pointOfCareRepository.CountByUnitId(unitId);
@@ -524,6 +553,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="unitId">The unique identifier of the unit whose virtual PoCs are being counted.</param>
     /// <returns>A <see cref="Task{long}"/> representing the asynchronous operation, containing the total number of virtual PoCs linked to the given unit.</returns>
+    /// <!-- aidoc:v1 sig=62cdca4 body=a5dd4e4 -->
     public async Task<long> CountVirtualPoCsByUnitId(ObjectId unitId)
     {
         return await pointOfCareRepository.CountVirtualsByUnitId(unitId);
@@ -537,6 +567,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="id">The unique identifier of the point of care whose status should be updated.</param>
     /// <param name="status">The new point of care status to apply.</param>
+    /// <!-- aidoc:v1 sig=8b769d6 body=e16609b -->
     public async Task SetPointOfCareStatus(ObjectId id, StatusEnum.PointOfCare status)
     {
         var pointOfCare = await GetInfo(id, null);
@@ -562,6 +593,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="patientLocation">The patient location used to look up the associated Point of Care.</param>
     /// <returns>A task that yields the matching <see cref="PointOfCare"/>, or <c>null</c> if no Point of Care is found for the given location.</returns>
+    /// <!-- aidoc:v1 sig=81e2a50 body=1670341 -->
     public async Task<PointOfCare?> FindPoCByPatientLocation(PatientLocation patientLocation)
     {
         return await pointOfCareRepository.FindByPatientLocation(patientLocation);
@@ -573,6 +605,7 @@ public class PointOfCareService(
     /// </summary>
     /// <param name="pointOfCare">The point of care whose related subscribers should receive the notification. Its <c>Id</c> is used to match subscriber location identifiers.</param>
     /// <param name="operation">The type of operation (e.g., create, update, delete) being broadcast, sent as the message payload.</param>
+    /// <!-- aidoc:v1 sig=6782e58 body=7d10a0d -->
     private void SendPointOfCareBroadcast(PointOfCare pointOfCare, OperationType operation)
     {
         try
diff --git a/adas-core.Application/Services/PumpService.cs b/adas-core.Application/Services/PumpService.cs
index edf35e83..05401fc6 100644
--- a/adas-core.Application/Services/PumpService.cs
+++ b/adas-core.Application/Services/PumpService.cs
@@ -27,6 +27,7 @@ namespace adas_core.Application.Services
     /// - Snapshot (pump_state)
     /// - Broadcast de snapshots (PumpState + PumpAlarmState)
     /// </summary>
+    /// <!-- aidoc:v1 sig=0b0aa26 -->
     public class PumpService(
         IPumpObservationRepository pumpObservationRepository,
         IPumpStateRepository pumpStateRepo,
@@ -57,6 +58,7 @@ namespace adas_core.Application.Services
         /// Processes an incoming <see cref="ApiRequest"/> by normalizing its pump observations, resolving or creating the associated patient, and handling each observation according to its message type (HL7 PCD-01/04/10 or AlarisPump). For each observation, it dispatches to the appropriate observation or alarm pipeline, updates the pump state snapshot, broadcasts the resulting snapshots with any active device alarms, and applies retention rules on the historical observations. AlarisPump observations without a PatientId are discarded, and per-observation processing errors are logged without aborting the whole request.
         /// </summary>
         /// <param name="req">The API request containing the pump observations and message type to be persisted and broadcast.</param>
+        /// <!-- aidoc:v1 sig=3ced5b9 body=c626166 -->
         public async Task SaveRequest(ApiRequest req)
         {
             // Normalizar single vs list (Alaris puede mandar 1 sola)
@@ -142,6 +144,7 @@ namespace adas_core.Application.Services
         /// Processes a pump observation by assigning an identifier and expiration, mapping it to the persistence model, and persisting it together with an audit log entry when the mapping succeeds.
         /// </summary>
         /// <param name="obs">The pump observation to process. Its <c>Id</c> and <c>Expires</c> are populated before mapping.</param>
+        /// <!-- aidoc:v1 sig=9e025e2 body=74d05a4 -->
         private async Task ProcessObservation(PumpObservation obs)
         {
             logger.LogDebug("Insertando OBSERVATION DeviceId={dev} Time={time}", obs.DeviceId, obs.Time);
@@ -165,6 +168,7 @@ namespace adas_core.Application.Services
         /// Persists a pump alarm event derived from the supplied observation and updates the associated alarm state.
         /// </summary>
         /// <param name="obs">The pump observation providing the device, infusion, alarm, and patient context used to build the alarm event.</param>
+        /// <!-- aidoc:v1 sig=e9b46d7 body=fc7e79f -->
         private async Task ProcessAlarm(PumpObservation obs)
         {
             logger.LogDebug("Insertando ALARM DeviceId={dev}, Phase={phase}, Type={type}",
@@ -205,6 +209,7 @@ namespace adas_core.Application.Services
         /// Updates the alarm state for a pump observation, removing the active alarm when the event phase is "end" and upserting a new alarm state record for start or continue phases.
         /// </summary>
         /// <param name="obs">The pump observation providing the event phase, device identifier, alarm type, and related alarm metadata used to drive the alarm state change.</param>
+        /// <!-- aidoc:v1 sig=cc5c035 body=95b81e6 -->
         private async Task UpdateAlarmState(PumpObservation obs)
         {
             if (obs.EventPhase == null) return;
@@ -251,6 +256,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="obs">The pump observation whose values are merged into the current state and used to locate the device's existing record.</param>
         /// <returns>The updated <see cref="PumpState"/> instance reflecting the merged observation and the new <c>LastUpdated</c> timestamp.</returns>
+        /// <!-- aidoc:v1 sig=e28e643 body=185db9d -->
         private async Task<PumpState> UpdatePumpState(PumpObservation obs)
         {
             var current = await pumpStateRepo.FindByDeviceIdAsync(obs.DeviceId!)
@@ -274,6 +280,8 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="state">The target <see cref="PumpState"/> instance whose fields will be updated in place.</param>
         /// <param name="obs">The <see cref="PumpObservation"/> instance supplying the new candidate values to merge.</param>
+        /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+        ///      "The summary claims 'each field' is updated only when the observation provides a valid value, but the last line unconditionally assigns state.PatientId = obs.PatientId with no null/whitespace guard, contradicting that universal claim." -->
         private static void MergePumpState(PumpState state, PumpObservation obs)
         {
             // Identidad / físico
@@ -343,6 +351,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="v">The nullable pump value to inspect.</param>
         /// <returns><c>true</c> when <paramref name="v"/> is not null and its <c>Value</c> is not null; otherwise, <c>false</c>.</returns>
+        /// <!-- aidoc:v1 sig=c30317b -->
         private static bool HasValue(CommonPumpTypes.PumpValue? v) => v is { Value: not null };
 
         //  MAP 
@@ -352,6 +361,8 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="obs">The pump observation to be transformed through the mapping pipeline.</param>
         /// <returns>A task that yields the mapped <see cref="PumpObservation"/>, or <c>null</c> when the calculated observations stage produces no result.</returns>
+        /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+        ///      "The <returns> tag states the method returns null 'when the calculated observations stage produces no result', but obs4 is only used for logging via LogDebug; the method always returns obs3, so a null result from the calculated observations stage has no effect on the returned value." -->
         public async Task<PumpObservation?> MapPumpObservation(PumpObservation obs)
         {
             var obs2 = await configPumpsService.Map(obs);
@@ -371,6 +382,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="req">The API request to be saved.</param>
         /// <returns>A task that represents the asynchronous save operation.</returns>
+        /// <!-- aidoc:v1 sig=951b5f8 -->
         public Task SaveRequestAsync(ApiRequest req) => SaveRequest(req);
 
 
@@ -381,6 +393,7 @@ namespace adas_core.Application.Services
         /// <param name="patientId">The unique identifier of the patient whose pump observations are being retrieved.</param>
         /// <param name="num">The maximum number of recent pump observations to return. Defaults to 1.</param>
         /// <returns>A task that resolves to a list of the most recent <see cref="PumpObservation"/> records for the patient, or an empty list when none are available.</returns>
+        /// <!-- aidoc:v1 sig=0a9eb02 body=3be1853 -->
         public async Task<List<PumpObservation>> FindLastPumpObservations(ObjectId patientId, int num = 1)
         {
             var list = await pumpObservationRepository.FindByPatientId(patientId);
@@ -396,6 +409,7 @@ namespace adas_core.Application.Services
         /// Asynchronously retrieves the most recent pump observation timestamp for every patient by delegating to the pump observation repository.
         /// </summary>
         /// <returns>A task that resolves to a dictionary mapping each patient's <see cref="ObjectId"/> to the <see cref="DateTime"/> of their last pump observation.</returns>
+        /// <!-- aidoc:v1 sig=115ac00 body=dd1cce6 -->
         public async Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime()
         {
             return await pumpObservationRepository.FindAllLastPatientObservationTimeAsync();
@@ -407,6 +421,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="id">The unique identifier of the patient whose related pump data should be removed.</param>
         /// <returns>A task that represents the asynchronous deletion of the patient's data across the pump observation, alarm event, and alarm state repositories.</returns>
+        /// <!-- aidoc:v1 sig=09e4e41 body=fee3771 -->
         public async Task DeleteByPatientId(ObjectId id)
         {
             logger.LogDebug("Delete Pump data by Patient Id {id}", id);
@@ -420,6 +435,7 @@ namespace adas_core.Application.Services
         /// Archives the specified patient by delegating the operation to the archive routine identified by the patient's identifier.
         /// </summary>
         /// <param name="patient">The patient to be archived.</param>
+        /// <!-- aidoc:v1 sig=14b3e19 -->
         public async Task Archive(Patient patient) => await ArchiveByPatientId(patient.Id);
 
         // Archivo → por PatientId (mueve a archive_pumpobservations y elimina del activo)
@@ -427,6 +443,7 @@ namespace adas_core.Application.Services
         /// Archives all pump observations associated with the specified patient by moving them to the archive repository and then deleting the active data. If no pump observations are found for the patient, the archive insertion is skipped while the deletion of active data still proceeds.
         /// </summary>
         /// <param name="id">The unique identifier of the patient whose pump observations should be archived.</param>
+        /// <!-- aidoc:v1 sig=3385472 body=58d55f6 -->
         public async Task ArchiveByPatientId(ObjectId id)
         {
             var list = await pumpObservationRepository.FindByPatientId(id);
@@ -446,6 +463,7 @@ namespace adas_core.Application.Services
         /// <param name="id">The new ObjectId to assign.</param>
         /// <param name="oldId">The existing ObjectId to be replaced.</param>
         /// <exception cref="ArgumentException">Thrown when <paramref name="nameId"/> is null, empty, or whitespace.</exception>
+        /// <!-- aidoc:v1 sig=72ce1ca body=f3ec601 -->
         public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
         {
 
@@ -476,6 +494,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="id">The identifier used to look up the configuration pump items.</param>
         /// <returns>A task that represents the asynchronous operation. The task result is a list of <see cref="ConfigPumpItem"/> matching the given identifier, or <c>null</c> if no items are found.</returns>
+        /// <!-- aidoc:v1 sig=eedef4c -->
         public async Task<List<ConfigPumpItem>?> GetItemsById(string id)
                     => await configPumpsService.GetConfigItems(id);
 
@@ -485,6 +504,7 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="ConfigPumps"/> configurations.</returns>
         /// <exception cref="NotFoundException">Thrown when the underlying service returns a null result, meaning the pump configuration resource was not found.</exception>
+        /// <!-- aidoc:v1 sig=e34911b -->
         public async Task<List<ConfigPumps>?> GetAllPumpConfig()
                     => await configPumpsService.GetAllPumpConfigs()
                        ?? throw new NotFoundException(HttpEnum.ErrorMessage.NotFoundResourceMissing);
@@ -496,6 +516,8 @@ namespace adas_core.Application.Services
         /// <param name="id">The unique identifier of the pump configuration to retrieve.</param>
         /// <returns>The matching <see cref="ConfigPumps"/> instance, or <c>null</c> if the service returns one; otherwise a <see cref="NotFoundException"/> is thrown.</returns>
         /// <exception cref="NotFoundException">Thrown when the configuration service returns <c>null</c>, indicating that the requested resource is missing.</exception>
+        /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+        ///      "The <returns> tag states the method may return null if the service returns one, but the code throws NotFoundException in that case, so null is never returned." -->
         public async Task<ConfigPumps?> GetPumpConfigsById(string id)
                     => await configPumpsService.GetPumpConfigById(id)
                        ?? throw new NotFoundException(HttpEnum.ErrorMessage.NotFoundResourceMissing);
@@ -506,6 +528,7 @@ namespace adas_core.Application.Services
         /// <param name="config">The pump configuration containing the updated values to persist.</param>
         /// <returns>The updated <see cref="ConfigPumps"/> configuration if the update succeeds.</returns>
         /// <exception cref="NotFoundException">Thrown when the underlying update operation does not return a configuration, indicating the resource is missing.</exception>
+        /// <!-- aidoc:v1 sig=16f1333 body=f673ce7 -->
         public async Task<ConfigPumps?> UpdatePumpConfig(ConfigPumps config)
         {
             var oldConfig = await configPumpsService.GetPumpConfigById(config.Id);
@@ -520,6 +543,8 @@ namespace adas_core.Application.Services
         /// <param name="config">The pump configuration to insert.</param>
         /// <returns>The newly inserted <see cref="ConfigPumps"/>, or <see langword="null"/> if the operation yields no result.</returns>
         /// <exception cref="ConflictException">Thrown when the pump configuration could not be created by the underlying service.</exception>
+        /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+        ///      "The documentation states the method may return null when the operation yields no result, but the code uses `?? throw new ConflictException(...)`, so a null result is converted into a thrown exception rather than returned. The method never actually returns null." -->
         public async Task<ConfigPumps?> InsertPumpConfig(ConfigPumps config)
         {
             await auditService.CreateAuditLogAsync(httpContextAccessor.HttpContext?.User!, null, config);
@@ -533,6 +558,7 @@ namespace adas_core.Application.Services
         /// <param name="config">The pump configuration to delete.</param>
         /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the deletion was successful.</returns>
         /// <exception cref="ConflictException">Thrown when the underlying deletion operation fails.</exception>
+        /// <!-- aidoc:v1 sig=5589ecb body=1433282 -->
         public async Task<bool> DeletePumpConfig(ConfigPumps config)
         {
             var result = await configPumpsService.DeletePumpConfig(config);
@@ -547,6 +573,8 @@ namespace adas_core.Application.Services
         /// </summary>
         /// <param name="filter">The pagination and filter criteria, including page number, page size, optional patient identifier, device identifier, and date range.</param>
         /// <returns>A task that yields the paginated response of pump observations, or <c>null</c> if the operation cannot be performed.</returns>
+        /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+        ///      "Documentation states the method may return null when the operation cannot be performed, but the code never returns null in any code path (it always returns a non-null PaginationResponse, possibly empty). Note: the type signature PaginationResponse<PumpObservation>? permits null, but the implementation never produces it." -->
         public async Task<PaginationResponse<PumpObservation>?> GetPaginatedPump(PaginationFilter filter)
         {
             // Implementación compatible sin nuevos métodos en los repos:
@@ -600,6 +628,8 @@ namespace adas_core.Application.Services
         /// Inserts a pump observation into the repository, applying default values for missing identifier and timestamp, and triggers post-insertion side effects such as audit logging, state updates, snapshot broadcasting, and retention actions. If the mapped observation is null, no further action is taken. Observations with a number of zero are skipped from post-insertion processing when zero-value emissions are disabled.
         /// </summary>
         /// <param name="obs">The pump observation to insert. Its <c>Id</c> is generated if not set, and its <c>Time</c> defaults to UTC now if set to <see cref="DateTime.MinValue"/>.</param>
+        /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+        ///      "The summary states default values are applied for 'missing identifier', but the code unconditionally generates a new Id (obs.Id = ObjectId.GenerateNewId()) regardless of whether one was previously set, while the timestamp default is actually conditional." -->
         public async Task InsertPumpObservation(PumpObservation obs)
         {
             logger.LogDebug("Insert {obs}", obs);
@@ -627,6 +657,7 @@ namespace adas_core.Application.Services
         /// Applies the configured retention policy to pump observations, executing deletion by age (days) or by count (keeping the last N), and logging a warning for unrecognized policies. Returns early when no retention policy value is available.
         /// </summary>
         /// <param name="obs">The pump observation used to resolve the applicable retention configuration.</param>
+        /// <!-- aidoc:v1 sig=69d9eb2 body=4a9842a -->
         private async Task DoRetentionActions(PumpObservation obs)
         {
             var result = await configPumpsService.RetentionActions(obs);
@@ -679,6 +710,7 @@ namespace adas_core.Application.Services
         /// <param name="patientId">Optional patient identifier used to resolve the patient and derive the target location; when null the request location is used instead.</param>
         /// <param name="req">Optional API request whose <c>Location</c> is used as a fallback to resolve the target location when no patient identifier is provided.</param>
         /// <returns>A <see cref="Task"/> that completes once the pump state and all active alarms have been dispatched, or immediately when there are no matching subscribers.</returns>
+        /// <!-- aidoc:v1 sig=f2630b9 body=43b3596 -->
         private async Task SendSnapshotsBroadcast(
                     PumpState state,
                     IEnumerable<PumpAlarmState> activeAlarms,
@@ -734,6 +766,7 @@ namespace adas_core.Application.Services
         /// <param name="req">The API request that may contain a patient id to be parsed and assigned.</param>
         /// <param name="obs">The pump observation whose patient id is being updated in place.</param>
         /// <param name="foundPatientId">An optional patient id obtained from a prior lookup, used as a fallback when the observation has no patient id assigned.</param>
+        /// <!-- aidoc:v1 sig=a9136e6 body=0d864ed -->
         private static void UpdatePatientFromRequest(ApiRequest req, PumpObservation obs, ObjectId? foundPatientId)
         {
             if (obs.PatientId == null && foundPatientId != null)
diff --git a/adas-core.Application/Services/RecordingAlertService.cs b/adas-core.Application/Services/RecordingAlertService.cs
index 54c8038d..c1981774 100644
--- a/adas-core.Application/Services/RecordingAlertService.cs
+++ b/adas-core.Application/Services/RecordingAlertService.cs
@@ -17,6 +17,22 @@ namespace adas_core.Application.Services;
 /// Uses <see cref="IRecordingAlertRepository"/> and <see cref="IRecordingAlertArchiveRepository"/> for alert persistence, and lazily resolves <see cref="IPatientService"/> through <paramref name="patientService"/>.
 /// </remarks>
 /// <!-- aidoc:v1 sig=6c23cec -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'configObservationService' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'recordingAlertRepository' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'recordingAlertArchiveRepository' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'logger' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'clientMessageService' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'subscribersService' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'httpContextAccessor' is not documented with a <param> tag." -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "Constructor parameter 'auditService' is not documented with a <param> tag." -->
 public class RecordingAlertService(
     Lazy<IPatientService> patientService,
     IConfigObservationService configObservationService,
@@ -34,6 +50,7 @@ public class RecordingAlertService(
     /// </summary>
     /// <param name="patient">The patient to be archived.</param>
     /// <returns>A task that represents the asynchronous archive operation.</returns>
+    /// <!-- aidoc:v1 sig=0afe718 body=be01ba0 -->
     public async Task Archive(Patient patient)
     {
         await ArchiveByPatientId(patient.Id);
@@ -44,6 +61,7 @@ public class RecordingAlertService(
     /// to the archive repository and then deleting them from the source repository.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose recording alerts should be archived.</param>
+    /// <!-- aidoc:v1 sig=3385472 body=286b52c -->
     public async Task ArchiveByPatientId(ObjectId id)
     {
         logger.LogDebug("Archive Recording Alerts by Patient Id {id}", id);
@@ -61,6 +79,7 @@ public class RecordingAlertService(
     /// Deletes all recording alerts associated with the specified patient identifier by delegating to the recording alert repository.
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose recording alerts should be removed.</param>
+    /// <!-- aidoc:v1 sig=09e4e41 body=b6d232c -->
     public async Task DeleteByPatientId(ObjectId id)
     {
         logger.LogDebug("Delete Recording Alerts by Patient Id {id}", id);
@@ -73,6 +92,7 @@ public class RecordingAlertService(
     /// <param name="patientId">The unique identifier of the patient whose recording alerts are being queried.</param>
     /// <param name="num">The maximum number of recent alerts to return. Defaults to 2.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of the patient's most recent <see cref="PatientRecordingAlert"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=8d69c21 body=4613a27 -->
     public async Task<List<PatientRecordingAlert>> FindLastRecordingAlert(ObjectId patientId, int num = 2)
     {
         return await recordingAlertRepository.AggregatedPatientLastObservations(patientId, num);
@@ -84,6 +104,7 @@ public class RecordingAlertService(
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=a3706aa body=c8d77ba -->
     public Task SaveRequestAsync(ApiRequest apiRequest)
     {
         return Task.FromResult(Task.Run(async () => { await SaveRequest(apiRequest); }));
@@ -95,6 +116,7 @@ public class RecordingAlertService(
     /// </summary>
     /// <param name="apiRequest">The API request containing patient or location identifiers and the recording alerts to persist.</param>
     /// <exception cref="ApiRequestException">Thrown when <paramref name="apiRequest"/>.Type is not a valid type for Observations.</exception>
+    /// <!-- aidoc:v1 sig=229d8cd body=d93e92b -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         if (string.IsNullOrEmpty(apiRequest.PatientNumber) && string.IsNullOrEmpty(apiRequest.Location?.UnitName) &&
@@ -164,6 +186,7 @@ public class RecordingAlertService(
     /// <param name="nameId">The name identifier used to filter the records to update.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign to the matching records.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced in the matching records.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=c1620c4 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await recordingAlertRepository.UpdateManyObjectId(nameId, id, oldId);
@@ -173,6 +196,7 @@ public class RecordingAlertService(
     /// Inserts a new patient recording alert by persisting it, creating an audit log entry, broadcasting the alert, and executing any associated retention actions.
     /// </summary>
     /// <param name="recAlert">The patient recording alert to be inserted and processed.</param>
+    /// <!-- aidoc:v1 sig=4687f06 body=311839c -->
     private async Task InsertRecordingAlert(PatientRecordingAlert recAlert)
     {
         logger.LogDebug("Insert {recAlert}", recAlert);
@@ -186,6 +210,7 @@ public class RecordingAlertService(
     /// Asynchronously broadcasts a patient observation to subscribers whose registered locations include the patient's point of care, sending a recording alert when the observation is a recording alert and a generic observation otherwise. The method returns early without sending any message if the observation has no name, the patient cannot be resolved, or the patient has no point of care assigned.
     /// </summary>
     /// <param name="recAlert">The patient observation to broadcast to matching subscribers.</param>
+    /// <!-- aidoc:v1 sig=6f93bc2 body=b6d7077 -->
     private async Task SendObsBroadcast(BasePatientObservation recAlert)
     {
         if (recAlert.Name == null) return;
@@ -210,6 +235,7 @@ public class RecordingAlertService(
     /// </summary>
     /// <param name="recAlert">The patient recording alert whose retention actions will be evaluated and applied.</param>
     /// <exception cref="ArgumentOutOfRangeException">Thrown when the resolved <see cref="RetentionPolicy"/> value is not handled by the switch statement.</exception>
+    /// <!-- aidoc:v1 sig=90f8187 body=a64ba52 -->
     private async Task DoRetentionActions(PatientRecordingAlert recAlert)
     {
         var result = await configObservationService.RetentionActions(recAlert);
diff --git a/adas-core.Application/Services/RecordingService.cs b/adas-core.Application/Services/RecordingService.cs
index 6e7de36d..c3510540 100644
--- a/adas-core.Application/Services/RecordingService.cs
+++ b/adas-core.Application/Services/RecordingService.cs
@@ -21,6 +21,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Provides functionality for recording operations as defined by the <see cref="IRecordingService"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=5872d8b -->
 public class RecordingService : IRecordingService
 {
     private readonly IAuthService _authService;
@@ -95,6 +96,7 @@ public class RecordingService : IRecordingService
     /// <param name="poc">The point of care associated with the recording.</param>
     /// <returns>A task that resolves to <c>true</c> if the cancel request succeeded; otherwise, <c>false</c>.</returns>
     /// <exception cref="Exception">Thrown when the recording API URL is not defined or the authentication token is null or empty.</exception>
+    /// <!-- aidoc:v1 sig=34368ee body=ee5471e -->
     public async Task<bool> SendCancelRecordingToRecordingApi(Patient patient, PointOfCare poc)
     {
         var token = await _authService.GetToken();
@@ -125,6 +127,7 @@ public class RecordingService : IRecordingService
     /// <param name="poc">The point of care where the recording was performed.</param>
     /// <param name="manualRecording">The manual recording whose start and stop times are forwarded to the queue.</param>
     /// <param name="start">A flag indicating whether the recording is being started or stopped.</param>
+    /// <!-- aidoc:v1 sig=f624109 body=55cd11e -->
     public async Task SendRecordingData(Patient patient, PointOfCare poc, ManualRecording manualRecording,
             bool start)
     {
@@ -140,6 +143,7 @@ public class RecordingService : IRecordingService
     /// <param name="poc">The point of care where the recording was captured.</param>
     /// <param name="automaticRecording">The automatic recording payload, including alarm name, start/stop/event timestamps, severity, and description.</param>
     /// <returns>A task that resolves to <c>true</c> if the recording data was queued successfully; otherwise, <c>false</c> when the alarm name cannot be parsed or the send operation fails.</returns>
+    /// <!-- aidoc:v1 sig=3c0ea0c body=f69af0b -->
     public async Task<bool> SendAutoRecordingData(Patient patient, PointOfCare poc, RecordingData automaticRecording)
     {
         try
@@ -178,6 +182,7 @@ public class RecordingService : IRecordingService
     /// <param name="start">Flag indicating whether the recording is a start event; defaults to true.</param>
     /// <param name="type">The alarm type for the recording; defaults to <see cref="AlarmEnum.Type.Manual"/>.</param>
     /// <exception cref="Exception">Thrown when the point of care status is not <see cref="StatusEnum.PointOfCare.InUse"/>, including the serialized point of care in the message.</exception>
+    /// <!-- aidoc:v1 sig=e6985f2 body=01a1208 -->
     public async Task SendRecordingDataToQueue(Patient patient, PointOfCare poc, DateTime? date, DateTime? endDate,
             DateTime? eventDate, AlarmEnum.Name? alarmName, AlarmEnum.Severity severity, string? alarmDescription,
             bool start = true, AlarmEnum.Type type = AlarmEnum.Type.Manual)
@@ -242,6 +247,8 @@ public class RecordingService : IRecordingService
     /// </summary>
     /// <param name="roomId">The identifier of the room whose recordings should be fetched.</param>
     /// <returns>A task that resolves to a list of <see cref="RecordingData"/> for the room, an empty list when the request fails or the room has no recordings, or <c>null</c> when the recording API URL or authentication token is not configured or when the maximum number of retries is reached.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The documentation states the method returns null 'when the maximum number of retries is reached', but the post-loop check `if (retryCount == _rabbitMqSettings.MaxRetries)` is unreachable: after all retries throw HttpRequestException, `retryCount` is `MaxRetries + 1`, so the null branch is skipped and an empty list is returned instead." -->
     public async Task<List<RecordingData>?> GetRecordings(int roomId)
     {
         var retryCount = 1;
@@ -331,6 +338,7 @@ public class RecordingService : IRecordingService
     /// </summary>
     /// <param name="apiRequest">The API request whose recording data and patient information will be sent to the Recording API.</param>
     /// <exception cref="Exception">Rethrown via Task.FromException when a non-HTTP error occurs while sending the recording request.</exception>
+    /// <!-- aidoc:v1 sig=655d140 body=ec1d813 -->
     public async Task SaveRequestAsync(ApiRequest apiRequest)
     {
         var retryCount = 1;
@@ -420,6 +428,7 @@ public class RecordingService : IRecordingService
     /// </summary>
     /// <param name="apiRequest">The API request to save.</param>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=3385bba body=bfa6f2f -->
     public Task SaveRequest(ApiRequest apiRequest)
     {
         //return Task.CompletedTask;
@@ -442,6 +451,7 @@ public class RecordingService : IRecordingService
     /// <param name="alarmDescription">A textual description of the alarm.</param>
     /// <param name="alarm">The alarm type, defaulting to <see cref="AlarmEnum.Type.Manual"/> when not specified.</param>
     /// <returns>A configured <see cref="RecordingData"/> instance, or <c>null</c> if any required identifier is invalid.</returns>
+    /// <!-- aidoc:v1 sig=912bcd8 body=3236ae1 -->
     private RecordingData? GenerateRecordingData(Patient patient, PointOfCare poc, DateTime? startDate,
             DateTime? endDate, DateTime? eventTime, int? minToExpired, AlarmEnum.Name? alarmName,
             AlarmEnum.Severity severity,
@@ -502,6 +512,7 @@ public class RecordingService : IRecordingService
     /// and silently returns when the patient cannot be resolved.
     /// </summary>
     /// <param name="recording">The list of recording entries to broadcast; the first item is used to resolve the patient and room context.</param>
+    /// <!-- aidoc:v1 sig=f4cef29 body=92782d1 -->
     private async Task SendRecordingBroadcast(List<RecordingData> recording)
     {
         if (!recording.IsNullOrEmpty())
@@ -534,6 +545,7 @@ public class RecordingService : IRecordingService
     /// </summary>
     /// <param name="plainText">The text to encode.</param>
     /// <returns>The Base64 encoded representation of the input text.</returns>
+    /// <!-- aidoc:v1 sig=7418cfd body=746e11b -->
     protected static string Base64Encode(string plainText)
     {
         var plainTextBytes = Encoding.UTF8.GetBytes(plainText);
diff --git a/adas-core.Application/Services/SchedulerService.cs b/adas-core.Application/Services/SchedulerService.cs
index cdbcd1fb..0470a611 100644
--- a/adas-core.Application/Services/SchedulerService.cs
+++ b/adas-core.Application/Services/SchedulerService.cs
@@ -19,6 +19,7 @@ namespace adas_core.Application.Services;
 /// <summary>
 /// Provides scheduling functionality as a service to manage and coordinate timed or periodic operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=524e1c4 -->
 public class SchedulerService
 {
     private readonly bool _activateCheckExpiredAlerts;
@@ -73,6 +74,7 @@ public class SchedulerService
     /// <param name="httpClientFactory">Factory used to create HTTP clients for provider integrations.</param>
     /// <param name="calculatedObservationsService">Lazy provider of calculated observations operations.</param>
     /// <param name="patientProcedureService">Lazy provider of patient care plan operations.</param>
+    /// <!-- aidoc:v1 sig=2ce1d53 body=1abbe4d -->
     public SchedulerService(IOptions<ApiSettings> apiSettings,
             IOptions<List<ProvidersSettings>> providersSettings,
             Lazy<IPatientService> patientService,
@@ -167,6 +169,8 @@ public class SchedulerService
     /// <summary>
     /// Initializes the Quartz scheduler by wiring up service dependencies for background jobs, creating job and trigger definitions, and conditionally scheduling them based on feature flag configuration settings before starting the scheduler.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states jobs are scheduled 'before starting the scheduler', but the code starts the scheduler first (await scheduler.Start()) and then calls ScheduleJobs afterwards." -->
     private async Task InitScheduler()
     {
         //TODO con el cambio a .net core y el repaso a la inyección de dependencias de estructure map
@@ -398,6 +402,7 @@ public class SchedulerService
 /// <remarks>
 /// The DisallowConcurrentExecution attribute prevents overlapping executions of this job.
 /// </remarks>
+/// <!-- aidoc:v1 sig=e3fb42b -->
 [DisallowConcurrentExecution]
 public class CheckHydricBalanceRyCJob : IJob
 {
@@ -413,6 +418,7 @@ public class CheckHydricBalanceRyCJob : IJob
     /// All exceptions raised during processing are caught and logged, allowing the job to finish without interrupting the scheduler.
     /// </summary>
     /// <param name="context">The Quartz job execution context provided by the scheduler when the job trigger fires.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=41f8cfc -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -457,6 +463,7 @@ public class CheckHydricBalanceRyCJob : IJob
 /// <remarks>
 /// The DisallowConcurrentExecution attribute ensures that only one instance of this job can execute at any given time.
 /// </remarks>
+/// <!-- aidoc:v1 sig=e9c40b0 -->
 [DisallowConcurrentExecution]
 public class CheckActiveTreatmentsJob : IJob
 {
@@ -474,6 +481,7 @@ public class CheckActiveTreatmentsJob : IJob
     /// Executes the scheduled job that iterates through all patients, retrieves their active treatments and the associated medicines (excluding nutrition-type medicines), and calculates medicine observations for each patient. Exceptions are caught and logged without rethrowing, and the total execution duration is logged upon completion.
     /// </summary>
     /// <param name="context">The job execution context provided by the scheduler.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=0440983 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -525,6 +533,7 @@ public class CheckActiveTreatmentsJob : IJob
 /// <remarks>
 /// The <see cref="DisallowConcurrentExecutionAttribute"/> attribute prevents multiple instances of this job from running at the same time.
 /// </remarks>
+/// <!-- aidoc:v1 sig=0dd74bf -->
 [DisallowConcurrentExecution]
 public class CheckActiveAppointmentsJob : IJob
 {
@@ -540,6 +549,7 @@ public class CheckActiveAppointmentsJob : IJob
     /// Executes the scheduled check active appointments job, logging the start and completion times along with the total elapsed time. Any exception thrown during execution is caught and logged without being rethrown.
     /// </summary>
     /// <param name="context">The Quartz scheduler context that provides runtime information for the job execution.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=5d53712 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -567,6 +577,7 @@ public class CheckActiveAppointmentsJob : IJob
 /// <remarks>
 /// The DisallowConcurrentExecution attribute prevents multiple instances of this job from running simultaneously.
 /// </remarks>
+/// <!-- aidoc:v1 sig=df3113f -->
 [DisallowConcurrentExecution]
 public class CheckInactivePatientsJob : IJob
 {
@@ -579,6 +590,7 @@ public class CheckInactivePatientsJob : IJob
     /// Skips processing when another instance is already running, as indicated by the global <c>isCheckingInactivePatients</c> flag, and logs the elapsed execution time.
     /// </summary>
     /// <param name="context">The Quartz job execution context whose <see cref="IJobExecutionContext.JobDetail"/> data map supplies the inactivity and discharge thresholds.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=b1deaf7 -->
     public async Task Execute(IJobExecutionContext context)
     {
         //LogExecutionContext.TrySetTraceIdentifier(Guid.NewGuid().ToString(), true);
@@ -617,6 +629,7 @@ public class CheckInactivePatientsJob : IJob
 /// <remarks>
 /// The <c>DisallowConcurrentExecution</c> attribute ensures that overlapping executions of this job are prevented, guaranteeing that only one instance runs at a time.
 /// </remarks>
+/// <!-- aidoc:v1 sig=ea835b5 -->
 [DisallowConcurrentExecution]
 public class CheckOpiateBolusesJob : IJob
 {
@@ -630,6 +643,8 @@ public class CheckOpiateBolusesJob : IJob
     /// logging any errors that occur and reporting the total execution time upon completion.
     /// </summary>
     /// <param name="context">The Quartz job execution context provided by the scheduler for this job run.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=missing_returns
+    ///      "The method returns Task but no <returns> tag is provided (low severity since Quartz Execute methods typically have no meaningful return value)." -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -660,6 +675,7 @@ public class CheckOpiateBolusesJob : IJob
 /// <remarks>
 /// The <see cref="DisallowConcurrentExecutionAttribute"/> attribute ensures that only one instance of this job can execute at a given time, preventing overlapping runs that could lead to duplicate processing of expired observations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=5ab6b97 -->
 [DisallowConcurrentExecution]
 public class CheckExpiredObservationsJob : IJob
 {
@@ -672,6 +688,7 @@ public class CheckExpiredObservationsJob : IJob
     /// Executes the scheduled job that checks and expires observations, recalculating dependent data. Uses a global flag to prevent concurrent execution of the expiration logic, and logs the start, duration, and any errors encountered.
     /// </summary>
     /// <param name="context">The job execution context provided by the scheduler.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=05b3176 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -705,6 +722,7 @@ public class CheckExpiredObservationsJob : IJob
 /// <summary>
 ///     Job for calculate NEWS based on FR, SPo2, Temperature, Tas and FC
 /// </summary>
+/// <!-- aidoc:v1 sig=3533a62 -->
 [DisallowConcurrentExecution]
 public class CalculateNewsJob : IJob
 {
@@ -728,6 +746,7 @@ public class CalculateNewsJob : IJob
     /// the latest underlying observation is not expired.
     /// </summary>
     /// <param name="context">The Quartz job execution context provided by the scheduler.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=2929244 -->
     public async Task Execute(IJobExecutionContext context)
     {
         //Filter patients in real locations
@@ -885,6 +904,7 @@ public class CalculateNewsJob : IJob
 /// <remarks>
 /// This job is decorated with the <see cref="DisallowConcurrentExecutionAttribute"/> to prevent overlapping executions of the same job instance.
 /// </remarks>
+/// <!-- aidoc:v1 sig=de60ccf -->
 [DisallowConcurrentExecution]
 public class CheckExpiredAlertsJob : IJob
 {
@@ -898,6 +918,7 @@ public class CheckExpiredAlertsJob : IJob
     /// Runs the expiration logic only when the global "isCheckingAlertsExpiration" flag is absent or set to false; any exception is caught and logged without being rethrown.
     /// </summary>
     /// <param name="context">The Quartz job execution context provided by the scheduler when the job trigger fires.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=fe3b1b9 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -929,6 +950,7 @@ public class CheckExpiredAlertsJob : IJob
 /// <remarks>
 /// The <see cref="DisallowConcurrentExecutionAttribute"/> attribute ensures that the job will not be triggered while a previous execution is still running.
 /// </remarks>
+/// <!-- aidoc:v1 sig=36ea806 -->
 [DisallowConcurrentExecution]
 public class ArchiveNurseDataJob : IJob
 {
@@ -945,6 +967,7 @@ public class ArchiveNurseDataJob : IJob
     /// Executes the ArchiveNurseDataJob which archives finished nurse procedures, tests, and treatments for patients whose associated end dates exceed the configured thresholds defined in <see cref="ArchiveNurseDataSettings"/>. Each archive category is only processed when its corresponding setting flag is active, and any exception is caught and logged without interrupting the remaining work.
     /// </summary>
     /// <param name="context">The Quartz.NET job execution context that provides runtime information for the scheduled job execution.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=d478de0 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
@@ -1053,6 +1076,7 @@ public class ArchiveNurseDataJob : IJob
 /// Represents a scheduled job that retrieves observations associated with providers.
 /// </summary>
 /// <remarks>The DisallowConcurrentExecution attribute prevents overlapping executions of this job instance.</remarks>
+/// <!-- aidoc:v1 sig=172abfc -->
 [DisallowConcurrentExecution]
 public class GetProvidersObservationsJob : IJob
 {
@@ -1073,6 +1097,7 @@ public class GetProvidersObservationsJob : IJob
     /// skips providers whose type or required constructor cannot be found, and logs and recovers from any exception raised during processing.
     /// </summary>
     /// <param name="context">The Quartz job execution context provided by the scheduler when the job is triggered.</param>
+    /// <!-- aidoc:v1 sig=1b2454a body=6326f48 -->
     public async Task Execute(IJobExecutionContext context)
     {
         var start = DateTime.Now;
diff --git a/adas-core.Application/Services/ServiceConfigService.cs b/adas-core.Application/Services/ServiceConfigService.cs
index eef53a76..af34d424 100644
--- a/adas-core.Application/Services/ServiceConfigService.cs
+++ b/adas-core.Application/Services/ServiceConfigService.cs
@@ -30,6 +30,7 @@ public class ServiceConfigService(
     /// <param name="id">The identifier of the service configuration to retrieve. May be a string id or a valid ObjectId representation.</param>
     /// <returns>The matching <see cref="ServiceConfig"/>, or <c>null</c> when no record is found for the provided id.</returns>
     /// <exception cref="NotFoundException">Thrown when the resource cannot be found after attempting both the string id and the parsed <see cref="ObjectId"/> lookup.</exception>
+    /// <!-- aidoc:v1 sig=61e5b19 body=92358a2 -->
     public async Task<ServiceConfig?> Get(string id)
     {
         var result = await serviceConfigRepository.FindById(id);
diff --git a/adas-core.Application/Services/SubscribersService.cs b/adas-core.Application/Services/SubscribersService.cs
index bcf0270a..89159cf4 100644
--- a/adas-core.Application/Services/SubscribersService.cs
+++ b/adas-core.Application/Services/SubscribersService.cs
@@ -8,6 +8,7 @@ namespace adas_core.Application.Services;
 /// Provides operations for managing subscribers by implementing the <see cref="ISubscribersService"/> contract.
 /// Acts as the concrete service layer responsible for subscriber-related functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=e353a71 -->
 public class SubscribersService : ISubscribersService
 {
     private readonly List<WsSubscriber> _subscribers = [];
@@ -17,6 +18,7 @@ public class SubscribersService : ISubscribersService
     /// Retrieves a thread-safe snapshot of the current list of WebSocket subscribers.
     /// </summary>
     /// <returns>A new <see cref="List{WsSubscriber}"/> containing a copy of the current subscribers.</returns>
+    /// <!-- aidoc:v1 sig=3155474 body=ddb46e4 -->
     public List<WsSubscriber> GetSubscribers()
         {
             lock (_subscribers)
@@ -32,6 +34,7 @@ public class SubscribersService : ISubscribersService
     /// </summary>
     /// <param name="contextConnectionId">The unique connection identifier of the subscriber to look up.</param>
     /// <returns>The matching <see cref="WsSubscriber"/> if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=856df48 body=db50c61 -->
     public WsSubscriber? GetById(string contextConnectionId)
         {
             lock (_subscribers)
@@ -46,6 +49,7 @@ public class SubscribersService : ISubscribersService
     /// </summary>
     /// <param name="pocId">The point-of-contact identifier used to match subscribers by their location list.</param>
     /// <returns>A list of <see cref="WsSubscriber"/> instances that have <paramref name="pocId"/> in their location identifiers; returns an empty list when no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=3b0aee1 body=c5fc264 -->
     public List<WsSubscriber> GetByPocId(ObjectId pocId)
         {
             lock (_subscribers)
@@ -59,6 +63,7 @@ public class SubscribersService : ISubscribersService
     /// </summary>
     /// <param name="contextConnectionId">The unique identifier of the connection to remove.</param>
     /// <returns>The number of connections that were removed from the subscribers list.</returns>
+    /// <!-- aidoc:v1 sig=46195a8 body=3ef844c -->
     public int RemoveConnectionById(string contextConnectionId)
         {
             lock (_subscribers)
@@ -72,6 +77,7 @@ public class SubscribersService : ISubscribersService
     /// Ensures that concurrent calls to add subscribers are serialized to prevent race conditions.
     /// </summary>
     /// <param name="subscriber">The WebSocket subscriber to add to the collection.</param>
+    /// <!-- aidoc:v1 sig=def83cb body=fdd2d71 -->
     public void AddSubscriber(WsSubscriber subscriber)
         {
             lock (_subscribers)
diff --git a/adas-core.Application/Services/TreatmentService.cs b/adas-core.Application/Services/TreatmentService.cs
index 08bb63b3..8e9b33eb 100644
--- a/adas-core.Application/Services/TreatmentService.cs
+++ b/adas-core.Application/Services/TreatmentService.cs
@@ -25,6 +25,7 @@ namespace adas_core.Application.Services;
 /// (<c>OMP_O09</c>, <c>ORM_O01</c>, <c>RAS_O17</c>) and emits broadcasts to
 /// subscribers based on the patient's point of care.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2ea7df4 -->
 public class TreatmentService(
     ITreatmentRepository treatmentRepository,
     ITreatmentArchiveRepository treatmentArchiveRepository,
@@ -47,6 +48,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// an <see cref="IEnumerable{T}"/> of <see cref="PatientTreatment"/> for the patient.
     /// </returns>
+    /// <!-- aidoc:v1 sig=10e5f85 body=be14412 -->
     public async Task<IEnumerable<PatientTreatment>> GetTreatmentsByPatientId(ObjectId id)
     {
         return await treatmentRepository.GetByPatientId(id);
@@ -62,6 +64,7 @@ public class TreatmentService(
     /// If the treatment cannot be mapped, it is silently ignored. A broadcast
     /// is dispatched asynchronously upon successful insertion.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=d915a21 body=09c8128 -->
     public async Task Insert(PatientTreatment treatment)
     {
         logger.LogDebug("Insert {treatment}", treatment);
@@ -88,6 +91,7 @@ public class TreatmentService(
     /// Thrown when the patient has no treatments to delete (no record was found)
     /// or when the underlying delete operation fails.
     /// </exception>
+    /// <!-- aidoc:v1 sig=cc92a12 body=aa4c4ae -->
     public async Task<bool> DeleteByPatientId(ObjectId id)
     {
         var treatmentToDelete = await FindByPatientId(id) ??
@@ -108,6 +112,7 @@ public class TreatmentService(
     /// </summary>
     /// <param name="patient">The <see cref="Patient"/> whose treatments will be archived.</param>
     /// <returns>A task that represents the asynchronous archive operation.</returns>
+    /// <!-- aidoc:v1 sig=0afe718 body=be01ba0 -->
     public async Task Archive(Patient patient)
     {
         await ArchiveByPatientId(patient.Id);
@@ -119,6 +124,7 @@ public class TreatmentService(
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the patient whose treatments will be archived.</param>
     /// <returns>A task that represents the asynchronous archive operation.</returns>
+    /// <!-- aidoc:v1 sig=3385472 body=15c288e -->
     public async Task ArchiveByPatientId(ObjectId id)
     {
         logger.LogDebug("ArchiveB Treatments by Patient Id PatientId {id}", id);
@@ -144,6 +150,7 @@ public class TreatmentService(
     /// <exception cref="ConflictException">
     /// Thrown when the treatment does not exist or the update operation fails.
     /// </exception>
+    /// <!-- aidoc:v1 sig=6e80560 body=5fae191 -->
     public async Task<bool> UpdateTreatment(PatientTreatment patientTreatment)
     {
         var oldTreatment = await treatmentRepository.GetById(patientTreatment.Id) ??
@@ -166,6 +173,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// an <see cref="IAsyncCursor{T}"/> of <see cref="PatientTreatment"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=2560a5d body=edd0375 -->
     public async Task<IAsyncCursor<PatientTreatment>> FindByPatientIdAsync(ObjectId patientId)
     {
         return await treatmentRepository.FindByPatientIdAsync(patientId);
@@ -179,6 +187,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// an <see cref="IEnumerable{T}"/> of <see cref="PatientTreatment"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=1aafccf body=be6338f -->
     public async Task<IEnumerable<PatientTreatment>> FindByPatientId(ObjectId patientId)
     {
         return await treatmentRepository.FindByPatientId(patientId);
@@ -192,6 +201,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// a <see cref="List{T}"/> of <see cref="PatientTreatment"/> representing the bolus treatments.
     /// </returns>
+    /// <!-- aidoc:v1 sig=9ad10af body=3161220 -->
     public async Task<List<PatientTreatment>> GetBolusTreatments(ObjectId patientId)
     {
         return await treatmentRepository.FindBolusTreatments(patientId);
@@ -202,6 +212,7 @@ public class TreatmentService(
     /// </summary>
     /// <param name="apiRequest">The inbound <see cref="ApiRequest"/> to process.</param>
     /// <returns>A task that represents the asynchronous save operation.</returns>
+    /// <!-- aidoc:v1 sig=655d140 body=fe3d8b2 -->
     public async Task SaveRequestAsync(ApiRequest apiRequest)
     {
         await SaveRequest(apiRequest);
@@ -221,6 +232,7 @@ public class TreatmentService(
     /// The method also enforces the unit's <c>AutoAdt</c> configuration when the
     /// request does not originate from a panel.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=229d8cd body=9f1cf3d -->
     public async Task SaveRequest(ApiRequest apiRequest)
     {
         if (string.IsNullOrEmpty(apiRequest.PatientNumber))
@@ -307,6 +319,7 @@ public class TreatmentService(
     /// representing the active treatments. Treatments marked as <c>Dc</c> or
     /// outside their validity window are excluded.
     /// </returns>
+    /// <!-- aidoc:v1 sig=1c9e799 body=f285c51 -->
     public async Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         var treatments = await treatmentRepository.GetByPatientId(id);
@@ -330,6 +343,7 @@ public class TreatmentService(
     /// <param name="id">The new <see cref="ObjectId"/> value.</param>
     /// <param name="oldId">The previous <see cref="ObjectId"/> value being replaced.</param>
     /// <returns>A task that represents the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=72ce1ca body=e91a5b9 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await treatmentRepository.UpdateManyObjectId(nameId, id, oldId);
@@ -346,6 +360,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// a <see cref="PaginationResponse{T}"/> of <see cref="PatientTreatment"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=e26055d body=baf1772 -->
     public async Task<PaginationResponse<PatientTreatment>> GetPaginatedTreatments(PaginationFilter filter)
     {
         var result = treatmentRepository.GetPaginatedTreatments(filter);
@@ -371,6 +386,7 @@ public class TreatmentService(
     /// A task that represents the asynchronous operation. The task result contains
     /// a <see cref="List{T}"/> of <see cref="PatientTreatment"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=3821694 body=dbc3de2 -->
     public async Task<List<PatientTreatment>> GetActiveTreatmentsByPatientIdAndOrder(ObjectId patientId, string order)
     {
         return await treatmentRepository.GetActiveTreatmentsByPatientIdAndOrder(patientId, order);
@@ -385,6 +401,7 @@ public class TreatmentService(
     /// <exception cref="ConflictException">
     /// Thrown when the treatment does not exist.
     /// </exception>
+    /// <!-- aidoc:v1 sig=9ab6da4 body=cbff241 -->
     public async Task DeleteById(ObjectId id)
     {
         var oldTreatment = await treatmentRepository.GetById(id) ??
@@ -407,6 +424,7 @@ public class TreatmentService(
     /// If the configuration-observation service returns <see langword="null"/>,
     /// the treatment is considered ignored and a debug entry is logged.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=c13749c body=e16fa1f -->
     private async Task<PatientTreatment?> MapTreatment(PatientTreatment treatment)
     {
         var treatment2 = await calculatedObservationsService.Value.Map(treatment);
@@ -428,6 +446,7 @@ public class TreatmentService(
     /// If the patient cannot be located or has no <c>PointOfCareId</c>, the
     /// broadcast is skipped.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=fd42729 body=b957bc2 -->
     private async Task SendBroadcast(PatientTreatment treatment, OperationType operationType)
     {
         var patient = await patientService.FindById(treatment.PatientId);
@@ -452,6 +471,8 @@ public class TreatmentService(
     /// discontinued (<see cref="OrderControlType.Dc"/>) and the current UTC
     /// time lies within its validity window; otherwise, <see langword="false"/>.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary describes the treatment as 'not canceled', but the code checks for OrderControlType.Dc (discontinued), which is distinct from canceled (OrderControlType.Ca) in HL7." -->
     private static bool IsValidTreatment(PatientTreatment treatment)
     {
         if (treatment.PlacerOrder == null)
@@ -478,6 +499,7 @@ public class TreatmentService(
     /// The most recent treatment whose <see cref="OrderControlType"/> is
     /// <c>Nw</c> or <c>Xo</c>, or <see langword="null"/> if none qualifies.
     /// </returns>
+    /// <!-- aidoc:v1 sig=e49781f body=fc0887d -->
     private static PatientTreatment? GetMostRecentActiveTreatment(IGrouping<string?, PatientTreatment> group)
     {
         return group
diff --git a/adas-core.Application/Services/UnitService.cs b/adas-core.Application/Services/UnitService.cs
index 124a1d99..11b271ce 100644
--- a/adas-core.Application/Services/UnitService.cs
+++ b/adas-core.Application/Services/UnitService.cs
@@ -41,6 +41,7 @@ public class UnitService(
     /// </summary>
     /// <param name="withPoCs">If <c>true</c>, loads and assigns the PointOfCares for each unit; if <c>false</c>, returns units without their PointOfCares.</param>
     /// <returns>A task representing the asynchronous operation, containing the list of all units, with PointOfCares populated when requested.</returns>
+    /// <!-- aidoc:v1 sig=e53198c body=b2eb1e0 -->
     public async Task<List<Unit>> GetAll(bool withPoCs = false)
         {
             var units = await unitRepository.GetAll();
@@ -59,6 +60,7 @@ public class UnitService(
     /// Retrieves all units in a compact representation, mapping each unit to a <see cref="UnitInfoDto"/> containing its identifier, name, and title, with null name and title values safely replaced by empty strings.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="UnitInfoDto"/> objects for all available units.</returns>
+    /// <!-- aidoc:v1 sig=d5bdc99 body=459fadb -->
     public async Task<List<UnitInfoDto>> GetAllCompact()
         {
             var units = await unitRepository.GetAll();
@@ -78,6 +80,7 @@ public class UnitService(
     /// </summary>
     /// <param name="id">The unique identifier of the unit to retrieve.</param>
     /// <returns>A <see cref="Task{UnitInfoDto}"/> containing the compact unit information, or a DTO with null/empty fields if the unit does not exist.</returns>
+    /// <!-- aidoc:v1 sig=83a227f body=03176e8 -->
     public async Task<UnitInfoDto> GetOneCompact(ObjectId id)
         {
             var unit = await unitRepository.FindById(id);
@@ -97,6 +100,7 @@ public class UnitService(
     /// <param name="filter">The pagination parameters controlling the page number, page size, and total count.</param>
     /// <param name="withPoCs">Indicates whether the response units should be populated with their related Points of Care. Defaults to false.</param>
     /// <returns>A <see cref="Task{PaginationResponse{Unit}}"/> containing the requested page of units along with pagination metadata.</returns>
+    /// <!-- aidoc:v1 sig=ace0a7a body=e4686d4 -->
     public async Task<PaginationResponse<Unit>> GetPaginatedUnits(PaginationFilter filter, bool withPoCs = false)
         {
             var result = unitRepository.GetPaginatedUnits(filter);
@@ -133,6 +137,8 @@ public class UnitService(
     /// <param name="withPoCs">When <see langword="true"/>, also loads and assigns the Points of Care associated with the unit; when <see langword="false"/> (default), the Points of Care collection is not populated.</param>
     /// <returns>A <see cref="Task{Unit}"/> that yields the requested <see cref="Unit"/> with its optional related lists and Points of Care, or <see langword="null"/> when no unit matches the identifier.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit is found for the supplied <paramref name="id"/>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> tag states the method yields 'null when no unit matches the identifier', but the code uses '?? throw new NotFoundException(...)' so a missing unit causes an exception rather than a null return." -->
     public async Task<Unit?> GetInfo(ObjectId id, LocaleEnum? dataLocale, bool fillLists = true, bool withPoCs = false)
         {
             var unit = await Get(id.ToString()) ??
@@ -252,6 +258,8 @@ public class UnitService(
     /// <param name="withDevices">Flag intended to control device inclusion alongside the points of care.</param>
     /// <returns>The matching <see cref="Unit"/> instance.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit exists for the supplied <paramref name="id"/>.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=mentions_removed_behavior
+    ///      "The `withDevices` parameter is documented as a 'flag intended to control device inclusion alongside the points of care', but the parameter is never used in the method body — `FindAllByUnitIdWithDevices` is always called (with devices) regardless of the flag whenever `withPoCs` is true." -->
     public async Task<Unit?> GetInfo(ObjectId id, bool withPoCs = true, bool withDevices = true)
         {
             var unit = await Get(id.ToString()) ??
@@ -271,6 +279,7 @@ public class UnitService(
     /// <param name="itemUnitName">The name of the unit to search for.</param>
     /// <returns>The unit matching the specified name.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit exists with the provided name.</exception>
+    /// <!-- aidoc:v1 sig=7ccf7cc body=9d60511 -->
     public async Task<Unit?> GetByName(string itemUnitName)
         {
             return await unitRepository.FindByName(itemUnitName) ??
@@ -284,6 +293,8 @@ public class UnitService(
     /// <param name="patientId">The identifier of the patient whose associated unit should be retrieved.</param>
     /// <returns>A <see cref="Task{Unit}"/> containing the associated <see cref="Unit"/> if found, or <c>null</c> when no matching unit exists.</returns>
     /// <exception cref="NotFoundException">Thrown when the patient has no associated <c>UnitId</c> (i.e., the resource is missing).</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The returns tag uses <see cref=\"Task{Unit}\"/> but the method signature is Task<Unit?>; the nullable annotation is missing from the type reference (the descriptive text 'or null' partially compensates)." -->
     public async Task<Unit?> FindByPatientId(ObjectId patientId)
         {
             //var sections = await GetAll();
@@ -305,6 +316,7 @@ public class UnitService(
     /// <param name="masterListId">The identifier of the master list used to find the associated units.</param>
     /// <param name="masterListType">The type of the master list used to filter the units.</param>
     /// <returns>A task that represents the asynchronous operation, containing a collection of <see cref="Unit"/> entities if found, or <c>null</c> if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=d996cfa body=ae5cf23 -->
     public async Task<IEnumerable<Unit>?> FindUnitsByMasterListId(ObjectId masterListId, MasterListType masterListType)
         {
             try
@@ -327,6 +339,7 @@ public class UnitService(
     /// <param name="masterListId">The unique identifier of the master list whose units should be counted.</param>
     /// <param name="masterListType">The type of the master list used to filter the units to be counted.</param>
     /// <returns>A <see cref="Task{Int64}"/> representing the asynchronous operation, containing the total number of units that match the given master list identifier and type.</returns>
+    /// <!-- aidoc:v1 sig=2014d9c body=8106f59 -->
     public async Task<long> CountUnitsByMasterListId(ObjectId masterListId, MasterListType masterListType)
         {
             return await unitRepository.CountUnitsByMasterListId(masterListId, masterListType);
@@ -338,6 +351,7 @@ public class UnitService(
     /// </summary>
     /// <param name="masterListId">The identifier of the master list whose units should be retrieved.</param>
     /// <returns>A task that yields the collection of <see cref="Unit"/> items matching the master list identifier, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=ff45b25 body=1fd5690 -->
     public async Task<IEnumerable<Unit>> FindUnitsByMasterListId(ObjectId masterListId)
         {
             try
@@ -362,6 +376,8 @@ public class UnitService(
     /// <returns>The updated <see cref="Unit"/> if the operation succeeds; otherwise, <c>null</c> when the underlying update returns no result.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit is found matching the identifier specified in <paramref name="updateUnitListDto"/>.</exception>
     /// <exception cref="ConflictException">Thrown when the update operation performed by the repository fails to produce a result.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The documentation states the method returns null when the underlying update returns no result, but the code throws ConflictException in that case; the method never actually returns null." -->
     public async Task<Unit?> UpdateUnitMasterList(UpdateUnitIdListDto updateUnitListDto)
         {
             var unit = await FindById(updateUnitListDto.UnitId) ??
@@ -380,6 +396,8 @@ public class UnitService(
     /// <returns>A task that resolves to <c>true</c> when the configuration was successfully updated; otherwise, <c>false</c>.</returns>
     /// <exception cref="NotFoundException">Thrown when the unit cannot be found either before or after the update operation.</exception>
     /// <exception cref="ConflictException">Thrown when the underlying update operation fails to persist the new configuration.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation claims the method resolves to false when the update fails, but the code throws ConflictException instead and never returns false." -->
     public async Task<bool> UpdateConfiguration(ObjectId unitIdParsed, UnitConfiguration unitConfiguration)
         {
             var oldConfig = await FindById(unitIdParsed) ??
@@ -398,6 +416,7 @@ public class UnitService(
     /// </summary>
     /// <param name="id">The identifier of the unit to find.</param>
     /// <returns>The unit matching the specified identifier, or null if the identifier is null.</returns>
+    /// <!-- aidoc:v1 sig=ee7012d body=14c7c27 -->
     public async Task<Unit?> FindById(ObjectId? id)
         {
             if (id == null)
@@ -411,6 +430,7 @@ public class UnitService(
     /// </summary>
     /// <param name="name">The name of the unit to look up. Can be <see langword="null"/> or empty.</param>
     /// <returns>A <see cref="Task{Unit}"/> containing the matching <see cref="Unit"/>, or <see langword="null"/> if no name was provided.</returns>
+    /// <!-- aidoc:v1 sig=09cbbd2 body=8b96d0b -->
     public async Task<Unit?> FindByName(string? name)
         {
             if (string.IsNullOrEmpty(name))
@@ -426,6 +446,7 @@ public class UnitService(
     /// <param name="name">The name of the unit to search for. Takes precedence over <paramref name="pocName"/> when provided.</param>
     /// <param name="pocName">The point of care bed identifier used as a fallback to locate the unit when <paramref name="name"/> is not supplied.</param>
     /// <returns>A task containing the matching <see cref="Unit"/>, or <c>null</c> if no unit can be resolved from the given inputs.</returns>
+    /// <!-- aidoc:v1 sig=cfafc13 body=67e6827 -->
     public async Task<Unit?> FindByUnitNameOrPocName(string? name, string? pocName)
         {
             if (!string.IsNullOrEmpty(name))
@@ -451,6 +472,7 @@ public class UnitService(
     /// <param name="unit">The unit entity to be inserted.</param>
     /// <returns>The newly created unit returned by the repository.</returns>
     /// <exception cref="ConflictException">Thrown when the repository returns null, indicating that the unit could not be created.</exception>
+    /// <!-- aidoc:v1 sig=a8b3336 body=f2e2479 -->
     public async Task<Unit?> InsertOne(Unit unit)
         {
             var newUnit = await unitRepository.InsertOneUnit(unit) ??
@@ -465,6 +487,7 @@ public class UnitService(
     /// <param name="unit">The unit containing the updated information, including the identifier of the existing unit to modify.</param>
     /// <returns>The updated <see cref="Unit"/> if the operation succeeded; <c>null</c> if the repository could not persist the update.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit exists with the specified identifier.</exception>
+    /// <!-- aidoc:v1 sig=2e95c1d body=7f75d2a -->
     public async Task<Unit?> UpdateUnit(Unit unit)
         {
             var oldUnit = await FindById(unit.Id) ??
@@ -488,6 +511,8 @@ public class UnitService(
     /// <returns>The updated unit when the operation succeeds; otherwise, null.</returns>
     /// <exception cref="NotFoundException">Thrown when no unit is found for the provided identifier.</exception>
     /// <exception cref="ConflictException">Thrown when the underlying unit update operation fails.</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "Returns doc says 'otherwise, null' but the method throws NotFoundException/ConflictException on failure rather than ever returning null; the nullable return type is documented but no path actually produces null." -->
     public async Task<Unit?> UpdateUnitInfo(ObjectId unitId, string name, string title, string? configObsId = null)
         {
             var oldUnit = await FindById(unitId) ??
@@ -507,6 +532,7 @@ public class UnitService(
     /// <param name="unit">The unit entity to delete, identified by its <c>Id</c>.</param>
     /// <returns>A task that resolves to <c>true</c> when the unit is successfully deleted.</returns>
     /// <exception cref="ConflictException">Thrown when the delete operation fails (returns <c>null</c>).</exception>
+    /// <!-- aidoc:v1 sig=226184c body=dcf53cd -->
     public async Task<bool> DeleteUnitById(Unit unit)
         {
             //if (unit is not { Status: null }) throw new ConflictException(ErrorMessage.Conflict_ResourceInUse);
@@ -521,6 +547,7 @@ public class UnitService(
     /// </summary>
     /// <param name="id">The identifier used to locate the unit. It can be an ObjectId, a title, or a name.</param>
     /// <returns>The matching <see cref="Unit"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=fbd7a84 body=0390751 -->
     public async Task<Unit?> Get(string id)
         {
             Unit? section = null;
@@ -541,6 +568,7 @@ public class UnitService(
     /// </summary>
     /// <param name="location">The <see cref="PatientLocation"/> providing the <c>Bed</c> and <c>UnitName</c> values used to filter the results.</param>
     /// <returns>A task containing a list of <see cref="Unit"/> entries whose point of care matches the given location, or <c>null</c> if an error occurs while retrieving the data.</returns>
+    /// <!-- aidoc:v1 sig=1ca25fc body=0bf54cf -->
     public async Task<List<Unit>?> FindByLocation(PatientLocation location)
         {
             try
@@ -564,6 +592,7 @@ public class UnitService(
     /// </summary>
     /// <param name="unit">The unit whose operation is being broadcast.</param>
     /// <param name="operation">The type of operation performed on the unit, sent as part of the broadcast message.</param>
+    /// <!-- aidoc:v1 sig=719c6f2 body=28f4ccb -->
     private async void SendUnitBroadcast(Unit unit, OperationType operation)
         {
             try
diff --git a/adas-core.Application/Subscriptions/SubscriberGroupedService.cs b/adas-core.Application/Subscriptions/SubscriberGroupedService.cs
index 866b0737..6f5a0dac 100644
--- a/adas-core.Application/Subscriptions/SubscriberGroupedService.cs
+++ b/adas-core.Application/Subscriptions/SubscriberGroupedService.cs
@@ -14,6 +14,7 @@ namespace adas_core.Application.Subscriptions;
 /// <remarks>
 /// This service depends on an optional cache, a grouped observation service, a logger, and a lazily-initialized client message service to support its subscriber-related operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=01f4003 -->
 public class SubscriberGroupedService(
     ICacheService? cacheService,
     IGroupedObservationService groupedObservationService,
@@ -48,6 +49,7 @@ public class SubscriberGroupedService(
     /// Returns a thread-safe snapshot of the grouped subscribers as a new list. The internal collection is locked during the copy to ensure consistency and prevent concurrent modification.
     /// </summary>
     /// <returns>A new <see cref="List{WsSubscriberGrouped}"/> containing a copy of the grouped subscribers.</returns>
+    /// <!-- aidoc:v1 sig=6e3438d body=29d89cc -->
     public List<WsSubscriberGrouped> GetGrouped()
     {
         lock (_subscriberGrouped)
@@ -60,6 +62,7 @@ public class SubscriberGroupedService(
     /// Removes all grouped observations associated with the specified patient identifier from the subscriber collection in a thread-safe manner.
     /// </summary>
     /// <param name="patientId">The string representation of the patient identifier used to locate and remove the matching grouped observations.</param>
+    /// <!-- aidoc:v1 sig=60f9191 body=6bbfa2e -->
     public void RemoveGroupedObsByPatientId(string patientId)
     {
         lock (_subscriberGrouped)
@@ -76,6 +79,10 @@ public class SubscriberGroupedService(
     /// </summary>
     /// <param name="patientId">objectId on db for Patient</param>
     /// <param name="newLocation"></param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary describes conditional removal logic distinguishing section vs box subscribers, but the code removes ALL wsSubscribers for the given patientId without any section/box differentiation." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Summary mentions BoxSubscribers and SectionSubscribers with conditional behavior that does not exist in the code; CheckEmptySubscriberGroup is called but no selective filtering is performed." -->
     public void RemoveWsSubscriberByLocation(string patientId, PatientLocation? newLocation)
     {
         lock (_subscriberGrouped)
@@ -100,6 +107,7 @@ public class SubscriberGroupedService(
     /// </summary>
     /// <param name="patientId">The patient identifier used to locate the subscriber groups to update.</param>
     /// <param name="wsIdToRemove">The WebSocket subscriber ID to remove from the matching subscriber and group collections.</param>
+    /// <!-- aidoc:v1 sig=66711e2 body=1eb38c9 -->
     public void RemoveWsSubscriberPatientIdAndWsId(string patientId, string wsIdToRemove)
     {
         lock (_subscriberGrouped)
@@ -139,6 +147,8 @@ public class SubscriberGroupedService(
     ///     Object with properties to generate new grouped observations, clients using those
     ///     grouped obsercations and the generated list of grouped observations
     /// </param>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "Method returns a List<string> describing what was removed (e.g. 'ws:{PatientId}-{Names}-{Regularity}-{Group.Count}' when the whole object is removed, or 'group:{key}' per removed group), but no <returns> tag exists." -->
     public List<string> CheckEmptySubscriberGroup(WsSubscriberGrouped? wsSubscriberGrouped)
     {
         lock (_subscriberGrouped)
@@ -179,6 +189,7 @@ public class SubscriberGroupedService(
     /// Uses locking to ensure that concurrent calls do not corrupt the subscriber list.
     /// </summary>
     /// <param name="wsSubscriberGrouped">The grouped WebSocket subscriber instance to be added to the collection.</param>
+    /// <!-- aidoc:v1 sig=38538c1 body=b4c236b -->
     public void AddSubscriberGrouped(WsSubscriberGrouped wsSubscriberGrouped)
     {
         lock (_subscriberGrouped)
@@ -195,6 +206,7 @@ public class SubscriberGroupedService(
     /// <param name="timeZoneId">The optional time zone identifier applied to the new subscription when one is created.</param>
     /// <param name="connectionId">The unique identifier of the client connection being registered.</param>
     /// <param name="lastObsInGroup">The most recent observation in the group, used to initialize a new subscription.</param>
+    /// <!-- aidoc:v1 sig=fbd3149 body=ea8c43a -->
     public void CheckOnSubscriptionGroup(GroupedField groupedField, ObjectId patientId, string? timeZoneId,
             string connectionId, GroupedObservation lastObsInGroup)
     {
@@ -235,6 +247,7 @@ public class SubscriberGroupedService(
     /// </summary>
     /// <param name="wsgHashCode">The hash code used to identify the target subscriber group whose last grouped observation should be updated.</param>
     /// <param name="newGroupedObservation">The new <see cref="GroupedObservation"/> to set as the last grouped observation in the matched group.</param>
+    /// <!-- aidoc:v1 sig=da02c06 body=39de597 -->
     public void UpdateLastGroupedObsInGroup(string wsgHashCode, GroupedObservation newGroupedObservation)
     {
         lock (_subscriberGrouped)
@@ -247,6 +260,7 @@ public class SubscriberGroupedService(
     /// Creates the next empty grouped observation for the supplied WebSocket subscriber group and distributes it asynchronously to every subscriber in the group, applying the subscriber-specific group value resolved from the group mapping.
     /// </summary>
     /// <param name="ws">The grouped WebSocket subscriber context whose next empty observation is generated and whose subscribers will receive the notification.</param>
+    /// <!-- aidoc:v1 sig=cabbfc3 body=1ebe417 -->
     private async Task AddEmptyObs(WsSubscriberGrouped ws)
     {
         var gobs = await groupedObservationService.CreateNextEmptyObs(ws);
diff --git a/adas-core.Application/Subscriptions/WsSubscriberGrouped.cs b/adas-core.Application/Subscriptions/WsSubscriberGrouped.cs
index 48e4ca67..95763f6c 100644
--- a/adas-core.Application/Subscriptions/WsSubscriberGrouped.cs
+++ b/adas-core.Application/Subscriptions/WsSubscriberGrouped.cs
@@ -16,6 +16,7 @@ namespace adas_core.Application.Subscriptions;
 /// <summary>
 /// Represents a grouped WebSocket subscriber that aggregates and manages multiple related subscription registrations.
 /// </summary>
+/// <!-- aidoc:v1 sig=fe6f386 -->
 public class WsSubscriberGrouped
 {
     private readonly EventHandler<string> _sendEvent;
@@ -30,6 +31,8 @@ public class WsSubscriberGrouped
     /// <param name="lastGroupedObservationObs">The most recent <see cref="GroupedObservation"/> passed to <see cref="UpdateLastGo"/> to initialize the last-observation state.</param>
     /// <param name="sendEvent">The <see cref="EventHandler{String}"/> invoked by the timer to forward outgoing messages to the subscriber.</param>
     /// <!-- aidoc:v1 sig=16f9dfc body=cc103b1 -->
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary states the constructor 'starts the internal Timer', but Timer.Start() is only invoked when Regularity is not GroupedObservationEnum.Regularity.Times; in the 'Times' regularity case the timer is configured but not started." -->
     public WsSubscriberGrouped(ObjectId patientId, string wsId, string? timeZoneId,
         GroupedField gf, GroupedObservation lastGroupedObservationObs, EventHandler<string> sendEvent)
     {
@@ -74,6 +77,7 @@ public class WsSubscriberGrouped
     /// Refreshes the cached last observations by matching each known name against the supplied grouped observation, falling back to the most recent observation when no match is found.
     /// </summary>
     /// <param name="lastGroupedObservationObs">The source grouped observation whose observations are searched to populate the last-observation cache.</param>
+    /// <!-- aidoc:v1 sig=9a3db7f body=189f23b -->
     public void UpdateLastGo(GroupedObservation lastGroupedObservationObs)
         {
             LastGroupedObservationObs.Clear();
@@ -150,6 +154,7 @@ public class WsSubscriberGrouped
     /// <summary>
     /// Restarts the timer by recalculating its interval through <c>SetUpTimerInterval</c> and then starting it.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a307365 body=43d12e3 -->
     private void TimerReestart()
         {
             Timer.Interval = SetUpTimerInterval();
@@ -160,6 +165,7 @@ public class WsSubscriberGrouped
     /// Calculates the timer interval in milliseconds until the next scheduled occurrence based on the configured <see cref="Regularity"/>, supporting Second, Minute, Day, and a default (Hour) case, and adds a per-regularity grace time.
     /// </summary>
     /// <returns>The number of milliseconds to wait until the next interval, including the grace time.</returns>
+    /// <!-- aidoc:v1 sig=e8a752a body=602d58e -->
     private int SetUpTimerInterval()
         {
             var currentDateTime = DateTime.Now;
@@ -230,6 +236,7 @@ public class WsSubscriberGrouped
 /// <summary>
 /// Provides static extension methods to enhance WebSocket subscriber functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=1808a25 -->
 public static class WsSubscriberExtension
 {
     /// <summary>
@@ -239,6 +246,7 @@ public static class WsSubscriberExtension
     /// <param name="r">The <see cref="GroupedField"/> to compare against the source.</param>
     /// <param name="patientId">The patient identifier to match against the source patient identifier.</param>
     /// <returns><c>true</c> if all compared properties are equal; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d3fad4a body=13fa9d8 -->
     public static bool Compare(this WsSubscriberGrouped source, GroupedField r, ObjectId patientId)
         {
             return r.Regularity == source.Regularity &&
@@ -256,6 +264,7 @@ public static class WsSubscriberExtension
     /// <param name="shift">The target shift list to compare.</param>
     /// <param name="sourceShift">The source shift list to compare against.</param>
     /// <returns><c>true</c> if both lists are null or if their sequence of strings is equal; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=71a6e44 body=3a82a4f -->
     private static bool CompareStringShiftList(List<string>? shift, List<string>? sourceShift)
         {
             if (shift != null && sourceShift != null) return sourceShift.SequenceEqual(shift);
@@ -271,6 +280,7 @@ public static class WsSubscriberExtension
     /// <param name="name">The fallback candidate list of names to compare against <paramref name="sourceNames"/> when <paramref name="names"/> cannot be used.</param>
     /// <param name="sourceNames">The source list of names being compared.</param>
     /// <returns><c>true</c> if <paramref name="sourceNames"/> is a sequence match for either <paramref name="names"/> or <paramref name="name"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=96b8c77 body=49d77d4 -->
     private static bool CompareNamesStringList(List<string> names, List<string> name, List<string> sourceNames)
         {
             if (!CollectionsUtils.IsEmptyOrNull(names) && sourceNames.SequenceEqual(names)) return true;
@@ -281,6 +291,8 @@ public static class WsSubscriberExtension
     ///     Check if the incoming observation affect to the group and is new info or is irrelevant
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The <returns> tag is present but contains no description; the reader cannot tell what true vs false means without reading the implementation" -->
     public static bool IsNewObservationRelevantForGroup(this WsSubscriberGrouped group, PatientObservation obs)
     {
         double.TryParse(obs.Value.ToString(), out var pobsValue);
diff --git a/adas-core.Application/Subscriptions/WsSuscriber.cs b/adas-core.Application/Subscriptions/WsSuscriber.cs
index efb2e1ca..cfefe9fc 100644
--- a/adas-core.Application/Subscriptions/WsSuscriber.cs
+++ b/adas-core.Application/Subscriptions/WsSuscriber.cs
@@ -9,6 +9,7 @@ namespace adas_core.Application.Subscriptions;
 /// <summary>
 /// Represents a WebSocket subscriber identified by a unique string identifier.
 /// </summary>
+/// <!-- aidoc:v1 sig=e5ef774 -->
 public class WsSubscriber(string id)
 {
     public string? UserName;
diff --git a/adas-core.Authentication/Attributes/AuthorizeRolesAttribute.cs b/adas-core.Authentication/Attributes/AuthorizeRolesAttribute.cs
index d913fbd7..c9234905 100644
--- a/adas-core.Authentication/Attributes/AuthorizeRolesAttribute.cs
+++ b/adas-core.Authentication/Attributes/AuthorizeRolesAttribute.cs
@@ -13,6 +13,8 @@ namespace adas_core.Authentication.Attributes;
 /// Constrained by <see cref="System.AttributeUsageAttribute"/> to <see cref="AttributeTargets.Method"/>, the attribute is configured at construction with the required <paramref name="type"/>.
 /// </remarks>
 /// <!-- aidoc:v1 sig=b5093e9 -->
+/// <!-- aidoc-review:v1 severity=medium kind=missing_param
+///      "The primary constructor parameter 'type' is referenced via <paramref> in remarks but lacks a formal <param> tag describing its purpose." -->
 [AttributeUsage(AttributeTargets.Method)]
 public class AuthorizeRolesAttribute(PermissionEnum.RolesType type) : Attribute, IAuthorizationFilter
 {
@@ -22,6 +24,7 @@ public class AuthorizeRolesAttribute(PermissionEnum.RolesType type) : Attribute,
     /// and otherwise responds with a forbid result when no user role starts with the permission type value.
     /// </summary>
     /// <param name="context">The authorization filter context providing access to the HTTP context and where the authorization result is assigned.</param>
+    /// <!-- aidoc:v1 sig=6368c5d body=ab6a306 -->
     public void OnAuthorization(AuthorizationFilterContext context)
         {
             var user = context.HttpContext.User;
diff --git a/adas-core.Authentication/Attributes/AuthorizeUserByService.cs b/adas-core.Authentication/Attributes/AuthorizeUserByService.cs
index 04664b46..2d326bb5 100644
--- a/adas-core.Authentication/Attributes/AuthorizeUserByService.cs
+++ b/adas-core.Authentication/Attributes/AuthorizeUserByService.cs
@@ -19,6 +19,7 @@ public class AuthorizePermissionsAttribute(
     /// Handles authorization by validating the presence of the <c>Displayid</c> request header and ensuring the authenticated user exists in the user service. If the header is missing or the user cannot be found, the request is short-circuited with a <see cref="NotFoundObjectResult"/>.
     /// </summary>
     /// <param name="context">The <see cref="AuthorizationFilterContext"/> for the current request, providing access to the HTTP context, user identity, and the ability to set the action result.</param>
+    /// <!-- aidoc:v1 sig=6368c5d body=527e8e0 -->
     public void OnAuthorization(AuthorizationFilterContext context)
         {
             var user = context.HttpContext.User;
diff --git a/adas-core.Authentication/Attributes/PermissionAuthorizeAttribute.cs b/adas-core.Authentication/Attributes/PermissionAuthorizeAttribute.cs
index 5e29aea2..69051b40 100644
--- a/adas-core.Authentication/Attributes/PermissionAuthorizeAttribute.cs
+++ b/adas-core.Authentication/Attributes/PermissionAuthorizeAttribute.cs
@@ -27,6 +27,7 @@ public class PermissionAuthorizeAttribute(string source, string? resourceIdHeade
     /// </summary>
     /// <param name="context">The <see cref="AuthorizationFilterContext"/> for the current authorization request, providing access to the HTTP context, services, and the result to set when authorization fails.</param>
     /// <exception cref="ForbbidenException">Thrown when the <see cref="IPermissionService"/> cannot be resolved from the request services.</exception>
+    /// <!-- aidoc:v1 sig=2cfde77 body=c01efe9 -->
     public async Task OnAuthorizationAsync(AuthorizationFilterContext context)
         {
             // Obtener el servicio de permisos.
diff --git a/adas-core.Authentication/AuthorityService.cs b/adas-core.Authentication/AuthorityService.cs
index 0c48c208..aba0a20d 100644
--- a/adas-core.Authentication/AuthorityService.cs
+++ b/adas-core.Authentication/AuthorityService.cs
@@ -25,6 +25,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="roleName">The name of the role to associate with the authority.</param>
     /// <param name="userId">The unique identifier of the user for whom the authority is being created.</param>
+    /// <!-- aidoc:v1 sig=e8925cb body=6481017 -->
     public void CreateNew(string roleName, ObjectId userId)
         {
             authorityRepository.CreateNewAuthority(roleName, userId);
@@ -34,6 +35,7 @@ public class AuthorityService(
     /// Inserts a new <paramref name="authorization"/> into the authority repository and records an audit log entry for the operation using the current HTTP context user.
     /// </summary>
     /// <param name="authorization">The authorization entity to be inserted and tracked in the audit log.</param>
+    /// <!-- aidoc:v1 sig=ae025de body=a51a17b -->
     public async Task InsertOne(Authorization authorization)
         {
             await authorityRepository.InsertOneAsync(authorization);
@@ -44,6 +46,7 @@ public class AuthorityService(
     /// Updates an existing authorization record in the repository and records an audit log entry capturing the previous and updated states for the current user.
     /// </summary>
     /// <param name="authorization">The authorization entity containing the identifier of the record to update and its new values.</param>
+    /// <!-- aidoc:v1 sig=0061b8f body=ec8308f -->
     public async Task updateOne(Authorization authorization)
         {
             var oldAuth = await authorityRepository.GetById(authorization.Id);
@@ -56,6 +59,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="userId"></param>
     /// <returns>A list of the user's authorities.</returns>
+    /// <!-- aidoc:v1 sig=f9a2a8a body=7e449b3 -->
     public Task<List<Authorization>> GetUserAuthorities(ObjectId userId)
     {
         return authorityRepository.GetUserAuthorities(userId);
@@ -65,6 +69,7 @@ public class AuthorityService(
     /// Retrieves all available authorities from the underlying repository.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Authorization"/> records.</returns>
+    /// <!-- aidoc:v1 sig=db31dc4 body=3106354 -->
     public Task<List<Authorization>> GetAllAuthorities()
         {
             return authorityRepository.GetAllAuthorities();
@@ -75,6 +80,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="id">The unique identifier of the user whose authorities should be deleted.</param>
     /// <returns><c>true</c> if the authorities were successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=abc4727 body=4c48116 -->
     public async Task<bool> DeleteAuthoritiesForUser(ObjectId id)
         {
             try
@@ -99,6 +105,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="authorization">The authorization entity to be created and stored.</param>
     /// <returns>The created <see cref="Authorization"/> entity.</returns>
+    /// <!-- aidoc:v1 sig=dd7f92d body=801be1a -->
     public async Task<Authorization?> CreateNewUserAuthority(Authorization authorization)
         {
             await authorityRepository.InsertOneAsync(authorization);
@@ -112,6 +119,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="userAuthorityIdParsed">The parsed identifier of the user authority to delete.</param>
     /// <returns><c>true</c> if the user authority was successfully deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=73f08c6 body=0b2f9a8 -->
     public async Task<bool> DeleteUserAuthority(ObjectId userAuthorityIdParsed)
         {
             try
@@ -135,6 +143,7 @@ public class AuthorityService(
     /// </summary>
     /// <param name="authorization">The authorization entity containing the updated information to persist.</param>
     /// <returns>The updated <see cref="Authorization"/> on success, or <c>null</c> if an error occurs during the operation.</returns>
+    /// <!-- aidoc:v1 sig=21fd169 body=9a8dcf9 -->
     public async Task<Authorization?> EditUserAuthority(Authorization authorization)
         {
             try
diff --git a/adas-core.Authentication/Interfaces/IAuthorityService.cs b/adas-core.Authentication/Interfaces/IAuthorityService.cs
index e13afada..86d2617b 100644
--- a/adas-core.Authentication/Interfaces/IAuthorityService.cs
+++ b/adas-core.Authentication/Interfaces/IAuthorityService.cs
@@ -10,29 +10,34 @@ public interface IAuthorityService
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose authorizations are being requested.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects for the user.</returns>
+    /// <!-- aidoc:v1 sig=1476a1a -->
     public Task<List<Authorization>> GetUserAuthorities(ObjectId userId);
     /// <summary>
     /// Creates a new role with the specified name and associates it with the given user.
     /// </summary>
     /// <param name="roleName">The name of the role to create.</param>
     /// <param name="userId">The identifier of the user to associate with the new role.</param>
+    /// <!-- aidoc:v1 sig=ea6d5b6 -->
     public void CreateNew(string roleName, ObjectId userId);
     /// <summary>
     /// Inserts a new authorization record into the data store.
     /// </summary>
     /// <param name="authorization">The authorization entity to insert.</param>
     /// <returns>A task that represents the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=bf14da0 -->
     public Task InsertOne(Authorization authorization);
     /// <summary>
     /// Updates a single authorization record.
     /// </summary>
     /// <param name="authorization">The authorization object containing the data to be updated.</param>
+    /// <!-- aidoc:v1 sig=2e9fb22 -->
     public Task updateOne(Authorization authorization);
 
     /// <summary>
     /// Asynchronously retrieves all authorizations.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all authorization objects.</returns>
+    /// <!-- aidoc:v1 sig=dd351e0 -->
     public Task<List<Authorization>> GetAllAuthorities();
 
     /// <summary>
@@ -40,23 +45,27 @@ public interface IAuthorityService
     /// </summary>
     /// <param name="id">The unique identifier of the user whose authorities should be removed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains <c>true</c> if authorities were deleted; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=851a476 -->
     Task<bool> DeleteAuthoritiesForUser(ObjectId id);
     /// <summary>
     /// Creates a new user authority based on the provided <paramref name="authorization"/>.
     /// </summary>
     /// <param name="authorization">The authorization data used to create the new user authority.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Authorization"/>, or <c>null</c> if the authority could not be created.</returns>
+    /// <!-- aidoc:v1 sig=adb1353 -->
     Task<Authorization?> CreateNewUserAuthority(Authorization authorization);
     /// <summary>
     /// Asynchronously deletes a user authority identified by the provided parsed identifier.
     /// </summary>
     /// <param name="userAuthorityIdParsed">The parsed identifier of the user authority to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result is <see langword="true"/> if the user authority was successfully deleted; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=d8ae827 -->
     Task<bool> DeleteUserAuthority(ObjectId userAuthorityIdParsed);
     /// <summary>
     /// Edits the user authority using the provided authorization data.
     /// </summary>
     /// <param name="authorization">The authorization object containing the user authority details to be updated.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the updated <see cref="Authorization"/>, or <c>null</c> if the authorization was not found.</returns>
+    /// <!-- aidoc:v1 sig=857d49a -->
     Task<Authorization?> EditUserAuthority(Authorization authorization);
 }
\ No newline at end of file
diff --git a/adas-core.Authentication/Interfaces/ILoginService.cs b/adas-core.Authentication/Interfaces/ILoginService.cs
index 309f00e2..a37f57bb 100644
--- a/adas-core.Authentication/Interfaces/ILoginService.cs
+++ b/adas-core.Authentication/Interfaces/ILoginService.cs
@@ -15,12 +15,14 @@ public interface ILoginService
     /// <param name="username">The username of the user attempting to log in.</param>
     /// <param name="password">The password associated with the username.</param>
     /// <returns>A <see cref="Task{User}"/> representing the asynchronous operation, containing the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=a4700d5 -->
     Task<User> Login(string username, string password);
     /// <summary>
     /// Authenticates a user based on the provided HTTP context.
     /// </summary>
     /// <param name="context">The HTTP context containing the request information used to perform the login.</param>
     /// <returns>A task that represents the asynchronous login operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=ff09cb3 -->
     Task<User> Login(HttpContext context);
 
     /// <summary>
@@ -29,29 +31,34 @@ public interface ILoginService
     /// <param name="username">The username of the user to authenticate.</param>
     /// <param name="password">The password of the user to authenticate.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=a232f05 -->
     Task<User> Authenticate(string username, string password);
     /// <summary>
     /// Retrieves a user by their unique identifier, returning null if no matching user is found.
     /// </summary>
     /// <param name="id">The unique identifier of the user to look up.</param>
     /// <returns>The user with the specified identifier, or null if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=ab4b64e -->
     Task<User?> GetById(ObjectId id);
     /// <summary>
     /// Retrieves a user from the data store by their email address, or returns null if no matching user is found.
     /// </summary>
     /// <param name="email">The email address used to look up the user.</param>
     /// <returns>A task that resolves to the <see cref="User"/> matching the provided email, or null if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=aad49e4 -->
     Task<User?> GetByEmail(string email);
     /// <summary>
     /// Retrieves a user by their username asynchronously, returning <c>null</c> if no matching user is found.
     /// </summary>
     /// <param name="username">The username to look up.</param>
     /// <returns>A <see cref="Task{User}"/> that resolves to the matching <see cref="User"/>, or <c>null</c> if no user exists with the specified username.</returns>
+    /// <!-- aidoc:v1 sig=d91b767 -->
     Task<User?> GetByUsername(string username);
 
     /// <summary>
     /// Asynchronously retrieves a list of all users in the system.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="User"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=850c090 -->
     Task<List<User>> GetAllUsers();
 }
\ No newline at end of file
diff --git a/adas-core.Authentication/Interfaces/ITokenService.cs b/adas-core.Authentication/Interfaces/ITokenService.cs
index 67b6ee32..f2ae8c97 100644
--- a/adas-core.Authentication/Interfaces/ITokenService.cs
+++ b/adas-core.Authentication/Interfaces/ITokenService.cs
@@ -13,12 +13,14 @@ public interface ITokenService
     /// <param name="username">The username used to look up the security token.</param>
     /// <param name="claims">The list of claims associated with the token.</param>
     /// <returns>A <see cref="SecurityToken"/> if a matching token is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=78fe633 -->
     SecurityToken? GetToken(string username, List<Claim> claims);
 
     /// <summary>
     /// Retrieves the current refresh token used to obtain new access tokens for authentication.
     /// </summary>
     /// <returns>The refresh token as a string.</returns>
+    /// <!-- aidoc:v1 sig=575d89a -->
     string GetRefreshToken();
 
     /// <summary>
@@ -26,5 +28,6 @@ public interface ITokenService
     /// </summary>
     /// <param name="token">The security token to serialize.</param>
     /// <returns>A string containing the serialized form of the security token.</returns>
+    /// <!-- aidoc:v1 sig=0e94bd2 -->
     string Serialize(SecurityToken token);
 }
\ No newline at end of file
diff --git a/adas-core.Authentication/Interfaces/IUserService.cs b/adas-core.Authentication/Interfaces/IUserService.cs
index cdf547ba..0c991077 100644
--- a/adas-core.Authentication/Interfaces/IUserService.cs
+++ b/adas-core.Authentication/Interfaces/IUserService.cs
@@ -20,6 +20,7 @@ public interface IUserService
     /// <param name="username">The username of the user attempting to log in.</param>
     /// <param name="password">The password associated with the specified username.</param>
     /// <returns>A task that represents the asynchronous login operation, containing the <see cref="TokenResult"/> with the authentication token information.</returns>
+    /// <!-- aidoc:v1 sig=d557171 -->
     Task<TokenResult> Login(string username, string password);
     /// <summary>
     /// Authenticates a user based on the provided username and password and returns the corresponding user.
@@ -27,12 +28,14 @@ public interface IUserService
     /// <param name="username">The username of the user to authenticate.</param>
     /// <param name="password">The password of the user to authenticate.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the authenticated <see cref="User"/>.</returns>
+    /// <!-- aidoc:v1 sig=b9ab570 -->
     Task<User> GetUser(string username, string password);
     /// <summary>
     /// Refreshes an authentication token using the provided refresh token and returns the resulting token information.
     /// </summary>
     /// <param name="refreshToken">The refresh token used to obtain a new access token.</param>
     /// <returns>A <see cref="Task{TResult}"/> that represents the asynchronous operation, containing the <see cref="TokenResult"/> with the refreshed token details.</returns>
+    /// <!-- aidoc:v1 sig=c0187cf -->
     Task<TokenResult> RefreshToken(string refreshToken);
 
     /// <summary>
@@ -40,6 +43,7 @@ public interface IUserService
     /// </summary>
     /// <param name="token">The access token used to authenticate the user.</param>
     /// <returns>A task that represents the asynchronous login operation, containing the <see cref="TokenResult"/> with the outcome of the authentication.</returns>
+    /// <!-- aidoc:v1 sig=b806672 -->
     Task<TokenResult> LoginWithAccessToken(string token);
     /// <summary>
     /// Validates the specified token according to its type and outputs the corresponding <see cref="SecurityToken"/>.
@@ -47,6 +51,7 @@ public interface IUserService
     /// <param name="token">The token string to be validated.</param>
     /// <param name="tokenType">The type of the token, used to determine the appropriate validation strategy.</param>
     /// <param name="securityToken">When the method returns, contains the validated <see cref="SecurityToken"/> if validation succeeds.</param>
+    /// <!-- aidoc:v1 sig=994e231 -->
     void ValidateToken(string token, string tokenType, out SecurityToken securityToken);
     /// <summary>
     /// Retrieves the user associated with the provided JWT security token.
@@ -54,6 +59,7 @@ public interface IUserService
     /// </summary>
     /// <param name="jwtToken">The JWT security token used to identify the user. May be <c>null</c>.</param>
     /// <returns>A task that resolves to the <see cref="User"/> associated with the token, or <c>null</c> if the token is invalid or no user matches.</returns>
+    /// <!-- aidoc:v1 sig=4e2d176 -->
     Task<User?> GetUserByToken(JwtSecurityToken? jwtToken);
     /// <summary>
     /// Asynchronously retrieves a user by validating a CAS (Central Authentication Service) ticket against the specified service.
@@ -61,41 +67,48 @@ public interface IUserService
     /// <param name="service">The service URL or identifier that the ticket was issued for and must be validated against.</param>
     /// <param name="ticket">The CAS ticket string used to authenticate and identify the user.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the associated <see cref="User"/> if the ticket is valid, or <c>null</c> if the user cannot be found.</returns>
+    /// <!-- aidoc:v1 sig=35a0f18 -->
     Task<User?> GetUserByCasTicket(string service, string ticket);
     /// <summary>
     /// Asynchronously generates a JSON Web Token (JWT) for the specified user and returns the token result.
     /// </summary>
     /// <param name="user">The user for whom the JWT is being generated.</param>
     /// <returns>A task that represents the asynchronous operation, containing the <see cref="TokenResult"/> with the generated token details.</returns>
+    /// <!-- aidoc:v1 sig=87e065c -->
     Task<TokenResult> GenerateJwt(User user);
     /// <summary>
     /// Asynchronously retrieves all users from the data store.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all <see cref="User"/> entities.</returns>
+    /// <!-- aidoc:v1 sig=52f36eb -->
     Task<List<User>> GetAll();
     /// <summary>
     /// Asynchronously retrieves a user by their unique identifier, returning <c>null</c> when no user matches the provided id.
     /// </summary>
     /// <param name="id">The unique <see cref="ObjectId"/> identifier of the user to look up.</param>
     /// <returns>A task that resolves to the matching <see cref="User"/>, or <c>null</c> if no user is found for the given id.</returns>
+    /// <!-- aidoc:v1 sig=9fe25b3 -->
     Task<User?> GetUserById(ObjectId id);
     /// <summary>
     /// Asynchronously retrieves a user by their unique username, returning null when no matching user is found.
     /// </summary>
     /// <param name="name">The username used to look up the user.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching user if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=917e8bd -->
     Task<User?> GetUserByUserName(string name);
     /// <summary>
     /// Asynchronously retrieves a user matching the specified name, returning <c>null</c> when no matching user is found.
     /// </summary>
     /// <param name="name">The name used to look up the user.</param>
     /// <returns>A task that resolves to the matching <see cref="User"/>, or <c>null</c> if no user with the given name exists.</returns>
+    /// <!-- aidoc:v1 sig=ea58eab -->
     Task<User?> GetUserByName(string name);
     /// <summary>
     /// Creates a user from the provided LDAP user entry.
     /// </summary>
     /// <param name="userEntryLdap">The LDAP user entry used to create the user.</param>
     /// <returns>A task that represents the asynchronous create operation, containing the created <see cref="User"/> or <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=aefe667 -->
     Task<User?> CreateUser(User userEntryLdap);
     /// <summary>
     /// Creates a new user based on the provided user data, typically originating from an incoming request.
@@ -103,6 +116,7 @@ public interface IUserService
     /// </summary>
     /// <param name="user">The user data to use for creating the new user.</param>
     /// <returns>A task that represents the asynchronous operation. The result is the created <see cref="User"/>, or <see langword="null"/> if creation failed.</returns>
+    /// <!-- aidoc:v1 sig=658bda4 -->
     Task<User?> CreateNewUserByRequest(User user);
 
     /// <summary>
@@ -110,6 +124,7 @@ public interface IUserService
     /// </summary>
     /// <param name="createUserWithAuthDto">The data transfer object containing the information required to create the user and its authorities.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="User"/> instance, or <c>null</c> if no user was created.</returns>
+    /// <!-- aidoc:v1 sig=f76bd48 -->
     Task<User?> CreateNewUserWithAuthorities(CreateUserWithAuthDto createUserWithAuthDto);
     /// <summary>
     /// Updates an existing user along with the associated authorities, optionally updating the password.
@@ -117,6 +132,7 @@ public interface IUserService
     /// <param name="createUserWithAuthDto">The data transfer object containing the user information and authorities to update.</param>
     /// <param name="updatePass">A flag indicating whether the user's password should be updated as part of the operation.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="User"/> or <c>null</c> if the user was not found.</returns>
+    /// <!-- aidoc:v1 sig=a4bc265 -->
     Task<User?> UpdateUserWithAuthorities(UpdateUserWithAuthDto createUserWithAuthDto, bool updatePass);
     /// <summary>
     /// Updates a user's information based on the provided user data, with an option to include password updates.
@@ -124,6 +140,7 @@ public interface IUserService
     /// <param name="user">The user entity containing the updated information to be persisted.</param>
     /// <param name="updatePass">A flag indicating whether the user's password should be updated during this operation.</param>
     /// <returns>A task that returns the updated <see cref="User"/>, or null if the user could not be found.</returns>
+    /// <!-- aidoc:v1 sig=4c6a1ca -->
     Task<User?> UpdateUsersByRequest(User user, bool updatePass);
     /// <summary>
     /// Updates the password for the user identified by the specified identifier, verifying the old password before applying the new one.
@@ -132,41 +149,48 @@ public interface IUserService
     /// <param name="oldPassword">The user's current password, used to verify the request.</param>
     /// <param name="newPassword">The new password to set for the user.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the password was updated successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=38635ef -->
     Task<bool> UpdateUserPassword(ObjectId id, string oldPassword, string newPassword);
     /// <summary>
     /// Asynchronously deletes a user identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the user to delete.</param>
     /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the user was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=8d34422 -->
     Task<bool> DeleteUser(ObjectId id);
     /// <summary>
     /// Retrieves a paginated list of users based on the provided pagination filter configuration.
     /// </summary>
     /// <param name="config">The pagination filter that defines paging parameters such as page number and page size.</param>
     /// <returns>A task that represents the asynchronous operation, containing the paginated response of <see cref="User"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=e324e87 -->
     Task<PaginationResponse<User>> GetPaginatedUsers(PaginationFilter config);
     /// <summary>
     /// Asynchronously creates a new authority based on the provided authorization data.
     /// </summary>
     /// <param name="auth">The authorization information used to create the new authority.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created <see cref="Authorization"/>.</returns>
+    /// <!-- aidoc:v1 sig=d636b5c -->
     Task<Authorization> CreateNewAuthority(Authorization auth);
     /// <summary>
     /// Asynchronously deletes an authority identified by the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the authority to delete.</param>
     /// <returns>A task that represents the asynchronous delete operation. The task result contains a boolean indicating whether the authority was successfully deleted.</returns>
+    /// <!-- aidoc:v1 sig=e85ede9 -->
     Task<bool> DeleteAuthority(string id);
     /// <summary>
     /// Updates the authority information based on the provided authorization data.
     /// </summary>
     /// <param name="authorization">The authorization entity containing the authority details to be updated.</param>
     /// <returns>A task that represents the asynchronous operation. The task result is <c>true</c> if the update was successful; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=0295989 -->
     Task<bool> UpdateAuthority(Authorization authorization);
     /// <summary>
     /// Authenticates the user using the provided access token and returns the resulting token information.
     /// </summary>
     /// <param name="token">The access token used to perform the login.</param>
     /// <returns>A task that represents the asynchronous login operation, containing the token result.</returns>
+    /// <!-- aidoc:v1 sig=485f1d7 -->
     Task<TokenResult> LoginWithGivenAccessToken(string token);
 }
\ No newline at end of file
diff --git a/adas-core.Authentication/Models/LoginInfo.cs b/adas-core.Authentication/Models/LoginInfo.cs
index d69be5be..f1f8c826 100644
--- a/adas-core.Authentication/Models/LoginInfo.cs
+++ b/adas-core.Authentication/Models/LoginInfo.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a container for login-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=3e9909a -->
 public class LoginInfo
 {
     public string Username { get; set; } = null!;
diff --git a/adas-core.Authentication/Models/Token.cs b/adas-core.Authentication/Models/Token.cs
index 7146f107..8b85dcc7 100644
--- a/adas-core.Authentication/Models/Token.cs
+++ b/adas-core.Authentication/Models/Token.cs
@@ -6,6 +6,7 @@ namespace adas_core.Authentication.Models;
 /// <summary>
 /// Represents the result of a token-related operation, encapsulating the outcome and any associated token data.
 /// </summary>
+/// <!-- aidoc:v1 sig=3a6d234 -->
 public class TokenResult
 {
     public string AccessToken { get; set; } = null!;
@@ -18,6 +19,7 @@ public class TokenResult
 /// <summary>
 /// Represents a panel UI component responsible for displaying token-related results.
 /// </summary>
+/// <!-- aidoc:v1 sig=2bd900f -->
 public class TokenResultPanel
 {
     public TokenResult TokenResult { get; set; } = null!;
diff --git a/adas-core.Authentication/Models/UciResponse.cs b/adas-core.Authentication/Models/UciResponse.cs
index ad41595b..40b111d3 100644
--- a/adas-core.Authentication/Models/UciResponse.cs
+++ b/adas-core.Authentication/Models/UciResponse.cs
@@ -4,6 +4,7 @@
 /// Represents a generic response in the Universal Chess Interface (UCI) protocol, encapsulating a payload of type <typeparamref name="T"/>.
 /// </summary>
 /// <typeparam name="T">The type of the response payload.</typeparam>
+/// <!-- aidoc:v1 sig=edd025b -->
 public class UciResponse<T>
 {
     /// <summary>
@@ -40,6 +41,7 @@ public class UciResponse<T>
     /// </summary>
     /// <param name="entity">The entity to include in the response payload.</param>
     /// <returns>A <see cref="UciResponse{T}"/> containing the provided entity.</returns>
+    /// <!-- aidoc:v1 sig=193e85b body=f1d7691 -->
     public static UciResponse<T> FromSuccess(T entity)
         {
             return new UciResponse<T>(entity);
@@ -51,6 +53,7 @@ public class UciResponse<T>
     /// </summary>
     /// <param name="ex">The exception whose type name and message are used to populate the error response.</param>
     /// <returns>A <see cref="UciResponse{T}"/> containing the cleaned exception type name and the exception message as the error details.</returns>
+    /// <!-- aidoc:v1 sig=f4afb5b body=80d56b7 -->
     public static UciResponse<T> FromError(Exception ex)
         {
             var error = ex.GetType().Name;
@@ -65,6 +68,7 @@ public class UciResponse<T>
     /// <param name="error">The error code or identifier describing the failure.</param>
     /// <param name="message">An optional human-readable message providing additional context about the error.</param>
     /// <returns>A <see cref="UciResponse{T}"/> with <c>Success</c> set to <c>false</c>, the specified <paramref name="error"/>, and the optional <paramref name="message"/>.</returns>
+    /// <!-- aidoc:v1 sig=43834ba body=b488e43 -->
     public static UciResponse<T> FromError(string error, string? message = null)
         {
             return new UciResponse<T>
diff --git a/adas-core.Authentication/RegistrationExtensions/AuthRegistration.cs b/adas-core.Authentication/RegistrationExtensions/AuthRegistration.cs
index 3e7d79e6..b9cf84d3 100644
--- a/adas-core.Authentication/RegistrationExtensions/AuthRegistration.cs
+++ b/adas-core.Authentication/RegistrationExtensions/AuthRegistration.cs
@@ -9,12 +9,14 @@ namespace adas_core.Authentication.RegistrationExtensions;
 /// <remarks>
 /// This static class serves as a container for registration-related authentication operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=adfaf21 -->
 public static class AuthRegistration
 {
     /// <summary>
     /// Registers authentication-related services in the dependency injection container, including a singleton <see cref="IUserService"/> and a lazy wrapper for deferred resolution.
     /// </summary>
     /// <param name="serviceCollection">The service collection to which the authentication services are added.</param>
+    /// <!-- aidoc:v1 sig=01f4b10 body=0bc4709 -->
     public static void AddAuth(this IServiceCollection serviceCollection)
         {
             serviceCollection.AddSingleton<IUserService, UserService>();
diff --git a/adas-core.Authentication/UserService.cs b/adas-core.Authentication/UserService.cs
index 64ae17ae..9f91c7da 100644
--- a/adas-core.Authentication/UserService.cs
+++ b/adas-core.Authentication/UserService.cs
@@ -31,6 +31,7 @@ namespace adas_core.Authentication;
 /// <remarks>
 /// This class is the default service component responsible for handling user domain logic and delegating persistence or infrastructure concerns as required by the interface.
 /// </remarks>
+/// <!-- aidoc:v1 sig=ea2e8b0 -->
 public class UserService : IUserService
 {
     private readonly ILocalAuditService _auditService;
@@ -109,6 +110,7 @@ public class UserService : IUserService
     /// <returns>A <see cref="Task{TResult}"/> containing the generated <see cref="TokenResult"/> for the authenticated user.</returns>
     /// <exception cref="UnauthorizedException">Thrown when no user matches the provided credentials, or when the user is not in the whitelist or valid groups.</exception>
     /// <exception cref="ForbbidenException">Thrown when the user account is disabled or currently locked.</exception>
+    /// <!-- aidoc:v1 sig=1e8af8c body=0dd331a -->
     public async Task<TokenResult> Login(string username, string password)
         {
             var user = await GetUser(username, password);
@@ -134,6 +136,7 @@ public class UserService : IUserService
     /// <param name="tokenType">The type of the token being validated.</param>
     /// <param name="validatedToken">When the method returns, contains the validated <see cref="SecurityToken"/> if validation succeeds.</param>
     /// <exception cref="TokenException">Thrown when the token is invalid, is not signed with the HmacSha256 algorithm, or any other validation error occurs.</exception>
+    /// <!-- aidoc:v1 sig=cd90202 body=4ddd4b1 -->
     public void ValidateToken(string token, string tokenType, out SecurityToken validatedToken)
         {
             try
@@ -176,6 +179,8 @@ public class UserService : IUserService
     /// <param name="jwtToken">The <see cref="JwtSecurityToken"/> containing the user identity claims, or <see langword="null"/> to indicate no token was supplied.</param>
     /// <returns>A <see cref="Task{User}"/> that resolves to the matching <see cref="User"/> with its password cleared and authorization loaded if required, or <see langword="null"/> when the token is missing or no user matches the extracted username.</returns>
     /// <!-- aidoc:v1 sig=29f6fec body=a7970c3 -->
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The <see cref=\"Task{User}\"/> reference indicates a non-nullable Task<User>, but the method actually returns Task<User?> with a nullable User." -->
     public async Task<User?> GetUserByToken(JwtSecurityToken? jwtToken)
     {
         User? user = null;
@@ -204,6 +209,8 @@ public class UserService : IUserService
     /// <exception cref="LoginServicesException">Thrown when the CAS login method is not available, or when an unexpected error occurs during authentication.</exception>
     /// <exception cref="UnauthorizedAccessException">Thrown when the authenticated user is not in the users whitelist and does not belong to any valid group.</exception>
     /// <exception cref="BusinessException">Rethrown when a business-level error occurs during the login process.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary states the method 'authenticates a user using a CAS ticket', but the ticket parameter is never used in the active code path - authentication is performed via service.Login(_httpContextAccessor.HttpContext). The <returns> clause also references ticket validity ('if the ticket is valid'), which is not checked." -->
     public async Task<User?> GetUserByCasTicket(string serviceUrl, string ticket)
         {
             var service = _availableLoginServices.FirstOrDefault(s => s.Method == UserEnum.LoginMethod.Cas);
@@ -250,6 +257,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="refreshToken">The refresh token used to generate a new JWT.</param>
     /// <returns>A TokenResult containing the new JWT, or an empty result if the user associated with the token is not found.</returns>
+    /// <!-- aidoc:v1 sig=1902a2f body=bb5bba0 -->
     public async Task<TokenResult> RefreshToken(string refreshToken)
         {
             ValidateToken(refreshToken, IUserService.TokenTypeRefresh, out var validatedToken);
@@ -269,6 +277,7 @@ public class UserService : IUserService
     /// <param name="password">The password to authenticate against.</param>
     /// <returns>The authenticated <see cref="User"/> returned by the first successful login service.</returns>
     /// <exception cref="LoginServicesNotFoundException">Thrown when no configured login service successfully authenticates the user.</exception>
+    /// <!-- aidoc:v1 sig=b90d52e body=0ab820c -->
     public async Task<User> GetUser(string username, string password)
         {
             //BusinessException? loginException = null;
@@ -297,6 +306,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="id">The unique identifier of the user to retrieve.</param>
     /// <returns>A <see cref="Task{User}"/> containing the user with its authorization populated, or <c>null</c> if the user cannot be found or an exception is thrown during retrieval.</returns>
+    /// <!-- aidoc:v1 sig=6af9d13 body=5ffaaf2 -->
     public async Task<User?> GetUserById(ObjectId id)
         {
             try
@@ -316,6 +326,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="name">The username to look up.</param>
     /// <returns>The matching <see cref="User"/> with its <c>Authorization</c> property populated from the authority service, or <c>null</c> if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=f6a5557 body=812fa43 -->
     public async Task<User?> GetUserByUserName(string name)
         {
             var u = await _userRepository.GetByUserName(name);
@@ -330,6 +341,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="name">The name of the user to look up.</param>
     /// <returns>A <see cref="User"/> instance with its <c>Authorization</c> populated when found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=5fce94d body=3ae1c25 -->
     public async Task<User?> GetUserByName(string name)
         {
             try
@@ -349,6 +361,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="userEntryLdap">The user information sourced from LDAP to be created in the system.</param>
     /// <returns>The created user retrieved by username, or null if the user cannot be found after insertion.</returns>
+    /// <!-- aidoc:v1 sig=191573e body=81f390b -->
     public async Task<User?> CreateUser(User userEntryLdap)
         {
             CheckIfUserNameExists(userEntryLdap.UserName);
@@ -366,6 +379,7 @@ public class UserService : IUserService
     /// <returns>The created user retrieved by username after insertion.</returns>
     /// <exception cref="UnprocessableEntityException">Thrown when a local user's password is not considered strong.</exception>
     /// <exception cref="NotFoundException">Thrown when the user cannot be retrieved by username after insertion.</exception>
+    /// <!-- aidoc:v1 sig=82465f8 body=d4f7721 -->
     public async Task<User?> CreateNewUserByRequest(User user)
         {
             CheckIfEmailExists(user.Email);
@@ -391,6 +405,7 @@ public class UserService : IUserService
     /// <param name="createUserWithAuthDto">The data transfer object containing the user details and the list of authorizations to associate with the new user.</param>
     /// <returns>The newly created user, or <c>null</c> if creation fails (in which case an exception is thrown instead).</returns>
     /// <exception cref="NotFoundException">Thrown when the user cannot be created by the underlying request, indicating a missing resource.</exception>
+    /// <!-- aidoc:v1 sig=b28ec32 body=6f231bc -->
     public async Task<User?> CreateNewUserWithAuthorities(CreateUserWithAuthDto createUserWithAuthDto)
         {
             var user = createUserWithAuthDto.User;
@@ -413,6 +428,7 @@ public class UserService : IUserService
     /// <param name="updatePass">Indicates whether the user's password should be updated and re-hashed.</param>
     /// <returns>The updated user returned by the repository, or <c>null</c> if the user could not be found or updated.</returns>
     /// <exception cref="UnprocessableEntityException">Thrown when <paramref name="updatePass"/> is <c>true</c> and the provided password does not meet the strong password policy.</exception>
+    /// <!-- aidoc:v1 sig=4a0b955 body=0eb37fa -->
     public async Task<User?> UpdateUsersByRequest(User user, bool updatePass)
         {
             var oldUser = await _userRepository.GetByUserName(user.UserName);
@@ -443,6 +459,8 @@ public class UserService : IUserService
     /// <param name="elementUpdated">The element that has been updated and should be transmitted to the subscribers.</param>
     /// <param name="userName">The user name used to filter the subscribers that will receive the broadcast.</param>
     /// <param name="operation">The type of operation (e.g., create, update, delete) associated with the broadcast.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary says the broadcast notifies subscribers of 'an update operation', but the code passes through any OperationType (which the param description itself lists as create/update/delete), not just update operations." -->
     private async Task SendBroadcastUser(object elementUpdated, string userName, OperationType operation)
         {
             var subscribers = _subscribersService.GetSubscribers().Where(s =>
@@ -459,6 +477,7 @@ public class UserService : IUserService
     /// <param name="elementUpdated">The updated element to send as the notification payload to non-admin subscribers.</param>
     /// <param name="userName">The username whose subscribers will receive the broadcast.</param>
     /// <param name="operation">The operation type that describes the nature of the update.</param>
+    /// <!-- aidoc:v1 sig=4f775b6 body=1033854 -->
     private async Task SendBroadcastPermissions(object elementUpdated, string userName, OperationType operation)
         {
             var subscribers = _subscribersService.GetSubscribers().Where(s =>
@@ -491,6 +510,7 @@ public class UserService : IUserService
     /// <param name="updatePass">Flag indicating whether the user's password should be updated as part of the operation.</param>
     /// <returns>The updated <see cref="User"/>.</returns>
     /// <exception cref="ConflictException">Thrown when the underlying user update returns no result.</exception>
+    /// <!-- aidoc:v1 sig=99d7acb body=7cdfa30 -->
     public async Task<User?> UpdateUserWithAuthorities(UpdateUserWithAuthDto updateUserWithAuthDto, bool updatePass)
         {
             var u = updateUserWithAuthDto.User;
@@ -525,6 +545,7 @@ public class UserService : IUserService
     /// <exception cref="BadRequestException">Thrown when <paramref name="newPassword"/> is equal to <paramref name="oldPassword"/>.</exception>
     /// <exception cref="NotFoundException">Thrown when no user exists for the supplied <paramref name="id"/>.</exception>
     /// <exception cref="UnprocessableEntityException">Thrown when <paramref name="oldPassword"/> does not match the user's current password, or when <paramref name="newPassword"/> does not satisfy the strength policy.</exception>
+    /// <!-- aidoc:v1 sig=0243044 body=c52695d -->
     public async Task<bool> UpdateUserPassword(ObjectId id, string oldPassword, string newPassword)
         {
             if (oldPassword == newPassword)
@@ -561,6 +582,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="id">The identifier of the user to delete.</param>
     /// <returns>A task that resolves to <c>true</c> when the user is successfully deleted; otherwise, <c>false</c> if an error is encountered.</returns>
+    /// <!-- aidoc:v1 sig=72679b2 body=c3e6d4f -->
     public async Task<bool> DeleteUser(ObjectId id)
         {
             try
@@ -582,6 +604,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="filter">The pagination filter containing the page number and page size used to skip, limit, and shape the result set.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a <see cref="PaginationResponse{User}"/> with the requested page of users and pagination details.</returns>
+    /// <!-- aidoc:v1 sig=0367293 body=27c2222 -->
     public async Task<PaginationResponse<User>> GetPaginatedUsers(PaginationFilter filter)
         {
             var result = _userRepository.GetPaginatedUsers(filter);
@@ -603,6 +626,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="user">The user whose identity, email, IP address, and authorization claims will be embedded in the generated tokens.</param>
     /// <returns>A <see cref="TokenResult"/> containing the serialized access and refresh tokens, their respective expiration times, and the associated user.</returns>
+    /// <!-- aidoc:v1 sig=67521e7 body=d87cd16 -->
     public async Task<TokenResult> GenerateJwt(User user)
         {
             var claims = new List<Claim>
@@ -650,6 +674,7 @@ public class UserService : IUserService
     /// <returns>A task that resolves to the list of <see cref="User"/> objects returned by the first successful login service.</returns>
     /// <exception cref="LoginServicesException">Thrown when a non-business exception occurs while retrieving users from a service.</exception>
     /// <exception cref="LoginServicesNotFoundException">Thrown when no login service matches the valid login methods or all attempts fail without a captured business exception.</exception>
+    /// <!-- aidoc:v1 sig=b9380e5 body=b90883c -->
     public async Task<List<User>> GetAll()
         {
             BusinessException? loginException = null;
@@ -688,6 +713,7 @@ public class UserService : IUserService
     /// <param name="token">The access token to validate and use for user authentication.</param>
     /// <returns>A <see cref="TokenResult"/> containing the new access token, refresh token, their expiry times, and the authenticated user.</returns>
     /// <exception cref="NotFoundException">Thrown when no user can be resolved from the provided token.</exception>
+    /// <!-- aidoc:v1 sig=4a410ea body=f486923 -->
     public async Task<TokenResult> LoginWithGivenAccessToken(string token)
         {
             ValidateToken(token, IUserService.TokenTypeUser, out var validatedToken);
@@ -742,6 +768,7 @@ public class UserService : IUserService
     /// <param name="token">The access token used to identify and authenticate the user.</param>
     /// <returns>A <see cref="Task{TokenResult}"/> containing the generated JWT for the authenticated user.</returns>
     /// <exception cref="NotFoundException">Thrown when no user is found that matches the validated access token.</exception>
+    /// <!-- aidoc:v1 sig=58a9e83 body=98c26eb -->
     public async Task<TokenResult> LoginWithAccessToken(string token)
         {
             ValidateToken(token, IUserService.TokenTypeUser, out var validatedToken);
@@ -759,6 +786,7 @@ public class UserService : IUserService
     /// <param name="auth">The authorization used to create the new user authority.</param>
     /// <returns>The newly created <see cref="Authorization"/> instance.</returns>
     /// <exception cref="ConflictException">Thrown when the authority service fails to create the user authority (returns null).</exception>
+    /// <!-- aidoc:v1 sig=b73cf48 body=71c9c28 -->
     public async Task<Authorization> CreateNewAuthority(Authorization auth)
         {
             var newUserAuthority = await _authorityService.CreateNewUserAuthority(auth) ??
@@ -773,6 +801,7 @@ public class UserService : IUserService
     /// <returns>A task that resolves to <c>true</c> when the authority is successfully deleted.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="ConflictException">Thrown when the underlying delete operation fails.</exception>
+    /// <!-- aidoc:v1 sig=eaa5d92 body=8a73373 -->
     public async Task<bool> DeleteAuthority(string id)
         {
             if (!ObjectId.TryParse(id, out var userAuthorityIdParsed))
@@ -788,6 +817,7 @@ public class UserService : IUserService
     /// <param name="authorization">The authorization details used to update the user's authority.</param>
     /// <returns>A task that resolves to <c>true</c> when the authority is successfully updated.</returns>
     /// <exception cref="ConflictException">Thrown when the authority service returns a null response, indicating the update failed.</exception>
+    /// <!-- aidoc:v1 sig=544e59f body=c079022 -->
     public async Task<bool> UpdateAuthority(Authorization authorization)
         {
             _ = await _authorityService.EditUserAuthority(authorization) ??
@@ -801,6 +831,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="authorities">The list of authorizations to convert into claims.</param>
     /// <returns>A task that represents the asynchronous operation, containing the list of claims built from the supplied authorities.</returns>
+    /// <!-- aidoc:v1 sig=527b34e body=d91d2bf -->
     public async Task<List<Claim>> ClaimsFromAuthorities(List<Authorization> authorities)
         {
             var claims = new List<Claim>();
@@ -828,6 +859,7 @@ public class UserService : IUserService
     /// </summary>
     /// <param name="auth">The authorization source whose role and display identifier are used to build the claim value.</param>
     /// <param name="claims">The list of claims to which the new role claim is appended when not already present.</param>
+    /// <!-- aidoc:v1 sig=85111ea body=f681ceb -->
     private static void AddClaim(Authorization auth, List<Claim> claims)
         {
             var newClaim = new Claim(ClaimTypes.Role,
@@ -844,6 +876,7 @@ public class UserService : IUserService
     /// <param name="userName">The username to validate against existing users.</param>
     /// <param name="userId">Optional identifier of the user being updated; when provided, that user is excluded from the duplicate check.</param>
     /// <exception cref="BadRequestException">Thrown when another user with the same <paramref name="userName"/> already exists.</exception>
+    /// <!-- aidoc:v1 sig=cd63db7 body=c9563e3 -->
     private void CheckIfUserNameExists(string userName, ObjectId? userId = null)
         {
             var users = GetAll().Result;
@@ -860,6 +893,7 @@ public class UserService : IUserService
     /// <param name="email">The email address to verify for uniqueness in the user collection.</param>
     /// <param name="userId">The optional ID of the current user; when set, it is excluded from the duplicate email check.</param>
     /// <exception cref="BadRequestException">Thrown when the email is already registered to a different user.</exception>
+    /// <!-- aidoc:v1 sig=074e36e body=4e4b89e -->
     private void CheckIfEmailExists(string email, ObjectId? userId = null)
         {
             var users = GetAll().Result;
diff --git a/adas-core.Domain/Enums/ActionsEnum.cs b/adas-core.Domain/Enums/ActionsEnum.cs
index 7c9c1a85..336c4e67 100644
--- a/adas-core.Domain/Enums/ActionsEnum.cs
+++ b/adas-core.Domain/Enums/ActionsEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for defining and accessing available action definitions or constants.
 /// </summary>
+/// <!-- aidoc:v1 sig=52b977e -->
 public static class ActionsEnum
 {
     public enum Actions
diff --git a/adas-core.Domain/Enums/AlarmEnum.cs b/adas-core.Domain/Enums/AlarmEnum.cs
index a1e884e5..32338989 100644
--- a/adas-core.Domain/Enums/AlarmEnum.cs
+++ b/adas-core.Domain/Enums/AlarmEnum.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Enums;
 /// <remarks>
 /// This class is declared as static and cannot be instantiated; all members are accessed via the type name.
 /// </remarks>
+/// <!-- aidoc:v1 sig=6f3ffd9 -->
 public static class AlarmEnum
 {
     public enum AudioAlarmType
diff --git a/adas-core.Domain/Enums/CacheEnum.cs b/adas-core.Domain/Enums/CacheEnum.cs
index 9d006942..998e6f84 100644
--- a/adas-core.Domain/Enums/CacheEnum.cs
+++ b/adas-core.Domain/Enums/CacheEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides static utility methods for caching and managing enumeration values.
 /// </summary>
+/// <!-- aidoc:v1 sig=fa3a832 -->
 public static class CacheEnum
 {
     
diff --git a/adas-core.Domain/Enums/DisplayConfigEnums.cs b/adas-core.Domain/Enums/DisplayConfigEnums.cs
index fdab348d..703a2b2e 100644
--- a/adas-core.Domain/Enums/DisplayConfigEnums.cs
+++ b/adas-core.Domain/Enums/DisplayConfigEnums.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static collection of display-related configuration enumerations.
 /// </summary>
+/// <!-- aidoc:v1 sig=124d59f -->
 public static class DisplayConfigEnums
 {
     public enum AxisPosition
diff --git a/adas-core.Domain/Enums/FileEnum.cs b/adas-core.Domain/Enums/FileEnum.cs
index 6ff1311c..7efd75f9 100644
--- a/adas-core.Domain/Enums/FileEnum.cs
+++ b/adas-core.Domain/Enums/FileEnum.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class serves as a container for static members related to file enumeration functionality.
 /// </remarks>
+/// <!-- aidoc:v1 sig=218e266 -->
 public static class FileEnum
 {
     public enum AssetTheme
diff --git a/adas-core.Domain/Enums/GroupedObservationEnum.cs b/adas-core.Domain/Enums/GroupedObservationEnum.cs
index c10cdae4..be8b6bf6 100644
--- a/adas-core.Domain/Enums/GroupedObservationEnum.cs
+++ b/adas-core.Domain/Enums/GroupedObservationEnum.cs
@@ -6,6 +6,8 @@
 /// <remarks>
 /// This type is intended to provide a structured way to classify or organize observation values into distinct groups.
 /// </remarks>
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The summary states the type is 'an enumeration', but the code declares it as `public class GroupedObservationEnum`, not an `enum`." -->
 public class GroupedObservationEnum
 {
     public enum Regularity
diff --git a/adas-core.Domain/Enums/HttpEnum.cs b/adas-core.Domain/Enums/HttpEnum.cs
index 861b6ef7..b8861bec 100644
--- a/adas-core.Domain/Enums/HttpEnum.cs
+++ b/adas-core.Domain/Enums/HttpEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for HTTP-related enumerations and associated helper members.
 /// </summary>
+/// <!-- aidoc:v1 sig=6dac62b -->
 public static class HttpEnum
 {
     /// <summary>
diff --git a/adas-core.Domain/Enums/MedicineEnum.cs b/adas-core.Domain/Enums/MedicineEnum.cs
index 9a6253b7..f5156fca 100644
--- a/adas-core.Domain/Enums/MedicineEnum.cs
+++ b/adas-core.Domain/Enums/MedicineEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for medicine-related enumeration values or constants.
 /// </summary>
+/// <!-- aidoc:v1 sig=69fb283 -->
 public static class MedicineEnum
 {
     public enum Group
diff --git a/adas-core.Domain/Enums/ObservationEnum.cs b/adas-core.Domain/Enums/ObservationEnum.cs
index d26ece44..4bbe3ed8 100644
--- a/adas-core.Domain/Enums/ObservationEnum.cs
+++ b/adas-core.Domain/Enums/ObservationEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for observation-related enumeration members.
 /// </summary>
+/// <!-- aidoc:v1 sig=b580639 -->
 public static class ObservationEnum
 {
     /**
diff --git a/adas-core.Domain/Enums/PatientEnum.cs b/adas-core.Domain/Enums/PatientEnum.cs
index 6d5480a0..6b252280 100644
--- a/adas-core.Domain/Enums/PatientEnum.cs
+++ b/adas-core.Domain/Enums/PatientEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for patient-related enumeration values or constants used throughout the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=ab2fce9 -->
 public static class PatientEnum
 {
     public enum Gender
diff --git a/adas-core.Domain/Enums/PermissionEnum.cs b/adas-core.Domain/Enums/PermissionEnum.cs
index 081097ba..6af29eeb 100644
--- a/adas-core.Domain/Enums/PermissionEnum.cs
+++ b/adas-core.Domain/Enums/PermissionEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a set of permission values used to define access rights or authorization levels within the system.
 /// </summary>
+/// <!-- aidoc:v1 sig=b079c37 -->
 public class PermissionEnum
 {
     public enum PermissionTypesEnum
diff --git a/adas-core.Domain/Enums/PumpEnum.cs b/adas-core.Domain/Enums/PumpEnum.cs
index b2d67e63..637e362e 100644
--- a/adas-core.Domain/Enums/PumpEnum.cs
+++ b/adas-core.Domain/Enums/PumpEnum.cs
@@ -4,6 +4,7 @@
 /// Provides static utility members related to the Pump enumeration.
 /// </summary>
 /// <remarks>This class cannot be instantiated and serves as a container for helpers associated with the Pump enum.</remarks>
+/// <!-- aidoc:v1 sig=062034e -->
 public static class PumpEnum
 {
     public enum PumpMessageType
diff --git a/adas-core.Domain/Enums/RelayEnum.cs b/adas-core.Domain/Enums/RelayEnum.cs
index ea78ec4f..7ee61c8f 100644
--- a/adas-core.Domain/Enums/RelayEnum.cs
+++ b/adas-core.Domain/Enums/RelayEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides static utility methods for working with enum types, serving as a relay or helper layer for enum-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=f849741 -->
 public static class RelayEnum
 {
     public enum Mode
diff --git a/adas-core.Domain/Enums/StatusEnum.cs b/adas-core.Domain/Enums/StatusEnum.cs
index ae9f120d..625084a3 100644
--- a/adas-core.Domain/Enums/StatusEnum.cs
+++ b/adas-core.Domain/Enums/StatusEnum.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class is declared as static and cannot be instantiated. It is intended to group status values in a centralized, type-safe manner.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d0730a7 -->
 public static class StatusEnum
 {
     public enum Discharge
diff --git a/adas-core.Domain/Enums/SubscriptionType.cs b/adas-core.Domain/Enums/SubscriptionType.cs
index eb5fad91..9eb99215 100644
--- a/adas-core.Domain/Enums/SubscriptionType.cs
+++ b/adas-core.Domain/Enums/SubscriptionType.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for subscription-related enumeration values.
 /// </summary>
+/// <!-- aidoc:v1 sig=5465e63 -->
 public static class SubscriptionEnum
 {
     public enum Type
diff --git a/adas-core.Domain/Enums/UserEnum.cs b/adas-core.Domain/Enums/UserEnum.cs
index f134715d..3267aaa3 100644
--- a/adas-core.Domain/Enums/UserEnum.cs
+++ b/adas-core.Domain/Enums/UserEnum.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a static container for user-related enumeration values.
 /// </summary>
+/// <!-- aidoc:v1 sig=a944e48 -->
 public static class UserEnum
 {
     public enum LoginMethod
diff --git a/adas-core.Domain/Exceptions/AdasException.cs b/adas-core.Domain/Exceptions/AdasException.cs
index e9a30141..d5e41db5 100644
--- a/adas-core.Domain/Exceptions/AdasException.cs
+++ b/adas-core.Domain/Exceptions/AdasException.cs
@@ -3,4 +3,5 @@ namespace adas_core.Domain.Exceptions;
 /// <summary>
 /// Represents an exception that is thrown when an error occurs within the ADAS (Advanced Driver Assistance Systems) module, providing a prefixed message for easier identification.
 /// </summary>
+/// <!-- aidoc:v1 sig=cb76f52 -->
 public class AdasException(string message) : Exception($"ADAS Exception: {message}");
\ No newline at end of file
diff --git a/adas-core.Domain/Exceptions/BusinessException.cs b/adas-core.Domain/Exceptions/BusinessException.cs
index ad53c291..2a6da586 100644
--- a/adas-core.Domain/Exceptions/BusinessException.cs
+++ b/adas-core.Domain/Exceptions/BusinessException.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Exceptions;
 /// <summary>
 /// Represents an exception that aggregates one or more errors related to business logic or domain rule violations.
 /// </summary>
+/// <!-- aidoc:v1 sig=10da46f -->
 public class BusinessException : AggregateException
 {
     /// <summary>
diff --git a/adas-core.Domain/Exceptions/LoginServicesException.cs b/adas-core.Domain/Exceptions/LoginServicesException.cs
index 2ddb0a6a..30a7ea9c 100644
--- a/adas-core.Domain/Exceptions/LoginServicesException.cs
+++ b/adas-core.Domain/Exceptions/LoginServicesException.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Exceptions;
 /// This exception extends <see cref="BusinessException"/> to signal business-level failures
 /// specific to authentication and login operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=354544f -->
 public class LoginServicesException : BusinessException
 {
     /// <summary>
diff --git a/adas-core.Domain/Exceptions/UserNotFoundException.cs b/adas-core.Domain/Exceptions/UserNotFoundException.cs
index efe49475..348d4f5b 100644
--- a/adas-core.Domain/Exceptions/UserNotFoundException.cs
+++ b/adas-core.Domain/Exceptions/UserNotFoundException.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Exceptions;
 /// <remarks>
 /// Inherits from <see cref="BusinessException"/> to signal user lookup failures within the business domain.
 /// </remarks>
+/// <!-- aidoc:v1 sig=4ee5e51 -->
 public class UserNotFoundException : BusinessException
 {
     /// <summary>
diff --git a/adas-core.Domain/IDefaultRepository.cs b/adas-core.Domain/IDefaultRepository.cs
index df7410cd..7bc5f295 100644
--- a/adas-core.Domain/IDefaultRepository.cs
+++ b/adas-core.Domain/IDefaultRepository.cs
@@ -10,17 +10,20 @@ public interface IDefaultRepository<T, in TS> where T : class
     /// Returns the <see cref="DbSet{T}"/> for entity type <typeparamref name="T"/>, enabling querying and persistence operations against the corresponding table.
     /// </summary>
     /// <returns>A <see cref="DbSet{T}"/> instance for the entity type <typeparamref name="T"/>.</returns>
+    /// <!-- aidoc:v1 sig=ec00daf -->
     DbSet<T> GetSet();
     /// <summary>
     /// Gets an <see cref="IQueryable{T}"/> representing the queryable source of items, allowing callers to compose additional query operations.
     /// </summary>
     /// <returns>An <see cref="IQueryable{T}"/> that can be used to build and execute queries against the underlying data source.</returns>
+    /// <!-- aidoc:v1 sig=f6cc40d -->
     IQueryable<T> Query();
     /// <summary>
     /// Returns a queryable collection of <typeparamref name="T"/> items, optionally applying the specified pagination filter to control paging behavior.
     /// </summary>
     /// <param name="filter">The pagination filter that controls paging of the returned items, or <c>null</c> to omit pagination.</param>
     /// <returns>An <see cref="IQueryable{T}"/> that can be used to enumerate the items with the applied filter.</returns>
+    /// <!-- aidoc:v1 sig=1ebc2e6 -->
     IQueryable<T> Query(PaginationFilter? filter);
     /// <summary>
     /// Returns a paginated queryable sequence of items based on the specified page and page size.
@@ -28,6 +31,7 @@ public interface IDefaultRepository<T, in TS> where T : class
     /// <param name="currentPage">The current page number; when null, pagination may be ignored or handled accordingly.</param>
     /// <param name="pageSize">The number of items per page; when null, a default page size may be used.</param>
     /// <returns>An <see cref="IQueryable{T}"/> representing the requested page of items.</returns>
+    /// <!-- aidoc:v1 sig=864e936 -->
     IQueryable<T> Query(int? currentPage, int? pageSize = null);
 
     /// <summary>
@@ -36,6 +40,7 @@ public interface IDefaultRepository<T, in TS> where T : class
     /// <param name="id">The identifier of the entity to look up.</param>
     /// <param name="includeExpressions">Expressions that specify related entities to include in the returned result.</param>
     /// <returns>The entity matching the supplied identifier, or <c>null</c> if no entity is found.</returns>
+    /// <!-- aidoc:v1 sig=512b7c5 -->
     T? GetById(TS id, params Expression<Func<T, object>>[] includeExpressions);
 
     /// <summary>
@@ -45,6 +50,7 @@ public interface IDefaultRepository<T, in TS> where T : class
     /// <param name="id">The identifier of type <typeparamref name="TS"/> used to locate the entity.</param>
     /// <param name="queryCustomizer">A customizer that controls how the underlying query is constructed and executed.</param>
     /// <returns>The matching entity of type <typeparamref name="T"/>, or <c>null</c> if no entity with the given <paramref name="id"/> is found.</returns>
+    /// <!-- aidoc:v1 sig=aaf08fe -->
     T? GetById(TS id, QueryCustomizer<T> queryCustomizer);
 
     /*[Obsolete("Use GetById(<S> id) instead")]
@@ -57,55 +63,65 @@ public interface IDefaultRepository<T, in TS> where T : class
     /// </summary>
     /// <param name="keyValues">The values that compose the primary key of the entity to retrieve.</param>
     /// <returns>The matching entity of type <typeparamref name="T"/>, or <c>null</c> if no entity is found.</returns>
+    /// <!-- aidoc:v1 sig=830c24f -->
     T? GetByIds(params object[] keyValues);
     /// <summary>
     /// Creates a new instance of type T based on the specified source object.
     /// </summary>
     /// <param name="obj">The source object used to create the new instance.</param>
     /// <returns>A new instance of type T created from the specified object.</returns>
+    /// <!-- aidoc:v1 sig=8ea5182 -->
     T Create(T obj);
     /// <summary>
     /// Creates a list of objects based on the provided collection of input items.
     /// </summary>
     /// <param name="objs">The list of input objects to be created.</param>
     /// <returns>A list of created objects of type <typeparamref name="T"/>.</returns>
+    /// <!-- aidoc:v1 sig=d9289fe -->
     List<T> Create(List<T> objs);
     /// <summary>
     /// Deletes the specified object from the underlying data source and returns the result.
     /// </summary>
     /// <param name="obj">The object of type <typeparamref name="T"/> to be deleted.</param>
     /// <returns>The object of type <typeparamref name="T"/> representing the result of the delete operation.</returns>
+    /// <!-- aidoc:v1 sig=da00ac2 -->
     T Delete(T obj);
     /// <summary>
     /// Deletes the specified collection of objects.
     /// </summary>
     /// <param name="objs">The collection of objects to delete.</param>
     /// <returns>A list of the deleted objects.</returns>
+    /// <!-- aidoc:v1 sig=e26006d -->
     List<T> Delete(ICollection<T> objs);
     /// <summary>
     /// Deletes all records or entries managed by the associated repository or service.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dab2212 -->
     void DeleteAll();
     /// <summary>
     /// Updates the specified entity in the underlying store and returns the updated instance.
     /// </summary>
     /// <param name="obj">The entity instance containing the updated values to persist.</param>
     /// <returns>The updated entity of type <typeparamref name="T"/> as returned by the operation.</returns>
+    /// <!-- aidoc:v1 sig=ea86cad -->
     T Update(T obj);
     /// <summary>
     /// Gets the total number of items in the collection.
     /// </summary>
     /// <returns>The total count of items.</returns>
+    /// <!-- aidoc:v1 sig=b8f191e -->
     int Count();
     /// <summary>
     /// Returns the number of items that match the specified status.
     /// </summary>
     /// <param name="status">The status value used to filter the items being counted.</param>
     /// <returns>The total count of items matching the specified status.</returns>
+    /// <!-- aidoc:v1 sig=c2a0590 -->
     int Count(string status);
     /// <summary>
     /// Retrieves all entities of type <typeparamref name="T"/> and returns them as a list.
     /// </summary>
     /// <returns>A <see cref="List{T}"/> containing all entities of type <typeparamref name="T"/>; an empty list if none are found.</returns>
+    /// <!-- aidoc:v1 sig=3045be0 -->
     List<T> FindAll();
 }
\ No newline at end of file
diff --git a/adas-core.Domain/Models/ADMPanelRequest.cs b/adas-core.Domain/Models/ADMPanelRequest.cs
index 78801360..8fabeb09 100644
--- a/adas-core.Domain/Models/ADMPanelRequest.cs
+++ b/adas-core.Domain/Models/ADMPanelRequest.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents a request payload for the administrative panel operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=9d0f4b5 -->
 public class AdmPanelRequest
 {
     public string? Type { get; set; }
@@ -69,6 +70,7 @@ public class AdmPanelRequest
     /// If serialization fails, falls back to the base <see cref="object.ToString"/> implementation.
     /// </summary>
     /// <returns>A JSON-serialized string of the object, or the result of <c>base.ToString()</c> if serialization throws an exception.</returns>
+    /// <!-- aidoc:v1 sig=483eaf3 body=7f15aa0 -->
     public override string? ToString()
         {
             try
diff --git a/adas-core.Domain/Models/APIRequest.cs b/adas-core.Domain/Models/APIRequest.cs
index 9b47d9e9..dbae3235 100644
--- a/adas-core.Domain/Models/APIRequest.cs
+++ b/adas-core.Domain/Models/APIRequest.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents an API request, encapsulating the data and configuration needed to invoke a remote or web service endpoint.
 /// </summary>
+/// <!-- aidoc:v1 sig=7388af5 -->
 public class ApiRequest
 {
     // SIU
@@ -112,6 +113,7 @@ public class ApiRequest
     /// If serialization fails, falls back to the result of <see cref="object.ToString()"/>.
     /// </summary>
     /// <returns>A JSON string representation of the object, or the base <see cref="object.ToString()"/> result if serialization throws an exception.</returns>
+    /// <!-- aidoc:v1 sig=483eaf3 body=7f15aa0 -->
     public override string? ToString()
         {
             try
diff --git a/adas-core.Domain/Models/AppSettings/ApiSettings.cs b/adas-core.Domain/Models/AppSettings/ApiSettings.cs
index b8e62bec..309c5ec0 100644
--- a/adas-core.Domain/Models/AppSettings/ApiSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/ApiSettings.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.AppSettings;
 /// <summary>
 /// Represents configuration settings for an API, such as base URL, authentication credentials, and timeout values.
 /// </summary>
+/// <!-- aidoc:v1 sig=83781cb -->
 public class ApiSettings
 {
     public const string Api = "ApiSettings";
@@ -214,6 +215,7 @@ public class ApiSettings
 /// <summary>
 /// Represents archived data related to a nurse, providing storage or transfer of historical nursing records.
 /// </summary>
+/// <!-- aidoc:v1 sig=49ee4f4 -->
 public class ArchiveNurseData
 {
     public bool Active { get; set; } = false;
@@ -226,6 +228,7 @@ public class ArchiveNurseData
 /// <summary>
 /// Represents the configuration settings used to control the archiving process for nurse-related data.
 /// </summary>
+/// <!-- aidoc:v1 sig=dc90db8 -->
 public class ArchiveNurseDataConfig
 {
     public bool Active { get; set; } = false;
@@ -235,6 +238,7 @@ public class ArchiveNurseDataConfig
 /// <summary>
 /// Represents a mapping configuration for point of care data, defining relationships between source and target structures.
 /// </summary>
+/// <!-- aidoc:v1 sig=27a9412 -->
 public class PointOfCareMapping
 {
     public string? Key { get; set; }
@@ -245,6 +249,7 @@ public class PointOfCareMapping
 /// <summary>
 /// Represents configuration settings that govern how observations are captured, processed, or reported.
 /// </summary>
+/// <!-- aidoc:v1 sig=5975642 -->
 public class ConfigObservationSettings
 {
     public bool IgnoreUnknownObservation { get; set; }
@@ -257,6 +262,7 @@ public class ConfigObservationSettings
 /// <summary>
 /// Represents a collection or registry of intervention codes used to identify or categorize specific interventions.
 /// </summary>
+/// <!-- aidoc:v1 sig=46f520c -->
 public class InterventionsCodes
 {
     private object? _finalValue;
@@ -387,6 +393,7 @@ public class InterventionsCodes
 /// <summary>
 /// Represents a collection or container of values related to interventions.
 /// </summary>
+/// <!-- aidoc:v1 sig=4c5d783 -->
 public class InterventionsValues
 {
     private object? _finalValue;
@@ -500,6 +507,7 @@ public class InterventionsValues
 /// <summary>
 /// Represents a collection or configuration for mapping interventions, providing the means to associate intervention data with corresponding target structures or actions.
 /// </summary>
+/// <!-- aidoc:v1 sig=55d2689 -->
 public class MappingInterventions
 {
     public string? Type { get; set; }
diff --git a/adas-core.Domain/Models/AppSettings/AuthSettings.cs b/adas-core.Domain/Models/AppSettings/AuthSettings.cs
index ae6e8a19..54ba6ce8 100644
--- a/adas-core.Domain/Models/AppSettings/AuthSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/AuthSettings.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.AppSettings;
 /// <summary>
 /// Represents a set of configuration settings used to control authentication behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=d8a746d -->
 public class AuthSettings
 {
     public JwtConfig? JwtConfig { get; set; }
@@ -18,6 +19,7 @@ public class AuthSettings
 /// <remarks>
 /// This class derives from <see cref="JwtExtConfig"/> and inherits its configuration properties, allowing it to serve as a more specific or customized JWT configuration type.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8dc3f7a -->
 public class JwtConfig : JwtExtConfig
 {
     public string? Issuer { get; set; }
@@ -32,6 +34,7 @@ public class JwtConfig : JwtExtConfig
 /// <summary>
 /// Represents a configuration class for JWT (JSON Web Token) extension settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=3aa508b -->
 public class JwtExtConfig
 {
     public string? Key { get; set; }
@@ -45,6 +48,7 @@ public class JwtExtConfig
 /// <remarks>
 /// Inherits from a generic list of strings, exposing standard collection semantics for the whitelisted user entries.
 /// </remarks>
+/// <!-- aidoc:v1 sig=670602e -->
 public class UsersWhiteListConfig : List<string>
 {
     /// <summary>
@@ -52,6 +56,7 @@ public class UsersWhiteListConfig : List<string>
     /// </summary>
     /// <param name="user">The user whose username will be checked against the collection.</param>
     /// <returns><c>true</c> if a matching username is found; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a7ea804 body=5c9ff96 -->
     public bool IsValid(User user)
         {
             return this.Any(username => username.ToLowerInvariant().Equals(user.UserName.ToLowerInvariant()));
@@ -74,6 +79,10 @@ public class UsersWhiteListConfig : List<string>
 /// Represents a group that has been validated as meeting the required criteria.
 /// </summary>
 /// <!-- aidoc:v1 sig=1cee181 -->
+/// <summary>
+/// Represents a group that has been validated, typically used as a wrapper or marker type to distinguish validated data from unvalidated input.
+/// </summary>
+/// <!-- aidoc:v1 sig=1cee181 -->
 public class ValidGroupsConfig : List<ValidGroup>
 {
     /// <summary>
@@ -81,6 +90,7 @@ public class ValidGroupsConfig : List<ValidGroup>
     /// </summary>
     /// <param name="user">The user instance to validate.</param>
     /// <returns><see langword="true"/> if <paramref name="user"/> is not null; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=ef48a2b body=71cdf52 -->
     public bool IsValid(User? user)
         {
             return user != null;
diff --git a/adas-core.Domain/Models/AppSettings/AutoRecordingSettings.cs b/adas-core.Domain/Models/AppSettings/AutoRecordingSettings.cs
index 5b1ebce9..7ef82350 100644
--- a/adas-core.Domain/Models/AppSettings/AutoRecordingSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/AutoRecordingSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the configuration settings for automatic recording functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=9229177 -->
 public class AutoRecordingSettings
 {
     public AutoStart? AutoStart { get; set; }
@@ -13,6 +14,7 @@ public class AutoRecordingSettings
 /// <summary>
 /// Represents functionality related to automatic startup of a process or service.
 /// </summary>
+/// <!-- aidoc:v1 sig=6a81bf1 -->
 public class AutoStart
 {
     public int BlueCode { get; set; }
@@ -23,6 +25,7 @@ public class AutoStart
 /// <summary>
 /// Represents an automatic stop mechanism that handles stopping operations or processes automatically.
 /// </summary>
+/// <!-- aidoc:v1 sig=240b0b2 -->
 public class AutoStop
 {
     public int BlueCode { get; set; }
@@ -33,6 +36,7 @@ public class AutoStop
 /// <summary>
 /// Represents a condition or requirement that indicates an alert must be sent.
 /// </summary>
+/// <!-- aidoc:v1 sig=3f6f290 -->
 public class MustSendAlert
 {
     public bool BlueCode { get; set; }
diff --git a/adas-core.Domain/Models/AppSettings/CacheSettings.cs b/adas-core.Domain/Models/AppSettings/CacheSettings.cs
index 95587d98..bf499f6f 100644
--- a/adas-core.Domain/Models/AppSettings/CacheSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/CacheSettings.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.AppSettings;
 /// <summary>
 /// Represents configuration settings for a caching mechanism.
 /// </summary>
+/// <!-- aidoc:v1 sig=cf8ad7b -->
 public class CacheSettings
 {
     
@@ -46,6 +47,7 @@ public class CacheSettings
 /// Represents an in-memory implementation for managing application settings.
 /// Provides storage and retrieval of configuration values without persisting them to an external source.
 /// </summary>
+/// <!-- aidoc:v1 sig=5f6fdbf -->
 public class InMemorySettings
 {
     public TtlSettings Ttl { get; set; } = new();
@@ -58,6 +60,7 @@ public class InMemorySettings
 /// <summary>
 /// Represents configuration settings related to Time-To-Live (TTL) behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=3ef4f35 -->
 public class TtlSettings
 {
     public int? GlobalSeconds { get; set; }
diff --git a/adas-core.Domain/Models/AppSettings/DatabaseSettings.cs b/adas-core.Domain/Models/AppSettings/DatabaseSettings.cs
index bc8369e2..242181af 100644
--- a/adas-core.Domain/Models/AppSettings/DatabaseSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/DatabaseSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a set of configuration settings used to establish and manage database connections.
 /// </summary>
+/// <!-- aidoc:v1 sig=afbc8ad -->
 public class DatabaseSettings
 {
     public const string Database = "DatabaseSettings";
diff --git a/adas-core.Domain/Models/AppSettings/ListSettings.cs b/adas-core.Domain/Models/AppSettings/ListSettings.cs
index 675e32da..ae3b0ceb 100644
--- a/adas-core.Domain/Models/AppSettings/ListSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/ListSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents configuration or display settings for a list.
 /// </summary>
+/// <!-- aidoc:v1 sig=67da1b3 -->
 public class ListSettings
 {
     public ListSettingItem AltableOptionList { get; set; } = new()
@@ -140,6 +141,7 @@ public class ListSettings
 /// <summary>
 /// Represents a single item within a list-based setting configuration.
 /// </summary>
+/// <!-- aidoc:v1 sig=7f2589e -->
 public class ListSettingItem
 {
     public string? ManualObservationName { get; set; }
diff --git a/adas-core.Domain/Models/AppSettings/PermissionSettings.cs b/adas-core.Domain/Models/AppSettings/PermissionSettings.cs
index 225d81fa..b1766854 100644
--- a/adas-core.Domain/Models/AppSettings/PermissionSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/PermissionSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the configuration settings related to permissions.
 /// </summary>
+/// <!-- aidoc:v1 sig=1c938b3 -->
 public class PermissionSettings
 {
     public SourcePermissions Admin { get; set; } = new(
@@ -359,6 +360,7 @@ public class PanelPermissionTypes(
 /// <remarks>
 /// This type captures granular action-level authorization flags, allowing the application to enforce and check individual user capabilities across supported operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a3c35ac -->
 public class UserActions(bool create, bool update, bool delete, bool read, bool execute)
 {
     public bool Create { get; set; } = create;
diff --git a/adas-core.Domain/Models/AppSettings/RabbitMQSettings.cs b/adas-core.Domain/Models/AppSettings/RabbitMQSettings.cs
index 94dd9db7..aca9302c 100644
--- a/adas-core.Domain/Models/AppSettings/RabbitMQSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/RabbitMQSettings.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class is intended to hold RabbitMQ-related configuration values, such as connection details and broker options, that can be bound from application configuration sources.
 /// </remarks>
+/// <!-- aidoc:v1 sig=f11b409 -->
 public class RabbitMqSettings
 {
     public string ConnectionString { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/AppSettings/RecordingSettings.cs b/adas-core.Domain/Models/AppSettings/RecordingSettings.cs
index caf6c2d3..4b2976ad 100644
--- a/adas-core.Domain/Models/AppSettings/RecordingSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/RecordingSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents configuration settings used to control recording behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=423ec65 -->
 public class RecordingSettings
 {
     public const string Recording = "RecordingSettings";
diff --git a/adas-core.Domain/Models/AppSettings/RedisSettings.cs b/adas-core.Domain/Models/AppSettings/RedisSettings.cs
index 0fa40015..4173edea 100644
--- a/adas-core.Domain/Models/AppSettings/RedisSettings.cs
+++ b/adas-core.Domain/Models/AppSettings/RedisSettings.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.AppSettings
     ///  - TTL global y por entidad
     ///  - Generación de claves CacheKeys
     /// </summary>
+    /// <!-- aidoc:v1 sig=5ed70a1 -->
     public class RedisSettings
     {
         // Conexión y networking
@@ -30,6 +31,7 @@ namespace adas_core.Domain.Models.AppSettings
         /// <summary>
         /// Represents a Redis server endpoint, typically used to encapsulate connection details such as host, port, and credentials required to connect to a Redis instance.
         /// </summary>
+        /// <!-- aidoc:v1 sig=1bcefd5 -->
         public class RedisEndpoint
         {
             public string Host { get; set; } = null!;
@@ -42,6 +44,7 @@ namespace adas_core.Domain.Models.AppSettings
         /// <summary>
         /// Provides static cache key constants used throughout the application to ensure consistent key naming when storing and retrieving cached data.
         /// </summary>
+        /// <!-- aidoc:v1 sig=6c8a7c2 -->
         public static class CacheKeys
         {
             // ----------------- Patients -----------------
@@ -50,6 +53,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// </summary>
             /// <param name="patientId">The unique identifier of the patient to be included in the formatted string.</param>
             /// <returns>A string in the format "patients:{patientId}" representing the patient resource key.</returns>
+            /// <!-- aidoc:v1 sig=a34b787 -->
             public static string Patient(string patientId)
                             => $"patients:{patientId}";
 
@@ -59,6 +63,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// </summary>
             /// <param name="id">The unique identifier of the config display to include in the key.</param>
             /// <returns>A formatted key string in the form <c>configDisplays:{id}</c> suitable for lookup or caching.</returns>
+            /// <!-- aidoc:v1 sig=4d38573 -->
             public static string ConfigDisplay(string id)
                             => $"configDisplays:{id}";
 
@@ -66,6 +71,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// Returns the configuration key representing the "all displays" setting, typically used to request or identify the display configuration for all available displays.
             /// </summary>
             /// <returns>The string identifier "configDisplays:all" used to reference the all-displays configuration.</returns>
+            /// <!-- aidoc:v1 sig=6e48d03 -->
             public static string ConfigDisplaysAll()
                             => "configDisplays:all";
 
@@ -75,6 +81,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// </summary>
             /// <param name="obsId">The observation identifier to include in the formatted result.</param>
             /// <returns>A formatted string in the form "pumpObs:{obsId}".</returns>
+            /// <!-- aidoc:v1 sig=88326ef -->
             public static string PumpObservation(string obsId)
                             => $"pumpObs:{obsId}";
 
@@ -84,6 +91,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="pumpId">The unique identifier of the pump used in the composed key.</param>
             /// <param name="date">The observation date whose year, month, and day are formatted into the key.</param>
             /// <returns>A string in the form <c>pumpObs:pump:{pumpId}:{yyyyMMdd}</c> representing the daily pump observation key.</returns>
+            /// <!-- aidoc:v1 sig=4367dcb -->
             public static string PumpDaily(string pumpId, DateTime date)
                             => $"pumpObs:pump:{pumpId}:{date:yyyyMMdd}";
 
@@ -93,6 +101,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// </summary>
             /// <param name="apptId">The unique identifier of the appointment.</param>
             /// <returns>A formatted string in the form "appointments:{apptId}".</returns>
+            /// <!-- aidoc:v1 sig=1b8e8d2 -->
             public static string Appointment(string apptId)
                             => $"appointments:{apptId}";
 
@@ -103,6 +112,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="patientId">The unique identifier of the patient whose appointments are being addressed.</param>
             /// <param name="date">The date for which the appointments are being requested.</param>
             /// <returns>A formatted cache key string combining the patient identifier and the day in <c>yyyyMMdd</c> format.</returns>
+            /// <!-- aidoc:v1 sig=657fef9 -->
             public static string AppointmentsByPatientDay(string patientId, DateTime date)
                             => $"appointments:patient:{patientId}:{date:yyyyMMdd}";
 
@@ -113,6 +123,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="patientId">The identifier of the patient whose appointments are being queried.</param>
             /// <param name="date">The date whose year and month determine the appointment period encoded in the key.</param>
             /// <returns>A formatted string in the form <c>appointments:patient:{patientId}:{yyyyMM}</c> suitable for use as a cache key.</returns>
+            /// <!-- aidoc:v1 sig=9218fd1 -->
             public static string AppointmentsByPatientMonth(string patientId, DateTime date)
                             => $"appointments:patient:{patientId}:{date:yyyyMM}";
 
@@ -123,6 +134,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="patientId">The unique identifier of the patient whose observations are being referenced.</param>
             /// <param name="groupedField">The optional field used to group the observations; may be null.</param>
             /// <returns>A formatted string in the pattern "groupedObs:{groupedField}:patient:{patientId}".</returns>
+            /// <!-- aidoc:v1 sig=14698da -->
             public static string GroupedObservationsByPatient(string patientId, string? groupedField)
                             => $"groupedObs:{groupedField}:patient:{patientId}";
 
@@ -133,6 +145,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="groupedField">The field name used to group the observations.</param>
             /// <param name="date">The observation date, formatted as <c>yyyyMMdd</c> in the generated key.</param>
             /// <returns>A cache key string in the format <c>groupedObs:{groupedField}:patient:{patientId}:{yyyyMMdd}</c>.</returns>
+            /// <!-- aidoc:v1 sig=b28a057 -->
             public static string GroupedObservationsByPatientDay(string patientId, string groupedField, DateTime date)
                             => $"groupedObs:{groupedField}:patient:{patientId}:{date:yyyyMMdd}";
 
@@ -143,6 +156,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="groupedField">The observation field used as the grouping criterion.</param>
             /// <param name="date">The date used to derive the month bucket (formatted as yyyyMM) for the cache key.</param>
             /// <returns>A formatted cache key string in the form <c>groupedObs:{groupedField}:patient:{patientId}:{yyyyMM}</c>.</returns>
+            /// <!-- aidoc:v1 sig=029e2f4 -->
             public static string GroupedObservationsByPatientMonth(string patientId, string groupedField, DateTime date)
                             => $"groupedObs:{groupedField}:patient:{patientId}:{date:yyyyMM}";
 
@@ -153,6 +167,7 @@ namespace adas_core.Domain.Models.AppSettings
             /// <param name="groupedField">The field used to group the observations.</param>
             /// <param name="take">The maximum number of latest observations to include in the cache key.</param>
             /// <returns>A formatted cache key string identifying the patient's latest grouped observations.</returns>
+            /// <!-- aidoc:v1 sig=8f5c768 -->
             public static string GroupedObservationsLatest(string patientId, string groupedField, int take)
                             => $"groupedObs:{groupedField}:patient:{patientId}:latest:{take}";
         }
diff --git a/adas-core.Domain/Models/BasePatientObservation.cs b/adas-core.Domain/Models/BasePatientObservation.cs
index d3a23bb7..e56eabb4 100644
--- a/adas-core.Domain/Models/BasePatientObservation.cs
+++ b/adas-core.Domain/Models/BasePatientObservation.cs
@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// This type is intended to be subclassed by concrete converters that implement specific serialization and deserialization logic for patient observation types.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d585833 -->
 public class BasePatientObservation : JsonConverter
 {
     public ObjectId Id { get; set; }
@@ -50,6 +51,7 @@ public class BasePatientObservation : JsonConverter
     /// Falls back to the base <see cref="object.ToString"/> implementation if JSON serialization fails.
     /// </summary>
     /// <returns>A JSON-formatted string of the object, or the result of <c>base.ToString()</c> if serialization throws an exception; may be <see langword="null"/> only if the underlying <c>ToString()</c> returns <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=5e4fc16 body=7f15aa0 -->
     public string? ToJsonString()
         {
             try
@@ -66,6 +68,7 @@ public class BasePatientObservation : JsonConverter
     /// Returns a string representation of the patient observation, including its identifier, patient identifier, timestamp, and conditionally included optional fields (such as system identifier, code, coding system, end time, name, and units) when they have values. Any child creation observations are also appended to the output.
     /// </summary>
     /// <returns>A formatted string that lists the patient observation properties prefixed with <c>BasePatientObservation[</c> and suffixed with <c>]</c>.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=128cf3b -->
     public override string ToString()
         {
             List<string> items =
@@ -90,6 +93,7 @@ public class BasePatientObservation : JsonConverter
     /// Converts the current object's properties into a list of formatted key-value strings, including core identifiers and timestamp, and conditionally appending optional fields only when they contain values.
     /// </summary>
     /// <returns>A list of strings where each entry is formatted as "key: value" representing the object's properties.</returns>
+    /// <!-- aidoc:v1 sig=ea52c68 body=e7737e2 -->
     public List<string> ToListString()
         {
             List<string> items =
@@ -111,6 +115,7 @@ public class BasePatientObservation : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to evaluate for conversion support.</param>
     /// <returns><c>true</c> if <paramref name="objectType"/> is <see cref="BasePatientObservation"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee00023 body=5861409 -->
     public override bool CanConvert(Type objectType)
         {
             return objectType == typeof(BasePatientObservation);
@@ -122,6 +127,7 @@ public class BasePatientObservation : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> to which the filtered JSON will be written.</param>
     /// <param name="value">The object to serialize. If <see langword="null"/>, nothing is written.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used during the conversion process.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=d69e337 -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value == null) return;
@@ -141,6 +147,8 @@ public class BasePatientObservation : JsonConverter
     /// <param name="serializer">The serializer instance performing the deserialization.</param>
     /// <returns>An object instance built from the JSON data.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> tag states 'An object instance built from the JSON data', but the method always throws NotImplementedException and never returns an object instance." -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -152,6 +160,7 @@ public class BasePatientObservation : JsonConverter
 /// Represents a parent data class that serves as a base container for shared data members and functionality.
 /// Provides a foundational structure intended to be inherited by more specific data classes.
 /// </summary>
+/// <!-- aidoc:v1 sig=46770a1 -->
 public class ParentDataClass
 {
     public string? Code { get; set; }
diff --git a/adas-core.Domain/Models/BasePatientObservationValue.cs b/adas-core.Domain/Models/BasePatientObservationValue.cs
index cafcce14..498d3b31 100644
--- a/adas-core.Domain/Models/BasePatientObservationValue.cs
+++ b/adas-core.Domain/Models/BasePatientObservationValue.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Serves as an abstract base class for patient observation values, extending <see cref="BasePatientObservation"/> to provide common functionality for representing measured or recorded clinical data associated with a patient observation.
 /// </summary>
+/// <!-- aidoc:v1 sig=e61451e -->
 public abstract class BasePatientObservationValue : BasePatientObservation
 {
     public object Value { get; set; } = new();
diff --git a/adas-core.Domain/Models/BsonConverters/DictionaryBsonConverter.cs b/adas-core.Domain/Models/BsonConverters/DictionaryBsonConverter.cs
index 4335cfb4..80cce926 100644
--- a/adas-core.Domain/Models/BsonConverters/DictionaryBsonConverter.cs
+++ b/adas-core.Domain/Models/BsonConverters/DictionaryBsonConverter.cs
@@ -17,6 +17,7 @@ namespace adas_core.Domain.Models.BsonConverters;
 /// <c>Dictionary&lt;string, object&gt;</c>, providing a focused implementation for
 /// BSON-based persistence and data interchange scenarios.
 /// </remarks>
+/// <!-- aidoc:v1 sig=169ec09 -->
 public class DictionaryBsonConverter : SerializerBase<Dictionary<string, object>>
 {
     /// <summary>
@@ -27,6 +28,7 @@ public class DictionaryBsonConverter : SerializerBase<Dictionary<string, object>
     /// <param name="context">The BSON deserialization context providing the reader used to traverse the BSON payload.</param>
     /// <param name="args">The BSON deserialization arguments carrying additional configuration for the deserialization process.</param>
     /// <returns>A dictionary containing the deserialized key/value pairs extracted from the BSON document.</returns>
+    /// <!-- aidoc:v1 sig=03fa40b body=034476c -->
     public override Dictionary<string, object> Deserialize(BsonDeserializationContext context,
             BsonDeserializationArgs args)
         {
@@ -136,6 +138,7 @@ public class DictionaryBsonConverter : SerializerBase<Dictionary<string, object>
     /// <param name="context">The BSON serialization context that provides the writer used to emit the document.</param>
     /// <param name="args">The BSON serialization arguments associated with the current operation.</param>
     /// <param name="value">The dictionary whose entries are written as fields of the BSON document.</param>
+    /// <!-- aidoc:v1 sig=b562ad9 body=3da66f6 -->
     public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args,
             Dictionary<string, object> value)
         {
@@ -163,6 +166,7 @@ public class DictionaryBsonConverter : SerializerBase<Dictionary<string, object>
     /// <returns><c>true</c> if the key-value pair was successfully serialized; otherwise, <c>false</c>.</returns>
     /// <exception cref="BsonSerializationException">Thrown when a BSON array contains an element whose BSON type is not supported.</exception>
     /// <exception cref="NotSupportedException">Thrown when the default branch encounters a BSON value type that is not supported.</exception>
+    /// <!-- aidoc:v1 sig=8d659cd body=35e207b -->
     private static bool TrySerializeKeyValuePair(KeyValuePair<string, object> item, IBsonWriter writer)
         {
             writer.WriteName(item.Key);
diff --git a/adas-core.Domain/Models/BsonConverters/DictionaryConverter.cs b/adas-core.Domain/Models/BsonConverters/DictionaryConverter.cs
index 73e3a87d..20a24a9b 100644
--- a/adas-core.Domain/Models/BsonConverters/DictionaryConverter.cs
+++ b/adas-core.Domain/Models/BsonConverters/DictionaryConverter.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.BsonConverters;
 /// <remarks>
 /// Inherits from <see cref="JsonConverter"/> to provide custom conversion logic for dictionary-shaped data.
 /// </remarks>
+/// <!-- aidoc:v1 sig=7df0a03 -->
 public class DictionaryConverter : JsonConverter
 {
     /// <summary>
@@ -18,6 +19,7 @@ public class DictionaryConverter : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to evaluate for converter compatibility.</param>
     /// <returns><c>true</c> if the type is <see cref="Dictionary{TKey, TValue}"/> of string and object; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee00023 body=2fea12b -->
     public override bool CanConvert(Type objectType)
         {
             return objectType == typeof(Dictionary<string, object>);
@@ -31,6 +33,7 @@ public class DictionaryConverter : JsonConverter
     /// <param name="existingValue">The existing value of the object being read.</param>
     /// <param name="serializer">The JSON serializer used to deserialize nested values.</param>
     /// <returns>A dictionary containing the JSON properties mapped to their deserialized values.</returns>
+    /// <!-- aidoc:v1 sig=c91c541 body=db0fb4a -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -74,6 +77,7 @@ public class DictionaryConverter : JsonConverter
     /// <param name="writer">The JSON writer that receives the serialized output.</param>
     /// <param name="value">The dictionary to serialize; if null, nothing is written.</param>
     /// <param name="serializer">The serializer used to convert each dictionary value into a JSON token.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=a4424e8 -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value == null)
diff --git a/adas-core.Domain/Models/ChartValue.cs b/adas-core.Domain/Models/ChartValue.cs
index 32eea332..5481aac5 100644
--- a/adas-core.Domain/Models/ChartValue.cs
+++ b/adas-core.Domain/Models/ChartValue.cs
@@ -4,6 +4,7 @@
 /// Represents a value used in a chart, typically encapsulating a data point or measurement
 /// that can be plotted or rendered as part of a chart visualization.
 /// </summary>
+/// <!-- aidoc:v1 sig=b8a6733 -->
 public class ChartValue
 {
     public List<string> Labels { get; set; } = [];
diff --git a/adas-core.Domain/Models/ChatMessage.cs b/adas-core.Domain/Models/ChatMessage.cs
index 69a98350..46c25d70 100644
--- a/adas-core.Domain/Models/ChatMessage.cs
+++ b/adas-core.Domain/Models/ChatMessage.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a chat message, typically used to encapsulate the content and metadata exchanged in a chat conversation.
 /// </summary>
+/// <!-- aidoc:v1 sig=031793b -->
 public class ChatMessage
 {
     public PatientLocation? LocationFrom { get; set; }
diff --git a/adas-core.Domain/Models/Code.cs b/adas-core.Domain/Models/Code.cs
index f8b2d9c7..4c146ae2 100644
--- a/adas-core.Domain/Models/Code.cs
+++ b/adas-core.Domain/Models/Code.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a code entity, serving as a base type for code-related constructs.
 /// </summary>
+/// <!-- aidoc:v1 sig=3e09f19 -->
 public class Code
 {
     public string Identifier { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/CodeAction.cs b/adas-core.Domain/Models/CodeAction.cs
index dd1bf499..cb19eb45 100644
--- a/adas-core.Domain/Models/CodeAction.cs
+++ b/adas-core.Domain/Models/CodeAction.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents a code action that encapsulates an operation or transformation to be performed on code.
 /// </summary>
+/// <!-- aidoc:v1 sig=09c8387 -->
 public class CodeAction
 {
     public ActionsEnum.ResourceAction Action { get; set; }
@@ -16,6 +17,7 @@ public class CodeAction
     /// </summary>
     /// <param name="actions">The list of code actions to apply.</param>
     /// <returns>A <see cref="List{Code}"/> with the applied changes, or <c>null</c> if no codes are produced.</returns>
+    /// <!-- aidoc:v1 sig=08fa405 body=22d71fc -->
     public static List<Code>? Apply(List<CodeAction> actions)
         {
             return Apply(null, actions);
@@ -28,6 +30,7 @@ public class CodeAction
     /// <param name="source">The list of codes to modify. If null, an empty list is used as the starting point.</param>
     /// <param name="actions">The list of code actions to apply. If null, the source list is returned unchanged.</param>
     /// <returns>The modified list of codes, or null if the list is empty after applying the actions.</returns>
+    /// <!-- aidoc:v1 sig=409f9ba body=f7391f6 -->
     public static List<Code>? Apply(List<Code>? source, List<CodeAction>? actions)
         {
             source ??= [];
diff --git a/adas-core.Domain/Models/CodeStatus.cs b/adas-core.Domain/Models/CodeStatus.cs
index 1ba0d48a..2c772a26 100644
--- a/adas-core.Domain/Models/CodeStatus.cs
+++ b/adas-core.Domain/Models/CodeStatus.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the status of a code-related operation or entity.
 /// </summary>
+/// <!-- aidoc:v1 sig=148b1f2 -->
 public class CodeStatus
 {
     public Code? Code { get; set; }
diff --git a/adas-core.Domain/Models/DTO/AppointmentDto.cs b/adas-core.Domain/Models/DTO/AppointmentDto.cs
index beb096f2..d1debbbd 100644
--- a/adas-core.Domain/Models/DTO/AppointmentDto.cs
+++ b/adas-core.Domain/Models/DTO/AppointmentDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object for transferring appointment information between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=ed5b9a8 -->
 public class AppointmentDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/AssetDto.cs b/adas-core.Domain/Models/DTO/AssetDto.cs
index ee5a1c54..ece6812d 100644
--- a/adas-core.Domain/Models/DTO/AssetDto.cs
+++ b/adas-core.Domain/Models/DTO/AssetDto.cs
@@ -3,6 +3,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object for conveying asset information between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=d1871a9 -->
 public class AssetDto
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/DTO/ConfigObservationDto.cs b/adas-core.Domain/Models/DTO/ConfigObservationDto.cs
index b3aedc52..0eb6103f 100644
--- a/adas-core.Domain/Models/DTO/ConfigObservationDto.cs
+++ b/adas-core.Domain/Models/DTO/ConfigObservationDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object used to convey configuration observation information between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=564b645 -->
 public class ConfigObservationDto
 {
     public string Id { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/CreateUserWithAuthDto.cs b/adas-core.Domain/Models/DTO/CreateUserWithAuthDto.cs
index 1af39faf..a53ad102 100644
--- a/adas-core.Domain/Models/DTO/CreateUserWithAuthDto.cs
+++ b/adas-core.Domain/Models/DTO/CreateUserWithAuthDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to create a user along with authentication details.
 /// </summary>
+/// <!-- aidoc:v1 sig=9e4b61f -->
 public class CreateUserWithAuthDto
 {
     public User User { get; set; } = new();
diff --git a/adas-core.Domain/Models/DTO/DeviceDto.cs b/adas-core.Domain/Models/DTO/DeviceDto.cs
index 26e376c7..fb0997af 100644
--- a/adas-core.Domain/Models/DTO/DeviceDto.cs
+++ b/adas-core.Domain/Models/DTO/DeviceDto.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object (DTO) used to encapsulate and transfer device-related information between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=eb8d200 -->
 public class DeviceDto
 {
     public DeviceEvent? Event { get; set; }
@@ -31,6 +32,7 @@ public class DeviceDto
 /// <remarks>
 /// This class is intended to be used as a data carrier for device event notifications or processing.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d49f516 -->
 public class DeviceEvent
 {
     public ClickType? ClickType { get; set; } 
diff --git a/adas-core.Domain/Models/DTO/DiagnosisDto.cs b/adas-core.Domain/Models/DTO/DiagnosisDto.cs
index 846d3701..b33c54c5 100644
--- a/adas-core.Domain/Models/DTO/DiagnosisDto.cs
+++ b/adas-core.Domain/Models/DTO/DiagnosisDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object (DTO) for conveying diagnosis information between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=9d64d60 -->
 public class DiagnosisDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/Display/ColorConfigDto.cs b/adas-core.Domain/Models/DTO/Display/ColorConfigDto.cs
index 2ac19125..11a266cd 100644
--- a/adas-core.Domain/Models/DTO/Display/ColorConfigDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/ColorConfigDto.cs
@@ -3,6 +3,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object (DTO) that encapsulates color configuration settings for transferring color-related data between application layers or systems.
 /// </summary>
+/// <!-- aidoc:v1 sig=bc3afa0 -->
 public class ColorConfigDto
 {
     public LevelColors? Level { get; set; }
@@ -18,6 +19,7 @@ public class ColorConfigDto
     /// <summary>
     /// Represents configuration settings that define the visual appearance, such as colors, themes, or styling preferences.
     /// </summary>
+    /// <!-- aidoc:v1 sig=070355d -->
     public class AppearanceSettings
     {
         public string? TextColor { get; set; }
@@ -36,6 +38,7 @@ public class ColorConfigDto
     /// <remarks>
     /// This type is intended to encapsulate the visual color configuration associated with the numeric portion of a status box display.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=41d803c -->
     public class StatusBoxNumberColors
     {
         public AppearanceSettings? Reserved { get; set; }
@@ -50,6 +53,7 @@ public class ColorConfigDto
     /// <summary>
     /// Provides a centralized set of color values used throughout the therapy-related user interface or visual components.
     /// </summary>
+    /// <!-- aidoc:v1 sig=550c282 -->
     public class TherapyColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -61,6 +65,7 @@ public class ColorConfigDto
     /// <summary>
     /// Provides a collection of color values intended for use in test scenarios.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b0381d4 -->
     public class TestColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -72,6 +77,7 @@ public class ColorConfigDto
     /// <summary>
     /// Represents a collection of color definitions used to visually represent procedures.
     /// </summary>
+    /// <!-- aidoc:v1 sig=676d773 -->
     public class ProcedureColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -86,6 +92,7 @@ public class ColorConfigDto
     /// <remarks>
     /// Used to centralize color definitions related to level display, allowing consistent theming across level-related UI elements.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=f693cfc -->
     public class LevelColors
     {
         public string? Level1 { get; set; }
@@ -98,6 +105,7 @@ public class ColorConfigDto
     /// <summary>
     /// Represents a collection of predefined text color values or definitions for styling text output.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d12f899 -->
     public class TextColors
     {
         public string? Normal { get; set; }
@@ -110,6 +118,7 @@ public class ColorConfigDto
     /// <summary>
     /// Provides a set of predefined color values used for rendering arrows in charts or visualizations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=abbea19 -->
     public class ArrowColors
     {
         public string? Normal { get; set; }
@@ -121,6 +130,7 @@ public class ColorConfigDto
     /// <summary>
     /// Represents a collection or definition of colors used to visually style an indicator.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5c596cd -->
     public class IndicatorColors
     {
         public string? Empty { get; set; }
@@ -134,6 +144,7 @@ public class ColorConfigDto
     /// <summary>
     /// Represents a collection or definition of colors used for rendering graphs and chart elements.
     /// </summary>
+    /// <!-- aidoc:v1 sig=83d1667 -->
     public class GraphColors
     {
         public string? Normal { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/CreateDisplayConfigDto.cs b/adas-core.Domain/Models/DTO/Display/CreateDisplayConfigDto.cs
index cc52bdcb..c398f99b 100644
--- a/adas-core.Domain/Models/DTO/Display/CreateDisplayConfigDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/CreateDisplayConfigDto.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object used to create a new display configuration.
 /// </summary>
+/// <!-- aidoc:v1 sig=2d892f7 -->
 public class CreateDisplayConfigDto
 {
     public DisplayConfigEnums.DisplayType Type { get; set; } =
@@ -20,6 +21,7 @@ public class CreateDisplayConfigDto
 /// <summary>
 /// Represents a data transfer object used to create a display configuration card.
 /// </summary>
+/// <!-- aidoc:v1 sig=887faf2 -->
 public class CreateDisplayConfigCardDto
 {
     public CardConfig? CardConfig { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayConfigDto.cs b/adas-core.Domain/Models/DTO/Display/DisplayConfigDto.cs
index fd048553..a2ad33f3 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayConfigDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayConfigDto.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object for display configuration settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=99d0425 -->
 public class DisplayConfigDto
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayConfigLocationDto.cs b/adas-core.Domain/Models/DTO/Display/DisplayConfigLocationDto.cs
index 5fbdc8e3..ec0b6b43 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayConfigLocationDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayConfigLocationDto.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This DTO is used to transfer display configuration settings along with their associated location data between application layers.
 /// </remarks>
+/// <!-- aidoc:v1 sig=fa37034 -->
 public class DisplayConfigLocationDto
 {
     public string? DisplayName { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayConfigSummary.cs b/adas-core.Domain/Models/DTO/Display/DisplayConfigSummary.cs
index bc6152c8..85322d00 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayConfigSummary.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayConfigSummary.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a summary of display configuration settings, providing a consolidated view of display-related parameters.
 /// </summary>
+/// <!-- aidoc:v1 sig=c5b0fcb -->
 public class DisplayConfigSummary
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayMinimalDto.cs b/adas-core.Domain/Models/DTO/Display/DisplayMinimalDto.cs
index 5e961c92..ebf6fc3a 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayMinimalDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayMinimalDto.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a minimal data transfer object that encapsulates a subset of fields from a <see cref="MongoModels.Display"/> model for lightweight serialization or transfer.
 /// </summary>
+/// <!-- aidoc:v1 sig=42b5500 -->
 public class DisplayMinimalDto(MongoModels.Display display)
 {
     public ObjectId Id { get; set; } = display.Id;
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayNurseDto.cs b/adas-core.Domain/Models/DTO/Display/DisplayNurseDto.cs
index d79d2b26..5315f631 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayNurseDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayNurseDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object used for displaying nurse information, extending the base display configuration functionality provided by <see cref="DisplayConfigDto"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=84008b2 -->
 public class DisplayNurseDto : DisplayConfigDto
 {
     public List<BannerItem>? HomeBanner { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/DisplayWithPermissionsDto.cs b/adas-core.Domain/Models/DTO/Display/DisplayWithPermissionsDto.cs
index 71e3ca81..f975961c 100644
--- a/adas-core.Domain/Models/DTO/Display/DisplayWithPermissionsDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/DisplayWithPermissionsDto.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <remarks>
 /// This DTO is intended for transferring presentation data together with the permissions required to view or interact with it.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2f55888 -->
 public class DisplayWithPermissionsDto
 {
     public DisplayPermissionTypes? Permissions { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/MinimalDisplayListDto.cs b/adas-core.Domain/Models/DTO/Display/MinimalDisplayListDto.cs
index 26832d37..1be3b4be 100644
--- a/adas-core.Domain/Models/DTO/Display/MinimalDisplayListDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/MinimalDisplayListDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object that provides a minimal representation of a display list for transfer between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=9405a12 -->
 public class MinimalDisplayListDto
 {
     public List<MinimalDisplaySection> DisplayNurse { get; set; } = [];
diff --git a/adas-core.Domain/Models/DTO/Display/SmartDisplayDto.cs b/adas-core.Domain/Models/DTO/Display/SmartDisplayDto.cs
index 6d02aa70..2be6a129 100644
--- a/adas-core.Domain/Models/DTO/Display/SmartDisplayDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/SmartDisplayDto.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.DTO.Display;
 /// <summary>
 /// Represents a data transfer object for a smart display configuration, extending the base display configuration with additional smart display properties.
 /// </summary>
+/// <!-- aidoc:v1 sig=653991f -->
 public class SmartDisplayDto : DisplayConfigDto
 {
     public bool? HasCameras { get; set; }
diff --git a/adas-core.Domain/Models/DTO/Display/UpdateDisplayConfigNameDto.cs b/adas-core.Domain/Models/DTO/Display/UpdateDisplayConfigNameDto.cs
index 5ebf3647..1f1dd508 100644
--- a/adas-core.Domain/Models/DTO/Display/UpdateDisplayConfigNameDto.cs
+++ b/adas-core.Domain/Models/DTO/Display/UpdateDisplayConfigNameDto.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This DTO is intended to carry the necessary information to modify the name of an existing display configuration entity.
 /// </remarks>
+/// <!-- aidoc:v1 sig=4ec9b5b -->
 public class UpdateDisplayConfigNameDto
 {
     public string DisplayName { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/MasterListDto.cs b/adas-core.Domain/Models/DTO/MasterListDto.cs
index 4b8919ff..6ffe1393 100644
--- a/adas-core.Domain/Models/DTO/MasterListDto.cs
+++ b/adas-core.Domain/Models/DTO/MasterListDto.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object for a master list, used to transfer collection data between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=4a4e2ff -->
 public class MasterListDto
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/DTO/MasterListWithPaginatedOptionsDto.cs b/adas-core.Domain/Models/DTO/MasterListWithPaginatedOptionsDto.cs
index aa454c19..fc153ee5 100644
--- a/adas-core.Domain/Models/DTO/MasterListWithPaginatedOptionsDto.cs
+++ b/adas-core.Domain/Models/DTO/MasterListWithPaginatedOptionsDto.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <remarks>
 /// This DTO packages a <see cref="MasterList"/> together with the configured <c>pageSize</c> and a list of <see cref="UnitInfoDto"/> entries for transport across application boundaries.
 /// </remarks>
+/// <!-- aidoc:v1 sig=e8bee3d -->
 public class MasterListWithPaginatedOptionsDto(MasterList masterList, int pageSize, List<UnitInfoDto> units)
 {
     public ObjectId Id { get; set; } = masterList.Id;
diff --git a/adas-core.Domain/Models/DTO/ObservationAlarmDto.cs b/adas-core.Domain/Models/DTO/ObservationAlarmDto.cs
index 4648da8c..3eb9c18a 100644
--- a/adas-core.Domain/Models/DTO/ObservationAlarmDto.cs
+++ b/adas-core.Domain/Models/DTO/ObservationAlarmDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object for an observation alarm, used to encapsulate and transfer alarm-related information between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=f8120d4 -->
 public class ObservationAlarmDto
 {
     public string? PatientNumber { get; set; }
diff --git a/adas-core.Domain/Models/DTO/ObservationDto.cs b/adas-core.Domain/Models/DTO/ObservationDto.cs
index 58f0ca74..8cf21938 100644
--- a/adas-core.Domain/Models/DTO/ObservationDto.cs
+++ b/adas-core.Domain/Models/DTO/ObservationDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object for an observation, used to transfer observation data between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=76fadf5 -->
 public class ObservationDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/PaginationPairDto.cs b/adas-core.Domain/Models/DTO/PaginationPairDto.cs
index bf8601b1..2a463b56 100644
--- a/adas-core.Domain/Models/DTO/PaginationPairDto.cs
+++ b/adas-core.Domain/Models/DTO/PaginationPairDto.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <remarks>
 /// Typically used to convey paired pagination metadata, such as a page number together with a page size or total count, in request or response payloads.
 /// </remarks>
+/// <!-- aidoc:v1 sig=24f9a08 -->
 public class PaginationPairDto
 {
     public PaginationFilter ListFilter { get; set; } = new();
diff --git a/adas-core.Domain/Models/DTO/PatientDto.cs b/adas-core.Domain/Models/DTO/PatientDto.cs
index c2cba242..a17c182e 100644
--- a/adas-core.Domain/Models/DTO/PatientDto.cs
+++ b/adas-core.Domain/Models/DTO/PatientDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object used to encapsulate and transfer patient information between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=59e4bee -->
 public class PatientDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/PocAndUnitDto.cs b/adas-core.Domain/Models/DTO/PocAndUnitDto.cs
index 9dd0f19b..b3f67bc6 100644
--- a/adas-core.Domain/Models/DTO/PocAndUnitDto.cs
+++ b/adas-core.Domain/Models/DTO/PocAndUnitDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object that encapsulates point of contact and unit information for transfer between application layers or systems.
 /// </summary>
+/// <!-- aidoc:v1 sig=98b87a1 -->
 public class PocAndUnitDto
 {
     public List<MinimalPocAndUnitDto> PocList { get; set; } = [];
@@ -13,6 +14,7 @@ public class PocAndUnitDto
 /// <summary>
 /// Represents a minimal data transfer object encapsulating point of consumption and unit information.
 /// </summary>
+/// <!-- aidoc:v1 sig=e2d607e -->
 public class MinimalPocAndUnitDto
 {
     public string? PocName { get; set; }
diff --git a/adas-core.Domain/Models/DTO/PointOfCareDto.cs b/adas-core.Domain/Models/DTO/PointOfCareDto.cs
index 813833b9..2eb5836d 100644
--- a/adas-core.Domain/Models/DTO/PointOfCareDto.cs
+++ b/adas-core.Domain/Models/DTO/PointOfCareDto.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object for point-of-care information, used to transfer point-of-care data between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=15d3efb -->
 public class PointOfCareDto
 {
    
@@ -38,6 +39,7 @@ public class PointOfCareDto
 /// <summary>
 /// Represents a data transfer object (DTO) for point-of-care configuration settings, used to transfer configuration data between layers or systems.
 /// </summary>
+/// <!-- aidoc:v1 sig=f9fb377 -->
 public class PointOfCareConfigurationDto
 {
     public List<LightBeacon> BeaconList { get; set; } = [];
diff --git a/adas-core.Domain/Models/DTO/PumpDto.cs b/adas-core.Domain/Models/DTO/PumpDto.cs
index 6d687521..c33094f4 100644
--- a/adas-core.Domain/Models/DTO/PumpDto.cs
+++ b/adas-core.Domain/Models/DTO/PumpDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object for conveying pump-related information between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=c1749e0 -->
 public class PumpDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/RecordingAlertDto.cs b/adas-core.Domain/Models/DTO/RecordingAlertDto.cs
index d614284f..43afdbf8 100644
--- a/adas-core.Domain/Models/DTO/RecordingAlertDto.cs
+++ b/adas-core.Domain/Models/DTO/RecordingAlertDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to convey information about a recording alert between application layers or services.
 /// </summary>
+/// <!-- aidoc:v1 sig=480bad5 -->
 public class RecordingAlertDto
 {
     public string? PatientNumber { get; set; }
diff --git a/adas-core.Domain/Models/DTO/TreatmentDto.cs b/adas-core.Domain/Models/DTO/TreatmentDto.cs
index cc3f4114..1bff0afd 100644
--- a/adas-core.Domain/Models/DTO/TreatmentDto.cs
+++ b/adas-core.Domain/Models/DTO/TreatmentDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object for conveying treatment information between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=b0dd4e4 -->
 public class TreatmentDto
 {
     public string PatientNumber { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/UnitInfoDto.cs b/adas-core.Domain/Models/DTO/UnitInfoDto.cs
index 97b13b2c..eb27ec64 100644
--- a/adas-core.Domain/Models/DTO/UnitInfoDto.cs
+++ b/adas-core.Domain/Models/DTO/UnitInfoDto.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object that encapsulates information about a unit.
 /// </summary>
+/// <!-- aidoc:v1 sig=6fcba76 -->
 public class UnitInfoDto
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/DTO/UpdateListNameAndDescriptionDto.cs b/adas-core.Domain/Models/DTO/UpdateListNameAndDescriptionDto.cs
index b458ee0d..a5e234dc 100644
--- a/adas-core.Domain/Models/DTO/UpdateListNameAndDescriptionDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateListNameAndDescriptionDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object used to update the name and description of a list.
 /// </summary>
+/// <!-- aidoc:v1 sig=8a6822d -->
 public class UpdateListNameAndDescriptionDto
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/DTO/UpdateMasterListDetailsDto.cs b/adas-core.Domain/Models/DTO/UpdateMasterListDetailsDto.cs
index e4727201..3644d119 100644
--- a/adas-core.Domain/Models/DTO/UpdateMasterListDetailsDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateMasterListDetailsDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to transfer updated master list details between application layers.
 /// </summary>
+/// <!-- aidoc:v1 sig=95ee98b -->
 public class UpdateMasterListDetailsDto
 {
     public bool? CanAddElement { get; set; }
diff --git a/adas-core.Domain/Models/DTO/UpdateObservationDto.cs b/adas-core.Domain/Models/DTO/UpdateObservationDto.cs
index 202df1d7..bf6ce024 100644
--- a/adas-core.Domain/Models/DTO/UpdateObservationDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateObservationDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to update an existing observation.
 /// </summary>
+/// <!-- aidoc:v1 sig=459b127 -->
 public class UpdateObservationDto
 {
     public ConfigObservation? OldConfigObservationItem { get; set; }
diff --git a/adas-core.Domain/Models/DTO/UpdateOptionMasterListDto.cs b/adas-core.Domain/Models/DTO/UpdateOptionMasterListDto.cs
index ee25a250..a818095a 100644
--- a/adas-core.Domain/Models/DTO/UpdateOptionMasterListDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateOptionMasterListDto.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to update an option master list.
 /// </summary>
+/// <!-- aidoc:v1 sig=459af04 -->
 public class UpdateOptionMasterListDto
 {
     public OptionList? UpdatedOption { get; set; }
diff --git a/adas-core.Domain/Models/DTO/UpdatePasswordDto.cs b/adas-core.Domain/Models/DTO/UpdatePasswordDto.cs
index da9733e1..2966d6d3 100644
--- a/adas-core.Domain/Models/DTO/UpdatePasswordDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdatePasswordDto.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data transfer object used to encapsulate the information required to update a user's password.
 /// </summary>
+/// <!-- aidoc:v1 sig=d670943 -->
 public class UpdatePasswordDto
 {
     public string OldPassword { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/DTO/UpdateUnitIdListDto.cs b/adas-core.Domain/Models/DTO/UpdateUnitIdListDto.cs
index 5e55705b..26927497 100644
--- a/adas-core.Domain/Models/DTO/UpdateUnitIdListDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateUnitIdListDto.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <summary>
 /// Represents a data transfer object used to update a list of unit identifiers.
 /// </summary>
+/// <!-- aidoc:v1 sig=c8a8700 -->
 public class UpdateUnitIdListDto
 {
     public ObjectId UnitId { get; set; }
@@ -16,6 +17,7 @@ public class UpdateUnitIdListDto
     /// Returns a string representation of the <see cref="UpdateUnitIdListDto"/> instance, including the formatted entries of its <c>MasterListData</c> collection.
     /// </summary>
     /// <returns>A string in the format <c>UpdateUnitIdListDto[...</c> containing the concatenated <c>MasterListData</c> values.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=dc5f015 -->
     public override string ToString()
         {
             List<string> items = [];
@@ -30,6 +32,7 @@ public class UpdateUnitIdListDto
 /// <summary>
 /// Represents a data container for a master list, serving as a centralized collection of items used for reference or aggregation purposes.
 /// </summary>
+/// <!-- aidoc:v1 sig=843ba2e -->
 public class MasterListData
 {
     public ObjectId? MasterListId { get; set; }
@@ -40,6 +43,7 @@ public class MasterListData
     /// Handles null values for <c>MasterListId</c> and <c>MasterListType</c> by displaying them as "Null" and "null" respectively.
     /// </summary>
     /// <returns>A formatted string containing the identifier and type of the master list.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=1e8e338 -->
     public override string ToString()
         {
             List<string> items =
diff --git a/adas-core.Domain/Models/DTO/UpdateUserWithAuthDto.cs b/adas-core.Domain/Models/DTO/UpdateUserWithAuthDto.cs
index c2d3ee60..784880ac 100644
--- a/adas-core.Domain/Models/DTO/UpdateUserWithAuthDto.cs
+++ b/adas-core.Domain/Models/DTO/UpdateUserWithAuthDto.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.DTO;
 /// <remarks>
 /// This DTO is typically used to transfer user account and authentication information in update operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8f34fab -->
 public class UpdateUserWithAuthDto
 {
     public User User { get; set; } = new();
diff --git a/adas-core.Domain/Models/Entity.cs b/adas-core.Domain/Models/Entity.cs
index 2a2a3e92..9366326e 100644
--- a/adas-core.Domain/Models/Entity.cs
+++ b/adas-core.Domain/Models/Entity.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// Serves as a foundational or domain-level type that can be extended or composed to model real-world concepts.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2708538 -->
 public class Entity
 {
     public string? EntityIdentifier { get; set; }
diff --git a/adas-core.Domain/Models/Filter/FilterOptionListElement.cs b/adas-core.Domain/Models/Filter/FilterOptionListElement.cs
index a3e683ed..933beb1e 100644
--- a/adas-core.Domain/Models/Filter/FilterOptionListElement.cs
+++ b/adas-core.Domain/Models/Filter/FilterOptionListElement.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.Filter;
 /// <summary>
 /// Represents an individual element within a filter option list, encapsulating a selectable filter value and its associated metadata.
 /// </summary>
+/// <!-- aidoc:v1 sig=ab4a49f -->
 public class FilterOptionListElement
 {
     public string? OptionType { get; set; }
diff --git a/adas-core.Domain/Models/Filter/FilteredRequest.cs b/adas-core.Domain/Models/Filter/FilteredRequest.cs
index 67025e1e..a4ba3c70 100644
--- a/adas-core.Domain/Models/Filter/FilteredRequest.cs
+++ b/adas-core.Domain/Models/Filter/FilteredRequest.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.Filter;
 /// <remarks>
 /// This type serves as a container for request data that has been narrowed or constrained by a filtering process.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a20fd1d -->
 public class FilteredRequest
 {
     #region Common region
diff --git a/adas-core.Domain/Models/Filter/PaginationFilter.cs b/adas-core.Domain/Models/Filter/PaginationFilter.cs
index e9a95492..b7da8ded 100644
--- a/adas-core.Domain/Models/Filter/PaginationFilter.cs
+++ b/adas-core.Domain/Models/Filter/PaginationFilter.cs
@@ -32,6 +32,7 @@ public record PaginationFilter
     /// Determines whether the pagination state is considered empty by checking if both <c>PageNumber</c> and <c>PageSize</c> are less than or equal to zero.
     /// </summary>
     /// <returns><c>true</c> if both <c>PageNumber</c> and <c>PageSize</c> are less than or equal to zero; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1112d99 body=9475006 -->
     public bool IsEmpty()
         {
             return PageNumber <= 0 && PageSize <= 0;
@@ -41,6 +42,7 @@ public record PaginationFilter
 /// <summary>
 /// Provides static extension methods for working with pagination filter objects.
 /// </summary>
+/// <!-- aidoc:v1 sig=62ea0cc -->
 public static class PaginationFilterExtensions
 {
     /// <summary>
@@ -49,6 +51,7 @@ public static class PaginationFilterExtensions
     /// <param name="queryable">The source <see cref="IQueryable{T}"/> to paginate.</param>
     /// <param name="filter">The pagination settings containing the page number and page size. If <c>null</c> or invalid, no pagination is applied.</param>
     /// <returns>The paginated <see cref="IQueryable{T}"/>, or the original queryable when the filter is <c>null</c> or contains invalid values.</returns>
+    /// <!-- aidoc:v1 sig=9302d94 body=6731de7 -->
     public static IQueryable<T> ApplyPagination<T>(this IQueryable<T> queryable, PaginationFilter? filter)
         {
             var modifQueryable = queryable;
diff --git a/adas-core.Domain/Models/GroupedObservation.cs b/adas-core.Domain/Models/GroupedObservation.cs
index 2b46b8b6..2ccbed3b 100644
--- a/adas-core.Domain/Models/GroupedObservation.cs
+++ b/adas-core.Domain/Models/GroupedObservation.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents an observation that belongs to or has been categorized within a logical group.
 /// </summary>
+/// <!-- aidoc:v1 sig=84e4850 -->
 public class GroupedObservation
 {
     public ObjectId PatientId { get; set; }
@@ -20,6 +21,7 @@ public class GroupedObservation
     /// Returns a string representation of the PatientObservation, including the patient's name and observations in a formatted output.
     /// </summary>
     /// <returns>A formatted string in the form "PatientObservation[name: ..., observations: ...]".</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=4730d27 -->
     public override string ToString()
         {
             List<string> items =
@@ -33,6 +35,7 @@ public class GroupedObservation
     /// <summary>
     /// Represents a grouped collection of observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c2fb2de -->
     public class GroupedObservationObs
     {
         public string Name { get; set; } = string.Empty;
@@ -71,6 +74,7 @@ public class GroupedObservation
         /// Returns a string representation of the GroupedObservationObs, including the name and any non-null statistical properties (first, last, min, max, average, sum, count, half-hour, min alert, max alert), along with the time, shift date, and optional shift.
         /// </summary>
         /// <returns>A formatted string in the form "GroupedObservationObs[name: ..., ...]" summarizing the object's relevant properties.</returns>
+        /// <!-- aidoc:v1 sig=d27f326 body=c3b1d70 -->
         public override string ToString()
                 {
                     List<string> items = [$"name: {Name}"];
@@ -96,6 +100,7 @@ public class GroupedObservation
     /// <summary>
     /// Represents an observed value within a grouped observation, pairing a value with an optional timestamp and status type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1c0a52a -->
     public class GroupedObservationObsValue(object value, DateTime? time, StatusEnum.Type type = StatusEnum.Type.Ok)
     {
         public StatusEnum.Type Type { get; set; } = type;
@@ -109,6 +114,7 @@ public class GroupedObservation
         /// Returns a formatted string representation of the object, including its value, time, and type/status fields.
         /// </summary>
         /// <returns>A string containing the value, time, and type of the object.</returns>
+        /// <!-- aidoc:v1 sig=d27f326 body=fad9e16 -->
         public override string ToString()
                 {
                     return $"value: {Value}, time: {Time}, status: {Type}";
diff --git a/adas-core.Domain/Models/GroupedObservations/Field.cs b/adas-core.Domain/Models/GroupedObservations/Field.cs
index d371980d..db3aabe5 100644
--- a/adas-core.Domain/Models/GroupedObservations/Field.cs
+++ b/adas-core.Domain/Models/GroupedObservations/Field.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// As a public class, it is accessible from any other code that can reference its containing namespace or assembly.
 /// </remarks>
+/// <!-- aidoc:v1 sig=5749bb9 -->
 public class Field
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/GroupedObservations/GroupedField.cs b/adas-core.Domain/Models/GroupedObservations/GroupedField.cs
index fc39d8b1..13116b70 100644
--- a/adas-core.Domain/Models/GroupedObservations/GroupedField.cs
+++ b/adas-core.Domain/Models/GroupedObservations/GroupedField.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.GroupedObservations;
 /// <remarks>
 /// This type is intended to model fields that are organized together as part of a group, allowing related field metadata or behavior to be handled collectively.
 /// </remarks>
+/// <!-- aidoc:v1 sig=57187d4 -->
 public class GroupedField
 {
     /// <summary>
@@ -76,6 +77,7 @@ public class GroupedField
     /// Retrieves the list of names stored in the current instance.
     /// </summary>
     /// <returns>A <see cref="List{String}"/> containing the names; returns the underlying field directly without copying or filtering.</returns>
+    /// <!-- aidoc:v1 sig=0adca4a body=371ba0c -->
     public List<string> GetNames()
         {
             return Names;
@@ -87,6 +89,7 @@ public class GroupedField
     /// </summary>
     /// <param name="obj">The object to compare with the current instance.</param>
     /// <returns><c>true</c> if the specified object is a <see cref="GroupedField"/> with the same <c>Group</c>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=dfd98b0 body=aa039d5 -->
     public override bool Equals(object? obj)
         {
             return obj is GroupedField field && Group == field.Group;
@@ -97,6 +100,7 @@ public class GroupedField
     /// This override ensures consistent hash-based behavior for equality comparisons and use in hash-based collections.
     /// </summary>
     /// <returns>An integer hash code derived from the object's key properties.</returns>
+    /// <!-- aidoc:v1 sig=eb26c4a body=fe3f69e -->
     public override int GetHashCode()
         {
             return HashCode.Combine(Name, Group, Max, Regularity, Result);
diff --git a/adas-core.Domain/Models/HistoricalLocations.cs b/adas-core.Domain/Models/HistoricalLocations.cs
index 81d0abdb..ca8d03f6 100644
--- a/adas-core.Domain/Models/HistoricalLocations.cs
+++ b/adas-core.Domain/Models/HistoricalLocations.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// Implements <see cref="IEquatable{T}"/> of <see cref="HistoricalLocation"/> to allow instances to be compared for value equality without relying on object identity.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a0e1a1a -->
 public class HistoricalLocation : IEquatable<HistoricalLocation>
 {
     // Propiedades con get y set para que MongoDB pueda escribir en ellas
@@ -16,6 +17,7 @@ public class HistoricalLocation : IEquatable<HistoricalLocation>
     /// <summary>
     /// Initializes a new instance of the <see cref="HistoricalLocation"/> class, which represents a historical record of a location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f80bd9e body=4448e1d -->
     public HistoricalLocation() { }
 
     // Tu constructor actual
@@ -38,6 +40,7 @@ public class HistoricalLocation : IEquatable<HistoricalLocation>
     /// </summary>
     /// <param name="other">The other <see cref="HistoricalLocation"/> instance to compare with this one.</param>
     /// <returns><c>true</c> if both the admission time and patient location match; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=0ff3ea9 body=152b210 -->
     public bool Equals(HistoricalLocation? other)
         {
             if (other == null) return false;
@@ -49,17 +52,20 @@ public class HistoricalLocation : IEquatable<HistoricalLocation>
     /// Determines whether this instance is considered empty by verifying that no admission time is set and that the patient location is either null or empty.
     /// </summary>
     /// <returns><see langword="true"/> when <c>AdmTime</c> has no value and <c>PatientLocation</c> is <see langword="null"/> or empty; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=4cc0edf -->
     public bool IsEmpty() => !AdmTime.HasValue && (PatientLocation == null || PatientLocation.IsEmpty());
 
     /// <summary>
     /// Determines whether the instance is in a full state by verifying that an admission time has been set, a patient location is assigned, and the assigned location is not full or empty.
     /// </summary>
     /// <returns><c>true</c> when <see cref="AdmTime"/> has a value, <see cref="PatientLocation"/> is not null, and the location is not full or empty; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=dbff41a -->
     public bool IsFull() => AdmTime.HasValue && PatientLocation != null && !PatientLocation.IsFullEmpty();
 
     /// <summary>
     /// Returns a string representation of the HistoricalLocation, including the admission time and patient location.
     /// </summary>
     /// <returns>A formatted string with the values of <c>AdmTime</c> and <c>PatientLocation</c>.</returns>
+    /// <!-- aidoc:v1 sig=cdf9f2a -->
     public override string ToString() => $"HistoricalLocation[AdmTime: {AdmTime}, PatientLocation: {PatientLocation}]";
 }
\ No newline at end of file
diff --git a/adas-core.Domain/Models/ManualRecording.cs b/adas-core.Domain/Models/ManualRecording.cs
index 401a7085..2639648d 100644
--- a/adas-core.Domain/Models/ManualRecording.cs
+++ b/adas-core.Domain/Models/ManualRecording.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a manual recording entity, typically used to capture or track recording operations initiated explicitly by a user or system.
 /// </summary>
+/// <!-- aidoc:v1 sig=9913506 -->
 public class ManualRecording
 {
     //[JsonProperty("patientId")]
@@ -20,6 +21,7 @@ public class ManualRecording
 /// <remarks>
 /// This class serves as a model or container for recording-related operations within the application.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8077681 -->
 public class MRecording
 {
     public DateTime? StartRecordingTime { get; set; }
diff --git a/adas-core.Domain/Models/Masters/AccessControlList.cs b/adas-core.Domain/Models/Masters/AccessControlList.cs
index 12d749c0..ce77f893 100644
--- a/adas-core.Domain/Models/Masters/AccessControlList.cs
+++ b/adas-core.Domain/Models/Masters/AccessControlList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// As a subclass of <see cref="MasterList"/>, it inherits the core list management capabilities while specializing them for access control scenarios.
 /// </remarks>
+/// <!-- aidoc:v1 sig=29c837b -->
 public class AccessControlList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/AllergyList.cs b/adas-core.Domain/Models/Masters/AllergyList.cs
index 8e2e7c5c..f27a087f 100644
--- a/adas-core.Domain/Models/Masters/AllergyList.cs
+++ b/adas-core.Domain/Models/Masters/AllergyList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Provides a domain-specific list type dedicated to managing and organizing allergy records.
 /// </remarks>
+/// <!-- aidoc:v1 sig=eb47795 -->
 public class AllergyList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/AltableOptionList.cs b/adas-core.Domain/Models/Masters/AltableOptionList.cs
index 473360d8..4b9d0185 100644
--- a/adas-core.Domain/Models/Masters/AltableOptionList.cs
+++ b/adas-core.Domain/Models/Masters/AltableOptionList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a list of alterable options, inheriting core list functionality from the <see cref="MasterList"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=b3c193a -->
 public class AltableOptionList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/DestinationList.cs b/adas-core.Domain/Models/Masters/DestinationList.cs
index 27f86c19..abd4b742 100644
--- a/adas-core.Domain/Models/Masters/DestinationList.cs
+++ b/adas-core.Domain/Models/Masters/DestinationList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Serves as a concrete list type within the master list hierarchy, specifically tailored for destination-related collections.
 /// </remarks>
+/// <!-- aidoc:v1 sig=4e41310 -->
 public class DestinationList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/DiagnosisList.cs b/adas-core.Domain/Models/Masters/DiagnosisList.cs
index 26731896..d770ed07 100644
--- a/adas-core.Domain/Models/Masters/DiagnosisList.cs
+++ b/adas-core.Domain/Models/Masters/DiagnosisList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a specialized list of diagnosis entries, extending the base <see cref="MasterList"/> functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=dd7c62d -->
 public class DiagnosisList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/DischargeStatusList.cs b/adas-core.Domain/Models/Masters/DischargeStatusList.cs
index 3c8f22de..560db80b 100644
--- a/adas-core.Domain/Models/Masters/DischargeStatusList.cs
+++ b/adas-core.Domain/Models/Masters/DischargeStatusList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a typed master list of discharge statuses, deriving from the base <see cref="MasterList"/> class.
 /// </summary>
+/// <!-- aidoc:v1 sig=2613a10 -->
 public class DischargeStatusList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/DoctorList.cs b/adas-core.Domain/Models/Masters/DoctorList.cs
index d1ac809f..b70faca9 100644
--- a/adas-core.Domain/Models/Masters/DoctorList.cs
+++ b/adas-core.Domain/Models/Masters/DoctorList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Serves as a specialized list type for doctor-related data, extending the shared behavior provided by <see cref="MasterList"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=dd704f3 -->
 public class DoctorList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/DoctorTypeList.cs b/adas-core.Domain/Models/Masters/DoctorTypeList.cs
index 7b82e86e..8633c1b1 100644
--- a/adas-core.Domain/Models/Masters/DoctorTypeList.cs
+++ b/adas-core.Domain/Models/Masters/DoctorTypeList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// This class serves as a specialized collection that inherits the core list behavior from <see cref="MasterList"/>, tailored for managing doctor type entries.
 /// </remarks>
+/// <!-- aidoc:v1 sig=57fade1 -->
 public class DoctorTypeList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/GenericList.cs b/adas-core.Domain/Models/Masters/GenericList.cs
index 1dba112d..2f1acd30 100644
--- a/adas-core.Domain/Models/Masters/GenericList.cs
+++ b/adas-core.Domain/Models/Masters/GenericList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a generic list type that derives from <see cref="MasterList"/>, extending the base master list functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=4545a7a -->
 public class GenericList : MasterList;
diff --git a/adas-core.Domain/Models/Masters/InsulationList.cs b/adas-core.Domain/Models/Masters/InsulationList.cs
index 9d7702e6..e0c70266 100644
--- a/adas-core.Domain/Models/Masters/InsulationList.cs
+++ b/adas-core.Domain/Models/Masters/InsulationList.cs
@@ -4,4 +4,5 @@
 /// Represents a specialized list that manages insulation-related entries within the system.
 /// Inherits from <see cref="MasterList"/>, providing a dedicated collection for organizing and handling insulation data.
 /// </summary>
+/// <!-- aidoc:v1 sig=d5823d9 -->
 public class InsulationList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/InternalDestinationList.cs b/adas-core.Domain/Models/Masters/InternalDestinationList.cs
index 4127b378..0d169b66 100644
--- a/adas-core.Domain/Models/Masters/InternalDestinationList.cs
+++ b/adas-core.Domain/Models/Masters/InternalDestinationList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// This type specializes the <see cref="MasterList"/> behavior for internal destination handling within the containing system.
 /// </remarks>
+/// <!-- aidoc:v1 sig=035de24 -->
 public class InternalDestinationList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/LanguageBarrierList.cs b/adas-core.Domain/Models/Masters/LanguageBarrierList.cs
index 8f6c6305..bf5ea26e 100644
--- a/adas-core.Domain/Models/Masters/LanguageBarrierList.cs
+++ b/adas-core.Domain/Models/Masters/LanguageBarrierList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Inherits from <see cref="MasterList"/>, extending its functionality for handling language barrier data.
 /// </remarks>
+/// <!-- aidoc:v1 sig=203408f -->
 public class LanguageBarrierList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/MasterList.cs b/adas-core.Domain/Models/Masters/MasterList.cs
index 96fca9b8..a63a108b 100644
--- a/adas-core.Domain/Models/Masters/MasterList.cs
+++ b/adas-core.Domain/Models/Masters/MasterList.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.Masters;
 /// <remarks>
 /// This class provides a foundational structure for organizing and accessing a primary list of entries.
 /// </remarks>
+/// <!-- aidoc:v1 sig=7e547fa -->
 public class MasterList
 {
     public ObjectId Id { get; set; }
@@ -99,6 +100,7 @@ public class MasterList
 /// <remarks>
 /// This type is intended to encapsulate the metadata or structure associated with an option list, allowing consumers to access its detailed content in a structured manner.
 /// </remarks>
+/// <!-- aidoc:v1 sig=64e9c68 -->
 public class OptionListDetails
 {
     public Element? OptionType { get; set; }
@@ -114,6 +116,7 @@ public class OptionListDetails
 /// <summary>
 /// Represents a generic element within the system, serving as a foundational type that can be extended or composed to model domain-specific entities or structures.
 /// </summary>
+/// <!-- aidoc:v1 sig=5a233de -->
 public class Element
 {
     public string Title { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/Masters/MobilityOptionList.cs b/adas-core.Domain/Models/Masters/MobilityOptionList.cs
index 8d6b979d..20690149 100644
--- a/adas-core.Domain/Models/Masters/MobilityOptionList.cs
+++ b/adas-core.Domain/Models/Masters/MobilityOptionList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Inherits from <see cref="MasterList"/>, leveraging the base class's list management functionality specialized for mobility options.
 /// </remarks>
+/// <!-- aidoc:v1 sig=86787d7 -->
 public class MobilityOptionList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/OptionList.cs b/adas-core.Domain/Models/Masters/OptionList.cs
index 3bc2c1d1..b061ec13 100644
--- a/adas-core.Domain/Models/Masters/OptionList.cs
+++ b/adas-core.Domain/Models/Masters/OptionList.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.Masters;
 /// <summary>
 /// Represents a list that contains a collection of options.
 /// </summary>
+/// <!-- aidoc:v1 sig=457ff9d -->
 public class OptionList
 {
     public ObjectId? Id { get; set; }
@@ -27,6 +28,7 @@ public class OptionList
     /// <param name="a">The first <see cref="OptionList"/> to compare.</param>
     /// <param name="b">The second <see cref="OptionList"/> to compare.</param>
     /// <returns><c>true</c> if all compared properties of both <see cref="OptionList"/> instances are equal; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=0ffd91d body=252c4b1 -->
     public bool AreEqual(OptionList a, OptionList b)
         {
             return a.OptionType == b.OptionType &&
@@ -48,6 +50,7 @@ public class OptionList
     /// <param name="a">The first <see cref="OptionList"/> to compare.</param>
     /// <param name="b">The second <see cref="OptionList"/> to compare.</param>
     /// <returns><c>true</c> if both option lists match across OptionType, Name, IconDefault, IconCategory, IconColor, Color, BgColor, IsDefault, InitDate, and EndDate; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=55a14e4 body=3b3e773 -->
     public bool AreEqualExcludeDescription(OptionList a, OptionList b)
         {
             return a.OptionType == b.OptionType &&
@@ -66,6 +69,7 @@ public class OptionList
 /// <summary>
 /// Represents a locale, providing culture-specific or region-specific information such as language, country, or regional settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=87ff1ad -->
 public class Locale
 {
     public LocaleItem? Es { get; set; }
@@ -78,6 +82,7 @@ public class Locale
 /// <summary>
 /// Represents a single locale item, typically used to encapsulate locale-related data such as language or regional settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=e73342d -->
 public class LocaleItem
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/Masters/OriginList.cs b/adas-core.Domain/Models/Masters/OriginList.cs
index c183fe24..bfff231c 100644
--- a/adas-core.Domain/Models/Masters/OriginList.cs
+++ b/adas-core.Domain/Models/Masters/OriginList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// This class specializes the base <see cref="MasterList"/> behavior for managing a collection of origin items.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8c6c8bc -->
 public class OriginList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/PassiveSittingList.cs b/adas-core.Domain/Models/Masters/PassiveSittingList.cs
index 0277e382..3566e6d3 100644
--- a/adas-core.Domain/Models/Masters/PassiveSittingList.cs
+++ b/adas-core.Domain/Models/Masters/PassiveSittingList.cs
@@ -3,4 +3,5 @@ namespace adas_core.Domain.Models.Masters;
 /// <summary>
 /// Represents a specialized master list containing passive sitting entries, inheriting from the <see cref="MasterList"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=6769c7b -->
 public class PassiveSittingList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/PatientStatusList.cs b/adas-core.Domain/Models/Masters/PatientStatusList.cs
index 8f1b814c..52411af1 100644
--- a/adas-core.Domain/Models/Masters/PatientStatusList.cs
+++ b/adas-core.Domain/Models/Masters/PatientStatusList.cs
@@ -4,4 +4,5 @@
 /// Represents a master list of patient status entries, providing a centralized
 /// collection for managing and accessing patient status data.
 /// </summary>
+/// <!-- aidoc:v1 sig=a6afcbd -->
 public class PatientStatusList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/ProcedureList.cs b/adas-core.Domain/Models/Masters/ProcedureList.cs
index 64121e7b..274b0e9e 100644
--- a/adas-core.Domain/Models/Masters/ProcedureList.cs
+++ b/adas-core.Domain/Models/Masters/ProcedureList.cs
@@ -4,4 +4,5 @@
 /// Represents a list of procedures, inheriting from <see cref="MasterList"/> to provide procedure-specific list functionality.
 /// Serves as a specialized master list dedicated to managing procedure entries.
 /// </summary>
+/// <!-- aidoc:v1 sig=09e9015 -->
 public class ProcedureList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/ServiceList.cs b/adas-core.Domain/Models/Masters/ServiceList.cs
index 672f81db..97959776 100644
--- a/adas-core.Domain/Models/Masters/ServiceList.cs
+++ b/adas-core.Domain/Models/Masters/ServiceList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a specialized list that inherits from <see cref="MasterList"/>, intended to manage and organize service-related entries.
 /// </summary>
+/// <!-- aidoc:v1 sig=93975da -->
 public class ServiceList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/TestList.cs b/adas-core.Domain/Models/Masters/TestList.cs
index 45690a0d..0612166b 100644
--- a/adas-core.Domain/Models/Masters/TestList.cs
+++ b/adas-core.Domain/Models/Masters/TestList.cs
@@ -3,4 +3,5 @@ namespace adas_core.Domain.Models.Masters;
 /// <summary>
 /// Represents a test list that derives from the <see cref="MasterList"/> base class, providing specialized list behavior for testing scenarios.
 /// </summary>
+/// <!-- aidoc:v1 sig=f64564c -->
 public class TestList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/TherapeuticCeilingList.cs b/adas-core.Domain/Models/Masters/TherapeuticCeilingList.cs
index 1cd1caed..c0286b79 100644
--- a/adas-core.Domain/Models/Masters/TherapeuticCeilingList.cs
+++ b/adas-core.Domain/Models/Masters/TherapeuticCeilingList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Inherits from <see cref="MasterList"/>, leveraging the base list functionality to manage and organize therapeutic ceiling entries.
 /// </remarks>
+/// <!-- aidoc:v1 sig=cc88fb5 -->
 public class TherapeuticCeilingList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/TreatmentList.cs b/adas-core.Domain/Models/Masters/TreatmentList.cs
index 7742954c..3ed35e00 100644
--- a/adas-core.Domain/Models/Masters/TreatmentList.cs
+++ b/adas-core.Domain/Models/Masters/TreatmentList.cs
@@ -6,4 +6,5 @@
 /// <remarks>
 /// Acts as a domain-specific collection type for organizing and managing treatments within the system.
 /// </remarks>
+/// <!-- aidoc:v1 sig=0ea71df -->
 public class TreatmentList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Masters/VisitOptionList.cs b/adas-core.Domain/Models/Masters/VisitOptionList.cs
index 4c640db0..6057a8d8 100644
--- a/adas-core.Domain/Models/Masters/VisitOptionList.cs
+++ b/adas-core.Domain/Models/Masters/VisitOptionList.cs
@@ -3,4 +3,5 @@
 /// <summary>
 /// Represents a list of visit options, inheriting from the <see cref="MasterList"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=27c1d62 -->
 public class VisitOptionList : MasterList;
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Medicine.cs b/adas-core.Domain/Models/Medicine.cs
index 9cc9aee9..74eac375 100644
--- a/adas-core.Domain/Models/Medicine.cs
+++ b/adas-core.Domain/Models/Medicine.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents a medicine entity within the domain model.
 /// </summary>
+/// <!-- aidoc:v1 sig=86593e9 -->
 public class Medicine
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Admission.cs b/adas-core.Domain/Models/MongoModels/Admission.cs
index 64d507e3..422146fd 100644
--- a/adas-core.Domain/Models/MongoModels/Admission.cs
+++ b/adas-core.Domain/Models/MongoModels/Admission.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents an admission, typically encapsulating data and behavior related to the process of admitting an entity, such as a student or patient, into an institution or system.
 /// </summary>
+/// <!-- aidoc:v1 sig=f89b3f0 -->
 public class Admission
 {
     public ObjectId Id { get; set; }
@@ -36,6 +37,8 @@ public class Admission
     /// Returns a human-readable string representation of the Admission, conditionally including NHC, Person, Admission Date, location, Origin, Diagnosis, and any associated Allergies only when they are present.
     /// </summary>
     /// <returns>A formatted string in the form "Admission [...]" summarizing the Admission's key properties.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary states Admission Date is conditionally included, but it is always added to the output." -->
     public override string ToString()
         {
             List<string> items = [];
diff --git a/adas-core.Domain/Models/MongoModels/AlarmConfig.cs b/adas-core.Domain/Models/MongoModels/AlarmConfig.cs
index 41934d21..20141616 100644
--- a/adas-core.Domain/Models/MongoModels/AlarmConfig.cs
+++ b/adas-core.Domain/Models/MongoModels/AlarmConfig.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents the configuration settings for an alarm.
 /// </summary>
+/// <!-- aidoc:v1 sig=0091df6 -->
 public class AlarmConfig
 {
     public string? Name { get; set; }
@@ -21,6 +22,7 @@ public class AlarmConfig
 /// <summary>
 /// Represents the configuration settings for audio processing or playback.
 /// </summary>
+/// <!-- aidoc:v1 sig=a6df86e -->
 public class AudioConfig
 {
     public AlarmEnum.AudioAlarmType Type { get; set; } = AlarmEnum.AudioAlarmType.Off;
diff --git a/adas-core.Domain/Models/MongoModels/AlarmItem.cs b/adas-core.Domain/Models/MongoModels/AlarmItem.cs
index 40a5b414..61b4b1ba 100644
--- a/adas-core.Domain/Models/MongoModels/AlarmItem.cs
+++ b/adas-core.Domain/Models/MongoModels/AlarmItem.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents an alarm item entity.
 /// </summary>
+/// <!-- aidoc:v1 sig=8ad7aa4 -->
 public class AlarmItem
 {
     public bool Enabled { get; set; }
@@ -28,6 +29,7 @@ public class AlarmItem
     /// Returns a formatted string representation of the <see cref="AlarmItem"/>, including the Enabled, StartBefore, EndAfter, Severity, and BeaconColor values, and optionally appending the Color value when it is not null or empty.
     /// </summary>
     /// <returns>A string in the format "AlarmItem[item1, item2, ...]" containing the key properties of the alarm item.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=bf483de -->
     public override string ToString()
         {
             List<string> items =
diff --git a/adas-core.Domain/Models/MongoModels/Authorizations.cs b/adas-core.Domain/Models/MongoModels/Authorizations.cs
index 5f8c4094..8af3c623 100644
--- a/adas-core.Domain/Models/MongoModels/Authorizations.cs
+++ b/adas-core.Domain/Models/MongoModels/Authorizations.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents an authorization mechanism that determines whether a principal is granted access to a protected resource or operation.
 /// </summary>
+/// <!-- aidoc:v1 sig=068aec6 -->
 public class Authorization
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Box.cs b/adas-core.Domain/Models/MongoModels/Box.cs
index e87c245c..af2df829 100644
--- a/adas-core.Domain/Models/MongoModels/Box.cs
+++ b/adas-core.Domain/Models/MongoModels/Box.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// Represents a patient box (clinical display unit) that aggregates patient data,
 /// observations, medications, and display configuration for a specific point of care.
 /// </summary>
+/// <!-- aidoc:v1 sig=444196a -->
 public class Box
 {
     public Person? AttendingDoctor;
diff --git a/adas-core.Domain/Models/MongoModels/Camera.cs b/adas-core.Domain/Models/MongoModels/Camera.cs
index 4ee94c06..8464bdf3 100644
--- a/adas-core.Domain/Models/MongoModels/Camera.cs
+++ b/adas-core.Domain/Models/MongoModels/Camera.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a camera, typically used to capture or render visual content in a scene or application.
 /// </summary>
+/// <!-- aidoc:v1 sig=0330244 -->
 public class Camera
 {
     public ObjectId Id { get; set; }
@@ -27,6 +28,7 @@ public class Camera
 /// <summary>
 /// Represents a sequence of bytes that can be read from or written to.
 /// </summary>
+/// <!-- aidoc:v1 sig=cfa31eb -->
 public class Stream
 {
     public string? Rtsp { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/ConfigObservation.cs b/adas-core.Domain/Models/MongoModels/ConfigObservation.cs
index 9470fa16..876af519 100644
--- a/adas-core.Domain/Models/MongoModels/ConfigObservation.cs
+++ b/adas-core.Domain/Models/MongoModels/ConfigObservation.cs
@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This type is intended to capture configuration-related observation data within the application.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8a2fa80 -->
 public class ConfigObservation
 {
     public Dictionary<string, ConfigObservation>? Grouped;
@@ -86,6 +87,7 @@ public class ConfigObservation
     /// human-readable serialization.
     /// </summary>
     /// <returns>A string containing the JSON-serialized representation of the object with indented formatting.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=4278a22 -->
     public override string ToString()
         {
             return JsonConvert.SerializeObject(this, Formatting.Indented);
@@ -94,6 +96,7 @@ public class ConfigObservation
     /// <summary>
     /// Represents a range of colors, typically used to define a spectrum or gradient between a start and end color.
     /// </summary>
+    /// <!-- aidoc:v1 sig=37974e8 -->
     public class ColorRange
     {
         public ObservationEnum.ValueType? ValueType;
@@ -121,6 +124,7 @@ public class ConfigObservation
 /// <summary>
 /// Represents a configuration class that holds settings for demonstration purposes.
 /// </summary>
+/// <!-- aidoc:v1 sig=9784dc4 -->
 public class DemoConfig
 {
     public int? MaxValue { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/ConfigPumps.cs b/adas-core.Domain/Models/MongoModels/ConfigPumps.cs
index 53e89a56..0e37cd3f 100644
--- a/adas-core.Domain/Models/MongoModels/ConfigPumps.cs
+++ b/adas-core.Domain/Models/MongoModels/ConfigPumps.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// Used to manage and access configuration parameters specific to pump operations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2da7898 -->
 public class ConfigPumps
 {
     public string Id { get; set; } = string.Empty;
@@ -20,6 +21,7 @@ public class ConfigPumps
 /// <summary>
 /// Represents a configuration item related to a pump, encapsulating its settings or state data.
 /// </summary>
+/// <!-- aidoc:v1 sig=d499c2b -->
 public class ConfigPumpItem
 {
     public PumpEnum.AlarmType? AlarmType { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/ConfigUnits.cs b/adas-core.Domain/Models/MongoModels/ConfigUnits.cs
index bf78e5a3..3d25fe6f 100644
--- a/adas-core.Domain/Models/MongoModels/ConfigUnits.cs
+++ b/adas-core.Domain/Models/MongoModels/ConfigUnits.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a configuration container for unit definitions, providing centralized access to unit-related settings and metadata.
 /// </summary>
+/// <!-- aidoc:v1 sig=2dd8a90 -->
 public class ConfigUnits
 {
     public string Id { get; set; } = string.Empty;
@@ -13,6 +14,7 @@ public class ConfigUnits
 /// <summary>
 /// Represents a single configuration unit item, serving as a data model for storing and managing individual configuration entries.
 /// </summary>
+/// <!-- aidoc:v1 sig=32cd1c6 -->
 public class ConfigUnitItem
 {
     public string? Code { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Device.cs b/adas-core.Domain/Models/MongoModels/Device.cs
index 650dbbe2..63fd78fc 100644
--- a/adas-core.Domain/Models/MongoModels/Device.cs
+++ b/adas-core.Domain/Models/MongoModels/Device.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a device entity within the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=59faaff -->
 public class Device
 {
     public ObjectId Id { get; set; }
@@ -28,6 +29,7 @@ public class Device
 /// <summary>
 /// Represents the configuration settings for a device.
 /// </summary>
+/// <!-- aidoc:v1 sig=7e33f30 -->
 public class DeviceSettings
 {
     public DeviceAction? Action { get; set; }
@@ -35,6 +37,7 @@ public class DeviceSettings
 /// <summary>
 /// Represents an action that can be performed on or by a device.
 /// </summary>
+/// <!-- aidoc:v1 sig=c894f50 -->
 public class DeviceAction
 {
     public DeviceActionType Type { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Discharge.cs b/adas-core.Domain/Models/MongoModels/Discharge.cs
index ef07c1d9..2e73db50 100644
--- a/adas-core.Domain/Models/MongoModels/Discharge.cs
+++ b/adas-core.Domain/Models/MongoModels/Discharge.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a discharge, typically referring to the release or emission of a substance, energy, or a patient leaving a medical facility.
 /// </summary>
+/// <!-- aidoc:v1 sig=afee042 -->
 public class Discharge
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Display.cs b/adas-core.Domain/Models/MongoModels/Display.cs
index 8b5398bd..1d2e0d50 100644
--- a/adas-core.Domain/Models/MongoModels/Display.cs
+++ b/adas-core.Domain/Models/MongoModels/Display.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a display used to present or output information to the user.
 /// </summary>
+/// <!-- aidoc:v1 sig=3c7b634 -->
 public class Display
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/DisplayCardConfig.cs b/adas-core.Domain/Models/MongoModels/DisplayCardConfig.cs
index 04865f6c..613c2deb 100644
--- a/adas-core.Domain/Models/MongoModels/DisplayCardConfig.cs
+++ b/adas-core.Domain/Models/MongoModels/DisplayCardConfig.cs
@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class is intended to be used as a data container or settings holder for card-related configurations.
 /// </remarks>
+/// <!-- aidoc:v1 sig=03cda1e -->
 public class CardConfig
 {
     public ObjectId Id { get; set; }
@@ -23,6 +24,7 @@ public class CardConfig
 /// <remarks>
 /// This type is intended to be used as a data container to define the visual or behavioral properties of a row card.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c6be0d4 -->
 public class RowCardConfig
 {
     // Dynamic cells de nurse y Dynamic Obs de monitoring
@@ -47,6 +49,7 @@ public class RowCardConfig
 /// <summary>
 /// Represents a single cell, typically used as an individual unit within a larger structured data model such as a grid, table, or matrix.
 /// </summary>
+/// <!-- aidoc:v1 sig=f829831 -->
 public class Cell
 {
     public ChartSettings? ChartSettings { get; set; }
@@ -96,6 +99,7 @@ public class Cell
 /// <summary>
 /// Represents the configuration settings used to control the appearance and behavior of a chart.
 /// </summary>
+/// <!-- aidoc:v1 sig=f930ff3 -->
 public class ChartSettings
 {
     public LegendLayoutConfig? LegendLayoutConfig { get; set; }
@@ -106,6 +110,7 @@ public class ChartSettings
 /// <summary>
 /// Represents configuration settings for a dialog, providing a centralized structure to manage dialog-related options and parameters.
 /// </summary>
+/// <!-- aidoc:v1 sig=a54c110 -->
 public class DialogConfig
 {
     public bool? IsDraggable { get; set; }
@@ -118,6 +123,7 @@ public class DialogConfig
 /// <remarks>
 /// Serves as a container for medical configuration data, providing a centralized structure to manage and access medical settings within the application.
 /// </remarks>
+/// <!-- aidoc:v1 sig=90344c2 -->
 public class MedicalConfig
 {
     public bool HasFinalizeTime { get; set; }
@@ -127,6 +133,7 @@ public class MedicalConfig
 /// <summary>
 /// Represents a list of icon values, providing a collection structure for managing and accessing icon-related data.
 /// </summary>
+/// <!-- aidoc:v1 sig=8813035 -->
 public class IconValueList
 {
     public double? MinValue { get; set; }
@@ -139,6 +146,7 @@ public class IconValueList
 /// <summary>
 /// Represents the configuration settings for the home page or home component.
 /// </summary>
+/// <!-- aidoc:v1 sig=016eb54 -->
 public class HomeConfig
 {
     public string? MinColumnSize { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/DisplayCardDetailConfig.cs b/adas-core.Domain/Models/MongoModels/DisplayCardDetailConfig.cs
index 0939130c..028f9791 100644
--- a/adas-core.Domain/Models/MongoModels/DisplayCardDetailConfig.cs
+++ b/adas-core.Domain/Models/MongoModels/DisplayCardDetailConfig.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents the configuration settings for card details.
 /// </summary>
+/// <!-- aidoc:v1 sig=f4c2536 -->
 public class CardDetailsConfig
 {
     public ObjectId Id { get; set; }
@@ -19,6 +20,7 @@ public class CardDetailsConfig
 /// <summary>
 /// Represents configuration settings for row details, typically used to control the display and behavior of expandable detail rows.
 /// </summary>
+/// <!-- aidoc:v1 sig=e4c173a -->
 public class RowDetailsConfig
 {
     // Dynamic cells de nurse y Dynamic Obs de monitoring
@@ -33,6 +35,7 @@ public class RowDetailsConfig
 /// <summary>
 /// Represents a container for detailed information about an individual cell.
 /// </summary>
+/// <!-- aidoc:v1 sig=52acd82 -->
 public class CellDetails
 {
     public List<ObservationTextRule>? TextRules { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/DisplayConfig.cs b/adas-core.Domain/Models/MongoModels/DisplayConfig.cs
index 45394c90..d7f23554 100644
--- a/adas-core.Domain/Models/MongoModels/DisplayConfig.cs
+++ b/adas-core.Domain/Models/MongoModels/DisplayConfig.cs
@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class encapsulates the configuration data used to manage display-related properties and behavior.
 /// </remarks>
+/// <!-- aidoc:v1 sig=f899910 -->
 public class DisplayConfig
 {
     public ObjectId Id { get; set; }
@@ -62,6 +63,8 @@ public class DisplayConfig
     /// </summary>
     /// <param name="defaultConfig">The default configuration to use as a fallback when the current configuration properties are null or empty.</param>
     /// <returns>The current <see cref="DisplayConfig"/> instance with merged configuration values.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Documentation claims collection properties are replaced when 'null or empty', but the checks use `?.Count == 0` (which evaluates to false when the collection is null, so null collections are NOT replaced) and FieldList uses `.Count == 0` without `?.`, which would throw NullReferenceException if null. In practice, collections are only replaced when empty." -->
     public virtual DisplayConfig MergeConfig(DisplayConfig defaultConfig)
         {
             // CardConfig ??= defaultConfig.CardConfig; 
@@ -85,6 +88,7 @@ public class DisplayConfig
 /// <summary>
 /// Represents a standard display configuration, extending the base <see cref="DisplayConfig"/> class to provide default display settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=65fefbe -->
 public class StandarDisplay : DisplayConfig
 {
     public SectionConfig? SectionConfig { get; set; }
@@ -94,6 +98,7 @@ public class StandarDisplay : DisplayConfig
     /// </summary>
     /// <param name="defaultConfig">The default display configuration to merge from. Only values from a <see cref="StandarDisplay"/> instance are applied.</param>
     /// <returns>The merged <see cref="DisplayConfig"/>, or the current instance if the provided configuration is not a <see cref="StandarDisplay"/>.</returns>
+    /// <!-- aidoc:v1 sig=b33236e body=5690a8c -->
     public override DisplayConfig MergeConfig(DisplayConfig defaultConfig)
         {
             if (defaultConfig is not StandarDisplay defaultStandarConfig)
@@ -108,6 +113,7 @@ public class StandarDisplay : DisplayConfig
 /// <summary>
 /// Represents a display configuration specific to nurses, inheriting common display behavior from the <see cref="DisplayConfig"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=2caf10d -->
 public class DisplayNurse : DisplayConfig
 {
     /// <summary>
@@ -115,6 +121,8 @@ public class DisplayNurse : DisplayConfig
     /// </summary>
     /// <param name="defaultConfig">The default DisplayConfig to merge values from. Only DisplayNurse instances contribute fallback values for nurse-specific settings.</param>
     /// <returns>A DisplayConfig containing the merged configuration.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states that when defaultConfig is not a DisplayNurse instance, 'the current configuration is returned unchanged before delegating to the base merge behavior.' In the code, it returns this immediately without calling base.MergeConfig; the base merge is only invoked when defaultConfig IS a DisplayNurse." -->
     public override DisplayConfig MergeConfig(DisplayConfig defaultConfig)
         {
             if (defaultConfig is not DisplayNurse defaultNurseConfig) return this;
@@ -131,6 +139,7 @@ public class DisplayNurse : DisplayConfig
 /// <remarks>
 /// Inherits from <see cref="DisplayConfig"/>, extending its general display configuration behavior with pump-specific context.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c412ac8 -->
 public class PumpDisplay : DisplayConfig
 {
     /// <summary>
@@ -138,6 +147,7 @@ public class PumpDisplay : DisplayConfig
     /// </summary>
     /// <param name="config">The display configuration to merge from. Only <see cref="PumpDisplay"/> instances are processed; any other type results in the current instance being returned as-is.</param>
     /// <returns>The merged <see cref="DisplayConfig"/> result produced by chaining the base merge operation.</returns>
+    /// <!-- aidoc:v1 sig=a725218 body=9a89afd -->
     public override DisplayConfig MergeConfig(DisplayConfig config)
         {
             if (config is not PumpDisplay defaultConfig) return this;
@@ -159,6 +169,7 @@ public class PumpDisplay : DisplayConfig
 /// <summary>
 /// Represents a smart display configuration that extends the base <see cref="DisplayConfig"/> behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=9d6032d -->
 public class SmartDisplay : DisplayConfig
 {
     /// <summary>
@@ -166,6 +177,8 @@ public class SmartDisplay : DisplayConfig
     /// </summary>
     /// <param name="defaultConfigToCast">The default <see cref="DisplayConfig"/> to merge; it is cast to <see cref="SmartDisplay"/> to access smart display-specific properties.</param>
     /// <returns>The merged <see cref="DisplayConfig"/> produced by the base merge operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states that when the configuration is not a SmartDisplay, 'the current instance is returned unchanged and the merge is delegated to the base implementation', but the code returns early via `return this;` and never calls `base.MergeConfig(defaultConfig)` in that branch." -->
     public override DisplayConfig MergeConfig(DisplayConfig defaultConfigToCast)
         {
             if (defaultConfigToCast is not SmartDisplay defaultConfig) return this;
@@ -216,6 +229,7 @@ public class SmartDisplay : DisplayConfig
     /// <param name="value1">The first value to compare.</param>
     /// <param name="value2">The second value to compare.</param>
     /// <returns><c>true</c> if both values are null, deeply equal as enumerables, equal via <see cref="object.Equals(object, object)"/> when their types match, or have matching string representations; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d71a534 body=38b9696 -->
     private static bool AreEqual(object? value1, object? value2)
         {
             if (value1 == null && value2 == null) return true;
@@ -251,6 +265,7 @@ public class SmartDisplay : DisplayConfig
 /// <summary>
 /// Represents a configuration class for defining header-related settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=3510dc0 -->
 public class HeaderConfig
 {
     public HeaderItem? PartnerLogo { get; set; }
@@ -280,6 +295,7 @@ public class HeaderConfig
     /// <summary>
     /// Represents a single item contained within a header.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8f11d42 -->
     public class HeaderItem
     {
         public string? LogoUrl { get; set; }
@@ -290,6 +306,7 @@ public class HeaderConfig
 /// <summary>
 /// Represents a display section that provides a minimal rendering configuration.
 /// </summary>
+/// <!-- aidoc:v1 sig=5dcd648 -->
 public class MinimalDisplaySection
 {
     public string? Name { get; set; }
@@ -299,6 +316,7 @@ public class MinimalDisplaySection
 /// <summary>
 /// Represents the configuration settings for a section.
 /// </summary>
+/// <!-- aidoc:v1 sig=ea9c3f4 -->
 public class SectionConfig
 {
     public int? Columns { get; set; }
@@ -311,6 +329,7 @@ public class SectionConfig
 /// <summary>
 /// Represents a banner item, typically used to encapsulate data related to a banner display element such as a notification, advertisement, or promotional content.
 /// </summary>
+/// <!-- aidoc:v1 sig=1bd3f1b -->
 public class BannerItem
 {
     public DisplayConfigEnums.BannerType? Type { get; set; }
@@ -324,6 +343,7 @@ public class BannerItem
 /// <remarks>
 /// This class is used to store and manage configuration data related to individual banner items within the application.
 /// </remarks>
+/// <!-- aidoc:v1 sig=f9294dd -->
 public class BannerItemConfig
 {
     public BannerItemTableConfig? BannerItemTableConfig { get; set; }
@@ -334,6 +354,7 @@ public class BannerItemConfig
 /// <summary>
 /// Represents the configuration settings for a banner item table.
 /// </summary>
+/// <!-- aidoc:v1 sig=3ff0b95 -->
 public class BannerItemTableConfig
 {
     public List<HeaderBannerItemTableConfig>? Config { get; set; }
@@ -344,6 +365,7 @@ public class BannerItemTableConfig
 /// <summary>
 /// Represents the configuration settings for medical staff.
 /// </summary>
+/// <!-- aidoc:v1 sig=e9bae08 -->
 public class MedicalStaffConfig
 {
     public bool? HasTeams { get; set; }
@@ -353,6 +375,7 @@ public class MedicalStaffConfig
 /// <summary>
 /// Represents an overview of form items, providing a consolidated view or summary of form-related data.
 /// </summary>
+/// <!-- aidoc:v1 sig=832554b -->
 public class FormItemOverview
 {
     public bool Nhc { get; set; }
@@ -383,6 +406,7 @@ public class FormItemOverview
 /// <summary>
 /// Represents the configuration settings for a table that displays header banner items.
 /// </summary>
+/// <!-- aidoc:v1 sig=3f13f61 -->
 public class HeaderBannerItemTableConfig
 {
     public DisplayConfigEnums.CellType? Type { get; set; }
@@ -398,6 +422,7 @@ public class HeaderBannerItemTableConfig
 /// <summary>
 /// Represents a sensor, which is a device or component used to detect and measure physical phenomena such as temperature, pressure, or motion.
 /// </summary>
+/// <!-- aidoc:v1 sig=ab8bd33 -->
 public class Sensor
 {
     public string? Name { get; set; }
@@ -409,6 +434,7 @@ public class Sensor
 /// <summary>
 /// Represents a configuration that defines color-related settings or values.
 /// </summary>
+/// <!-- aidoc:v1 sig=de4e5be -->
 public class ColorConfig
 {
     public LevelColors? Level { get; set; }
@@ -461,6 +487,7 @@ public class ColorConfig
     /// <summary>
     /// Represents configuration settings that define the visual appearance of an application or user interface element.
     /// </summary>
+    /// <!-- aidoc:v1 sig=070355d -->
     public class AppearanceSettings
     {
         public string? TextColor { get; set; }
@@ -502,6 +529,7 @@ public class ColorConfig
     /// <summary>
     /// Represents the set of colors used to display numbers within a status box.
     /// </summary>
+    /// <!-- aidoc:v1 sig=41d803c -->
     public class StatusBoxNumberColors
     {
         public AppearanceSettings? Reserved { get; set; }
@@ -543,6 +571,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a collection of colors used for therapy-related visuals or themes.
     /// </summary>
+    /// <!-- aidoc:v1 sig=550c282 -->
     public class TherapyColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -577,6 +606,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a test class for color-related operations or values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b0381d4 -->
     public class TestColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -612,6 +642,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a set of colors used to define or customize the appearance of a procedure.
     /// </summary>
+    /// <!-- aidoc:v1 sig=676d773 -->
     public class ProcedureColors
     {
         public AppearanceSettings? Default { get; set; }
@@ -647,6 +678,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a collection or definition of colors associated with different levels.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f693cfc -->
     public class LevelColors
     {
         public string? Level1 { get; set; }
@@ -685,6 +717,7 @@ public class ColorConfig
     /// <summary>
     /// Provides a collection of predefined color values used for styling or rendering text.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d12f899 -->
     public class TextColors
     {
         public string? Normal { get; set; }
@@ -723,6 +756,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a collection or definition of colors used for rendering arrows.
     /// </summary>
+    /// <!-- aidoc:v1 sig=abbea19 -->
     public class ArrowColors
     {
         public string? Normal { get; set; }
@@ -758,6 +792,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a collection or definition of colors used for indicators.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5c596cd -->
     public class IndicatorColors
     {
         public string? Empty { get; set; }
@@ -799,6 +834,7 @@ public class ColorConfig
     /// <summary>
     /// Represents a collection or definition of colors used for rendering graphs.
     /// </summary>
+    /// <!-- aidoc:v1 sig=83d1667 -->
     public class GraphColors
     {
         public string? Normal { get; set; }
@@ -835,6 +871,7 @@ public class ColorConfig
 /// <remarks>
 /// This class encapsulates the configuration data required to define or manage form-related properties.
 /// </remarks>
+/// <!-- aidoc:v1 sig=68452e9 -->
 public class FormConfig
 {
     public FormItemOverview? Admission { get; set; }
@@ -849,6 +886,7 @@ public class FormConfig
 /// <summary>
 /// Represents a label associated with an axis, typically used in charting or graphing scenarios to describe or identify the axis.
 /// </summary>
+/// <!-- aidoc:v1 sig=8bf0d61 -->
 public class AxisLabel
 {
     public bool? Show { get; set; }
@@ -868,6 +906,10 @@ public class AxisLabel
 /// Represents a line associated with an axis, typically used to render or define the visual structure of an axis in a chart or graph.
 /// </summary>
 /// <!-- aidoc:v1 sig=5e39639 -->
+/// <summary>
+/// Represents an axis line, typically used to model a line associated with a coordinate axis.
+/// </summary>
+/// <!-- aidoc:v1 sig=5e39639 -->
 public class AxisLineStyle
 {
     public string? Color { get; set; }
@@ -882,6 +924,7 @@ public class AxisLine
 /// <summary>
 /// Represents a single tick mark on an axis, typically used in charting or graphing scenarios.
 /// </summary>
+/// <!-- aidoc:v1 sig=51bf334 -->
 public class AxisTick
 {
     public bool? Show { get; set; }
@@ -893,6 +936,7 @@ public class AxisTick
 /// <summary>
 /// Represents the configuration settings for a chart, defining its visual and behavioral properties.
 /// </summary>
+/// <!-- aidoc:v1 sig=16a7db6 -->
 public class ChartConfig
 {
     public ObjectId Id { get; set; }
@@ -910,6 +954,7 @@ public class ChartConfig
 /// Serves as the base class for configuration types that define settings for a series.
 /// Provides a common foundation for derived series configuration implementations.
 /// </summary>
+/// <!-- aidoc:v1 sig=c855a1e -->
 public class SeriesConfigBase
 {
     public string? Key { get; set; }
@@ -954,6 +999,7 @@ public class SeriesConfigBase
 /// <summary>
 /// Represents a visual mapping that handles the rendering or display logic for map-related data.
 /// </summary>
+/// <!-- aidoc:v1 sig=8a60e84 -->
 public class VisualMap
 {
     public bool Show { get; set; } //Mostrar en la leyenda
@@ -965,6 +1011,7 @@ public class VisualMap
 /// <summary>
 /// Represents a single piece, serving as a general-purpose entity within its containing system.
 /// </summary>
+/// <!-- aidoc:v1 sig=fda97c7 -->
 public class Piece
 {
     public double? Opacity { get; set; } //Valor de la opacidad
@@ -1044,6 +1091,10 @@ public class Piece
 // /// Represents a single <c>candlestick</c> data point, typically used in financial charting to encapsulate price information for a discrete time interval.
 // /// </summary>
 // /// <!-- aidoc:v1 sig=59009c7 -->
+// /// <summary>
+// /// Represents a candle, likely encapsulating related data and behavior.
+// /// </summary>
+// /// <!-- aidoc:v1 sig=59009c7 -->
 // public class CandlestickSeriesConfig : SeriesConfigBase
 // {
 //     public List<Candle>? CandleKeyList { get; set; }
@@ -1081,6 +1132,7 @@ public enum CandleValueType
 /// <remarks>
 /// This class is intended to be inherited by specialized chart configuration types to ensure consistent configuration handling across the charting system.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b3dbace -->
 public class ChartBaseConfig
 {
     public string? Title { get; set; }
@@ -1101,6 +1153,7 @@ public class ChartBaseConfig
 /// <summary>
 /// Represents the configuration settings for an axis.
 /// </summary>
+/// <!-- aidoc:v1 sig=5ac80c1 -->
 public class AxisConfig
 {
     public DisplayConfigEnums.AxisType Type { get; set; }
@@ -1126,6 +1179,7 @@ public class AxisConfig
 /// <remarks>
 /// This class serves as a base type for specific graph layout strategies and is intended to be used to control the visual or logical arrangement of graph components.
 /// </remarks>
+/// <!-- aidoc:v1 sig=875c23e -->
 public class GraphLayout
 {
     public string? Layout { get; set; }
@@ -1138,6 +1192,7 @@ public class GraphLayout
 /// <summary>
 /// Represents a layout configuration for arranging section boxes.
 /// </summary>
+/// <!-- aidoc:v1 sig=b374a33 -->
 public class SectionBoxLayout
 {
     public DisplayConfigEnums.RowType Type { get; set; }
@@ -1165,6 +1220,7 @@ public class SectionBoxLayout
 /// <summary>
 /// Represents a configuration class that defines conditions.
 /// </summary>
+/// <!-- aidoc:v1 sig=66c2309 -->
 public class ConditionsConfig
 {
     public string? Condition { get; set; }
@@ -1174,6 +1230,7 @@ public class ConditionsConfig
 /// <summary>
 /// Represents a layout manager that arranges child elements in a row-based box configuration.
 /// </summary>
+/// <!-- aidoc:v1 sig=30e8cdf -->
 public class RowBoxLayout
 {
     public double? GrowPriority { get; set; }
@@ -1191,6 +1248,7 @@ public class RowBoxLayout
 /// <summary>
 /// Represents a box layout configuration for displaying observation rows.
 /// </summary>
+/// <!-- aidoc:v1 sig=6dfdcd9 -->
 public class ObservationRowBoxLayout
 {
     public List<ObservationTextRule>? TextRules { get; set; }
@@ -1230,6 +1288,7 @@ public class ObservationRowBoxLayout
 /// <summary>
 /// Represents a layout that arranges cards with a rotating behavior, likely managing the visual positioning and orientation of card elements within a container.
 /// </summary>
+/// <!-- aidoc:v1 sig=4cb8ae1 -->
 public class CardRotatingLayout
 {
     // In MS
@@ -1246,6 +1305,7 @@ public class CardRotatingLayout
 /// <summary>
 /// Represents a rule used to validate or process observation text.
 /// </summary>
+/// <!-- aidoc:v1 sig=5df013c -->
 public class ObservationTextRule
 {
     public ObservationEnum.ValueType ValueType { get; set; }
@@ -1265,6 +1325,7 @@ public class ObservationTextRule
 /// <summary>
 /// Represents a configuration object that defines layout settings for a legend.
 /// </summary>
+/// <!-- aidoc:v1 sig=ef77ebb -->
 public class LegendLayoutConfig
 {
     public List<LegendLayoutRow>? Rows { get; set; }
@@ -1273,6 +1334,7 @@ public class LegendLayoutConfig
 /// <summary>
 /// Represents a single row within a legend layout, typically used to organize and arrange legend items in a structured, row-based configuration.
 /// </summary>
+/// <!-- aidoc:v1 sig=b0c9b56 -->
 public class LegendLayoutRow
 {
     public decimal? GrowPriority { get; set; }
@@ -1282,6 +1344,7 @@ public class LegendLayoutRow
 /// <summary>
 /// Represents a column within a legend layout, defining a vertical arrangement of legend entries or items.
 /// </summary>
+/// <!-- aidoc:v1 sig=733f2f6 -->
 public class LegendLayoutColumn
 {
     public string? Key { get; set; }
@@ -1292,6 +1355,7 @@ public class LegendLayoutColumn
 /// <summary>
 /// Represents a label associated with a legend, typically used to describe or identify an entry in a chart, graph, or similar visual component.
 /// </summary>
+/// <!-- aidoc:v1 sig=3878ffa -->
 public class LegendLabel
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/HistoricalConfigChanges.cs b/adas-core.Domain/Models/MongoModels/HistoricalConfigChanges.cs
index 552683f0..7e03ab6d 100644
--- a/adas-core.Domain/Models/MongoModels/HistoricalConfigChanges.cs
+++ b/adas-core.Domain/Models/MongoModels/HistoricalConfigChanges.cs
@@ -13,6 +13,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This converter extends <see cref="JsonConverter"/> to provide tailored JSON conversion behavior for historical config change data.
 /// </remarks>
+/// <!-- aidoc:v1 sig=232c10f -->
 public class HistoricalConfigChanges : JsonConverter
 {
     public DateTime Time;
@@ -34,6 +35,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> that receives the serialized JSON output.</param>
     /// <param name="value">The object to serialize. If <c>null</c>, the method does nothing.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used during serialization.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=a8323de -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -50,6 +52,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// </summary>
     /// <param name="value">The object instance whose type defines the target property.</param>
     /// <param name="propertyName">The name of the property to which the converter attribute should be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -84,6 +87,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="serializer">The <see cref="JsonSerializer"/> used to deserialize nested objects.</param>
     /// <returns>The deserialized object value.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=c91c541 body=bfa6f2f -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -96,6 +100,8 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="objectType">The type to evaluate for convertibility.</param>
     /// <returns><see langword="true"/> when the converter supports <paramref name="objectType"/>; otherwise, <see langword="false"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown in all cases because the method body is not implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The method always throws NotImplementedException and never actually returns true or false; the <returns> tag implies a boolean outcome that never occurs." -->
     public override bool CanConvert(Type objectType)
         {
             throw new NotImplementedException();
diff --git a/adas-core.Domain/Models/MongoModels/HistoricalIds.cs b/adas-core.Domain/Models/MongoModels/HistoricalIds.cs
index b53f4ded..06be06ae 100644
--- a/adas-core.Domain/Models/MongoModels/HistoricalIds.cs
+++ b/adas-core.Domain/Models/MongoModels/HistoricalIds.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// The type holds a timestamp together with a dictionary of patient IDs, providing a snapshot of the identification data at the given time.
 /// </remarks>
+/// <!-- aidoc:v1 sig=0e1354d -->
 public class HistoricalId(DateTime time, Dictionary<string, string> patientIds)
 {
     // Propiedades
@@ -19,6 +20,7 @@ public class HistoricalId(DateTime time, Dictionary<string, string> patientIds)
     /// Determines whether the appointment is empty by checking if the <see cref="Time"/> has not been set (is the default <see cref="DateTime"/>) and no patient identifiers have been associated.
     /// </summary>
     /// <returns><see langword="true"/> if both the time is uninitialized and the patient list is empty; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=1112d99 body=8e5afe5 -->
     public bool IsEmpty()
         {
             return Time == default(DateTime) && PatientIds.Count == 0;
@@ -29,6 +31,7 @@ public class HistoricalId(DateTime time, Dictionary<string, string> patientIds)
     /// Determines whether the current entity is fully populated by verifying that a time has been explicitly assigned and at least one patient is associated.
     /// </summary>
     /// <returns><c>true</c> if both the <c>Time</c> property is set to a non-default <see cref="DateTime"/> value and the <c>PatientIds</c> collection contains at least one entry; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=49eac56 body=64ddc12 -->
     public bool IsFull()
         {
             return Time != default(DateTime) && PatientIds.Count > 0;
@@ -39,6 +42,7 @@ public class HistoricalId(DateTime time, Dictionary<string, string> patientIds)
     /// Returns a string representation of the HistoricalId, including the time and a comma-separated list of patient identifiers.
     /// </summary>
     /// <returns>A formatted string in the form "HistoricalId[Time: {Time}, PatientIds: {idsString}]" where idsString is the patient identifiers joined by commas.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=7cb507c -->
     public override string ToString()
         {
             var idsString = string.Join(", ", PatientIds);
diff --git a/adas-core.Domain/Models/MongoModels/LightBeacon.cs b/adas-core.Domain/Models/MongoModels/LightBeacon.cs
index 8046b75a..2dd259e4 100644
--- a/adas-core.Domain/Models/MongoModels/LightBeacon.cs
+++ b/adas-core.Domain/Models/MongoModels/LightBeacon.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a light beacon, typically used to emit or signal light as a visual indicator or warning marker.
 /// </summary>
+/// <!-- aidoc:v1 sig=ecec1f5 -->
 public class LightBeacon
 {
     public ObjectId Id { get; set; }
@@ -17,6 +18,7 @@ public class LightBeacon
 /// <summary>
 /// Represents a container for configuration or option settings used by the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=ab896e3 -->
 public class Options
 {
     public string? Url { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Notice.cs b/adas-core.Domain/Models/MongoModels/Notice.cs
index e659e04b..3a142898 100644
--- a/adas-core.Domain/Models/MongoModels/Notice.cs
+++ b/adas-core.Domain/Models/MongoModels/Notice.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a notice, typically used to convey information, alerts, or messages within the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=2d051b4 -->
 public class Notice
 {
     public ObjectId Id { get; set; }
@@ -20,6 +21,7 @@ public class Notice
     /// Returns a string representation of the notice, including the date (only when set), display ID, type, and description.
     /// </summary>
     /// <returns>A formatted string prefixed with "Notice [" and containing the comma-separated notice details, omitting the date entry when <c>NoticeDate</c> equals <see cref="System.DateTime.MinValue"/>.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=1c88f7f -->
     public override string ToString()
         {
             List<string> items = [];
@@ -35,6 +37,7 @@ public class Notice
 /// <summary>
 /// Represents a data structure that contains information about a staff member.
 /// </summary>
+/// <!-- aidoc:v1 sig=27c7be9 -->
 public class StaffInfo
 {
     public required string Role { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Patient.cs b/adas-core.Domain/Models/MongoModels/Patient.cs
index f8387dd4..1d3558c0 100644
--- a/adas-core.Domain/Models/MongoModels/Patient.cs
+++ b/adas-core.Domain/Models/MongoModels/Patient.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a patient entity, typically used to encapsulate patient-related data and behavior within a healthcare or medical information system.
 /// </summary>
+/// <!-- aidoc:v1 sig=902d058 -->
 public class Patient
 {
     public ObjectId Id { get; set; }
@@ -95,6 +96,7 @@ public class Patient
     /// for nullable types).
     /// </summary>
     /// <returns>A formatted string prefixed with "person[" and containing the included fields joined by commas.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=5a5a5f9 -->
     public override string ToString()
         {
             List<string> items = [$"id: {Id}"];
@@ -117,6 +119,7 @@ public class Patient
     /// Determines whether the current <see cref="UnitString"/> represents an inactive Virtual Point of Care by checking that it is not null and is not defined as a value of the <see cref="VirtualPointOfCare"/> enumeration.
     /// </summary>
     /// <returns><c>true</c> if <c>UnitString</c> is not null and does not match any defined <see cref="VirtualPointOfCare"/> value; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=6381760 body=ad5b58c -->
     public bool IsInActivePoC()
         {
             return UnitString != null && !Enum.IsDefined(typeof(VirtualPointOfCare), UnitString);
@@ -126,6 +129,7 @@ public class Patient
     /// Creates a copy of the current <see cref="Patient"/> instance by performing a shallow copy.
     /// </summary>
     /// <returns>A new <see cref="Patient"/> object that is a shallow copy of the current instance.</returns>
+    /// <!-- aidoc:v1 sig=b9adf0d body=1385083 -->
     public Patient DeepCopy()
         {
             return (Patient)MemberwiseClone();
@@ -182,6 +186,7 @@ public class Patient
 /// <summary>
 /// Represents data related to a patient's income information.
 /// </summary>
+/// <!-- aidoc:v1 sig=7574aef -->
 public class PatientIncomeData
 {
     public DateTime? AdmTime { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/PatientCarePlan.cs b/adas-core.Domain/Models/MongoModels/PatientCarePlan.cs
index 3d698f8f..8dee1d78 100644
--- a/adas-core.Domain/Models/MongoModels/PatientCarePlan.cs
+++ b/adas-core.Domain/Models/MongoModels/PatientCarePlan.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class serves as a structured model for organizing and tracking the various aspects of a patient's care strategy.
 /// </remarks>
+/// <!-- aidoc:v1 sig=28fe9fe -->
 public class PatientCarePlan
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/PoCMapping.cs b/adas-core.Domain/Models/MongoModels/PoCMapping.cs
index 4c0dd90a..1d0ca022 100644
--- a/adas-core.Domain/Models/MongoModels/PoCMapping.cs
+++ b/adas-core.Domain/Models/MongoModels/PoCMapping.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class serves as a container or descriptor for mapping logic, commonly used to translate data between different representations or models.
 /// </remarks>
+/// <!-- aidoc:v1 sig=5a30aec -->
 public class PoCMapping
 {
     public string Id { get; set; } = string.Empty;
@@ -17,6 +18,7 @@ public class PoCMapping
 /// <summary>
 /// Represents a single item used in a proof of concept (PoC) mapping, encapsulating the data or configuration required to define a mapping entry.
 /// </summary>
+/// <!-- aidoc:v1 sig=7b4cf01 -->
 public class PoCMappingItem
 {
     public string OriginalPoC { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/MongoModels/PoCSettings.cs b/adas-core.Domain/Models/MongoModels/PoCSettings.cs
index 54fa50f6..af276ae0 100644
--- a/adas-core.Domain/Models/MongoModels/PoCSettings.cs
+++ b/adas-core.Domain/Models/MongoModels/PoCSettings.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class serves as a container for configuration values used during proof-of-concept development and testing phases.
 /// </remarks>
+/// <!-- aidoc:v1 sig=6b63115 -->
 public class PoCSettings
 {
     public ObjectId Id { get; set; }
@@ -21,6 +22,7 @@ public class PoCSettings
     /// Returns a string representation of the object, always including the Id, and conditionally appending the PatientLocation and Relay Manual Status when those values are not null.
     /// </summary>
     /// <returns>A string containing the Id and, when available, the PatientLocation and Manual Relay Status information.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=f9c6eac -->
     public override string ToString()
         {
             var result = "Id: " + Id;
diff --git a/adas-core.Domain/Models/MongoModels/PointOfCare.cs b/adas-core.Domain/Models/MongoModels/PointOfCare.cs
index 92ae5652..e3c0faa8 100644
--- a/adas-core.Domain/Models/MongoModels/PointOfCare.cs
+++ b/adas-core.Domain/Models/MongoModels/PointOfCare.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class serves as a data model for capturing information related to a specific point where care is administered to patients.
 /// </remarks>
+/// <!-- aidoc:v1 sig=99a7922 -->
 public class PointOfCare
 {
     public ObjectId Id { get; set; }
@@ -39,6 +40,7 @@ public class PointOfCare
 /// <summary>
 /// Represents the configuration settings for a point-of-care system, encapsulating the parameters and options required to manage its behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=50c6b7b -->
 public class PointOfCareConfiguration
 {
     public List<ObjectId>? BeaconIdList { get; set; } = [];
diff --git a/adas-core.Domain/Models/MongoModels/PumpElement.cs b/adas-core.Domain/Models/MongoModels/PumpElement.cs
index d7dd9be7..bcc07295 100644
--- a/adas-core.Domain/Models/MongoModels/PumpElement.cs
+++ b/adas-core.Domain/Models/MongoModels/PumpElement.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a pump element within the system, serving as a component for pumping-related functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=c1af8ef -->
 public class PumpElement
 {
     public string? Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Relay.cs b/adas-core.Domain/Models/MongoModels/Relay.cs
index 2243b1e4..750ee103 100644
--- a/adas-core.Domain/Models/MongoModels/Relay.cs
+++ b/adas-core.Domain/Models/MongoModels/Relay.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This class serves as an intermediary mechanism, commonly used to decouple producers and consumers of information.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2f27144 -->
 public class Relay
 {
     public ObjectId Id { get; set; }
@@ -52,6 +53,7 @@ public class Relay
     /// </summary>
     /// <param name="other">The other <see cref="Relay"/> instance to compare against the current one.</param>
     /// <returns><c>true</c> if all properties of both relays match; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=2e64d60 body=9793a82 -->
     public bool Equals(Relay other)
         {
             return Driver == other.Driver && Ip == other.Ip && Port == other.Port && RelayNumber == other.RelayNumber &&
@@ -63,6 +65,7 @@ public class Relay
     /// Returns a JSON string representation of the current object, serializing all its public properties via JsonConvert.
     /// </summary>
     /// <returns>A JSON-formatted string that represents the current object.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=a8136e0 -->
     public override string ToString()
         {
             return JsonConvert.SerializeObject(this);
diff --git a/adas-core.Domain/Models/MongoModels/Section.cs b/adas-core.Domain/Models/MongoModels/Section.cs
index 53660697..39f89d46 100644
--- a/adas-core.Domain/Models/MongoModels/Section.cs
+++ b/adas-core.Domain/Models/MongoModels/Section.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a section, typically used to group or encapsulate a distinct portion of related content or functionality within a larger structure.
 /// </summary>
+/// <!-- aidoc:v1 sig=08dfa80 -->
 public class Section
 {
     // ReSharper disable once InconsistentNaming
@@ -39,6 +40,7 @@ public class Section
     /// </summary>
     /// <param name="other">The <see cref="Section"/> instance to compare with the current one.</param>
     /// <returns><c>true</c> if both sections share the same <see cref="Section.Id"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=b37ab9c body=200362c -->
     public bool Equals(Section? other)
         {
             return other != null &&
@@ -49,6 +51,7 @@ public class Section
     /// Returns a string representation of the Section, including its identifier.
     /// </summary>
     /// <returns>A string formatted as "[Section id: {Id}]" containing the section's identifier.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=50b2b4e -->
     public override string ToString()
         {
             return "[Section id: " + Id + "]";
@@ -57,6 +60,7 @@ public class Section
     /// <summary>
     /// Represents an individual item within a section, encapsulating the data and behavior associated with that entry.
     /// </summary>
+    /// <!-- aidoc:v1 sig=77db232 -->
     public class SectionItem
     {
         public string? Group { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/ServiceConfig.cs b/adas-core.Domain/Models/MongoModels/ServiceConfig.cs
index e0b642c4..096362c4 100644
--- a/adas-core.Domain/Models/MongoModels/ServiceConfig.cs
+++ b/adas-core.Domain/Models/MongoModels/ServiceConfig.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents the configuration settings for a service.
 /// </summary>
+/// <!-- aidoc:v1 sig=7ad95bf -->
 public class ServiceConfig
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/ServiceConfigService.cs b/adas-core.Domain/Models/MongoModels/ServiceConfigService.cs
index 710c18bb..3fb268ae 100644
--- a/adas-core.Domain/Models/MongoModels/ServiceConfigService.cs
+++ b/adas-core.Domain/Models/MongoModels/ServiceConfigService.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides functionality for managing service configuration settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=bddc26d -->
 public class ServiceConfigService
 {
     public string Screen { get; set; } = string.Empty;
@@ -14,6 +15,7 @@ public class ServiceConfigService
 /// <summary>
 /// Represents a configuration section that defines settings for a service configuration service.
 /// </summary>
+/// <!-- aidoc:v1 sig=ad46068 -->
 public class ServiceConfigServiceSection
 {
     public string BoxId { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/MongoModels/ServiceConfigTheme.cs b/adas-core.Domain/Models/MongoModels/ServiceConfigTheme.cs
index 7dc6a2b2..f05fbbc2 100644
--- a/adas-core.Domain/Models/MongoModels/ServiceConfigTheme.cs
+++ b/adas-core.Domain/Models/MongoModels/ServiceConfigTheme.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the configuration settings for the theme of a service.
 /// </summary>
+/// <!-- aidoc:v1 sig=f232567 -->
 public class ServiceConfigTheme
 {
     public string DefaultTheme { get; set; } = string.Empty;
@@ -14,6 +15,7 @@ public class ServiceConfigTheme
 /// <summary>
 /// Represents the configuration settings for a service's theme timetable.
 /// </summary>
+/// <!-- aidoc:v1 sig=c33232e -->
 public class ServiceConfigThemeTimetable
 {
     public string Theme { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/MongoModels/Step.cs b/adas-core.Domain/Models/MongoModels/Step.cs
index 85f0a9c8..35239fa8 100644
--- a/adas-core.Domain/Models/MongoModels/Step.cs
+++ b/adas-core.Domain/Models/MongoModels/Step.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents an individual step, typically within a sequence or workflow.
 /// </summary>
+/// <!-- aidoc:v1 sig=e078b3b -->
 public class Step
 {
     public int? RotationTime { get; set; }
@@ -27,6 +28,7 @@ public class Step
 /// <remarks>
 /// This class serves as a data container for font properties required by the UI rendering system.
 /// </remarks>
+/// <!-- aidoc:v1 sig=13f55fb -->
 public class UiFontData
 {
     public double? WidthStepBed { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/Unit.cs b/adas-core.Domain/Models/MongoModels/Unit.cs
index b30fae5b..8a3ede11 100644
--- a/adas-core.Domain/Models/MongoModels/Unit.cs
+++ b/adas-core.Domain/Models/MongoModels/Unit.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a unit, typically used as a return type for operations that have no meaningful result value.
 /// </summary>
+/// <!-- aidoc:v1 sig=a533774 -->
 public class Unit
 {
     public ObjectId Id { get; set; }
@@ -81,6 +82,7 @@ public class Unit
 /// <summary>
 /// Represents the configuration settings for a unit.
 /// </summary>
+/// <!-- aidoc:v1 sig=85992a0 -->
 public class UnitConfiguration
 {
     public bool AutoAdt { get; set; }
diff --git a/adas-core.Domain/Models/MongoModels/User.cs b/adas-core.Domain/Models/MongoModels/User.cs
index 6691539b..29a354ae 100644
--- a/adas-core.Domain/Models/MongoModels/User.cs
+++ b/adas-core.Domain/Models/MongoModels/User.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <summary>
 /// Represents a user within the system, encapsulating user-related data and behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=cd88043 -->
 public class User
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/Note.cs b/adas-core.Domain/Models/Note.cs
index 9c1ec7d7..4c9a42fa 100644
--- a/adas-core.Domain/Models/Note.cs
+++ b/adas-core.Domain/Models/Note.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a note entity used to store textual or descriptive information.
 /// </summary>
+/// <!-- aidoc:v1 sig=bf82ed0 -->
 public class Note
 {
     public string? CommentType { get; set; } = string.Empty;
@@ -15,6 +16,7 @@ public class Note
     /// Returns a string representation of the note, conditionally including the comment type, comment text, and entered time when their values are present.
     /// </summary>
     /// <returns>A formatted string in the form "note[...]" containing the available note properties, or "note[]" when no properties are set.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=2df1063 -->
     public override string ToString()
         {
             List<string> items = [];
diff --git a/adas-core.Domain/Models/ObservaitonRetentionResult.cs b/adas-core.Domain/Models/ObservaitonRetentionResult.cs
index 173424eb..09d2c476 100644
--- a/adas-core.Domain/Models/ObservaitonRetentionResult.cs
+++ b/adas-core.Domain/Models/ObservaitonRetentionResult.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents the result of an observation retention operation, encapsulating the outcome and relevant details of the retention process.
 /// </summary>
+/// <!-- aidoc:v1 sig=1ccfc4b -->
 public class ObservatitonRetentionResult
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/ObservationData.cs b/adas-core.Domain/Models/ObservationData.cs
index ae2530ae..3d114baa 100644
--- a/adas-core.Domain/Models/ObservationData.cs
+++ b/adas-core.Domain/Models/ObservationData.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a data structure for storing observation information.
 /// </summary>
+/// <!-- aidoc:v1 sig=5bb1e7c -->
 public class ObservationData
 {
     public string? CodingSystem { get; set; }
diff --git a/adas-core.Domain/Models/Observations/BoolObservation.cs b/adas-core.Domain/Models/Observations/BoolObservation.cs
index 99873f8d..b310dad1 100644
--- a/adas-core.Domain/Models/Observations/BoolObservation.cs
+++ b/adas-core.Domain/Models/Observations/BoolObservation.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents an observation that conveys a boolean value, extending the base <see cref="Observation"/> type.
 /// </summary>
+/// <!-- aidoc:v1 sig=16d4255 -->
 public class BoolObservation : Observation
 {
     public bool Value { get; set; }
@@ -13,6 +14,7 @@ public class BoolObservation : Observation
     /// </summary>
     /// <param name="obs">The list of patient observations from which the first entry is converted.</param>
     /// <returns>A <see cref="BoolObservation"/> containing the boolean value of the first observation, or <see langword="null"/> if the list contains no observations.</returns>
+    /// <!-- aidoc:v1 sig=42167d6 body=3489a3a -->
     internal static BoolObservation? From(List<PatientObservation> obs)
         {
             if (obs.Count > 0)
diff --git a/adas-core.Domain/Models/Observations/ChartObservation.cs b/adas-core.Domain/Models/Observations/ChartObservation.cs
index b81053b5..3dcf1811 100644
--- a/adas-core.Domain/Models/Observations/ChartObservation.cs
+++ b/adas-core.Domain/Models/Observations/ChartObservation.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents an observation that is associated with a chart, providing chart-specific contextual data derived from the base <see cref="Observation"/> type.
 /// </summary>
+/// <!-- aidoc:v1 sig=f15917b -->
 public class ChartObservation : Observation
 {
     public List<double> Values { get; set; } = [];
@@ -20,6 +21,7 @@ public class ChartObservation : Observation
     /// <param name="obs">The list of patient observations to convert.</param>
     /// <returns>A new <see cref="ChartObservation"/> instance.</returns>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="obs"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=7d736f9 body=29be5c3 -->
     internal static ChartObservation From(List<PatientObservation> obs)
         {
             return obs == null ? throw new ArgumentNullException(nameof(obs)) : new ChartObservation();
diff --git a/adas-core.Domain/Models/Observations/DoubleObservation.cs b/adas-core.Domain/Models/Observations/DoubleObservation.cs
index 41d4f462..c6d88fdf 100644
--- a/adas-core.Domain/Models/Observations/DoubleObservation.cs
+++ b/adas-core.Domain/Models/Observations/DoubleObservation.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.Observations;
 /// Represents an observation that captures a double-precision floating-point measurement or value.
 /// Inherits from the base <see cref="Observation"/> type, providing a specialized observation variant for numeric data of type <see cref="double"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=bb4c3dc -->
 public class DoubleObservation : Observation
 {
     public double? Value { get; set; }
@@ -16,6 +17,7 @@ public class DoubleObservation : Observation
     /// </summary>
     /// <param name="obs">The list of patient observations to convert. At least one element is required to produce a result.</param>
     /// <returns>A <see cref="DoubleObservation"/> populated with the converted double values, or <c>null</c> if the list is empty.</returns>
+    /// <!-- aidoc:v1 sig=0b5761e body=41f15e7 -->
     public static DoubleObservation? From(List<PatientObservation> obs)
         {
             if (obs.Count > 0)
diff --git a/adas-core.Domain/Models/Observations/FullObservation.cs b/adas-core.Domain/Models/Observations/FullObservation.cs
index a327a351..35d4c4f8 100644
--- a/adas-core.Domain/Models/Observations/FullObservation.cs
+++ b/adas-core.Domain/Models/Observations/FullObservation.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a complete observation as a specialized form of the <see cref="Observation"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=2c8f902 -->
 public class FullObservation : Observation
 {
     public DateTime LastObservationDate;
@@ -25,6 +26,7 @@ public class FullObservation : Observation
     /// </summary>
     /// <param name="obs">The list of patient observations to convert; only the first two entries are used when present.</param>
     /// <returns>A <see cref="FullObservation"/> built from the first observation, or <c>null</c> if <paramref name="obs"/> contains no items.</returns>
+    /// <!-- aidoc:v1 sig=aca4f16 body=dd762ba -->
     public static FullObservation? From(List<PatientObservation> obs)
         {
             if (obs.Count > 0)
diff --git a/adas-core.Domain/Models/Observations/Medication.cs b/adas-core.Domain/Models/Observations/Medication.cs
index cfd087e1..e0db3eb9 100644
--- a/adas-core.Domain/Models/Observations/Medication.cs
+++ b/adas-core.Domain/Models/Observations/Medication.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.Observations;
 /// <remarks>
 /// Serves as a specialized observation for capturing and modeling medication-specific data within the inheritance hierarchy.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a00759f -->
 public class Medication : Observation
 {
     /// <summary>
@@ -65,6 +66,7 @@ public class Medication : Observation
 /// <summary>
 /// Represents a value or data entry associated with a drug, such as dosage, concentration, or other pharmaceutical-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=a9fb501 -->
 public class DrugValue
 {
     /// <summary>
@@ -102,6 +104,7 @@ public class DrugValue
     /// Copies the values from the specified <see cref="DrugValue"/> instance into the current instance, replacing the existing Id, Text, Units, Time, CodingSystem, and Result properties.
     /// </summary>
     /// <param name="common">The <see cref="DrugValue"/> instance whose property values will be copied to the current instance.</param>
+    /// <!-- aidoc:v1 sig=04f2026 body=2cd00f7 -->
     public void Copy(DrugValue common)
         {
             Id = common.Id;
@@ -119,6 +122,7 @@ public class DrugValue
 /// <remarks>
 /// As an abstract class, it must be inherited by a derived class that supplies the concrete implementation for the double-based drug value behavior.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2c61895 -->
 public abstract class DrugDoubleValue : DrugValue
 {
     /// <summary>
@@ -141,6 +145,7 @@ public abstract class DrugDoubleValue : DrugValue
 /// <remarks>
 /// Inherits from <see cref="DrugValue"/> and is intended to be derived by concrete classes that encapsulate string-typed drug data associated with a <see cref="PumpElement"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b31b430 -->
 public abstract class DrugStringValue(PumpElement pumpElement) : DrugValue(pumpElement)
 {
     public string? Value { get; set; } = pumpElement.Value?.ToString();
@@ -149,6 +154,7 @@ public abstract class DrugStringValue(PumpElement pumpElement) : DrugValue(pumpE
 /// <summary>
 /// Represents a double-precision drug value that describes the flow of a fluid for the specified <see cref="PumpElement"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=afae0d5 -->
 public class FlowFluid(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 
 /// <summary>
@@ -157,6 +163,7 @@ public class FlowFluid(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/>, sharing the pump element context with its base type.
 /// </remarks>
+/// <!-- aidoc:v1 sig=e2e9e55 -->
 public class VolumeFluidDeliveryTotal(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 
 /// <summary>
@@ -165,11 +172,13 @@ public class VolumeFluidDeliveryTotal(PumpElement pumpElement) : DrugDoubleValue
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/> and is constructed with a <see cref="PumpElement"/> instance that is forwarded to the base constructor.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8d4645b -->
 public class PumpDeliveryPressure(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 
 /// <summary>
 /// Represents the remaining volume of fluid to be infused (TBI) associated with a pump element, implemented as a drug-related double value.
 /// </summary>
+/// <!-- aidoc:v1 sig=dc8c1c6 -->
 public class VolumeFluidTbiRemain(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 
 /// <summary>
@@ -178,12 +187,14 @@ public class VolumeFluidTbiRemain(PumpElement pumpElement) : DrugDoubleValue(pum
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/> and is constructed with a <see cref="PumpElement"/> to capture time-related fluid volume metrics.
 /// </remarks>
+/// <!-- aidoc:v1 sig=9b38fa5 -->
 public class VolumeFluidTimePdRemain(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 
 /// <summary>
 /// Represents the active sources of a pump element as a drug string value.
 /// Inherits from <see cref="DrugStringValue"/>, encapsulating source information for pump operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=ded4b3d -->
 public class PumpActiveSources(PumpElement pumpElement) : DrugStringValue(pumpElement)
 {
     public string? ValueId { get; set; } = pumpElement.ValueId;
@@ -193,11 +204,13 @@ public class PumpActiveSources(PumpElement pumpElement) : DrugStringValue(pumpEl
 /// <summary>
 /// Represents a drug value associated with a pump element, inheriting from the DrugStringValue base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=284cad0 -->
 public class Drug(PumpElement pumpElement) : DrugStringValue(pumpElement);
 
 /// <summary>
 /// Represents a pump mode as a drug-related string value, inheriting string-based value semantics from <see cref="DrugStringValue"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=d46f699 -->
 public class PumpMode : DrugStringValue
 {
     /// <summary>
@@ -214,6 +227,7 @@ public class PumpMode : DrugStringValue
 /// <summary>
 /// Represents the operational status of a pump as a drug-related string value.
 /// </summary>
+/// <!-- aidoc:v1 sig=b46795e -->
 public class PumpStatus : DrugStringValue
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/Observations/Observation.cs b/adas-core.Domain/Models/Observations/Observation.cs
index dc5e8159..487997d0 100644
--- a/adas-core.Domain/Models/Observations/Observation.cs
+++ b/adas-core.Domain/Models/Observations/Observation.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a single observation or recorded data point.
 /// </summary>
+/// <!-- aidoc:v1 sig=3ba0a3e -->
 public class Observation
 {
 }
\ No newline at end of file
diff --git a/adas-core.Domain/Models/Observations/ObservationPaginatedResult.cs b/adas-core.Domain/Models/Observations/ObservationPaginatedResult.cs
index a1515313..404f354e 100644
--- a/adas-core.Domain/Models/Observations/ObservationPaginatedResult.cs
+++ b/adas-core.Domain/Models/Observations/ObservationPaginatedResult.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a paginated collection of observation results, typically used to return a subset of observations along with associated pagination metadata.
 /// </summary>
+/// <!-- aidoc:v1 sig=088f64b -->
 public class ObservationPaginatedResult
 {
     public int Count { get; set; } = 0;
diff --git a/adas-core.Domain/Models/Observations/ObservationsRequest.cs b/adas-core.Domain/Models/Observations/ObservationsRequest.cs
index e71d042a..c5a0dcdc 100644
--- a/adas-core.Domain/Models/Observations/ObservationsRequest.cs
+++ b/adas-core.Domain/Models/Observations/ObservationsRequest.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a request for retrieving observations data, typically used to encapsulate query parameters or filtering criteria when interacting with an observations service or repository.
 /// </summary>
+/// <!-- aidoc:v1 sig=c2fdd1a -->
 public class ObservationsRequest
 {
     public string? PatientNumber { get; set; }
diff --git a/adas-core.Domain/Models/Observations/PredictMedicationObservation.cs b/adas-core.Domain/Models/Observations/PredictMedicationObservation.cs
index 7502f41c..712e442a 100644
--- a/adas-core.Domain/Models/Observations/PredictMedicationObservation.cs
+++ b/adas-core.Domain/Models/Observations/PredictMedicationObservation.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a prediction result or data model for medication observation.
 /// </summary>
+/// <!-- aidoc:v1 sig=bf83932 -->
 public class PredictMedicationObservation
 {
     public string MedicineText { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/Observations/StringObservation.cs b/adas-core.Domain/Models/Observations/StringObservation.cs
index 446fc453..934b9548 100644
--- a/adas-core.Domain/Models/Observations/StringObservation.cs
+++ b/adas-core.Domain/Models/Observations/StringObservation.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class specializes the Observation concept for textual or string-based content, inheriting the core observation behavior from its parent class.
 /// </remarks>
+/// <!-- aidoc:v1 sig=9cacd8d -->
 public class StringObservation : Observation
 {
     public string Value { get; set; } = string.Empty;
@@ -16,6 +17,7 @@ public class StringObservation : Observation
     /// </summary>
     /// <param name="obs">The list of <see cref="PatientObservation"/> instances to convert.</param>
     /// <returns>A <see cref="StringObservation"/> populated with the string value of the first observation, or <c>null</c> if the list contains no elements.</returns>
+    /// <!-- aidoc:v1 sig=ae5156f body=38bc202 -->
     public static StringObservation? From(List<PatientObservation> obs)
         {
             if (obs.Count > 0)
diff --git a/adas-core.Domain/Models/PatientAllergiesValue.cs b/adas-core.Domain/Models/PatientAllergiesValue.cs
index e951a542..1018926a 100644
--- a/adas-core.Domain/Models/PatientAllergiesValue.cs
+++ b/adas-core.Domain/Models/PatientAllergiesValue.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a value related to a patient's allergies.
 /// </summary>
+/// <!-- aidoc:v1 sig=8c95855 -->
 public class PatientAllergiesValue
 {
     public string? Type { get; set; }
@@ -16,6 +17,7 @@ public class PatientAllergiesValue
     /// Returns a formatted string representation of the object, including its Type, Value, and Notes properties.
     /// </summary>
     /// <returns>A string containing the Type, Value, and Notes properties of the object.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=6deda00 -->
     public override string ToString()
         {
             return $"Tipo: {Type}, Valor: {Value}, Notas: {Notes}";
diff --git a/adas-core.Domain/Models/PatientAppointment.cs b/adas-core.Domain/Models/PatientAppointment.cs
index dece7a45..744a4344 100644
--- a/adas-core.Domain/Models/PatientAppointment.cs
+++ b/adas-core.Domain/Models/PatientAppointment.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// A JSON converter that handles the serialization and deserialization of <see cref="PatientAppointment"/> objects to and from JSON format.
 /// </summary>
+/// <!-- aidoc:v1 sig=a1adfa3 -->
 public class PatientAppointment : JsonConverter
 {
     public ObjectId Id { get; set; }
@@ -59,6 +60,7 @@ public class PatientAppointment : JsonConverter
     /// </summary>
     /// <param name="apdb">The optional persisted <see cref="PatientAppointment"/> whose resource groups provide the source data for the actions. May be null or have fewer resource groups than the current list.</param>
     /// <returns>The list of <see cref="PatientAppointmentResourceGroup"/> instances with services, resources, locations, and personnel populated after applying the configured actions.</returns>
+    /// <!-- aidoc:v1 sig=536c687 body=182d1e8 -->
     public List<PatientAppointmentResourceGroup> ApplyResourceGroups(PatientAppointment? apdb = null)
         {
             var i = 0;
@@ -80,6 +82,7 @@ public class PatientAppointment : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to check for converter support.</param>
     /// <returns><c>true</c> if <paramref name="objectType"/> is <see cref="PatientAppointment"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee00023 body=3a2fc7b -->
     public override bool CanConvert(Type objectType)
         {
             return objectType == typeof(PatientAppointment);
@@ -91,6 +94,8 @@ public class PatientAppointment : JsonConverter
     /// <param name="writer">The JSON writer to which the serialized output is written.</param>
     /// <param name="value">The object to serialize. A null value results in no output being written.</param>
     /// <param name="serializer">The JSON serializer used to perform the conversion.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The serializer parameter is described as 'used to perform the conversion', but it is never referenced in the method body; the conversion is performed via JObject.FromObject(value) and jo.WriteTo(writer)." -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -111,6 +116,7 @@ public class PatientAppointment : JsonConverter
     /// <param name="serializer">The <see cref="JsonSerializer"/> invoking the converter.</param>
     /// <returns>An object representing the deserialized value.</returns>
     /// <exception cref="NotImplementedException">Always thrown, as the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=c91c541 body=bfa6f2f -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -124,6 +130,7 @@ public class PatientAppointment : JsonConverter
 /// <remarks>
 /// This class serves as a container or grouping mechanism for resources associated with managing patient appointment information.
 /// </remarks>
+/// <!-- aidoc:v1 sig=90132fc -->
 public class PatientAppointmentResourceGroup
 {
     public List<Code>? Services { get; set; }
@@ -147,6 +154,7 @@ public class PatientAppointmentResourceGroup
 /// <summary>
 /// Represents allergy information, serving as a model or container for allergy-related data.
 /// </summary>
+/// <!-- aidoc:v1 sig=e3c861e -->
 public class Allergies
 {
     public Code? AllergenType { get; set; }
diff --git a/adas-core.Domain/Models/PatientDiagnosis.cs b/adas-core.Domain/Models/PatientDiagnosis.cs
index 0a52b6ce..d7d6d116 100644
--- a/adas-core.Domain/Models/PatientDiagnosis.cs
+++ b/adas-core.Domain/Models/PatientDiagnosis.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents a diagnosis associated with a patient, encapsulating the relevant diagnostic information.
 /// </summary>
+/// <!-- aidoc:v1 sig=748a2da -->
 public class PatientDiagnosis
 {
     public ObjectId Id { get; set; }
@@ -55,6 +56,7 @@ public class PatientDiagnosis
     /// </summary>
     /// <returns>A formatted string in the form <c>PatientDiagnosis[field1: value1, field2: value2, ...]</c>
     /// containing the diagnosis data; optional fields are omitted when null or empty.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=b5fea56 -->
     public override string ToString()
         {
             List<string> items =
diff --git a/adas-core.Domain/Models/PatientDrainagesValue.cs b/adas-core.Domain/Models/PatientDrainagesValue.cs
index 7dec4552..6ef8dadf 100644
--- a/adas-core.Domain/Models/PatientDrainagesValue.cs
+++ b/adas-core.Domain/Models/PatientDrainagesValue.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a value associated with a patient's drainage information.
 /// </summary>
+/// <!-- aidoc:v1 sig=9f908dd -->
 public class PatientDrainagesValue
 {
     public string? Type { get; set; }
diff --git a/adas-core.Domain/Models/PatientICCA.cs b/adas-core.Domain/Models/PatientICCA.cs
index 3691a418..675c7f1d 100644
--- a/adas-core.Domain/Models/PatientICCA.cs
+++ b/adas-core.Domain/Models/PatientICCA.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a patient data model associated with the ICCA (IntelliSpace Critical Care and Anesthesia) system.
 /// </summary>
+/// <!-- aidoc:v1 sig=c44a697 -->
 public class PatientIcca
 {
     public PatientLocation Location { get; set; } = new(string.Empty, string.Empty);
@@ -17,6 +18,7 @@ public class PatientIcca
     /// Creates a deep copy of the current <see cref="PatientIcca"/> instance, duplicating the <see cref="Location"/>, <see cref="PatientNumber"/>, and <see cref="PatientId"/> so that modifications to the copy do not affect the original object.
     /// </summary>
     /// <returns>A new <see cref="PatientIcca"/> instance with independently copied reference-typed members.</returns>
+    /// <!-- aidoc:v1 sig=faeca64 body=c869a01 -->
     public PatientIcca DeepCopy()
         {
             var other = (PatientIcca)MemberwiseClone();
diff --git a/adas-core.Domain/Models/PatientIntravenousLinesValue.cs b/adas-core.Domain/Models/PatientIntravenousLinesValue.cs
index 347817e9..05f8a4c9 100644
--- a/adas-core.Domain/Models/PatientIntravenousLinesValue.cs
+++ b/adas-core.Domain/Models/PatientIntravenousLinesValue.cs
@@ -3,6 +3,8 @@
 /// <summary>
 /// Represents a value type containing data related to a patient's intravenous lines.
 /// </summary>
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The class is declared as 'class', which is a reference type, but the summary describes it as a 'value type'." -->
 public class PatientIntravenousLinesValue
 {
     public string? Type { get; set; }
diff --git a/adas-core.Domain/Models/PatientLocation.cs b/adas-core.Domain/Models/PatientLocation.cs
index 3821fd27..b1f887ab 100644
--- a/adas-core.Domain/Models/PatientLocation.cs
+++ b/adas-core.Domain/Models/PatientLocation.cs
@@ -4,6 +4,7 @@
 /// Represents the location of a patient within a healthcare or clinical context.
 /// Implements <see cref="IEquatable{PatientLocation}"/> to provide type-specific equality comparison between patient location instances.
 /// </summary>
+/// <!-- aidoc:v1 sig=6e6501a -->
 public class PatientLocation : IEquatable<PatientLocation>
 {
     /// <summary>
@@ -53,6 +54,7 @@ public class PatientLocation : IEquatable<PatientLocation>
     /// </summary>
     /// <param name="other">The <see cref="PatientLocation"/> to compare with the current instance.</param>
     /// <returns><see langword="true"/> when all three properties (<c>UnitName</c>, <c>Bed</c>, and <c>Room</c>) match; otherwise, <see langword="false"/>. Returns <see langword="false"/> if <paramref name="other"/> is <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=29defab body=9b8e1aa -->
     public bool Equals(PatientLocation? other)
         {
             return UnitName == other?.UnitName && Bed == other?.Bed && Room == other?.Room;
@@ -62,6 +64,7 @@ public class PatientLocation : IEquatable<PatientLocation>
     /// Determines whether the current instance is considered empty by checking that both the <see cref="UnitName"/> and <see cref="Bed"/> values are null or empty strings.
     /// </summary>
     /// <returns><see langword="true"/> if both <c>UnitName</c> and <c>Bed</c> are null or empty; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=1112d99 body=46ea0dd -->
     public bool IsEmpty()
         {
             return string.IsNullOrEmpty(UnitName) && string.IsNullOrEmpty(Bed);
@@ -71,6 +74,7 @@ public class PatientLocation : IEquatable<PatientLocation>
     /// Determines whether the unit name, bed, and room fields are all null or empty, indicating the entity is fully empty.
     /// </summary>
     /// <returns><c>true</c> if <see cref="UnitName"/>, <see cref="Bed"/>, and <see cref="Room"/> are all null or empty; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=b4be47a body=0369139 -->
     public bool IsFullEmpty()
         {
             return string.IsNullOrEmpty(UnitName) && string.IsNullOrEmpty(Bed) && string.IsNullOrEmpty(Room);
@@ -80,6 +84,7 @@ public class PatientLocation : IEquatable<PatientLocation>
     /// Returns a human-readable string representation of the PatientLocation, including the unit name, room, and bed.
     /// </summary>
     /// <returns>A formatted string in the form "PatientLocation[Unit: {UnitName},room: {Room} ,bed: {Bed}]".</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=bf03a9b -->
     public override string ToString()
         {
             return "PatientLocation[Unit: " + UnitName + ",room: " + Room + " ,bed: " + Bed + "]";
diff --git a/adas-core.Domain/Models/PatientLocationAction.cs b/adas-core.Domain/Models/PatientLocationAction.cs
index a79b78ac..f5537bd9 100644
--- a/adas-core.Domain/Models/PatientLocationAction.cs
+++ b/adas-core.Domain/Models/PatientLocationAction.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// This type encapsulates an operation or behavior associated with managing or interacting with a patient's location information.
 /// </remarks>
+/// <!-- aidoc:v1 sig=0e2406f -->
 public class PatientLocationAction
 {
     public ActionsEnum.ResourceAction? Action { get; set; }
@@ -21,6 +22,7 @@ public class PatientLocationAction
     /// </summary>
     /// <param name="actions">The list of patient location actions to apply. May be <c>null</c>.</param>
     /// <returns>The resulting <see cref="List{PatientLocation}"/> produced by applying the actions, or <c>null</c> if no locations are produced.</returns>
+    /// <!-- aidoc:v1 sig=29e7624 body=22d71fc -->
     public static List<PatientLocation>? Apply(List<PatientLocationAction>? actions)
     {
         return Apply(null, actions);
@@ -32,6 +34,7 @@ public class PatientLocationAction
     /// <param name="source">The list of patient locations to mutate. If null, an empty list is used.</param>
     /// <param name="actions">The actions to apply to the source list. If null, no actions are applied; actions with a null <c>Location</c> are skipped.</param>
     /// <returns>The resulting list of <see cref="PatientLocation"/> after applying the actions, or null if the list is empty.</returns>
+    /// <!-- aidoc:v1 sig=0e591a8 body=af27646 -->
     public static List<PatientLocation>? Apply(List<PatientLocation>? source, List<PatientLocationAction>? actions)
     {
         source ??= [];
diff --git a/adas-core.Domain/Models/PatientObservation.cs b/adas-core.Domain/Models/PatientObservation.cs
index 5378ca60..a7c36aec 100644
--- a/adas-core.Domain/Models/PatientObservation.cs
+++ b/adas-core.Domain/Models/PatientObservation.cs
@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// This class serves as a concrete implementation of patient observation data, inheriting common observation value behavior from <see cref="BasePatientObservationValue"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=877e2d3 -->
 public class PatientObservation : BasePatientObservationValue
 {
     private string? _result;
@@ -69,6 +70,10 @@ public class PatientObservation : BasePatientObservationValue
     /// Returns a string representation of the <see cref="PatientObservation"/>, including its value, optional min/max/warning thresholds, result, status, expiration, and persistence settings. Optional properties are only included in the output when they have non-null or, for strings, non-empty values.
     /// </summary>
     /// <returns>A formatted string in the form <c>PatientObservation[property1: value1, ...]</c> containing the populated properties of the observation.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary omits the 'showOnExpired' and 'colorOnExpired' properties which are also conditionally added to the output." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary states optional properties are included 'when they have non-null or, for strings, non-empty values', but 'showOnExpired' is added only when !ShowOnExpired (i.e., when the boolean is false)." -->
     public override string ToString()
     {
         var items = ToListString();
@@ -90,6 +95,7 @@ public class PatientObservation : BasePatientObservationValue
     /// Creates a copy of the current <see cref="PatientObservation"/> instance by performing a shallow copy via MemberwiseClone and casting the cloned object back to <see cref="PatientObservation"/>.
     /// </summary>
     /// <returns>A <see cref="PatientObservation"/> instance that is a shallow copy of the current object.</returns>
+    /// <!-- aidoc:v1 sig=25ad808 body=6d4453e -->
     public PatientObservation DeepCopy()
     {
         return (PatientObservation)MemberwiseClone();
diff --git a/adas-core.Domain/Models/PatientObservationAlarm.cs b/adas-core.Domain/Models/PatientObservationAlarm.cs
index 3e8cf15f..4a5550c2 100644
--- a/adas-core.Domain/Models/PatientObservationAlarm.cs
+++ b/adas-core.Domain/Models/PatientObservationAlarm.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models;
 /// <summary>
 /// Represents an alarm condition associated with a patient observation value, extending the base patient observation value type.
 /// </summary>
+/// <!-- aidoc:v1 sig=ff618b7 -->
 public class PatientObservationAlarm : BasePatientObservationValue
 {
     public InactivationState? InactivationState { get; set; }
@@ -33,6 +34,7 @@ public class PatientObservationAlarm : BasePatientObservationValue
 /// <summary>
 /// Represents a state indicating that an entity or process is currently inactive.
 /// </summary>
+/// <!-- aidoc:v1 sig=f773cd9 -->
 public class InactivationState
 {
     public AlarmEnum.AudioVideoState? Audio { get; set; }
@@ -43,6 +45,7 @@ public class InactivationState
 /// <summary>
 /// Represents a source entity, serving as a base or generic type for defining source-related data or behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=8435b92 -->
 public class Source
 {
     public string? Code { get; set; }
diff --git a/adas-core.Domain/Models/PatientRecordingAlert.cs b/adas-core.Domain/Models/PatientRecordingAlert.cs
index 229eb702..728a23a3 100644
--- a/adas-core.Domain/Models/PatientRecordingAlert.cs
+++ b/adas-core.Domain/Models/PatientRecordingAlert.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// Inherits common observation functionality from <see cref="BasePatientObservation"/> and specializes it to surface alert conditions associated with patient recordings.
 /// </remarks>
+/// <!-- aidoc:v1 sig=54d15ef -->
 public class PatientRecordingAlert : BasePatientObservation
 {
     public bool IsRecording { get; set; }
@@ -14,6 +15,7 @@ public class PatientRecordingAlert : BasePatientObservation
     /// Returns a string representation of the PatientRecordingAlert, including the patient identifier, source name when available, recording status, and time.
     /// </summary>
     /// <returns>A formatted string representation of the alert's key properties.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=c094493 -->
     public override string ToString()
         {
             var items = ToListString();
diff --git a/adas-core.Domain/Models/PatientTreatment.cs b/adas-core.Domain/Models/PatientTreatment.cs
index 4dec7f71..9d471712 100644
--- a/adas-core.Domain/Models/PatientTreatment.cs
+++ b/adas-core.Domain/Models/PatientTreatment.cs
@@ -13,6 +13,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// This converter overrides the default JSON conversion behavior to control how <see cref="PatientTreatment"/> objects are written to and read from JSON.
 /// </remarks>
+/// <!-- aidoc:v1 sig=ce9ac9e -->
 public class PatientTreatment : JsonConverter
 {
     //If bolopom plus to bolus opiates.
@@ -86,6 +87,8 @@ public class PatientTreatment : JsonConverter
     /// Returns a string representation of the PatientTreatment instance, including its core identifiers, order details, timing fields, requested give codes, notes, and routes. Non-null or non-empty properties are appended to the output, and in case of an exception during formatting, an error message containing the exception detail is returned instead.
     /// </summary>
     /// <returns>A formatted string summarizing the PatientTreatment fields, or an error message if formatting fails.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states 'Non-null or non-empty properties are appended to the output', but several properties (Id, PatientId, OrderControl, SingleDose, BoloPom, MessageTime) are always appended without a null/empty check." -->
     public override string ToString()
         {
             try
@@ -147,6 +150,8 @@ public class PatientTreatment : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> to which the JSON representation of the value will be written.</param>
     /// <param name="value">The object to serialize. If null, the method performs no action.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used to perform the serialization of nested objects.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The `serializer` parameter is described as 'used to perform the serialization of nested objects', but the method body never references it (serialization is performed via JObject.FromObject(value) and jo.WriteTo(writer))." -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -165,6 +170,7 @@ public class PatientTreatment : JsonConverter
     /// </summary>
     /// <param name="value">The object instance whose property should receive the attribute.</param>
     /// <param name="propertyName">The name of the property to which the attribute will be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -199,6 +205,8 @@ public class PatientTreatment : JsonConverter
     /// <param name="serializer">The <see cref="JsonSerializer"/> invoking this converter.</param>
     /// <returns>An object of the specified type deserialized from the JSON.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The <returns> tag states the method returns 'An object of the specified type deserialized from the JSON', but the method unconditionally throws NotImplementedException and never returns a value. The summary and exception tag do clarify this, so the impact on readers is limited." -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -211,6 +219,10 @@ public class PatientTreatment : JsonConverter
     /// <param name="objectType">The type to check for conversion support.</param>
     /// <returns><see langword="true"/> if the converter can convert the specified type; otherwise, <see langword="false"/>.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method is not yet implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The method always throws NotImplementedException and never returns a boolean value, so the documented return contract (true/false) is inaccurate." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The summary states the method 'determines whether the converter can convert the specified type', but the implementation does not perform any determination; it unconditionally throws." -->
     public override bool CanConvert(Type objectType)
         {
             throw new NotImplementedException();
diff --git a/adas-core.Domain/Models/Person.cs b/adas-core.Domain/Models/Person.cs
index 69f66190..46847379 100644
--- a/adas-core.Domain/Models/Person.cs
+++ b/adas-core.Domain/Models/Person.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// Implements <see cref="IEquatable{T}"/> to define a strongly typed Equals(T)"/> method for comparing <see cref="Person"/> objects.
 /// </remarks>
+/// <!-- aidoc:v1 sig=792beb2 -->
 public class Person : IEquatable<Person>
 {
     public string? LastName { get; set; }
@@ -34,6 +35,7 @@ public class Person : IEquatable<Person>
     /// </summary>
     /// <param name="other">The <see cref="Person"/> to compare with the current instance.</param>
     /// <returns><c>true</c> if all compared personal attributes and identifiers match; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d70c130 body=f4868ed -->
     public bool Equals(Person? other)
         {
             return other != null &&
@@ -50,6 +52,7 @@ public class Person : IEquatable<Person>
     /// </summary>
     /// <param name="patientIds">The dictionary of patient identifiers to assign as the current identifiers and to record historically.</param>
     /// <param name="time">The optional timestamp for the historical entry. If <c>null</c>, <see cref="DateTime.UtcNow"/> is used.</param>
+    /// <!-- aidoc:v1 sig=8a58d68 body=eb77bd1 -->
     public void SetIds(Dictionary<string, string> patientIds, DateTime? time = null)
         {
             Ids = patientIds;
@@ -76,6 +79,7 @@ public class Person : IEquatable<Person>
     /// Determines whether the patient instance contains no meaningful data by checking that the last name, first name, second name, and birth date are unset, the gender is unknown, and the identifiers collection is null or empty.
     /// </summary>
     /// <returns><c>true</c> if all relevant patient fields are null, empty, or set to their default unknown value; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1112d99 body=1f0316a -->
     public bool IsEmpty()
         {
             return string.IsNullOrEmpty(LastName) && string.IsNullOrEmpty(FirstName) && string.IsNullOrEmpty(SecondName) &&
@@ -88,6 +92,7 @@ public class Person : IEquatable<Person>
     /// and the gender is set to <see cref="PatientEnum.Gender.Unknown"/>.
     /// </summary>
     /// <returns><c>true</c> if the patient's personal data fields are empty and gender is unknown; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=739b42e body=f60ba9c -->
     public bool IsEmptyDontCheckIds()
         {
             return string.IsNullOrEmpty(LastName) && string.IsNullOrEmpty(FirstName) && string.IsNullOrEmpty(SecondName) &&
@@ -104,6 +109,7 @@ public class Person : IEquatable<Person>
     /// </summary>
     /// <param name="other">The other <see cref="Person"/> whose identifiers are compared against this instance.</param>
     /// <returns><c>true</c> if both identifier collections are <c>null</c> or contain the same key-value pairs; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=f4e9bea body=25ffbb5 -->
     private bool CheckIdsAreEqual(Person other)
         {
             if (Ids == null && other.Ids == null) return true;
@@ -138,6 +144,7 @@ public class Person : IEquatable<Person>
     /// Returns a string representation of the Person, including the non-empty/non-null properties such as first name, last name, second name, birth date, language, gender, and identifiers.
     /// </summary>
     /// <returns>A formatted string in the form "Person[prop1: value1, prop2: value2, ...]" containing the person's populated fields.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=b0cb4aa -->
     public override string ToString()
         {
             List<string> items = [];
diff --git a/adas-core.Domain/Models/PersonResource.cs b/adas-core.Domain/Models/PersonResource.cs
index 217c0f33..9c02003d 100644
--- a/adas-core.Domain/Models/PersonResource.cs
+++ b/adas-core.Domain/Models/PersonResource.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a Person resource, typically used as a data transfer or API resource model for person-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=10daa23 -->
 public class PersonResource
 {
     public Person? Person { get; set; }
diff --git a/adas-core.Domain/Models/PersonResourceAction.cs b/adas-core.Domain/Models/PersonResourceAction.cs
index cc664184..ccec8297 100644
--- a/adas-core.Domain/Models/PersonResourceAction.cs
+++ b/adas-core.Domain/Models/PersonResourceAction.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// Typically used to model operations, commands, or permissions associated with a person entity within a resource-based system.
 /// </remarks>
+/// <!-- aidoc:v1 sig=ca1fc37 -->
 public class PersonResourceAction
 {
     public ActionsEnum.ResourceAction? Action { get; set; }
@@ -22,6 +23,7 @@ public class PersonResourceAction
     /// </summary>
     /// <param name="actions">The list of actions to be applied.</param>
     /// <returns>A <see cref="List{PersonResource}"/> containing the result of applying the actions.</returns>
+    /// <!-- aidoc:v1 sig=1cb6d40 body=22d71fc -->
     public static List<PersonResource>? Apply(List<PersonResourceAction> actions)
         {
             return Apply(null, actions);
@@ -34,6 +36,7 @@ public class PersonResourceAction
     /// <param name="source">The source list of person resources to mutate. If null, an empty list is used.</param>
     /// <param name="actions">The list of resource actions (add, delete, update) to apply to the source. If null, no actions are applied.</param>
     /// <returns>The resulting list of person resources after applying the actions, or null if the resulting list is empty.</returns>
+    /// <!-- aidoc:v1 sig=97e8c77 body=f0632c0 -->
     public static List<PersonResource>? Apply(List<PersonResource>? source, List<PersonResourceAction>? actions)
         {
             source ??= [];
diff --git a/adas-core.Domain/Models/Providers/ProvidersSettings.cs b/adas-core.Domain/Models/Providers/ProvidersSettings.cs
index a734a0c5..589cf115 100644
--- a/adas-core.Domain/Models/Providers/ProvidersSettings.cs
+++ b/adas-core.Domain/Models/Providers/ProvidersSettings.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the configuration settings used to manage and configure providers within the application.
 /// </summary>
+/// <!-- aidoc:v1 sig=7fdd003 -->
 public class ProvidersSettings
 {
     public string Name { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/Providers/ResultModelPredictMedicationADAS.cs b/adas-core.Domain/Models/Providers/ResultModelPredictMedicationADAS.cs
index b2c398f7..5abc5598 100644
--- a/adas-core.Domain/Models/Providers/ResultModelPredictMedicationADAS.cs
+++ b/adas-core.Domain/Models/Providers/ResultModelPredictMedicationADAS.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class is intended to be inherited by concrete result model types that provide specific prediction logic for medication-related ADAS assessments.
 /// </remarks>
+/// <!-- aidoc:v1 sig=43f9384 -->
 public abstract class ResultModelPredictMedicationAdas
 {
     public string MedicineIdentifier { get; set; } = string.Empty;
@@ -28,6 +29,7 @@ public abstract class ResultModelPredictMedicationAdas
     /// Returns a string representation combining the medicine text and its degree of similarity, separated by a pipe character.
     /// </summary>
     /// <returns>A formatted string containing the <c>MedicineText</c> and <c>DegreeSimilarity</c> values joined by a pipe (<c>|</c>) separator.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=1c1a8a5 -->
     public override string ToString()
         {
             return $"{MedicineText} | {DegreeSimilarity}";
diff --git a/adas-core.Domain/Models/Providers/ResultModelPredictOfStayADAS.cs b/adas-core.Domain/Models/Providers/ResultModelPredictOfStayADAS.cs
index 0c874a30..49467e85 100644
--- a/adas-core.Domain/Models/Providers/ResultModelPredictOfStayADAS.cs
+++ b/adas-core.Domain/Models/Providers/ResultModelPredictOfStayADAS.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This type serves as a data container for prediction outcomes produced by the ADAS stay prediction process.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c42766f -->
 public class ResultModelPredictOfStayAdas
 {
     public string Result { get; set; } = string.Empty;
@@ -19,6 +20,7 @@ public class ResultModelPredictOfStayAdas
 /// <remarks>
 /// As an abstract class, <see cref="Payload"/> cannot be instantiated directly and must be extended by a concrete subclass.
 /// </remarks>
+/// <!-- aidoc:v1 sig=f182851 -->
 public abstract class Payload
 {
     public double PercentageMin { get; set; }
diff --git a/adas-core.Domain/Models/Pumps/CommonPumpTypes.cs b/adas-core.Domain/Models/Pumps/CommonPumpTypes.cs
index 626a0ee4..afdbd0ba 100644
--- a/adas-core.Domain/Models/Pumps/CommonPumpTypes.cs
+++ b/adas-core.Domain/Models/Pumps/CommonPumpTypes.cs
@@ -4,6 +4,7 @@
 /// Serves as an abstract base class for representing common pump types.
 /// Provides a shared foundation for derived classes that define specific pump categorizations.
 /// </summary>
+/// <!-- aidoc:v1 sig=ae2d216 -->
 public abstract class CommonPumpTypes
 {
     // Tipos auxiliares para valores con unidades (idénticos a PatientPumpObservation pero anidados aquí)
@@ -11,6 +12,7 @@ public abstract class CommonPumpTypes
     /// <summary>
     /// Represents a value associated with a pump operation or measurement.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e6d5f09 -->
     public class PumpValue
     {
         public double? Value { get; set; }
@@ -19,12 +21,14 @@ public abstract class CommonPumpTypes
         /// Returns a string representation of the measurement, including its value and units.
         /// </summary>
         /// <returns>A formatted string containing the Value and Units of the measurement.</returns>
+        /// <!-- aidoc:v1 sig=e168502 -->
         public override string ToString() => $"{{Value: {Value}, Units: {Units}}}";
     }
 
     /// <summary>
     /// Represents a container for detailed information about a syringe.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1b49f09 -->
     public class SyringeDetails
     {
         public string? Type { get; set; }
diff --git a/adas-core.Domain/Models/Pumps/PumpAlarmEvent.cs b/adas-core.Domain/Models/Pumps/PumpAlarmEvent.cs
index 7c02038d..ae9141c5 100644
--- a/adas-core.Domain/Models/Pumps/PumpAlarmEvent.cs
+++ b/adas-core.Domain/Models/Pumps/PumpAlarmEvent.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.Pumps;
 /// <summary>
 /// Represents an event related to a pump alarm, encapsulating data raised when an alarm condition is detected on a pump.
 /// </summary>
+/// <!-- aidoc:v1 sig=6cc55e2 -->
 public class PumpAlarmEvent
 {
     public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/Pumps/PumpAlarmState.cs b/adas-core.Domain/Models/Pumps/PumpAlarmState.cs
index 50167566..f29bda10 100644
--- a/adas-core.Domain/Models/Pumps/PumpAlarmState.cs
+++ b/adas-core.Domain/Models/Pumps/PumpAlarmState.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.Pumps
     /// Una fila por alarma activa (DeviceId + AlarmType o AlarmCodeMdc).
     /// Se actualiza vía PumpService: start/continue → upsert, end → delete.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d93ddd8 -->
     public class PumpAlarmState
     {
         public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/Pumps/PumpObservation.cs b/adas-core.Domain/Models/Pumps/PumpObservation.cs
index 87ee5193..892ef71e 100644
--- a/adas-core.Domain/Models/Pumps/PumpObservation.cs
+++ b/adas-core.Domain/Models/Pumps/PumpObservation.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.Pumps
     /// de observaciones (PCD-01/10), alarmas (PCD-04) y eventos. El servicio
     /// decidirá cómo dividir y persistir en las colecciones destino.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7ac2d51 -->
     public class PumpObservation
     {
         public ObjectId Id { get; set; } 
diff --git a/adas-core.Domain/Models/Pumps/PumpState.cs b/adas-core.Domain/Models/Pumps/PumpState.cs
index ce0b058e..ff78eb2a 100644
--- a/adas-core.Domain/Models/Pumps/PumpState.cs
+++ b/adas-core.Domain/Models/Pumps/PumpState.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.Pumps
     /// Se sobrescribe con cada mensaje del HL7.
     /// Contiene siempre el último valor conocido de la bomba.
     /// </summary>
+    /// <!-- aidoc:v1 sig=86a0766 -->
     public class PumpState
     {
         public ObjectId Id { get; set; }
diff --git a/adas-core.Domain/Models/Recording/AccessGrant.cs b/adas-core.Domain/Models/Recording/AccessGrant.cs
index 0ef7dfa9..037997b6 100644
--- a/adas-core.Domain/Models/Recording/AccessGrant.cs
+++ b/adas-core.Domain/Models/Recording/AccessGrant.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a grant of access, typically used to convey permissions or authorization rights within a system.
 /// </summary>
+/// <!-- aidoc:v1 sig=5e5541d -->
 public class AccessGrant
 {
     private int _expiresIn;
diff --git a/adas-core.Domain/Models/Recording/Patient.cs b/adas-core.Domain/Models/Recording/Patient.cs
index e9d1674d..b29e4301 100644
--- a/adas-core.Domain/Models/Recording/Patient.cs
+++ b/adas-core.Domain/Models/Recording/Patient.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a patient entity within the system, encapsulating patient-related data and behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=902d058 -->
 public class Patient
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/Recording/RecordingData.cs b/adas-core.Domain/Models/Recording/RecordingData.cs
index 554ab1bf..d044df6d 100644
--- a/adas-core.Domain/Models/Recording/RecordingData.cs
+++ b/adas-core.Domain/Models/Recording/RecordingData.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.Recording;
 /// <summary>
 /// Represents a data container for recording-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=636c263 -->
 public class RecordingData
 {
     public Patient? Patient { get; set; }
@@ -25,6 +26,7 @@ public class RecordingData
     /// Generates a unique store identifier by combining the RoomId with the current timestamp formatted as yyyyMMdd-HHmmss, and assigns it to the Store property.
     /// </summary>
     /// <returns>A formatted store identifier string in the pattern "RoomId_yyyyMMdd-HHmmss".</returns>
+    /// <!-- aidoc:v1 sig=1148b1b body=f0bd2b9 -->
     public string GenerateStore()
         {
             return Store = $"{RoomId}_{DateTime.Now:yyyyMMdd-HHmmss}";
@@ -34,6 +36,7 @@ public class RecordingData
     /// Returns a compact JSON representation of the current object. If JSON serialization fails for any reason, falls back to the base <see cref="object.ToString"/> implementation.
     /// </summary>
     /// <returns>A JSON string produced by <see cref="JsonConvert.SerializeObject(object, Formatting)"/> with <see cref="Formatting.None"/>, or the result of the base <see cref="object.ToString"/> when serialization throws.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=374af05 -->
     public override string ToString()
         {
             try
diff --git a/adas-core.Domain/Models/Responses/BeaconResponse.cs b/adas-core.Domain/Models/Responses/BeaconResponse.cs
index 4d4f3183..1cc1c4f1 100644
--- a/adas-core.Domain/Models/Responses/BeaconResponse.cs
+++ b/adas-core.Domain/Models/Responses/BeaconResponse.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Models.Responses;
 /// <remarks>
 /// Implements <see cref="IEquatable{T}"/> to enable value-based equality comparison between <see cref="BeaconResponse"/> instances.
 /// </remarks>
+/// <!-- aidoc:v1 sig=47c826a -->
 public class BeaconResponse(string color, ObjectId poc, ObjectId unitId) : IEquatable<BeaconResponse>
 {
     private string Color { get; } = color;
@@ -20,6 +21,7 @@ public class BeaconResponse(string color, ObjectId poc, ObjectId unitId) : IEqua
     /// </summary>
     /// <param name="other">The <see cref="BeaconResponse"/> to compare with the current instance.</param>
     /// <returns><see langword="true"/> if both <c>PointOfCareId</c> and <c>UnitId</c> match; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=dc8b593 body=afe9f08 -->
     public bool Equals(BeaconResponse? other)
         {
             return PointOfCareId == other?.PointOfCareId && UnitId == other.UnitId;
@@ -29,6 +31,7 @@ public class BeaconResponse(string color, ObjectId poc, ObjectId unitId) : IEqua
     /// Returns a string representation of the BeaconResponse, including the point of care identifier, unit (bed) identifier, and color.
     /// </summary>
     /// <returns>A formatted string describing the beacon's point of care, unit, and color.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=c53ecf7 -->
     public override string ToString()
         {
             return "BeaconResponse[pointOfCare: " + PointOfCareId + ", bed: " + UnitId + ", color: " + Color + "]";
diff --git a/adas-core.Domain/Models/Responses/BoxObservationsResponse.cs b/adas-core.Domain/Models/Responses/BoxObservationsResponse.cs
index 5bf35a2f..de6c4d32 100644
--- a/adas-core.Domain/Models/Responses/BoxObservationsResponse.cs
+++ b/adas-core.Domain/Models/Responses/BoxObservationsResponse.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.Responses;
 /// <summary>
 /// Represents a response containing a collection of observations related to a box.
 /// </summary>
+/// <!-- aidoc:v1 sig=75c632e -->
 public class BoxObservationsResponse
 {
     public List<Medication> Medication = [];
diff --git a/adas-core.Domain/Models/Responses/DisplayConfigMinimalResponse.cs b/adas-core.Domain/Models/Responses/DisplayConfigMinimalResponse.cs
index 2d4cb31e..2d872e29 100644
--- a/adas-core.Domain/Models/Responses/DisplayConfigMinimalResponse.cs
+++ b/adas-core.Domain/Models/Responses/DisplayConfigMinimalResponse.cs
@@ -10,6 +10,7 @@ namespace adas_core.Domain.Models.Responses;
 /// <remarks>
 /// This class is typically used to convey a lightweight subset of display configuration information in API responses or inter-component communication.
 /// </remarks>
+/// <!-- aidoc:v1 sig=7a9b7f7 -->
 public class DisplayConfigMinimalResponse
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/Responses/LoginResponse.cs b/adas-core.Domain/Models/Responses/LoginResponse.cs
index 5e679bc1..2bfcb307 100644
--- a/adas-core.Domain/Models/Responses/LoginResponse.cs
+++ b/adas-core.Domain/Models/Responses/LoginResponse.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the response data returned from a login operation.
 /// </summary>
+/// <!-- aidoc:v1 sig=ac3742e -->
 public class LoginResponse
 {
     public string Token { get; set; } = "";
@@ -14,6 +15,7 @@ public class LoginResponse
     /// Returns <c>true</c> when the expiration date has passed, or when no expiration date has been set (i.e., <see cref="DateTime.MinValue"/>), treating unset expirations as expired.
     /// </summary>
     /// <returns><c>true</c> if the item is expired or has no expiration date set; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=f667915 body=3966309 -->
     public bool IsExpired()
         {
             if (Expiration != DateTime.MinValue)
diff --git a/adas-core.Domain/Models/Responses/PaginationResponse.cs b/adas-core.Domain/Models/Responses/PaginationResponse.cs
index 537145c1..c62003ca 100644
--- a/adas-core.Domain/Models/Responses/PaginationResponse.cs
+++ b/adas-core.Domain/Models/Responses/PaginationResponse.cs
@@ -4,6 +4,7 @@
 /// Represents a generic response wrapper for paginated data, typically used to return a subset of items along with associated pagination metadata.
 /// </summary>
 /// <typeparam name="T">The type of the items contained in the paginated response.</typeparam>
+/// <!-- aidoc:v1 sig=3c8b06d -->
 public class PaginationResponse<T>
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/Responses/Response.cs b/adas-core.Domain/Models/Responses/Response.cs
index 81989a9d..cc181e7e 100644
--- a/adas-core.Domain/Models/Responses/Response.cs
+++ b/adas-core.Domain/Models/Responses/Response.cs
@@ -4,6 +4,7 @@
 /// Represents a generic response wrapper that encapsulates a payload of type <typeparamref name="T"/> along with associated response metadata.
 /// </summary>
 /// <typeparam name="T">The type of the payload contained within the response.</typeparam>
+/// <!-- aidoc:v1 sig=1410d00 -->
 public class Response<T>
 {
     /// <summary>
diff --git a/adas-core.Domain/Models/SignalR/Message.cs b/adas-core.Domain/Models/SignalR/Message.cs
index 3bc125ab..58360f33 100644
--- a/adas-core.Domain/Models/SignalR/Message.cs
+++ b/adas-core.Domain/Models/SignalR/Message.cs
@@ -7,6 +7,7 @@ namespace adas_core.Domain.Models.SignalR;
 /// <summary>
 /// Represents a message, typically used for communication or data transfer between components.
 /// </summary>
+/// <!-- aidoc:v1 sig=efb0732 -->
 public class Message
 {
     public long IdMessage { get; set; }
@@ -30,6 +31,7 @@ public class Message
     /// Returns a JSON representation of the current object, falling back to the default <see cref="object.ToString"/> implementation if serialization fails.
     /// </summary>
     /// <returns>A JSON-formatted string describing the object, or the result of the base <see cref="object.ToString"/> method if serialization throws an exception.</returns>
+    /// <!-- aidoc:v1 sig=483eaf3 body=acdb440 -->
     public override string? ToString()
         {
             try
diff --git a/adas-core.Domain/Models/SignalR/MessageData.cs b/adas-core.Domain/Models/SignalR/MessageData.cs
index 1e02ae03..908ee819 100644
--- a/adas-core.Domain/Models/SignalR/MessageData.cs
+++ b/adas-core.Domain/Models/SignalR/MessageData.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.SignalR;
 /// <summary>
 /// Represents data associated with a message, providing a structure for storing and transporting message-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=cec5c86 -->
 public class MessageData
 {
     public bool IsDemo { get; set; } = false;
diff --git a/adas-core.Domain/Models/SignalR/Recording.cs b/adas-core.Domain/Models/SignalR/Recording.cs
index 3c3404df..51b415d2 100644
--- a/adas-core.Domain/Models/SignalR/Recording.cs
+++ b/adas-core.Domain/Models/SignalR/Recording.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Models.SignalR;
 /// <summary>
 /// Represents a recording, encapsulating data and behavior associated with a captured event or media.
 /// </summary>
+/// <!-- aidoc:v1 sig=962065d -->
 public class Recording
 {
     public string Id { get; set; } = null!;
diff --git a/adas-core.Domain/Models/SystemAlerts/ApiClients.cs b/adas-core.Domain/Models/SystemAlerts/ApiClients.cs
index 6949bd8d..347a7399 100644
--- a/adas-core.Domain/Models/SystemAlerts/ApiClients.cs
+++ b/adas-core.Domain/Models/SystemAlerts/ApiClients.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a collection or container of API client instances, providing centralized access to various external service clients.
 /// </summary>
+/// <!-- aidoc:v1 sig=fe2df96 -->
 public class ApiClients
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/SystemAlerts/Performance.cs b/adas-core.Domain/Models/SystemAlerts/Performance.cs
index 8de931fd..2d400dfa 100644
--- a/adas-core.Domain/Models/SystemAlerts/Performance.cs
+++ b/adas-core.Domain/Models/SystemAlerts/Performance.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a performance-related entity, such as a metric, measurement, or record used to track and evaluate performance data.
 /// </summary>
+/// <!-- aidoc:v1 sig=e556192 -->
 public class Performance
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/SystemAlerts/Queue.cs b/adas-core.Domain/Models/SystemAlerts/Queue.cs
index cb8aee6e..a49dc738 100644
--- a/adas-core.Domain/Models/SystemAlerts/Queue.cs
+++ b/adas-core.Domain/Models/SystemAlerts/Queue.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a queue, a data structure that follows the First In, First Out (FIFO) principle for managing elements.
 /// </summary>
+/// <!-- aidoc:v1 sig=e234fc6 -->
 public class Queue
 {
     public string? Name { get; set; }
diff --git a/adas-core.Domain/Models/Timing.cs b/adas-core.Domain/Models/Timing.cs
index 323be73e..adf4e28c 100644
--- a/adas-core.Domain/Models/Timing.cs
+++ b/adas-core.Domain/Models/Timing.cs
@@ -4,6 +4,7 @@
 /// Represents a utility or component related to timing operations.
 /// Provides functionality for measuring, tracking, or managing time-related behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=c359098 -->
 public class Timing
 {
     public DateTime? StartTime { get; set; }
diff --git a/adas-core.Domain/Models/TreatmentRoute.cs b/adas-core.Domain/Models/TreatmentRoute.cs
index 7175698e..139fb753 100644
--- a/adas-core.Domain/Models/TreatmentRoute.cs
+++ b/adas-core.Domain/Models/TreatmentRoute.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a treatment route, defining the pathway or method by which a treatment is administered or delivered.
 /// </summary>
+/// <!-- aidoc:v1 sig=bcc07b7 -->
 public class TreatmentRoute
 {
     public Code? Route { get; set; }
@@ -11,6 +12,7 @@ public class TreatmentRoute
     /// Returns a string representation of the treatment route, including the route code when available.
     /// </summary>
     /// <returns>A formatted string identifying the treatment route, with the route code appended if <c>Route</c> is not null.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=8a0f0f8 -->
     public override string ToString()
         {
             List<string> items = [];
diff --git a/adas-core.Domain/Models/UiConfig.cs b/adas-core.Domain/Models/UiConfig.cs
index 25bfdf2b..fb5ebb41 100644
--- a/adas-core.Domain/Models/UiConfig.cs
+++ b/adas-core.Domain/Models/UiConfig.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents the configuration settings for the user interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=08d6397 -->
 public class UiConfig
 {
     public Dictionary<string, object>? UiConfiguration;
diff --git a/adas-core.Domain/Models/ValueConfig.cs b/adas-core.Domain/Models/ValueConfig.cs
index 4a1cd98c..11a65b2b 100644
--- a/adas-core.Domain/Models/ValueConfig.cs
+++ b/adas-core.Domain/Models/ValueConfig.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a value configuration entity used to encapsulate configurable data or settings.
 /// </summary>
+/// <!-- aidoc:v1 sig=4971e75 -->
 public class ValueCondif
 {
     public string Obsid { get; set; } = string.Empty;
diff --git a/adas-core.Domain/Models/WebMessageNotification.cs b/adas-core.Domain/Models/WebMessageNotification.cs
index f4096ff1..b3cb6aa5 100644
--- a/adas-core.Domain/Models/WebMessageNotification.cs
+++ b/adas-core.Domain/Models/WebMessageNotification.cs
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This type encapsulates the data required to send or describe a web message notification to a recipient.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b519c56 -->
 public class WebMessageNotification
 {
     //{"notification":
diff --git a/adas-core.Domain/Permissions.cs b/adas-core.Domain/Permissions.cs
index 1abdfa53..6534e323 100644
--- a/adas-core.Domain/Permissions.cs
+++ b/adas-core.Domain/Permissions.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain;
 /// <summary>
 /// Represents a set of permissions, providing functionality related to access control and authorization.
 /// </summary>
+/// <!-- aidoc:v1 sig=3ca0f1a -->
 public class Permissions
 {
     public SourcePermissions Write { get; set; } = new()
@@ -24,6 +25,7 @@ public class Permissions
 /// <remarks>
 /// This class encapsulates permission-related information for a given source context.
 /// </remarks>
+/// <!-- aidoc:v1 sig=7b1538b -->
 public class SourcePermissions
 {
     public List<ActionsEnum.Actions> Actions { get; set; } = [];
diff --git a/adas-core.Domain/QueryCustomizer.cs b/adas-core.Domain/QueryCustomizer.cs
index b808da71..1106037f 100644
--- a/adas-core.Domain/QueryCustomizer.cs
+++ b/adas-core.Domain/QueryCustomizer.cs
@@ -29,6 +29,7 @@ namespace adas_core.Domain;
 /// </code>
 ///     </example>
 /// </summary>
+/// <!-- aidoc:v1 sig=0f0f12f -->
 public class QueryCustomizer<T> where T : class
 {
     private readonly List<Expression<Func<T, object>>> _includeLinqExpressions = [];
@@ -38,6 +39,7 @@ public class QueryCustomizer<T> where T : class
     /// Creates and returns a new instance of the <see cref="QueryCustomizer{T}"/> class.
     /// </summary>
     /// <returns>A new <see cref="QueryCustomizer{T}"/> instance.</returns>
+    /// <!-- aidoc:v1 sig=21eb01d body=b0a5bab -->
     public static QueryCustomizer<T> New()
         {
             return new QueryCustomizer<T>();
@@ -48,6 +50,7 @@ public class QueryCustomizer<T> where T : class
     /// </summary>
     /// <param name="includeExpression">A lambda expression selecting the related entity to include in the query results.</param>
     /// <returns>The current <see cref="QueryCustomizer{T}"/> instance to allow fluent chaining of additional includes or customizations.</returns>
+    /// <!-- aidoc:v1 sig=404974a body=eeec9fd -->
     public QueryCustomizer<T> Include(Expression<Func<T, object>> includeExpression)
         {
             _includeLinqExpressions.Add(includeExpression);
@@ -59,6 +62,7 @@ public class QueryCustomizer<T> where T : class
     /// </summary>
     /// <param name="includeExpressions">The expressions specifying the related entities to include in the query.</param>
     /// <returns>The current <see cref="QueryCustomizer{T}"/> instance to support fluent method chaining.</returns>
+    /// <!-- aidoc:v1 sig=d7110f2 body=0a0314a -->
     public QueryCustomizer<T> Include(params Expression<Func<T, object>>[] includeExpressions)
         {
             _includeLinqExpressions.AddRange(includeExpressions);
@@ -70,6 +74,7 @@ public class QueryCustomizer<T> where T : class
     /// </summary>
     /// <param name="includeExpression">The include expression to be added to the collection of include expressions.</param>
     /// <returns>The current <see cref="QueryCustomizer{T}"/> instance with the include expression added.</returns>
+    /// <!-- aidoc:v1 sig=3bdcd2a body=f954d2e -->
     public QueryCustomizer<T> Include(string includeExpression)
         {
             _includeLinqStringExpressions.Add(includeExpression);
@@ -81,6 +86,7 @@ public class QueryCustomizer<T> where T : class
     /// </summary>
     /// <param name="includeExpressions">The string expressions representing the related entities or paths to include in the query.</param>
     /// <returns>The current <see cref="QueryCustomizer{T}"/> instance to enable fluent method chaining.</returns>
+    /// <!-- aidoc:v1 sig=684e75d body=681d029 -->
     public QueryCustomizer<T> Include(params string[] includeExpressions)
         {
             _includeLinqStringExpressions.AddRange(includeExpressions);
@@ -94,6 +100,7 @@ public class QueryCustomizer<T> where T : class
     /// </summary>
     /// <param name="queryable">The source queryable to which the include expressions will be applied.</param>
     /// <returns>An <see cref="IQueryable{T}"/> with all configured include expressions applied.</returns>
+    /// <!-- aidoc:v1 sig=5890dbb body=6eaed69 -->
     public IQueryable<T> AddToQueryable(IQueryable<T> queryable)
         {
             var resultQueryable = queryable;
diff --git a/adas-core.Domain/Utils/AuthUtils.cs b/adas-core.Domain/Utils/AuthUtils.cs
index 89ac6bea..cea0049b 100644
--- a/adas-core.Domain/Utils/AuthUtils.cs
+++ b/adas-core.Domain/Utils/AuthUtils.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// This class is sealed and cannot be inherited.
 /// </remarks>
+/// <!-- aidoc:v1 sig=830b168 -->
 public sealed class AuthUtils
 {
     private LoginResponse _loginResponse = new();
@@ -55,6 +56,7 @@ public sealed class AuthUtils
     /// Retrieves the current <see cref="LoginResponse"/> in a thread-safe manner by acquiring a lock on the underlying field.
     /// </summary>
     /// <returns>The current <see cref="LoginResponse"/> instance.</returns>
+    /// <!-- aidoc:v1 sig=041b791 body=ad62115 -->
     public LoginResponse GetLoginResponse()
         {
             lock (_loginResponse)
diff --git a/adas-core.Domain/Utils/BsonUtils.cs b/adas-core.Domain/Utils/BsonUtils.cs
index 930b2ffd..2308afca 100644
--- a/adas-core.Domain/Utils/BsonUtils.cs
+++ b/adas-core.Domain/Utils/BsonUtils.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for working with BSON (Binary JSON) data.
 /// </summary>
+/// <!-- aidoc:v1 sig=bd71742 -->
 public static class BsonUtils
 {
     /// <summary>
@@ -12,6 +13,7 @@ public static class BsonUtils
     /// </summary>
     /// <param name="val">The <see cref="BsonValue"/> instance to convert to a CLR object.</param>
     /// <returns>The underlying CLR value when <paramref name="val"/> is an Int32, Int64, Double, valid DateTime (in UTC), or String; otherwise <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=29fed77 body=dde4c14 -->
     public static object? ToObject(this BsonValue val)
         {
             if (val.IsInt32) return val.AsInt32;
@@ -33,6 +35,7 @@ public static class BsonUtils
     /// <param name="doc">The BSON document to search for the key.</param>
     /// <param name="key">The key of the value to retrieve.</param>
     /// <returns>The <see cref="BsonValue"/> associated with <paramref name="key"/>, or <c>null</c> if the key does not exist.</returns>
+    /// <!-- aidoc:v1 sig=1ab6e35 body=441c98c -->
     public static BsonValue? Get(this BsonDocument doc, string key)
         {
             return doc.TryGetValue(key, out var value) ? value : null;
diff --git a/adas-core.Domain/Utils/CacheUtils.cs b/adas-core.Domain/Utils/CacheUtils.cs
index a15a1019..ed263aa8 100644
--- a/adas-core.Domain/Utils/CacheUtils.cs
+++ b/adas-core.Domain/Utils/CacheUtils.cs
@@ -14,6 +14,7 @@ namespace adas_core.Domain.Utils
     ///  - Caída a GlobalSeconds del backend si no hay TTL específico
     ///  - Si el TTL resultante es null o menor o igual a 0 sin expiración
     /// </summary>
+    /// <!-- aidoc:v1 sig=d7c4909 -->
     public static class CacheKeyTtl
     {
         /// <summary>
@@ -21,6 +22,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="seconds">The number of seconds to convert.</param>
         /// <returns>A <see cref="TimeSpan"/> representing <paramref name="seconds"/>, or <c>null</c> when <paramref name="seconds"/> is <c>null</c> or less than or equal to zero.</returns>
+        /// <!-- aidoc:v1 sig=967178f -->
         private static TimeSpan? SecondsOrNull(int? seconds)
                     => seconds is > 0
                         ? TimeSpan.FromSeconds(seconds.Value)
@@ -32,6 +34,7 @@ namespace adas_core.Domain.Utils
         /// <param name="selector">A function that selects the desired <see cref="int?"/> value from a <see cref="TtlSettings"/> instance.</param>
         /// <param name="s">The cache settings whose in-memory TTL configuration is used as the source.</param>
         /// <returns>The nullable integer value produced by applying <paramref name="selector"/> to the in-memory <see cref="TtlSettings"/>.</returns>
+        /// <!-- aidoc:v1 sig=a263f69 -->
         private static int? FromInMemory(Func<TtlSettings, int?> selector, CacheSettings s)
                     => selector(s.InMemory.Ttl);
 
@@ -42,6 +45,7 @@ namespace adas_core.Domain.Utils
         /// <param name="selector">A function that derives a nullable integer from a <see cref="TtlSettings"/> instance, or null to short-circuit the operation.</param>
         /// <param name="s">The cache settings whose Redis TTL configuration will be inspected, or null to use a default <see cref="TtlSettings"/>.</param>
         /// <returns>The nullable integer produced by invoking the selector on the resolved <see cref="TtlSettings"/>, or null if the selector is null.</returns>
+        /// <!-- aidoc:v1 sig=219e390 -->
         private static int? FromRedis(Func<TtlSettings, int?>? selector, CacheSettings? s)
                     => selector?.Invoke(s?.Redis.Ttl ?? new TtlSettings());
 
@@ -50,6 +54,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="s">The cache settings containing the in-memory TTL configuration, or <c>null</c>.</param>
         /// <returns>A <see cref="TimeSpan"/> representing the global in-memory TTL converted from seconds, or <c>null</c> if <paramref name="s"/> is <c>null</c> or the global seconds value is not set.</returns>
+        /// <!-- aidoc:v1 sig=08c6cf7 -->
         private static TimeSpan? GlobalInMemory(CacheSettings? s)
                     => SecondsOrNull(s?.InMemory.Ttl.GlobalSeconds);
 
@@ -58,12 +63,19 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="s">The cache settings containing the Redis TTL configuration, or <c>null</c>.</param>
         /// <returns>A <see cref="TimeSpan"/> representing the global Redis TTL, or <c>null</c> if the configuration is unavailable.</returns>
+        /// <!-- aidoc:v1 sig=3ee947c -->
         private static TimeSpan? GlobalRedis(CacheSettings? s)
                     => SecondsOrNull(s?.Redis.Ttl.GlobalSeconds);
 
         /// <summary>
         /// Resuelve TTL para una entidad concreta, respetando el backend configurado para dicha entidad.
         /// </summary>
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'settings' (CacheSettings?) is not documented." -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+        ///      "Parameter 'entity' (CacheEnum.EntityType) is not documented." -->
+        /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+        ///      "Return value (TimeSpan?) is not documented." -->
         public static TimeSpan? ResolveForEntity(CacheSettings? settings, CacheEnum.EntityType entity)
         {
             // Selección del backend según la entidad
@@ -115,6 +127,7 @@ namespace adas_core.Domain.Utils
         /// <summary>
         /// Dada una clave, clasifica la entidad y resuelve el TTL para esa clave.
         /// </summary>
+        /// <!-- aidoc:v1 sig=e7e1d98 body=1fb058f -->
         public static TimeSpan? ResolveForKey(CacheSettings settings, string key)
         {
             var entity = CacheKeyClassifier.Classify(key);
@@ -129,6 +142,7 @@ namespace adas_core.Domain.Utils
     /// - Prefijos normalizados para que el CacheDispatcher clasifique el backend.
     /// - Overloads "KeyWithTtl" para devolver (key, ttl) en una llamada.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6c8a7c2 -->
     public static class CacheKeys
     {
         #region ConfigObservations
@@ -137,6 +151,7 @@ namespace adas_core.Domain.Utils
         /// Returns the configuration key string "configObservations:all", typically used to identify a setting or cache entry related to all configuration observations.
         /// </summary>
         /// <returns>The string "configObservations:all".</returns>
+        /// <!-- aidoc:v1 sig=588468f -->
         public static string ConfigObservationsAll()
                     => "configObservations:all";
 
@@ -163,6 +178,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="displayId">The identifier of the display whose base key is being generated.</param>
         /// <returns>A formatted key string combining the display section, the display identifier, and the "base" suffix.</returns>
+        /// <!-- aidoc:v1 sig=c78d13f -->
         public static string DisplayBase(ObjectId displayId)
                     => $"configDisplays:display:{displayId}:base";
         
@@ -172,6 +188,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">Optional cache settings used to resolve the TTL for display entities. When null, a default TTL is applied.</param>
         /// <param name="displayId">The identifier of the display used to compose the base cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL for the display entity.</returns>
+        /// <!-- aidoc:v1 sig=506cbc3 body=cd54390 -->
         public static (string Key, TimeSpan? Ttl) DisplayBaseKeyWithTtl(
                     CacheSettings? settings,
                     ObjectId displayId)
@@ -186,6 +203,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="displayId">The identifier of the display whose configuration key is being generated.</param>
         /// <returns>A formatted string key in the form "configDisplays:display:{displayId}:config" representing the display's configuration entry.</returns>
+        /// <!-- aidoc:v1 sig=034d7aa -->
         public static string DisplayWithConfig(ObjectId displayId)
                     => $"configDisplays:display:{displayId}:config";
 
@@ -195,6 +213,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">The cache settings used to resolve the TTL for the display entity; may be <c>null</c>.</param>
         /// <param name="displayId">The identifier of the display entity for which the cache key is generated.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be <c>null</c> if no TTL is configured.</returns>
+        /// <!-- aidoc:v1 sig=1334a3e body=0bbecb4 -->
         public static (string Key, TimeSpan? Ttl) DisplayWithConfigKeyWithTtl(
                     CacheSettings? settings,
                     ObjectId displayId)
@@ -212,6 +231,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="pocId">The unique identifier of the Point of Care entity whose base reference key is being generated.</param>
         /// <returns>A formatted string that combines the "pointOfCare" prefix, the provided <paramref name="pocId"/>, and the "base" suffix to uniquely identify the base resource of the Point of Care.</returns>
+        /// <!-- aidoc:v1 sig=76872a0 -->
         public static string PointOfCareBase(ObjectId pocId)
                     => $"pointOfCare:{pocId}:base";
         
@@ -221,6 +241,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">The cache settings used by the TTL resolver. May be null, in which case the resolver falls back to its default behavior.</param>
         /// <param name="pocId">The identifier of the Point of Care entity used to generate the cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be null when no expiration is configured.</returns>
+        /// <!-- aidoc:v1 sig=b4d58ed body=d0c1f0e -->
         public static (string Key, TimeSpan? Ttl) PointOfCareBaseKeyWithTtl(
                     CacheSettings? settings, ObjectId pocId)
                 {
@@ -234,6 +255,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="pocId">The identifier of the point of care used to compose the cache key.</param>
         /// <returns>A formatted cache key string in the form <c>pointOfCare:{pocId}:withInfo</c>.</returns>
+        /// <!-- aidoc:v1 sig=373f954 -->
         public static string PointOfCareWithInfoKeyWithTtl(ObjectId pocId)
                     => $"pointOfCare:{pocId}:withInfo";
 
@@ -243,6 +265,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">Optional cache settings used to resolve the TTL for the point of care entity. May be <c>null</c>.</param>
         /// <param name="pocId">The identifier of the point of care used to build the cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be <c>null</c> when no TTL is configured.</returns>
+        /// <!-- aidoc:v1 sig=e93cb06 body=e1c096f -->
         public static (string Key, TimeSpan? Ttl) PointOfCareWithInfoKeyWithTtl(
                     CacheSettings? settings, ObjectId pocId)
                 {
@@ -261,6 +284,7 @@ namespace adas_core.Domain.Utils
         /// <param name="fieldNames">The collection of field names to include in the key, normalized via <c>Normalize</c>.</param>
         /// <param name="last">Optional maximum number of recent observations to consider; when <c>null</c>, defaults to <c>0</c>.</param>
         /// <returns>A formatted cache key string combining the patient id, normalized field names, and the last value.</returns>
+        /// <!-- aidoc:v1 sig=6571377 -->
         public static string LatestObservations(ObjectId patientId, IEnumerable<string> fieldNames, int? last = null)
                     => $"patients:latestObs:{patientId}:{Normalize(fieldNames)}:{last ?? 0}";
 
@@ -273,6 +297,7 @@ namespace adas_core.Domain.Utils
         /// <param name="fieldNames">The collection of field names to include in the latest observations cache key.</param>
         /// <param name="last">The optional number of most recent observations to consider when building the cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL for the cache entry.</returns>
+        /// <!-- aidoc:v1 sig=c42ebf0 body=17e9521 -->
         public static (string Key, TimeSpan? Ttl) LatestObservationsKeyWithTtl(
                     CacheSettings? settings, ObjectId patientId, IEnumerable<string> fieldNames, int? last = null)
                 {
@@ -290,6 +315,7 @@ namespace adas_core.Domain.Utils
         /// <param name="patientId">The unique identifier of the patient whose latest pump observations are being requested.</param>
         /// <param name="last">The optional number of most recent pump observation entries to include; when null, zero is used as a fallback.</param>
         /// <returns>A formatted cache key string of the form <c>pumpObs:latest:{patientId}:{last}</c>, with <c>last</c> resolved to <c>0</c> when null.</returns>
+        /// <!-- aidoc:v1 sig=b2d398b -->
         public static string LatestPumps(ObjectId patientId, int? last = null)
                     => $"pumpObs:latest:{patientId}:{last ?? 0}";
 
@@ -300,6 +326,7 @@ namespace adas_core.Domain.Utils
         /// <param name="patientId">The identifier of the patient whose latest pump observations are being cached.</param>
         /// <param name="last">The optional maximum number of latest pump entries to include in the cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be <see langword="null"/> if no TTL is configured.</returns>
+        /// <!-- aidoc:v1 sig=480ebe1 body=28bba9f -->
         public static (string Key, TimeSpan? Ttl) LatestPumpsKeyWithTtl(
                     CacheSettings settings, ObjectId patientId, int? last = null)
                 {
@@ -316,6 +343,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="patientId">The unique identifier of the patient whose appointments are being keyed.</param>
         /// <returns>A formatted cache key string combining the patient identifier and the current UTC date.</returns>
+        /// <!-- aidoc:v1 sig=5ef1337 body=ac8edc0 -->
         public static string PatientAppointmentsToday(ObjectId patientId)
                 {
                     var dateKey = DateTime.UtcNow.ToString("yyyyMMdd");
@@ -328,6 +356,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">Optional cache settings used to resolve the TTL for the appointments entity.</param>
         /// <param name="patientId">The identifier of the patient whose appointments cache key is being generated.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be null when no TTL is configured.</returns>
+        /// <!-- aidoc:v1 sig=ff8616a body=e708272 -->
         public static (string Key, TimeSpan? Ttl) PatientAppointmentsTodayKeyWithTtl(
                     CacheSettings? settings,
                     ObjectId patientId)
@@ -342,6 +371,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="pocId">The identifier of the Point of Contact whose appointments are being keyed.</param>
         /// <returns>A formatted cache key string combining the PoC identifier and today's UTC date in <c>yyyyMMdd</c> format.</returns>
+        /// <!-- aidoc:v1 sig=86e2e65 body=2c278cf -->
         public static string PocAppointmentsToday(ObjectId pocId)
                 {
                     var dateKey = DateTime.UtcNow.ToString("yyyyMMdd");
@@ -354,6 +384,7 @@ namespace adas_core.Domain.Utils
         /// <param name="settings">The cache settings used to resolve the TTL; may be <c>null</c> when no settings are supplied.</param>
         /// <param name="pocId">The identifier of the Point of Care whose today's appointments cache key is being generated.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL as a nullable <see cref="TimeSpan"/>.</returns>
+        /// <!-- aidoc:v1 sig=55982d2 body=03e4a32 -->
         public static (string Key, TimeSpan? Ttl) PocAppointmentsTodayKeyWithTtl(
                     CacheSettings? settings,
                     ObjectId pocId)
@@ -372,6 +403,7 @@ namespace adas_core.Domain.Utils
         /// <param name="patientId">The unique identifier of the patient whose grouped observations are being addressed.</param>
         /// <param name="groupedFieldName">The name of the grouped field used to categorize the observations.</param>
         /// <returns>A formatted string in the pattern <c>groupedObs:{groupedFieldName}:patient:{patientId}</c>.</returns>
+        /// <!-- aidoc:v1 sig=66bcd8e -->
         public static string GroupedObs(ObjectId patientId, string groupedFieldName)
                     => $"groupedObs:{groupedFieldName}:patient:{patientId}";
 
@@ -382,6 +414,7 @@ namespace adas_core.Domain.Utils
         /// <param name="patientId">The identifier of the patient whose grouped observations are being cached.</param>
         /// <param name="groupedFieldName">The name of the grouped field used to compose the cache key.</param>
         /// <returns>A tuple containing the generated cache key and the resolved TTL, which may be <c>null</c> when no expiry is configured.</returns>
+        /// <!-- aidoc:v1 sig=2c64810 body=ce29e10 -->
         public static (string Key, TimeSpan? Ttl) GroupedObsKeyWithTtl(
                     CacheSettings? settings, ObjectId patientId, string groupedFieldName)
                 {
@@ -398,6 +431,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="items">The collection of strings to normalize.</param>
         /// <returns>A pipe-delimited string of the cleaned and sorted values, or an empty string if no valid entries are supplied.</returns>
+        /// <!-- aidoc:v1 sig=6dd057a -->
         public static string Normalize(IEnumerable<string> items)
                     => string.Join("|", items
                         .Where(s => !string.IsNullOrWhiteSpace(s))
@@ -411,6 +445,7 @@ namespace adas_core.Domain.Utils
     /// Clasificador de claves basado en prefijos.
     /// Permite al CacheDispatcher seleccionar el backend adecuado (Redis, InMemory, None).
     /// </summary>
+    /// <!-- aidoc:v1 sig=933c0c4 -->
     public static class CacheKeyClassifier
     {
         /// <summary>
@@ -421,6 +456,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="key">The cache key to classify.</param>
         /// <returns>The <see cref="CacheEnum.EntityType"/> that matches the key's prefix, or <see cref="CacheEnum.EntityType.Unknown"/> when no prefix is recognized.</returns>
+        /// <!-- aidoc:v1 sig=8dce21c body=135a132 -->
         public static CacheEnum.EntityType Classify(string key)
                 {
                     if (key.StartsWith("patients:", StringComparison.OrdinalIgnoreCase))
@@ -450,6 +486,7 @@ namespace adas_core.Domain.Utils
     /// <summary>
     /// Patrones para DeleteByPattern (Redis) u operaciones masivas por prefijo.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6408068 -->
     public static class CacheKeyPatterns
     {
         /// <summary>
@@ -457,6 +494,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="type">The entity type for which a cache key pattern is being generated.</param>
         /// <returns>A string representing the cache key pattern associated with the given entity type, or "*" if the entity type is not recognized.</returns>
+        /// <!-- aidoc:v1 sig=fc7e3c6 -->
         public static string ForEntity(CacheEnum.EntityType type)
                     => type switch
                     {
@@ -474,6 +512,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="prefix">The key prefix to match against.</param>
         /// <returns>A formatted string combining <paramref name="prefix"/> and ":*" used as a wildcard pattern.</returns>
+        /// <!-- aidoc:v1 sig=5dfcb40 -->
         public static string ByPrefix(string prefix)
                     => $"{prefix}:*";
 
@@ -483,6 +522,7 @@ namespace adas_core.Domain.Utils
         /// <param name="prefix">The category or context prefix prepended to the pattern.</param>
         /// <param name="patientId">The patient identifier used to scope the wildcard pattern.</param>
         /// <returns>A formatted pattern string in the form <c>{prefix}:*:{patientId}*</c>.</returns>
+        /// <!-- aidoc:v1 sig=1b8b063 -->
         public static string ByPatient(string prefix, string patientId)
                     => $"{prefix}:*:{patientId}*";
 
@@ -492,6 +532,7 @@ namespace adas_core.Domain.Utils
         /// <param name="prefix">The prefix segment to include at the beginning of the returned string.</param>
         /// <param name="date">The date segment to include at the end of the returned string.</param>
         /// <returns>A string formatted as <c>{prefix}:*:{date}</c>.</returns>
+        /// <!-- aidoc:v1 sig=5bc6f05 -->
         public static string ByDate(string prefix, string date)
                     => $"{prefix}:*:{date}";
     }
@@ -501,6 +542,7 @@ namespace adas_core.Domain.Utils
     /// Utilidad para extraer información estructurada útil para trazas.
     /// No usada por la lógica de caché, pero sí por logs y diagnósticos.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9ba5b41 -->
     public static class CacheKeyInspector
     {
         private static readonly Regex _patientRegex =
@@ -518,6 +560,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="key">The input string from which to extract the patient identifier.</param>
         /// <returns>The extracted patient identifier, or <c>null</c> if no match is found.</returns>
+        /// <!-- aidoc:v1 sig=1aa2718 body=b3a8f76 -->
         public static string? ExtractPatientId(string key)
                 {
                     var match = _patientRegex.Match(key);
@@ -529,6 +572,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="key">The grouped observation key to parse.</param>
         /// <returns>A tuple containing the extracted field name and patient identifier, or <c>(null, null)</c> if the key does not match the pattern.</returns>
+        /// <!-- aidoc:v1 sig=3435318 body=f175ccc -->
         public static (string? Field, string? PatientId) ExtractGroupedObservationInfo(string key)
                 {
                     var match = _groupedRegex.Match(key);
@@ -543,6 +587,7 @@ namespace adas_core.Domain.Utils
         /// </summary>
         /// <param name="key">The input string expected to contain a location and a date in <c>yyyyMMdd</c> format.</param>
         /// <returns>A tuple containing the extracted <c>Location</c> string and the parsed <c>Date</c>; either value may be <c>null</c> when extraction or parsing fails.</returns>
+        /// <!-- aidoc:v1 sig=45672a9 body=450f3c1 -->
         public static (string? Location, DateTime? Date) ExtractAppointmentInfo(string key)
                 {
                     var match = _appointmentDayRegex.Match(key);
diff --git a/adas-core.Domain/Utils/CardConfigExtensions.cs b/adas-core.Domain/Utils/CardConfigExtensions.cs
index c8e1478a..fe0fd7b5 100644
--- a/adas-core.Domain/Utils/CardConfigExtensions.cs
+++ b/adas-core.Domain/Utils/CardConfigExtensions.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// This class is a static container for extension methods that extend the capabilities of the <see cref="CardConfig"/> type.
 /// </remarks>
+/// <!-- aidoc:v1 sig=966db52 -->
 public static class CardConfigExtensions
 {
     // Método principal para extraer todos los nombres
diff --git a/adas-core.Domain/Utils/CollectionsUtils.cs b/adas-core.Domain/Utils/CollectionsUtils.cs
index 5b7dfb5e..22f8073b 100644
--- a/adas-core.Domain/Utils/CollectionsUtils.cs
+++ b/adas-core.Domain/Utils/CollectionsUtils.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for working with collections.
 /// </summary>
+/// <!-- aidoc:v1 sig=50818c2 -->
 public static class CollectionsUtils
 {
     /// <summary>
@@ -12,6 +13,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate.</param>
     /// <returns><see langword="true"/> if the list is null or empty; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=dfb5373 body=1cd2a38 -->
     public static bool IsNullOrEmpty<T>(this List<T>? value)
         {
             return value == null || !value.Any();
@@ -22,6 +24,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate.</param>
     /// <returns><see langword="true"/> if the list is <see langword="null"/> or empty; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=5038079 body=1cd2a38 -->
     public static bool IsEmptyOrNull<T>(List<T>? value)
         {
             return value == null || !value.Any();
@@ -32,6 +35,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate. May be <c>null</c>.</param>
     /// <returns><c>true</c> if <paramref name="value"/> is not <c>null</c> and contains one or more elements; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=2c3b8ff body=0269891 -->
     public static bool HasElements<T>(List<T>? value)
         {
             return value != null && value.Any();
@@ -42,6 +46,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate.</param>
     /// <returns><see langword="true"/> if the list is not null and contains at least one element; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=61945f3 body=2b7a733 -->
     public static bool IsNotEmpty<T>(List<T> value)
         {
             return !IsEmptyOrNull(value);
@@ -52,6 +57,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate; may be <see langword="null"/>.</param>
     /// <returns>The original <paramref name="value"/> if it is not null; otherwise, an empty <see cref="List{T}"/>.</returns>
+    /// <!-- aidoc:v1 sig=4b33799 body=5556777 -->
     public static List<T> EmptyIfNull<T>(List<T>? value)
         {
             return value ?? [];
@@ -62,6 +68,7 @@ public static class CollectionsUtils
     /// </summary>
     /// <param name="value">The list to evaluate.</param>
     /// <returns>The original <paramref name="value"/> when it is not null and not empty; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=a05f7fc body=74812a2 -->
     public static List<T>? NullIfEmpty<T>(List<T> value)
         {
             return IsEmptyOrNull(value) ? null : value;
@@ -73,6 +80,7 @@ public static class CollectionsUtils
     /// <param name="collection">The source collection whose elements are copied into the new array.</param>
     /// <param name="type">The element <see cref="Type"/> of the array to create.</param>
     /// <returns>A new <see cref="Array"/> of the specified type containing the elements copied from the collection.</returns>
+    /// <!-- aidoc:v1 sig=98732cd body=d08ef3a -->
     public static Array ToArray(ICollection collection, Type type)
         {
             var result = Array.CreateInstance(type, collection.Count);
@@ -86,6 +94,7 @@ public static class CollectionsUtils
     /// <param name="list">The list to evaluate for a null or empty state.</param>
     /// <param name="defaultList">The fallback list returned when <paramref name="list"/> is null or empty.</param>
     /// <returns>The original <paramref name="list"/> when it contains items; otherwise <paramref name="defaultList"/>.</returns>
+    /// <!-- aidoc:v1 sig=c865748 body=df53ea7 -->
     public static List<string> IfEmptyOrNull(List<string> list, List<string> defaultList)
         {
             return IsEmptyOrNull(list) ? defaultList : list;
diff --git a/adas-core.Domain/Utils/ComparableDictionary.cs b/adas-core.Domain/Utils/ComparableDictionary.cs
index a69eb402..41a71678 100644
--- a/adas-core.Domain/Utils/ComparableDictionary.cs
+++ b/adas-core.Domain/Utils/ComparableDictionary.cs
@@ -10,12 +10,14 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// Inherits from <see cref="Dictionary{TKey, TValue}"/> and enforces that both keys and values are non-nullable.
 /// </remarks>
+/// <!-- aidoc:v1 sig=1d1f5d7 -->
 public class ComparableDictionary<TKey, TValue> : Dictionary<TKey, TValue> where TKey : notnull where TValue : notnull
 {
     /// <summary>
     /// Generates a hash code for the collection by concatenating the string representations of all key-value pairs, separated by underscores and double percent signs, and returning the hash code of the resulting string.
     /// </summary>
     /// <returns>An integer hash code derived from the concatenated key-value pairs of the collection.</returns>
+    /// <!-- aidoc:v1 sig=eb26c4a body=e3340b4 -->
     public override int GetHashCode()
         {
             StringBuilder str = new();
diff --git a/adas-core.Domain/Utils/ComplexObjectValueTypeSerializer.cs b/adas-core.Domain/Utils/ComplexObjectValueTypeSerializer.cs
index 1d24596e..a851cceb 100644
--- a/adas-core.Domain/Utils/ComplexObjectValueTypeSerializer.cs
+++ b/adas-core.Domain/Utils/ComplexObjectValueTypeSerializer.cs
@@ -17,12 +17,14 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// Declared as a partial class, allowing its definition to be split across multiple files.
 /// </remarks>
+/// <!-- aidoc:v1 sig=bc11fa0 -->
 public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
 {
     /// <summary>
     /// Provides a compiled regular expression for matching MongoDB ObjectId references, such as <c>ObjectId("...")</c>, that wrap a 24-character hexadecimal identifier.
     /// </summary>
     /// <returns>A <see cref="Regex"/> that matches strings containing an <c>ObjectId</c> call with a 24-character hexadecimal value enclosed in delimiters.</returns>
+    /// <!-- aidoc:v1 sig=ebf18cf -->
     [GeneratedRegex("ObjectId\\((.[a-f0-9]{24}.)\\)")]
         private static partial Regex ObjectIdRegex();
 
@@ -176,6 +178,7 @@ public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
     /// <param name="context">The BSON serialization context that provides the writer used to emit the serialized output.</param>
     /// <param name="args">Additional BSON serialization arguments passed through to the underlying serializers.</param>
     /// <param name="value">The runtime value to serialize. A <c>null</c> value is written as a BSON null; all other values are dispatched based on their concrete type.</param>
+    /// <!-- aidoc:v1 sig=afd2b33 body=331ada7 -->
     public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
         {
             switch (value)
@@ -241,6 +244,7 @@ public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
     /// </summary>
     /// <param name="bsonArray">The BSON array whose element type needs to be resolved.</param>
     /// <returns>The resolved <see cref="Type"/> for the array elements, or <c>null</c> when no matching type can be determined.</returns>
+    /// <!-- aidoc:v1 sig=c18a474 body=ae05e3b -->
     private Type? GetElementTypeFromBsonArray(BsonArray bsonArray)
         {
             if (bsonArray.Count == 1 && bsonArray.Values.Any(c => c.IsBsonNull))
@@ -289,6 +293,7 @@ public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
     /// Provides serialization for <see cref="List{T}"/> instances while ignoring null elements.
     /// </summary>
     /// <typeparam name="T">The type of elements contained in the list being serialized.</typeparam>
+    /// <!-- aidoc:v1 sig=886b1df -->
     public class NullIgnoringListSerializer<T> : SerializerBase<List<T>>
     {
         /// <summary>
@@ -297,6 +302,7 @@ public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
         /// <param name="context">The BSON deserialization context providing the reader used to read the BSON data.</param>
         /// <param name="args">Additional arguments that influence the deserialization process.</param>
         /// <returns>A <see cref="List{T}"/> containing the deserialized elements, or an empty list if the BSON value is null.</returns>
+        /// <!-- aidoc:v1 sig=df18c1f body=b9d1e6d -->
         public override List<T> Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
                 {
                     var bsonType = context.Reader.GetCurrentBsonType();
@@ -324,6 +330,7 @@ public partial class ComplexObjectValueTypeSerializer : SerializerBase<object>
         /// <param name="context">The BSON serialization context providing the writer used to emit the array and its elements.</param>
         /// <param name="args">The BSON serialization arguments supplying additional options for the serialization process.</param>
         /// <param name="value">The list of items to serialize as a BSON array.</param>
+        /// <!-- aidoc:v1 sig=e2b49d6 body=1f2669b -->
         public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, List<T> value)
                 {
                     context.Writer.WriteStartArray();
diff --git a/adas-core.Domain/Utils/CryptoAdas.cs b/adas-core.Domain/Utils/CryptoAdas.cs
index 988a4ba5..250426c7 100644
--- a/adas-core.Domain/Utils/CryptoAdas.cs
+++ b/adas-core.Domain/Utils/CryptoAdas.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides a static container for cryptographic operations and utilities related to the Adas domain.
 /// </summary>
+/// <!-- aidoc:v1 sig=2c4859b -->
 public static class CryptoAdas
 {
     private static readonly Regex PassRegex = new("^(?=.*?[A-Z])(?=.*?[a-z])(?=.*?[0-9])(?=.*?[#?!@$%^&*-]).{8,}$");
@@ -19,6 +20,7 @@ public static class CryptoAdas
     /// </summary>
     /// <param name="input">The string to hash. Its ASCII byte representation is used as the input to the MD5 algorithm.</param>
     /// <returns>The MD5 hash of <paramref name="input"/> formatted as an uppercase hexadecimal string.</returns>
+    /// <!-- aidoc:v1 sig=e509d6c body=5733afd -->
     public static string CreateMd5(string input)
         {
             using var md5 = MD5.Create();
@@ -39,6 +41,7 @@ public static class CryptoAdas
     /// <param name="gF">The grouped field whose names, max, since, regularity, and results are included in the hash input.</param>
     /// <param name="patientId">The identifier of the patient whose data is being hashed.</param>
     /// <returns>An MD5 hash string representing the combined patient and grouped field data.</returns>
+    /// <!-- aidoc:v1 sig=0805f4d body=4e67e9c -->
     public static string CreateMd5GroupedObs(GroupedField gF, ObjectId patientId)
         {
             var names = CollectionsUtils.IfEmptyOrNull(gF.Names, [gF.Name ?? string.Empty]);
@@ -56,6 +59,7 @@ public static class CryptoAdas
     /// </summary>
     /// <param name="input">The plain text string to be hashed.</param>
     /// <returns>A BCrypt hashed representation of the input string.</returns>
+    /// <!-- aidoc:v1 sig=095e787 body=667d6d0 -->
     public static string CreateBCrypt(string input)
         {
             return BCrypt.Net.BCrypt.HashPassword(input);
@@ -67,6 +71,7 @@ public static class CryptoAdas
     /// <param name="loginPass">The plain text password entered by the user during login.</param>
     /// <param name="passwordHash">The stored BCrypt hash to compare the password against.</param>
     /// <returns><c>true</c> if the password matches the hash; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a06bd55 body=9f08488 -->
     public static bool VerifyPassword(string loginPass, string passwordHash)
         {
             return BCrypt.Net.BCrypt.Verify(loginPass, passwordHash);
@@ -77,6 +82,7 @@ public static class CryptoAdas
     /// </summary>
     /// <param name="password">The password string to evaluate against the strong password requirements.</param>
     /// <returns><c>true</c> if the password matches the strong password pattern; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=fc43cf7 body=9a130ab -->
     public static bool IsStrongPassword(string password)
         {
             return PassRegex.IsMatch(password);
diff --git a/adas-core.Domain/Utils/DetailConfigExtension.cs b/adas-core.Domain/Utils/DetailConfigExtension.cs
index 1476368e..9e55f2d2 100644
--- a/adas-core.Domain/Utils/DetailConfigExtension.cs
+++ b/adas-core.Domain/Utils/DetailConfigExtension.cs
@@ -8,6 +8,8 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// This is a static utility class that cannot be instantiated and is intended to extend the functionality of <see cref="DetailConfigExtension"/> through extension method definitions.
 /// </remarks>
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The documentation states the class provides extension methods for 'DetailConfigExtension' itself, but by convention a class named 'DetailConfigExtension' is meant to extend another type (likely 'DetailConfig'), not itself." -->
 public static class DetailConfigExtension
 {
     // Método principal para iniciar la extracción
diff --git a/adas-core.Domain/Utils/DictionaryEx.cs b/adas-core.Domain/Utils/DictionaryEx.cs
index e2cda82d..5862ef18 100644
--- a/adas-core.Domain/Utils/DictionaryEx.cs
+++ b/adas-core.Domain/Utils/DictionaryEx.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides static extension methods to augment the functionality of dictionary types.
 /// </summary>
+/// <!-- aidoc:v1 sig=02a7d52 -->
 public static class DictionaryEx
 {
     /// <summary>
@@ -12,6 +13,7 @@ public static class DictionaryEx
     /// <param name="key">The key whose associated value should be returned.</param>
     /// <param name="defaultValue">The value to return when the key is not present in the dictionary. Defaults to the default value of <typeparamref name="TV"/>.</param>
     /// <returns>The value associated with the key if found; otherwise, <paramref name="defaultValue"/>.</returns>
+    /// <!-- aidoc:v1 sig=b234e0b body=dba24e5 -->
     public static TV? GetValue<TK, TV>(this IDictionary<TK, TV> dict, TK key, TV? defaultValue = default)
         {
             return dict.TryGetValue(key, out var value) ? value : defaultValue;
@@ -24,6 +26,7 @@ public static class DictionaryEx
     /// <param name="itemSeparator">The separator placed between each formatted key-value pair in the resulting string.</param>
     /// <param name="keySeparator">The separator placed between a key and its corresponding value within each pair.</param>
     /// <returns>A single string containing all dictionary entries formatted and joined using the specified separators.</returns>
+    /// <!-- aidoc:v1 sig=8568016 body=8f9bb50 -->
     public static string ToListString<TK, TV>(this IDictionary<TK, TV> dict, string itemSeparator = ", ",
             string keySeparator = ": ")
         {
@@ -38,6 +41,7 @@ public static class DictionaryEx
     /// <param name="dictionary">The dictionary to search for the key.</param>
     /// <param name="key">The key whose associated value should be retrieved.</param>
     /// <returns>The value associated with the key, or null if the key was not found in the dictionary.</returns>
+    /// <!-- aidoc:v1 sig=9a17711 body=7e00219 -->
     public static TValue? TryGetAndReturn<TKey, TValue>(this IDictionary<TKey, TValue> dictionary, TKey key)
             where TKey : notnull where TValue : class
         {
diff --git a/adas-core.Domain/Utils/EnumUtils.cs b/adas-core.Domain/Utils/EnumUtils.cs
index 55eae505..86e87a69 100644
--- a/adas-core.Domain/Utils/EnumUtils.cs
+++ b/adas-core.Domain/Utils/EnumUtils.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for working with <see cref="System.Enum"/> types.
 /// </summary>
+/// <!-- aidoc:v1 sig=429f818 -->
 public static class EnumUtils
 {
     /// <summary>
@@ -14,6 +15,7 @@ public static class EnumUtils
     /// </summary>
     /// <param name="value">The enumeration value whose description should be obtained.</param>
     /// <returns>The description text from the <see cref="DescriptionAttribute"/> if present; otherwise, the string representation of the enum value.</returns>
+    /// <!-- aidoc:v1 sig=48c6985 body=d45f10c -->
     public static string GetDescription(Enum value)
         {
             var enumMember = value.GetType().GetMember(value.ToString()).FirstOrDefault();
diff --git a/adas-core.Domain/Utils/EquatableDictionary.cs b/adas-core.Domain/Utils/EquatableDictionary.cs
index 48da231a..a5c17ce4 100644
--- a/adas-core.Domain/Utils/EquatableDictionary.cs
+++ b/adas-core.Domain/Utils/EquatableDictionary.cs
@@ -19,6 +19,7 @@ public sealed class EquatableDictionary<TKey, TValue>
     /// </summary>
     /// <param name="other">The dictionary to compare against this instance.</param>
     /// <returns><c>true</c> if both dictionaries contain the same keys with equal values; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1b5e4bb body=d98d679 -->
     public bool Equals(ComparableDictionary<TKey, TValue>? other)
         {
             if (other is null) return false;
@@ -38,6 +39,7 @@ public sealed class EquatableDictionary<TKey, TValue>
     /// </summary>
     /// <param name="other">The object to compare with the current instance.</param>
     /// <returns><c>true</c> if <paramref name="other"/> is a <see cref="ComparableDictionary{TKey, TValue}"/> and is equal to the current instance; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=a2c1185 body=4da7df8 -->
     public override bool Equals(object? other)
         {
             return Equals(other as ComparableDictionary<TKey, TValue>);
@@ -48,6 +50,7 @@ public sealed class EquatableDictionary<TKey, TValue>
     /// Each pair contributes a hash derived from its key and value, and the per-pair hashes are combined using XOR.
     /// </summary>
     /// <returns>An integer hash code that represents the contents of the collection.</returns>
+    /// <!-- aidoc:v1 sig=eb26c4a body=9b55f08 -->
     public override int GetHashCode()
         {
             var hash = 0;
diff --git a/adas-core.Domain/Utils/GlobalData.cs b/adas-core.Domain/Utils/GlobalData.cs
index 2eb0f3dc..574cfed7 100644
--- a/adas-core.Domain/Utils/GlobalData.cs
+++ b/adas-core.Domain/Utils/GlobalData.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides static access to global application data and configuration values.
 /// </summary>
+/// <!-- aidoc:v1 sig=8205a2a -->
 public static class GlobalData
 {
     public static Dictionary<string, object> Data = new();
@@ -12,6 +13,7 @@ public static class GlobalData
     /// </summary>
     /// <param name="key">The key used to identify the data entry in the store.</param>
     /// <param name="value">The value to associate with the specified key.</param>
+    /// <!-- aidoc:v1 sig=844414c body=7ffcd39 -->
     public static void AddData(string key, object value)
         {
             var exists = Data.ContainsKey(key);
diff --git a/adas-core.Domain/Utils/Hl7Utils.cs b/adas-core.Domain/Utils/Hl7Utils.cs
index 6386572d..78bb128c 100644
--- a/adas-core.Domain/Utils/Hl7Utils.cs
+++ b/adas-core.Domain/Utils/Hl7Utils.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for working with HL7 (Health Level 7) data formats and messages.
 /// </summary>
+/// <!-- aidoc:v1 sig=671835a -->
 public static class Hl7Utils
 {
     /// <summary>
@@ -16,6 +17,7 @@ public static class Hl7Utils
     /// <param name="logger">Logger para registrar advertencias</param>
     /// <param name="type">Tipo de mensaje HL7 que se va a procesar su entrada</param>
     /// <returns>true si se permite; false en caso contrario.</returns>
+    /// <!-- aidoc:v1 sig=32eaafb body=f8cff18 -->
     public static bool ManageAutoAdt(Unit? unitConfig, Unit? oldUnitConfig, ILogger logger, string type)
     {
         // Variables de estado:
diff --git a/adas-core.Domain/Utils/Interfaces/IMappingUtils.cs b/adas-core.Domain/Utils/Interfaces/IMappingUtils.cs
index d160e0af..d7b546fd 100644
--- a/adas-core.Domain/Utils/Interfaces/IMappingUtils.cs
+++ b/adas-core.Domain/Utils/Interfaces/IMappingUtils.cs
@@ -8,6 +8,7 @@ public interface IMappingUtils
     /// <param name="code">The code used to look up the entity.</param>
     /// <param name="category">The category used to filter the search.</param>
     /// <returns>A nullable tuple containing the type, name, and group of the found entity, or <c>null</c> if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=b334b7d -->
     (string type, string name, string group)? SearchByCode(object code, string category);
     /// <summary>
     /// Retrieves the complexity value associated with the specified name, optionally applying a weight.
@@ -15,6 +16,7 @@ public interface IMappingUtils
     /// <param name="name">The name used to look up the complexity value.</param>
     /// <param name="peso">An optional weight value to apply to the complexity calculation.</param>
     /// <returns>The complexity value as an integer.</returns>
+    /// <!-- aidoc:v1 sig=a58a789 -->
     int GetComplexityValue(string name, double? peso = null);
 
     // void ConvertStringToDoubleInMapping();
diff --git a/adas-core.Domain/Utils/JsonExtensions.cs b/adas-core.Domain/Utils/JsonExtensions.cs
index 64277be5..1c3bea1d 100644
--- a/adas-core.Domain/Utils/JsonExtensions.cs
+++ b/adas-core.Domain/Utils/JsonExtensions.cs
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides extension methods for JSON-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=705e834 -->
 public static class JsonExtensions
 {
     /// <summary>
@@ -15,6 +16,7 @@ public static class JsonExtensions
     /// <param name="inputPath">The path to the source JSON file to read from.</param>
     /// <param name="outputPath">The path to the destination BSON file to write to.</param>
     /// <param name="fileMode">The file mode used to open the output file. Defaults to <see cref="FileMode.CreateNew"/>.</param>
+    /// <!-- aidoc:v1 sig=c16c55c body=99b3e3a -->
     public static void CopyToBson(string inputPath, string outputPath, FileMode fileMode = FileMode.CreateNew)
         {
             using var textReader = File.OpenText(inputPath);
diff --git a/adas-core.Domain/Utils/JwtHelper.cs b/adas-core.Domain/Utils/JwtHelper.cs
index acc8bbe4..c86f32cc 100644
--- a/adas-core.Domain/Utils/JwtHelper.cs
+++ b/adas-core.Domain/Utils/JwtHelper.cs
@@ -12,6 +12,7 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// This class is intended to be inherited by concrete implementations that define specific JWT processing behaviors.
 /// </remarks>
+/// <!-- aidoc:v1 sig=1fa4049 -->
 public abstract class JwtHelper
 {
     /// <summary>
@@ -25,6 +26,7 @@ public abstract class JwtHelper
     /// <param name="expiration">The token lifetime in minutes, added to the current UTC time to compute the expiration date.</param>
     /// <param name="additionalClaims">Optional extra claims to merge into the token alongside the standard claims. If null, only the default claims are included.</param>
     /// <returns>A <see cref="JwtSecurityToken"/> signed with HMAC-SHA256 and configured with the supplied issuer, audience, expiration, and claims.</returns>
+    /// <!-- aidoc:v1 sig=7df0b13 body=543eca7 -->
     public static JwtSecurityToken GetJwtToken(
             string username,
             string secret,
@@ -70,6 +72,7 @@ public abstract class JwtHelper
     /// Generates a cryptographically secure refresh token by producing 64 random bytes using <see cref="RandomNumberGenerator"/> and returning the value as a Base64-encoded string.
     /// </summary>
     /// <returns>A Base64-encoded string representation of a 64-byte cryptographically random sequence suitable for use as a refresh token.</returns>
+    /// <!-- aidoc:v1 sig=6a19dd4 body=ba66473 -->
     public static string GenerateRefreshToken()
         {
             var randomNumber = new byte[64];
@@ -83,6 +86,7 @@ public abstract class JwtHelper
     /// </summary>
     /// <param name="principal"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=df50964 body=4874c36 -->
     public static string? GetUsernameFromPrincipal(ClaimsPrincipal principal)
     {
         var nameClaim = principal.Claims.FirstOrDefault(c => c.Type.Equals(ClaimTypes.NameIdentifier));
diff --git a/adas-core.Domain/Utils/Mapper.cs b/adas-core.Domain/Utils/Mapper.cs
index 3432f0d4..83013761 100644
--- a/adas-core.Domain/Utils/Mapper.cs
+++ b/adas-core.Domain/Utils/Mapper.cs
@@ -43,6 +43,12 @@ public static class Mapper<T>
     /// <param name="destination">The target object that will receive the mapped property values.</param>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="source"/> or <paramref name="destination"/> is null.</exception>
     /// <exception cref="ArgumentException">Thrown when a source value is null but the corresponding destination property is a value type that is not <see cref="Nullable{T}"/>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states null values are only assigned to reference types or Nullable<T> types, but the condition `propType is { IsByRef: false } && propType.Name != \"Nullable\\`1\"` is true for reference types as well, so the code throws ArgumentException for reference types too." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The exception is documented as thrown only when the destination property is a non-nullable value type, but the condition matches any non-Nullable property type (including reference types), so the exception is also thrown for reference-type properties." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states that when source value type does not match the destination property type, the value is converted using Convert.ToDouble(object), but the unconditional `p.SetValue(destination, kv.Value, null)` after the else-if block overwrites the conversion, so the original (unconverted) value is always assigned." -->
     public static void Map(ExpandoObject source, T destination)
         {
             // Might as well take care of null references early.
diff --git a/adas-core.Domain/Utils/MappingUtils.cs b/adas-core.Domain/Utils/MappingUtils.cs
index 6093ad44..e3d787de 100644
--- a/adas-core.Domain/Utils/MappingUtils.cs
+++ b/adas-core.Domain/Utils/MappingUtils.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides a sealed implementation of mapping utilities, serving as the concrete type for the <see cref="IMappingUtils"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=3654eb4 -->
 public sealed class MappingUtils : IMappingUtils
 {
     private readonly List<MappingInterventions>? _cccData;
@@ -139,6 +140,7 @@ public sealed class MappingUtils : IMappingUtils
     /// <param name="name">The name of the entry to look up in the CCC data.</param>
     /// <param name="peso">Optional weight used to select the matching range when multiple values are defined; when null, range-based lookup is skipped.</param>
     /// <returns>The matched initial value (for single-entry entries) or the contributed value (for range-based entries); returns 0 if the name is not found or no data is available.</returns>
+    /// <!-- aidoc:v1 sig=ebd2665 body=cd6536d -->
     public int GetComplexityValue(string name, double? peso = null)
         {
             ConvertStringToDoubleInMapping();
@@ -167,6 +169,7 @@ public sealed class MappingUtils : IMappingUtils
     /// <summary>
     /// Converts string representations of numeric values in the <c>_cccData</c> mapping to <see cref="double"/> using the invariant culture, ensuring the period (".") is recognized as the decimal separator. The method only runs when the data has not already been transformed (<c>_isTransformedValue</c> is false) and when <c>_cccData</c> is not null, iterating through each mapping's <c>Codes</c> and <c>Value</c> entries to parse and replace their <c>InitialValue</c> and <c>FinalValue</c> when they are strings. After processing, it marks the transformation as completed by setting <c>_isTransformedValue</c> to true.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c56c099 body=08add6b -->
     private void ConvertStringToDoubleInMapping()
         {
             // esto es  para garantizar que el punto (".") sea reconocido como separador decimal
diff --git a/adas-core.Domain/Utils/MediaUtils.cs b/adas-core.Domain/Utils/MediaUtils.cs
index 808426ed..b73fd535 100644
--- a/adas-core.Domain/Utils/MediaUtils.cs
+++ b/adas-core.Domain/Utils/MediaUtils.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for handling media-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=448de2e -->
 public static class MediaUtils
 {
     public static readonly Dictionary<string, string> Mapping = new(StringComparer.InvariantCultureIgnoreCase)
@@ -98,6 +99,7 @@ public static class MediaUtils
     /// </summary>
     /// <param name="filePath">The file path whose extension is used to resolve the MIME type.</param>
     /// <returns>The corresponding MIME type string if the extension is found in the mapping; otherwise, the default <c>application/octet-stream</c> value.</returns>
+    /// <!-- aidoc:v1 sig=32736f8 body=5e920f2 -->
     public static string GetMimeType(string filePath)
         {
             var extension = Path.GetExtension(filePath).ToLowerInvariant();
@@ -110,6 +112,7 @@ public static class MediaUtils
     /// </summary>
     /// <param name="filePath">The path of the file to evaluate.</param>
     /// <returns><c>true</c> if the file extension matches one of the supported video extensions; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=76fdeef body=e5c094c -->
     public static bool IsVideoFile(string filePath)
         {
             // Extensiones de video soportadas
@@ -124,6 +127,7 @@ public static class MediaUtils
     /// </summary>
     /// <param name="videoPath">The file path of the video whose duration should be retrieved.</param>
     /// <returns>The video duration in milliseconds, or null if an error occurs while reading the file.</returns>
+    /// <!-- aidoc:v1 sig=06def65 body=dc9235d -->
     public static long? GetVideoDuration(string videoPath)
         {
             try
diff --git a/adas-core.Domain/Utils/NumberUtils.cs b/adas-core.Domain/Utils/NumberUtils.cs
index ccda69c4..22054ab0 100644
--- a/adas-core.Domain/Utils/NumberUtils.cs
+++ b/adas-core.Domain/Utils/NumberUtils.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides a collection of static utility methods for performing common numeric operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=6831b9b -->
 public static class NumberUtils
 {
     /// <summary>
@@ -10,6 +11,7 @@ public static class NumberUtils
     /// </summary>
     /// <param name="value">The object to evaluate.</param>
     /// <returns><c>true</c> if <paramref name="value"/> is one of the supported numeric types (sbyte, byte, short, ushort, int, uint, long, ulong, float, double, or decimal); otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=1d802ac body=c01f438 -->
     public static bool IsNumber(this object value)
         {
             return value is sbyte
@@ -30,6 +32,7 @@ public static class NumberUtils
     /// </summary>
     /// <param name="value">The object to convert to a <see cref="double"/>.</param>
     /// <returns>A <see cref="double"/> that represents the converted value.</returns>
+    /// <!-- aidoc:v1 sig=0769d25 body=41720e3 -->
     public static double ToDouble(this object value)
         {
             return Convert.ToDouble(value);
diff --git a/adas-core.Domain/Utils/ObjectIdConverter.cs b/adas-core.Domain/Utils/ObjectIdConverter.cs
index 4584e33f..7bb26529 100644
--- a/adas-core.Domain/Utils/ObjectIdConverter.cs
+++ b/adas-core.Domain/Utils/ObjectIdConverter.cs
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Utils;
 /// <remarks>
 /// Inherits from <see cref="JsonConverter"/> to customize JSON representation for the type it targets.
 /// </remarks>
+/// <!-- aidoc:v1 sig=f98482b -->
 public class ObjectIdConverter : JsonConverter
 {
     /// <summary>
@@ -17,6 +18,7 @@ public class ObjectIdConverter : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> used to emit the JSON output.</param>
     /// <param name="value">The value to serialize, expected to be an <see cref="ObjectId"/> instance.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> invoking this converter.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=beff169 -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value is ObjectId objectId)
@@ -34,6 +36,7 @@ public class ObjectIdConverter : JsonConverter
     /// <param name="existingValue">The existing value being populated, passed through from the deserializer.</param>
     /// <param name="serializer">The JSON serializer invoking this converter.</param>
     /// <returns>An <see cref="ObjectId"/> instance when the value can be parsed or when the target type is non-nullable; <c>null</c> when the target type is nullable and no valid value is found.</returns>
+    /// <!-- aidoc:v1 sig=881b805 body=5a6faf1 -->
     public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -59,6 +62,10 @@ public class ObjectIdConverter : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to evaluate for compatibility with the converter.</param>
     /// <returns><see langword="true"/> if <paramref name="objectType"/> can be assigned from <see cref="ObjectId"/>; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The code `typeof(ObjectId).IsAssignableFrom(objectType)` returns true when objectType is assignable TO ObjectId (i.e., objectType is ObjectId or a derived type). The doc states the opposite: 'objectType can be assigned from ObjectId' would mean ObjectId is assignable to objectType." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says 'checking if the type is assignable from ObjectId', which implies ObjectId is assignable to the type. The code actually checks if the type is assignable to ObjectId." -->
     public override bool CanConvert(Type objectType)
         {
             return typeof(ObjectId).IsAssignableFrom(objectType);
diff --git a/adas-core.Domain/Utils/ObjectUtils.cs b/adas-core.Domain/Utils/ObjectUtils.cs
index e15f1d73..4df05a2a 100644
--- a/adas-core.Domain/Utils/ObjectUtils.cs
+++ b/adas-core.Domain/Utils/ObjectUtils.cs
@@ -5,6 +5,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides static utility methods for common object-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=97753a4 -->
 public static class ObjectUtils
 {
     /// <summary>
@@ -13,6 +14,8 @@ public static class ObjectUtils
     /// </summary>
     /// <param name="obj">The object to convert to a string. Can be null.</param>
     /// <returns>A string containing the type name followed by the object's non-null property values and their names.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The format example shows 'TypeName[Property1: Value1,Property2: Value2]' without a trailing comma, but the code always appends a comma after each property value, producing a trailing comma before the closing bracket (e.g., 'TypeName[Prop1: Value1,]')." -->
     public static string ToStr(this object? obj)
         {
             if (obj == null) return "[OBJ NULL]";
diff --git a/adas-core.Domain/Utils/RelayHelper.cs b/adas-core.Domain/Utils/RelayHelper.cs
index c611b3fb..824b3aca 100644
--- a/adas-core.Domain/Utils/RelayHelper.cs
+++ b/adas-core.Domain/Utils/RelayHelper.cs
@@ -8,6 +8,7 @@ namespace adas_core.Domain.Utils;
 /// <summary>
 /// Provides helper methods for relaying operations, data, or commands between components.
 /// </summary>
+/// <!-- aidoc:v1 sig=00f0997 -->
 public class RelayHelper
 {
     /// <summary>
@@ -69,6 +70,7 @@ public class RelayHelper
     /// Powers on the specified relay by constructing a request to the local relay control endpoint at https://localhost:7186, where the relay is identified by its <see cref="Relay.RelayNumber"/> in the path.
     /// </summary>
     /// <param name="relay">The relay to power on.</param>
+    /// <!-- aidoc:v1 sig=61b2177 body=b5539f2 -->
     public static void PowerOnRelay(Relay relay)
         {
             UriBuilder builder = new()
@@ -87,6 +89,7 @@ public class RelayHelper
     /// using the relay's number as the path identifier, then forwarding the call to the underlying relay handler.
     /// </summary>
     /// <param name="relay">The relay to power off, identified by its <see cref="Relay.RelayNumber"/> which is used to construct the request path.</param>
+    /// <!-- aidoc:v1 sig=3bafafd body=1a09ab5 -->
     public static void PowerOffRelay(Relay relay)
         {
             UriBuilder builder = new()
@@ -140,6 +143,7 @@ public class RelayHelper
     /// </summary>
     /// <param name="relay">The relay whose status is being queried.</param>
     /// <returns><c>true</c> if the relay is active; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=d491189 body=90f8ab6 -->
     public static bool GetRelayStatus(Relay relay)
         {
             return false;
diff --git a/adas-core.Domain/Utils/StringEx.cs b/adas-core.Domain/Utils/StringEx.cs
index 1bc18f35..f1c447b7 100644
--- a/adas-core.Domain/Utils/StringEx.cs
+++ b/adas-core.Domain/Utils/StringEx.cs
@@ -3,6 +3,7 @@
 /// <summary>
 /// Provides static extension methods for the <see cref="string"/> type.
 /// </summary>
+/// <!-- aidoc:v1 sig=cc11c0a -->
 public static class StringEx
 {
     /// <summary>
@@ -10,6 +11,7 @@ public static class StringEx
     /// </summary>
     /// <param name="source">The string to evaluate.</param>
     /// <returns><c>true</c> if <paramref name="source"/> is <c>null</c> or an empty string; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=6fb921b body=7fbbf9d -->
     public static bool IsEmpty(this string source)
         {
             return string.IsNullOrEmpty(source);
@@ -20,6 +22,7 @@ public static class StringEx
     /// </summary>
     /// <param name="source">The string to evaluate.</param>
     /// <returns>true if the string is null, empty, or contains only white space; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=cec22b6 body=67e9275 -->
     public static bool IsEmptyOrWhiteSpace(this string source)
         {
             return string.IsNullOrWhiteSpace(source);
@@ -31,6 +34,7 @@ public static class StringEx
     /// <param name="source">The string to search within.</param>
     /// <param name="value">The delimiter whose first occurrence marks the start of the returned substring.</param>
     /// <returns>The substring after the first occurrence of <paramref name="value"/>; otherwise, the original <paramref name="source"/>.</returns>
+    /// <!-- aidoc:v1 sig=e1718c5 body=92784ed -->
     public static string SubstringAfter(this string source, string value)
         {
             if (string.IsNullOrEmpty(source) || string.IsNullOrEmpty(value)) return source;
@@ -48,6 +52,7 @@ public static class StringEx
     /// <param name="source">The string to extract the substring from.</param>
     /// <param name="value">The delimiter whose first occurrence marks the end of the returned substring.</param>
     /// <returns>The substring of <paramref name="source"/> before the first occurrence of <paramref name="value"/>, or the original <paramref name="source"/> when no match is found or when either input is null or empty.</returns>
+    /// <!-- aidoc:v1 sig=a2fe204 body=2083b5c -->
     public static string SubstringBefore(this string source, string value)
         {
             if (string.IsNullOrEmpty(source) || string.IsNullOrEmpty(value)) return source;
diff --git a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_0_UpdateDataPatien.cs b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_0_UpdateDataPatien.cs
index f1f6c0f3..fa5bbc8a 100644
--- a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_0_UpdateDataPatien.cs
+++ b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_0_UpdateDataPatien.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Migrations.MongoMigrations;
 /// <remarks>
 /// Inherits from the <see cref="Migration"/> base class, indicating it is intended to be applied as part of an Entity Framework (or similar) migration pipeline to evolve the underlying data store.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8030161 -->
 public class U_0_1_0_UpdateDataPatien : Migration
 {
     /// <summary>
diff --git a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_1_UpdateDisplayConfigDriver.cs b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_1_UpdateDisplayConfigDriver.cs
index a010c36a..beeb038d 100644
--- a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_1_UpdateDisplayConfigDriver.cs
+++ b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_1_UpdateDisplayConfigDriver.cs
@@ -10,8 +10,13 @@ namespace adas_core.Infrastructure.Migrations.MongoMigrations;
 /// <remarks>
 /// Inherits from <see cref="Migration"/> to support schema or data changes associated with the 0.1.1 release.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a62c43b -->
 public class U_0_1_1_UpdateDisplayConfigDriver : Migration
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="U_0_1_1_UpdateDisplayConfigDriver"/> class by passing identifier 11 to the base constructor and assigning the Description property with a message indicating that the driver generates the Type field in all documents of the DisplayConfig collection to compensate for the new driver not exposing <c>_t</c> for polymorphism.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=230f909 body=56a8ba9 -->
     public U_0_1_1_UpdateDisplayConfigDriver() : base(11)
     {
         Description =
@@ -24,6 +29,7 @@ public class U_0_1_1_UpdateDisplayConfigDriver : Migration
     /// (defaulting to <c>Unknown</c> for any other value), removing the original <c>_t</c> field, and merging the
     /// results back into the same collection while discarding documents that do not already have a match.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2ec5b05 body=0e7c665 -->
     public override void Update()
         {
             var collection = Database.GetCollection<BsonDocument>("config_displays");
diff --git a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_2_UpdatePointOfCareConfig.cs b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_2_UpdatePointOfCareConfig.cs
index 50db2063..1bc2b8f9 100644
--- a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_2_UpdatePointOfCareConfig.cs
+++ b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_2_UpdatePointOfCareConfig.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Migrations.MongoMigrations;
 /// <remarks>
 /// The migration identifier prefix (U_0_1_2) indicates a specific ordering or version step within the migration sequence.
 /// </remarks>
+/// <!-- aidoc:v1 sig=4cbfeb5 -->
 public class U_0_1_2_UpdatePointOfCareConfig : Migration
 {
     /// <summary>
@@ -25,6 +26,8 @@ public class U_0_1_2_UpdatePointOfCareConfig : Migration
     /// <summary>
     /// Updates all point-of-care documents in the database by migrating their embedded configuration arrays (beacons, cameras, and relayList) to empty identifier list structures (beaconIdList, cameraIdList, and relayIdList), preserving the existing arrays' data not retained in this operation.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims data is 'preserved' through migration, but the code removes the existing 'beacons', 'cameras', and 'relayList' arrays entirely and replaces them with newly created empty BsonArrays—no data from the original arrays is retained or migrated." -->
     public override void Update()
         {
             var collection = Database.GetCollection<BsonDocument>("pointOfCares");
diff --git a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_3_UpdateLanguageBarrier.cs b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_3_UpdateLanguageBarrier.cs
index 19fcbca1..03fb31d0 100644
--- a/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_3_UpdateLanguageBarrier.cs
+++ b/adas-core.Infrastructure/Migrations/MongoMigrations/U_0_1_3_UpdateLanguageBarrier.cs
@@ -7,6 +7,7 @@ namespace adas_core.Infrastructure.Migrations.MongoMigrations;
 /// <summary>
 /// Represents a database migration that updates the LanguageBarrier component to version 0.1.3.
 /// </summary>
+/// <!-- aidoc:v1 sig=8c1ced1 -->
 public class U_0_1_3_UpdateLanguageBarrier : Migration
 {
     /// <summary>
diff --git a/adas-core.Infrastructure/Repositories/AdmissionRepository.cs b/adas-core.Infrastructure/Repositories/AdmissionRepository.cs
index 8ea41ad5..975a6cab 100644
--- a/adas-core.Infrastructure/Repositories/AdmissionRepository.cs
+++ b/adas-core.Infrastructure/Repositories/AdmissionRepository.cs
@@ -17,6 +17,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repositorio para gestionar las operaciones de la entidad Admission en MongoDB. Proporciona métodos para insertar, actualizar, eliminar y buscar admisiones, así como para manejar opciones de listas maestras relacionadas con las admisiones. 
 /// Utiliza Serilog para el registro de errores y eventos importantes durante las operaciones de la base de datos.
 /// </summary>
+/// <!-- aidoc:v1 sig=661ecfc -->
 public class AdmissionRepository : MongoRepository<Admission>, IAdmissionRepository
 {
     
@@ -41,6 +42,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// Esto permite que el repositorio se conecte a la colección correcta para realizar las operaciones de base de datos relacionadas con las admisiones.
     /// </summary>
     /// <returns>El nombre de la colección de admisiones en MongoDB.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=c763693 -->
     public override string GetCollectionName()
     {
         return _apiSettings.Admissions;
@@ -51,6 +53,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="admission">La admisión a insertar en la base de datos.</param>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=2d2f0a6 body=e87ab8c -->
     public override async Task InsertOneAsync(Admission admission)
     {
         try
@@ -70,6 +73,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="id">El identificador único (ObjectId) de la admisión a eliminar.</param>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=27ebee4 -->
     public async Task Delete(ObjectId id)
     {
         try
@@ -89,6 +93,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="admission">La admisión con los datos actualizados.</param>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=b1dc4bf body=31005c0 -->
     public async Task Update(Admission admission)
     {
         try
@@ -109,6 +114,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// <param name="id">El identificador único (ObjectId) de la admisión a actualizar.</param>
     /// <param name="newLocation">El nuevo identificador de la ubicación (PointOfCareId) de la admisión.</param>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=8e1f6ee body=e466f15 -->
     public async Task UpdateLocation(ObjectId id, ObjectId newLocation)
     {
         var filterBuilder = Builders<Admission>.Filter;
@@ -126,6 +132,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// <param name="id">El identificador único (ObjectId) de la admisión a actualizar.</param>
     /// <param name="patient">La instancia de Person con los nuevos datos personales.</param>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=424027b body=3e081ee -->
     public async Task UpdatePatient(ObjectId id, Person patient)
     {
         var filterBuilder = Builders<Admission>.Filter;
@@ -142,6 +149,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// Si ocurre una excepción durante el proceso, se registra un error con Serilog y se devuelve una lista vacía.
     /// </summary>
     /// <returns>Una lista de todas las admisiones almacenadas en la base de datos.</returns>
+    /// <!-- aidoc:v1 sig=c8ce0f4 body=52c24c8 -->
     public async Task<IEnumerable<Admission>> FindAll()
     {
         try
@@ -163,6 +171,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// <param name="patientNumber">El número de paciente (NHC) a buscar.</param>
     /// <param name="unitId">El identificador de unidad (ObjectId) que debe ser distinto al de la admisión encontrada.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve la admisión encontrada o null si no se encuentra ninguna.</returns>
+    /// <!-- aidoc:v1 sig=19a02a2 body=32461f1 -->
     public async Task<Admission?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId)
     {
         if (string.IsNullOrWhiteSpace(patientNumber)) return null;
@@ -182,6 +191,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="id">El identificador único (ObjectId) de la admisión a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve la admisión encontrada o null si no se encuentra ninguna.</returns>
+    /// <!-- aidoc:v1 sig=0698ddf body=138b21a -->
     public async Task<Admission?> FindById(ObjectId id)
     {
         try
@@ -203,6 +213,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="nhc">El número de paciente (NHC) a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve la admisión encontrada o null si no se encuentra ninguna.</returns>
+    /// <!-- aidoc:v1 sig=cd32c8c body=a17d4c4 -->
     public async Task<Admission?> FindByNhc(string nhc)
     {
         try
@@ -225,6 +236,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="location">La ubicación del paciente (PatientLocation) a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones que coinciden con la ubicación especificada.</returns>
+    /// <!-- aidoc:v1 sig=326e4a1 body=c3de436 -->
     public async Task<List<Admission>> FindByLocation(PatientLocation location)
     {
         try
@@ -249,6 +261,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="origin">El nombre del origen de la admisión a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones que coinciden con el origen especificado.</returns>
+    /// <!-- aidoc:v1 sig=eded8f2 body=1837f4c -->
     public async Task<IEnumerable<Admission>?> FindByOrigin(string origin)
     {
         try
@@ -273,6 +286,8 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="origin">La admisión a insertar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve la admisión insertada o null si ocurre un error.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The summary states the method sets AdmissionDate to the current UTC date/time before insertion, but the code never assigns or modifies AdmissionDate." -->
     public async Task<Admission?> InsertOneAsyncAndReturn(Admission origin)
     {
         try
@@ -293,6 +308,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="unitId">El identificador de la unidad a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones que coinciden con los criterios especificados.</returns>
+    /// <!-- aidoc:v1 sig=a0f7f96 body=976a399 -->
     public async Task<List<Admission>> GetAdmissionByUnitIdWithOutPoC(ObjectId unitId)
     {
         try
@@ -314,6 +330,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="unitId">El identificador de la unidad a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve el número de admisiones que coinciden con el unitId especificado.</returns>
+    /// <!-- aidoc:v1 sig=baa8175 body=0635d14 -->
     public async Task<long> CountByUnitId(ObjectId unitId)
     {
         try
@@ -335,6 +352,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="pocId">El identificador del punto de atención a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones que coinciden con el PointOfCareId especificado.</returns>
+    /// <!-- aidoc:v1 sig=ff96e2c body=6fe7177 -->
     public async Task<List<Admission>> FindByPointOfCareId(ObjectId pocId)
     {
         try
@@ -356,6 +374,8 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="unitIds">La lista de identificadores de unidad a buscar.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones que coinciden con los unitIds especificados.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states that the method 'utiliza el método FindAsync para obtenerlas', but the code actually uses Collection.Find(filterUnit).ToListAsync(), not FindAsync." -->
     public async Task<List<Admission>> FindByUnitIds(List<ObjectId> unitIds)
     {
         var filterUnit = Builders<Admission>.Filter.In("unitId", unitIds);
@@ -369,6 +389,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// <param name="opt">La opción de actualización de la lista maestra.</param>
     /// <param name="typeName">El nombre del tipo de lista maestra.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones actualizadas.</returns>
+    /// <!-- aidoc:v1 sig=eb0fbec body=436eb94 -->
     public async Task<IEnumerable<Admission>> UpdateMasterListOption(List<ObjectId> unitIds,
         UpdateOptionMasterListDto opt, string typeName)
     {
@@ -459,6 +480,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// <param name="opt">La opción de actualización de la lista maestra.</param>
     /// <param name="typeName">El nombre del tipo de lista maestra.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una lista de admisiones actualizadas.</returns>
+    /// <!-- aidoc:v1 sig=b26eefb body=eea63d3 -->
     public async Task<IEnumerable<Admission>> DeleteMasterListOption(List<ObjectId> unitIds, OptionList opt,
         string typeName)
     {
@@ -552,6 +574,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="unitId">El identificador de la unidad cuyas admisiones se eliminarán.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve un valor booleano que indica si la eliminación fue exitosa.</returns>
+    /// <!-- aidoc:v1 sig=9070532 body=ce4ae70 -->
     public async Task<bool> DeleteAdmissionsByUnitId(ObjectId unitId)
     {
         try
@@ -571,6 +594,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// Crea índices en la colección de admisiones para mejorar el rendimiento de las consultas. En este caso, se crea un índice único en el campo "nhc" (número de paciente) que solo se aplica a los documentos que tienen un valor para "nhc".
     /// </summary>
     /// <returns>Una tarea que representa la operación asincrónica.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=5d1f175 -->
     public override async Task CreateIndexes()
     {
         var optionsUq = new CreateIndexOptions<Admission>
@@ -593,6 +617,7 @@ public class AdmissionRepository : MongoRepository<Admission>, IAdmissionReposit
     /// </summary>
     /// <param name="diagnosis">El nombre del diagnóstico que se utilizará para buscar admisiones.</param>
     /// <returns>Una tarea que representa la operación asincrónica y devuelve una colección de admisiones que coinciden con el diagnóstico especificado.</returns>
+    /// <!-- aidoc:v1 sig=50438e0 body=f744392 -->
     public async Task<IEnumerable<Admission>?> FindByDiagnosis(string diagnosis)
     {
         try
diff --git a/adas-core.Infrastructure/Repositories/AlarmRepository.cs b/adas-core.Infrastructure/Repositories/AlarmRepository.cs
index f600b8e8..a523d544 100644
--- a/adas-core.Infrastructure/Repositories/AlarmRepository.cs
+++ b/adas-core.Infrastructure/Repositories/AlarmRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository for managing patient observation alarms in MongoDB. Provides methods to retrieve aggregated patient observations based on specified fields and expiration status. 
 /// Implements the IAlarmRepository interface and extends the MongoRepository base class for common MongoDB operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=38c745c -->
 public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmRepository
 {
     /// <summary>
@@ -35,6 +36,8 @@ public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmR
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="logger">The logger instance for logging errors and information.</param>
     /// <exception cref="ArgumentNullException">Thrown when any of the input parameters are null.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "Documents ArgumentNullException as thrown 'when any of the input parameters are null', but the code only null-checks apiSettings; database and logger are not validated." -->
     public AlarmRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database, ILogger<AlarmRepository> logger)
         : base(database)
     {
@@ -51,6 +54,7 @@ public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmR
     /// <param name="patientId">The unique identifier of the patient.</param>
     /// <param name="filterObservations">A list of fields to filter the observations. If null, all observations for the patient are retrieved.</param>
     /// <returns>A list of patient observation alarms matching the filter criteria.</returns>
+    /// <!-- aidoc:v1 sig=43640c3 body=c02d57d -->
     public async Task<List<PatientObservationAlarm>> AggregatedPatientLastObservationsByField(ObjectId patientId,
         List<Field>? filterObservations = null)
     {
@@ -118,6 +122,7 @@ public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmR
     /// <param name="filterObservations">A list of fields to filter the observations. If null, all observations for the patient are retrieved.</param>
     /// <param name="configAlarm">A list of configuration settings for the observations, including expiration times.</param>
     /// <returns>A list of patient observation alarms matching the filter criteria and expiration settings.</returns>
+    /// <!-- aidoc:v1 sig=4c42a94 body=1caea2e -->
     public async Task<List<PatientObservationAlarm>> AggregatedPatientNotExpiredObservationsByField(
         ObjectId patientId,
         List<Field>? filterObservations,
@@ -193,6 +198,7 @@ public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmR
     /// If the collection name is not specified in the API settings, it defaults to "patients_alarms".
     /// </summary>
     /// <returns>The name of the MongoDB collection for patient observation alarms.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=e2ee5dc -->
     public override string GetCollectionName()
     {
         return _apiSettings.PatientsAlarms ?? "patients_alarms";
@@ -202,6 +208,7 @@ public class AlarmRepository : MongoRepository<PatientObservationAlarm>, IAlarmR
     /// Creates indexes for the patient observation alarms collection in MongoDB to optimize query performance.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation of creating indexes.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=340db89 -->
     public override async Task CreateIndexes()
     {
         try
diff --git a/adas-core.Infrastructure/Repositories/AppointmentArchiveRepository.cs b/adas-core.Infrastructure/Repositories/AppointmentArchiveRepository.cs
index dfd9a062..3df11301 100644
--- a/adas-core.Infrastructure/Repositories/AppointmentArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/AppointmentArchiveRepository.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing archived patient appointments in MongoDB. This repository provides methods to insert, delete, and manage archived appointments, ensuring efficient storage and retrieval of historical appointment data.
 /// </summary>
+/// <!-- aidoc:v1 sig=fd51b07 -->
 public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>, IAppointmentArchiveRepository
 {
     /// <summary>
@@ -24,6 +25,8 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// <param name="apiSettings">The API settings containing configuration for the archive collection.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when any of the input parameters are null.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "The exception description states it is 'Thrown when any of the input parameters are null', but only apiSettings is null-checked; database is passed to the base constructor without a null check." -->
     public AppointmentArchiveRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -37,6 +40,7 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// </summary>
     /// <param name="appointment">The patient appointment to be inserted into the archive collection.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=160dca2 body=ec779ee -->
     public override async Task InsertOneAsync(PatientAppointment appointment)
     {
         await Collection.InsertOneAsync(appointment);
@@ -47,6 +51,7 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// </summary>
     /// <param name="date">The date before which all patient appointments should be deleted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=63daa66 body=c6d74c3 -->
     public async Task DeleteBeforeDate(DateTime date)
     {
         var filter = Builders<PatientAppointment>.Filter.Lt(pa => pa.CreateTime, date);
@@ -59,6 +64,7 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// </summary>
     /// <param name="appointment">The collection of patient appointments to be inserted into the archive.</param>
     /// <returns>A task representing the asynchronous operation, with the result being the count of inserted documents.</returns>
+    /// <!-- aidoc:v1 sig=c7c2d89 body=e3ee2bb -->
     public async Task<long> InsertBatch(IEnumerable<PatientAppointment> appointment)
     {
         var writes = new List<WriteModel<PatientAppointment>>();
@@ -74,6 +80,7 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// If the collection name is not specified in the settings, it defaults to "archive_patients_appointments".
     /// </summary>
     /// <returns>The name of the MongoDB collection for archived patient appointments.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=6f721df -->
     public override string GetCollectionName()
     {
         return _apiSettings.ArchivePatientsAppointments ?? "archive_patients_appointments";
@@ -83,6 +90,7 @@ public class AppointmentArchiveRepository : MongoRepository<PatientAppointment>,
     /// Creates indexes on the MongoDB collection for archived patient appointments to optimize query performance. This method defines the necessary indexes, such as an index on the "patientid" field, and ensures that they are created in the background without blocking other operations.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=1a9cdb6 -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions<PatientAppointment> { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/AppointmentRepository.cs b/adas-core.Infrastructure/Repositories/AppointmentRepository.cs
index f572f58e..175e0db4 100644
--- a/adas-core.Infrastructure/Repositories/AppointmentRepository.cs
+++ b/adas-core.Infrastructure/Repositories/AppointmentRepository.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// This class provides methods to perform CRUD operations and queries related to patient appointments, such as retrieving appointments by patient ID, finding appointments by point of care, and updating or deleting appointments. 
 /// It utilizes the MongoDB driver for database interactions and is configured using application settings for collection names and other parameters.
 /// </summary>
+/// <!-- aidoc:v1 sig=2015cdb -->
 public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppointmentRepository
 {
     /// <summary>
@@ -27,6 +28,8 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when any of the input parameters are null.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "Documentation states ArgumentNullException is thrown when 'any of the input parameters are null', but only apiSettings is null-checked in the constructor body; database is passed to the base constructor without an explicit null check." -->
     public AppointmentRepository(
         IOptions<ApiSettings> apiSettings,
         IMongoDatabase database) : base(database)
@@ -41,6 +44,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// If the collection name is not specified in the settings, it defaults to "patients_appointments".
     /// </summary>
     /// <returns>The name of the MongoDB collection for patient appointments.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=d8275f8 -->
     public override string GetCollectionName()
     {
         return _apiSettings.PatientsAppointments ?? "patients_appointments";
@@ -51,6 +55,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="patientId">The ID of the patient whose appointments are to be retrieved.</param>
     /// <returns>A list of patient appointments for the specified patient ID.</returns>
+    /// <!-- aidoc:v1 sig=c45e6c0 body=7fc6917 -->
     public async Task<List<PatientAppointment>> GetByPatient(ObjectId patientId)
     {
         var filter = Builders<PatientAppointment>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -69,6 +74,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="poc">The point of care details to filter appointments.</param>
     /// <returns>A list of patient appointments that match the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=6e05c46 body=b220747 -->
     public async Task<List<PatientAppointment>> FindByPoC(PointOfCare poc)
     {
         var location = new PatientLocation()
@@ -85,6 +91,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="appointment">The patient appointment to be inserted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=160dca2 body=b1d1f38 -->
     public override async Task InsertOneAsync(PatientAppointment appointment)
     {
         appointment.CreateTime ??= DateTime.UtcNow;
@@ -97,6 +104,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="appointment">The patient appointment to be updated.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=6653577 body=7202215 -->
     public async Task Update(PatientAppointment appointment)
     {
         await UpdateOneAsync(appointment.Id, appointment);
@@ -107,6 +115,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="id">The ID of the patient appointment to be deleted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=78c6c5d body=673af1f -->
     public new async Task DeleteAsync(ObjectId id)
     {
         var filter = Builders<PatientAppointment>.Filter.Eq(t => t.Id, id); // Replace 'T' with your actual class name.
@@ -118,6 +127,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="patientId">The ID of the patient whose appointments are to be retrieved.</param>
     /// <returns>An asynchronous cursor to iterate through the patient appointments.</returns>
+    /// <!-- aidoc:v1 sig=737aa7b body=4dc939c -->
     public Task<IAsyncCursor<PatientAppointment>> FindByPatientIdAsync(ObjectId patientId)
     {
         var filter = Builders<PatientAppointment>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -129,6 +139,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="patientId">The ID of the patient whose appointments are to be deleted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4776e51 body=b5830ef -->
     public async Task DeleteByPatientId(ObjectId patientId)
     {
         var filter = Builders<PatientAppointment>.Filter.Eq(po => po.PatientId, patientId);
@@ -141,6 +152,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// <param name="patientId">The ID of the patient whose appointment is to be retrieved.</param>
     /// <param name="visitNumber">The visit number of the appointment to be retrieved.</param>
     /// <returns>The first matching patient appointment if found, or null if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=713bd29 body=0453b7b -->
     public async Task<PatientAppointment?> FindByPatientAndVisitNumber(ObjectId patientId, string visitNumber)
     {
         var builder = Builders<PatientAppointment>.Filter;
@@ -160,6 +172,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// <param name="patientId">The ID of the patient whose appointment is to be retrieved.</param>
     /// <param name="appointmentReason">The reason for the appointment to be retrieved.</param>
     /// <returns>The first matching patient appointment if found, or null if no match is found.</returns>
+    /// <!-- aidoc:v1 sig=0d22413 body=622cd38 -->
     public async Task<PatientAppointment?> FindByPatientAndReason(ObjectId patientId, string? appointmentReason)
     {
         var builder = Builders<PatientAppointment>.Filter;
@@ -178,6 +191,8 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// </summary>
     /// <param name="location">The location details to filter patient appointments by.</param>
     /// <returns>A list of patient appointments that match the specified location.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary states the location 'includes details such as bed, room, and unit name', but the code only filters by Bed and UnitName; Room is not part of the filter." -->
     public async Task<List<PatientAppointment>> FindByLocation(PatientLocation location)
     {
         var builder = Builders<PatientAppointmentResourceGroup>.Filter;
@@ -200,6 +215,10 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// <param name="id">The new ObjectId to replace the old patient ID.</param>
     /// <param name="oldId">The old ObjectId of the patient whose appointments are to be updated.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states this method constructs a filter and uses UpdateManyAsync, but the code only awaits a call to UpdateManyObjectIdAsync without constructing any filter or calling UpdateManyAsync directly." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Mentions 'UpdateManyAsync method' which is not invoked here; the method delegates to UpdateManyObjectIdAsync instead." -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await UpdateManyObjectIdAsync(nameId, id, oldId);
@@ -210,6 +229,7 @@ public class AppointmentRepository : MongoRepository<PatientAppointment>, IAppoi
     /// The indexes are created in the background and are not unique.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=178452d -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/ArchivePatientCarePlanRepository.cs b/adas-core.Infrastructure/Repositories/ArchivePatientCarePlanRepository.cs
index c73b1916..bd1a8992 100644
--- a/adas-core.Infrastructure/Repositories/ArchivePatientCarePlanRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ArchivePatientCarePlanRepository.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// This class provides methods to perform CRUD operations and queries related to archived patient care plans, such as retrieving care plans by patient ID, inserting new care plans, and creating indexes. 
 /// It utilizes the MongoDB driver for database interactions and is configured using application settings for collection names and other parameters.
 /// </summary>
+/// <!-- aidoc:v1 sig=20f996a -->
 public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>, IArchivePatientCarePlanRepository
 {
     #region Properties
@@ -37,6 +38,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="logger">The logger for logging information, warnings, and errors.</param>
+    /// <!-- aidoc:v1 sig=ac3a86d body=8a9d2fd -->
     public ArchivePatientCarePlanRepository(
         IOptions<ApiSettings> apiSettings,
         IMongoDatabase database,
@@ -51,6 +53,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// This method ensures that the necessary indexes are created to optimize query performance, particularly for queries based on patient ID. The indexes are created in the background to avoid blocking operations on the database.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=747164e -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions<PatientCarePlan> { Background = true, Unique = false };
@@ -73,6 +76,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patient">The patient care plan to be inserted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=06563e4 body=65f486e -->
     public override async Task InsertOneAsync(PatientCarePlan patient)
     {
         try
@@ -93,6 +97,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patient">The list of patient care plans to be inserted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=67f7f21 body=d6d5f8a -->
     public override async Task InsertManyAsync(List<PatientCarePlan> patient)
     {
         try
@@ -116,6 +121,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// This method is used by the base repository class to determine which collection to interact with for CRUD operations.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=a3f1bbe -->
     public override string GetCollectionName()
     {
         return _apiSettings.ArchivePatientProcedure ?? "archive_patients_care_plan";
@@ -127,6 +133,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patientId">The ID of the patient whose care plans are to be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=33d98b1 body=fae3443 -->
     public async Task<List<PatientCarePlan>?> FindByPatientId(ObjectId patientId)
     {
         var result = await Collection.FindAsync(Builders<PatientCarePlan>.Filter.Eq(p => p.PatientId, patientId));
@@ -138,6 +145,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patientId">The ID of the patient whose care plans are to be retrieved, provided as a string.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=9198094 body=7897dce -->
     public async Task<List<PatientCarePlan>?> FindByPatientId(string patientId)
     {
         var isParsed = ObjectId.TryParse(patientId, out var patientIdParsed);
@@ -151,6 +159,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// </summary>
     /// <param name="patientNumber">The number of the patient whose care plans are to be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=3c65a30 body=41e7132 -->
     public async Task<List<PatientCarePlan>?> FindByPatientNumber(string patientNumber)
     {
         var result = await Collection.FindAsync(Builders<PatientCarePlan>.Filter.Eq(p => p.PatientNumber, patientNumber));
@@ -161,6 +170,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// Finds all patient care plans in the MongoDB collection. This method retrieves all documents from the collection and returns them as a list of <see cref="PatientCarePlan"/> objects.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=6a558a7 body=faea989 -->
     public async Task<List<PatientCarePlan>> FindAll()
     {
         var result = await Collection.Find(Builders<PatientCarePlan>.Filter.Empty).ToListAsync();
@@ -176,6 +186,7 @@ public class ArchivePatientCarePlanRepository : MongoRepository<PatientCarePlan>
     /// <param name="oldPatientPatientId">The ID of the patient whose care plans are to be retrieved, provided as a string.</param>
     /// <param name="oldPatientPatientNumber">The number of the patient whose care plans are to be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of <see cref="PatientCarePlan"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=1d58fb5 body=6e9839e -->
     public async Task<List<PatientCarePlan>?> FindByIds(ObjectId oldPatientId, string? oldPatientPatientId,
         string? oldPatientPatientNumber)
     {
diff --git a/adas-core.Infrastructure/Repositories/AuthorityRepository.cs b/adas-core.Infrastructure/Repositories/AuthorityRepository.cs
index 4cb20f2b..b1d2719d 100644
--- a/adas-core.Infrastructure/Repositories/AuthorityRepository.cs
+++ b/adas-core.Infrastructure/Repositories/AuthorityRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
 /// <param name="database">The MongoDB database instance.</param>
 /// <param name="logger">The logger for logging information, warnings, and errors.</param>
+/// <!-- aidoc:v1 sig=01b7bc7 -->
 public class AuthorityRepository(
     IOptions<ApiSettings> apiSettings,
     IMongoDatabase database,
@@ -29,6 +30,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="roleName">The name of the role to be assigned to the new authority.</param>
     /// <param name="userId">The ID of the user for whom the new authority is being created.</param>
+    /// <!-- aidoc:v1 sig=29e2cb9 body=ec4fdec -->
     public void CreateNewAuthority(string roleName, ObjectId userId)
     {
         var newAuthorization = new Authorization
@@ -48,6 +50,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="userId">The ID of the user whose authorities are being retrieved.</param>
     /// <returns>A list of authorities associated with the specified user ID.</returns>
+    /// <!-- aidoc:v1 sig=15ea92f body=00b4901 -->
     public async Task<List<Authorization>> GetUserAuthorities(ObjectId userId)
     {
         var filter = Builders<Authorization>.Filter.Eq(p => p.UserId, userId);
@@ -60,6 +63,7 @@ public class AuthorityRepository(
     /// Retrieves a list of all authorities in the system. This method queries the database for all authority records and returns them as a list. It also logs the retrieval of all authorities for debugging purposes.
     /// </summary>
     /// <returns>A list of all authorities in the system.</returns>
+    /// <!-- aidoc:v1 sig=e98ee21 body=736e0af -->
     public async Task<List<Authorization>> GetAllAuthorities()
     {
         var result = await Collection.FindAsync(Builders<Authorization>.Filter.Empty);
@@ -73,6 +77,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="unitId">The ID of the unit whose authorities are being retrieved.</param>
     /// <returns>A list of authorities associated with the specified unit ID.</returns>
+    /// <!-- aidoc:v1 sig=37cf403 body=a1ee959 -->
     public async Task<List<Authorization>> GetByUnitId(ObjectId unitId)
     {
         var filter = Builders<Authorization>.Filter.Eq(a => a.UnitId, unitId.ToString());
@@ -90,6 +95,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="userId">The ID of the user whose authorities are being deleted.</param>
     /// <returns>A boolean value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=731646b body=b62575f -->
     public async Task<bool> DeleteAllAuthoritiesByUser(ObjectId userId)
     {
         try
@@ -113,6 +119,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="unitId">The ID of the unit whose authorities are being deleted.</param>
     /// <returns>A boolean value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=3e0e6b6 body=4adf653 -->
     public async Task<bool> DeleteAllAuthoritiesByUnit(ObjectId unitId)
     {
         try
@@ -134,6 +141,7 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="displayId">The ID of the display whose authorities are being deleted.</param>
     /// <returns>A boolean value indicating whether the deletion was successful.</returns>
+    /// <!-- aidoc:v1 sig=a4dbbd6 body=3f3c2b8 -->
     public async Task<bool> DeleteAllAuthoritiesByDisplay(ObjectId displayId)
     {
         try
@@ -153,6 +161,7 @@ public class AuthorityRepository(
     /// Retrieves the name of the collection used for storing authorities in the database. This method returns the collection name as specified in the API settings configuration.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=f98b290 -->
     public override string GetCollectionName()
     {
         return _apiSettings.Authorizations;
@@ -164,6 +173,8 @@ public class AuthorityRepository(
     /// </summary>
     /// <param name="authId">The unique identifier of the authority to be retrieved.</param>
     /// <returns>The authority that matches the provided ID, or null if no matching authority is found.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Summary claims the method logs the retrieval for debugging purposes, but no logging code is present in the method body." -->
     public async Task<Authorization> GetById(ObjectId authId)
     {
         var filter = Builders<Authorization>.Filter.Eq(p => p.Id, authId);
@@ -176,6 +187,7 @@ public class AuthorityRepository(
     /// This method is typically called during the initial setup of the application to ensure that essential data is present in the database.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=ccdefcf body=d957dc7 -->
     public sealed override async Task InsertInitialLoad()
     {
         var user = Db.GetCollection<User>(apiSettings.Value.Users);
diff --git a/adas-core.Infrastructure/Repositories/CameraRepository.cs b/adas-core.Infrastructure/Repositories/CameraRepository.cs
index 81eb4980..d9ea0e1f 100644
--- a/adas-core.Infrastructure/Repositories/CameraRepository.cs
+++ b/adas-core.Infrastructure/Repositories/CameraRepository.cs
@@ -16,6 +16,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository for managing camera entities in the MongoDB database. This repository provides methods to create, retrieve, update, and search for cameras based on various criteria. 
 /// It also includes error handling and logging for debugging purposes.
 /// </summary>
+/// <!-- aidoc:v1 sig=003e7c1 -->
 public class CameraRepository : MongoRepository<Camera>, ICameraRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -26,6 +27,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// </summary>
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
+    /// <!-- aidoc:v1 sig=e4f283c body=12fddac -->
     public CameraRepository(IMongoDatabase database, IOptions<ApiSettings> apiSettings) : base(database)
     {
         _apiSettings = apiSettings.Value;
@@ -35,6 +37,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// Gets the name of the MongoDB collection that this repository interacts with. In this case, it returns the collection name for cameras as specified in the API settings.
     /// </summary>
     /// <returns>The name of the MongoDB collection for cameras.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=05f9f4e -->
     public override string GetCollectionName()
     {
        return _apiSettings.Cameras;
@@ -46,6 +49,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// </summary>
     /// <param name="cameraId">The unique identifier of the camera to retrieve.</param>
     /// <returns>The Camera object if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=6eb1bff body=8816446 -->
     public async Task<Camera?> GetById(ObjectId cameraId)
     {
         try
@@ -66,6 +70,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// </summary>
     /// <param name="name">The name of the camera to retrieve.</param>
     /// <returns>The Camera object if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=42cd675 body=e41e30c -->
     public async Task<Camera?> GetByName(string name)
     {
         var filterBuilder = Builders<Camera>.Filter;
@@ -81,6 +86,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// </summary>
     /// <param name="configurationRelayList">The list of camera IDs to retrieve.</param>
     /// <returns>A list of Camera objects that match the provided IDs.</returns>
+    /// <!-- aidoc:v1 sig=63176e6 body=14b9319 -->
     public List<Camera> GetCameraInList(List<ObjectId> configurationRelayList)
     {
         var filterBuilder = Builders<Camera>.Filter;
@@ -98,6 +104,12 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// <param name="filter">The pagination filter containing page number, page size, and any additional filtering criteria.</param>
     /// <returns>A paginated list of Camera objects.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided filter is invalid or contains invalid data.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Method returns IFindFluent<Camera, Camera>, not a paginated list of Camera objects." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims it 'retrieves a paginated list of camera entities' but the method returns an IFindFluent query builder, not a list." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "BadRequestException is thrown only when the text filter exceeds 100 characters; doc describes it generically as 'invalid filter or invalid data'." -->
     public IFindFluent<Camera, Camera> GetPaginatedCameras(PaginationFilter filter)
     {
         var filterBuilder = Builders<Camera>.Filter;
@@ -133,6 +145,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// </summary>
     /// <param name="camera">The Camera object to insert into the database.</param>
     /// <returns>The inserted Camera object if successful; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=4c3fa66 body=c723ea9 -->
     public async Task<Camera?> InsertOneCamera(Camera camera)
     {
         try
@@ -155,6 +168,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// <param name="objectId">The unique identifier of the camera to update.</param>
     /// <param name="camera">The Camera object containing the updated information.</param>
     /// <returns>The updated Camera object if successful; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=5dea533 body=003b000 -->
     public async Task<Camera?> UpdateCameraAsync(ObjectId objectId, Camera camera)
     {
         var filter = Builders<Camera>.Filter.Eq("_id", objectId);
@@ -178,6 +192,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// <param name="textToSearch">The text string to search for in the camera names.</param>
     /// <returns>A list of Camera objects whose names match the search criteria.</returns>
     /// <exception cref="BadRequestException">Thrown when the search text is too long.</exception>
+    /// <!-- aidoc:v1 sig=a584e66 body=efc6951 -->
     public async Task<List<Camera>> GetSearchByNameCameras(string textToSearch)
     {
         if (string.IsNullOrWhiteSpace(textToSearch))
@@ -202,6 +217,7 @@ public class CameraRepository : MongoRepository<Camera>, ICameraRepository
     /// <param name="filters">A list of filter definitions to apply to the query.</param>
     /// <param name="sort">A sort definition to apply to the query results.</param>
     /// <returns>An IFindFluent object for further query customization or execution.</returns>
+    /// <!-- aidoc:v1 sig=7aa3c5c body=e772829 -->
     private IFindFluent<Camera, Camera> CreateFindFluent(List<FilterDefinition<Camera>> filters, SortDefinition<Camera> sort)
     {
         var combinedFilter = filters.Any()
diff --git a/adas-core.Infrastructure/Repositories/ConfigObservationRepository.cs b/adas-core.Infrastructure/Repositories/ConfigObservationRepository.cs
index 66b6b303..31e280c5 100644
--- a/adas-core.Infrastructure/Repositories/ConfigObservationRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ConfigObservationRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repositorio para manejar las operaciones CRUD de ConfigObservation en MongoDB.
 /// </summary>
+/// <!-- aidoc:v1 sig=a788dff -->
 public class ConfigObservationRepository : MongoRepository<ConfigObservation>, IConfigObservationRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -26,6 +27,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// <param name="apiSettings">Configuración de la API.</param>
     /// <param name="database">Instancia de la base de datos MongoDB.</param>
     /// <param name="masterListServiceFactory">Fábrica de servicios de lista maestra.</param>
+    /// <!-- aidoc:v1 sig=da6c2d3 body=58ec731 -->
     public ConfigObservationRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database,
         IMasterListServiceFactory masterListServiceFactory) : base(database)
     {
@@ -37,6 +39,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Obtiene el nombre de la colección de MongoDB para ConfigObservation, utilizando la configuración proporcionada o un valor predeterminado.
     /// </summary>
     /// <returns>El nombre de la colección de MongoDB para ConfigObservation.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=101bc42 -->
     public override string GetCollectionName()
     {
         return _apiSettings.ConfigObservations ?? "config_observations";
@@ -47,6 +50,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="id">El ID del ConfigObservation a buscar.</param>
     /// <returns>El ConfigObservation encontrado, o null si no se encuentra.</returns>
+    /// <!-- aidoc:v1 sig=9e9dbe7 body=eb0c8ec -->
     public async Task<ConfigObservation?> FindById(ObjectId id)
     {
         var result = await Collection.FindAsync(Builders<ConfigObservation>.Filter.Eq(x => x.Id, id));
@@ -58,6 +62,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="configObservation">El ConfigObservation con los datos actualizados.</param>
     /// <returns>El ConfigObservation actualizado, o null si no se encuentra.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The documentation states it returns null if the document is not found, but the method body unconditionally returns the input configObservation parameter and never returns null." -->
     public async Task<ConfigObservation?> Update(ConfigObservation configObservation)
     {
         await UpdateOneAsync(configObservation.Id, configObservation);
@@ -69,6 +75,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=0493ac3 body=040c92d -->
     public async Task<ConfigObservation?> Delete(ObjectId id)
     {
         return await DeleteAsync(id);
@@ -78,6 +85,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Busca todos los IDs de ConfigObservation en la base de datos MongoDB.
     /// </summary>
     /// <returns>Una lista de todos los IDs de ConfigObservation.</returns>
+    /// <!-- aidoc:v1 sig=9552257 body=197e2a4 -->
     public async Task<List<ObjectId>> FindAllIds()
     {
         var allCollection = await Collection.FindAsync(_ => true);
@@ -89,6 +97,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Busca todos los ConfigObservation en la base de datos MongoDB.
     /// </summary>
     /// <returns>Una colección de todos los ConfigObservation.</returns>
+    /// <!-- aidoc:v1 sig=9ac53aa body=abac63b -->
     public async Task<ICollection<ConfigObservation>> FindAll()
     {
         var result = await Collection.FindAsync(_ => true);
@@ -100,6 +109,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="id">El ID del ConfigObservation para filtrar los nombres (opcional).</param>
     /// <returns>Una lista de nombres de ConfigObservation.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The 'id' parameter is documented as used to filter names, but the code never references it; the MongoDB filter is '_ => true' (all documents)." -->
     public async Task<List<string>> GetConfigNames(string id)
     {
         var allConfigs = await Collection.Find(_ => true).ToListAsync();
@@ -117,6 +128,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Busca todos los nombres de ConfigObservation en la base de datos MongoDB, eliminando duplicados y espacios en blanco.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The <returns> tag is empty and does not describe that the method returns a list of distinct, case-insensitive, trimmed configuration names." -->
     public async Task<List<string>> GetConfigNames()
     {
         var allConfigs = await Collection.Find(_ => true).ToListAsync();
@@ -134,6 +147,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Cuenta el número total de ConfigObservation en la base de datos MongoDB.
     /// </summary>
     /// <returns>El número total de ConfigObservation.</returns>
+    /// <!-- aidoc:v1 sig=acac1a2 body=4039511 -->
     public async Task<long> Count()
     {
         var filter = Builders<ConfigObservation>.Filter.Empty;
@@ -147,6 +161,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// <param name="filter">El filtro de paginación y búsqueda.</param>
     /// <returns>Una colección de ConfigObservation que cumple con los criterios de búsqueda y paginación.</returns>
     /// <exception cref="BadRequestException">Se lanza cuando el texto de búsqueda es demasiado largo.</exception>
+    /// <!-- aidoc:v1 sig=bfdfd9c body=7c0d92a -->
     public async Task<ICollection<ConfigObservation>> GetPaginatedItems(PaginationFilter filter)
     {
         var builder = Builders<ConfigObservation>.Filter;
@@ -196,6 +211,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// <param name="name">El nombre del ConfigObservation a buscar.</param>
     /// <returns>El ConfigObservation que coincide con el nombre proporcionado, o null si no se encuentra.</returns>
     /// <exception cref="BadRequestException">Se lanza cuando el nombre es nulo, vacío o demasiado largo.</exception>
+    /// <!-- aidoc:v1 sig=dd521a7 body=acfad20 -->
     public async Task<ConfigObservation?> FindByName(string name)
     {
         if (string.IsNullOrWhiteSpace(name))
@@ -222,6 +238,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// <param name="codingSystem">El sistema de codificación del ConfigObservation a buscar.</param>
     /// <param name="code">El código del ConfigObservation a buscar.</param>
     /// <returns>El ConfigObservation que coincide con el sistema de codificación y código proporcionados, o null si no se encuentra.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the search is case-insensitive ('búsqueda insensible a mayúsculas y minúsculas'), but the code uses Builders.Filter.Eq which is a case-sensitive equality match." -->
     public async Task<ConfigObservation?> GetByCodeSysAndCode(string? codingSystem, string? code)
     {
         var builder = Builders<ConfigObservation>.Filter;
@@ -245,6 +263,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="configObservationItem">El ConfigObservation a insertar en la base de datos.</param>
     /// <returns>El ConfigObservation insertado, incluyendo su ID generado.</returns>
+    /// <!-- aidoc:v1 sig=0a96f47 body=ed8eb4c -->
     public async Task<ConfigObservation> InsertOneAsyncAndReturn(ConfigObservation configObservationItem)
     {
         await Collection.InsertOneAsync(configObservationItem);
@@ -257,6 +276,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// </summary>
     /// <param name="name">El nombre del ConfigObservation a buscar.</param>
     /// <returns>Una lista de ConfigObservation que coinciden con el nombre proporcionado.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims a case-insensitive search ('insensible a mayúsculas y minúsculas'), but the code uses Builders.Eq which performs a case-sensitive equality match in MongoDB." -->
     public async Task<List<ConfigObservation>> FindAllByName(string name)
     {
         var builder = Builders<ConfigObservation>.Filter;
@@ -279,6 +300,8 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// <param name="name">El nombre del ConfigObservation a buscar.</param>
     /// <param name="originalName">El nombre original del ConfigObservation a buscar.</param>
     /// <returns>El ConfigObservation que coincide con los parámetros proporcionados, o null si no se encuentra.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the search is case-insensitive ('búsqueda insensible a mayúsculas y minúsculas'), but the code uses Builders<>.Eq which performs a case-sensitive equality match with no case-insensitive collation or regex." -->
     public async Task<ConfigObservation?> GetSingleConfigObservationItem(string? code, string? codingSystem,
         string? name, string? originalName)
     {
@@ -301,6 +324,7 @@ public class ConfigObservationRepository : MongoRepository<ConfigObservation>, I
     /// Si ya existen ConfigObservation en la base de datos, solo se insertan aquellos que faltan en comparación con la lista maestra.
     /// </summary>  
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=ccdefcf body=2d99abd -->
     public sealed override async Task InsertInitialLoad()
     {
         var stringNurseObs = _masterListServiceFactory.StringNurseObs();
diff --git a/adas-core.Infrastructure/Repositories/ConfigPumpsRepository.cs b/adas-core.Infrastructure/Repositories/ConfigPumpsRepository.cs
index d0d50419..351b50bb 100644
--- a/adas-core.Infrastructure/Repositories/ConfigPumpsRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ConfigPumpsRepository.cs
@@ -9,6 +9,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing ConfigPumps in MongoDB. Provides methods to retrieve, update, and delete pump configurations.
 /// </summary>
+/// <!-- aidoc:v1 sig=268862a -->
 public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -19,6 +20,7 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// <param name="apiSettings">The API settings.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=ee04ef2 body=d2b18a3 -->
     public ConfigPumpsRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -30,6 +32,7 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// Gets the name of the MongoDB collection for ConfigPumps. Uses the value from API settings or defaults to "config_pumps".
     /// </summary>
     /// <returns>The name of the MongoDB collection for ConfigPumps.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=04254e5 -->
     public override string GetCollectionName()
     {
         return _apiSettings.ConfigPumps ?? "config_pumps";
@@ -39,6 +42,8 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// Retrieves all ConfigPumps documents from the MongoDB collection. Returns a list of ConfigPumps or null if no documents are found.
     /// </summary>
     /// <returns>A list of ConfigPumps or null if no documents are found.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation states the method returns null if no documents are found, but the code always returns a list (ToList() returns an empty list when no documents match, never null)." -->
     public async Task<List<ConfigPumps>?> GetAllConfigs()
     {
         var result = await Collection.FindAsync(Builders<ConfigPumps>.Filter.Empty);
@@ -51,6 +56,7 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// </summary>
     /// <param name="id">The unique identifier of the ConfigPumps document.</param>
     /// <returns>The ConfigPumps document if found, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=00c3a1c body=e64c9f9 -->
     public async Task<ConfigPumps?> FindById(string id)
     {
         var result = await Collection.FindAsync(Builders<ConfigPumps>.Filter.Eq(x => x.Id, id));
@@ -65,6 +71,7 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// </summary>
     /// <param name="config">The ConfigPumps object containing the updated data.</param>
     /// <returns>The updated ConfigPumps document if found, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=cc52f62 body=3d18e97 -->
     public async Task<ConfigPumps?> UpdateConfig(ConfigPumps config)
     {
         var filter = Builders<ConfigPumps>.Filter.Eq("_id", config.Id);
@@ -80,6 +87,7 @@ public class ConfigPumpsRepository : MongoRepository<ConfigPumps>, IConfigPumpsR
     /// </summary>
     /// <param name="config">The ConfigPumps object to be deleted.</param>
     /// <returns>True if the deletion was successful, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=4d3028e body=1b2f41a -->
     public async Task<bool> DeleteConfig(ConfigPumps config)
     {
         var filter = Builders<ConfigPumps>.Filter.Eq("_id", config.Id);
diff --git a/adas-core.Infrastructure/Repositories/ConfigUnitsRepository.cs b/adas-core.Infrastructure/Repositories/ConfigUnitsRepository.cs
index cc2847b0..8b1c0cc5 100644
--- a/adas-core.Infrastructure/Repositories/ConfigUnitsRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ConfigUnitsRepository.cs
@@ -9,6 +9,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing ConfigUnits in MongoDB. Provides methods to retrieve and manipulate ConfigUnits data.
 /// </summary>
+/// <!-- aidoc:v1 sig=5a9f621 -->
 public class ConfigUnitsRepository : MongoRepository<ConfigUnits>, IConfigUnitsRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -19,6 +20,7 @@ public class ConfigUnitsRepository : MongoRepository<ConfigUnits>, IConfigUnitsR
     /// <param name="apiSettings">The API settings.</param>
     /// <param name="database">The MongoDB database.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=e6f329f body=d2b18a3 -->
     public ConfigUnitsRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -30,6 +32,7 @@ public class ConfigUnitsRepository : MongoRepository<ConfigUnits>, IConfigUnitsR
     /// Gets the name of the MongoDB collection for ConfigUnits. This method retrieves the collection name from the API settings, or defaults to "config_units" if not specified.
     /// </summary>
     /// <returns>The name of the MongoDB collection for ConfigUnits.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=a6d4b9f -->
     public override string GetCollectionName()
     {
         return _apiSettings.ConfigUnits ?? "config_units";
@@ -40,6 +43,7 @@ public class ConfigUnitsRepository : MongoRepository<ConfigUnits>, IConfigUnitsR
     /// </summary>
     /// <param name="id">The unique identifier of the ConfigUnits document.</param>
     /// <returns>The ConfigUnits document if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=5d21b10 body=63900d7 -->
     public async Task<ConfigUnits?> FindById(string id)
     {
         var resutl = await Collection.FindAsync(Builders<ConfigUnits>.Filter.Eq(x => x.Id, id));
diff --git a/adas-core.Infrastructure/Repositories/DeviceRepository.cs b/adas-core.Infrastructure/Repositories/DeviceRepository.cs
index 055e4f2d..ede747a7 100644
--- a/adas-core.Infrastructure/Repositories/DeviceRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DeviceRepository.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing Device entities in MongoDB. Provides methods for finding devices by various attributes and updating device statistics.
 /// </summary>
+/// <!-- aidoc:v1 sig=8160c8b -->
 public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -20,6 +21,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// </summary>
     /// <param name="apiSettings">The API settings.</param>
     /// <param name="database">The MongoDB database.</param>
+    /// <!-- aidoc:v1 sig=8e9392d body=d58addb -->
     public DeviceRepository(ApiSettings apiSettings, IMongoDatabase database) : base(database)
     {
         _apiSettings = apiSettings;
@@ -29,6 +31,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// Gets the name of the MongoDB collection for devices. The collection name is determined by the API settings, with a default value of "devices" if not specified.
     /// </summary>
     /// <returns>The name of the MongoDB collection for devices.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=8a1ceb4 -->
     public override string GetCollectionName()
     {
         return _apiSettings.Devices ?? "devices";
@@ -40,6 +43,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// The MacAddr index is unique, while the others are non-unique and created in the background.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=5d6df8e -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions { Background = true, Unique = true };
@@ -59,6 +63,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// </summary>
     /// <param name="deviceDtoMacAddr">The MAC address of the device to find.</param>
     /// <returns>The device with the specified MAC address, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=e831bcc body=02399ff -->
     public async Task<Device?> FindByMacAddr(string deviceDtoMacAddr)
     {
         return await Collection
@@ -71,6 +76,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// </summary>
     /// <param name="deviceDtoSerialNumber">The serial number of the device to find.</param>
     /// <returns>The device with the specified serial number, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=d482bd7 body=6f0ac54 -->
     public async Task<Device?> FindBySerialNumber(string deviceDtoSerialNumber)
     {
         return await Collection
@@ -83,6 +89,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// </summary>
     /// <param name="deviceDtoUuid">The UUID of the device to find.</param>
     /// <returns>The device with the specified UUID, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=af1665c body=db4fc30 -->
     public async Task<Device?> FindByUuid(string deviceDtoUuid)
     {
         return await Collection
@@ -95,6 +102,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// </summary>
     /// <param name="deviceDtoKey">The key of the device to find.</param>
     /// <returns>The device with the specified key, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=a1e1740 body=65c4079 -->
     public async Task<Device?> FindByKey(string deviceDtoKey)
     {
         return await Collection
@@ -109,6 +117,7 @@ public class DeviceRepository : MongoRepository<Device>, IDeviceRepository
     /// <param name="id">The ID of the device to update.</param>
     /// <param name="deviceExist">The existing DeviceDto object containing the updated statistics.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=0207e01 body=4ce9194 -->
     public async Task UpdateDeviceStats(ObjectId id, DeviceDto deviceExist)
     {
         var update = Builders<Device>.Update
diff --git a/adas-core.Infrastructure/Repositories/DiagnosisArchiveRepository.cs b/adas-core.Infrastructure/Repositories/DiagnosisArchiveRepository.cs
index 450f02d3..4651015e 100644
--- a/adas-core.Infrastructure/Repositories/DiagnosisArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DiagnosisArchiveRepository.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing archived patient diagnoses in MongoDB. This repository provides methods for inserting, deleting, and indexing patient diagnosis records in the archive collection.
 /// </summary>
+/// <!-- aidoc:v1 sig=577bbca -->
 public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDiagnosisArchiveRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -21,6 +22,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// <param name="apiSettings"></param>
     /// <param name="database"></param>
     /// <exception cref="ArgumentNullException"></exception>
+    /// <!-- aidoc:v1 sig=7317890 body=d2b18a3 -->
     public DiagnosisArchiveRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -33,6 +35,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// </summary>
     /// <param name="patientDiagnosis">The patient diagnosis record to insert.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=078dbb7 body=e8b7555 -->
     public override async Task InsertOneAsync(PatientDiagnosis patientDiagnosis)
     {
         await Collection.InsertOneAsync(patientDiagnosis);
@@ -43,6 +46,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// </summary>
     /// <param name="date">The date before which patient diagnosis records should be deleted.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=63daa66 body=6aa88ab -->
     public async Task DeleteBeforeDate(DateTime date)
     {
         var filter = Builders<PatientDiagnosis>.Filter.Lt(po => po.Time, date);
@@ -55,6 +59,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// </summary>
     /// <param name="observations">The collection of patient diagnosis records to insert.</param>
     /// <returns>The number of records successfully inserted.</returns>
+    /// <!-- aidoc:v1 sig=133455f body=c530ab0 -->
     public async Task<long> InsertBatch(IEnumerable<PatientDiagnosis> observations)
     {
         var writes = new List<WriteModel<PatientDiagnosis>>();
@@ -71,6 +76,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// If the API settings do not specify a collection name, a default name of "archive_patients_diagnosis" is used.
     /// </summary>
     /// <returns>The name of the MongoDB collection for archived patient diagnoses.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=4f8e6ac -->
     public override string GetCollectionName()
     {
         return _apiSettings.ArchivePatientsDiagnosis ?? "archive_patients_diagnosis";
@@ -80,6 +86,7 @@ public class DiagnosisArchiveRepository : MongoRepository<PatientDiagnosis>, IDi
     /// Creates indexes on the MongoDB collection for archived patient diagnoses to optimize query performance.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=f61edcf -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions<PatientDiagnosis> { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/DiagnosisRepository.cs b/adas-core.Infrastructure/Repositories/DiagnosisRepository.cs
index 6ca05b69..8d4c5578 100644
--- a/adas-core.Infrastructure/Repositories/DiagnosisRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DiagnosisRepository.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing patient diagnoses in a MongoDB collection. Provides methods for CRUD operations and querying diagnoses by patient ID and code.
 /// </summary>
+/// <!-- aidoc:v1 sig=4f19305 -->
 public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosisRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -21,6 +22,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when the API settings are null.</exception>
+    /// <!-- aidoc:v1 sig=e5a1bd3 body=d2b18a3 -->
     public DiagnosisRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -31,6 +33,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// Gets the name of the MongoDB collection for storing patient diagnoses. The collection name is determined by the API settings, and defaults to "patients_diagnosis" if not specified.
     /// </summary>
     /// <returns>The name of the MongoDB collection for patient diagnoses.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=feb8aa0 -->
     public override string GetCollectionName()
     {
         return _apiSettings.PatientsDiagnosis ?? "patients_diagnosis";
@@ -41,6 +44,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// </summary>
     /// <param name="patientId">The ID of the patient whose diagnoses are to be retrieved.</param>
     /// <returns>A list of patient diagnoses for the specified patient ID.</returns>
+    /// <!-- aidoc:v1 sig=29ab524 body=2b1e434 -->
     public async Task<List<PatientDiagnosis>> GetByPatient(ObjectId patientId)
     {
         var filter = Builders<PatientDiagnosis>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -55,6 +59,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// </summary>
     /// <param name="id">The ID of the patient diagnosis to delete.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=78c6c5d body=494b016 -->
     public new async Task DeleteAsync(ObjectId id)
     {
         var filter = Builders<PatientDiagnosis>.Filter.Eq(t => t.Id, id);
@@ -66,6 +71,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// </summary>
     /// <param name="diagnosis">The patient diagnosis to insert.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=d69e886 body=fba3aaf -->
     public override async Task InsertOneAsync(PatientDiagnosis diagnosis)
     {
         await Collection.InsertOneAsync(diagnosis);
@@ -76,6 +82,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// </summary>
     /// <param name="patientId">The ID of the patient whose diagnoses are to be deleted.</param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=4776e51 body=1287abe -->
     public async Task DeleteByPatientId(ObjectId patientId)
     {
         var filter = Builders<PatientDiagnosis>.Filter.Eq(po => po.PatientId, patientId);
@@ -91,6 +98,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// <param name="code">The code of the diagnosis.</param>
     /// <param name="codingSystem">The coding system of the diagnosis.</param>
     /// <returns>The matching patient diagnosis, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=9870e04 body=960248f -->
     public async Task<PatientDiagnosis?> FindByPatientIdAndCode(ObjectId patientId, string? code, string? codingSystem)
     {
         var builder = Builders<PatientDiagnosis>.Filter;
@@ -111,6 +119,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// </summary>
     /// <param name="patientId">The ID of the patient whose diagnoses are to be retrieved.</param>
     /// <returns>An asynchronous cursor of patient diagnoses.</returns>
+    /// <!-- aidoc:v1 sig=98dc0d1 body=8f5c296 -->
     public async Task<IAsyncCursor<PatientDiagnosis>> FindByPatientIdAsync(ObjectId patientId)
     {
         var filter = Builders<PatientDiagnosis>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -126,6 +135,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// <param name="id">The new patient ID to be set.</param>
     /// <param name="oldId">The old patient ID to be replaced.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=72ce1ca body=b9b81e9 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await UpdateManyObjectIdAsync(nameId, id, oldId);
@@ -135,6 +145,7 @@ public class DiagnosisRepository : MongoRepository<PatientDiagnosis>, IDiagnosis
     /// Creates indexes for the patient diagnosis collection. This method ensures that the necessary indexes are created on the MongoDB collection to optimize query performance.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=4955da2 body=5225318 -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/DischargeRepository.cs b/adas-core.Infrastructure/Repositories/DischargeRepository.cs
index 46c29bea..ef1fd655 100644
--- a/adas-core.Infrastructure/Repositories/DischargeRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DischargeRepository.cs
@@ -17,6 +17,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing Discharge entities in MongoDB. Provides methods for CRUD operations and specific queries related to discharges.
 /// </summary>
+/// <!-- aidoc:v1 sig=6c520ba -->
 public class DischargeRepository : MongoRepository<Discharge>, IDischargeRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -26,6 +27,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
     /// <param name="database">The MongoDB database instance.</param>
+    /// <!-- aidoc:v1 sig=37f77f4 body=12fddac -->
     public DischargeRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         _apiSettings = apiSettings.Value;
@@ -35,6 +37,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// Gets the name of the MongoDB collection for discharges from the API settings.
     /// </summary>
     /// <returns>The name of the MongoDB collection for discharges.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=d8f9298 -->
     public override string GetCollectionName()
     {
         return _apiSettings.Discharges;
@@ -45,6 +48,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="discharge">The discharge record to insert.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=e47013f body=e384f70 -->
     public override async Task InsertOneAsync(Discharge discharge)
     {
         try
@@ -63,6 +67,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="id">The ID of the discharge record to delete.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=7e7d153 -->
     public async Task Delete(ObjectId id)
     {
         try
@@ -83,6 +88,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// <param name="discharge">The discharge record to update.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="ConflictException"></exception>
+    /// <!-- aidoc:v1 sig=1ecc041 body=d41cd7e -->
     public async Task Update(Discharge discharge)
     {
         try
@@ -102,6 +108,8 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// <param name="id">The ID of the discharge record to update.</param>
     /// <param name="unit">The new unit name to set.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The summary claims 'If the update operation fails, an error is logged,' but the method body contains no try/catch, error handling, or logging — only an unawaited UpdateOneAsync call." -->
     public async Task UpdateUnit(ObjectId id, string unit)
     {
         var filterBuilder = Builders<Discharge>.Filter;
@@ -119,6 +127,8 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// <param name="id">The ID of the discharge record to update.</param>
     /// <param name="patient">The new patient information to set.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims 'If the update operation fails, an error is logged', but the code has no try-catch or logging mechanism — any failure would propagate as an exception." -->
     public async Task UpdatePatient(ObjectId id, Patient patient)
     {
         var filterBuilder = Builders<Discharge>.Filter;
@@ -134,6 +144,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// Finds and retrieves all discharge records from the MongoDB collection. If an error occurs during retrieval, an error is logged and an empty list is returned.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of all discharge records.</returns>
+    /// <!-- aidoc:v1 sig=87546e9 body=77eea29 -->
     public async Task<IEnumerable<Discharge>> FindAll()
     {
         try
@@ -153,6 +164,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="id">The ID of the discharge record to retrieve.</param>
     /// <returns>A task representing the asynchronous operation, containing the discharge record if found, or null if not found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=16a9670 body=05bd4d2 -->
     public async Task<Discharge?> FindById(ObjectId id)
     {
         try
@@ -174,6 +186,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="unit">The unit name to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of discharge records matching the specified unit name, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=26a3520 body=9cee09f -->
     public async Task<IEnumerable<Discharge>?> FindByUnit(string unit)
     {
         try
@@ -195,6 +208,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="unitId">The ID of the unit to count discharge records for.</param>
     /// <returns>A task representing the asynchronous operation, containing the count of discharge records matching the specified unit ID, or 0 if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=baa8175 body=1403f2e -->
     public async Task<long> CountByUnitId(ObjectId unitId)
     {
         try
@@ -214,6 +228,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="destination">The destination to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of discharge records matching the specified destination, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=7f6b4ab body=f403711 -->
     public async Task<IEnumerable<Discharge>?> FindByDestination(string destination)
     {
         try
@@ -238,6 +253,10 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="unitIds">The IDs of the units to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of discharge records matching the specified unit IDs, or null if an error occurs.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states that on error an error is logged and null is returned, but the method has no try/catch and no logging; exceptions would propagate, not be swallowed and converted to null." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The returns tag claims 'null if an error occurs', but the implementation never returns null on error (no exception handling); it only returns the ToListAsync result." -->
     public async Task<IEnumerable<Discharge>?> GetDischargesByUnitIds(IEnumerable<ObjectId>? unitIds)
     {
         var filterUnit = Builders<Discharge>.Filter.In("unitId", unitIds);
@@ -249,6 +268,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="pocId">The ID of the Point of Care to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of discharge records matching the specified Point of Care ID, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=13fd339 body=8de0a6c -->
     public async Task<IEnumerable<Discharge>?> FindByPoCId(ObjectId pocId)
     {
         try
@@ -271,6 +291,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="service">The service to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing a list of discharge records matching the specified service, or null if an error occurs.</returns>   
+    /// <!-- aidoc:v1 sig=8f5cc53 body=fa9829a -->
     public async Task<IEnumerable<Discharge>?> FindByService(string service)
     {
         try
@@ -292,6 +313,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="location">The patient location to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing the discharge record matching the specified patient location, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=d6f8db9 body=a619aca -->
     public async Task<Discharge?> GetDischargeByLocation(PatientLocation location)
     {
         try
@@ -313,6 +335,8 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="id">The ID of the Point of Care to search for.</param>
     /// <returns>A task representing the asynchronous operation, containing the discharge record matching the specified Point of Care ID, or null if an error occurs.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "Returns tag only mentions null in the error case, but FirstOrDefaultAsync also returns null when no matching discharge record is found" -->
     public async Task<Discharge?> GetDischargeByPointOfCareId(ObjectId id)
     {
         try
@@ -337,6 +361,10 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// <param name="opt">The update option specifying the changes to be applied to the master list.</param>
     /// <param name="typeName">The name of the master list type to be updated.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated discharge records, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'performs updates accordingly', but the switch cases are empty (only comments) and no actual update logic is present in the code." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims 'If an error occurs during the update process, an error is logged and an empty list is returned', but there is no error handling or logging in the code, and the method always returns an empty list." -->
     public Task<IEnumerable<Discharge>> UpdateMasterListOption(List<ObjectId> unitIds, UpdateOptionMasterListDto opt,
         string typeName)
     {
@@ -361,6 +389,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="unitId">The ID of the unit for which to delete discharge records.</param>
     /// <returns>A task representing the asynchronous operation, containing true if the deletion was successful, or false if an error occurred.</returns>
+    /// <!-- aidoc:v1 sig=d4333b3 body=a16e555 -->
     public async Task<bool> DeleteByUnitId(ObjectId unitId)
     {
         try
@@ -383,6 +412,12 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// <param name="opt">The update option specifying the changes to be applied to the master list.</param>
     /// <param name="typeName">The name of the master list type to be updated.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated discharge records, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The <param name=\"opt\"> description calls it 'The update option specifying the changes to be applied to the master list', but the method is a delete operation (DeleteMasterListOption), so this should describe a delete option, not an update option." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The <param name=\"typeName\"> description says 'The name of the master list type to be updated', but the method performs deletion, not update." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "The <returns> description says 'containing the updated discharge records', but the method deletes and returns discharge records, it does not update them." -->
     public Task<IEnumerable<Discharge>> DeleteMasterListOption(List<ObjectId> unitIds, OptionList opt, string typeName)
     {
         var isParsed = Enum.TryParse<MasterListType>(typeName, out var parsedTypeName);
@@ -406,6 +441,7 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// </summary>
     /// <param name="patientId">The ID of the patient for which to retrieve the discharge record.</param>
     /// <returns>A task representing the asynchronous operation, containing the discharge record if found, or null if an error occurs or the record is not found.</returns>
+    /// <!-- aidoc:v1 sig=e4173bb body=474ce38 -->
     public async Task<Discharge?> GetByPatientId(ObjectId patientId)
     {
         try
@@ -428,6 +464,8 @@ public class DischargeRepository : MongoRepository<Discharge>, IDischargeReposit
     /// If an error occurs during index creation, an error is logged.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary claims 'If an error occurs during index creation, an error is logged,' but the method body has no try/catch or logging code; error handling is delegated to MongoUtils.EnsureIndexes." -->
     public override async Task CreateIndexes()
     {
         var optionsUq = new CreateIndexOptions<Discharge>
diff --git a/adas-core.Infrastructure/Repositories/DisplayCardConfigRepository.cs b/adas-core.Infrastructure/Repositories/DisplayCardConfigRepository.cs
index 7b8ccc18..20a2c237 100644
--- a/adas-core.Infrastructure/Repositories/DisplayCardConfigRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DisplayCardConfigRepository.cs
@@ -12,6 +12,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing display card configurations in MongoDB. Provides methods to perform CRUD operations on CardConfig documents.
 /// </summary>
+/// <!-- aidoc:v1 sig=12ef408 -->
 public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplayCardConfigRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -23,6 +24,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="apiSettings">The API settings containing configuration for the repository.</param>
     /// <param name="logger">The logger instance for logging repository operations.</param>
+    /// <!-- aidoc:v1 sig=0e57fcf body=7dde119 -->
     public DisplayCardConfigRepository(
         IMongoDatabase database,
         ApiSettings apiSettings,
@@ -37,6 +39,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// Gets the name of the MongoDB collection for CardConfig documents, as specified in the API settings.
     /// </summary>
     /// <returns>The name of the MongoDB collection for CardConfig documents.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=9fe3e35 -->
     public override string GetCollectionName()
     {
         return _apiSettings.DisplayCardConfig;
@@ -46,6 +49,8 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// Retrieves all CardConfig documents from the MongoDB collection and returns them as a list. Logs any exceptions that occur during the retrieval process.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing a list of all CardConfig documents.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Summary claims the method 'Logs any exceptions that occur during the retrieval process,' but the code body contains no exception handling or logging." -->
     public async Task<List<CardConfig>> GetAll()
     {
         var result = await Collection.Find(Builders<CardConfig>.Filter.Empty).ToListAsync();
@@ -57,6 +62,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// </summary>
     /// <param name="configId">The unique identifier of the CardConfig document.</param>
     /// <returns>A task representing the asynchronous operation, containing the CardConfig document if found, or null if not found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=f4374bb body=2b6bbf9 -->
     public async Task<CardConfig?> GetById(ObjectId configId)
     {
         try
@@ -76,6 +82,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// </summary>
     /// <param name="config">The CardConfig document to insert.</param>
     /// <returns>A task representing the asynchronous operation, containing the inserted CardConfig document if successful, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=2193380 body=b92e5d6 -->
     public async Task<CardConfig?> InsertOneAsyncAndReturn(CardConfig config)
     {
         try
@@ -98,6 +105,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// </summary>
     /// <param name="config">The CardConfig document to update.</param>
     /// <returns>A task representing the asynchronous operation, containing an UpdateResponse with the number of modified documents and the updated document.</returns>
+    /// <!-- aidoc:v1 sig=5309b51 body=5aadf60 -->
     public async Task<UpdateResponse<CardConfig?>> UpdateOne(CardConfig? config)
     {
         try
@@ -124,6 +132,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// </summary>
     /// <param name="configId">The unique identifier of the CardConfig document to delete.</param>
     /// <returns>A task representing the asynchronous operation, containing the deleted CardConfig document if successful, or null if not found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=b415d24 body=47fbf6b -->
     public async Task<CardConfig?> DeleteOne(ObjectId configId)
     {
         return await DeleteAsync(configId);
@@ -136,6 +145,7 @@ public class DisplayCardConfigRepository : MongoRepository<CardConfig>, IDisplay
     /// <param name="resultId">The unique identifier of the result.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated CardConfig document if successful, or null if not found or an error occurs. </returns>
     /// <exception cref="NotImplementedException"></exception>
+    /// <!-- aidoc:v1 sig=385c445 body=bfa6f2f -->
     public Task<object> UpdateCardConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         throw new NotImplementedException();
diff --git a/adas-core.Infrastructure/Repositories/DisplayChartConfigRepository.cs b/adas-core.Infrastructure/Repositories/DisplayChartConfigRepository.cs
index cbed924d..a05dea1a 100644
--- a/adas-core.Infrastructure/Repositories/DisplayChartConfigRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DisplayChartConfigRepository.cs
@@ -12,6 +12,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Repository for managing ChartConfig in MongoDB. Provides methods to retrieve and manipulate ChartConfig data.
 /// </summary>
+/// <!-- aidoc:v1 sig=22edc0e -->
 public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDisplayChartConfigRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -24,6 +25,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="apiSettings">The API settings instance.</param>
     /// <param name="logger">The logger instance.</param>
+    /// <!-- aidoc:v1 sig=9ddd533 body=7dde119 -->
     public DisplayChartConfigRepository(IMongoDatabase database, ApiSettings apiSettings,
         ILogger<DisplayChartConfigRepository> logger) : base(database)
     {
@@ -35,6 +37,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// Gets the name of the MongoDB collection for ChartConfig. This method retrieves the collection name from the API settings.
     /// </summary>
     /// <returns>The name of the MongoDB collection for ChartConfig.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=0d27cbe -->
     public override string GetCollectionName()
     {
         return _apiSettings.DisplayChartConfig;
@@ -44,6 +47,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// Retrieves all ChartConfig documents from the MongoDB collection. This method returns a list of ChartConfig objects representing all the configurations stored in the database.
     /// </summary>
     /// <returns>A list of ChartConfig objects representing all the configurations stored in the database.</returns>
+    /// <!-- aidoc:v1 sig=c0c01a0 body=014de50 -->
     public async Task<List<ChartConfig>> GetAll()
     {
         var result = await Collection.Find(Builders<ChartConfig>.Filter.Empty).ToListAsync();
@@ -55,6 +59,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// </summary>
     /// <param name="configId">The unique identifier of the ChartConfig document.</param>
     /// <returns>The ChartConfig object if found, or null if no matching document is found.</returns>
+    /// <!-- aidoc:v1 sig=6225aa4 body=e406da3 -->
     public async Task<ChartConfig?> GetById(ObjectId configId)
     {
         try
@@ -75,6 +80,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// </summary>
     /// <param name="config">The ChartConfig object to be inserted into the MongoDB collection.</param>
     /// <returns>The inserted ChartConfig object if successful, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=14ecb27 body=b92e5d6 -->
     public async Task<ChartConfig?> InsertOneAsyncAndReturn(ChartConfig config)
     {
         try
@@ -97,6 +103,7 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// </summary>
     /// <param name="config">The ChartConfig object containing the updated data.</param>
     /// <returns>An UpdateResponse object containing the number of changes made and the updated ChartConfig document.</returns>
+    /// <!-- aidoc:v1 sig=6322c8a body=dcdf910 -->
     public async Task<UpdateResponse<ChartConfig?>> UpdateOne(ChartConfig? config)
     {
         try
@@ -129,6 +136,8 @@ public class DisplayChartConfigRepository : MongoRepository<ChartConfig>, IDispl
     /// </summary>
     /// <param name="configId">ChartConfig Id to be deleted </param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=low kind=missing_returns
+    ///      "<returns> tag is empty; method returns Task<ChartConfig?> (the deleted ChartConfig or null)" -->
     public async Task<ChartConfig?> DeleteOne(ObjectId configId)
     {
         return await DeleteAsync(configId);
diff --git a/adas-core.Infrastructure/Repositories/DisplayConfigRepository.cs b/adas-core.Infrastructure/Repositories/DisplayConfigRepository.cs
index 346a6a22..74006abe 100644
--- a/adas-core.Infrastructure/Repositories/DisplayConfigRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DisplayConfigRepository.cs
@@ -22,6 +22,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing DisplayConfig entities in MongoDB.
 /// Provides CRUD operations and specialized queries for display configurations.
 /// </summary>
+/// <!-- aidoc:v1 sig=ca069f4 -->
 public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayConfigRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -35,6 +36,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="logger">Logger for repository operations.</param>
     /// <param name="unitRepository">Repository for unit-related operations.</param>
+    /// <!-- aidoc:v1 sig=a0aa8ef body=0dfcbb0 -->
     public DisplayConfigRepository(
         IMongoDatabase database,
         ApiSettings apiSettings,
@@ -50,6 +52,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// Gets the name of the collection for display configurations.
     /// </summary>
     /// <returns>The collection name from API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=f8787a2 -->
     public override string GetCollectionName()
     {
         return _apiSettings.DisplaysConfig;
@@ -59,6 +62,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// Retrieves all display configurations from the database.
     /// </summary>
     /// <returns>A list of all DisplayConfig entities.</returns>
+    /// <!-- aidoc:v1 sig=fb4ed8e body=24446a1 -->
     public async Task<List<DisplayConfig>> GetAll()
     {
         var result = await Collection.Find(Builders<DisplayConfig>.Filter.Empty).ToListAsync();
@@ -71,6 +75,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="filter">The pagination and filtering parameters.</param>
     /// <returns>A fluent queryable for DisplayConfigSummary results.</returns>
     /// <exception cref="BadRequestException">Thrown when the text filter exceeds 100 characters.</exception>
+    /// <!-- aidoc:v1 sig=02e1b9c body=5dc4416 -->
     public IFindFluent<DisplayConfig, DisplayConfigSummary> GetAllPaginated(PaginationFilter filter)
     {
         var filterBuilder = Builders<DisplayConfig>.Filter;
@@ -116,6 +121,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="type">The display type to filter by.</param>
     /// <returns>A list of DisplayConfig entities matching the specified type.</returns>
+    /// <!-- aidoc:v1 sig=8122d6c body=0e1c2e7 -->
     public async Task<List<DisplayConfig>> GetByType(DisplayConfigEnums.DisplayType type)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(p => p.Type, type);
@@ -129,6 +135,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="id">The ObjectId of the display configuration to retrieve.</param>
     /// <returns>The DisplayConfig with related data, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=a9a2204 body=4378765 -->
     public async Task<DisplayConfig?> GetById(ObjectId id)
     {
         try
@@ -231,6 +238,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="type">The display type to search for.</param>
     /// <returns>The default DisplayConfig for the specified type, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=2078a2a body=724ce64 -->
     public async Task<DisplayConfig?> GetDefault(DisplayConfigEnums.DisplayType type)
     {
         var filter = Builders<DisplayConfig>.Filter.And(
@@ -248,6 +256,8 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="config">The DisplayConfig to insert.</param>
     /// The inserted DisplayConfig, or null if insertion fails.
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The <returns> tag is empty; the description 'The inserted DisplayConfig, or null if insertion fails.' is placed outside the tag, making the returns documentation structurally malformed." -->
     public async Task<DisplayConfig?> InsertOneAsyncAndReturn(DisplayConfig config)
     {
         try
@@ -268,6 +278,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="displayConfigId">The ObjectId of the display configuration to update.</param>
     /// <param name="newDisplayConfig">The new SmartDisplay configuration to apply.</param>
     /// <returns>The updated SmartDisplay configuration, or null if update fails.</returns>
+    /// <!-- aidoc:v1 sig=58bdfe0 body=590507f -->
     public async Task<SmartDisplay?> UpdateSmartDisplay(ObjectId displayConfigId, SmartDisplay? newDisplayConfig)
     {
         try
@@ -315,6 +326,8 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="colorConfig">The new ColorConfig to apply.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The documentation claims the method throws an exception if the MongoDB update fails, but the method catches all exceptions internally and returns false instead of throwing." -->
     public async Task<bool> UpdateConfigColor(ObjectId objectIdConfigDisplay, ColorConfig colorConfig)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq("Id", objectIdConfigDisplay);
@@ -362,6 +375,8 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="headerConfig">The new HeaderConfig to apply.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches all exceptions internally and returns false rather than throwing; the documented exception is never propagated to callers." -->
     public async Task<bool> UpdateHeaderConfig(ObjectId objectIdConfigDisplay, HeaderConfig headerConfig)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq("Id", objectIdConfigDisplay);
@@ -419,6 +434,8 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="bannerItems">The list of banner items to set.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches all exceptions and returns false; it never throws an exception as documented." -->
     public async Task<bool> UpdateSetHomeBanner(ObjectId objectIdConfigDisplay, List<BannerItem> bannerItems)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq("Id", objectIdConfigDisplay);
@@ -445,6 +462,8 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="baseConfig">The base DisplayConfig with updated values.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "The method catches all exceptions internally (try/catch logs and returns false) and never propagates an exception to the caller, yet the doc claims it throws Exception on MongoDB update failure." -->
     public async Task<bool> UpdateBaseConfig(ObjectId objectIdConfigDisplay, DisplayConfig baseConfig)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq("Id", objectIdConfigDisplay);
@@ -475,6 +494,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="newDisplayConfig">The new DisplayNurseDto configuration to apply.</param>
     /// <param name="nurseObs">List of observation names to mark as "last".</param>
     /// <returns>The updated DisplayNurse configuration, or null if update fails.</returns>
+    /// <!-- aidoc:v1 sig=0cb9b52 body=d8fcae3 -->
     public async Task<DisplayNurse?> UpdateDisplayNurse(ObjectId displayConfigId, DisplayNurseDto? newDisplayConfig,
         List<string> nurseObs)
     {
@@ -537,6 +557,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="objectIdConfigDisplay">The ObjectId of the display configuration to update.</param>
     /// <param name="name">The new hospital name.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=d760b75 body=7083954 -->
     public async Task<bool> UpdateDisplayConfigHospitalName(ObjectId objectIdConfigDisplay, string name)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(c => c.Id, objectIdConfigDisplay);
@@ -563,6 +584,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="objectIdConfigDisplay">The ObjectId of the display configuration to update.</param>
     /// <param name="fields">The new list of fields to set.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=43fa539 body=cc10b03 -->
     public async Task<bool> UpdateFieldList(ObjectId objectIdConfigDisplay, List<Field> fields)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(x => x.Id, objectIdConfigDisplay);
@@ -578,6 +600,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="unitId">The ObjectId of the unit.</param>
     /// <param name="displayType">The type of display configuration to retrieve.</param>
     /// <returns>The default DisplayConfig for the unit, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=af33a33 body=295e51e -->
     public async Task<DisplayConfig?> GetDefaultByUnitIdAndType(ObjectId unitId,
         DisplayConfigEnums.DisplayType displayType)
     {
@@ -602,6 +625,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="objectIdConfigDisplay">The ObjectId of the display configuration to delete.</param>
     /// <returns>The deleted DisplayConfig, or null if not found.</returns>
+    /// <!-- aidoc:v1 sig=cb87e31 body=36ac5e8 -->
     public async Task<DisplayConfig?> DeleteDisplayConfig(ObjectId objectIdConfigDisplay)
     {
         return await DeleteAsync(objectIdConfigDisplay);
@@ -611,6 +635,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// Retrieves all display configurations in compact format (minimal response).
     /// </summary>
     /// <returns>A list of DisplayConfigMinimalResponse containing Id, Hospital, and Type.</returns>
+    /// <!-- aidoc:v1 sig=5f61162 body=223c235 -->
     public Task<List<DisplayConfigMinimalResponse>> GetAllCompact()
     {
         var filter = Builders<DisplayConfig>.Filter.Empty;
@@ -629,6 +654,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="cardConfigId">The ObjectId of the card configuration.</param>
     /// <returns>A list of ObjectIds for display configurations using the specified card config.</returns>
+    /// <!-- aidoc:v1 sig=019036b body=4e73250 -->
     public async Task<List<ObjectId>> GetAllByCardConfigId(ObjectId cardConfigId)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(d => d.CardConfigId, cardConfigId);
@@ -645,6 +671,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="cardConfigId">The ObjectId of the card configuration.</param>
     /// <returns>A list of ObjectIds for display configurations using the specified card config in main or rotating layout.</returns>
+    /// <!-- aidoc:v1 sig=295400b body=1b55ad2 -->
     public async Task<List<ObjectId>> GetAllByCardConfigIdAndRotating(ObjectId cardConfigId)
     {
         var mainFilter = Builders<DisplayConfig>.Filter.Eq(d => d.CardConfigId, cardConfigId);
@@ -669,6 +696,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="displayConfigId">The ObjectId of the display configuration to update.</param>
     /// <param name="resultId">The new card configuration ID to set.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=bdfb090 body=66dd0a1 -->
     public async Task<bool> UpdateCardConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(x => x.Id, displayConfigId);
@@ -684,6 +712,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="displayConfigId">The ObjectId of the display configuration to update.</param>
     /// <param name="newChartIdToAdd">The new chart configuration ID to add.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=1b8d34f body=b651a1f -->
     public async Task<bool> AddChartId(ObjectId? displayConfigId, ObjectId newChartIdToAdd)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(x => x.Id, displayConfigId);
@@ -700,6 +729,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="deletedId">The ObjectId of the chart configuration that was deleted.</param>
     /// <returns>The MongoDB UpdateResult indicating the number of modified documents.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB operation fails.</exception>
+    /// <!-- aidoc:v1 sig=075b13a body=f79af77 -->
     public async Task<UpdateResult> UpdateDeletedChartConfig(ObjectId deletedId)
     {
         try
@@ -723,6 +753,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="objectIdConfigChart">The ObjectId of the chart configuration.</param>
     /// <returns>Always throws NotImplementedException.</returns>
     /// <exception cref="NotImplementedException">This method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=a5f05a4 body=bfa6f2f -->
     public Task<ChartConfig> GetChartConfig(ObjectId objectIdConfigChart)
     {
         throw new NotImplementedException();
@@ -734,6 +765,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="displayConfigId">The ObjectId of the display configuration to update.</param>
     /// <param name="resultId">The new detail configuration ID to set.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=4dd76a3 body=4d42278 -->
     public async Task<bool> UpdateDetailConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(x => x.Id, displayConfigId);
@@ -748,6 +780,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="baseConfigId">The ObjectId of the detail configuration.</param>
     /// <returns>A list of ObjectIds for display configurations using the specified detail config.</returns>
+    /// <!-- aidoc:v1 sig=63a6ce8 body=8cc75f6 -->
     public async Task<List<ObjectId>> GetAllByCardDetailConfigId(ObjectId baseConfigId)
     {
         var filter = Builders<DisplayConfig>.Filter.Eq(d => d.DetailConfigId, baseConfigId);
@@ -768,6 +801,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// - SmartDisplay
     /// - StandarDisplay
     /// </remarks>
+    /// <!-- aidoc:v1 sig=ccdefcf body=119a973 -->
     public sealed override async Task InsertInitialLoad()
     {
         // 1. Obtener todos los valores y castear al tipo IEnumerable<DisplayType>
@@ -828,6 +862,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="newDisplayConfig">The DisplayNurseDto configuration to extract fields from.</param>
     /// <param name="nurseObs">List of observation names to mark as "last" priority.</param>
     /// <returns>A list of Field objects with extracted observation names.</returns>
+    /// <!-- aidoc:v1 sig=be49f7a body=ac425f2 -->
     private List<Field> ExtractObservationFields(DisplayNurseDto newDisplayConfig, List<string> nurseObs)
     {
         var fieldSet = new HashSet<string>();
@@ -859,6 +894,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="newDisplayConfig">The JSON string to search for observation names.</param>
     /// <param name="regex">The regex pattern to match observation name arrays.</param>
     /// <param name="fieldSet">The hash set to populate with field names.</param>
+    /// <!-- aidoc:v1 sig=04f2381 body=6fed3f0 -->
     private void FillHashSet(string newDisplayConfig, Regex regex, HashSet<string> fieldSet)
     {
         var matches = regex.Matches(newDisplayConfig);
@@ -877,6 +913,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="cells">The list of cells to extract from.</param>
     /// <param name="fieldSet">The hash set to populate with field names.</param>
+    /// <!-- aidoc:v1 sig=dc14082 body=a8faa74 -->
     private void ExtractFromCells(List<Cell>? cells, HashSet<string> fieldSet)
     {
         if (cells is null)
@@ -900,6 +937,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="cells">The list of detail cells to extract from.</param>
     /// <param name="fieldSet">The hash set to populate with field names.</param>
+    /// <!-- aidoc:v1 sig=263c487 body=3b85da1 -->
     private void ExtractFromDetailsCells(List<CellDetails>? cells, HashSet<string> fieldSet)
     {
         if (cells is null)
@@ -924,6 +962,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// <param name="filters">List of filter definitions to apply.</param>
     /// <param name="sort">Sort definition for the query results.</param>
     /// <returns>A fluent queryable for DisplayConfigSummary.</returns>
+    /// <!-- aidoc:v1 sig=2b4f3c2 body=ceac316 -->
     private IFindFluent<DisplayConfig, DisplayConfigSummary> CreateFindFluentMinimal(
         List<FilterDefinition<DisplayConfig>> filters,
         SortDefinition<DisplayConfig> sort)
@@ -948,6 +987,7 @@ public class DisplayConfigRepository : MongoRepository<DisplayConfig>, IDisplayC
     /// </summary>
     /// <param name="baseConfig">The base DisplayConfig with values to update.</param>
     /// <returns>A tuple containing list of update definitions and list of field names.</returns>
+    /// <!-- aidoc:v1 sig=9aca42d body=1c04095 -->
     private (List<UpdateDefinition<DisplayConfig>> Updates, List<string> Fields) GetBaseUpdateDefinition(
         DisplayConfig baseConfig)
     {
diff --git a/adas-core.Infrastructure/Repositories/DisplayDetailConfigRepository.cs b/adas-core.Infrastructure/Repositories/DisplayDetailConfigRepository.cs
index 201632f7..4c756d71 100644
--- a/adas-core.Infrastructure/Repositories/DisplayDetailConfigRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DisplayDetailConfigRepository.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing CardDetailsConfig entities in MongoDB.
 /// Provides CRUD operations for display detail configurations used in nurse and smart displays.
 /// </summary>
+/// <!-- aidoc:v1 sig=34c7058 -->
 public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>, IDisplayDetailConfigRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -24,6 +25,7 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="logger">Logger for repository operations.</param>
+    /// <!-- aidoc:v1 sig=ad18f30 body=7dde119 -->
     public DisplayDetailConfigRepository(
         IMongoDatabase database,
         ApiSettings apiSettings,
@@ -38,6 +40,7 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// Gets the name of the collection for display detail configurations.
     /// </summary>
     /// <returns>The collection name from API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=957e9fe -->
     public override string GetCollectionName()
     {
         return _apiSettings.DisplayDetailConfig;
@@ -47,6 +50,7 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// Retrieves all display detail configurations from the database.
     /// </summary>
     /// <returns>A list of all CardDetailsConfig entities.</returns>
+    /// <!-- aidoc:v1 sig=7f19149 body=555d3e4 -->
     public async Task<List<CardDetailsConfig>> GetAll()
     {
         var result = await Collection.Find(Builders<CardDetailsConfig>.Filter.Empty).ToListAsync();
@@ -59,6 +63,8 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// <param name="configId">The ObjectId of the detail configuration to retrieve.</param>
     /// <returns>The CardDetailsConfig if found; otherwise, null.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB query fails; returns null instead.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches all exceptions and returns null; it never throws. The exception tag incorrectly states 'Throws an exception if MongoDB query fails' and is internally contradictory ('returns null instead')." -->
     public async Task<CardDetailsConfig?> GetById(ObjectId configId)
     {
         try
@@ -78,6 +84,7 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// </summary>
     /// <param name="config">The CardDetailsConfig to insert.</param>
     /// <returns>The inserted CardDetailsConfig, or null if insertion fails.</returns>
+    /// <!-- aidoc:v1 sig=269dde2 body=b92e5d6 -->
     public async Task<CardDetailsConfig?> InsertOneAsyncAndReturn(CardDetailsConfig config)
     {
         try
@@ -98,6 +105,8 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// <param name="config">The CardDetailsConfig with updated values.</param>
     /// <returns>An UpdateResponse containing the modified count and the updated document.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails; returns UpdateResponse with null document.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The <exception> tag states the method throws an exception on MongoDB failure, but the catch block catches Exception and never rethrows it; the method always returns an UpdateResponse." -->
     public async Task<UpdateResponse<CardDetailsConfig?>> UpdateOne(CardDetailsConfig? config)
     {
         try
@@ -130,6 +139,7 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// </summary>
     /// <param name="configId">The ObjectId of the configuration to delete.</param>
     /// <returns>The deleted CardDetailsConfig if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=84fe430 body=47fbf6b -->
     public async Task<CardDetailsConfig?> DeleteOne(ObjectId configId)
     {
         return await DeleteAsync(configId);
@@ -142,6 +152,8 @@ public class DisplayDetailConfigRepository : MongoRepository<CardDetailsConfig>,
     /// <param name="resultId">The new reference ID to set.</param>
     /// <returns>Always throws NotImplementedException.</returns>
     /// <exception cref="NotImplementedException">This method is not implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary only mentions updating 'the display configuration ID reference' but the method (UpdateCardConfigId) also takes a resultId parameter, indicating it updates more than just the display config ID" -->
     public Task<object> UpdateCardConfigId(ObjectId? displayConfigId, ObjectId? resultId)
     {
         throw new NotImplementedException();
diff --git a/adas-core.Infrastructure/Repositories/DisplayRepository.cs b/adas-core.Infrastructure/Repositories/DisplayRepository.cs
index 7ece2009..08e3e920 100644
--- a/adas-core.Infrastructure/Repositories/DisplayRepository.cs
+++ b/adas-core.Infrastructure/Repositories/DisplayRepository.cs
@@ -17,6 +17,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing Display entities in MongoDB.
 /// Provides CRUD operations and specialized queries for display devices.
 /// </summary>
+/// <!-- aidoc:v1 sig=4489fa0 -->
 public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
 {
     #region Properties
@@ -34,6 +35,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="logger">Logger for repository operations.</param>
+    /// <!-- aidoc:v1 sig=602ae85 body=8a9d2fd -->
     public DisplayRepository(
         IOptions<ApiSettings> apiSettings,
         IMongoDatabase database,
@@ -53,6 +55,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// Creates the necessary indexes for the Display collection.
     /// Creates indexes on displayConfigId and unitId fields for improved query performance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=e61cb51 -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions<Display> { Background = true, Unique = false };
@@ -74,6 +77,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// Gets the name of the collection for displays.
     /// </summary>
     /// <returns>The collection name from API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=1415d9e -->
     public override string GetCollectionName()
     {
         return _apiSettings.Displays;
@@ -83,6 +87,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// Retrieves all displays from the database.
     /// </summary>
     /// <returns>A list of all Display entities.</returns>
+    /// <!-- aidoc:v1 sig=f108028 body=b55a64a -->
     public async Task<List<Display>> GetAll()
     {
         var result = await Collection.Find(Builders<Display>.Filter.Empty).ToListAsync();
@@ -96,6 +101,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="filter">The pagination and filtering parameters.</param>
     /// <returns>A fluent queryable for Display results.</returns>
     /// <exception cref="BadRequestException">Thrown when the text filter exceeds 100 characters.</exception>
+    /// <!-- aidoc:v1 sig=2c97614 body=82ace38 -->
     public IFindFluent<Display, Display> GetPaginatedDisplays(PaginationFilter filter)
     {
         var filterBuilder = Builders<Display>.Filter;
@@ -148,6 +154,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="filters">List of filter definitions to apply.</param>
     /// <param name="sort">Sort definition for the query results.</param>
     /// <returns>A fluent queryable for Display results.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary says 'paginated displays' but the code only performs Find and Sort with no Skip/Limit pagination logic." -->
     private IFindFluent<Display, Display> CreateFindFluent(List<FilterDefinition<Display>> filters,
         SortDefinition<Display> sort)
     {
@@ -162,6 +170,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="pointOfCare">The PointOfCare to filter by.</param>
     /// <returns>A list of Display entities associated with the point of care.</returns>
+    /// <!-- aidoc:v1 sig=ad8af85 body=814934a -->
     public async Task<List<Display>> GetByPointOfCare(PointOfCare pointOfCare)
     {
         var filter = Builders<Display>.Filter.AnyEq(x => x.PointOfCareIdList, pointOfCare.Id);
@@ -174,6 +183,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="name">The name of the display to retrieve.</param>
     /// <returns>The Display if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=58df1bb body=fbf8613 -->
     public async Task<Display?> GetByName(string name)
     {
         var result = await Collection.FindAsync(Builders<Display>.Filter.Eq(p => p.Name, name));
@@ -185,6 +195,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="id">The ObjectId of the display to retrieve.</param>
     /// <returns>The Display if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=06fe2a7 body=9ea9cc7 -->
     public async Task<Display?> GetById(ObjectId id)
     {
         var result = await Collection.FindAsync(Builders<Display>.Filter.Eq(p => p.Id, id));
@@ -197,6 +208,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="id">The ObjectId of the display to retrieve.</param>
     /// <returns>The Display with DisplayConfig populated if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=9707594 body=ef3813d -->
     public async Task<Display?> GetByIdWithConfigDisplay(ObjectId id)
     {
         var pipeline = new BsonDocument[]
@@ -225,6 +237,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="id">The ObjectId of the unit.</param>
     /// <returns>A list of Display entities associated with the unit.</returns>
+    /// <!-- aidoc:v1 sig=30d0bf1 body=d267dcd -->
     public async Task<List<Display>> GetByUnitId(ObjectId id)
     {
         var filter = Builders<Display>.Filter.Eq(p => p.UnitId, id);
@@ -238,6 +251,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="unitId">The ObjectId of the unit.</param>
     /// <returns>The count of displays for the unit, or 0 if an error occurs.</returns>
     /// <exception cref="Exception">Logs errors and returns 0 on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "Method catches Exception internally and returns 0; it does not throw Exception. The <exception> tag misleads readers about thrown exceptions." -->
     public async Task<long> CountByUnitId(ObjectId unitId)
     {
         try
@@ -256,6 +271,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="id">The ObjectId of the display configuration.</param>
     /// <returns>A list of Display entities using the specified configuration.</returns>
+    /// <!-- aidoc:v1 sig=55e6b45 body=769064e -->
     public async Task<List<Display>> GetByConfigId(ObjectId id)
     {
         var result = await Collection.FindAsync(Builders<Display>.Filter.Eq(p => p.DisplayConfigId, id));
@@ -269,6 +285,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="configId">The ObjectId of the card configuration.</param>
     /// <returns>A list of Display entities using the specified card config, or empty list on error.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The <exception cref=\"Exception\"> tag documents an exception that the method catches internally and never propagates to callers; the method instead returns an empty list. Exception tags should describe exceptions thrown to the caller." -->
     public async Task<List<Display>> GetByCardConfigId(ObjectId configId)
     {
         try
@@ -307,6 +325,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// </summary>
     /// <param name="displayConfigId">The ObjectId of the display configuration to check.</param>
     /// <returns>The count of displays using the configuration.</returns>
+    /// <!-- aidoc:v1 sig=fddd490 body=6e359c3 -->
     public async Task<long> IsDisplayConfigInUse(ObjectId displayConfigId)
     {
         return await Collection.CountDocumentsAsync(
@@ -324,6 +343,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="listPocObId">The new list of point of care ObjectIds.</param>
     /// <returns>The updated Display if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "Method catches all exceptions (catch (Exception e)) and returns null; no exception is actually thrown or propagated. The <exception cref=\"Exception\"> tag misleads readers into expecting the method to throw." -->
     public async Task<Display?> UpdatePointOfCareList(ObjectId objectId, List<ObjectId> listPocObId)
     {
         try
@@ -349,6 +370,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="config">The new DisplayConfig to set.</param>
     /// <returns>The updated Display if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The catch block swallows all exceptions and returns null, so Exception is never propagated to the caller." -->
     public async Task<Display?> UpdateConfig(ObjectId objectId, DisplayConfig config)
     {
         try
@@ -374,6 +397,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="displayConfigId">The new display configuration ObjectId to set.</param>
     /// <returns>The updated Display if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions internally and returns null; it never throws Exception, so documenting <exception cref=\"Exception\"> is misleading for callers." -->
     public async Task<Display?> UpdateConfigId(ObjectId objectId, ObjectId displayConfigId)
     {
         try
@@ -399,6 +424,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="objectIdConfigDisplay">The ObjectId of the display configuration preset.</param>
     /// <returns>The updated Display if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches Exception internally and never rethrows it, so <exception cref=\"Exception\"> misleads callers into expecting the exception to propagate. The method always returns null on failure rather than throwing." -->
     public async Task<Display?> UpdateConfigPreset(ObjectId objectIdDisplay, ObjectId objectIdConfigDisplay)
     {
         try
@@ -424,6 +451,7 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="name">The new name for the display.</param>
     /// <returns>The updated Display if successful.</returns>
     /// <exception cref="Exception">Throws an exception if MongoDB update fails.</exception>
+    /// <!-- aidoc:v1 sig=0662978 body=870f296 -->
     public async Task<Display> UpdateName(Display display, string name)
     {
         try
@@ -453,6 +481,8 @@ public class DisplayRepository : MongoRepository<Display>, IDisplayRepository
     /// <param name="unitId">The ObjectId of the unit whose displays should be deleted.</param>
     /// <returns>True if deletion was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Logs errors and returns false on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches all exceptions internally via `catch (Exception e)` and never propagates them to the caller; documenting `Exception` as a thrown exception is misleading" -->
     public async Task<bool> DeleteManyByUnitId(ObjectId unitId)
     {
         try
diff --git a/adas-core.Infrastructure/Repositories/HistoricalConfigChangesRepository.cs b/adas-core.Infrastructure/Repositories/HistoricalConfigChangesRepository.cs
index c4c7b714..c4481c7f 100644
--- a/adas-core.Infrastructure/Repositories/HistoricalConfigChangesRepository.cs
+++ b/adas-core.Infrastructure/Repositories/HistoricalConfigChangesRepository.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing HistoricalConfigChanges entities in MongoDB.
 /// Provides CRUD operations and specialized queries for tracking configuration changes over time.
 /// </summary>
+/// <!-- aidoc:v1 sig=ac48934 -->
 public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfigChanges>,
     IHistoricalConfigChangesRepository
 {
@@ -27,6 +28,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// <param name="database">The MongoDB database instance.</param>
     /// <param name="logger">Logger for repository operations.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=4d362f8 body=a0d2d7c -->
     public HistoricalConfigChangesRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database,
         ILogger<HistoricalConfigChangesRepository> logger) : base(database)
     {
@@ -39,6 +41,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// Gets the name of the collection for historical configuration changes.
     /// </summary>
     /// <returns>The collection name from API settings, or default "historicalConfigChanges".</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=211bf70 -->
     public override string GetCollectionName()
     {
         return _apiSettings.HistoricalConfigChanges ?? "historicalConfigChanges";
@@ -50,6 +53,8 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// <param name="historicalConfigChanges">The HistoricalConfigChanges entity to insert.</param>
     /// <returns>The inserted HistoricalConfigChanges with generated ID, or null if insertion fails.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The <exception cref=\"Exception\"> tag implies the method throws Exception, but the catch block catches all exceptions internally and returns null; the method does not propagate any exceptions to the caller." -->
     public override async Task<HistoricalConfigChanges?> InsertOneAsync(HistoricalConfigChanges historicalConfigChanges)
     {
         try
@@ -69,6 +74,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// </summary>
     /// <param name="id">The ObjectId of the record to delete.</param>
     /// <returns>The deleted HistoricalConfigChanges if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=20dbcc3 body=040c92d -->
     public async Task<HistoricalConfigChanges?> Delete(ObjectId id)
     {
         return await DeleteAsync(id);
@@ -78,6 +84,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// Retrieves all historical configuration change records.
     /// </summary>
     /// <returns>A collection of all HistoricalConfigChanges entities.</returns>
+    /// <!-- aidoc:v1 sig=d7a85d4 body=abac63b -->
     public async Task<ICollection<HistoricalConfigChanges>> FindAll()
     {
         var result = await Collection.FindAsync(_ => true);
@@ -88,6 +95,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// Retrieves all IDs of historical configuration change records.
     /// </summary>
     /// <returns>A list of all ObjectIds in the collection.</returns>
+    /// <!-- aidoc:v1 sig=9552257 body=9650290 -->
     public async Task<List<ObjectId>> FindAllIds()
     {
         List<ObjectId> listCollection = [];
@@ -103,6 +111,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// </summary>
     /// <param name="id">The ObjectId of the record to retrieve.</param>
     /// <returns>The HistoricalConfigChanges if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=1f8f1f0 body=dbebfe0 -->
     public async Task<HistoricalConfigChanges?> FindById(ObjectId id)
     {
         var result = await Collection.FindAsync(Builders<HistoricalConfigChanges>.Filter.Eq(x => x.Id, id));
@@ -114,6 +123,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// </summary>
     /// <param name="historicalConfigChanges">The HistoricalConfigChanges with updated values.</param>
     /// <returns>The updated HistoricalConfigChanges if successful; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=42cea8e body=6c26e7c -->
     public async Task<HistoricalConfigChanges?> Update(HistoricalConfigChanges historicalConfigChanges)
     {
         var filter = Builders<HistoricalConfigChanges>.Filter.Eq("_id", historicalConfigChanges.Id);
@@ -136,6 +146,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// <param name="cfgType">The type of configuration to filter by.</param>
     /// <param name="num">The maximum number of records to retrieve. Default is 10.</param>
     /// <returns>A collection of the most recent HistoricalConfigChanges for the specified type.</returns>
+    /// <!-- aidoc:v1 sig=bc7ddf0 body=c5e6a70 -->
     public async Task<ICollection<HistoricalConfigChanges>> FindLastHistoricalConfigChangesByType(
         DisplayConfigEnums.ConfigTypes cfgType, int num = 10)
     {
@@ -159,6 +170,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// <param name="cfgType">Optional configuration type to filter by. If null, all types are included.</param>
     /// <param name="num">The maximum number of records to retrieve. Default is 10.</param>
     /// <returns>A collection of the most recent HistoricalConfigChanges for the specified user.</returns>
+    /// <!-- aidoc:v1 sig=2ce032b body=646e240 -->
     public async Task<ICollection<HistoricalConfigChanges>> FindLastHistoricalConfigChangesByUser(string user,
         DisplayConfigEnums.ConfigTypes? cfgType = null, int num = 10)
     {
@@ -181,6 +193,7 @@ public class HistoricalConfigChangesRepository : MongoRepository<HistoricalConfi
     /// Creates compound indexes on (configType, time) and (username, time) for improved query performance.
     /// </summary>
     /// <exception cref="Exception">Throws an exception if index creation fails; logs error details before throwing.</exception>
+    /// <!-- aidoc:v1 sig=4955da2 body=f833046 -->
     public override async Task CreateIndexes()
     {
         try
diff --git a/adas-core.Infrastructure/Repositories/LightBeaconRepository.cs b/adas-core.Infrastructure/Repositories/LightBeaconRepository.cs
index 722917b3..65e0d821 100644
--- a/adas-core.Infrastructure/Repositories/LightBeaconRepository.cs
+++ b/adas-core.Infrastructure/Repositories/LightBeaconRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing <see cref="LightBeacon"/> entities in MongoDB.
 /// Provides CRUD operations and query capabilities specific to light beacons.
 /// </summary>
+/// <!-- aidoc:v1 sig=f6a410c -->
 public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -25,6 +26,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// </summary>
     /// <param name="database">The MongoDB database instance used to access the collection.</param>
     /// <param name="apiSettings">The application API settings containing configuration values, including the collection name.</param>
+    /// <!-- aidoc:v1 sig=005180d body=12fddac -->
     public LightBeaconRepository(IMongoDatabase database, IOptions<ApiSettings> apiSettings) : base(database)
     {
         _apiSettings = apiSettings.Value;
@@ -34,6 +36,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// Gets the name of the MongoDB collection used to store light beacons.
     /// </summary>
     /// <returns>The collection name retrieved from the API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=b7c9492 -->
     public override string GetCollectionName()
     {
         return _apiSettings.LightBeacons;
@@ -44,6 +47,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// </summary>
     /// <param name="configurationRelayList">A list of <see cref="ObjectId"/> values representing the relay identifiers to filter by.</param>
     /// <returns>A <see cref="List{LightBeacon}"/> containing the matching light beacons. Returns an empty list if no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=c392d31 body=b387b94 -->
     public List<LightBeacon> GetLightBeaconInList(List<ObjectId> configurationRelayList)
     {
         var filterBuilder = Builders<LightBeacon>.Filter;
@@ -62,6 +66,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// A <see cref="Task{LightBeacon}"/> representing the asynchronous operation.
     /// The task result contains the <see cref="LightBeacon"/> if found; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=0f2f926 body=1b42ab2 -->
     public async Task<LightBeacon?> GetById(ObjectId relayId)
     {
         try
@@ -85,6 +90,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// A <see cref="Task{LightBeacon}"/> representing the asynchronous operation.
     /// The task result contains the <see cref="LightBeacon"/> if found; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=adf2a24 body=8e1d78c -->
     public async Task<LightBeacon?> GetByName(string? requestRelayName)
     {
         var filterBuilder = Builders<LightBeacon>.Filter;
@@ -102,6 +108,8 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// A <see cref="Task{LightBeacon}"/> representing the asynchronous operation.
     /// The task result contains the inserted <see cref="LightBeacon"/> if successful; otherwise, <see langword="null"/> if the operation fails.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The cref in the <returns> tag references Task{LightBeacon}, but the method's actual return type is Task<LightBeacon?} (nullable). The descriptive text correctly mentions the null case, so the semantic meaning is preserved, but the type reference is inaccurate." -->
     public async Task<LightBeacon?> InsertOneAsyncAndReturn(LightBeacon beacon)
     {
         try
@@ -125,6 +133,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// An <see cref="IFindFluent{LightBeacon, LightBeacon}"/> instance that can be used to further refine and execute the query.
     /// </returns>
     /// <exception cref="BadRequestException">Thrown when the text filter exceeds 100 characters in length.</exception>
+    /// <!-- aidoc:v1 sig=07ed538 body=4c87ab2 -->
     public IFindFluent<LightBeacon, LightBeacon> GetPaginatedRelays(PaginationFilter filter)
     {
         var filterBuilder = Builders<LightBeacon>.Filter;
@@ -163,6 +172,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// containing a list of matching <see cref="LightBeacon"/> objects.
     /// </returns>
     /// <exception cref="NotImplementedException">This method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=7342f3e body=bfa6f2f -->
     public Task<List<LightBeacon>> GetSearchByName(string textToSearch)
     {
         throw new NotImplementedException();
@@ -175,6 +185,7 @@ public class LightBeaconRepository : MongoRepository<LightBeacon>, ILightBeaconR
     /// <param name="filters">A list of <see cref="FilterDefinition{LightBeacon}"/> to be combined into the query.</param>
     /// <param name="sort">The <see cref="SortDefinition{LightBeacon}"/> defining the sort order of the results.</param>
     /// <returns>An <see cref="IFindFluent{LightBeacon, LightBeacon}"/> instance representing the constructed query.</returns>
+    /// <!-- aidoc:v1 sig=1b1403f body=e71d1c5 -->
     private IFindFluent<LightBeacon, LightBeacon> CreateFindFluent(List<FilterDefinition<LightBeacon>> filters, SortDefinition<LightBeacon> sort)
     {
         var combinedFilter = filters.Any()
diff --git a/adas-core.Infrastructure/Repositories/MasterListRepository.cs b/adas-core.Infrastructure/Repositories/MasterListRepository.cs
index a16f76be..e771a55e 100644
--- a/adas-core.Infrastructure/Repositories/MasterListRepository.cs
+++ b/adas-core.Infrastructure/Repositories/MasterListRepository.cs
@@ -20,6 +20,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// options lists, diagnoses, allergies, procedures, treatments, and other reference data.
 /// </summary>
 /// <typeparam name="T">The type of MasterList entity to manage.</typeparam>
+/// <!-- aidoc:v1 sig=f958de2 -->
 public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository<T> where T : MasterList
 {
     private readonly ApiSettings _apiSettings;
@@ -30,6 +31,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=800d538 body=d2b18a3 -->
     public MasterListRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -41,6 +43,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// Maps different MasterList subtypes to their corresponding MongoDB collection names.
     /// </summary>
     /// <returns>The collection name for the current MasterList type.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=64e6c55 -->
     public override string GetCollectionName()
     {
         return typeof(T) switch
@@ -76,6 +79,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="entity">The entity to insert.</param>
     /// <exception cref="Exception">Throws and re-throws exceptions after logging.</exception>
+    /// <!-- aidoc:v1 sig=c7a7ad8 body=26b3581 -->
     public override async Task InsertOneAsync(T entity)
     {
         try
@@ -94,6 +98,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="id">The ObjectId of the entity to delete.</param>
     /// <exception cref="Exception">Throws and re-throws exceptions after logging.</exception>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=fe0ba8c -->
     public async Task Delete(ObjectId id)
     {
         try
@@ -113,6 +118,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="entity">The entity with updated values.</param>
     /// <exception cref="Exception">Throws and re-throws exceptions after logging.</exception>
+    /// <!-- aidoc:v1 sig=019b691 body=863650a -->
     public async Task Update(T entity)
     {
         try
@@ -133,6 +139,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="id">The ObjectId of the master list.</param>
     /// <param name="newOpt">The OptionList with updated values.</param>
     /// <returns>The updated OptionList if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=64ca4dd body=a7714e6 -->
     public async Task<OptionList?> UpdateFullMasterListOption(ObjectId id, OptionList newOpt)
     {
         var filter = Builders<T>.Filter.Where(o => o.Id == id && o.Options.Any(opt => opt.Id == newOpt.Id)
@@ -166,6 +173,12 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="id">The ObjectId of the entity to retrieve.</param>
     /// <returns>The MasterList entity if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documents 'MasterList entity' but the method returns the generic type T? (Task<T?>)." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "Documents <exception cref='Exception'> but the method catches and handles all Exception internally, returning null; it does not rethrow." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary refers specifically to a 'master list entity' though the method is generic (Task<T?>) and not bound to a MasterList type." -->
     public async Task<T?> FindById(ObjectId id)
     {
         try
@@ -197,6 +210,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="locale">The locale for translation.</param>
     /// <returns>The OptionList with translated fields if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc:v1 sig=fdb2628 body=0e4983e -->
     public async Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId, LocaleEnum locale)
     {
         try
@@ -342,6 +356,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="optionId">The ObjectId of the option to retrieve.</param>
     /// <returns>The OptionList if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches Exception and returns null; it never propagates any exception, so documenting it with <exception cref=\"Exception\"> is misleading." -->
     public async Task<OptionList?> FindOptionItemById(ObjectId masterId, ObjectId optionId)
     {
         try
@@ -374,6 +390,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="locale">Optional locale for translated option names.</param>
     /// <returns>The MasterList entity with translated options if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches Exception internally and returns null; it does not propagate Exception to the caller, so the <exception cref=\"Exception\"/> tag is misleading." -->
     public async Task<T?> FindById(ObjectId id, LocaleEnum? locale)
     {
         try
@@ -556,6 +574,14 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="name">The name of the master list to retrieve.</param>
     /// <returns>The MasterList entity if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary says 'master list entity' but the method is generic (FindByName<T>) and is not specific to master lists." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns tag says 'The MasterList entity if found; otherwise, null' but the method returns Task<T?>, a generic nullable type, not specifically a MasterList." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "Param description refers to 'the master list to retrieve', but the entity type is the generic T, not specifically MasterList." -->
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "Documents <exception cref='Exception'> but the method catches all Exception instances and never propagates them to the caller." -->
     public async Task<T?> FindByName(string name)
     {
         try
@@ -584,6 +610,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="id">The ObjectId of the master list.</param>
     /// <param name="textSearch">Optional text to search within options.</param>
     /// <returns>A list of matching OptionList items.</returns>
+    /// <!-- aidoc:v1 sig=569d223 body=bb7f2c6 -->
     public async Task<List<OptionList>> GetMasterListByIdAndTextSearchContaining(ObjectId id, string? textSearch)
     {
         return await GetOptionsByTextSearch(textSearch, id);
@@ -594,6 +621,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="filter">The pagination and filtering parameters.</param>
     /// <returns>A fluent queryable for MasterList results.</returns>
+    /// <!-- aidoc:v1 sig=bbb39c7 body=f42ebaa -->
     public IFindFluent<T, T> GetPaginatedMasterList(PaginationFilter filter)
     {
         var filterBuilder = Builders<T>.Filter;
@@ -621,6 +649,10 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="filter">The pagination and filtering parameters.</param>
     /// <param name="listId">The ObjectId of the master list.</param>
     /// <returns>A list of filtered OptionList items.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims pagination is performed, but the code only applies an optional text filter and returns all matching options with no Skip/Take/page logic." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Documentation describes pagination via the filter, but no pagination is applied; only FilteredRequest.Text is consumed." -->
     public async Task<List<OptionList>> GetPaginatedOptions(PaginationFilter filter, ObjectId listId)
     {
         //TODO: LOCALE
@@ -646,6 +678,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="opt">The option element to add.</param>
     /// <returns>The newly created OptionList if successful; otherwise, null if duplicate exists.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "The method catches Exception internally and returns null; it never propagates an Exception to the caller, so the <exception> tag is incorrect." -->
     public async Task<OptionList?> AddOptionToMasterList(ObjectId id, FilterOptionListElement opt)
     {
         var exist = await GetMasterListByIdAndSearchOptions(id, opt);
@@ -689,6 +723,10 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <returns>An enumerable of all MasterList entities.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation states the method returns 'MasterList entities', but the method is generic and returns IEnumerable<T>." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary describes retrieving 'all master list entities', but the method is a generic GetAll<T>() that retrieves all entities of the type parameter T." -->
     public async Task<IEnumerable<T>> GetAll()
     {
         try
@@ -708,6 +746,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <returns>An enumerable of MasterListDto containing id, name, description, listType, and options count.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "Method catches all Exception instances and returns an empty list; it does not throw Exception to the caller, so <exception cref=\"Exception\"> is misleading." -->
     public async Task<IEnumerable<MasterListDto>> GetAllWithoutOptions()
     {
         try
@@ -736,6 +776,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <returns>The total count of entities.</returns>
     /// <exception cref="Exception">Logs errors and returns 0 on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions internally and returns 0, so it never throws Exception to the caller. The <exception> tag with description 'Logs errors and returns 0 on failure' describes catch-block behavior rather than a thrown exception." -->
     public async Task<int> Count()
     {
         try
@@ -758,6 +800,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="filters">The filter criteria including text, name, description, and optionType.</param>
     /// <returns>A list of matching OptionList items ordered by name.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions internally and returns an empty list, so it never throws Exception to the caller; documenting <exception cref=\"Exception\"> is misleading." -->
     public async Task<List<OptionList>> GetMasterListByIdAndSearchOptions(ObjectId id, FilterOptionListElement? filters)
     {
         try
@@ -973,6 +1017,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="locale">The locale for translation updates.</param>
     /// <returns>The updated OptionList if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all Exception types internally and returns null; it does not throw Exception to the caller, so declaring <exception cref=\"Exception\"> is misleading." -->
     public async Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList newOpt, LocaleEnum locale)
     {
         // 1. Evitar duplicados
@@ -1073,6 +1119,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="newOpt">The OptionList with updated values.</param>
     /// <returns>The updated OptionList if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions internally in a try/catch and returns null; it never propagates an Exception to the caller, so documenting <exception cref='Exception'> is misleading." -->
     public async Task<OptionList?> UpdateMasterListOption(ObjectId id, OptionList newOpt)
     {
         var master = await FindById(id);
@@ -1108,6 +1156,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="id">The ObjectId of the master list.</param>
     /// <param name="deleteOptId">The ObjectId of the option to delete.</param>
     /// <returns>True if the option was deleted; otherwise, false.</returns>
+    /// <!-- aidoc:v1 sig=e663f16 body=75627bc -->
     public async Task<bool> DeleteMasterListOption(ObjectId id, ObjectId deleteOptId)
     {
         // Define el filtro para encontrar el documento por su _id
@@ -1132,6 +1181,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="opt">The UpdateMasterListDetailsDto with updated values.</param>
     /// <returns>The updated UpdateMasterListDetailsDto if successful; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The method catches all exceptions internally and returns null; it never propagates an exception to the caller, so the <exception cref=\"Exception\"> tag is misleading." -->
     public async Task<UpdateMasterListDetailsDto?> UpdateOptionDetailsToMasterList(ObjectId id,
         UpdateMasterListDetailsDto opt)
     {
@@ -1167,6 +1218,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="name">The new name.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Logs errors and returns false on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all Exception types internally and never propagates them to the caller; documenting <exception cref=\"Exception\"> implies callers must handle it, which is misleading." -->
     public async Task<bool> UpdateMasterListName(ObjectId id, string name)
     {
         var filter = Builders<T>.Filter.And(
@@ -1193,6 +1246,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="description">The new description.</param>
     /// <returns>True if the update was successful; otherwise, false.</returns>
     /// <exception cref="Exception">Logs errors and returns false on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions and returns false; it never propagates an exception to the caller, so the <exception cref=\"Exception\"/> tag is incorrect." -->
     public async Task<bool> UpdateMasterListDescription(ObjectId id, string description)
     {
         var filter = Builders<T>.Filter.And(
@@ -1219,6 +1274,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="oldOpt">The OptionList to remove.</param>
     /// <returns>True if the option was removed; otherwise, false.</returns>
     /// <exception cref="Exception">Logs errors and returns false on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "<exception cref=\"Exception\"> documents an exception that the method never throws; all exceptions are caught internally and the method returns false." -->
     public async Task<bool> RemoveMasterListOption(ObjectId id, OptionList oldOpt)
     {
         var filter = Builders<T>.Filter.Eq("_id", id);
@@ -1250,6 +1307,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// Creates necessary indexes for the MasterList collection.
     /// Currently creates text indexes for DiagnosisList on options.name, options.description, and options._id.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation claims the method creates 'text indexes', but the code uses IndexKeys.Ascending(...) to create standard ascending (non-text) indexes." -->
     public override async Task CreateIndexes()
     {
         if (typeof(T) == typeof(DiagnosisList))
@@ -1275,6 +1334,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="textSearch">Optional text to search within options.</param>
     /// <returns>A list of matching OptionList items.</returns>
+    /// <!-- aidoc:v1 sig=484b092 body=48e3496 -->
     public async Task<List<OptionList>> GetMasterListByTextSearch(string? textSearch)
     {
         return await GetOptionsByTextSearch(textSearch);
@@ -1287,6 +1347,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="id">Optional master list ObjectId to filter results.</param>
     /// <returns>A list of matching OptionList items ordered by name.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches all exceptions internally via a broad try/catch and returns an empty list; it never rethrows, so the <exception cref=\"Exception\"> tag documents behavior that does not propagate to the caller." -->
     private async Task<List<OptionList>> GetOptionsByTextSearch(string? textSearch, ObjectId? id = null)
     {
         try
@@ -1364,6 +1426,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="filters">List of filter definitions to apply.</param>
     /// <param name="sort">Sort definition for the query results.</param>
     /// <returns>A fluent queryable for T results.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary describes the method as creating a fluent query 'for paginated results', but the method body performs no pagination (no Skip/Limit); it only builds a find query with filters and sort." -->
     private IFindFluent<T, T> CreateFindFluent(List<FilterDefinition<T>> filters, SortDefinition<T> sort)
     {
         var combinedFilter = filters.Any()
@@ -1379,6 +1443,10 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="localeList">The default locale to exclude from translations.</param>
     /// <param name="opt">The option name to use as default translation.</param>
     /// <returns>A Locale object with translations for all other locales.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "localeList is documented as 'The default locale to exclude' but it is not necessarily the default; the code separately skips LocaleEnum.Default and localeList is just another locale to exclude." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary states the method operates 'based on a default locale' and excludes only 'the specified default', but the code creates identical LocaleItems for every locale except both LocaleEnum.Default and localeList, with no use of any default locale as a basis." -->
     private Locale GetNewItemLocale(LocaleEnum localeList, string opt)
     {
         var newLocale = new Locale();
@@ -1418,6 +1486,7 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// </summary>
     /// <param name="input">The input string to build the pattern from.</param>
     /// <returns>A regex-compatible pattern string.</returns>
+    /// <!-- aidoc:v1 sig=2992c00 body=ae88daf -->
     private static string BuildRegexPattern(string input)
     {
         var regexPattern = new StringBuilder();
@@ -1459,6 +1528,8 @@ public class MasterListRepository<T> : MongoRepository<T>, IMasterListRepository
     /// <param name="locale">The locale for translation.</param>
     /// <returns>A list of matching OptionList items ordered by name.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches Exception internally and does not throw it to the caller; the <exception cref=\"Exception\"> tag is misleading because it implies the exception propagates." -->
     private async Task<List<OptionList>> GetMasterListByIdAndTextSearch(
         ObjectId id, string newOptName, LocaleEnum locale)
     {
diff --git a/adas-core.Infrastructure/Repositories/MedicineRepository.cs b/adas-core.Infrastructure/Repositories/MedicineRepository.cs
index d96fc033..5ddb0146 100644
--- a/adas-core.Infrastructure/Repositories/MedicineRepository.cs
+++ b/adas-core.Infrastructure/Repositories/MedicineRepository.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing <see cref="Medicine"/> entities in MongoDB.
 /// Provides CRUD operations, search, pagination, and aggregation capabilities specific to medicines.
 /// </summary>
+/// <!-- aidoc:v1 sig=16673ad -->
 public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -23,6 +24,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// <param name="apiSettings">The application API settings containing configuration values, including the collection name. Cannot be <see langword="null"/>.</param>
     /// <param name="database">The MongoDB database instance used to access the collection.</param>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="apiSettings"/> is <see langword="null"/>.</exception>
+    /// <!-- aidoc:v1 sig=78d0590 body=d2b18a3 -->
     public MedicineRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -36,6 +38,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// Falls back to the default "medicines" collection name when not configured in the API settings.
     /// </summary>
     /// <returns>The collection name retrieved from the API settings, or "medicines" if not configured.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=24e9d1c -->
     public override string GetCollectionName()
     {
         return _apiSettings.Medicines ?? "medicines";
@@ -49,6 +52,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{Medicine}"/> representing the asynchronous operation.
     /// The task result contains the first <see cref="Medicine"/> matching the criteria, or <see langword="null"/> if no match is found.
     /// </returns>
+    /// <!-- aidoc:v1 sig=b6d43c1 body=db3587a -->
     public async Task<Medicine?> GetMedicine(string code)
     {
         var result = await Collection.FindAsync(x => x.Codes.Contains(code) || x.Notes.Contains(code));
@@ -65,6 +69,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{List{Medicine}}"/> representing the asynchronous operation.
     /// The task result contains a list of matching <see cref="Medicine"/> objects. Returns an empty list if no matches are found.
     /// </returns>
+    /// <!-- aidoc:v1 sig=68faf9f body=85d920f -->
     public async Task<List<Medicine>> GetMedicineByCodeOrNote(List<string> codeNotes)
     {
         var filter = Builders<Medicine>.Filter.AnyIn("Codes", codeNotes.ToArray());
@@ -81,6 +86,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{Medicine}"/> representing the asynchronous operation.
     /// The task result contains the <see cref="Medicine"/> if found; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc:v1 sig=84930f7 body=2ce8f8c -->
     public async Task<Medicine?> GetMedicineByName(string name)
     {
         var filter = Builders<Medicine>.Filter.Eq(p => p.Name, name);
@@ -96,6 +102,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{List{Medicine}}"/> representing the asynchronous operation.
     /// The task result contains a list of all <see cref="Medicine"/> objects. Returns an empty list if the collection is empty.
     /// </returns>
+    /// <!-- aidoc:v1 sig=6bce187 body=bdbdf96 -->
     public async Task<List<Medicine>> GetAll()
     {
         var result = await Collection.FindAsync(_ => true);
@@ -111,6 +118,8 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{Medicine}"/> representing the asynchronous operation.
     /// The task result contains the <see cref="Medicine"/> if found; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The cref uses Task{Medicine} but the method's actual return type is Task<Medicine?>; however, the explanatory sentence correctly describes the nullable behavior." -->
     public async Task<Medicine?> GetMedicineById(ObjectId medicineId)
     {
         var filter = Builders<Medicine>.Filter.Eq(p => p.Id, medicineId);
@@ -127,6 +136,8 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{Medicine}"/> representing the asynchronous operation.
     /// The task result contains the newly inserted <see cref="Medicine"/> retrieved by its name, or <see langword="null"/> if the lookup fails.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The return type is Task<Medicine?> (nullable), but the cref uses Task{Medicine} which represents the non-nullable Task<Medicine>. The prose does mention null, so meaning is preserved." -->
     public async Task<Medicine?> PostMedicine(Medicine medicine)
     {
         await Collection.InsertOneAsync(medicine);
@@ -143,6 +154,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// A <see cref="Task{Medicine}"/> representing the asynchronous operation.
     /// The task result contains the same <see cref="Medicine"/> instance that was passed in, after the update operation has been issued.
     /// </returns>
+    /// <!-- aidoc:v1 sig=baa8582 body=be3411f -->
     public async Task<Medicine?> UpdateMedicine(Medicine medicine)
     {
         await UpdateOneAsync(medicine.Id, medicine);
@@ -155,6 +167,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// </summary>
     /// <param name="medicineId">The <see cref="ObjectId"/> of the medicine to delete.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=ea3ac00 body=5d15af8 -->
     public async Task DeleteMedicineById(ObjectId medicineId)
     {
         var filter = Builders<Medicine>.Filter.Eq(po => po.Id, medicineId);
@@ -172,6 +185,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// An <see cref="IFindFluent{Medicine, Medicine}"/> instance that can be used to further refine and execute the query.
     /// When no filters are provided, all medicines are returned sorted by name.
     /// </returns>
+    /// <!-- aidoc:v1 sig=067ab87 body=1dc1cf3 -->
     public IFindFluent<Medicine, Medicine> GetPaginatedMedicines(PaginationFilter filter)
     {
         // Crear variable con la clase que construye los filtros que necesitamos
@@ -220,6 +234,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// An <see cref="IAggregateFluent{BsonDocument}"/> representing the aggregation pipeline that, when executed,
     /// yields documents containing the distinct values of the specified field.
     /// </returns>
+    /// <!-- aidoc:v1 sig=3fad0c3 body=ba53337 -->
     public IAggregateFluent<BsonDocument> GetDistinctFieldDataQuery(string field)
     {
         return Collection.Aggregate()
@@ -238,6 +253,7 @@ public class MedicineRepository : MongoRepository<Medicine>, IMedicineRepository
     /// containing a list of distinct group names as strings.
     /// </returns>
     /// <exception cref="NotImplementedException">This method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=4759c2c body=bfa6f2f -->
     public Task<List<string>> GetAllGroups()
     {
         throw new NotImplementedException();
diff --git a/adas-core.Infrastructure/Repositories/MongoRepository.cs b/adas-core.Infrastructure/Repositories/MongoRepository.cs
index f50e2f88..b95825fa 100644
--- a/adas-core.Infrastructure/Repositories/MongoRepository.cs
+++ b/adas-core.Infrastructure/Repositories/MongoRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// to customize schema setup, seeding, and insertion behavior.
 /// </summary>
 /// <typeparam name="T">The domain model type persisted in the MongoDB collection.</typeparam>
+/// <!-- aidoc:v1 sig=69998d5 -->
 public abstract class MongoRepository<T> : IMongoRepository<T>
 {
     /// <summary>
@@ -33,6 +34,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// Initializes a new instance of the <see cref="MongoRepository{T}"/> class using the provided database.
     /// </summary>
     /// <param name="database">The MongoDB database instance used to access collections. Must not be <see langword="null"/>.</param>
+    /// <!-- aidoc:v1 sig=d790eeb body=2671b37 -->
     protected MongoRepository(IMongoDatabase database)
     {
         Db = database;
@@ -42,6 +44,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// When implemented in a derived class, returns the name of the MongoDB collection used to store documents of type <typeparamref name="T"/>.
     /// </summary>
     /// <returns>The MongoDB collection name as a string.</returns>
+    /// <!-- aidoc:v1 sig=e2b0ea0 -->
     public abstract string GetCollectionName();
 
     /// <summary>
@@ -73,6 +76,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// </summary>
     /// <param name="obj">The document of type <typeparamref name="T"/> to insert.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous insert operation.</returns>
+    /// <!-- aidoc:v1 sig=7489d1f body=3bc7781 -->
     public virtual async Task InsertOneAsync(T obj)
     {
         try
@@ -93,6 +97,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// <param name="id">The <see cref="ObjectId"/> value of the document's <c>_id</c> field.</param>
     /// <param name="obj">The replacement document of type <typeparamref name="T"/>.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous replace/upsert operation.</returns>
+    /// <!-- aidoc:v1 sig=e9b79ac body=34c3c0c -->
     public async Task UpdateOneAsync(ObjectId id, T obj)
     {
         try
@@ -117,6 +122,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// A <see cref="Task{T}"/> representing the asynchronous operation.
     /// The task result contains the deleted document, or <see langword="null"/> / default if no document matched or an error occurred.
     /// </returns>
+    /// <!-- aidoc:v1 sig=de6ed30 body=36e5c1c -->
     public async Task<T?> DeleteAsync(ObjectId id)
     {
         try
@@ -136,6 +142,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// derived classes should override this method to define their own indexes.
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous index creation operation.</returns>
+    /// <!-- aidoc:v1 sig=f76a2b3 body=6805ef5 -->
     public virtual Task CreateIndexes()
     {
         return Task.CompletedTask;
@@ -146,6 +153,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// derived classes should override this method to provide custom seeding logic.
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous seeding operation.</returns>
+    /// <!-- aidoc:v1 sig=e4d5f7d body=6805ef5 -->
     public virtual Task InsertInitialLoad()
     {
         return Task.CompletedTask;
@@ -157,6 +165,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// </summary>
     /// <param name="obj">The list of documents of type <typeparamref name="T"/> to insert.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous bulk insert operation.</returns>
+    /// <!-- aidoc:v1 sig=f63f7ad body=4633ba9 -->
     public virtual async Task InsertManyAsync(List<T> obj)
     {
         try
@@ -178,6 +187,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to replace.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=2f5f8d3 body=af391c3 -->
     protected async Task UpdateManyObjectIdAsync(string nameId, ObjectId id, ObjectId oldId)
     {
         try
@@ -202,6 +212,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// A <see cref="Task{T}"/> representing the asynchronous operation.
     /// The task result contains the deleted document, or <see langword="null"/> / default if no document matched or an error occurred.
     /// </returns>
+    /// <!-- aidoc:v1 sig=ec974d1 body=36e5c1c -->
     protected async Task<T?> DeleteAsync(string id)
     {
         try
@@ -225,6 +236,7 @@ public abstract class MongoRepository<T> : IMongoRepository<T>
     /// <see langword="true"/> if a collection with the given name exists; otherwise, <see langword="false"/>.
     /// Returns <see langword="false"/> when an exception is thrown while querying the database.
     /// </returns>
+    /// <!-- aidoc:v1 sig=bc8012c body=ec4a9e5 -->
     protected bool CollectionExists(string collectionName)
     {
         try
diff --git a/adas-core.Infrastructure/Repositories/NoticeRepository.cs b/adas-core.Infrastructure/Repositories/NoticeRepository.cs
index cd9cf4fc..f90ff450 100644
--- a/adas-core.Infrastructure/Repositories/NoticeRepository.cs
+++ b/adas-core.Infrastructure/Repositories/NoticeRepository.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing Notice entities in MongoDB.
 /// Provides CRUD operations for notices/notifications that can be displayed on screens.
 /// </summary>
+/// <!-- aidoc:v1 sig=a7dc3b2 -->
 public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -23,6 +24,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=c18eb8b body=99d85d9 -->
     public NoticeRepository(IOptions<ApiSettings>? apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings != null)
@@ -35,6 +37,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// Gets the name of the collection for notices.
     /// </summary>
     /// <returns>The collection name from API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=dfe078b -->
     public override string GetCollectionName()
     {
         return _apiSettings.Notices;
@@ -46,6 +49,8 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// </summary>
     /// <param name="notice">The Notice entity to insert.</param>
     /// <exception cref="Exception">Logs warning and silently fails on insertion error.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches Exception and does not re-throw it, so documenting <exception cref=\"Exception\"> is misleading—callers will not see this exception propagate." -->
     public override async Task InsertOneAsync(Notice notice)
     {
         try
@@ -64,6 +69,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// </summary>
     /// <param name="id">The ObjectId of the notice to delete.</param>
     /// <exception cref="Exception">Throws and re-throws exceptions after logging.</exception>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=c1d807b -->
     public async Task Delete(ObjectId id)
     {
         try
@@ -83,6 +89,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// </summary>
     /// <param name="notice">The Notice entity with updated values.</param>
     /// <exception cref="Exception">Throws and re-throws exceptions after logging.</exception>
+    /// <!-- aidoc:v1 sig=64f77d8 body=b33b6f7 -->
     public async Task Update(Notice notice)
     {
         try
@@ -101,6 +108,8 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// </summary>
     /// <returns>An enumerable of all Notice entities.</returns>
     /// <exception cref="Exception">Logs errors and returns empty list on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method catches and handles all exceptions internally (returns empty list), so no exception is propagated to the caller; documenting <exception cref=\"Exception\"> is misleading." -->
     public async Task<IEnumerable<Notice>> FindAll()
     {
         try
@@ -121,6 +130,8 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// <param name="id">The ObjectId of the notice to retrieve.</param>
     /// <returns>The Notice if found; otherwise, null.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The method's try-catch handles all exceptions internally and returns null, so no exception is ever propagated to the caller; documenting <exception cref=\"Exception\"> is misleading." -->
     public async Task<Notice?> FindById(ObjectId id)
     {
         try
@@ -143,6 +154,8 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// <param name="date">The date to filter notices by.</param>
     /// <returns>An enumerable of Notice entities matching the date, or null on error.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "The <exception cref=\"Exception\"> tag documents an exception that is never thrown to callers; the catch block handles all exceptions internally and returns null instead." -->
     public async Task<IEnumerable<Notice>?> FindByDate(DateTime date)
     {
         try
@@ -165,6 +178,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// <param name="type">The notice type to filter by.</param>
     /// <returns>An enumerable of Notice entities matching the type, or null on error.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc:v1 sig=c8e3fb2 body=d0629e2 -->
     public async Task<IEnumerable<Notice>?> FindByType(string type)
     {
         try
@@ -187,6 +201,7 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// <param name="displayId">The ObjectId of the display to filter by.</param>
     /// <returns>An enumerable of Notice entities for the display, or null on error.</returns>
     /// <exception cref="Exception">Logs errors and returns null on failure.</exception>
+    /// <!-- aidoc:v1 sig=a6848c6 body=c64a895 -->
     public async Task<IEnumerable<Notice>?> FindByDisplayId(ObjectId displayId)
     {
         try
@@ -207,6 +222,8 @@ public class NoticeRepository : MongoRepository<Notice>, INoticeRepository
     /// Creates the necessary indexes for the Notice collection.
     /// Creates compound indexes on (noticeType, noticeDate) and (noticeDate) for improved query performance.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Documentation states 'compound indexes' (plural), but only (noticeType, noticeDate) is compound; (noticeDate) is a single-field index." -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/ObservationArchiveRepository.cs b/adas-core.Infrastructure/Repositories/ObservationArchiveRepository.cs
index 27bfba39..7a4516fe 100644
--- a/adas-core.Infrastructure/Repositories/ObservationArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ObservationArchiveRepository.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing PatientObservation archive entities in MongoDB.
 /// Provides operations for storing and retrieving historical patient observations.
 /// </summary>
+/// <!-- aidoc:v1 sig=208c7de -->
 public class ObservationArchiveRepository : MongoRepository<PatientObservation>, IObservationArchiveRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -23,6 +24,7 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=fa9b83d body=d2b18a3 -->
     public ObservationArchiveRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -38,6 +40,8 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// <param name="lastDate">The cutoff date to filter observations (inclusive).</param>
     /// <param name="filterObservations">Optional list of observation names to filter by. If null, retrieves all distinct observations.</param>
     /// <returns>A list of PatientObservation entities sorted by time descending.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The returned list is sorted by time descending only within each observation name group (each foreach iteration), not globally across all observation types, since results are appended via AddRange without re-sorting." -->
     public async Task<List<PatientObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num,
         DateTime lastDate, List<string>? filterObservations = null)
     {
@@ -64,6 +68,7 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// Gets the name of the collection for archived patient observations.
     /// </summary>
     /// <returns>The collection name from API settings, or default "archive_patients_observations".</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=81daff1 -->
     public override string GetCollectionName()
     {
         return _apiSettings.ArchivePatientsObservations ?? "archive_patients_observations";
@@ -76,6 +81,7 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// <param name="patientObservation">The PatientObservation entity to insert.</param>
     /// <exception cref="MongoWriteException">Throws when duplicate key error persists after max retries.</exception>
     /// <exception cref="Exception">Throws when insertion fails for reasons other than duplicate key.</exception>
+    /// <!-- aidoc:v1 sig=ae8c780 body=b4e7347 -->
     public new async Task InsertOneAsync(PatientObservation patientObservation)
     {
         const int maxRetries = 2; // Número máximo de reintentos
@@ -117,6 +123,8 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// </summary>
     /// <param name="date">The cutoff date. Observations older than this date will be deleted.</param>
     /// <returns>The number of deleted documents.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Method returns Task, not Task<int>; the number of deleted documents is not exposed to callers." -->
     public async Task DeleteBeforeDate(DateTime date)
     {
         var filter = Builders<PatientObservation>.Filter.Lt(po => po.Time, date);
@@ -128,6 +136,7 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// </summary>
     /// <param name="observations">An enumerable of PatientObservation entities to insert.</param>
     /// <returns>The count of successfully inserted documents.</returns>
+    /// <!-- aidoc:v1 sig=f522e46 body=daebb76 -->
     public async Task<long> InsertBatch(IEnumerable<PatientObservation> observations)
     {
         var writes = new List<WriteModel<PatientObservation>>();
@@ -143,6 +152,8 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// </summary>
     /// <param name="patientId">The ObjectId of the patient.</param>
     /// <returns>A list of all PatientObservation entities for the patient.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states observations are 'archived', but the code only filters by PatientId with no archive-status filter, implying retrieval behavior the code does not perform." -->
     public async Task<List<PatientObservation>> FindAllFromPatient(ObjectId patientId)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(p => p.PatientId, patientId);
@@ -158,6 +169,7 @@ public class ObservationArchiveRepository : MongoRepository<PatientObservation>,
     /// <param name="patientId">The ObjectId of the patient.</param>
     /// <param name="filterObservations">Optional pre-filtered list of observation names. If null or empty, computes distinct values.</param>
     /// <returns>A list of distinct observation name strings.</returns>
+    /// <!-- aidoc:v1 sig=b7f7b8f body=198b120 -->
     private async Task<List<string>> AggregatePatientObservations(ObjectId patientId,
         List<string>? filterObservations = null)
     {
diff --git a/adas-core.Infrastructure/Repositories/ObservationRepository.cs b/adas-core.Infrastructure/Repositories/ObservationRepository.cs
index c5990d1f..fef18ef2 100644
--- a/adas-core.Infrastructure/Repositories/ObservationRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ObservationRepository.cs
@@ -21,6 +21,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing <see cref="PatientObservation"/> entities in MongoDB.
 /// Provides specialized query, aggregation, retention, and expiration operations for patient clinical observations.
 /// </summary>
+/// <!-- aidoc:v1 sig=70efcb8 -->
 public class ObservationRepository : MongoRepository<PatientObservation>, IObservationRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -34,6 +35,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="database">The MongoDB database instance used to access the collection.</param>
     /// <param name="logger">The logger used to record diagnostic and error information.</param>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="apiSettings"/> is <see langword="null"/>.</exception>
+    /// <!-- aidoc:v1 sig=5a66d34 body=2164183 -->
     public ObservationRepository(
         IOptions<ApiSettings>? apiSettings,
         IMongoDatabase database,
@@ -56,6 +58,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// Falls back to the default "patients_observations" collection name when not configured in the API settings.
     /// </summary>
     /// <returns>The collection name retrieved from the API settings, or "patients_observations" if not configured.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=23fb24b -->
     public override string GetCollectionName()
     {
         return _apiSettings.PatientsObservations ?? "patients_observations";
@@ -70,6 +73,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="code">The code identifying the observation type within the coding system.</param>
     /// <param name="num">The maximum number of recent observations to return. Defaults to 2.</param>
     /// <returns>An <see cref="IEnumerable{PatientObservation}"/> containing the matching observations ordered from newest to oldest.</returns>
+    /// <!-- aidoc:v1 sig=404377e body=0480966 -->
     public async Task<IEnumerable<PatientObservation>> FindLastObservations(ObjectId patientId, string codingSystem,
         string code, int num = 2)
     {
@@ -96,6 +100,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="codingSystem">The coding system to filter observations by.</param>
     /// <param name="num">The maximum number of recent observations to return. Defaults to 10.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the matching observations ordered from newest to oldest.</returns>
+    /// <!-- aidoc:v1 sig=09172c7 body=f40336d -->
     public async Task<List<PatientObservation>> FindLastObservationsByCodingSystem(ObjectId patientId,
         string codingSystem, int num = 10)
     {
@@ -121,6 +126,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="num">The maximum number of observations to return per observation name.</param>
     /// <param name="filterObservations">Optional list of observation names to restrict the query to. When <see langword="null"/>, all distinct names are discovered.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the aggregated latest observations across all matching names.</returns>
+    /// <!-- aidoc:v1 sig=0f4e126 body=0b43f32 -->
     public async Task<List<PatientObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num,
         List<string>? filterObservations = null)
     {
@@ -157,6 +163,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="lastDate">The inclusive upper bound (UTC) for the observation <c>time</c> field.</param>
     /// <param name="filterObservations">Optional list of observation names to restrict the query to. When <see langword="null"/>, all distinct names are discovered.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the matching observations.</returns>
+    /// <!-- aidoc:v1 sig=605f95b body=2f3441d -->
     public async Task<List<PatientObservation>> AggregatedPatientLastObservationsByLastDate(ObjectId patientId, int num,
         DateTime lastDate, List<string>? filterObservations = null)
     {
@@ -195,6 +202,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="List{PatientObservation}"/> containing the matching observations.
     /// Returns an empty list when an exception occurs while querying the database.
     /// </returns>
+    /// <!-- aidoc:v1 sig=442f63d body=77c0486 -->
     public async Task<List<PatientObservation>> AggregatedPatientLastObservationsByField(ObjectId patientId,
         List<Field>? filterObservations)
     {
@@ -266,6 +274,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="List{BsonDocument}"/> with one document per time bucket.
     /// Returns an empty list when an exception occurs while executing the pipeline.
     /// </returns>
+    /// <!-- aidoc:v1 sig=43cc5aa body=792314e -->
     public async Task<List<BsonDocument>> AggregatedPatientGroupedObservations(ObjectId patientId,
         GroupedField groupedField)
     {
@@ -550,6 +559,8 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>A <see cref="Task"/> representing the asynchronous insert operation.</returns>
     /// <exception cref="MongoWriteException">Rethrown after the maximum number of retries has been reached when a duplicate-key error keeps occurring.</exception>
     /// <exception cref="Exception">Rethrown when an unexpected error occurs during the insert operation.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method retries 'with a new ObjectId' on duplicate-key errors, but the catch block never assigns or generates a new ObjectId — the same patientObservation is passed to InsertOneAsync unchanged on each retry." -->
     public new async Task InsertOneAsync(PatientObservation patientObservation)
     {
         const int maxRetries = 2; // Número máximo de reintentos
@@ -586,6 +597,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the patient whose observations should be removed.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=09e4e41 body=0e8105c -->
     public async Task DeleteByPatientId(ObjectId id)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(po => po.PatientId, id);
@@ -599,6 +611,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// An <see cref="IAsyncCursor{PatientObservation}"/> that can be enumerated to retrieve the patient's observations.
     /// </returns>
+    /// <!-- aidoc:v1 sig=3727a3e body=9f79ea7 -->
     public async Task<IAsyncCursor<PatientObservation>> FindByPatientIdAsync(ObjectId patientId)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -615,6 +628,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// An <see cref="IAsyncCursor{PatientObservation}"/> containing the matching observations,
     /// retrieved with a server-side batch size of 100.
     /// </returns>
+    /// <!-- aidoc:v1 sig=6e7afc6 body=3957510 -->
     public async Task<IAsyncCursor<PatientObservation>> FindByPatientIdAndCodingSystemAsync(ObjectId patientId,
         string codingSystem, string name)
     {
@@ -636,6 +650,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the observation to delete.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous delete operation.</returns>
+    /// <!-- aidoc:v1 sig=78c6c5d body=8d17292 -->
     public new async Task DeleteAsync(ObjectId id)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(obs => obs.Id, id);
@@ -650,6 +665,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="name">The observation name to filter by.</param>
     /// <param name="retentionPolicyValue">The retention window expressed in days. Observations older than <c>UtcNow - retentionPolicyValue</c> days are removed.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the documents that were deleted.</returns>
+    /// <!-- aidoc:v1 sig=db9f78a body=38e1006 -->
     public async Task<List<PatientObservation>> DeleteOlderDaysAsync(string name, int retentionPolicyValue)
     {
         var dateLimit = DateTime.UtcNow.AddDays(-1 * retentionPolicyValue);
@@ -672,6 +688,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="name">The observation name to filter by.</param>
     /// <param name="retentionPolicyValue">The retention window expressed in seconds. Observations older than <c>UtcNow - retentionPolicyValue</c> seconds are removed.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the documents that were deleted.</returns>
+    /// <!-- aidoc:v1 sig=9b16832 body=8605782 -->
     public async Task<List<PatientObservation>> DeleteOlderSecondsAsync(string name, int retentionPolicyValue)
     {
         var dateLimit = DateTime.UtcNow.AddSeconds(-1 * retentionPolicyValue);
@@ -694,6 +711,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="name">The observation name to apply the retention policy to.</param>
     /// <param name="retentionPolicyValue">The maximum number of observations to retain. The remainder are deleted.</param>
     /// <returns>A <see cref="List{PatientObservation}"/> containing the documents that were deleted. Returns an empty list when nothing had to be deleted.</returns>
+    /// <!-- aidoc:v1 sig=c385e27 body=8410fad -->
     public async Task<List<PatientObservation>> DeleteOlderNumberAsync(string name, int retentionPolicyValue)
     {
         var builder = Builders<PatientObservation>.Filter;
@@ -724,6 +742,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="patientid">The unique identifier of the patient.</param>
     /// <param name="systemId">The external system identifier to look up.</param>
     /// <returns><see langword="true"/> if a matching observation exists; otherwise, <see langword="false"/>.</returns>
+    /// <!-- aidoc:v1 sig=039b8ae body=13a2d36 -->
     public async Task<bool> ExistBySystemId(ObjectId patientid, string systemId)
     {
         return await Collection.Find(Builders<PatientObservation>.Filter.And(
@@ -745,6 +764,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="Task{PatientObservation}"/> representing the asynchronous operation.
     /// The task result contains the most recent matching observation, or <see langword="null"/> if no observation matches.
     /// </returns>
+    /// <!-- aidoc:v1 sig=6152e35 body=332a506 -->
     public async Task<PatientObservation?> FindLastObservationBeforeDate(ObjectId patientId, string? name,
         DateTime date)
     {
@@ -772,6 +792,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="Task{List{PatientObservation}}"/> representing the asynchronous operation.
     /// The task result contains a list of matching observations, which may be empty.
     /// </returns>
+    /// <!-- aidoc:v1 sig=87691b0 body=2ac50f6 -->
     public async Task<List<PatientObservation>?> FindAnyWithSameDate(ObjectId patientId, string? name, DateTime date)
     {
         var builder = Builders<PatientObservation>.Filter;
@@ -792,6 +813,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// A <see cref="List{PatientObservation}"/> containing the matching observations, which may be empty.
     /// </returns>
+    /// <!-- aidoc:v1 sig=c25141b body=58a25f4 -->
     public async Task<List<PatientObservation>> FindAnyBeforeDate(ObjectId patientId, DateTime date)
     {
         var filterBuilder = Builders<PatientObservation>.Filter;
@@ -817,6 +839,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// A <see cref="List{PatientObservation}"/> containing the most recent observation for each distinct value.
     /// </returns>
+    /// <!-- aidoc:v1 sig=fbdab74 body=42ee291 -->
     public async Task<List<PatientObservation>> FindLatestUniqueValuesByName(ObjectId patientId, string name,
         int? expires)
     {
@@ -867,6 +890,8 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// A <see cref="List{PatientObservation}"/> containing one observation per unique (Location, Type) combination.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The actual return type is List<PatientObservation?> (nullable elements due to LastOrDefault()), but the doc references List{PatientObservation} without indicating nullability." -->
     public async Task<List<PatientObservation?>> AggregatedPatientActiveIntravenousLinesObservations(ObjectId patientId)
     {
         var results = new List<PatientObservation>();
@@ -899,6 +924,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// A <see cref="Dictionary{ObjectId, DateTime}"/> mapping each patient's <see cref="ObjectId"/> to the UTC timestamp of their latest observation.
     /// </returns>
+    /// <!-- aidoc:v1 sig=115ac00 body=29b2957 -->
     public async Task<Dictionary<ObjectId, DateTime>> FindAllLastPatientObservationTime()
     {
         var group = new BsonDocument
@@ -950,6 +976,8 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="Task{PatientObservation}"/> representing the asynchronous operation.
     /// The task result contains the <see cref="PatientObservation"/> if found; otherwise, <see langword="null"/>.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The cref references Task{PatientObservation} but the actual return type is Task<PatientObservation?}; the textual description correctly notes null behavior but the cref itself is missing the nullable annotation." -->
     public async Task<PatientObservation?> FindById(ObjectId id)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(o => o.Id, id);
@@ -967,6 +995,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="Task{List{PatientObservation}}"/> representing the asynchronous operation.
     /// The task result contains a list of observations, which may be empty.
     /// </returns>
+    /// <!-- aidoc:v1 sig=4837300 body=9950647 -->
     public async Task<List<PatientObservation>?> FindByPatientId(ObjectId id)
     {
         var filter = Builders<PatientObservation>.Filter.Eq(o => o.PatientId, id);
@@ -982,6 +1011,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// </summary>
     /// <param name="observation">The <see cref="PatientObservation"/> whose <see cref="ObjectId"/> identifies the document to update.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=738ce4b body=caca1ff -->
     public async Task Update(PatientObservation observation)
     {
         await UpdateOneAsync(observation.Id, observation);
@@ -995,6 +1025,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="id">The new <see cref="ObjectId"/> value to assign.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to replace.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=72ce1ca body=b9b81e9 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
     {
         await UpdateManyObjectIdAsync(nameId, id, oldId);
@@ -1005,6 +1036,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// </summary>
     /// <param name="expiredObservations">The list of <see cref="PatientObservation"/> instances to mark as expired. The set of identifiers is used to build the update filter.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=c0d4f8c body=2cbb9ec -->
     public async Task UpdateExpiredObservations(List<PatientObservation> expiredObservations)
     {
         var filter = Builders<PatientObservation>.Filter
@@ -1020,6 +1052,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <param name="patientObservations">The observations whose identifiers form the target set of the update.</param>
     /// <param name="update">The <see cref="UpdateDefinition{PatientObservation}"/> describing the changes to apply to each matching document.</param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=9ef4ae8 body=5f5bfaf -->
     public async Task UpdateMany(IEnumerable<PatientObservation> patientObservations,
         UpdateDefinition<PatientObservation> update)
     {
@@ -1034,6 +1067,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// An <see cref="IEnumerable{PatientObservation}"/> containing all observations.
     /// </returns>
+    /// <!-- aidoc:v1 sig=8ac3146 body=bff76bc -->
     public async Task<IEnumerable<PatientObservation>> FindAll()
     {
         var result = await Collection.FindAsync(_ => true);
@@ -1051,6 +1085,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// (in minutes). Observations whose <c>time</c> is older than <c>DateTime.Now - expires</c> minutes are marked as expired.
     /// </param>
     /// <returns>A <see cref="Task"/> representing the asynchronous update operation.</returns>
+    /// <!-- aidoc:v1 sig=3c6bca9 body=e2d9f44 -->
     public async Task ExpireExpiredObservations(
         List<ConfigObservation> configObservationsToExpire)
     {
@@ -1095,6 +1130,10 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// An <see cref="IEnumerable{PatientObservation}"/> containing the matching non-expired observations.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states 'Observations with a null name are excluded from the result' unconditionally, but the null-name filter (Not(Eq(o => o.Name, null))) is only added inside the `if (filterObservations != null)` branch. When filterObservations is null, null-named observations are NOT excluded." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Param description claims 'When null, all non-null named observations are considered', but when filterObservations is null the code adds no name-related filters at all - null-named observations are also returned (subject only to the not-expired filter)." -->
     public async Task<IEnumerable<PatientObservation>> FindNotExpired(List<string?>? filterObservations)
     {
         var filterBuilder = Builders<PatientObservation>.Filter;
@@ -1129,6 +1168,10 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// Thrown when <paramref name="name"/> is null, empty, or whitespace,
     /// or when its length exceeds 100 characters.
     /// </exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "<paramref name=\"fromDate\"/> is documented as 'inclusive lower bound', but the code uses Builders<>.Filter.Gt (strict greater-than), making it an exclusive lower bound." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_param_role
+    ///      "<paramref name=\"name\"/> is documented as 'The regex pattern to match', but Regex.Escape(name) is applied, so it is matched as an escaped literal substring, not as a raw regex pattern." -->
     public async Task<IEnumerable<PatientObservation>> FindByName(string name, DateTime? fromDate = null)
     {
         if (string.IsNullOrWhiteSpace(name))
@@ -1167,6 +1210,8 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// An <see cref="IFindFluent{PatientObservation, PatientObservation}"/> instance that can be used to further refine and execute the query.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary describes the query as 'paginated', but the code applies only sort and filter; no Skip/Limit (or other pagination) is performed on the IFindFluent." -->
     public IFindFluent<PatientObservation, PatientObservation> GetPaginatedObservations(PaginationFilter filter)
     {
         // Crear variable con la clase que construye los filtros 
@@ -1214,6 +1259,10 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// <returns>
     /// An <see cref="IEnumerable{PatientObservation}"/> containing the matching observations ordered from newest to oldest.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states results are 'optionally bounded to a recent time window', but the code never applies the computed date filter to the query: `filterBuilder.And(dateFilter)` is invoked inside the `if (endAfter.HasValue)` block but its return value is discarded, so `endAfter` has no effect on the returned observations." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The <param name=\"endAfter\"> description claims only observations with time >= UtcNow - endAfter are returned, yet the constructed `dateFilter` is never combined into the final `filters` passed to `FindAsync`." -->
     public async Task<IEnumerable<PatientObservation>> FindLastNotExpiredObservatonsByPatient(ObjectId patientId,
         string name, int? endAfter = null, int? num = null)
     {
@@ -1254,6 +1303,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous index creation operation.</returns>
     /// <exception cref="Exception">Rethrown when an error occurs while creating the indexes.</exception>
+    /// <!-- aidoc:v1 sig=4955da2 body=2d25714 -->
     public override async Task CreateIndexes()
     {
         try
@@ -1296,6 +1346,7 @@ public class ObservationRepository : MongoRepository<PatientObservation>, IObser
     /// A <see cref="List{String}"/> containing the observation names to aggregate over.
     /// Returns an empty list if no observations exist for the patient.
     /// </returns>
+    /// <!-- aidoc:v1 sig=b7f7b8f body=54374c4 -->
     private async Task<List<string>> AggregatePatientObservations(ObjectId patientId,
         List<string>? filterObservations = null)
     {
diff --git a/adas-core.Infrastructure/Repositories/POCMappingRepository.cs b/adas-core.Infrastructure/Repositories/POCMappingRepository.cs
index b884bfb4..8ca0f0ee 100644
--- a/adas-core.Infrastructure/Repositories/POCMappingRepository.cs
+++ b/adas-core.Infrastructure/Repositories/POCMappingRepository.cs
@@ -9,6 +9,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Provides a MongoDB-backed repository implementation for PoCMapping entities.
 /// </summary>
+/// <!-- aidoc:v1 sig=34c4715 -->
 public class PoCMappingRepository : MongoRepository<PoCMapping>, IPoCMappingRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -30,6 +31,7 @@ public class PoCMappingRepository : MongoRepository<PoCMapping>, IPoCMappingRepo
     /// Retrieves the name of the mappings collection from the API settings configuration.
     /// </summary>
     /// <returns>The mappings collection name as configured in <c>_apiSettings</c>.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=140c15b -->
     public override string GetCollectionName()
     {
         return _apiSettings.Mappings;
@@ -40,6 +42,7 @@ public class PoCMappingRepository : MongoRepository<PoCMapping>, IPoCMappingRepo
     /// </summary>
     /// <param name="key">The unique identifier (Id) of the <see cref="PoCMapping"/> to look up.</param>
     /// <returns>A Task TResult containing the matching PoCMapping, or <c>null</c> if no document with the specified key exists in the collection.</returns>
+    /// <!-- aidoc:v1 sig=05f7477 body=e2c98c4 -->
     public async Task<PoCMapping?> FindByKey(string key)
     {
         var filterBuilder = Builders<PoCMapping>.Filter;
diff --git a/adas-core.Infrastructure/Repositories/PatientArchiveRepository.cs b/adas-core.Infrastructure/Repositories/PatientArchiveRepository.cs
index f75b8b37..e250b2bd 100644
--- a/adas-core.Infrastructure/Repositories/PatientArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PatientArchiveRepository.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Repository implementation for managing Patient archive entities in MongoDB.
 /// Provides CRUD operations for historical/archived patient data.
 /// </summary>
+/// <!-- aidoc:v1 sig=9d2c240 -->
 public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiveRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -24,6 +25,7 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// <param name="apiSettings">API settings containing collection names configuration.</param>
     /// <param name="database">The MongoDB database instance.</param>
     /// <exception cref="ArgumentNullException">Thrown when apiSettings is null.</exception>
+    /// <!-- aidoc:v1 sig=f8a321d body=d2b18a3 -->
     public PatientArchiveRepository(IOptions<ApiSettings> apiSettings, IMongoDatabase database) : base(database)
     {
         if (apiSettings == null) throw new ArgumentNullException(nameof(apiSettings));
@@ -34,6 +36,7 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// Gets the name of the collection for archived patients.
     /// </summary>
     /// <returns>The collection name from API settings, or default "archive_patient".</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=76e5629 -->
     public override string GetCollectionName()
     {
         return _apiSettings.ArchivePatient ?? "archive_patient";
@@ -44,6 +47,7 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// </summary>
     /// <param name="patientNumber">The patient number to search for.</param>
     /// <returns>The Patient if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=09c89ab body=8d2454d -->
     public async Task<Patient?> FindByPatientNumber(string patientNumber)
     {
         if (string.IsNullOrWhiteSpace(patientNumber)) return null;
@@ -60,6 +64,7 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// Retrieves all archived patients from the collection.
     /// </summary>
     /// <returns>A list of all Patient entities in the archive.</returns>
+    /// <!-- aidoc:v1 sig=e8bb639 body=57f77c8 -->
     public async Task<List<Patient>> FindAll()
     {
         var filterBuilder = Builders<Patient>.Filter;
@@ -77,6 +82,8 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// <param name="patientNumber">The patient number to search for.</param>
     /// <param name="unitId">The unit ID (currently not used in query, kept for interface compatibility).</param>
     /// <returns>The unique Patient if exactly one match is found; otherwise, null if multiple or none.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary claims the method searches for an 'archived patient', but the code applies no archive-status filter; it only filters by patientNumber." -->
     public async Task<Patient?> SearchByPatientNumberAndDistinctUnit(string patientNumber, ObjectId unitId)
     {
         if (string.IsNullOrWhiteSpace(patientNumber)) return null;
@@ -96,6 +103,8 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// </summary>
     /// <param name="obj">The Patient entity to insert or merge.</param>
     /// <exception cref="Exception">Logs warning and silently fails on error.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_exception
+    ///      "The method catches Exception internally and swallows it (logs a warning); it never throws Exception to the caller, so documenting it via <exception cref=\"Exception\"> is misleading." -->
     public override async Task InsertOneAsync(Patient obj)
     {
         try
@@ -154,6 +163,7 @@ public class PatientArchiveRepository : MongoRepository<Patient>, IPatientArchiv
     /// Creates the necessary indexes for the PatientArchive collection.
     /// Creates an index on patientNumber for improved query performance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=549d3bb -->
     public override async Task CreateIndexes()
     {
         var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/PatientCarePlanRepository.cs b/adas-core.Infrastructure/Repositories/PatientCarePlanRepository.cs
index 689e9943..265e1e84 100644
--- a/adas-core.Infrastructure/Repositories/PatientCarePlanRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PatientCarePlanRepository.cs
@@ -12,6 +12,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// providing concrete persistence operations defined by the <see cref="IPatientCarePlanRepository"/> contract.
 /// </summary>
 /// <typeparam name="PatientCarePlan">The type of the patient care plan entity managed by this repository.</typeparam>
+/// <!-- aidoc-review:v1 severity=medium kind=extra_param
+///      "<typeparam name=\"PatientCarePlan\"> is invalid because PatientCarePlanRepository is not a generic class; PatientCarePlan is a concrete type argument to MongoRepository<T>, not a type parameter." -->
 public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPatientCarePlanRepository
 {
     #region Properties
@@ -28,6 +30,7 @@ public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPati
     /// <param name="patientid">The string identifier of the patient whose object identifiers will be updated.</param>
     /// <param name="patientId">The new <see cref="ObjectId"/> to assign to the patient's records.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> to be replaced.</param>
+    /// <!-- aidoc:v1 sig=9a63bf8 body=94ba0df -->
     public async Task UpdateManyObjectId(string patientid, ObjectId patientId, ObjectId oldId)
         {
             await UpdateManyObjectIdAsync(patientid, patientId, oldId);
@@ -61,6 +64,7 @@ public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPati
     /// Returns the collection name for patient care plan data, using the configured setting if available or a default fallback otherwise.
     /// </summary>
     /// <returns>The patient care plan collection name from <c>_apiSettings.PatientCarePlan</c>, or <c>"patients_care_plan"</c> when the setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=c8bc19f -->
     public override string GetCollectionName()
         {
             return _apiSettings.PatientCarePlan ?? "patients_care_plan";
@@ -72,6 +76,7 @@ public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPati
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose care plans should be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="PatientCarePlan"/> objects associated with the specified patient, or an empty list if none are found.</returns>
+    /// <!-- aidoc:v1 sig=9706d89 body=fae3443 -->
     public async Task<List<PatientCarePlan>> FindByPatientId(ObjectId patientId)
         {
             var result = await Collection.FindAsync(Builders<PatientCarePlan>.Filter.Eq(p => p.PatientId, patientId));
@@ -83,6 +88,7 @@ public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPati
     /// </summary>
     /// <param name="userId">The unique identifier of the user whose patient care plans are being queried.</param>
     /// <returns>A list of <see cref="PatientCarePlan"/> instances matching the specified user identifier; an empty list is returned if no plans are found.</returns>
+    /// <!-- aidoc:v1 sig=7520aa9 body=3dd56f3 -->
     public async Task<List<PatientCarePlan>> FindByUserId(ObjectId userId)
         {
             var result = await Collection.FindAsync(Builders<PatientCarePlan>.Filter.Eq(p => p.UserId, userId));
@@ -93,6 +99,7 @@ public class PatientCarePlanRepository : MongoRepository<PatientCarePlan>, IPati
     /// Retrieves all patient care plans from the data store without applying any filter.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="PatientCarePlan"/> records.</returns>
+    /// <!-- aidoc:v1 sig=6a558a7 body=faea989 -->
     public async Task<List<PatientCarePlan>> FindAll()
         {
             var result = await Collection.Find(Builders<PatientCarePlan>.Filter.Empty).ToListAsync();
diff --git a/adas-core.Infrastructure/Repositories/PatientRepository.cs b/adas-core.Infrastructure/Repositories/PatientRepository.cs
index affe53dc..8bebeec0 100644
--- a/adas-core.Infrastructure/Repositories/PatientRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PatientRepository.cs
@@ -18,6 +18,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Provides a MongoDB-backed repository implementation for managing patient data, exposing patient-specific data access operations defined by the IPatientRepository contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=c81c577 -->
 public class PatientRepository : MongoRepository<Patient>, IPatientRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -47,6 +48,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// or falling back to the default "patients" if the setting is null.
     /// </summary>
     /// <returns>The configured patients collection name, or "patients" as a default when the setting is not set.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=04f5507 -->
     public override string GetCollectionName()
         {
             return _apiSettings.Patients ?? "patients";
@@ -58,6 +60,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="id">The unique identifier of the patient to locate.</param>
     /// <returns>A <see cref="Patient"/> instance matching the provided id, or <c>null</c> if not found or on error.</returns>
+    /// <!-- aidoc:v1 sig=f97bb0d body=2c27a66 -->
     public async Task<Patient?> FindById(ObjectId id)
         {
             try
@@ -80,6 +83,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="id">The point of care identifier used to locate the patient.</param>
     /// <returns>A <see cref="Patient"/> instance if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=8a4443e body=e3fe55b -->
     public async Task<Patient?> FindByPointOfCareId(ObjectId id)
         {
             try
@@ -103,6 +107,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="unit">The identifier of the unit to filter by.</param>
     /// <param name="pointOfCare">The identifier of the point of care to filter by.</param>
     /// <returns>The first matching <see cref="Patient"/>, or null if no patient is found or an error is encountered.</returns>
+    /// <!-- aidoc:v1 sig=9b461f1 body=c98f5c9 -->
     public async Task<Patient> FindByUnitAndPocId(ObjectId unit, ObjectId pointOfCare)
         {
             try
@@ -129,6 +134,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="location">The location information used to locate the patient. Can be null.</param>
     /// <returns>A <see cref="Patient"/> matching the location criteria, or null if no match is found or the location is null.</returns>
+    /// <!-- aidoc:v1 sig=556acef body=7ff7fec -->
     public async Task<Patient?> FindByLocation(PatientLocation? location)
         {
             if (location == null)
@@ -155,6 +161,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// Asynchronously inserts a new <see cref="Patient"/> record, setting its creation date to the current UTC time. If the insertion fails but an existing patient with the same patient number is found at the same location, the exception is logged as a warning; otherwise, the error is logged and rethrown.
     /// </summary>
     /// <param name="patient">The <see cref="Patient"/> entity to insert into the data store.</param>
+    /// <!-- aidoc:v1 sig=334af9d body=f6ea95d -->
     public override async Task InsertOneAsync(Patient patient)
         {
             try
@@ -183,6 +190,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// Updates an existing patient record, refreshing the update timestamp to the current UTC time before persisting the changes.
     /// </summary>
     /// <param name="patient">The patient entity containing the updated information to be saved.</param>
+    /// <!-- aidoc:v1 sig=f9d52dc body=06dccd6 -->
     public async Task Update(Patient patient)
         {
             patient.UpdateDate = DateTime.UtcNow;
@@ -193,6 +201,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// Deletes a patient from the collection that matches the specified identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient to remove.</param>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=60a9b9b -->
     public async Task Delete(ObjectId id)
         {
             var filter = Builders<Patient>.Filter.Eq(x => x.Id, id);
@@ -204,6 +213,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose location will be updated.</param>
     /// <param name="location">The new location to assign to the patient.</param>
+    /// <!-- aidoc:v1 sig=a6d84a4 body=af93f9e -->
     public async Task UpdateLocation(ObjectId id, PatientLocation location)
         {
             var patient = await FindById(id);
@@ -236,6 +246,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose location will be updated.</param>
     /// <param name="location">The new point of care (location) identifier to assign to the patient.</param>
+    /// <!-- aidoc:v1 sig=ca2f737 body=b5de0cf -->
     public async Task UpdateLocation(ObjectId id, ObjectId location)
         {
             var patient = await FindById(id);
@@ -255,6 +266,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="id">The unique identifier of the patient whose attending doctor is being updated.</param>
     /// <param name="attendingDoctor">The new attending doctor to assign to the patient.</param>
+    /// <!-- aidoc:v1 sig=724f112 body=44fd27b -->
     public async Task UpdateAttendingDoctor(ObjectId id, Person attendingDoctor)
         {
             var update = Builders<Patient>.Update
@@ -272,6 +284,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="patientNumber">The new patient number to apply when <paramref name="updatePatientNumber"/> is true.</param>
     /// <param name="data">The new <see cref="Person"/> information to store for the patient.</param>
     /// <param name="updatePatientNumber">Indicates whether the patient number should be updated as part of the operation; defaults to true.</param>
+    /// <!-- aidoc:v1 sig=06ac587 body=114be5c -->
     public async Task UpdatePatientData(ObjectId id, string patientNumber, Person data, bool updatePatientNumber = true)
         {
             var filterBuilder = Builders<Patient>.Filter;
@@ -615,6 +628,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="unitIds">The list of unit identifiers used to filter patients.</param>
     /// <param name="typeName">The name of the type to validate against the MasterListType enumeration.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of Patient objects matching the specified unit identifiers, or an empty list if the type name is invalid.</returns>
+    /// <!-- aidoc:v1 sig=6f3d195 body=74ee8d7 -->
     public async Task<List<Patient>> GetPatientsByUnitIds(List<ObjectId> unitIds, string typeName)
         {
             var isParsed = Enum.TryParse<MasterListType>(typeName, out _);
@@ -630,6 +644,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="unitId">The unit identifier used to filter patients.</param>
     /// <returns>The number of patients matching the specified unit identifier, or 0 if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=baa8175 body=e692f35 -->
     public async Task<long> CountByUnitId(ObjectId unitId)
         {
             try
@@ -818,6 +833,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// Retrieves all <see cref="Patient"/> records from the data store.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all patients.</returns>
+    /// <!-- aidoc:v1 sig=e8bb639 body=c6cbf36 -->
     public async Task<List<Patient>> FindAll()
         {
             return (await Collection.FindAsync(Builders<Patient>.Filter.Empty)).ToList();
@@ -829,6 +845,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="pointOfCare">The unit or point of care used to filter the patients.</param>
     /// <returns>A task containing a list of <see cref="Patient"/> objects whose unit matches the specified point of care; an empty list is returned when no matches are found.</returns>
+    /// <!-- aidoc:v1 sig=c4523a3 body=eff26de -->
     public async Task<List<Patient>> FindByPointOfCare(string pointOfCare)
         {
             var filterBuilder = Builders<Patient>.Filter;
@@ -844,6 +861,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="pointOfCare">The identifier of the point of care used to filter the patient records.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=1cea52d body=b9dfd95 -->
     public async Task<List<Patient>> FindByPointOfCare(ObjectId pointOfCare)
         {
             var filterBuilder = Builders<Patient>.Filter;
@@ -932,6 +950,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="filter">The pagination and filtering criteria, including optional text, time range, unit, and point of care filters.</param>
     /// <returns>A find fluent for the filtered and sorted patient query.</returns>
+    /// <!-- aidoc:v1 sig=6790d47 body=f65667b -->
     public IFindFluent<Patient, Patient> GetPaginatedPatients(PaginationFilter filter)
         {
             var filterBuilder = Builders<Patient>.Filter;
@@ -981,6 +1000,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="date">The cutoff date; patients with an <c>UpdateDate</c> strictly earlier than this value, or with no <c>UpdateDate</c> set, will be returned.</param>
     /// <returns>A task that resolves to a list of <see cref="Patient"/> instances matching the filter criteria.</returns>
+    /// <!-- aidoc:v1 sig=42988dc body=d938adb -->
     public async Task<List<Patient>> FindPatientsNotUpdatedSince(DateTime date)
         {
             var filter = Builders<Patient>.Filter.Or(
@@ -999,6 +1019,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <returns>A task that resolves to a list of discharged <see cref="Patient"/> records,
     /// or an empty list if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=c56ad55 body=600ef72 -->
     public async Task<List<Patient>> FindDischargedPatients()
         {
             try
@@ -1022,6 +1043,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="updatedPatient">The patient entity containing the updated values and the identifier of the record to modify.</param>
     /// <returns>The updated <see cref="Patient"/> after the modification is applied, or <c>null</c> if no matching document exists.</returns>
+    /// <!-- aidoc:v1 sig=5cf3377 body=b2c2664 -->
     public async Task<Patient?> UpdateOne(Patient updatedPatient)
         {
             var filter = Builders<Patient>.Filter.Eq("_id", updatedPatient.Id);
@@ -1042,6 +1064,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="patientId">The unique identifier of the patient to update.</param>
     /// <param name="person">The patient object containing the new values for the incoming data fields.</param>
     /// <returns>The updated <see cref="Patient"/> document after the modification, or <c>null</c> if no document was found.</returns>
+    /// <!-- aidoc:v1 sig=c195b1f body=20e831b -->
     public async Task<Patient?> UpdatePatientIncomingData(ObjectId patientId, Patient person)
         {
             var filter = Builders<Patient>.Filter.Eq("_id", patientId);
@@ -1064,6 +1087,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="patientId">The unique identifier of the patient whose data will be updated.</param>
     /// <param name="person">The patient object containing the new demographic and clinical values to persist.</param>
     /// <returns>The updated <see cref="Patient"/> document, or <c>null</c> if no patient with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=a6fa876 body=4fc291c -->
     public async Task<Patient?> UpdatePatientDemographicData(ObjectId patientId, Patient person)
         {
             var filter = Builders<Patient>.Filter.Eq("_id", patientId);
@@ -1084,6 +1108,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <summary>
     /// Creates MongoDB indexes for the Patient collection, including a unique index on the <c>patientNumber</c> field and a non-unique index on the <c>admTime</c> field, using background index creation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=6e16010 -->
     public override async Task CreateIndexes()
         {
             var options = new CreateIndexOptions<Patient> { Background = true, Unique = false };
@@ -1111,6 +1136,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="requestFilter">The request containing the optional start and end time values used to build each range filter.</param>
     /// <param name="filters">The collection of filter definitions to which the constructed filters are added.</param>
     /// <param name="filterBuilder">The builder used to create the Gte and Lte filter definitions for each time range.</param>
+    /// <!-- aidoc:v1 sig=095d341 body=8b4f9c0 -->
     private static void AddTimeFilters(FilteredRequest requestFilter, List<FilterDefinition<Patient>> filters,
             FilterDefinitionBuilder<Patient> filterBuilder)
         {
@@ -1164,6 +1190,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// </summary>
     /// <param name="pointOfCare">The ObjectId of the point of care used to filter the patients.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of patients matching the specified point of care.</returns>
+    /// <!-- aidoc:v1 sig=4945a00 body=b9dfd95 -->
     public async Task<List<Patient>> FindAllByPointOfCareId(ObjectId pointOfCare)
         {
             var filterBuilder = Builders<Patient>.Filter;
@@ -1181,6 +1208,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="filters">The list of filter definitions to which the new filter will be appended.</param>
     /// <param name="filter">The pagination filter containing the request criteria used to build the default filter.</param>
     /// <param name="filterBuilder">The builder used to construct the MongoDB filter definitions for the <see cref="Patient"/> entity.</param>
+    /// <!-- aidoc:v1 sig=6206f14 body=1a8e3bd -->
     private void AddDefaultFilters(List<FilterDefinition<Patient>> filters, PaginationFilter filter,
             FilterDefinitionBuilder<Patient> filterBuilder)
         {
@@ -1206,6 +1234,7 @@ public class PatientRepository : MongoRepository<Patient>, IPatientRepository
     /// <param name="filters">The list of filter definitions to combine; when empty, an empty filter (match-all) is used.</param>
     /// <param name="sort">The sort definition to apply to the query results.</param>
     /// <returns>An <see cref="IFindFluent{TSource, TDocument}"/> configured with the combined filter and sort.</returns>
+    /// <!-- aidoc:v1 sig=6ee44b3 body=7b7fa02 -->
     private IFindFluent<Patient, Patient> CreateFindFluent(List<FilterDefinition<Patient>> filters,
             SortDefinition<Patient> sort)
         {
diff --git a/adas-core.Infrastructure/Repositories/PoCSettingsRepository.cs b/adas-core.Infrastructure/Repositories/PoCSettingsRepository.cs
index 4abb8a51..dc507f7a 100644
--- a/adas-core.Infrastructure/Repositories/PoCSettingsRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PoCSettingsRepository.cs
@@ -14,6 +14,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// Represents a MongoDB-backed repository for <see cref="PoCSettings"/> entities, implementing the <see cref="IPoCSettingsRepository"/> contract to provide data access operations.
 /// </summary>
 /// <typeparam name="PoCSettings">The type of the settings entity managed by the repository.</typeparam>
+/// <!-- aidoc-review:v1 severity=medium kind=extra_param
+///      "PoCSettings is not a type parameter of PoCSettingsRepository; it is a generic type argument supplied to MongoRepository. The <typeparam> tag is incorrect." -->
 public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -36,6 +38,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// Retrieves the collection name used for Proof of Concept (PoC) settings, returning the value from the API settings or the default "poc_settings" when no value is configured.
     /// </summary>
     /// <returns>The configured PoC settings collection name, or "poc_settings" as a fallback when <c>_apiSettings.PoCSettings</c> is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=1916b20 -->
     public override string GetCollectionName()
         {
             return _apiSettings.PoCSettings ?? "poc_settings";
@@ -45,6 +48,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// Deletes the PoCSettings document matching the specified identifier from the collection.
     /// </summary>
     /// <param name="id">The unique identifier of the PoCSettings document to delete.</param>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=24b7498 -->
     public async Task Delete(ObjectId id)
         {
             try
@@ -64,6 +68,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// If an error occurs during the retrieval, the exception is logged and an empty list is returned as a fallback.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of all PoCSettings records, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=6810f78 body=f98d2ca -->
     public async Task<List<PoCSettings>> FindAll()
         {
             try
@@ -84,6 +89,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> used to locate the PoCSettings document.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="PoCSettings"/> or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=de8c390 body=645f4b0 -->
     public async Task<PoCSettings?> FindById(ObjectId id)
         {
             try
@@ -105,6 +111,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// </summary>
     /// <param name="location">The patient location provided as search criteria. Detailed attribute-based filtering by location fields is currently commented out.</param>
     /// <returns>The first matching PoCSettings record, or null if no record is found.</returns>
+    /// <!-- aidoc:v1 sig=d3a4d30 body=e565bd9 -->
     public async Task<PoCSettings?> FindByLocation(PatientLocation location)
         {
             try
@@ -137,6 +144,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// Updates the existing PoC (Proof of Concept) settings asynchronously. If the update fails, the exception is logged and rethrown to the caller.
     /// </summary>
     /// <param name="pocSettings">The PoC settings entity to be updated, identified by its <c>Id</c>.</param>
+    /// <!-- aidoc:v1 sig=944ba55 body=9a9ca83 -->
     public async Task Update(PoCSettings pocSettings)
         {
             try
@@ -153,6 +161,7 @@ public class PoCSettingsRepository : MongoRepository<PoCSettings>, IPoCSettingsR
     /// <summary>
     /// Creates the MongoDB indexes required for the <see cref="PoCSettings"/> collection, applying non-unique background indexing on the <c>patientLocation</c> field.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=b65c045 -->
     public override async Task CreateIndexes()
         {
             var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/PointOfCareRepository.cs b/adas-core.Infrastructure/Repositories/PointOfCareRepository.cs
index 238ad7ad..45b396f2 100644
--- a/adas-core.Infrastructure/Repositories/PointOfCareRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PointOfCareRepository.cs
@@ -16,6 +16,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Represents a MongoDB-backed repository for <see cref="PointOfCare"/> entities, providing the persistence operations defined by the <see cref="IPointOfCareRepository"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=47f85a2 -->
 public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -41,6 +42,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Retrieves the collection name used for Locations operations from the API settings configuration.
     /// </summary>
     /// <returns>The configured Locations collection name retrieved from the API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=3c89cf4 -->
     public override string GetCollectionName()
         {
             return _apiSettings.Locations;
@@ -51,6 +53,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// If the base insert operation fails, the exception is written to the console and logged, then rethrown to preserve the original failure.
     /// </summary>
     /// <param name="pointOfCare">The <see cref="PointOfCare"/> entity to insert.</param>
+    /// <!-- aidoc:v1 sig=fb673ff body=2d2093f -->
     public override async Task InsertOneAsync(PointOfCare pointOfCare)
         {
             try
@@ -70,6 +73,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Any exception encountered during the delete operation is logged and rethrown to the caller.
     /// </summary>
     /// <param name="id">The unique identifier of the <see cref="PointOfCare"/> entity to remove.</param>
+    /// <!-- aidoc:v1 sig=3de1ad6 body=f09ede6 -->
     public async Task Delete(ObjectId id)
         {
             try
@@ -90,6 +94,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose related <see cref="PointOfCare"/> records should be removed.</param>
     /// <returns>A task that resolves to <c>true</c> when the records are deleted, or <c>false</c> when an error occurs during the operation.</returns>
+    /// <!-- aidoc:v1 sig=be3448b body=d89d1ff -->
     public async Task<bool> DeleteManyByUnitId(ObjectId unitId)
         {
             try
@@ -110,6 +115,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Updates an existing PointOfCare entity asynchronously in the data store.
     /// </summary>
     /// <param name="pointOfCare">The PointOfCare entity to update, identified by its Id.</param>
+    /// <!-- aidoc:v1 sig=f80d98a body=9bbdcdc -->
     public async Task Update(PointOfCare pointOfCare)
         {
             try
@@ -128,6 +134,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="id">The ObjectId of the PointOfCare document to update.</param>
     /// <param name="unit">The Unit object whose Name and Id values will be set on the matching document.</param>
+    /// <!-- aidoc:v1 sig=d74e094 body=6b7a6b3 -->
     public async Task UpdateUnitId(ObjectId id, Unit unit)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -146,6 +153,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="pocId">The unique identifier of the Point of Care whose relay configuration will be updated.</param>
     /// <param name="relayConfig">The collection of relays whose identifiers will be stored as the new relay configuration.</param>
+    /// <!-- aidoc:v1 sig=598eb3a body=e78ac25 -->
     public async Task UpdateRelayConfig(ObjectId pocId, List<Relay> relayConfig)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -161,6 +169,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="pocId">The identifier of the point of care whose relay configuration will be updated.</param>
     /// <param name="relayConfig">The new list of relay identifiers to assign to the point of care's configuration.</param>
+    /// <!-- aidoc:v1 sig=784ef54 body=8ee7aff -->
     public async Task UpdateRelayConfig(ObjectId pocId, List<ObjectId> relayConfig)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -176,6 +185,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="id">The unique identifier of the <see cref="PointOfCare"/> entity to update.</param>
     /// <param name="configuration">The new configuration values to apply to the entity.</param>
+    /// <!-- aidoc:v1 sig=1874ae4 body=c5f4db7 -->
     public async Task UpdateConfiguration(ObjectId id, PointOfCareConfiguration configuration)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -193,6 +203,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="id">The unique <see cref="ObjectId"/> of the point of care to retrieve.</param>
     /// <returns>A <see cref="PointOfCare"/> if a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=2826028 body=1db2247 -->
     public async Task<PointOfCare?> FindById(ObjectId id)
         {
             try
@@ -215,6 +226,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// <param name="status">The point of care status used to filter the results.</param>
     /// <param name="excludeVirtual">When <c>true</c>, filters out entries whose bed matches one of the known <see cref="VirtualPointOfCare"/> values; otherwise virtual entries are included.</param>
     /// <returns>A task that resolves to an <see cref="IEnumerable{PointOfCare}"/> containing the matching entries, or an empty collection if the query fails.</returns>
+    /// <!-- aidoc:v1 sig=66efb59 body=346b01e -->
     public async Task<IEnumerable<PointOfCare>> FindByUnitAndStatus(ObjectId unitId, StatusEnum.PointOfCare status,
             bool excludeVirtual = false)
         {
@@ -292,6 +304,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="unit">The identifier of the unit whose points of care should be retrieved.</param>
     /// <returns>A task that yields a collection of <see cref="PointOfCare"/> instances matching the given unit, or <c>null</c> if the search fails.</returns>
+    /// <!-- aidoc:v1 sig=1265646 body=709d354 -->
     public async Task<IEnumerable<PointOfCare>?> FindAllByUnitId(ObjectId unit)
         {
             try
@@ -314,6 +327,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="room">The room identifier used to filter the point-of-care records.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of matching <see cref="PointOfCare"/> entries, or <see langword="null"/> if the search fails.</returns>
+    /// <!-- aidoc:v1 sig=d9b8bd7 body=11151e4 -->
     public async Task<IEnumerable<PointOfCare>?> FindByRoom(string room)
         {
             try
@@ -336,6 +350,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="bed">The bed identifier used to filter the point of care records.</param>
     /// <returns>A task containing an enumerable collection of matching <see cref="PointOfCare"/> records, or null if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=27196b1 body=358ac53 -->
     public async Task<IEnumerable<PointOfCare>?> FindByBed(string bed)
         {
             try
@@ -359,6 +374,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// <param name="filter">The MongoDB filter definition used to match the desired <see cref="PointOfCare"/> documents.</param>
     /// <param name="projection">An optional projection definition to limit or transform the fields returned in each document. When <c>null</c>, the full documents are returned.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PointOfCare"/> documents that match the filter.</returns>
+    /// <!-- aidoc:v1 sig=18993a9 body=c2bab2a -->
     public async Task<List<PointOfCare>> FindByFilter(FilterDefinition<PointOfCare> filter,
             ProjectionDefinition<PointOfCare>? projection = null)
         {
@@ -372,6 +388,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose point-of-care entries should be counted.</param>
     /// <returns>A <see cref="Task{Int64}"/> that resolves to the number of matching point-of-care documents for the given unit.</returns>
+    /// <!-- aidoc:v1 sig=baa8175 body=a7b09ba -->
     public async Task<long> CountByUnitId(ObjectId unitId)
         {
             try
@@ -446,6 +463,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="pocId">The unique identifier of the point of care whose configuration is being requested.</param>
     /// <returns>A <see cref="Task{PointOfCare}"/> containing the matching <see cref="PointOfCare"/> with its configuration, or <c>null</c> if no record exists for the given identifier.</returns>
+    /// <!-- aidoc:v1 sig=8e7499c body=da257e7 -->
     public async Task<PointOfCare?> GetPoCConfiguration(ObjectId pocId)
         {
             var filter = Builders<PointOfCare>.Filter.Eq(p => p.Id, pocId);
@@ -461,6 +479,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Retrieves all <see cref="PointOfCare"/> records from the underlying data store using an empty filter.
     /// </summary>
     /// <returns>A <see cref="Task{TResult}"/> containing a <see cref="List{T}"/> of <see cref="PointOfCare"/> items, or <c>null</c> when no results are returned.</returns>
+    /// <!-- aidoc:v1 sig=54c1971 body=b4b56a0 -->
     public async Task<List<PointOfCare>?> GetAll()
         {
             var filter = Builders<PointOfCare>.Filter.Empty;
@@ -472,6 +491,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="id">The unique identifier of the point of care to retrieve.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="PointOfCare"/> with its resolved beacon, camera, and relay configuration, or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=3a998f5 body=6d67850 -->
     public async Task<PointOfCare?> FindByIdAllConfig(ObjectId id)
         {
             return await Collection.Aggregate()
@@ -515,6 +535,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// contra el total de cámaras en uso, independientemente del volumen de datos.
     /// </remarks>
     /// <returns>Un conjunto hash con los <see cref="ObjectId"/> de las cámaras en uso.</returns>
+    /// <!-- aidoc:v1 sig=f6346fe body=c7c2683 -->
     public async Task<HashSet<ObjectId>> FindAllIdCamerasInUse()
     {
         var distinctIds = await Collection
@@ -527,6 +548,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Retrieves all distinct beacon identifiers currently referenced by any point-of-care configuration.
     /// </summary>
     /// <returns>A set containing the unique <see cref="ObjectId"/> values of beacons in use across all point-of-care records.</returns>
+    /// <!-- aidoc:v1 sig=7e41dd8 body=2dfc33a -->
     public async Task<HashSet<ObjectId>> FindAllIdBeaconsInUse()
         {
             var distinctIds = await Collection
@@ -541,6 +563,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="unitId">The identifier of the unit used to filter the points of care.</param>
     /// <returns>A task that returns a collection of PointOfCare with their associated device lists populated, or null if an error occurs during the query.</returns>
+    /// <!-- aidoc:v1 sig=74ce5ed body=bc6b30b -->
     public async Task<IEnumerable<PointOfCare>?> FindAllByUnitIdWithDevices(ObjectId unitId)
         {
             try
@@ -592,6 +615,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Retrieves the set of distinct relay identifiers currently referenced by any <see cref="PointOfCare"/> configuration in the collection.
     /// </summary>
     /// <returns>A <see cref="HashSet{T}"/> of <see cref="ObjectId"/> values containing all unique relay IDs found across the <c>configuration.relayIdList</c> field of every document.</returns>
+    /// <!-- aidoc:v1 sig=7d4add8 body=4904eff -->
     public async Task<HashSet<ObjectId>> FindAllIdRelaysInUse()
         {
             var distinctIds = await Collection
@@ -605,6 +629,8 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Retrieves all point-of-care configurations, joining each configuration with its associated light beacons, cameras, and relays through MongoDB lookups and projecting the combined result into a flattened <see cref="PointOfCare"/> structure.
     /// </summary>
     /// <returns>A task that resolves to a list of <see cref="PointOfCare"/> objects enriched with the corresponding beacon, camera, and relay details, or <c>null</c> when no configurations are found.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "Documentation states the method returns 'null when no configurations are found', but the implementation uses pipeline.ToListAsync() which returns an empty list (not null) when no documents exist. The nullable return type annotation does not match the actual runtime behavior." -->
     public async Task<List<PointOfCare>?> GetAllConfigs()
         {
             var pipeline = Collection.Aggregate()
@@ -655,6 +681,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// Uses an empty filter to return every record and returns a nullable list that may be null if no results are found.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PointOfCare"/> objects with the projected fields, or <c>null</c> if no matching records exist.</returns>
+    /// <!-- aidoc:v1 sig=7d0cd41 body=44afaf5 -->
     public async Task<List<PointOfCare>?> GetAllLocationInfo()
         {
             var filter = Builders<PointOfCare>.Filter.Empty;
@@ -675,6 +702,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="filter">The pagination and filtering criteria. If <c>FilteredRequest</c> is null, no additional filters are applied.</param>
     /// <returns>An <see cref="IFindFluent{PointOfCare, PointOfCare}"/> representing the resulting MongoDB query with the applied filters and sort.</returns>
+    /// <!-- aidoc:v1 sig=63378f1 body=ab03c99 -->
     public IFindFluent<PointOfCare, PointOfCare> GetPaginatedPoCs(PaginationFilter filter)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -742,6 +770,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// <summary>
     /// Creates MongoDB indexes for the <see cref="PointOfCare"/> collection on the <c>unitId</c>, <c>room</c>, and <c>bed</c> fields, using background creation and non-unique constraints, to optimize query performance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=b988d70 -->
     public override async Task CreateIndexes()
         {
             var options = new CreateIndexOptions { Background = true, Unique = false };
@@ -760,6 +789,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// </summary>
     /// <param name="id">The unique identifier of the point-of-care record to update.</param>
     /// <param name="status">The new status value to apply to the point-of-care record.</param>
+    /// <!-- aidoc:v1 sig=ad30072 body=87cbbaf -->
     public async Task UpdateStatus(ObjectId id, StatusEnum.PointOfCare status)
         {
             var filterBuilder = Builders<PointOfCare>.Filter;
@@ -777,6 +807,7 @@ public class PointOfCareRepository : MongoRepository<PointOfCare>, IPointOfCareR
     /// <param name="filters">The list of filter definitions to be combined; an empty list results in no filtering.</param>
     /// <param name="sort">The sort definition applied to the resulting query.</param>
     /// <returns>An <see cref="IFindFluent{PointOfCare, PointOfCare}"/> representing the filtered and sorted query.</returns>
+    /// <!-- aidoc:v1 sig=76fee2f body=51d06bc -->
     private IFindFluent<PointOfCare, PointOfCare> CreateFindFluent(List<FilterDefinition<PointOfCare>> filters,
             SortDefinition<PointOfCare> sort)
         {
diff --git a/adas-core.Infrastructure/Repositories/PumpAlarmEventRepository.cs b/adas-core.Infrastructure/Repositories/PumpAlarmEventRepository.cs
index 93e273aa..71f46748 100644
--- a/adas-core.Infrastructure/Repositories/PumpAlarmEventRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PumpAlarmEventRepository.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <remarks>
 /// Inherits the generic MongoDB persistence capabilities of <see cref="MongoRepository{TDocument}"/>, specializing them for the <see cref="PumpAlarmEvent"/> entity type.
 /// </remarks>
+/// <!-- aidoc:v1 sig=bf52831 -->
 public class PumpAlarmEventRepository : MongoRepository<PumpAlarmEvent>, IPumpAlarmEventRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -88,6 +89,15 @@ public class PumpAlarmEventRepository : MongoRepository<PumpAlarmEvent>, IPumpAl
         await Collection.InsertOneAsync(alarmEvent);
     }
 
+    /// <summary>
+    /// Asynchronously retrieves <see cref="PumpAlarmEvent"/> records for the specified device, optionally constrained by an inclusive time range and a maximum result count.
+    /// </summary>
+    /// <param name="deviceId">The identifier of the device whose alarm events are queried.</param>
+    /// <param name="from">Optional inclusive lower bound on the event time; when <see langword="null"/>, no lower bound is applied.</param>
+    /// <param name="to">Optional inclusive upper bound on the event time; when <see langword="null"/>, no upper bound is applied.</param>
+    /// <param name="limit">Optional maximum number of events to return; when <see langword="null"/>, all matching events are returned.</param>
+    /// <returns>A task producing the matching <see cref="PumpAlarmEvent"/> records ordered by time in descending order.</returns>
+    /// <!-- aidoc:v1 sig=ea193a8 body=0e52ba3 -->
     public async Task<IEnumerable<PumpAlarmEvent>> FindByDeviceIdAsync(string deviceId, DateTime? from = null,
         DateTime? to = null, int? limit = null)
     {
@@ -111,6 +121,8 @@ public class PumpAlarmEventRepository : MongoRepository<PumpAlarmEvent>, IPumpAl
     /// <param name="deviceId">The identifier of the device whose latest alarm event is being retrieved.</param>
     /// <returns>A <see cref="Task{PumpAlarmEvent}"/> that yields the latest <see cref="PumpAlarmEvent"/> associated with <paramref name="deviceId"/>, or <c>null</c> if no matching event is found.</returns>
     /// <!-- aidoc:v1 sig=f0fbfb3 body=088b34a -->
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "The <returns> tag references Task{PumpAlarmEvent} without the nullable annotation, while the actual return type is Task<PumpAlarmEvent?> (though the description text does mention nullability)." -->
     public async Task<PumpAlarmEvent?> FindLastByDeviceIdAsync(string deviceId)
     {
         return await Collection
diff --git a/adas-core.Infrastructure/Repositories/PumpAlarmStateRepository.cs b/adas-core.Infrastructure/Repositories/PumpAlarmStateRepository.cs
index 7bfb32f5..dcd414a7 100644
--- a/adas-core.Infrastructure/Repositories/PumpAlarmStateRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PumpAlarmStateRepository.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Represents a MongoDB-based repository for <see cref="PumpAlarmState"/> entities, providing concrete data access functionality defined by the <see cref="IPumpAlarmStateRepository"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=86597ed -->
 public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAlarmStateRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -33,6 +34,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// Gets the collection name for the pump alarm state, returning the value configured in the API settings or the default "pump_alarm_state" when the configuration is not set.
     /// </summary>
     /// <returns>The configured collection name, or the default "pump_alarm_state" if the API setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=e7678e2 -->
     public override string GetCollectionName()
         {
             return _apiSettings.PumpAlarmState ?? "pump_alarm_state";
@@ -77,6 +79,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// <param name="alarmType">The optional alarm type used to further narrow the filter. When <c>null</c>, the alarm type is not applied.</param>
     /// <param name="alarmCodeMdc">The optional alarm code (MDC) used to further narrow the filter. Ignored when <c>null</c>, empty, or whitespace.</param>
     /// <returns>A <see cref="PumpAlarmState"/> instance if a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=6935479 body=32e97b5 -->
     public async Task<PumpAlarmState?> FindActiveAsync(string deviceId, PumpEnum.AlarmType? alarmType, string? alarmCodeMdc = null)
         {
             var filter = Builders<PumpAlarmState>.Filter.Eq(x => x.DeviceId, deviceId);
@@ -128,6 +131,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// <param name="deviceId">The identifier of the device whose alarm state records should be removed. Used as a mandatory filter criterion.</param>
     /// <param name="alarmType">The optional alarm type to further restrict which records are deleted. When <see langword="null"/>, records of any alarm type for the device are removed.</param>
     /// <param name="alarmCodeMdc">The optional alarm code MDC used to further narrow the deletion. Blank or whitespace values are ignored.</param>
+    /// <!-- aidoc:v1 sig=13aeac3 body=e8846f6 -->
     public async Task RemoveAsync(string? deviceId, PumpEnum.AlarmType? alarmType, string? alarmCodeMdc = null)
         {
             var filter = Builders<PumpAlarmState>.Filter.Eq(x => x.DeviceId, deviceId);
@@ -145,6 +149,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// Asynchronously deletes all records associated with the specified patient identifier by removing every document whose <c>PatientId</c> matches the supplied value.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose associated records should be removed.</param>
+    /// <!-- aidoc:v1 sig=4776e51 body=69c2fe9 -->
     public async Task DeleteByPatientId(ObjectId patientId)
         {
             await Collection.DeleteManyAsync(p => p.PatientId == patientId);
@@ -155,6 +160,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose pump alarm states are being queried.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{PumpAlarmState}"/> with the pump alarm states matching the provided device identifier.</returns>
+    /// <!-- aidoc:v1 sig=a3f8899 body=0854c79 -->
     public async Task<IEnumerable<PumpAlarmState>> FindAllActiveByDeviceAsync(string deviceId)
         {
             return await Collection.Find(x => x.DeviceId == deviceId).ToListAsync();
@@ -167,6 +173,7 @@ public class PumpAlarmStateRepository : MongoRepository<PumpAlarmState>, IPumpAl
     /// <param name="newId">The new <see cref="MongoDB.Bson.ObjectId"/> value to assign to the field.</param>
     /// <param name="oldId">The existing <see cref="MongoDB.Bson.ObjectId"/> value used to locate matching documents.</param>
     /// <returns>The number of documents that were modified by the update operation.</returns>
+    /// <!-- aidoc:v1 sig=885ce8c body=b35cab3 -->
     public async Task<long> UpdateManyObjectIdByFieldNameAsync(string fieldName, ObjectId newId, ObjectId oldId)
         {
             var filter = Builders<PumpAlarmState>.Filter.Eq(fieldName, oldId);
diff --git a/adas-core.Infrastructure/Repositories/PumpArchiveRepository.cs b/adas-core.Infrastructure/Repositories/PumpArchiveRepository.cs
index 4be44c12..52b63771 100644
--- a/adas-core.Infrastructure/Repositories/PumpArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PumpArchiveRepository.cs
@@ -15,6 +15,7 @@ namespace adas_core.Infrastructure.Repositories
     /// Repositorio de archivo para observaciones de bombas.
     /// Colección: archive_pumpobservations (configurable por ApiSettings.ArchivePumpObservations).
     /// </summary>
+    /// <!-- aidoc:v1 sig=46323e9 -->
     public class PumpArchiveRepository : MongoRepository<PumpObservation>, IPumpArchiveRepository
     {
         private readonly ApiSettings _apiSettings;
@@ -76,6 +77,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Asynchronously inserts a <see cref="PumpObservation"/> into the underlying MongoDB collection.
         /// </summary>
         /// <param name="obs">The pump observation to persist.</param>
+        /// <!-- aidoc:v1 sig=2e9b63d body=ff40c9a -->
         public async Task InsertAsync(PumpObservation obs)
                 {
                     await Collection.InsertOneAsync(obs);
@@ -85,6 +87,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Asynchronously inserts a batch of pump observations into the underlying data store. If the collection is empty, the method completes without performing any insertion.
         /// </summary>
         /// <param name="observations">The pump observations to insert into the collection.</param>
+        /// <!-- aidoc:v1 sig=1891edb body=80cfb77 -->
         public async Task InsertManyAsync(IEnumerable<PumpObservation> observations)
                 {
                     var list = observations as IList<PumpObservation> ?? observations.ToList();
@@ -101,6 +104,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="to">Optional inclusive upper bound for the observation time. When provided, only observations on or before this time are returned.</param>
         /// <param name="limit">Optional maximum number of observations to return. When null, all matching observations are returned.</param>
         /// <returns>A task that represents the asynchronous operation. The task result contains an <see cref="IEnumerable{PumpObservation}"/> of matching observations ordered from newest to oldest.</returns>
+        /// <!-- aidoc:v1 sig=d24c731 body=afb5adf -->
         public async Task<IEnumerable<PumpObservation>> FindByPatientIdAsync(
                     ObjectId patientId, DateTime? from = null, DateTime? to = null, int? limit = null)
                 {
@@ -124,6 +128,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Deletes all pump observations whose recording time is earlier than the specified cutoff date.
         /// </summary>
         /// <param name="addDays">The cutoff date; observations with a timestamp before this value are removed.</param>
+        /// <!-- aidoc:v1 sig=f776d6a body=426aa60 -->
         public async Task DeleteBeforeDate(DateTime addDays)
                 {
                     var filter = Builders<PumpObservation>.Filter.Lt(x => x.Time, addDays);
diff --git a/adas-core.Infrastructure/Repositories/PumpObservationRepository.cs b/adas-core.Infrastructure/Repositories/PumpObservationRepository.cs
index 94d016ff..21671d02 100644
--- a/adas-core.Infrastructure/Repositories/PumpObservationRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PumpObservationRepository.cs
@@ -17,6 +17,8 @@ namespace adas_core.Infrastructure.Repositories
     /// As a specialized repository inheriting from <see cref="MongoRepository{PumpObservation}"/>, this class
     /// reuses the base MongoDB storage capabilities while exposing the pump observation-specific repository contract.
     /// </remarks>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The <typeparam name=\"PumpObservation\"> tag is incorrect: PumpObservationRepository is not a generic class, so it has no type parameters." -->
     public class PumpObservationRepository : MongoRepository<PumpObservation>, IPumpObservationRepository
     {
         private readonly ApiSettings _apiSettings;
@@ -38,6 +40,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Retrieves the collection name used for pump observations, returning the configured value from API settings if available, or falling back to the default "pump_observations" name when no custom configuration is provided.
         /// </summary>
         /// <returns>The configured pump observations collection name from API settings, or the default "pump_observations" string if the setting is null.</returns>
+        /// <!-- aidoc:v1 sig=94e22ff body=711309f -->
         public override string GetCollectionName()
                 {
                     return _apiSettings.PumpObservations ?? "pump_observations";
@@ -77,6 +80,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Asynchronously inserts a pump observation into the underlying collection.
         /// </summary>
         /// <param name="obs">The pump observation document to be persisted.</param>
+        /// <!-- aidoc:v1 sig=2e9b63d body=ff40c9a -->
         public async Task InsertAsync(PumpObservation obs)
                 {
                     await Collection.InsertOneAsync(obs);
@@ -86,6 +90,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Inserts a batch of pump observations into the underlying collection in a single operation. Returns immediately when the input is null or contains no elements, performing no insertion in those cases.
         /// </summary>
         /// <param name="observations">The pump observations to insert. A null or empty collection results in a no-op.</param>
+        /// <!-- aidoc:v1 sig=9b8dfd0 body=13df81e -->
         public async Task InsertManyAsync(IEnumerable<PumpObservation>? observations)
                 {
                     if (observations == null) return;
@@ -104,6 +109,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="to">Optional end timestamp; when provided, only observations with a time less than or equal to this value are returned.</param>
         /// <param name="limit">Optional maximum number of observations to return; when not provided, all matching observations are returned.</param>
         /// <returns>A task that represents the asynchronous operation, containing the collection of matching <see cref="PumpObservation"/> records.</returns>
+        /// <!-- aidoc:v1 sig=c4c17bd body=fccb1f4 -->
         public async Task<IEnumerable<PumpObservation>> FindByDeviceIdAsync(
                     string deviceId,
                     DateTime? from = null,
@@ -136,6 +142,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="to">Optional inclusive upper bound for the observation time. When null, no upper time bound is applied.</param>
         /// <param name="limit">Optional maximum number of observations to return. When null, all matching observations are returned.</param>
         /// <returns>A task that represents the asynchronous operation. The task result contains the matching pump observations sorted by time in descending order.</returns>
+        /// <!-- aidoc:v1 sig=7a9379f body=b1db477 -->
         public async Task<IEnumerable<PumpObservation>> FindByPatientAsync(
                     ObjectId patientId,
                     DateTime? from = null,
@@ -205,6 +212,7 @@ namespace adas_core.Infrastructure.Repositories
         /// </summary>
         /// <param name="deviceId">The unique identifier of the device whose latest pump observation should be retrieved.</param>
         /// <returns>A task that resolves to the most recent <see cref="PumpObservation"/> for the device, or <c>null</c> if no observation is found.</returns>
+        /// <!-- aidoc:v1 sig=c025146 body=088b34a -->
         public async Task<PumpObservation?> FindLastByDeviceIdAsync(string deviceId)
                 {
                     return await Collection
@@ -218,6 +226,7 @@ namespace adas_core.Infrastructure.Repositories
         /// </summary>
         /// <param name="patientId">The optional patient identifier used to filter the pump observations.</param>
         /// <returns>A task that represents the asynchronous operation, containing a collection of pump observations matching the given patient identifier.</returns>
+        /// <!-- aidoc:v1 sig=db5b147 body=51d8815 -->
         public async Task<IEnumerable<PumpObservation>> FindByPatientId(ObjectId? patientId)
                 {
                     return await Collection.Find(x => x.PatientId == patientId).ToListAsync();
@@ -230,6 +239,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="patientId">The identifier of the patient whose observations are being retrieved.</param>
         /// <param name="num">The maximum number of observations to consider before deduplication. Defaults to 100.</param>
         /// <returns>A task that represents the asynchronous operation. The task result contains a list of distinct <see cref="PumpObservation"/> entries for the patient, ordered from most recent to oldest.</returns>
+        /// <!-- aidoc:v1 sig=0c8097f body=4281403 -->
         public async Task<List<PumpObservation>> AggregatedPatientLastObservations(ObjectId patientId, int num = 100)
                 {
                     var filterBuilder = Builders<PumpObservation>.Filter;
@@ -252,6 +262,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Deletes all records whose <c>PatientId</c> matches the specified patient identifier.
         /// </summary>
         /// <param name="patientId">The patient identifier whose associated records should be removed; may be <c>null</c>.</param>
+        /// <!-- aidoc:v1 sig=e8c536a body=395df12 -->
         public async Task DeleteByPatientId(ObjectId? patientId)
                 {
                     await Collection.DeleteManyAsync(x => x.PatientId == patientId);
@@ -264,6 +275,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="days">The age threshold in days. Observations with a <c>Time</c> older than <c>DateTime.UtcNow - days</c> are eligible for deletion.</param>
         /// <param name="name">Optional name used to further restrict the deletion to observations with a matching <c>Name</c> value. If null or empty, the name filter is not applied.</param>
         /// <returns>The number of <see cref="PumpObservation"/> documents that were deleted.</returns>
+        /// <!-- aidoc:v1 sig=102a371 body=9c5bcf4 -->
         public async Task<long> DeleteOlderThanDaysAsync(int days, string? name = null)
                 {
                     var limitDate = DateTime.UtcNow.AddDays(-days);
@@ -281,6 +293,7 @@ namespace adas_core.Infrastructure.Repositories
         /// </summary>
         /// <param name="maxCount">The maximum number of most recent records to keep per device.</param>
         /// <returns>The total number of observations deleted across all devices.</returns>
+        /// <!-- aidoc:v1 sig=295122a body=e030407 -->
         public async Task<long> DeleteKeepLastNAsync(int maxCount)
                 {
                     // Para cada DeviceId:
@@ -320,6 +333,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="oldId">The current <see cref="ObjectId"/> value used to match documents; if <c>null</c>, the filter matches documents where the field is null.</param>
         /// <returns>The number of documents that were modified by the update operation.</returns>
         /// <exception cref="ArgumentException">Thrown when <paramref name="fieldName"/> is null, empty, or whitespace.</exception>
+        /// <!-- aidoc:v1 sig=260cb78 body=f2c2192 -->
         public async Task<long> UpdateManyObjectIdByFieldAsync(string fieldName, ObjectId newId, ObjectId? oldId)
                 {
                     if (string.IsNullOrWhiteSpace(fieldName))
@@ -386,6 +400,7 @@ namespace adas_core.Infrastructure.Repositories
         /// <param name="patientId">The unique identifier of the patient whose observations are being queried.</param>
         /// <param name="name">The name of the pump observation to filter by. If null, empty, or whitespace, an empty list is returned.</param>
         /// <returns>A task representing the asynchronous operation, containing a list of the matching pump observations (at most two) sorted from newest to oldest.</returns>
+        /// <!-- aidoc:v1 sig=2ba6244 body=efdef74 -->
         public async Task<List<PumpObservation>> FindLastObservations(ObjectId patientId, string name)
                 {
                     if (string.IsNullOrWhiteSpace(name))
diff --git a/adas-core.Infrastructure/Repositories/PumpStateRepository.cs b/adas-core.Infrastructure/Repositories/PumpStateRepository.cs
index b3967818..747dae8c 100644
--- a/adas-core.Infrastructure/Repositories/PumpStateRepository.cs
+++ b/adas-core.Infrastructure/Repositories/PumpStateRepository.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Repositories
     /// Provides a repository implementation for <see cref="PumpState"/> entities backed by a MongoDB data store.
     /// </summary>
     /// <remarks>Inherits base functionality from <see cref="MongoRepository{T}"/> and implements the <see cref="IPumpStateRepository"/> contract.</remarks>
+    /// <!-- aidoc:v1 sig=e8fa3b3 -->
     public class PumpStateRepository : MongoRepository<PumpState>, IPumpStateRepository
     {
         private readonly ApiSettings _apiSettings;
@@ -32,6 +33,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Retrieves the collection name for pump states, returning the configured value from API settings or the default name "pump_states" when the setting is not provided.
         /// </summary>
         /// <returns>The configured pump states collection name, or the default value "pump_states" if the setting is null.</returns>
+        /// <!-- aidoc:v1 sig=94e22ff body=31eaf80 -->
         public override string GetCollectionName()
                 {
                     return _apiSettings.PumpStates ?? "pump_states";
@@ -71,6 +73,7 @@ namespace adas_core.Infrastructure.Repositories
         /// </summary>
         /// <param name="deviceId">The unique identifier of the device whose pump state should be looked up.</param>
         /// <returns>A <see cref="PumpState"/> instance if a matching record is found; otherwise, null.</returns>
+        /// <!-- aidoc:v1 sig=bab429b body=ea4c529 -->
         public async Task<PumpState?> FindByDeviceIdAsync(string deviceId)
                 {
                     return await Collection.Find(x => x.DeviceId == deviceId).FirstOrDefaultAsync();
@@ -80,6 +83,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Inserts the specified <see cref="PumpState"/> or updates the existing one identified by its <c>DeviceId</c>. If a matching record is found, its identifier is reused; otherwise a new identifier is generated when the provided one is empty.
         /// </summary>
         /// <param name="state">The pump state to persist. Its <c>Id</c> is preserved or assigned based on whether a record with the same <c>DeviceId</c> already exists.</param>
+        /// <!-- aidoc:v1 sig=5ce0824 body=9517005 -->
         public async Task UpsertAsync(PumpState state)
                 {
                     var existing = await Collection
@@ -102,6 +106,7 @@ namespace adas_core.Infrastructure.Repositories
         /// Asynchronously retrieves all <see cref="PumpState"/> records from the data store.
         /// </summary>
         /// <returns>A task that represents the asynchronous operation, containing an <see cref="IEnumerable{T}"/> of all <see cref="PumpState"/> records; an empty collection is returned if no records exist.</returns>
+        /// <!-- aidoc:v1 sig=22c3173 body=c62f88b -->
         public async Task<IEnumerable<PumpState>> GetAllAsync()
                 {
                     return await Collection.Find(Builders<PumpState>.Filter.Empty).ToListAsync();
diff --git a/adas-core.Infrastructure/Repositories/RecordingAlertArchiveRepository.cs b/adas-core.Infrastructure/Repositories/RecordingAlertArchiveRepository.cs
index 8e6cd970..c4c70f02 100644
--- a/adas-core.Infrastructure/Repositories/RecordingAlertArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/RecordingAlertArchiveRepository.cs
@@ -10,6 +10,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// Represents a MongoDB repository responsible for managing archived patient recording alerts, exposing archive-specific data access operations through the recording alert archive repository contract.
 /// </summary>
 /// <typeparam name="PatientRecordingAlert">The type of the patient recording alert entity persisted in the archive.</typeparam>
+/// <!-- aidoc-review:v1 severity=low kind=extra_param
+///      "The <typeparam name=\"PatientRecordingAlert\"> tag is applied to a non-generic class; RecordingAlertArchiveRepository declares no type parameters of its own. The type parameter belongs to the base class MongoRepository<PatientRecordingAlert> and should not appear on this type's documentation." -->
 public class RecordingAlertArchiveRepository : MongoRepository<PatientRecordingAlert>, IRecordingAlertArchiveRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -34,6 +36,7 @@ public class RecordingAlertArchiveRepository : MongoRepository<PatientRecordingA
     /// Gets the collection name for archive patients recording alerts, returning the configured value from API settings or a default name when no setting is provided.
     /// </summary>
     /// <returns>The configured collection name from <c>_apiSettings.ArchivePatientsRecordingalerts</c>, or the default "archive_patients_recordingalerts" if the setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=36b86be -->
     public override string GetCollectionName()
         {
             return _apiSettings.ArchivePatientsRecordingalerts ?? "archive_patients_recordingalerts";
@@ -43,6 +46,7 @@ public class RecordingAlertArchiveRepository : MongoRepository<PatientRecordingA
     /// Asynchronously inserts a new <see cref="PatientRecordingAlert"/> into the underlying collection.
     /// </summary>
     /// <param name="patientRecordingAlert">The patient recording alert document to persist.</param>
+    /// <!-- aidoc:v1 sig=ca2ca36 body=578d26d -->
     public override async Task InsertOneAsync(PatientRecordingAlert patientRecordingAlert)
         {
             await Collection.InsertOneAsync(patientRecordingAlert);
@@ -52,6 +56,7 @@ public class RecordingAlertArchiveRepository : MongoRepository<PatientRecordingA
     /// Deletes all <see cref="PatientRecordingAlert"/> records whose <c>Time</c> is earlier than the specified cutoff date.
     /// </summary>
     /// <param name="date">The cutoff date; records with a time strictly before this value will be removed.</param>
+    /// <!-- aidoc:v1 sig=63daa66 body=62825db -->
     public async Task DeleteBeforeDate(DateTime date)
         {
             var filter = Builders<PatientRecordingAlert>.Filter.Lt(po => po.Time, date);
@@ -63,6 +68,7 @@ public class RecordingAlertArchiveRepository : MongoRepository<PatientRecordingA
     /// </summary>
     /// <param name="patientRecordingAlerts">The patient recording alerts to insert into the collection.</param>
     /// <returns>The number of patient recording alerts that were inserted.</returns>
+    /// <!-- aidoc:v1 sig=3442916 body=ee3b5e0 -->
     public async Task<long> InsertBatch(IEnumerable<PatientRecordingAlert> patientRecordingAlerts)
         {
             var writes = new List<WriteModel<PatientRecordingAlert>>();
diff --git a/adas-core.Infrastructure/Repositories/RecordingAlertRepository.cs b/adas-core.Infrastructure/Repositories/RecordingAlertRepository.cs
index 047ad6da..3d7ef46f 100644
--- a/adas-core.Infrastructure/Repositories/RecordingAlertRepository.cs
+++ b/adas-core.Infrastructure/Repositories/RecordingAlertRepository.cs
@@ -14,6 +14,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// Provides a MongoDB-backed repository implementation for <see cref="PatientRecordingAlert"/> entities, exposing data access operations defined by the <see cref="IRecordingAlertRepository"/> contract.
 /// </summary>
 /// <typeparam name="PatientRecordingAlert">The type of recording alert entity managed by the repository.</typeparam>
+/// <!-- aidoc-review:v1 severity=medium kind=extra_param
+///      "RecordingAlertRepository is a non-generic class that inherits from MongoRepository<PatientRecordingAlert>; the <typeparam name=\"PatientRecordingAlert\"> tag does not belong to this class and should be removed." -->
 public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>, IRecordingAlertRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -37,6 +39,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// Retrieves the collection name for patients recording alerts, returning the configured API setting value or a default fallback when the setting is not available.
     /// </summary>
     /// <returns>The collection name from <c>_apiSettings.PatientsRecordingAlerts</c>, or the default value "patients_recordingalerts" if the setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=86753ae -->
     public override string GetCollectionName()
         {
             return _apiSettings.PatientsRecordingAlerts ?? "patients_recordingalerts";
@@ -49,6 +52,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// <param name="patientId">The unique identifier of the patient whose observations are being retrieved.</param>
     /// <param name="num">The maximum number of recent observations to return per grouped observation name.</param>
     /// <returns>A task containing a list of <see cref="PatientRecordingAlert"/> objects representing the aggregated last observations for the patient.</returns>
+    /// <!-- aidoc:v1 sig=7ba8251 body=28f8b50 -->
     public async Task<List<PatientRecordingAlert>> AggregatedPatientLastObservations(ObjectId patientId, int num)
         {
             var match = new BsonDocument
@@ -132,6 +136,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// Deletes a patient recording alert identified by the specified identifier from the underlying collection.
     /// </summary>
     /// <param name="id">The unique identifier of the patient recording alert to delete.</param>
+    /// <!-- aidoc:v1 sig=78c6c5d body=e746d33 -->
     public new async Task DeleteAsync(ObjectId id)
         {
             var filter = Builders<PatientRecordingAlert>.Filter.Eq(obs => obs.Id, id);
@@ -143,6 +148,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// Inserts a new patient recording alert into the underlying collection asynchronously.
     /// </summary>
     /// <param name="patientRecordingAlert">The patient recording alert document to be inserted.</param>
+    /// <!-- aidoc:v1 sig=ca2ca36 body=578d26d -->
     public override async Task InsertOneAsync(PatientRecordingAlert patientRecordingAlert)
         {
             await Collection.InsertOneAsync(patientRecordingAlert);
@@ -153,6 +159,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// </summary>
     /// <param name="name">The name of the patient recording alert used to match the document for deletion.</param>
     /// <param name="retentionPolicyValue">The retention period in days; the cutoff time is calculated as UTC now minus this number of days.</param>
+    /// <!-- aidoc:v1 sig=f57ae81 body=38e47b8 -->
     public async Task DeleteOlderDaysAsync(string name, int retentionPolicyValue)
         {
             var filterBuilder = Builders<PatientRecordingAlert>.Filter;
@@ -169,6 +176,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// Deletes all patient recording alerts associated with the specified patient identifier.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose recording alerts will be removed.</param>
+    /// <!-- aidoc:v1 sig=4776e51 body=7caf6e5 -->
     public async Task DeleteByPatientId(ObjectId patientId)
         {
             var filter = Builders<PatientRecordingAlert>.Filter.Eq(po => po.PatientId, patientId);
@@ -181,6 +189,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// </summary>
     /// <param name="name">The name used to filter the alerts subject to the retention policy.</param>
     /// <param name="retentionPolicyValue">The number of most recent records to retain; any additional older records will be deleted.</param>
+    /// <!-- aidoc:v1 sig=c937e38 body=7d9fe21 -->
     public async Task DeleteOlderNumberAsync(string name, int retentionPolicyValue)
         {
             var filterBuilder = Builders<PatientRecordingAlert>.Filter;
@@ -211,6 +220,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose recording alerts should be retrieved.</param>
     /// <returns>A task representing the asynchronous operation, containing a cursor over the matching patient recording alerts.</returns>
+    /// <!-- aidoc:v1 sig=e63f91e body=0dc65bb -->
     public async Task<IAsyncCursor<PatientRecordingAlert>> FindByPatientIdAsync(ObjectId patientId)
         {
             var filter = Builders<PatientRecordingAlert>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -225,6 +235,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// <param name="name">The name of the observation used to filter the results.</param>
     /// <param name="num">The maximum number of observations to return. Defaults to 2.</param>
     /// <returns>A list of <see cref="PatientRecordingAlert"/> entries containing the latest matching observations for the patient.</returns>
+    /// <!-- aidoc:v1 sig=47628d4 body=4ebb0f9 -->
     public async Task<List<PatientRecordingAlert>> FindLastObservations(ObjectId patientId, string name, int num = 2)
         {
             var filterBuilder = Builders<PatientRecordingAlert>.Filter;
@@ -256,6 +267,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// <param name="nameId">The identifier of the field or collection used to target the records to update.</param>
     /// <param name="id">The new <see cref="ObjectId"/> value to assign to the matched records.</param>
     /// <param name="oldId">The existing <see cref="ObjectId"/> value to be replaced.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=b9b81e9 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
         {
             await UpdateManyObjectIdAsync(nameId, id, oldId);
@@ -264,6 +276,7 @@ public class RecordingAlertRepository : MongoRepository<PatientRecordingAlert>,
     /// <summary>
     /// Creates MongoDB indexes for the PatientRecordingAlert collection, including a non-unique background index on the patientid field to optimize queries by patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=04093f9 -->
     public override async Task CreateIndexes()
         {
             var options = new CreateIndexOptions { Background = true, Unique = false };
diff --git a/adas-core.Infrastructure/Repositories/RelayRepository.cs b/adas-core.Infrastructure/Repositories/RelayRepository.cs
index 9d2f65b4..c98ae640 100644
--- a/adas-core.Infrastructure/Repositories/RelayRepository.cs
+++ b/adas-core.Infrastructure/Repositories/RelayRepository.cs
@@ -17,6 +17,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// </summary>
 /// <typeparam name="Relay">The type of the entity managed by the repository.</typeparam>
 /// <remarks>This class combines a concrete MongoDB repository implementation with a domain-specific interface, enabling standardized persistence operations for relay entities.</remarks>
+/// <!-- aidoc-review:v1 severity=high kind=extra_param
+///      "RelayRepository is not a generic class (declared as 'public class RelayRepository : MongoRepository<Relay>, IRelayRepository'), so the <typeparam name='Relay'> tag is invalid. Relay is a concrete type used as the type argument to the base class, not a type parameter of RelayRepository." -->
 public class RelayRepository : MongoRepository<Relay>, IRelayRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -38,6 +40,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// Retrieves the collection name for relays from the API settings configuration.
     /// </summary>
     /// <returns>The configured relays collection name as specified in the API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=c6df698 -->
     public override string GetCollectionName()
         {
             return _apiSettings.Relays;
@@ -48,6 +51,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay to look up.</param>
     /// <returns>The matching <see cref="Relay"/>, or <c>null</c> if no document matches the identifier or the query fails.</returns>
+    /// <!-- aidoc:v1 sig=3807664 body=f06b9f2 -->
     public async Task<Relay?> GetById(ObjectId relayId)
         {
             try
@@ -69,6 +73,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// <param name="configurationRelayList">The collection of relay identifiers used to filter relays by their Id field.</param>
     /// <param name="type">The relay type used as an equality filter on the Type field.</param>
     /// <returns>A list of <see cref="Relay"/> instances matching both the identifier and type filters; an empty list is returned when no relays match.</returns>
+    /// <!-- aidoc:v1 sig=ef9043b body=3a8764d -->
     public List<Relay> GetRelayByTypeInList(List<ObjectId> configurationRelayList, RelayEnum.Type type)
         {
             var filterBuilder = Builders<Relay>.Filter;
@@ -86,6 +91,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// </summary>
     /// <param name="configurationRelayList">The collection of <see cref="ObjectId"/> values used to match relays by their <c>Id</c> field.</param>
     /// <returns>A <see cref="List{Relay}"/> containing the relays whose identifiers are found in <paramref name="configurationRelayList"/>; an empty list is returned when no matching relays exist.</returns>
+    /// <!-- aidoc:v1 sig=262306c body=ab06cc9 -->
     public List<Relay> GetRelayInList(List<ObjectId> configurationRelayList)
         {
             var filterBuilder = Builders<Relay>.Filter;
@@ -102,6 +108,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// </summary>
     /// <param name="filter">The pagination criteria containing the optional text filter applied against the relay name.</param>
     /// <returns>A fluent find query for <see cref="Relay"/> entities, ordered by relay name in ascending order, ready for further pagination.</returns>
+    /// <!-- aidoc:v1 sig=6da9abe body=35a5fce -->
     public IFindFluent<Relay, Relay> GetPaginatedRelays(PaginationFilter filter)
         {
             var filterBuilder = Builders<Relay>.Filter;
@@ -132,6 +139,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// </summary>
     /// <param name="request">The relay entity to insert into the collection.</param>
     /// <returns>The inserted relay retrieved by its identifier, or <c>null</c> if the insertion fails.</returns>
+    /// <!-- aidoc:v1 sig=79b3c83 body=60b6b6c -->
     public async Task<Relay?> InsertOneRelayAsync(Relay request)
         {
             try
@@ -154,6 +162,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// <param name="objectId">The unique identifier of the relay document to update in the collection.</param>
     /// <param name="relay">The relay instance containing the new values to apply to the existing document.</param>
     /// <returns>A task that represents the asynchronous operation, containing the updated <see cref="Relay"/> after the update, or <c>null</c> if no matching document was found.</returns>
+    /// <!-- aidoc:v1 sig=2ca072d body=5a785d8 -->
     public async Task<Relay?> UpdateRelayAsync(ObjectId objectId, Relay relay)
         {
             var filter = Builders<Relay>.Filter.Eq("_id", objectId);
@@ -176,6 +185,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// </summary>
     /// <param name="requestRelayName">The name of the relay to look up. May be <c>null</c>, in which case the query matches relays with a null name.</param>
     /// <returns>A <see cref="Task{TResult}"/> containing the matching <see cref="Relay"/>, or <c>null</c> if no relay with the specified name is found.</returns>
+    /// <!-- aidoc:v1 sig=22f1a02 body=1a92d9a -->
     public async Task<Relay?> GetByName(string? requestRelayName)
         {
             var filterBuilder = Builders<Relay>.Filter;
@@ -191,6 +201,7 @@ public class RelayRepository : MongoRepository<Relay>, IRelayRepository
     /// <param name="filters">The list of filter definitions to combine; when empty, an empty filter is used to match all documents.</param>
     /// <param name="sort">The sort definition applied to the query results.</param>
     /// <returns>An <see cref="IFindFluent{TDocument, TProjection}"/> representing the filtered and sorted Relay query.</returns>
+    /// <!-- aidoc:v1 sig=e3578fc body=a377885 -->
     private IFindFluent<Relay, Relay> CreateFindFluent(List<FilterDefinition<Relay>> filters, SortDefinition<Relay> sort)
         {
             var combinedFilter = filters.Any()
diff --git a/adas-core.Infrastructure/Repositories/SectionRepository.cs b/adas-core.Infrastructure/Repositories/SectionRepository.cs
index 8176a710..c710ffc2 100644
--- a/adas-core.Infrastructure/Repositories/SectionRepository.cs
+++ b/adas-core.Infrastructure/Repositories/SectionRepository.cs
@@ -14,6 +14,8 @@ namespace adas_core.Infrastructure.Repositories;
 /// implementing the contract defined by <see cref="ISectionRepository"/>.
 /// </summary>
 /// <typeparam name="Section">The type of the section entity managed by this repository.</typeparam>
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The documentation uses <typeparamref name='Section'/> in the summary and declares a <typeparam name='Section'> element on a non-generic class, misrepresenting the class as having a type parameter when Section is only a type argument to the generic base class MongoRepository<Section>." -->
 public class SectionRepository : MongoRepository<Section>, ISectionRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -38,6 +40,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// Gets the configuration sections collection name from the API settings, falling back to a default value when not configured.
     /// </summary>
     /// <returns>The configured collection name, or "config_sections" if <c>_apiSettings.ConfigSections</c> is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=538109a -->
     public override string GetCollectionName()
         {
             return _apiSettings.ConfigSections ?? "config_sections";
@@ -47,6 +50,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// Retrieves all <see cref="Section"/> documents from the underlying collection by querying with an empty filter.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Section"/> documents found in the collection.</returns>
+    /// <!-- aidoc:v1 sig=c63d5ab body=5e7c572 -->
     public async Task<List<Section>> GetAll()
         {
             var result = await Collection.FindAsync(Builders<Section>.Filter.Empty);
@@ -59,6 +63,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="section">The section title used to look up the matching <see cref="Section"/>.</param>
     /// <returns>The first matching <see cref="Section"/>, or <c>null</c> if no section with the given title is found.</returns>
+    /// <!-- aidoc:v1 sig=657d14e body=7fd0ba3 -->
     public async Task<Section?> FindBySection(string section)
         {
             var result = await Collection.FindAsync(Builders<Section>.Filter.Eq(x => x.SectionTitle, section));
@@ -71,6 +76,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="pointOfCare">The point of care identifier used to filter the sections.</param>
     /// <returns>The first matching <see cref="Section"/>, or <c>null</c> if no section is found.</returns>
+    /// <!-- aidoc:v1 sig=a604321 body=7d830b2 -->
     public async Task<Section?> FindByPointOfCare(string pointOfCare)
         {
             var result = await Collection.FindAsync(Builders<Section>.Filter.Eq(x => x.PointOfCare, pointOfCare));
@@ -84,6 +90,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="id">The unique identifier of the section to retrieve.</param>
     /// <returns>A task containing the matching <see cref="Section"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=b74d29e body=35f3782 -->
     public async Task<Section?> FindById(string id)
         {
             var result = await Collection.FindAsync(Builders<Section>.Filter.Eq(x => x.Id, id));
@@ -96,6 +103,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="id">The identifier of the section to locate.</param>
     /// <returns>A <see cref="Section"/> instance if a document with the given identifier exists; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=d503cfd body=43632c9 -->
     public async Task<Section?> FindById(object id)
         {
             var result = await Collection.FindAsync(Builders<Section>.Filter.Eq(x => x._id, id));
@@ -109,6 +117,8 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="location">The patient location containing the unit name and bed used to locate the corresponding sections.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of sections matching the provided patient location; an empty list is returned when no matching sections are found.</returns>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary refers to 'active sections,' but the code only checks `box.IsActive`; the sections themselves are not filtered by any active state." -->
     public async Task<List<Section>> FindByLocation(PatientLocation location)
         {
             //can not filter to Collection the where condition, it throws System.InvalidOperationException: '{}.pointOfCare is not supported.'
@@ -128,6 +138,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="section">The section to insert into the collection.</param>
     /// <returns>The inserted <see cref="Section"/> on success, or <c>null</c> if the operation fails.</returns>
+    /// <!-- aidoc:v1 sig=6e6c338 body=c888f94 -->
     public async Task<Section?> InsertOneSection(Section section)
         {
             try
@@ -151,6 +162,7 @@ public class SectionRepository : MongoRepository<Section>, ISectionRepository
     /// </summary>
     /// <param name="section">The section containing the identifier of the record to update and the new field values to persist.</param>
     /// <returns>The updated <see cref="Section"/> as it appears after the update, or <see langword="null"/> if no matching record was found.</returns>
+    /// <!-- aidoc:v1 sig=21df1de body=d447f33 -->
     public async Task<Section?> UpdateSection(Section section)
         {
             var filter = Builders<Section>.Filter.Eq("Id", section.Id);
diff --git a/adas-core.Infrastructure/Repositories/ServiceConfigRepository.cs b/adas-core.Infrastructure/Repositories/ServiceConfigRepository.cs
index fc99a4a1..e71b415a 100644
--- a/adas-core.Infrastructure/Repositories/ServiceConfigRepository.cs
+++ b/adas-core.Infrastructure/Repositories/ServiceConfigRepository.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Represents a MongoDB repository for <see cref="ServiceConfig"/> entities, implementing the <see cref="IServiceConfigRepository"/> contract to provide data access operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=1c7de6e -->
 public class ServiceConfigRepository : MongoRepository<ServiceConfig>, IServiceConfigRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -33,6 +34,7 @@ public class ServiceConfigRepository : MongoRepository<ServiceConfig>, IServiceC
     /// Retrieves the service configuration collection name from API settings, falling back to the default "service_config" when no value is configured.
     /// </summary>
     /// <returns>The configured service collection name, or the default "service_config" when the API setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=8cab977 -->
     public override string GetCollectionName()
         {
             return _apiSettings.ServiceConfig ?? "service_config";
@@ -44,6 +46,7 @@ public class ServiceConfigRepository : MongoRepository<ServiceConfig>, IServiceC
     /// </summary>
     /// <param name="id">The string identifier used to look up the service configuration.</param>
     /// <returns>A task that represents the asynchronous operation, containing the matching <see cref="ServiceConfig"/> or <c>null</c> if not found.</returns>
+    /// <!-- aidoc:v1 sig=ea95853 body=ad0ec9c -->
     public async Task<ServiceConfig?> FindById(string id)
         {
             var result = await Collection.FindAsync(Builders<ServiceConfig>.Filter.Eq(x => x.StrId, id));
@@ -56,6 +59,7 @@ public class ServiceConfigRepository : MongoRepository<ServiceConfig>, IServiceC
     /// </summary>
     /// <param name="oid">The <see cref="ObjectId"/> of the <see cref="ServiceConfig"/> to locate.</param>
     /// <returns>A <see cref="ServiceConfig"/> instance if a document with the given identifier is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=66de090 body=218bdce -->
     public async Task<ServiceConfig?> FindById(ObjectId oid)
         {
             var result = await Collection.FindAsync(Builders<ServiceConfig>.Filter.Eq(x => x.Id, oid));
diff --git a/adas-core.Infrastructure/Repositories/TreatmentArchiveRepository.cs b/adas-core.Infrastructure/Repositories/TreatmentArchiveRepository.cs
index 65b93a3b..9bd33039 100644
--- a/adas-core.Infrastructure/Repositories/TreatmentArchiveRepository.cs
+++ b/adas-core.Infrastructure/Repositories/TreatmentArchiveRepository.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// Provides a MongoDB-backed repository for persisting and retrieving archived patient treatment records.
 /// Inherits from <see cref="MongoRepository{PatientTreatment}"/> and implements the <see cref="ITreatmentArchiveRepository"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=00919c4 -->
 public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITreatmentArchiveRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -34,6 +35,7 @@ public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITr
     /// Asynchronously inserts a single <see cref="PatientTreatment"/> document into the collection.
     /// </summary>
     /// <param name="patientTreatment">The patient treatment entity to persist.</param>
+    /// <!-- aidoc:v1 sig=817004e body=78ae787 -->
     public override async Task InsertOneAsync(PatientTreatment patientTreatment)
         {
             await Collection.InsertOneAsync(patientTreatment);
@@ -43,6 +45,7 @@ public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITr
     /// Deletes all patient treatments whose order time is before the specified date.
     /// </summary>
     /// <param name="date">The cutoff date; treatments with an order time earlier than this are removed.</param>
+    /// <!-- aidoc:v1 sig=63daa66 body=62a2131 -->
     public async Task DeleteBeforeDate(DateTime date)
         {
             var filter = Builders<PatientTreatment>.Filter.Lt(po => po.OrderTime, date);
@@ -54,6 +57,7 @@ public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITr
     /// </summary>
     /// <param name="treatments">The collection of patient treatment records to insert into the database.</param>
     /// <returns>The total count of patient treatment records inserted by the bulk write operation.</returns>
+    /// <!-- aidoc:v1 sig=5327a55 body=14e0e13 -->
     public async Task<long> InsertBatch(IEnumerable<PatientTreatment> treatments)
         {
             var writes = new List<WriteModel<PatientTreatment>>();
@@ -69,6 +73,7 @@ public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITr
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatment records are to be retrieved.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> records matching the specified patient.</returns>
+    /// <!-- aidoc:v1 sig=26634ec body=cdc309e -->
     public async Task<List<PatientTreatment>> FindAllFromPatient(ObjectId patientId)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(t => t.PatientId, patientId);
@@ -81,6 +86,7 @@ public class TreatmentArchiveRepository : MongoRepository<PatientTreatment>, ITr
     /// Retrieves the collection name for archive patients treatments, falling back to the default "archive_patients_treatments" value when the API settings do not specify one.
     /// </summary>
     /// <returns>The configured collection name from the API settings, or the default "archive_patients_treatments" if the setting is null.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=a88c4fb -->
     public override string GetCollectionName()
         {
             return _apiSettings.ArchivePatientsTreatments ?? "archive_patients_treatments";
diff --git a/adas-core.Infrastructure/Repositories/TreatmentRepository.cs b/adas-core.Infrastructure/Repositories/TreatmentRepository.cs
index 3ff1e7f6..fbd80559 100644
--- a/adas-core.Infrastructure/Repositories/TreatmentRepository.cs
+++ b/adas-core.Infrastructure/Repositories/TreatmentRepository.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Represents a MongoDB-backed repository for <see cref="PatientTreatment"/> entities, inheriting common data access functionality from <see cref="MongoRepository{T}"/> and implementing the <see cref="ITreatmentRepository"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=ff348dc -->
 public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatmentRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -37,6 +38,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// Retrieves the collection name for patients treatments, using the value configured in API settings or falling back to the default "patients_treatments" when the setting is not specified.
     /// </summary>
     /// <returns>The configured patients treatments collection name, or "patients_treatments" if no setting is defined.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=9f934d7 -->
     public override string GetCollectionName()
         {
             return _apiSettings.PatientsTreatments ?? "patients_treatments";
@@ -47,6 +49,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose treatments are being queried.</param>
     /// <returns>A collection of <see cref="PatientTreatment"/> records matching the specified patient identifier.</returns>
+    /// <!-- aidoc:v1 sig=378ba8a body=7965a74 -->
     public async Task<IEnumerable<PatientTreatment>> GetByPatientId(ObjectId patientId)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -59,6 +62,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="id">The unique identifier of the patient treatment to locate.</param>
     /// <returns>An asynchronous cursor containing the patient treatment matching the provided identifier.</returns>
+    /// <!-- aidoc:v1 sig=9df111b body=2d38c53 -->
     public async Task<IAsyncCursor<PatientTreatment>> GetById(ObjectId id)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(ob => ob.Id, id);
@@ -70,6 +74,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// Inserts a patient treatment record, defaulting the order time to the current UTC time when it is not already set.
     /// </summary>
     /// <param name="treatment">The patient treatment to insert.</param>
+    /// <!-- aidoc:v1 sig=e510e9e body=e2feaed -->
     public override async Task InsertOneAsync(PatientTreatment treatment)
         {
             treatment.OrderTime ??= DateTime.UtcNow;
@@ -80,6 +85,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// Deletes a patient treatment record from the database by its unique identifier.
     /// </summary>
     /// <param name="id">The unique identifier of the patient treatment to remove.</param>
+    /// <!-- aidoc:v1 sig=78c6c5d body=ffccab9 -->
     public new async Task DeleteAsync(ObjectId id)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(ob => ob.Id, id);
@@ -92,6 +98,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="patientId">The unique ObjectId of the patient whose treatment records should be returned.</param>
     /// <returns>An <see cref="IAsyncCursor{TDocument}"/> of <see cref="PatientTreatment"/> containing the matching treatment records.</returns>
+    /// <!-- aidoc:v1 sig=2560a5d body=b55629b -->
     public async Task<IAsyncCursor<PatientTreatment>> FindByPatientIdAsync(ObjectId patientId)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -105,6 +112,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="patientId">The identifier of the patient whose treatment records should be removed.</param>
     /// <returns>A task that resolves to <c>true</c> on successful deletion, or <c>false</c> if the operation failed due to an exception.</returns>
+    /// <!-- aidoc:v1 sig=792a636 body=a3d746d -->
     public async Task<bool> DeleteByPatientId(ObjectId patientId)
         {
             try
@@ -126,6 +134,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="treatment">The patient treatment entity containing the updated information, identified by its <c>Id</c>.</param>
     /// <returns><c>true</c> if the update succeeds; otherwise, <c>false</c> if an exception occurs during the operation.</returns>
+    /// <!-- aidoc:v1 sig=c17e7d4 body=21b1397 -->
     public async Task<bool> Update(PatientTreatment treatment)
         {
             try
@@ -145,6 +154,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient whose bolus treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="PatientTreatment"/> documents matching the patient and having a non-empty <c>RequestedGiveCodesStatus</c>.</returns>
+    /// <!-- aidoc:v1 sig=cf3ed2a body=b450746 -->
     public async Task<List<PatientTreatment>> FindBolusTreatments(ObjectId patientId)
         {
             var builder = Builders<PatientTreatment>.Filter;
@@ -166,6 +176,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// <param name="patientId">The identifier of the patient whose treatments will be searched.</param>
     /// <param name="order">The entity identifier of the placer order used to match treatments.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the list of matching <see cref="PatientTreatment"/> entries.</returns>
+    /// <!-- aidoc:v1 sig=3821694 body=b830b97 -->
     public async Task<List<PatientTreatment>> GetActiveTreatmentsByPatientIdAndOrder(ObjectId patientId, string order)
         {
             var builder = Builders<PatientTreatment>.Filter;
@@ -193,6 +204,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// <param name="nameId">The name of the field or relationship whose object identifier should be updated.</param>
     /// <param name="id">The new object identifier to replace the old one with.</param>
     /// <param name="oldId">The existing object identifier that should be replaced.</param>
+    /// <!-- aidoc:v1 sig=72ce1ca body=b9b81e9 -->
     public async Task UpdateManyObjectId(string nameId, ObjectId id, ObjectId oldId)
         {
             await UpdateManyObjectIdAsync(nameId, id, oldId);
@@ -203,6 +215,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="patientId">The unique <see cref="ObjectId"/> of the patient whose treatments are being queried.</param>
     /// <returns>A task that represents the asynchronous operation, containing an <see cref="IEnumerable{PatientTreatment}"/> with the matching treatment records. Returns an empty sequence if no treatments are found.</returns>
+    /// <!-- aidoc:v1 sig=1aafccf body=7965a74 -->
     public async Task<IEnumerable<PatientTreatment>> FindByPatientId(ObjectId patientId)
         {
             var filter = Builders<PatientTreatment>.Filter.Eq(ob => ob.PatientId, patientId);
@@ -252,6 +265,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// <summary>
     /// Ensures the required MongoDB indexes exist for the <see cref="PatientTreatment"/> collection, creating a non-unique background index on the <c>patientid</c> field to optimize query performance without blocking other database operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4955da2 body=7b72bb5 -->
     public override async Task CreateIndexes()
         {
             var options = new CreateIndexOptions { Background = true, Unique = false };
@@ -268,6 +282,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// </summary>
     /// <param name="filters">The collection of filter definitions to which the active treatment criteria will be appended.</param>
     /// <param name="filterBuilder">The builder used to construct the individual filter conditions combined for the active treatment logic.</param>
+    /// <!-- aidoc:v1 sig=52a33ae body=7b0cd33 -->
     private static void AddActiveTreatmentFilters(List<FilterDefinition<PatientTreatment>> filters,
             FilterDefinitionBuilder<PatientTreatment> filterBuilder)
         {
@@ -311,6 +326,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// <param name="filters">The list of filter definitions to which the start and end time filters will be added.</param>
     /// <param name="filter">The pagination filter containing the optional start and end date values from the request.</param>
     /// <param name="filterBuilder">The filter definition builder used to construct the MongoDB filter expressions.</param>
+    /// <!-- aidoc:v1 sig=b6dabce body=a3424c3 -->
     private void AddDefaultTimeFilters(List<FilterDefinition<PatientTreatment>> filters, PaginationFilter filter,
             FilterDefinitionBuilder<PatientTreatment> filterBuilder)
         {
@@ -336,6 +352,7 @@ public class TreatmentRepository : MongoRepository<PatientTreatment>, ITreatment
     /// <param name="filters">The list of filter definitions to combine; if empty, an empty filter is used instead.</param>
     /// <param name="sort">The sort definition to apply to the query results.</param>
     /// <returns>An <see cref="IFindFluent{PatientTreatment, PatientTreatment}"/> representing the configured find query with the combined filter and sort applied.</returns>
+    /// <!-- aidoc:v1 sig=45f2edf body=8cd8049 -->
     private IFindFluent<PatientTreatment, PatientTreatment> CreateFindFluent(
             List<FilterDefinition<PatientTreatment>> filters, SortDefinition<PatientTreatment> sort)
         {
diff --git a/adas-core.Infrastructure/Repositories/UnitRepository.cs b/adas-core.Infrastructure/Repositories/UnitRepository.cs
index d947351d..927c0f91 100644
--- a/adas-core.Infrastructure/Repositories/UnitRepository.cs
+++ b/adas-core.Infrastructure/Repositories/UnitRepository.cs
@@ -16,6 +16,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <summary>
 /// Represents a MongoDB-backed repository for <see cref="Unit"/> entities, inheriting persistence functionality from <see cref="MongoRepository{Unit}"/> and implementing the <see cref="IUnitRepository"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=2997ff1 -->
 public class UnitRepository : MongoRepository<Unit>, IUnitRepository
 {
     #region Properties
@@ -51,6 +52,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="unit">The <see cref="Unit"/> to be inserted into the collection.</param>
     /// <returns>The inserted <see cref="Unit"/> as returned by the lookup by identifier, or <c>null</c> if an exception occurred during insertion.</returns>
+    /// <!-- aidoc:v1 sig=46b66ca body=55b385e -->
     public async Task<Unit?> InsertOneUnit(Unit unit)
         {
             try
@@ -75,6 +77,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// Gets the collection name for units, returning the configured value from API settings or falling back to the default "units" when not specified.
     /// </summary>
     /// <returns>The collection name for units, or "units" if no custom value is configured in the API settings.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=48f375a -->
     public override string GetCollectionName()
         {
             return _apiSettings.Units ?? "units";
@@ -94,6 +97,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="id">The identifier of the <see cref="Unit"/> to locate.</param>
     /// <returns>A <see cref="Unit"/> instance if a match is found; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=2cb132e body=4a4ce42 -->
     public async Task<Unit?> FindById(object id)
         {
             var result = await Collection.FindAsync(Builders<Unit>.Filter.Eq(x => x.Id, id));
@@ -106,6 +110,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// <param name="id">The unique identifier of the unit to look up.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the matching <see cref="Unit"/>, or <c>null</c> if no unit is found with the specified identifier.</returns>
     /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=b1966a7 body=bfa6f2f -->
     public Task<Unit?> FindById(string id)
         {
             throw new NotImplementedException();
@@ -144,6 +149,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the master list to search for across the unit's list reference fields.</param>
     /// <returns>A task that yields an <see cref="IEnumerable{Unit}"/> containing the matching units, or an empty list if no matches are found or an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=be856f1 body=b563580 -->
     public async Task<IEnumerable<Unit>> FindByMasterListId(ObjectId id)
         {
             try
@@ -196,6 +202,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// <param name="id">The <see cref="ObjectId"/> of the master list used to match units.</param>
     /// <param name="masterListType">The type of master list, which determines the property name used in the filter.</param>
     /// <returns>The total number of <see cref="Unit"/> documents that match the filter.</returns>
+    /// <!-- aidoc:v1 sig=22d5ac5 body=8e9b4d7 -->
     public async Task<long> CountUnitsByMasterListId(ObjectId id, MasterListType masterListType)
         {
             var propertyName = $"{masterListType}Id";
@@ -209,6 +216,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="unitName">The name of the unit to look up using an exact equality match.</param>
     /// <returns>A <see cref="Task{Unit?}"/> containing the matching <see cref="Unit"/> if found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=12e24aa body=ec93cdf -->
     public async Task<Unit?> FindByName(string unitName)
         {
             var result = await Collection.FindAsync(Builders<Unit>.Filter.Eq(x => x.Name, unitName));
@@ -241,6 +249,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// Asynchronously retrieves all <see cref="Unit"/> records from the underlying collection.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation, containing a list of all <see cref="Unit"/> documents found in the collection.</returns>
+    /// <!-- aidoc:v1 sig=b1cb9b5 body=bc87eac -->
     public async Task<List<Unit>> GetAll()
         {
             var result = await Collection.FindAsync(Builders<Unit>.Filter.Empty);
@@ -254,6 +263,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="filter">The pagination filter containing the optional text search criteria used to narrow the result set.</param>
     /// <returns>An <see cref="IFindFluent{Unit, Unit}"/> representing the sorted and filtered query of units; if no filter request is supplied, an unfiltered query sorted by title is returned.</returns>
+    /// <!-- aidoc:v1 sig=9b2e0d7 body=ec22e2e -->
     public IFindFluent<Unit, Unit> GetPaginatedUnits(PaginationFilter filter)
         {
             var filterBuilder = Builders<Unit>.Filter;
@@ -286,6 +296,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// <param name="filters">The list of filter definitions to combine with a logical AND; if empty, no filtering is applied.</param>
     /// <param name="sort">The sort definition to apply to the query results.</param>
     /// <returns>A fluent find interface for <see cref="Unit"/> that can be further chained to project, limit, or execute the query.</returns>
+    /// <!-- aidoc:v1 sig=ef193db body=8638b4d -->
     private IFindFluent<Unit, Unit> CreateFindFluent(List<FilterDefinition<Unit>> filters, SortDefinition<Unit> sort)
         {
             var combinedFilter = filters.Any()
@@ -304,6 +315,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="unit">The unit containing the identifier and the new field values to be persisted.</param>
     /// <returns>The updated unit after the operation, or null if no document matched the filter.</returns>
+    /// <!-- aidoc:v1 sig=2e95c1d body=72db12f -->
     public async Task<Unit?> UpdateUnit(Unit unit)
         {
             var filter = Builders<Unit>.Filter.Eq("_id", unit.Id);
@@ -343,6 +355,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// <param name="name">The new name to assign to the unit.</param>
     /// <param name="title">The new title to assign to the unit.</param>
     /// <returns>The updated <see cref="Unit"/> after the modification, or <c>null</c> if no matching unit was found.</returns>
+    /// <!-- aidoc:v1 sig=cb1f7cc body=764f8fb -->
     public async Task<Unit?> UpdateUnitInfo(ObjectId unitId, string name, string title)
         {
             var filter = Builders<Unit>.Filter.Eq("_id", unitId);
@@ -364,6 +377,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="updateUnitListDto">The DTO containing the target <c>UnitId</c> and the collection of master list entries to update.</param>
     /// <returns>The updated <see cref="Unit"/> after the modifications, or <c>null</c> if no updates were performed.</returns>
+    /// <!-- aidoc:v1 sig=303c1f2 body=9b5590e -->
     public async Task<Unit?> UpdateUnitMasterList(UpdateUnitIdListDto updateUnitListDto)
         {
             var filter = Builders<Unit>.Filter.Eq("_id", updateUnitListDto.UnitId);
@@ -459,6 +473,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// <param name="unitIdParsed">The <see cref="ObjectId"/> of the unit whose configuration will be updated.</param>
     /// <param name="unitConfiguration">The new <see cref="UnitConfiguration"/> to apply to the unit.</param>
     /// <returns>A task that resolves to <c>true</c> when the update modified a document; otherwise <c>false</c> (including when the operation throws and the error is logged).</returns>
+    /// <!-- aidoc:v1 sig=0ae31e8 body=dd19aa3 -->
     public async Task<bool> UpdateConfiguration(ObjectId unitIdParsed, UnitConfiguration unitConfiguration)
         {
             var filter = Builders<Unit>.Filter.Eq("_id", unitIdParsed);
@@ -485,6 +500,7 @@ public class UnitRepository : MongoRepository<Unit>, IUnitRepository
     /// </summary>
     /// <param name="id">The identifier of the unit to delete.</param>
     /// <returns>The deleted <see cref="Unit"/> if found and removed; otherwise, <c>null</c> when an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=07e45cd body=5ae0f5c -->
     public new async Task<Unit?> DeleteAsync(ObjectId id)
         {
             var filter = Builders<Unit>.Filter.Eq(unit => unit.Id, id);
diff --git a/adas-core.Infrastructure/Repositories/UserRepository.cs b/adas-core.Infrastructure/Repositories/UserRepository.cs
index f69f21fe..87bd3fa1 100644
--- a/adas-core.Infrastructure/Repositories/UserRepository.cs
+++ b/adas-core.Infrastructure/Repositories/UserRepository.cs
@@ -16,6 +16,7 @@ namespace adas_core.Infrastructure.Repositories;
 /// <remarks>
 /// Inherits core data access functionality from <see cref="MongoRepository{User}"/> and implements the <see cref="IUserRepository"/> contract.
 /// </remarks>
+/// <!-- aidoc:v1 sig=7f8031c -->
 public class UserRepository : MongoRepository<User>, IUserRepository
 {
     private readonly ApiSettings _apiSettings;
@@ -37,6 +38,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// Retrieves the API collection name for users from the configured API settings.
     /// </summary>
     /// <returns>The configured name of the users collection.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=f29d25a -->
     public override string GetCollectionName()
         {
             return _apiSettings.Users;
@@ -49,6 +51,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// <param name="username">The username to look up in the collection.</param>
     /// <param name="password">The password that must match the stored value for the user to be returned.</param>
     /// <returns>A <see cref="User"/> instance when a matching record is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=be4ac11 body=ac01c98 -->
     public async Task<User?> GetUser(string username, string password)
         {
             var filter = Builders<User>
@@ -63,6 +66,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="id">The <see cref="ObjectId"/> of the user to look up.</param>
     /// <returns>A <see cref="User"/> instance if a matching document exists; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=9cec1a5 body=78ead0f -->
     public async Task<User?> GetById(ObjectId id)
         {
             var filter = Builders<User>
@@ -77,6 +81,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="name">The username used to look up the user.</param>
     /// <returns>A <see cref="User"/> instance if a match is found; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=c23232a body=1f6c5cb -->
     public async Task<User?> GetByUserName(string name)
         {
             var filter = Builders<User>
@@ -90,6 +95,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="name">The username used to match the user document in the collection.</param>
     /// <returns>A <see cref="Task{TResult}"/> that yields the matching <see cref="User"/> with its authorizations and resolved role, or <c>null</c> if no user is found.</returns>
+    /// <!-- aidoc:v1 sig=31b518d body=72882f6 -->
     public async Task<User?> GetByUserAndAuthoritesName(string name)
         {
             var matchStage = new BsonDocument("$match", new BsonDocument("userName", name));
@@ -137,6 +143,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="name">The name of the user to look up.</param>
     /// <returns>A <see cref="User"/> instance if a match is found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=ccb9033 body=30118c6 -->
     public async Task<User?> GetByName(string name)
         {
             var filter = Builders<User>
@@ -152,6 +159,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// <param name="user">The user entity whose fields will be applied to the existing record, identified by <see cref="User.Id"/>.</param>
     /// <param name="updatePass">If <c>true</c>, the password field is included in the update; if <c>false</c>, the password is not modified.</param>
     /// <returns>The updated <see cref="User"/> retrieved after the update, or <c>null</c> if no matching user was found.</returns>
+    /// <!-- aidoc:v1 sig=3448f77 body=e54a95d -->
     public async Task<User?> UpdateUser(User user, bool updatePass)
         {
             var filter = Builders<User>
@@ -176,6 +184,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="filteredRequest">The pagination filter containing paging details and the optional filter payload (text, user status, and user type) used to build the MongoDB query.</param>
     /// <returns>An <see cref="IFindFluent{TDocument, TProjection}"/> of <see cref="User"/> sorted ascending by user name and shaped by the assembled filter definitions.</returns>
+    /// <!-- aidoc:v1 sig=0f10830 body=0c62e4a -->
     public IFindFluent<User, User> GetPaginatedUsers(PaginationFilter filteredRequest)
         {
             // Crear variable con la clase que construye los filtros que necesitamos
@@ -215,6 +224,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// Retrieves the system user identified by the username "System", creating and inserting a new one with default credentials if no existing user is found.
     /// </summary>
     /// <returns>The existing system user if found; otherwise, the newly created and inserted system user.</returns>
+    /// <!-- aidoc:v1 sig=26219ff body=775a713 -->
     public async Task<User> GetOrCreateSystemUser()
         {
             var user = await GetByUserName("System");
@@ -236,6 +246,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// <summary>
     /// Inserts the initial load of data by ensuring that the system user exists, creating one if necessary.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ccdefcf body=eb41bb0 -->
     public sealed override async Task InsertInitialLoad()
         {
             await GetOrCreateSystemUser();
@@ -249,6 +260,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// <param name="filters">The list of filter definitions to be combined with logical AND.</param>
     /// <param name="sort">The sort definition to apply to the query results.</param>
     /// <returns>A fluent find query for the <see cref="User"/> collection with the combined filter and sort applied.</returns>
+    /// <!-- aidoc:v1 sig=65f1029 body=9a8a34a -->
     private IFindFluent<User, User> CreateFindFluent(List<FilterDefinition<User>> filters, SortDefinition<User> sort)
         {
             var combinedFilter = filters.Any()
@@ -264,6 +276,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="type">The user type to filter by. If null or not one of the handled values, no filter is added.</param>
     /// <returns>A list of FilterDefinition objects matching the specified user type, or an empty list if no specific type was matched.</returns>
+    /// <!-- aidoc:v1 sig=ef9cd45 body=04622cf -->
     private List<FilterDefinition<User>> GetUserTypeFilter(UserEnum.Type? type)
         {
             var filters = new List<FilterDefinition<User>>();
@@ -287,6 +300,7 @@ public class UserRepository : MongoRepository<User>, IUserRepository
     /// </summary>
     /// <param name="status">The user status used to select which filter combination is applied; a <c>null</c> or unhandled value yields an empty filter list.</param>
     /// <returns>A list of <see cref="FilterDefinition{TDocument}"/> filters that should be combined to query <see cref="User"/> documents for the specified status.</returns>
+    /// <!-- aidoc:v1 sig=afc76fe body=92c7666 -->
     private List<FilterDefinition<User>> GetUserStatusFilter(StatusEnum.User? status)
         {
             var filters = new List<FilterDefinition<User>>();
diff --git a/adas-core.Infrastructure/Services/PublisherService.cs b/adas-core.Infrastructure/Services/PublisherService.cs
index 197aa765..61c542ea 100644
--- a/adas-core.Infrastructure/Services/PublisherService.cs
+++ b/adas-core.Infrastructure/Services/PublisherService.cs
@@ -12,6 +12,7 @@ namespace adas_core.Infrastructure.Services;
 /// <summary>
 /// Represents a service that implements the <see cref="IPublisherService"/> contract, providing the concrete implementation of the publishing operations defined by the interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=2b6fa6f -->
 public class PublisherService : IPublisherService
 {
     private readonly ILogger<PublisherService> _logger;
@@ -90,6 +91,7 @@ public class PublisherService : IPublisherService
     /// <param name="msg">The message payload to send to the queue.</param>
     /// <param name="queueName">The name of the target queue to which the message will be sent.</param>
     /// <returns><c>true</c> if the message was sent successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=4a81ef7 body=ccacd65 -->
     public async Task<bool> SendMessage(string msg, string queueName)
         {
             try
@@ -121,6 +123,7 @@ public class PublisherService : IPublisherService
     /// <param name="obj">The object to serialize and send to the queue.</param>
     /// <param name="queueName">The name of the destination queue.</param>
     /// <returns>A task that resolves to <c>true</c> if the message was sent successfully; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=9bcf9cc body=8c96ff0 -->
     public async Task<bool> SendMessage(object obj, string queueName)
         {
             var json = JsonConvert.SerializeObject(obj);
@@ -133,6 +136,7 @@ public class PublisherService : IPublisherService
     /// <param name="obj">The message object expected to be a <c>Message&lt;Error&gt;</c>. If it is not, the method returns <c>false</c> without sending anything.</param>
     /// <param name="queueName">The name of the queue to which the error message body will be sent. The queue is created if it does not already exist.</param>
     /// <returns>A <see cref="Task{Boolean}"/> that resolves to <c>true</c> when the error message is successfully sent, and <c>false</c> when the bus is null, the object is not a <c>Message&lt;Error&gt;</c>, or an exception is raised while sending.</returns>
+    /// <!-- aidoc:v1 sig=ad36809 body=f9fde02 -->
     public async Task<bool> SendMessageError(object obj, string queueName)
         {
             try
diff --git a/adas-core.Infrastructure/Services/ReceiverService.cs b/adas-core.Infrastructure/Services/ReceiverService.cs
index b6ee7d72..eeb24bd2 100644
--- a/adas-core.Infrastructure/Services/ReceiverService.cs
+++ b/adas-core.Infrastructure/Services/ReceiverService.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Services;
 /// <summary>
 /// Provides functionality for receiving and processing incoming data, messages, or requests.
 /// </summary>
+/// <!-- aidoc:v1 sig=0552406 -->
 public class ReceiverService
 {
     private readonly ILogger<ReceiverService> _logger;
@@ -83,6 +84,7 @@ public class ReceiverService
     /// <summary>
     /// Registers all application queues defined in settings, including queues for observations, treatments, patients, pumps, appointments, recordings, recording alerts, and alarm observations, by adding each one through the <c>AddQueue</c> call.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b14e3d9 body=1372d9f -->
     private void SetQueues()
         {
             AddQueue(_settings.ObservationsQueue);
@@ -99,6 +101,7 @@ public class ReceiverService
     /// Adds a queue to the internal collection only when the supplied value is not null, empty, or whitespace; otherwise the call is ignored.
     /// </summary>
     /// <param name="queue">The queue identifier to add to the collection. Null, empty, or whitespace values are silently skipped.</param>
+    /// <!-- aidoc:v1 sig=322aa1a body=bdf4bfa -->
     private void AddQueue(string? queue)
         {
             if (!string.IsNullOrWhiteSpace(queue))
@@ -108,6 +111,7 @@ public class ReceiverService
     /// <summary>
     /// Attempts to establish a connection to RabbitMQ by disposing any existing bus, configuring EasyNetQ with the configured connection string, and registering consumers for all configured queues. If the connection fails, the failure is logged and a timer is scheduled to retry the connection after a five-second delay, recursively invoking the method when the timer elapses.
     /// </summary>
+    /// <!-- aidoc:v1 sig=417902d body=fbb9618 -->
     private void TryToConnect()
         {
             try
@@ -145,6 +149,7 @@ public class ReceiverService
     /// <summary>
     /// Disposes the underlying bus instance if it implements <see cref="IDisposable"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=21b17a7 body=232143f -->
     private void DisposeBus()
         {
             if (_bus is IDisposable disposable)
@@ -194,6 +199,7 @@ public class ReceiverService
     /// </summary>
     /// <param name="queue">The queue name to resolve to its corresponding API request service.</param>
     /// <returns>The matching <see cref="IApiRequestService"/> instance if the queue is recognized; otherwise, <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=62d9eca body=23b1d5d -->
     private IApiRequestService? ResolveService(string queue)
         {
             return queue switch
@@ -214,6 +220,7 @@ public class ReceiverService
     /// Asynchronously reprocesses messages from the specified error queue by deriving the target queue name from the routing key (with "Key" removed), resolving the associated service, and resubmitting the message. Operations are skipped when the bus is uninitialized, the derived queue name is empty, or no service is resolved.
     /// </summary>
     /// <param name="errorQueueName">The name of the error queue from which to reprocess messages.</param>
+    /// <!-- aidoc:v1 sig=baa5e88 body=90bfb05 -->
     public async Task ProcessErrorQueue(string errorQueueName)
         {
             if (_bus == null)
@@ -255,6 +262,7 @@ public class ReceiverService
     /// Sends EasyNetQ messages to a service implementing IApiRequestService
     /// Throws exception to trigger retry on failure
     /// </summary>
+    /// <!-- aidoc:v1 sig=f5ba50e body=1be117a -->
     private void TryToParseAndSend(IMessage<string> msg, IApiRequestService service)
     {
         try
diff --git a/adas-core.Infrastructure/Services/RelayService.cs b/adas-core.Infrastructure/Services/RelayService.cs
index 8ed59b23..aff29e8c 100644
--- a/adas-core.Infrastructure/Services/RelayService.cs
+++ b/adas-core.Infrastructure/Services/RelayService.cs
@@ -28,6 +28,7 @@ namespace adas_core.Infrastructure.Services;
 /// This class is the default implementation of <see cref="IRelayService"/>,
 /// and can be substituted via dependency injection where the interface is required.
 /// </remarks>
+/// <!-- aidoc:v1 sig=699b195 -->
 public class RelayService : IRelayService
 {
     private readonly List<RelayDevice> _devices = [];
@@ -74,6 +75,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relay">The relay to check, identified by its IP, port, and relay number used both as the cache key and as the target of the status request.</param>
     /// <returns>A task that yields the resolved <see cref="RelayEnum.Status"/> of the relay, or <see cref="RelayEnum.Status.Unknown"/> when the status cannot be determined.</returns>
+    /// <!-- aidoc:v1 sig=a2d75fa body=4380852 -->
     public async Task<RelayEnum.Status> CheckRelayStatus(Relay relay)
         {
             var cacheKey = Tuple.Create(relay.Ip, relay.Port, relay.RelayNumber);
@@ -123,6 +125,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relayId">The unique identifier of the relay whose status should be checked.</param>
     /// <returns>The current <see cref="RelayEnum.Status"/> of the relay, or <see cref="RelayEnum.Status.Unknown"/> if no relay with the given ID exists.</returns>
+    /// <!-- aidoc:v1 sig=bba9f8d body=7f98d77 -->
     public async Task<RelayEnum.Status> CheckRelayStatus(ObjectId relayId)
         {
             var relay = await _relayRepository.GetById(relayId);
@@ -134,6 +137,8 @@ public class RelayService : IRelayService
     /// Asynchronously powers off the specified relay. Uses a cache to avoid redundant operations when the relay is already off, falls back to an HTTP request when no local relay device is available, and updates the cache after a successful power off.
     /// </summary>
     /// <param name="relay">The relay to power off, including its network address and relay number.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states the cache is updated 'after a successful power off', but the cache update happens unconditionally without verifying that the power off operation actually succeeded (e.g., the awaited HTTP call is not checked for a success response)." -->
     public async Task PowerOff(Relay relay)
         {
             var cacheKey = Tuple.Create(relay.Ip, relay.Port, relay.RelayNumber);
@@ -179,6 +184,7 @@ public class RelayService : IRelayService
     /// Powers on the specified relay. If the relay is configured with a URL, sends a remote power-on request; otherwise, drives the relay device directly. Honors a caching layer to avoid redundant power-on commands when the relay is already reported as on.
     /// </summary>
     /// <param name="relay">The relay to power on, including driver, IP, port, relay number, and cache settings.</param>
+    /// <!-- aidoc:v1 sig=7f8cab9 body=56affe0 -->
     public async Task PowerOn(Relay relay)
         {
             if (string.IsNullOrEmpty(relay.Driver) || string.IsNullOrEmpty(relay.Ip)) return;
@@ -232,6 +238,7 @@ public class RelayService : IRelayService
     /// <param name="status">The manual relay status to apply.</param>
     /// <param name="pocId">The identifier of the point of care device whose relay configuration should be updated.</param>
     /// <param name="type">The relay type used to look up the target relay within the point of care's relay configuration.</param>
+    /// <!-- aidoc:v1 sig=82fad8b body=823e6e0 -->
     public async Task SetManualRelay(RelayEnum.Status status, ObjectId pocId, RelayEnum.Type type)
         {
             try
@@ -259,6 +266,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relay">The unique identifier of the relay to look up.</param>
     /// <returns>A task that resolves to the <see cref="Relay"/> if found, or <c>null</c> if no relay matches the supplied identifier.</returns>
+    /// <!-- aidoc:v1 sig=aa6ff57 body=51941e7 -->
     public Task<Relay?> GetById(ObjectId relay)
         {
             return _relayRepository.GetById(relay);
@@ -268,6 +276,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relayList">The list of relay identifiers to look up. Can be null.</param>
     /// <returns>A list of <see cref="Relay"/> objects corresponding to the provided identifiers, or an empty list if the input is null.</returns>
+    /// <!-- aidoc:v1 sig=ebc008d body=14fde35 -->
     public List<Relay> GetRelayInList(List<ObjectId>? relayList)
         {
             if(relayList == null) return new List<Relay>();
@@ -280,6 +289,7 @@ public class RelayService : IRelayService
     /// <param name="configurationRelayList">The optional list of <see cref="ObjectId"/> values identifying the configuration relays to filter; when <c>null</c>, the method short-circuits and returns an empty list.</param>
     /// <param name="type">The relay type used to filter the matching relays within the supplied list.</param>
     /// <returns>A <see cref="List{Relay}"/> containing the relays matching the specified <paramref name="type"/>, or an empty list if <paramref name="configurationRelayList"/> is <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=8a36763 body=46b0859 -->
     public List<Relay> GetRelayByTypeInList(List<ObjectId>? configurationRelayList, RelayEnum.Type type)
         {
             if(configurationRelayList == null) return new List<Relay>();
@@ -338,6 +348,7 @@ public class RelayService : IRelayService
     /// <param name="request">The relay entity to insert, whose name is checked for duplicates prior to persistence.</param>
     /// <returns>The inserted <see cref="Relay"/> entity returned by the repository, or <c>null</c> if the repository yields no result.</returns>
     /// <exception cref="Exception">Thrown when a relay with the same name as <paramref name="request"/> already exists in the repository.</exception>
+    /// <!-- aidoc:v1 sig=d0333f5 body=0c77f19 -->
     public async Task<Relay?> InsertRelay(Relay request)
         {
             var relayExist = await _relayRepository.GetByName(request.RelayName);
@@ -351,6 +362,7 @@ public class RelayService : IRelayService
     /// <param name="objectId">The unique identifier of the relay to update.</param>
     /// <param name="relay">The relay object containing the updated information.</param>
     /// <returns>A task representing the asynchronous operation, containing the updated <see cref="Relay"/>, or <c>null</c> if no relay with the specified identifier was found.</returns>
+    /// <!-- aidoc:v1 sig=24b1fa0 body=cd48e45 -->
     public Task<Relay?> UpdateRelayById(ObjectId objectId, Relay relay)
         {
             return _relayRepository.UpdateRelayAsync(objectId, relay);
@@ -417,6 +429,7 @@ public class RelayService : IRelayService
     /// <returns>The existing or newly created <see cref="RelayDevice"/>, or <c>null</c> if the relay is missing a valid IP or port.</returns>
     /// <exception cref="AdasException">Thrown when no constructor matching <see cref="Relay"/> and <see cref="RelaySettings"/> is found on the resolved driver type.</exception>
     /// <exception cref="AdasException">Thrown when the resolved driver type cannot be instantiated into a <see cref="RelayDevice"/>.</exception>
+    /// <!-- aidoc:v1 sig=c05ea03 body=5b9a1de -->
     private RelayDevice? GetRelayDevice(Relay relay)
         {
             if(relay.Ip.IsNullOrWhiteSpace() || relay.Port == 0) return null;
@@ -449,6 +462,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relay">The relay whose driver, IP, port, name, total count, username, and password are included in the request query string.</param>
     /// <param name="builder">The URI builder whose query is updated with the relay parameters and whose resulting URI is used as the request target.</param>
+    /// <!-- aidoc:v1 sig=3c06d77 body=f99c21d -->
     private async Task PowerRelay(Relay relay, UriBuilder builder)
         {
             var query = HttpUtility.ParseQueryString(builder.Query);
@@ -487,6 +501,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="dictionary">The concurrent dictionary containing relay status entries keyed by a tuple of device ID, port, and an additional integer value.</param>
     /// <returns>A string containing one formatted line per dictionary entry describing the device ID, port, and status.</returns>
+    /// <!-- aidoc:v1 sig=be16714 body=b812332 -->
     private static string DictionaryToString(ConcurrentDictionary<Tuple<string, int, int>, RelayEnum.Status> dictionary)
         {
             var builder = new StringBuilder();
@@ -504,6 +519,7 @@ public class RelayService : IRelayService
     /// </summary>
     /// <param name="relay">The relay instance whose status should be queried; its IP, port, relay number, driver, credentials, and mode are used to build the request.</param>
     /// <returns>The parsed <see cref="RelayEnum.Status"/> returned by the remote relay service, or <see cref="RelayEnum.Status.Unknown"/> if the request fails.</returns>
+    /// <!-- aidoc:v1 sig=3eb287a body=570413b -->
     private async Task<RelayEnum.Status> GetRelayStatusByOr(Relay relay)
         {
             var cacheKey = Tuple.Create(relay.Ip, relay.Port, relay.RelayNumber);
diff --git a/adas-core.Infrastructure/Services/SendAlertService.cs b/adas-core.Infrastructure/Services/SendAlertService.cs
index 4ea5878c..39622351 100644
--- a/adas-core.Infrastructure/Services/SendAlertService.cs
+++ b/adas-core.Infrastructure/Services/SendAlertService.cs
@@ -45,6 +45,7 @@ public class SendAlertService(
     /// If the Rabbit connection string is not defined in the web config, an error is logged and an empty list is returned.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Queue"/> objects, or an empty list if the Rabbit connection string is not configured.</returns>
+    /// <!-- aidoc:v1 sig=8b94d31 body=8aa2b12 -->
     public async Task<List<Queue>> GetQueues()
         {
             if (_rabbitConnectionString != null) return await GetQueuesAsync();
@@ -59,6 +60,7 @@ public class SendAlertService(
     /// Logs and suppresses any errors encountered while collecting the data, returning the successfully gathered metrics.
     /// </summary>
     /// <returns>A list of <see cref="Performance"/> entries containing the collected performance metrics; returns an empty list if all collection attempts fail.</returns>
+    /// <!-- aidoc:v1 sig=2be2617 body=a3f4d4b -->
     public List<Performance> GetPerformance()
         {
             logger.LogDebug("Starting check performance data from hospitals");
@@ -84,6 +86,7 @@ public class SendAlertService(
     /// Asynchronously retrieves a list of API clients by delegating to the underlying data retrieval method.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, containing the list of <see cref="ApiClients"/> instances retrieved.</returns>
+    /// <!-- aidoc:v1 sig=74b1e47 body=7ebcae0 -->
     public async Task<List<ApiClients>> GetApiClients()
         {
             return await GetApiClientsAsync();
@@ -93,6 +96,7 @@ public class SendAlertService(
     /// Asynchronously retrieves statistics for the configured RabbitMQ error queues (recording, patients, treatments, observations, and pumps). Only queues with non-empty names are queried, duplicates are ignored, and any exception raised while connecting or fetching stats is logged and results in an empty list being returned.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains a list of <see cref="Queue"/> objects with the name, message count, and consumer count of each queried queue, or an empty list if an error occurs.</returns>
+    /// <!-- aidoc:v1 sig=97010df body=95afb89 -->
     private async Task<List<Queue>> GetQueuesAsync()
         {
             logger.LogDebug("Starting check rabbitMQ data from hospitals");
@@ -151,6 +155,7 @@ public class SendAlertService(
     /// Calculates usage from total processor time divided by processor count, and returns a default Performance instance if the underlying process query fails.
     /// </summary>
     /// <returns>A Performance object describing the CPU usage percentage, total capacity, and unit. If an error occurs, a default Performance instance is returned and the exception is logged.</returns>
+    /// <!-- aidoc:v1 sig=a7e6e3d body=875a1c4 -->
     public Performance GetConsumedCpu()
         {
             Performance performance = new();
@@ -180,6 +185,7 @@ public class SendAlertService(
     /// Retrieves the current RAM consumption in gigabytes, returning it as a Performance metric where the total and consumed values are reported as equal with a consumption percentage of 100. If an error occurs while retrieving the memory information, the exception is logged and an empty Performance object is returned.
     /// </summary>
     /// <returns>A Performance object representing the RAM usage in GB; returns an empty Performance object if the memory retrieval fails.</returns>
+    /// <!-- aidoc:v1 sig=6b014f3 body=8c40f98 -->
     public Performance GetConsumedRam()
         {
             Performance performance = new();
@@ -211,6 +217,7 @@ public class SendAlertService(
     /// </summary>
     /// <param name="drive">The drive whose storage consumption is to be measured.</param>
     /// <returns>A <see cref="Performance"/> instance containing the consumed storage, total storage, percentage consumed, and the unit (GB) for the drive.</returns>
+    /// <!-- aidoc:v1 sig=d432443 body=b8cb174 -->
     public Performance GetConsumedStorage(DriveInfo drive)
         {
             Performance performance = new();
@@ -258,6 +265,7 @@ public class SendAlertService(
     /// <returns>A list of <see cref="Performance"/> entries describing the consumed storage for each
     /// successfully processed drive; returns an empty list if no drives yield results or if an
     /// error occurs during enumeration.</returns>
+    /// <!-- aidoc:v1 sig=1a15ba5 body=724e81c -->
     private List<Performance> GetConsumedStorages()
         {
             var list = new List<Performance>();
@@ -292,6 +300,7 @@ public class SendAlertService(
     /// Returns an empty list if the underlying call returns null or fails; any exception is caught and logged without being rethrown.
     /// </summary>
     /// <returns>A task that resolves to the list of connected API clients, which may be empty if no clients were retrieved.</returns>
+    /// <!-- aidoc:v1 sig=3d33350 body=519c9d5 -->
     private async Task<List<ApiClients>> GetApiClientsAsync()
         {
             logger.LogDebug("Starting check conected clients from hospitals");
@@ -317,6 +326,10 @@ public class SendAlertService(
     /// Asynchronously retrieves the list of connected WebSocket API clients, handling any errors by logging them and returning an empty <see cref="ApiClients"/> instance as a fallback.
     /// </summary>
     /// <returns>A <see cref="Task{TResult}"/> that resolves to an <see cref="ApiClients"/> instance representing the connected WebSocket subscribers.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The summary states the method 'retrieves the list of connected WebSocket API clients', but the actual retrieval code (`webSocketHandler.GetSubscribersConected()`) is commented out. The method only ever constructs a new empty ApiClients and returns it." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> tag documents a non-nullable ApiClients instance, but the method's return type is Task<ApiClients?> (nullable)." -->
     private Task<ApiClients?> GetWebSocketClients()
         {
             ApiClients apiClients = new();
diff --git a/adas-core.Infrastructure/Utils/CacheHostBuilderExtension.cs b/adas-core.Infrastructure/Utils/CacheHostBuilderExtension.cs
index 214b662f..b09c9b69 100644
--- a/adas-core.Infrastructure/Utils/CacheHostBuilderExtension.cs
+++ b/adas-core.Infrastructure/Utils/CacheHostBuilderExtension.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Utils
     /// <summary>
     /// Provides extension methods for configuring or building cache host instances.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f280f01 -->
     public static class CacheHostBuilderExtension
     {
         /// <summary>
diff --git a/adas-core.Infrastructure/Utils/CustomPointOfCareConverter.cs b/adas-core.Infrastructure/Utils/CustomPointOfCareConverter.cs
index dff4e5d8..5b30abd8 100644
--- a/adas-core.Infrastructure/Utils/CustomPointOfCareConverter.cs
+++ b/adas-core.Infrastructure/Utils/CustomPointOfCareConverter.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <remarks>
 /// This converter is designed to handle the serialization and deserialization logic specific to point of care entities, tailoring the behavior inherited from the <see cref="JsonConverter"/> base class.
 /// </remarks>
+/// <!-- aidoc:v1 sig=bdea055 -->
 public class CustomPointOfCareConverter : JsonConverter
 {
     /// <summary>
@@ -17,6 +18,7 @@ public class CustomPointOfCareConverter : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to evaluate for convertibility.</param>
     /// <returns><c>true</c> if <paramref name="objectType"/> equals <see cref="PointOfCare"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee00023 body=8b20223 -->
     public override bool CanConvert(Type objectType)
         {
             return objectType == typeof(PointOfCare);
diff --git a/adas-core.Infrastructure/Utils/MongoDbHostBuilderExtension.cs b/adas-core.Infrastructure/Utils/MongoDbHostBuilderExtension.cs
index 054e7276..33cf6ae3 100644
--- a/adas-core.Infrastructure/Utils/MongoDbHostBuilderExtension.cs
+++ b/adas-core.Infrastructure/Utils/MongoDbHostBuilderExtension.cs
@@ -14,6 +14,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <summary>
 /// Provides extension methods for configuring MongoDB integration on a host builder.
 /// </summary>
+/// <!-- aidoc:v1 sig=c198c69 -->
 public static class MongoDbHostBuilderExtension
 {
     /// <summary>
@@ -21,6 +22,7 @@ public static class MongoDbHostBuilderExtension
     /// </summary>
     /// <param name="hostBuilder">The host builder to extend with the MongoDB configuration.</param>
     /// <returns>The same <see cref="IHostBuilder"/> instance, allowing further fluent configuration.</returns>
+    /// <!-- aidoc:v1 sig=e4bedf4 body=7ed0573 -->
     public static IHostBuilder UseMongo(this IHostBuilder hostBuilder)
         {
             ConfigureMongoDbConventions();
@@ -34,6 +36,7 @@ public static class MongoDbHostBuilderExtension
     /// </summary>
     /// <param name="host">The host whose services are used to resolve the <see cref="IMongoDatabase"/> instance.</param>
     /// <returns>The same <see cref="IHost"/> instance, enabling fluent chaining.</returns>
+    /// <!-- aidoc:v1 sig=c767d9c body=fff8138 -->
     public static IHost RunMongoMigrations(this IHost host)
         {
             using var scope = host.Services.CreateScope();
@@ -63,6 +66,7 @@ public static class MongoDbHostBuilderExtension
     /// <returns>The configured <see cref="IMongoDatabase"/> instance.</returns>
     /// <exception cref="Exception">Thrown when the connection string or database name is null or empty.</exception>
     /// <exception cref="Exception">Thrown when the specified database does not exist.</exception>
+    /// <!-- aidoc:v1 sig=302f4d6 body=0f9a4d3 -->
     private static IMongoDatabase ConfigureMongoDbConnection(IOptions<DatabaseSettings> dbSettings)
         {
             var connectionString = dbSettings.Value.ConnectionString;
@@ -106,6 +110,7 @@ public static class MongoDbHostBuilderExtension
     /// Registers global MongoDB serialization conventions, including ignoring extra elements in BSON documents
     /// and using camelCase for element names, applied to all types in the application.
     /// </summary>
+    /// <!-- aidoc:v1 sig=470c959 body=7fdb696 -->
     public static void ConfigureMongoDbConventions()
         {
             var pack = new ConventionPack
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/AlarmMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/AlarmMapContributor.cs
index 23153399..94952f70 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/AlarmMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/AlarmMapContributor.cs
@@ -13,11 +13,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Represents a contributor that provides entity mapping configuration for Alarm entities.
 /// </summary>
 /// <remarks>Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping process.</remarks>
+/// <!-- aidoc:v1 sig=2e84ec1 -->
 public class AlarmMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for alarm-related domain types (including alarm configuration, audio, alarm items, patient observation alarms, inactivation states, sources, recording alerts, and performance), configuring enum serialization as strings, null-ignore behavior for optional members, default values where applicable, and unmapping members that should not be persisted. Registration is performed only when a class map for the type is not already registered, ensuring idempotent behavior.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=6fc7014 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(AlarmConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/AppointmentMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/AppointmentMapContributor.cs
index 109bea49..d9024605 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/AppointmentMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/AppointmentMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a contributor that provides entity mapping configuration for the <see cref="PatientAppointment"/> type as part of the mapping framework.
 /// </summary>
+/// <!-- aidoc:v1 sig=bbe580f -->
 public class AppointmentMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="PatientAppointment"/>, <see cref="PatientAppointmentResourceGroup"/>, and <see cref="Allergies"/> types, customizing the MongoDB serialization for their members. Registration is performed only if a class map for the type has not already been registered, making the call safe to invoke multiple times. Optional members are configured to be ignored when null, enum members are serialized as nullable string enums, and certain computed/action members are unmapped or assigned default collection values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=04cfbed -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(PatientAppointment)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/AuthMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/AuthMapContributor.cs
index 5943a469..3b28c849 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/AuthMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/AuthMapContributor.cs
@@ -7,11 +7,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents an entity map contributor that provides authentication-related mapping logic.
 /// </summary>
+/// <!-- aidoc:v1 sig=fe4f97f -->
 public class AuthMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="User"/> and <see cref="Authorization"/> types when no class map has been registered yet, configuring field serialization rules such as ignoring null or empty values, mapping the identifier to the "_id" element name, and unmapping navigation properties not intended for persistence.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=c4e3897 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(User)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/BannerConfigMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/BannerConfigMapContributor.cs
index 62e60e7f..2f6220cb 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/BannerConfigMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/BannerConfigMapContributor.cs
@@ -13,11 +13,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Used as a contributor that participates in entity map configuration for banner-related data.
 /// </remarks>
+/// <!-- aidoc:v1 sig=143f37c -->
 public class BannerConfigMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for banner-related configuration types, including <see cref="BannerItem"/>, <see cref="BannerItemConfig"/>, <see cref="BannerItemTableConfig"/>, and <see cref="HeaderBannerItemTableConfig"/>. Each map is only registered when no existing registration is found, and applies custom serialization (enum values stored as strings), null-ignoring behavior for optional members, and default values where appropriate.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=2d4b26f -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(BannerItem)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/BeaconMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/BeaconMapContributor.cs
index e87c0d95..51375c93 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/BeaconMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/BeaconMapContributor.cs
@@ -14,11 +14,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Implements the <see cref="IEntityMapContributor"/> interface to contribute
 /// beacon-specific mapping logic.
 /// </remarks>
+/// <!-- aidoc:v1 sig=9538dbe -->
 public class BeaconMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="LightBeacon"/>, <see cref="Options"/>, and <see cref="LightBeaconAbstract"/> types to configure their MongoDB serialization. Each registration is skipped if a class map for the type has already been registered, applying default values, element name mappings, and ignore-if-null settings to the respective members.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=b1eeb38 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(LightBeacon)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/BoxConfigMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/BoxConfigMapContributor.cs
index 1212f444..76dbe144 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/BoxConfigMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/BoxConfigMapContributor.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Provides configuration mapping contributions for box entities, implementing the <see cref="IEntityMapContributor"/> interface to participate in entity map setup.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b5af6b -->
 public class BoxConfigMapContributor : IEntityMapContributor
 {
     /// <summary>
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/CameraContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/CameraContributor.cs
index d938e219..f3e6422c 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/CameraContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/CameraContributor.cs
@@ -11,11 +11,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> interface to provide camera-specific mapping behavior within the entity mapping pipeline.
 /// </remarks>
+/// <!-- aidoc:v1 sig=fb656c1 -->
 public class CameraContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="Camera"/> and <see cref="Domain.Models.MongoModels.Stream"/> types with MongoDB, applying custom mapping conventions such as element name overrides, default values, and ignore-if-null behavior. Registration is performed only once; the method guards against duplicate registration by checking <see cref="BsonClassMap.IsClassMapRegistered(Type)"/> before registering.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=6ea6233 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Camera)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/CardMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/CardMapContributor.cs
index 3dff32a0..e257700c 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/CardMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/CardMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Provides card-specific mapping contributions by implementing the <see cref="IEntityMapContributor"/> contract within the entity mapping pipeline.
 /// </summary>
+/// <!-- aidoc:v1 sig=b8c7213 -->
 public class CardMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the layout and configuration types used by the display configuration domain, including <see cref="SectionBoxLayout"/>, <see cref="CardDetailsConfig"/>, <see cref="CardRotatingLayout"/>, <see cref="Step"/>, and <see cref="HomeConfig"/>. Each map is only registered when no existing map is present, and the configuration establishes default values, enum-as-string serialization, and ignore-if-null behavior for nullable layout properties.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=75cdc8f -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(SectionBoxLayout)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/CellMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/CellMapContributor.cs
index 825d9b90..094caa75 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/CellMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/CellMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a contributor that participates in populating a cell-based map by implementing the entity map contribution contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=23355bf -->
 public class CellMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="Cell"/>, <see cref="CellDetails"/>, <see cref="IconValueList"/>, <see cref="DialogConfig"/>, and <see cref="MedicalConfig"/> when they have not already been registered. Each registration configures default values, ignore-if-null behavior, and enum serialization for the corresponding type's members to control how instances are persisted in MongoDB.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=13b6118 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Cell)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/ColorConfigMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/ColorConfigMapContributor.cs
index 2a4356a6..acc54f31 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/ColorConfigMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/ColorConfigMapContributor.cs
@@ -12,11 +12,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Used as a pluggable component within the entity mapping pipeline to apply
 /// color-related configuration to mapped entities.
 /// </remarks>
+/// <!-- aidoc:v1 sig=1f5bb8d -->
 public class ColorConfigMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="ColorConfig"/> type and its nested configuration types, providing default color and appearance values for properties such as levels, text, arrows, indicators, graphs, status boxes, therapy, tests, and procedures. Each class map is registered only if it has not already been registered, ensuring idempotent initialization of the MongoDB serialization mappings used by the color configuration system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=c066e37 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(ColorConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/ComunicationFlowMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/ComunicationFlowMapContributor.cs
index e6c20772..27107b33 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/ComunicationFlowMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/ComunicationFlowMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a map contributor that provides mapping configuration for communication flow entities by implementing the <see cref="IEntityMapContributor"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=e2ee262 -->
 public class ComunicationFlowMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the application's MongoDB-serialized types, including <see cref="Message"/>, <see cref="Queue"/>, <see cref="ApiRequest"/>, <see cref="AdmPanelRequest"/>, <see cref="ApiClients"/>, and <see cref="VideoDto"/>, applying custom mapping rules such as unmapping the <c>Operation</c> member on <see cref="Message"/> and ignoring null values for <c>ObsertationData</c> on <see cref="AdmPanelRequest"/>. Each type is only registered if a class map has not already been registered, preventing duplicate registration.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=f163d5b -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Message)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/DeviceMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/DeviceMapContributor.cs
index c6adc465..66502ccc 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/DeviceMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/DeviceMapContributor.cs
@@ -12,6 +12,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Represents a contributor that provides device-related mapping logic for entities.
 /// Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping process.
 /// </summary>
+/// <!-- aidoc:v1 sig=46a00cb -->
 public class DeviceMapContributor : IEntityMapContributor
 {
     /// <summary>
@@ -20,6 +21,7 @@ public class DeviceMapContributor : IEntityMapContributor
     /// <remarks>
     /// Each map is only registered if no class map is already registered for the type. The registration applies auto-mapping and customizes serialization for enum members (stored as strings), applies default values for required properties, and configures nullable members to be ignored when null.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=d4dea7a body=3f2c953 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(DeviceActionType)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/DisplayHomeConfigContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/DisplayHomeConfigContributor.cs
index e7613a29..8e5ef2e8 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/DisplayHomeConfigContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/DisplayHomeConfigContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a contributor that supplies entity map configuration related to display home functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=c0118a2 -->
 public class DisplayHomeConfigContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="CardConfig"/> and <see cref="RowCardConfig"/> types if they are not already registered, configuring MongoDB serialization with custom element names, default values, null-ignore behavior, and string-based enum serialization.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=ede7ae5 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(CardConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/DisplayMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/DisplayMapContributor.cs
index 5f4eb8ef..5116380c 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/DisplayMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/DisplayMapContributor.cs
@@ -14,12 +14,14 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping pipeline for display scenarios.
 /// </remarks>
+/// <!-- aidoc:v1 sig=82df8a4 -->
 public class DisplayMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for display-related types (Display, DisplayNurse, StandarDisplay, SmartDisplay, PumpDisplay, DisplayConfig, and GroupedField) used for MongoDB serialization.
     /// </summary>
     /// <remarks>Configures polymorphic deserialization for DisplayConfig by declaring its known subtypes, sets custom element names for identifiers, applies default values for enum and collection members, omits null or unmapped properties, and uses string-based enum serialization where applicable. Each registration is guarded so it only occurs when the corresponding class map has not already been registered.</remarks>
+    /// <!-- aidoc:v1 sig=d4dea7a body=de9db08 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Display)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/FormMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/FormMapContributor.cs
index 2daf0fb3..11a2935e 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/FormMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/FormMapContributor.cs
@@ -8,11 +8,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Represents a contributor responsible for providing form-related mapping logic for entities.
 /// Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping process.
 /// </summary>
+/// <!-- aidoc:v1 sig=307c91c -->
 public class FormMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="FormConfig"/> and <see cref="FormItemOverview"/> types used during MongoDB serialization, configuring default values and conditional serialization rules for their members. Each class map is only registered if it has not already been registered, preventing duplicate registrations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=46140e0 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(FormConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/GraphMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/GraphMapContributor.cs
index afc03a7d..a6bbd8bd 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/GraphMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/GraphMapContributor.cs
@@ -13,11 +13,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> contract to participate in entity map configuration within a graph structure.
 /// </remarks>
+/// <!-- aidoc:v1 sig=014c988 -->
 public class GraphMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the application's chart, graph, and legend configuration types, configuring serialization behavior such as default values, null-ignoring, and enum string serialization. Each registration is guarded by an <see cref="BsonClassMap.IsClassMapRegistered"/> check so the method is idempotent and can be safely called multiple times.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=f960e13 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(GraphLayout)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/HeaderMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/HeaderMapContributor.cs
index 83a89fc8..9d058e51 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/HeaderMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/HeaderMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> interface to contribute mapping behavior within the entity mapping pipeline.
 /// </remarks>
+/// <!-- aidoc:v1 sig=35165d0 -->
 public class HeaderMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="HeaderConfig"/> type and its nested <see cref="HeaderConfig.HeaderItem"/> type with the MongoDB BsonClassMap serializer, configuring default values and null-ignore behavior for their members. Registration is performed only if a class map for the corresponding type has not already been registered, preventing duplicate registrations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=8e9a2db -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(HeaderConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/Interfaz/IEntityMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/Interfaz/IEntityMapContributor.cs
index 3166dbc9..a5feeae8 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/Interfaz/IEntityMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/Interfaz/IEntityMapContributor.cs
@@ -8,5 +8,6 @@ public interface IEntityMapContributor
     /// <summary>
     /// Registers the object-to-object mappings used by the application.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7010724 -->
     void RegisterMaps();
 }
\ No newline at end of file
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/MasterListMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/MasterListMapContributor.cs
index ccd69ec1..54f6ba0d 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/MasterListMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/MasterListMapContributor.cs
@@ -13,11 +13,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Use this contributor when defining or extending the mapping configuration associated with master list entities.
 /// </remarks>
+/// <!-- aidoc:v1 sig=267a909 -->
 public class MasterListMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for domain types (such as <see cref="Element"/>, <see cref="OptionList"/>, <see cref="MasterList"/>, <see cref="Locale"/>, and their derived option lists) to control their MongoDB serialization. Each registration is performed only when no class map already exists for the type, and applies domain-specific settings including default values, null-ignore rules, discriminator naming, and custom serializers for enums, locale fields, and identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=2ab86d2 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Element)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/NoticeControlMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/NoticeControlMapContributor.cs
index 62ad2bed..2d9cef52 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/NoticeControlMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/NoticeControlMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping process.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8f137ce -->
 public class NoticeControlMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the <see cref="Notice"/>, <see cref="StaffInfo"/>, and <see cref="MedicalStaffConfig"/> types if they have not already been registered, configuring element names, automatic mapping, and null-ignore behavior where applicable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=396c412 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Notice)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/ObsUnitMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/ObsUnitMapContributor.cs
index ae2551f7..d7b9b4ac 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/ObsUnitMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/ObsUnitMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Used to register or supply mapping logic specific to observation unit entities within the entity mapping framework.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d230120 -->
 public class ObsUnitMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="ConfigUnits"/> and <see cref="ConfigUnitItem"/> types if they have not already been registered, configuring how their members are serialized to MongoDB documents.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=1889b71 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(ConfigUnits)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/ObservationMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/ObservationMapContributor.cs
index 6c591396..bfd37816 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/ObservationMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/ObservationMapContributor.cs
@@ -17,11 +17,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements the <see cref="IEntityMapContributor"/> interface to participate in the entity mapping process.
 /// </remarks>
+/// <!-- aidoc:v1 sig=523871d -->
 public class ObservationMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the observation-related domain types used by the application. Each registration is guarded by an <see cref="BsonClassMap.IsClassMapRegistered"/> check so the method is safe to invoke multiple times, configuring element names, ignoring null members, unmapping non-persisted members, and supplying custom enum and complex-object serializers where required.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=8d212dc -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(BasePatientObservation)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/PatientMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/PatientMapContributor.cs
index f64ba04c..25c35c41 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/PatientMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/PatientMapContributor.cs
@@ -12,11 +12,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a contributor that participates in the mapping configuration of the <see cref="Patient"/> entity by implementing the <see cref="IEntityMapContributor"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=8b04747 -->
 public class PatientMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for the domain model types (Patient, Person, PatientLocation, and related entities) to configure their MongoDB serialization, including auto-mapping, null-value handling, enum string serialization, dictionary serialization, and ID member mapping. Skips registration for types that already have a registered class map.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=641507d -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(HistoricalLocation)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/PoCMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/PoCMapContributor.cs
index 5145ac11..21c25ab5 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/PoCMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/PoCMapContributor.cs
@@ -15,11 +15,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// This class serves as a demonstrative or experimental implementation of entity map contribution behavior, intended to validate the contract defined by <see cref="IEntityMapContributor"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=83c8bce -->
 public class PoCMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for PointOfCare-related types (PointOfCare, PointOfCareConfiguration, PoCMapping, PoCMappingItem, and PoCSettings) with the MongoDB driver, configuring serialization options such as element names, default values, null handling, and enum string serialization. Each registration is performed only if a class map for the type has not already been registered.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=61fe9cc -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(PointOfCare)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/PumpMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/PumpMapContributor.cs
index 9509962e..2f9d7f4b 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/PumpMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/PumpMapContributor.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps
     /// <summary>
     /// Represents a contributor that provides mapping logic for pump-related entities within an entity mapping context.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6c4bb57 -->
     public class PumpMapContributor : IEntityMapContributor
     {
         /// <summary>
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/RelayContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/RelayContributor.cs
index 4ec48b5f..05665661 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/RelayContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/RelayContributor.cs
@@ -11,11 +11,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// Provides an entity map contributor that relays or forwards mapping contributions from an underlying source.
 /// Implements the <see cref="IEntityMapContributor"/> contract to participate in entity mapping workflows.
 /// </summary>
+/// <!-- aidoc:v1 sig=f4d7c5f -->
 public class RelayContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers the BSON class map for the <see cref="Relay"/> type, defining how its properties are serialized and stored in MongoDB. The registration is performed only when no class map is already registered for the type, and it configures default values, string-based enum serialization, and null-ignoring behavior for optional members.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=ef76204 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Relay)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/RowMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/RowMapContributor.cs
index 129e88dd..356d9c21 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/RowMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/RowMapContributor.cs
@@ -10,11 +10,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Provides row-level mapping contributions to the entity mapping process by implementing the IEntityMapContributor interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=dd4ceaa -->
 public class RowMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for <see cref="RowBoxLayout"/>, <see cref="RowDetailsConfig"/>, and <see cref="ObservationRowBoxLayout"/>, configuring default values, enum string serialization, and null-ignoring behavior for nullable members. Each map is registered only if no class map has already been registered for the corresponding type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=c469476 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(RowBoxLayout)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/SectionMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/SectionMapContributor.cs
index cee63d07..2e9ac915 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/SectionMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/SectionMapContributor.cs
@@ -11,11 +11,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents a contributor that participates in section-based entity mapping by implementing the <see cref="IEntityMapContributor"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=aa1d4dc -->
 public class SectionMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers the BSON class maps for the <see cref="Section"/>, <see cref="Section.SectionItem"/>, <see cref="SectionConfig"/>, and <see cref="MinimalDisplaySection"/> types, configuring their MongoDB serialization behavior such as required fields, default values, null-ignoring members, and custom serializers. Each class map is registered only if it has not already been registered, preventing duplicate registrations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=affbd84 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Section)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/ServiceConfigMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/ServiceConfigMapContributor.cs
index edd8e5aa..08601fb5 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/ServiceConfigMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/ServiceConfigMapContributor.cs
@@ -7,11 +7,13 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Represents an entity map contributor that provides mapping configuration for service configuration entities.
 /// </summary>
+/// <!-- aidoc:v1 sig=519c23e -->
 public class ServiceConfigMapContributor : IEntityMapContributor
 {
     /// <summary>
     /// Registers BSON class maps for service configuration-related types, including <see cref="ServiceConfig"/>, <see cref="ServiceConfigService"/>, <see cref="ServiceConfigServiceSection"/>, <see cref="ServiceConfigTheme"/>, and <see cref="ServiceConfigThemeTimetable"/>, configuring their serialization elements, default values, and null-ignoring behavior. Each registration is guarded by a check that ensures the map is only registered if it has not been registered previously.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=1ad65b5 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(ServiceConfig)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/StandardMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/StandardMapContributor.cs
index 4032dbb8..6dfb7d89 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/StandardMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/StandardMapContributor.cs
@@ -7,6 +7,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <summary>
 /// Provides a standard implementation of the <see cref="IEntityMapContributor"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=70505b3 -->
 public class StandardMapContributor : IEntityMapContributor
 {
     /// <summary>
@@ -15,6 +16,7 @@ public class StandardMapContributor : IEntityMapContributor
     /// <see cref="UiFontData"/>, several nullable UI configuration members are configured to be ignored
     /// when null to avoid persisting default values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=af00a54 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(HistoricalConfigChanges)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/TreatmentMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/TreatmentMapContributor.cs
index c7ee86ab..2e4b7e47 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/TreatmentMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/TreatmentMapContributor.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// </summary>
 /// <remarks>
 /// This class is intended to be used as a mapping contributor within an entity mapping pipeline, providing configuration logic specific to treatment entities.</remarks>
+/// <!-- aidoc:v1 sig=a2b6bde -->
 public class TreatmentMapContributor : IEntityMapContributor
 {
     /// <summary>
@@ -23,6 +24,7 @@ public class TreatmentMapContributor : IEntityMapContributor
     /// define custom element names, default values, null-ignoring behavior, and specialized
     /// serializers for object identifiers and enum values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=1238a51 -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(PatientTreatment)))
diff --git a/adas-core.Infrastructure/Utils/MongoMaps/UnitMapContributor.cs b/adas-core.Infrastructure/Utils/MongoMaps/UnitMapContributor.cs
index af5b19e9..288fc9fc 100644
--- a/adas-core.Infrastructure/Utils/MongoMaps/UnitMapContributor.cs
+++ b/adas-core.Infrastructure/Utils/MongoMaps/UnitMapContributor.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils.MongoMaps;
 /// <remarks>
 /// Implements <see cref="IEntityMapContributor"/> to integrate unit-specific mapping logic into the entity mapping pipeline.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a1e9636 -->
 public class UnitMapContributor : IEntityMapContributor
 {
     /// <summary>
@@ -20,6 +21,7 @@ public class UnitMapContributor : IEntityMapContributor
     /// Each registration is performed only if no class map has been previously registered for the target type, and configures
     /// field-level mappings, default values, ignored properties, and custom serializers as required by the domain model.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4dea7a body=13d9ecf -->
     public void RegisterMaps()
         {
             if (!BsonClassMap.IsClassMapRegistered(typeof(Unit)))
diff --git a/adas-core.Infrastructure/Utils/MongoUtils.cs b/adas-core.Infrastructure/Utils/MongoUtils.cs
index 87371cd7..299ab0dc 100644
--- a/adas-core.Infrastructure/Utils/MongoUtils.cs
+++ b/adas-core.Infrastructure/Utils/MongoUtils.cs
@@ -7,6 +7,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <summary>
 /// Provides utility methods for interacting with MongoDB.
 /// </summary>
+/// <!-- aidoc:v1 sig=b90fd42 -->
 public class MongoUtils
 {
     /// <summary>
diff --git a/adas-core.Infrastructure/Utils/PatientObservationAlarmConverter.cs b/adas-core.Infrastructure/Utils/PatientObservationAlarmConverter.cs
index 16a7db9f..b7c9c8bc 100644
--- a/adas-core.Infrastructure/Utils/PatientObservationAlarmConverter.cs
+++ b/adas-core.Infrastructure/Utils/PatientObservationAlarmConverter.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <remarks>
 /// Implements <see cref="IBsonSerializer"/> to provide BSON serialization and deserialization support for <see cref="PatientObservationAlarm"/> objects.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a512928 -->
 public class PatientObservationAlarmConverter : JsonConverter<PatientObservationAlarm>, IBsonSerializer
 {
     /// <summary>
@@ -22,6 +23,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// <param name="args">The deserialization arguments that influence how the value is read and converted.</param>
     /// <returns>The deserialized .NET object produced from the BSON input.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the deserialization logic has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=2a74dda body=bfa6f2f -->
     public object Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
         {
             throw new NotImplementedException();
@@ -34,6 +36,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// <param name="args">The BSON serialization arguments containing additional information that influences the serialization behavior.</param>
     /// <param name="value">The object to be serialized into BSON.</param>
     /// <exception cref="System.NotImplementedException">Thrown because the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=bd1484e body=bfa6f2f -->
     public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
         {
             throw new NotImplementedException();
@@ -50,6 +53,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// <param name="hasExistingValue">Indicates whether <paramref name="existingValue"/> contains a value to be used during deserialization.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used for nested object deserialization.</param>
     /// <returns>A <see cref="PatientObservationAlarm"/> populated from the JSON, or <c>null</c> if the JSON token is <see cref="JsonToken.Null"/>.</returns>
+    /// <!-- aidoc:v1 sig=db7e773 body=9079bf3 -->
     public override PatientObservationAlarm? ReadJson(JsonReader reader, Type objectType,
             PatientObservationAlarm? existingValue,
             bool hasExistingValue, JsonSerializer serializer)
@@ -77,6 +81,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// <param name="writer">The <see cref="JsonWriter"/> to which the JSON output is written.</param>
     /// <param name="value">The object to serialize; if <see langword="null"/>, the method performs no action.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used to assist with the conversion.</param>
+    /// <!-- aidoc:v1 sig=9ef717f body=5f30748 -->
     public new void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -100,6 +105,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// </summary>
     /// <param name="value">The object instance whose type is inspected to locate the target property.</param>
     /// <param name="propertyName">The name of the property to which the <see cref="StringEnumConverter"/> attribute will be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -132,6 +138,7 @@ public class PatientObservationAlarmConverter : JsonConverter<PatientObservation
     /// <param name="value">The PatientObservationAlarm value to serialize.</param>
     /// <param name="serializer">The JsonSerializer used during the serialization process.</param>
     /// <exception cref="NotImplementedException">The method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=1687013 body=bfa6f2f -->
     public override void WriteJson(JsonWriter writer, PatientObservationAlarm? value, JsonSerializer serializer)
         {
             throw new NotImplementedException();
diff --git a/adas-core.Infrastructure/Utils/PatientObservationConverter.cs b/adas-core.Infrastructure/Utils/PatientObservationConverter.cs
index 297a33fc..cc867547 100644
--- a/adas-core.Infrastructure/Utils/PatientObservationConverter.cs
+++ b/adas-core.Infrastructure/Utils/PatientObservationConverter.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <remarks>
 /// The optional <see cref="Type"/> constructor parameter specifies the target value type used during conversion.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b25ac53 -->
 public class PatientObservationConverter(Type? valueType) : JsonConverter<PatientObservation>, IBsonSerializer
 {
     /// <summary>
@@ -22,6 +23,8 @@ public class PatientObservationConverter(Type? valueType) : JsonConverter<Patien
     /// <param name="args">The deserialization arguments containing additional information for the operation.</param>
     /// <returns>An object representing the deserialized value.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method is not yet implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary states the method 'Deserializes a BSON value', but the implementation only throws NotImplementedException and does not perform any deserialization." -->
     public object Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
         {
             throw new NotImplementedException();
@@ -34,6 +37,7 @@ public class PatientObservationConverter(Type? valueType) : JsonConverter<Patien
     /// <param name="args">The BSON serialization arguments containing additional information that may influence the serialization process.</param>
     /// <param name="value">The object to be serialized into BSON.</param>
     /// <exception cref="NotImplementedException">Thrown because the serialization logic has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=bd1484e body=bfa6f2f -->
     public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
         {
             throw new NotImplementedException();
@@ -47,6 +51,7 @@ public class PatientObservationConverter(Type? valueType) : JsonConverter<Patien
     /// <param name="writer">The JSON writer that receives the serialized output.</param>
     /// <param name="value">The patient observation to serialize. When <c>null</c>, the method performs no serialization.</param>
     /// <param name="serializer">The JSON serializer used during the conversion process.</param>
+    /// <!-- aidoc:v1 sig=272998e body=b3fc129 -->
     public override void WriteJson(JsonWriter writer, PatientObservation? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -66,6 +71,7 @@ public class PatientObservationConverter(Type? valueType) : JsonConverter<Patien
     /// </summary>
     /// <param name="value">The object instance whose property should be annotated.</param>
     /// <param name="propertyName">The name of the property to which the StringEnumConverter attribute should be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -101,6 +107,7 @@ public class PatientObservationConverter(Type? valueType) : JsonConverter<Patien
     /// <param name="serializer">The <see cref="JsonSerializer"/> used to read nested values.</param>
     /// <returns>A <see cref="PatientObservation"/> instance produced from the JSON.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=d5b4252 body=bfa6f2f -->
     public override PatientObservation ReadJson(JsonReader reader, Type objectType, PatientObservation? existingValue,
             bool hasExistingValue, JsonSerializer serializer)
         {
diff --git a/adas-core.Infrastructure/Utils/PatientPumpObservationConverter.cs b/adas-core.Infrastructure/Utils/PatientPumpObservationConverter.cs
index 2654bbfd..3a9bc03e 100644
--- a/adas-core.Infrastructure/Utils/PatientPumpObservationConverter.cs
+++ b/adas-core.Infrastructure/Utils/PatientPumpObservationConverter.cs
@@ -12,6 +12,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <summary>
 /// Provides JSON conversion for <see cref="PumpObservation"/> instances and supports BSON serialization through the <see cref="IBsonSerializer"/> interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=8967a45 -->
 public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, IBsonSerializer
 {
     /// <summary>
@@ -21,6 +22,7 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// <param name="args">The deserialization arguments containing additional settings for the operation.</param>
     /// <returns>The deserialized object.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the deserialization logic has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=2a74dda body=bfa6f2f -->
     public object Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
         {
             throw new NotImplementedException();
@@ -34,6 +36,7 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// <param name="args">The BSON serialization arguments that influence the serialization behavior.</param>
     /// <param name="value">The object to be serialized into BSON.</param>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=bd1484e body=bfa6f2f -->
     public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
         {
             throw new NotImplementedException();
@@ -52,6 +55,7 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// <param name="serializer">The <see cref="JsonSerializer"/> used for deserialization.</param>
     /// <returns>A <see cref="PumpObservation"/> instance reconstructed from the JSON data.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=5a89314 body=bfa6f2f -->
     public override PumpObservation ReadJson(JsonReader reader, Type objectType,
             PumpObservation? existingValue,
             bool hasExistingValue, JsonSerializer serializer)
@@ -65,6 +69,8 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// <param name="writer">The JSON writer to which the serialized object is written.</param>
     /// <param name="value">The object to serialize; if null, the method does nothing.</param>
     /// <param name="serializer">The JSON serializer used as context for the conversion.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The 'serializer' parameter is documented as 'The JSON serializer used as context for the conversion', but it is never referenced anywhere in the method body (the JSON is written via JObject.FromObject and jo.WriteTo, neither of which uses this argument)." -->
     public new void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -89,6 +95,7 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// <param name="value">The <see cref="PumpObservation"/> to serialize, or <see langword="null"/> if no value is available.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> providing serialization context and options.</param>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=6f585c5 body=bfa6f2f -->
     public override void WriteJson(JsonWriter writer, PumpObservation? value, JsonSerializer serializer)
         {
             throw new NotImplementedException();
@@ -99,6 +106,7 @@ public class PatientPumpObservationConverter : JsonConverter<PumpObservation>, I
     /// </summary>
     /// <param name="value">The object instance whose property will be inspected for the attribute.</param>
     /// <param name="propertyName">The name of the property to which the converter attribute will be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
diff --git a/adas-core.Infrastructure/Utils/PersonConverter.cs b/adas-core.Infrastructure/Utils/PersonConverter.cs
index 862669d6..9a15a704 100644
--- a/adas-core.Infrastructure/Utils/PersonConverter.cs
+++ b/adas-core.Infrastructure/Utils/PersonConverter.cs
@@ -13,6 +13,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <remarks>
 /// The primary constructor accepts a <see cref="Type"/> that represents the value type associated with this converter.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b735b04 -->
 public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSerializer
 {
     /// <summary>
@@ -22,6 +23,7 @@ public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSeria
     /// <param name="args">The BSON deserialization arguments.</param>
     /// <returns>The deserialized object.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=2a74dda body=bfa6f2f -->
     public object Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
         {
             throw new NotImplementedException();
@@ -34,6 +36,7 @@ public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSeria
     /// <param name="args">The BSON serialization arguments containing additional settings for the serialization.</param>
     /// <param name="value">The object to be serialized to BSON.</param>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=bd1484e body=bfa6f2f -->
     public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
         {
             throw new NotImplementedException();
@@ -47,6 +50,8 @@ public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSeria
     /// <param name="writer">The <see cref="JsonWriter"/> to which the JSON representation is written.</param>
     /// <param name="value">The <see cref="Person"/> instance to serialize. If <see langword="null"/>, the method returns without writing anything.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used during the conversion to a <see cref="JObject"/>.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The documentation states the `serializer` parameter is 'used during the conversion to a JObject', but `JObject.FromObject(value)` is invoked without passing `serializer`, so the parameter is unused in the method body." -->
     public override void WriteJson(JsonWriter writer, Person? value, JsonSerializer serializer)
         {
             if (value == null) return;
@@ -64,6 +69,7 @@ public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSeria
     /// </summary>
     /// <param name="value">The object instance whose property's attributes will be inspected and modified.</param>
     /// <param name="propertyName">The name of the property to which the converter attribute will be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=f8f9f45 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -96,6 +102,7 @@ public class PersonConverter(Type valueType) : JsonConverter<Person>, IBsonSeria
     /// <param name="serializer">The <see cref="JsonSerializer"/> calling the method.</param>
     /// <returns>A <see cref="Person"/> instance deserialized from the JSON.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=e413d58 body=bfa6f2f -->
     public override Person ReadJson(JsonReader reader, Type objectType, Person? existingValue, bool hasExistingValue,
             JsonSerializer serializer)
         {
diff --git a/adas-core.Infrastructure/Utils/RabbitConsumerErrorStrategy.cs b/adas-core.Infrastructure/Utils/RabbitConsumerErrorStrategy.cs
index faab08bc..41b4d4a3 100644
--- a/adas-core.Infrastructure/Utils/RabbitConsumerErrorStrategy.cs
+++ b/adas-core.Infrastructure/Utils/RabbitConsumerErrorStrategy.cs
@@ -11,6 +11,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <summary>
 /// Handles errors that occur during RabbitMQ message consumption and publishes them using the configured publisher service.
 /// </summary>
+/// <!-- aidoc:v1 sig=5b1d5b6 -->
 public class RabbitConsumerErrorHandler(IPublisherService publisherService)
 {
     private const int MaxRetries = 2;
@@ -24,6 +25,7 @@ public class RabbitConsumerErrorHandler(IPublisherService publisherService)
     /// <param name="message">The deserialized message whose body is inspected or re-serialized for retry handling.</param>
     /// <param name="receivedInfo">Information about the message receipt, passed to the retry handler.</param>
     /// <param name="next">The asynchronous delegate representing the next step in the processing pipeline.</param>
+    /// <!-- aidoc:v1 sig=f916bf0 body=5a18c25 -->
     public async Task HandleAsync<T>(
             Message<T> message,
             MessageReceivedInfo receivedInfo,
@@ -127,6 +129,7 @@ public class RabbitConsumerErrorHandler(IPublisherService publisherService)
     /// </summary>
     /// <param name="properties">The message properties whose headers are inspected for the "retries" entry.</param>
     /// <returns>The number of retries parsed from the "retries" header, or 0 if the header is absent or not a byte array.</returns>
+    /// <!-- aidoc:v1 sig=d7573fc body=b1a585f -->
     private int GetRetries(MessageProperties properties)
         {
             if (properties.Headers != null &&
@@ -148,6 +151,7 @@ public class RabbitConsumerErrorHandler(IPublisherService publisherService)
     /// <param name="exception">The exception that was raised, whose message is included in the error payload.</param>
     /// <param name="headers">The headers to associate with the resulting error message.</param>
     /// <returns>A <see cref="Message{Error}"/> containing the constructed error and the propagated message properties.</returns>
+    /// <!-- aidoc:v1 sig=250e4be body=a4fe29e -->
     private static Message<Error> CreateErrorMessage(
             MessageReceivedInfo receivedInfo,
             MessageProperties originalProperties,
diff --git a/adas-core.Infrastructure/Utils/RabbitIErrorMessageSerializer.cs b/adas-core.Infrastructure/Utils/RabbitIErrorMessageSerializer.cs
index 978cec7c..de15ca33 100644
--- a/adas-core.Infrastructure/Utils/RabbitIErrorMessageSerializer.cs
+++ b/adas-core.Infrastructure/Utils/RabbitIErrorMessageSerializer.cs
@@ -10,6 +10,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <remarks>
 /// This class serves as the RabbitMQ-specific concrete realization of the <see cref="IErrorMessageSerializer"/> contract.
 /// </remarks>
+/// <!-- aidoc:v1 sig=5b2b904 -->
 public class RabbitIErrorMessageSerializer : IErrorMessageSerializer
 {
     /// <summary>
@@ -18,6 +19,7 @@ public class RabbitIErrorMessageSerializer : IErrorMessageSerializer
     /// </summary>
     /// <param name="messageBody">The JSON-encoded string to unescape and convert.</param>
     /// <returns>A UTF-8 encoded byte array of the unescaped string, or <c>null</c> if the deserialized value is <c>null</c>.</returns>
+    /// <!-- aidoc:v1 sig=2d425b0 body=db8f7f7 -->
     public byte[]? Deserialize(string messageBody)
         {
             var unescapedJsonString = JsonConvert.DeserializeObject<string>(messageBody);
@@ -30,6 +32,7 @@ public class RabbitIErrorMessageSerializer : IErrorMessageSerializer
     /// </summary>
     /// <param name="messageBody">The raw byte array representing the message body to be deserialized.</param>
     /// <returns>The deserialized JSON string if successful; otherwise, the raw UTF-8 decoded string. Returns <see langword="null"/> if the deserialized JSON value is null.</returns>
+    /// <!-- aidoc:v1 sig=7a0ebce body=0ec9d3f -->
     public string? Serialize(byte[] messageBody)
         {
             var stringifiedMsgBody = Encoding.UTF8.GetString(messageBody);
diff --git a/adas-core.Infrastructure/Utils/TypesUtils.cs b/adas-core.Infrastructure/Utils/TypesUtils.cs
index af971249..c9f608d4 100644
--- a/adas-core.Infrastructure/Utils/TypesUtils.cs
+++ b/adas-core.Infrastructure/Utils/TypesUtils.cs
@@ -5,6 +5,7 @@ namespace adas_core.Infrastructure.Utils;
 /// <summary>
 /// Provides static utility methods for working with types.
 /// </summary>
+/// <!-- aidoc:v1 sig=9113a6d -->
 public static class TypesUtils
 {
     /// <summary>
@@ -15,6 +16,7 @@ public static class TypesUtils
     /// <param name="device">The specific device identifier used when resolving the driver type.</param>
     /// <returns>The <see cref="Type"/> of the driver that corresponds to the given device type.</returns>
     /// <exception cref="AdasException">Thrown when the provided <paramref name="deviceType"/> is not a recognized value.</exception>
+    /// <!-- aidoc:v1 sig=fffff40 body=77d9a24 -->
     public static Type GetDriver(string deviceType, string device)
         {
             return deviceType switch
diff --git a/adas-core.LdapLogin/Configuration/LDAPModule.cs b/adas-core.LdapLogin/Configuration/LDAPModule.cs
index f729fcdf..7f8951a7 100644
--- a/adas-core.LdapLogin/Configuration/LDAPModule.cs
+++ b/adas-core.LdapLogin/Configuration/LDAPModule.cs
@@ -7,6 +7,7 @@ namespace adas_core.LdapLogin.Configuration;
 /// <summary>
 /// Module for configuring LDAP services and dependencies.
 /// </summary>
+/// <!-- aidoc:v1 sig=4b93bc4 -->
 public class LdapModule : IModule
 {
     /// <summary>
@@ -14,6 +15,7 @@ public class LdapModule : IModule
     /// </summary>
     /// <param name="services">The service collection to which LDAP services will be added.</param>
     /// <param name="configuration">The configuration from which LDAP settings will be read.</param>
+    /// <!-- aidoc:v1 sig=a0a5f7c body=020607b -->
     public static void Configure(IServiceCollection services, IConfiguration configuration)
     {
         var configSection = configuration.GetSection("Ldap");
diff --git a/adas-core.LdapLogin/Configuration/LdapConfig.cs b/adas-core.LdapLogin/Configuration/LdapConfig.cs
index 4d0365a8..139de218 100644
--- a/adas-core.LdapLogin/Configuration/LdapConfig.cs
+++ b/adas-core.LdapLogin/Configuration/LdapConfig.cs
@@ -5,6 +5,7 @@ namespace adas_core.LdapLogin.Configuration;
 /// <summary>
 /// Configuration class for LDAP authentication settings, including server details, user properties, and authority mappings.
 /// </summary>
+/// <!-- aidoc:v1 sig=d33199f -->
 public class LdapConfig
 {
     /// <summary>
@@ -86,6 +87,7 @@ public class LdapConfig
 /// <summary>
 /// Represents a user in the LDAP authentication context, including their name, username, role, allowed actions, and an optional display ID for user-friendly identification.
 /// </summary>
+/// <!-- aidoc:v1 sig=5a274ab -->
 public class UserLdap
 {
     /// <summary>
@@ -120,6 +122,7 @@ public class UserLdap
 /// <summary>
 /// Represents a mapping between an LDAP group and an application role, including the group name, corresponding role, allowed actions, and an optional display ID for user-friendly identification.
 /// </summary>
+/// <!-- aidoc:v1 sig=b4aef6f -->
 public class AuthorityMap
 {
     /// <summary>
diff --git a/adas-core.LdapLogin/Configuration/LdapConfigValidator.cs b/adas-core.LdapLogin/Configuration/LdapConfigValidator.cs
index c1ec2e98..b3da4b5a 100644
--- a/adas-core.LdapLogin/Configuration/LdapConfigValidator.cs
+++ b/adas-core.LdapLogin/Configuration/LdapConfigValidator.cs
@@ -5,6 +5,7 @@ namespace adas_core.LdapLogin.Configuration;
 /// <summary>
 /// Validator for LdapConfig. Ensures that all required properties are set and valid.
 /// </summary>
+/// <!-- aidoc:v1 sig=2b5ea58 -->
 public class LdapConfigValidator : AbstractValidator<LdapConfig>
 {
     //public LdapConfigValidator()
diff --git a/adas-core.LdapLogin/IModule.cs b/adas-core.LdapLogin/IModule.cs
index 9a7446fb..6600f7c1 100644
--- a/adas-core.LdapLogin/IModule.cs
+++ b/adas-core.LdapLogin/IModule.cs
@@ -13,6 +13,8 @@ public interface IModule
     /// </summary>
     /// <param name="services"></param>
     /// <param name="configuration"></param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the method configures services for LDAP login functionality, but the method body is empty and performs no configuration." -->
     static void Configure(IServiceCollection services, IConfiguration configuration)
     {
     }
diff --git a/adas-core.LdapLogin/LdapLoginService.cs b/adas-core.LdapLogin/LdapLoginService.cs
index a27cbef8..20505824 100644
--- a/adas-core.LdapLogin/LdapLoginService.cs
+++ b/adas-core.LdapLogin/LdapLoginService.cs
@@ -19,6 +19,7 @@ namespace adas_core.LdapLogin;
 /// The service also handles the creation of new users in the application if they do not already exist, based on the LDAP information. 
 /// It uses configuration settings for connecting to the LDAP server and for mapping LDAP attributes to user properties and authorities.
 /// </summary>
+/// <!-- aidoc:v1 sig=4e5637f -->
 public class LdapLoginService : ILoginService
 {
     /// <summary>
@@ -50,6 +51,7 @@ public class LdapLoginService : ILoginService
     /// <param name="userService">The user service for managing user information.</param>
     /// <param name="authorityService">The authority service for managing user authorities.</param>
     /// <param name="logger">The logger for logging LDAP login operations.</param>
+    /// <!-- aidoc:v1 sig=f1b8e4e body=6c4718f -->
     public LdapLoginService(
         IOptions<LdapConfig> ldapConfig,
         IValidator<LdapConfig> validator,
@@ -82,6 +84,7 @@ public class LdapLoginService : ILoginService
     /// <returns>The authenticated user.</returns>
     /// <exception cref="LoginServicesException">Thrown when there is an error during the login process.</exception>
     /// <exception cref="UserNotFoundException">Thrown when the user is not found in the LDAP directory.</exception>
+    /// <!-- aidoc:v1 sig=bdfb451 body=f368622 -->
     public async Task<User> Login(string username, string password)
     {
         // Check for LDAP config
@@ -168,6 +171,7 @@ public class LdapLoginService : ILoginService
     /// <param name="context">The HTTP context of the request.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=8e7513e body=bc29d1d -->
     public Task<User> Login(HttpContext context)
     {
         throw new LoginServicesException("Not implemented");
@@ -180,6 +184,8 @@ public class LdapLoginService : ILoginService
     /// <param name="password">The password of the user to authenticate.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The documentation describes the return as 'A task representing the asynchronous operation' but does not mention that the Task wraps a User object (Task<User>)." -->
     public Task<User> Authenticate(string username, string password)
     {
         throw new LoginServicesException("Not implemented");
@@ -191,6 +197,7 @@ public class LdapLoginService : ILoginService
     /// <param name="id">The ID of the user to retrieve.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=4805967 body=bc29d1d -->
     public Task<User?> GetById(ObjectId id)
     {
         throw new LoginServicesException("Not implemented");
@@ -202,6 +209,7 @@ public class LdapLoginService : ILoginService
     /// <param name="email">The email of the user to retrieve.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=0032e56 body=bc29d1d -->
     public Task<User?> GetByEmail(string email)
     {
         throw new LoginServicesException("Not implemented");
@@ -213,6 +221,7 @@ public class LdapLoginService : ILoginService
     /// <param name="username">The username of the user to retrieve.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=1abddfb body=bc29d1d -->
     public Task<User?> GetByUsername(string username)
     {
         throw new LoginServicesException("Not implemented");
@@ -223,6 +232,7 @@ public class LdapLoginService : ILoginService
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when the method is not implemented.</exception>
+    /// <!-- aidoc:v1 sig=f55d943 body=bc29d1d -->
     public Task<List<User>> GetAllUsers()
     {
         throw new LoginServicesException("Not implemented");
@@ -235,6 +245,7 @@ public class LdapLoginService : ILoginService
     /// <param name="userEntryLdap">The user information obtained from the LDAP entry.</param>
     /// <param name="entry">The LDAP entry containing the user's information.</param>
     /// <returns>The existing or newly created user with updated authorities.</returns>
+    /// <!-- aidoc:v1 sig=87de1c2 body=a43bebd -->
     private async Task<User?> GetOrCreateUser(User userEntryLdap, LdapEntry entry)
     {
         var userToReturn = (await _userService.Value.GetUserByUserName(userEntryLdap.UserName) ??
@@ -261,6 +272,7 @@ public class LdapLoginService : ILoginService
     /// <param name="user">The user whose authorities are being checked.</param>
     /// <param name="entry">The LDAP entry containing the user's information.</param>
     /// <returns>A list of updated authorities for the user.</returns>
+    /// <!-- aidoc:v1 sig=d2bafd5 body=a5b969b -->
     private async Task<List<Authorization>> CheckAuthorities(User user, LdapEntry entry)
     {
         try
@@ -311,6 +323,7 @@ public class LdapLoginService : ILoginService
     /// <param name="entry">The LDAP entry containing the user's information.</param>
     /// <param name="user">The user whose authorities are being retrieved.</param>
     /// <returns>A list of authorities for the user based on the whitelist.</returns>
+    /// <!-- aidoc:v1 sig=a8263f0 body=06efa6f -->
     private List<Authorization> GetAuthoritiesWhiteList(LdapEntry entry, User user)
     {
         try
@@ -358,6 +371,10 @@ public class LdapLoginService : ILoginService
     /// </summary>
     /// <param name="ldapEntry">The LDAP entry containing the user's information.</param>
     /// <returns>The existing or newly created user with updated authorities.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary describes retrieving authorities and mapping LDAP groups to authorities, but the code only extracts UserName, First name, and Last name from LDAP attributes." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns description mentions 'user with updated authorities', but the method returns a User with only UserName, Name (first/last), and no authorities are set." -->
     private User GetUser(LdapEntry ldapEntry)
     {
         var attributes = ldapEntry.GetAttributeSet();
@@ -405,6 +422,7 @@ public class LdapLoginService : ILoginService
     /// <param name="ldapEntry">The LDAP entry containing the user's information.</param>
     /// <param name="user">The user whose authorities are being retrieved.</param>
     /// <returns>A list of authorities for the user based on the LDAP entry and the application's configuration.</returns>
+    /// <!-- aidoc:v1 sig=1e1f0f2 body=6c48c7a -->
     private List<Authorization> GetAuthoritiesMap(LdapEntry ldapEntry, User user)
     {
         try
diff --git a/adas-core.LdapLogin/RegistrationExtension/LdapRegistration.cs b/adas-core.LdapLogin/RegistrationExtension/LdapRegistration.cs
index eec798a4..4f682b02 100644
--- a/adas-core.LdapLogin/RegistrationExtension/LdapRegistration.cs
+++ b/adas-core.LdapLogin/RegistrationExtension/LdapRegistration.cs
@@ -8,6 +8,7 @@ namespace adas_core.LdapLogin.RegistrationExtension;
 /// <summary>
 /// Extension class for registering LDAP authentication services and configurations in the service collection.
 /// </summary>
+/// <!-- aidoc:v1 sig=8e86389 -->
 public static class LdapRegistration
 {
     /// <summary>
@@ -15,6 +16,7 @@ public static class LdapRegistration
     /// </summary>
     /// <param name="serviceCollection">The service collection to which LDAP services will be added.</param>
     /// <param name="configuration">The configuration from which LDAP settings will be read.</param>
+    /// <!-- aidoc:v1 sig=4c7364d body=26002c6 -->
     public static void AddLdapAuth(this IServiceCollection serviceCollection, IConfigurationRoot configuration)
     {
         serviceCollection.AddSingleton<IValidator<LdapConfig>, LdapConfigValidator>();
diff --git a/adas-core.LocalLogin/ILocalLoginRepository.cs b/adas-core.LocalLogin/ILocalLoginRepository.cs
index 45f172ce..7dbecb03 100644
--- a/adas-core.LocalLogin/ILocalLoginRepository.cs
+++ b/adas-core.LocalLogin/ILocalLoginRepository.cs
@@ -15,6 +15,7 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// Retrieves a list of all users from the MongoDB database. This method is asynchronous and returns a Task that resolves to a List of User objects.
     /// </summary>
     /// <returns>A Task that resolves to a List of User objects.</returns>
+    /// <!-- aidoc:v1 sig=52f36eb -->
     Task<List<User>> GetAll();
 
     /// <summary>
@@ -22,6 +23,7 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// </summary>
     /// <param name="id">The unique identifier of the user to retrieve.</param>
     /// <returns>A Task that resolves to a User object if found, or null if no user with the specified ID exists.</returns>
+    /// <!-- aidoc:v1 sig=ab4b64e -->
     Task<User?> GetById(ObjectId id);
 
     /// <summary>
@@ -29,6 +31,7 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// </summary>
     /// <param name="email">The email address of the user to retrieve.</param>
     /// <returns>A Task that resolves to a User object if found, or null if no user with the specified email exists.</returns>
+    /// <!-- aidoc:v1 sig=aad49e4 -->
     Task<User?> GetByEmail(string email);
 
     //User UpdateUser(User user);
@@ -41,6 +44,7 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// </summary>
     /// <param name="username">The username of the user to retrieve.</param>
     /// <returns>A Task that resolves to a User object if found, or null if no user with the specified username exists.</returns>
+    /// <!-- aidoc:v1 sig=d91b767 -->
     Task<User?> GetByUsername(string username);
 
     /// <summary>
@@ -50,6 +54,7 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// <param name="id">The unique identifier of the user to update.</param>
     /// <param name="user">The updated User object.</param>
     /// <returns>A Task that resolves to a boolean value indicating whether the update was successful (true) or not (false).</returns>
+    /// <!-- aidoc:v1 sig=43e4dd1 -->
     Task<bool> UpdateOneUserAsync(ObjectId id, User user);
 
     /// <summary>
@@ -57,5 +62,6 @@ public interface ILocalLoginRepository : IMongoRepository<User>
     /// </summary>
     /// <param name="user">The User object to insert into the database.</param>
     /// <returns>A Task that resolves to a boolean value indicating whether the insertion was successful (true) or not (false).</returns>
+    /// <!-- aidoc:v1 sig=5fbef55 -->
     Task<bool> InsertUserOneAsync(User user);
 }
\ No newline at end of file
diff --git a/adas-core.LocalLogin/LocalLoginRepository.cs b/adas-core.LocalLogin/LocalLoginRepository.cs
index e35a4a2e..796ddb6c 100644
--- a/adas-core.LocalLogin/LocalLoginRepository.cs
+++ b/adas-core.LocalLogin/LocalLoginRepository.cs
@@ -12,6 +12,7 @@ namespace adas_core.LocalLogin;
 /// Repository for handling user data in the local login system. This repository provides methods for inserting, updating, and retrieving user information from a MongoDB collection. 
 /// It also ensures that a system user is created during the initial load if it does not already exist.
 /// </summary>
+/// <!-- aidoc:v1 sig=d5e8f20 -->
 public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
 {
     /// <summary>
@@ -26,6 +27,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// </summary>
     /// <param name="apiSettings">The API settings containing configuration for the MongoDB collection name and other related settings.</param>
     /// <param name="database">The MongoDB database instance used for database operations.</param>
+    /// <!-- aidoc:v1 sig=063b436 body=12fddac -->
     public LocalLoginRepository(
         IOptions<ApiSettings> apiSettings,
         IMongoDatabase database
@@ -39,6 +41,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// Gets the name of the MongoDB collection for user data. This method overrides the base method from MongoRepository and returns the collection name specified in the API settings.
     /// </summary>
     /// <returns>The name of the MongoDB collection for user data.</returns>
+    /// <!-- aidoc:v1 sig=94e22ff body=f29d25a -->
     public override string GetCollectionName()
     {
         return _apiSettings.Users;
@@ -49,6 +52,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// </summary>
     /// <param name="user">The user object to insert into the collection.</param>
     /// <returns>True if the insertion is successful, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=4768362 body=5cf13d2 -->
     public async Task<bool> InsertUserOneAsync(User user)
     {
         try
@@ -71,6 +75,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// <param name="id">The unique identifier of the user to update.</param>
     /// <param name="user">The user object containing the updated information.</param>
     /// <returns>True if the update is successful, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=c44e9c5 body=cc0a56c -->
     public async Task<bool> UpdateOneUserAsync(ObjectId id, User user)
     {
         try
@@ -100,6 +105,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// </summary>
     /// <param name="id">The unique identifier of the user to retrieve.</param>
     /// <returns>The user object if found, or null if no user is found with the given ID.</returns>
+    /// <!-- aidoc:v1 sig=9cec1a5 body=0008abf -->
     public async Task<User?> GetById(ObjectId id)
     {
         var filter = Builders<User>.Filter.Eq(p => p.Id, id);
@@ -112,6 +118,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// </summary>
     /// <param name="email">The email address of the user to retrieve.</param>
     /// <returns>The user object if found, or null if no user is found with the given email address.</returns>
+    /// <!-- aidoc:v1 sig=16b59c7 body=a1fa87d -->
     public async Task<User?> GetByEmail(string email)
     {
         var filter = Builders<User>.Filter.Eq(p => p.Email, email);
@@ -124,6 +131,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// </summary>
     /// <param name="username">The username of the user to retrieve.</param>
     /// <returns>The user object if found, or null if no user is found with the given username.</returns>
+    /// <!-- aidoc:v1 sig=c92e57a body=1f78709 -->
     public async Task<User?> GetByUsername(string username)
     {
         var filter = Builders<User>.Filter.Eq(p => p.UserName, username);
@@ -135,6 +143,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// Retrieves all users from the MongoDB collection. This method executes a query to find all documents in the collection and returns a list of user objects.
     /// </summary>
     /// <returns>A list of all user objects in the collection.</returns>
+    /// <!-- aidoc:v1 sig=b9380e5 body=baa1e8c -->
     public async Task<List<User>> GetAll()
     {
         var result = await Collection.FindAsync(Builders<User>.Filter.Empty);
@@ -147,6 +156,7 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// It calls the GetOrCreateSystemUser method to check for the existence of the system user and insert it if necessary.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=ccdefcf body=eb41bb0 -->
     public sealed override async Task InsertInitialLoad()
     {
         await GetOrCreateSystemUser();
@@ -157,6 +167,8 @@ public class LocalLoginRepository : MongoRepository<User>, ILocalLoginRepository
     /// This method retrieves a user with the username "System" and, if no such user is found, it creates a new user with predefined credentials and inserts it into the collection.
     /// </summary>
     /// <returns>The system user object if found or created, or null if the operation fails.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The method returns Task (void), not a User object or null. The <returns> tag incorrectly claims it returns the system user or null." -->
     private async Task GetOrCreateSystemUser()
     {
         var user = await GetByUsername("System");
diff --git a/adas-core.LocalLogin/LocalLoginServiceImpl.cs b/adas-core.LocalLogin/LocalLoginServiceImpl.cs
index 9b010807..77fc2b27 100644
--- a/adas-core.LocalLogin/LocalLoginServiceImpl.cs
+++ b/adas-core.LocalLogin/LocalLoginServiceImpl.cs
@@ -15,6 +15,7 @@ namespace adas_core.LocalLogin;
 /// </summary>
 /// <param name="localLoginRepository">The repository used to access local user data.</param>
 /// <param name="authorityService">The service used to manage user authorities and permissions.</param>
+/// <!-- aidoc:v1 sig=67506c8 -->
 public class LocalLoginServiceImpl(
     ILocalLoginRepository localLoginRepository,
     IAuthorityService authorityService)
@@ -38,6 +39,7 @@ public class LocalLoginServiceImpl(
     /// <param name="password">The password of the user to authenticate.</param>
     /// <returns>The authenticated user object.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the username or password is invalid.</exception>
+    /// <!-- aidoc:v1 sig=bdfb451 body=6268a05 -->
     public async Task<User> Login(string username, string password)
     {
         var userFound = await localLoginRepository.GetByUsername(username) ??
@@ -56,6 +58,7 @@ public class LocalLoginServiceImpl(
     /// <param name="context">The HTTP context used for authentication.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="LoginServicesException">Thrown when this method is called, as it is not implemented for local login.</exception>
+    /// <!-- aidoc:v1 sig=8e7513e body=bc29d1d -->
     public Task<User> Login(HttpContext context)
     {
         throw new LoginServicesException("Not implemented");
@@ -68,6 +71,7 @@ public class LocalLoginServiceImpl(
     /// <param name="username">The username of the user to authenticate.</param>
     /// <param name="password">The password of the user to authenticate.</param>
     /// <returns>The authenticated user object, or an empty User object if authentication fails.</returns>
+    /// <!-- aidoc:v1 sig=8956af1 body=f8fd3cd -->
     public async Task<User> Authenticate(string username, string password)
     {
         try
@@ -90,6 +94,7 @@ public class LocalLoginServiceImpl(
     /// </summary>
     /// <param name="id">The unique identifier of the user to retrieve.</param>
     /// <returns>The user object if found, or null if no user is found with the given ID.</returns>
+    /// <!-- aidoc:v1 sig=9cec1a5 body=94eb30b -->
     public async Task<User?> GetById(ObjectId id)
     {
         return await localLoginRepository.GetById(id);
@@ -100,6 +105,7 @@ public class LocalLoginServiceImpl(
     /// </summary>
     /// <param name="email">The email address of the user to retrieve.</param>
     /// <returns>The user object if found, or null if no user is found with the given email.</returns>
+    /// <!-- aidoc:v1 sig=16b59c7 body=ba87a84 -->
     public async Task<User?> GetByEmail(string email)
     {
         return await localLoginRepository.GetByEmail(email);
@@ -110,6 +116,7 @@ public class LocalLoginServiceImpl(
     /// </summary>
     /// <param name="username"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=c92e57a body=a4fe5f4 -->
     public async Task<User?> GetByUsername(string username)
     {
         return await localLoginRepository.GetByUsername(username);
@@ -119,6 +126,7 @@ public class LocalLoginServiceImpl(
     /// Retrieves a list of all users from the local repository. This method queries the repository for all user records and returns them as a list. If there are no users in the repository, it returns an empty list.
     /// </summary>
     /// <returns>A list of all user objects, or an empty list if no users are found.</returns>
+    /// <!-- aidoc:v1 sig=7ea6105 body=02ca620 -->
     public async Task<List<User>> GetAllUsers()
     {
         return await localLoginRepository.GetAll();
diff --git a/adas-core.LocalLogin/RegistrationExtension/LocalLoginExtension.cs b/adas-core.LocalLogin/RegistrationExtension/LocalLoginExtension.cs
index a92b6461..4b352068 100644
--- a/adas-core.LocalLogin/RegistrationExtension/LocalLoginExtension.cs
+++ b/adas-core.LocalLogin/RegistrationExtension/LocalLoginExtension.cs
@@ -9,12 +9,14 @@ namespace adas_core.LocalLogin.RegistrationExtension;
 /// <summary>
 /// Extension class for registering local login services and repositories in the dependency injection container.
 /// </summary>
+/// <!-- aidoc:v1 sig=1d69f76 -->
 public static class LocalLoginExtension
 {
     /// <summary>
     /// Registers the local login services and repositories in the dependency injection container.
     /// </summary>
     /// <param name="serviceCollection">The service collection to which the services and repositories will be added.</param>
+    /// <!-- aidoc:v1 sig=8619947 body=8117c95 -->
     public static void AddLocalLogin(this IServiceCollection serviceCollection)
     {
         serviceCollection.AddSingleton<ILocalLoginRepository, LocalLoginRepository>();
diff --git a/adas-core.Test/Customizations/H12O/UCIN/CalculatedObservationsTest.cs b/adas-core.Test/Customizations/H12O/UCIN/CalculatedObservationsTest.cs
index e2c48dba..ff65fff8 100644
--- a/adas-core.Test/Customizations/H12O/UCIN/CalculatedObservationsTest.cs
+++ b/adas-core.Test/Customizations/H12O/UCIN/CalculatedObservationsTest.cs
@@ -34,6 +34,8 @@ public class CalculatedObservationsTest
     /// is produced for each test.
     /// </summary>
     /// <!-- aidoc:v1 sig=dee8bf2 body=3c4f27b -->
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "Summary enumerates configured IOptions settings but omits IntravenousLinesCode (intravenous lines codes), which is also assigned in the setup." -->
     [SetUp]
     public void Setup()
     {
@@ -610,6 +612,8 @@ public class CalculatedObservationsTest
     /// Verifies that when a previous <see cref="PatientObservation"/> for the same patient and location has already been removed, the intravenous calculation performed by <see cref="CalculatedObservations.Map"/> produces a result of 0.
     /// </summary>
     /// <!-- aidoc:v1 sig=ca5324a body=aae89b4 -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The documentation claims a previous observation 'has already been removed', but the mocked existing observation returned by FindLastObservations has no RemoveTime set (only Action='Insert', Duration, InsertTime, Type, and Location are populated), indicating it has not been removed." -->
     [Test]
     public async Task Calculate_Intravenous_Obs_Already_Exist_Removed_Should_Return_0()
     {
@@ -837,6 +841,8 @@ public class CalculatedObservationsTest
     /// Verifies that mapping a new <see cref="PatientObservation"/> with a "Catéter línea media" type, when two prior intravenous lines exist (one "Catéter EPICUTÁNEO PERIFÉRICO" and one "Catéter Venoso PERIFÉRICO"), inserts an <see cref="PatientObservation"/> named "IntravenousLines" with a summed value of 5 for the given <paramref name="patientId"/>.
     /// </summary>
     /// <!-- aidoc:v1 sig=1e74e0a body=1cc02b8 -->
+    /// <!-- aidoc-review:v1 severity=low kind=extra_param
+    ///      "<paramref name=\"patientId\"/> refers to a local variable; the method has no parameters" -->
     [Test]
     public async Task Calculate_Intravenous_sum_one_middle_line_and_two_Peripheral_should_return_5()
     {
diff --git a/adas-core.Test/Customizations/HPAZ/CalculatedObservationsTest.cs b/adas-core.Test/Customizations/HPAZ/CalculatedObservationsTest.cs
index 26f00186..81b821fd 100644
--- a/adas-core.Test/Customizations/HPAZ/CalculatedObservationsTest.cs
+++ b/adas-core.Test/Customizations/HPAZ/CalculatedObservationsTest.cs
@@ -26,6 +26,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Initializes mocked dependencies and configures the dependency injection container required to instantiate the <see cref="CalculatedObservations"/> service under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=d74ae8f -->
     [SetUp]
         public void Setup()
         {
@@ -114,6 +115,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that a PatientObservation with the ventilation mode "PRVC" is mapped to a calculated observation with the value "VCRP".
     /// </summary>
+    /// <!-- aidoc:v1 sig=eb9f8ec body=e44fb52 -->
     [Test]
         public async Task Calculate_Ventilation_Mode_PRVC_Returns_VCRP()
         {
@@ -137,6 +139,7 @@ public class CalculatedObservationsTest
     /// Verifies that the calculated observations mapping translates the ventilation mode value "FLUJ.ALTO" (High Flow) into the respiratory support code "OAF".
     /// Ensures that a patient observation with the name "Resp_Mode" and value "FLUJ.ALTO" produces a non-null mapped result with the expected output value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=76d5e48 body=d17dc11 -->
     [Test]
         public async Task Calculate_Ventilation_Mode_FLUJ_ALTO_Returns_OAF()
         {
@@ -159,6 +162,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a patient observation's respiratory mode is neither "PRVC" nor "FLUJ_ALTO" (for example, "VNI PC"), the calculated observation is not mapped to "VCRP" or "OAF".
     /// </summary>
+    /// <!-- aidoc:v1 sig=44eb476 body=279d733 -->
     [Test]
         public async Task Calculate_Ventilation_Mode_Not_PRVC_Not_FLUJ_ALTO_Returns_Other()
         {
@@ -188,6 +192,7 @@ public class CalculatedObservationsTest
     /// Verifies that the calculated observations mapping does not produce a Sattc_FiO2 observation
     /// when the Sattc value is 98, ensuring the calculation is suppressed for this specific input case.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c417ee7 body=b77cd07 -->
     [Test]
         public async Task CalculateSF_Sattc_98_Returns_Not_Sattc_FiO2()
         {
@@ -239,6 +244,7 @@ public class CalculatedObservationsTest
     /// Verifies that when an FiO2 observation is processed, the Oxygenation Index is calculated and inserted
     /// using the related P_VAM and PaO2_Tidal observations retrieved for the same patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3315812 body=f686108 -->
     [Test]
         public async Task CalculateOxygenationIndex_FiO2_Returns_Oxygenation_Index()
         {
@@ -297,6 +303,7 @@ public class CalculatedObservationsTest
     /// (computed as <c>P_VAM × FiO2 × 100 / PaO2</c>) that is inserted through the observation service for the same patient.
     /// </summary>
     /// <returns>A task that completes when the expected <c>Oxygenation_Index</c> observation has been inserted via the mocked observation service.</returns>
+    /// <!-- aidoc:v1 sig=da07bc9 body=502f5d7 -->
     [Test]
         public async Task CalculateOxygenationIndex_P_VAM_Returns_Oxygenation_Index()
         {
@@ -353,6 +360,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a PaO2_Tidal observation is mapped, the calculated Oxygenation_Index is derived using the formula P_VAM * FiO2 * 100 / PaO2_Tidal and persisted as an ADAS-coded observation for the same patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d5e69ac body=9ff274d -->
     [Test]
         public async Task CalculateOxygenationIndex_PaO2_Tidal_Returns_Oxygenation_Index()
         {
@@ -411,6 +419,8 @@ public class CalculatedObservationsTest
     /// is missing from the patient's most recent observations, even when a PaO2_Tidal observation is provided.
     /// Ensures that the mapping logic does not insert a new Oxygenation_Index observation in this scenario.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The doc states FiO2 is missing from recent observations, but the code mocks FindLastObservations to return FiO2 (it is present); PaO2_Tidal is the observation missing from the recent observations." -->
     [Test]
         public async Task CalculateOxygenationIndex_PaO2_Tidal_Not_Returns_Oxygenation_Index()
         {
@@ -456,6 +466,7 @@ public class CalculatedObservationsTest
     /// Verifies that the Oxygenation_Index is not calculated or persisted when the PaO2_Tidal observation value is zero.
     /// Ensures that the mapping logic skips downstream calculation and InsertObservation is never invoked in this edge case.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b4705b3 body=72f7967 -->
     [Test]
         public async Task CalculateOxygenationIndex_PaO2_Tidal_0_Not_Returns_Oxygenation_Index()
         {
@@ -513,6 +524,7 @@ public class CalculatedObservationsTest
     /// by dividing the PaO2 value by the most recent FiO2 observation for the patient and inserting the result as a new
     /// PatientObservation with the ADAS coding system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=087da9c body=91ce4a0 -->
     [Test]
         public async Task CalculatePF_PaO2_Returns_PaO2_FiO2()
         {
@@ -566,6 +578,7 @@ public class CalculatedObservationsTest
     /// when an FiO2 observation is processed, by inserting a new patient observation with the
     /// expected ratio value and coding system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=83f8636 body=46adcbd -->
     [Test]
         public async Task CalculatePF_FiO2_Returns_PaO2_FiO2()
         {
@@ -616,6 +629,7 @@ public class CalculatedObservationsTest
     /// Verifies that the PF ratio calculation does not produce a PaO2/FiO2 observation when the FiO2 value is zero.
     /// Ensures that no calculated observation is inserted for the patient under this condition.
     /// </summary>
+    /// <!-- aidoc:v1 sig=74e2fba body=e97f55c -->
     [Test]
         public async Task CalculatePF_FiO2_0_Not_Returns_PaO2_FiO2()
         {
@@ -661,6 +675,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when patient observations include a low SpO2 (Sattc) value of 50 and a low FC value of 50, the calculated observations processing triggers a BlueCode alarm by inserting the observation and sending the alarm.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cb9af03 body=d68c56c -->
     [Test]
         public async Task
             SendAlarm_BlueCode_FC_SpO2_Alarm_True_Returns_SendAlarm_BlueCode()
@@ -707,6 +722,7 @@ public class CalculatedObservationsTest
     /// Verifies that when a BlueCode alarm condition is triggered by FC and TAm observations, the calculated blue code list is generated, the observation is inserted, and the blue code alarm is sent with the expected severity and type.
     /// </summary>
     /// <returns>A task that completes when the blue code alarm verification has been executed.</returns>
+    /// <!-- aidoc:v1 sig=8d996ea body=861269c -->
     [Test]
         public async Task
             SendAlarm_BlueCode_FC_TAm_Alarm_True_Returns_SendAlarm_BlueCode()
@@ -769,6 +785,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that a BlueCode alarm is not triggered when the heart rate (FC) is at 50 and the mean arterial pressure (TAm) values do not meet the BlueCode criteria.
     /// </summary>
+    /// <!-- aidoc:v1 sig=593d4af body=9dce27f -->
     [Test]
         public async Task SendAlarm_BlueCode_FC_TAm_Alarm_False()
         {
@@ -833,6 +850,7 @@ public class CalculatedObservationsTest
     /// </summary>
     /// <param name="value">The object whose string representation will be converted to a double.</param>
     /// <returns>The parsed <see cref="double"/> value if the conversion succeeds; otherwise, <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=a1cea6b body=2180954 -->
     private static double? TryparseDouble(object value)
         {
             return double.TryParse(value.ToString(), out var valueParsed) ? valueParsed : null;
@@ -951,6 +969,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that a <see cref="PatientObservation"/> representing a pump volumetric air occlusion alarm is correctly mapped by the calculated observations mapper, returning a non-null result with a matching name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6fdcb6b body=3319cdd -->
     [Test]
         public async Task Map_PatientObservation_Alarm_Pump_Retur_obs()
         {
diff --git a/adas-core.Test/Customizations/HRYC/CalculatedObservationsTest.cs b/adas-core.Test/Customizations/HRYC/CalculatedObservationsTest.cs
index 4814d07b..72359922 100644
--- a/adas-core.Test/Customizations/HRYC/CalculatedObservationsTest.cs
+++ b/adas-core.Test/Customizations/HRYC/CalculatedObservationsTest.cs
@@ -1137,6 +1137,8 @@ public class CalculatedObservationsTest
     /// Verifies that <see cref="_calculatedObservations"/>.<see cref="ICalculatedObservations.Map(PatientObservation, bool)"/> correctly computes the diuresis-to-weight ratio as 43.6 when the latest diuresis observation value is 3924 and the current weight observation value is 90, and persists a derived <see cref="PatientObservation"/> named "Diuresis_Weight" for the same <paramref name="patientId"/>.
     /// </summary>
     /// <!-- aidoc:v1 sig=b46e7fe body=50dd2ac -->
+    /// <!-- aidoc-review:v1 severity=low kind=extra_param
+    ///      "<paramref name=\"patientId\"/> references a local variable, not a method parameter; the test method has no parameters." -->
     [Test]
     public async Task CalculateDiuresis_Weight_D_3924_Receive_W_90_Return_43_6()
     {
diff --git a/adas-core.Test/Customizations/HUVH/UCIA/CalculatedObservationsTest.cs b/adas-core.Test/Customizations/HUVH/UCIA/CalculatedObservationsTest.cs
index 512e53f8..7601f245 100644
--- a/adas-core.Test/Customizations/HUVH/UCIA/CalculatedObservationsTest.cs
+++ b/adas-core.Test/Customizations/HUVH/UCIA/CalculatedObservationsTest.cs
@@ -20,6 +20,8 @@ namespace adas_core.Test.Customizations.HUVH.UCIA;
 /// Marked with <c>TestFixture</c> and assigned <c>Order(2)</c> to control its execution sequence relative to other fixtures.
 /// </remarks>
 /// <!-- aidoc:v1 sig=d5b9e22 -->
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The summary is self-referential and circular: it claims the fixture 'validates the behavior of CalculatedObservationsTest related functionality,' but a test fixture does not validate its own behavior. The class likely tests `CalculatedObservations` functionality, not itself." -->
 [TestFixture]
 [Order(2)]
 public class CalculatedObservationsTest
@@ -29,6 +31,7 @@ public class CalculatedObservationsTest
     /// configuring a service provider with these dependencies, and instantiating the <see cref="CalculatedObservations"/>
     /// class under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=20f8ac4 -->
     [SetUp]
         public void Setup()
         {
@@ -84,6 +87,7 @@ public class CalculatedObservationsTest
     /// a RASS observation with a sufficiently low score, recent PSI and TS observations, and an active treatment
     /// (e.g., Propofol) with a minimum requested give amount that triggers the over-sedation condition.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d154c42 body=997a001 -->
     [Test]
         public async Task CalculateOverSedation_Should_Insert_Observation_When_Conditions_Met()
         {
@@ -108,6 +112,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that no over-sedation observation is inserted when the patient's RASS score is not -4 or -5, ensuring the over-sedation calculation only applies for those specific values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=be8cf87 body=bfc74a1 -->
     [Test]
         public async Task CalculateOverSedation_Should_Not_Insert_Observation_When_RASS_Is_Not_Negative4_Or_Negative5()
         {
@@ -123,6 +128,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that no observation is inserted when calculating over-sedation and the patient's PSI (Sedation Intensity Index) is 25 or higher, which indicates the threshold above which the over-sedation mapping should not produce an observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4c7f3e9 body=e6d4e04 -->
     [Test]
         public async Task CalculateOverSedation_Should_Not_Insert_Observation_When_PSI_Is_25_Or_Higher()
         {
@@ -144,6 +150,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the over-sedation calculation does not insert an observation when the patient's TS (Tidal Spontaneous) value is 5 or lower, even with a low RASS score and an elevated PSI value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ddfbeb2 body=05fcbdd -->
     [Test]
         public async Task CalculateOverSedation_Should_Not_Insert_Observation_When_TS_Is_5_Or_Lower()
         {
@@ -165,6 +172,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that no observation is inserted when the patient has no active treatments that exceed the configured threshold during the over-sedation calculation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6d6504a body=40c020e -->
     [Test]
         public async Task CalculateOverSedation_Should_Not_Insert_Observation_When_No_Treatments_Exceed_Threshold()
         {
@@ -190,6 +198,7 @@ public class CalculatedObservationsTest
     /// Verifies that an over-sedation observation is inserted when the calculation is triggered by a PSI observation
     /// and the patient's last RASS and TS observations, combined with active treatment data, meet the triggering criteria.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2484ab7 body=6ae0e08 -->
     [Test]
         public async Task CalculateOverSedation_Should_Insert_Observation_When_Triggered_By_PSI_Observation()
         {
@@ -215,6 +224,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the over-sedation calculation logic inserts a new observation when a triggering TS (Twitch Score) observation is received, given the presence of related RASS and PSI observations and an active treatment (e.g., Propofol) meeting the required minimum amount threshold.
     /// </summary>
+    /// <!-- aidoc:v1 sig=169c7e7 body=b584f23 -->
     [Test]
         public async Task CalculateOverSedation_Should_Insert_Observation_When_Triggered_By_TS_Observation()
         {
@@ -246,6 +256,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when an Inspiratory Pressure (PI) observation is processed and no Compliancia (COMPL) observation is found for the patient, the ventilation mode is set to "VMNI".
     /// </summary>
+    /// <!-- aidoc:v1 sig=cdcef7f body=1f1d9d7 -->
     [Test]
         public async Task CalculateVentilationMode_Should_Set_VMNI_When_PI_PS_Arrives_Without_COMPL()
         {
@@ -266,6 +277,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a "Compliancia" (COMPL) observation is mapped, the ventilation mode is calculated and set to "VMI".
     /// </summary>
+    /// <!-- aidoc:v1 sig=76c6409 body=09b9d41 -->
     [Test]
         public async Task CalculateVentilationMode_Should_Set_VMI_When_COMPL_Arrives()
         {
@@ -282,6 +294,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when an Air Flow observation is processed and a CCC Ventilation Mode observation exists for the patient, the calculated ventilation mode is set to the value retrieved from the CCC source (e.g., "CNAF") and persisted via an insert call.
     /// </summary>
+    /// <!-- aidoc:v1 sig=396d8de body=c8db6fd -->
     [Test]
         public async Task CalculateVentilationMode_Should_Set_CCC_Mode_When_AirFlow_Arrives_And_CCC_Has_Mode()
         {
@@ -344,6 +357,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a PI observation is processed and a COMPL observation already exists for the patient, no new calculated observation is inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a3a2ffc body=3e27399 -->
     [Test]
         public async Task CalculateVentilationMode_Should_Not_Insert_When_PI_Arrives_And_COMPL_Already_Exists()
         {
@@ -363,6 +377,7 @@ public class CalculatedObservationsTest
     /// Verifies that no calculated observation is inserted when a PS (Pressure Support) observation is processed
     /// and a COMPL observation already exists for the patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f7af740 body=6680e7c -->
     [Test]
         public async Task CalculateVentilationMode_Should_Not_Insert_When_PS_Arrives_And_COMPL_Already_Exists()
         {
@@ -386,6 +401,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that mapping a <see cref="PatientObservation"/> with Name "ECMO_Location" and Value "VV" returns a non-null result whose value is "VV".
     /// </summary>
+    /// <!-- aidoc:v1 sig=c8afb0f body=7f629ed -->
     [Test]
         public async Task CalculateEcmoLocation_Should_Return_VV_When_Value_Is_VV()
         {
@@ -398,6 +414,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the ECMO location calculation returns "VA" when the input observation value is "VA".
     /// </summary>
+    /// <!-- aidoc:v1 sig=c311f8b body=5b8882f -->
     [Test]
         public async Task CalculateEcmoLocation_Should_Return_VA_When_Value_Is_VA()
         {
@@ -412,6 +429,7 @@ public class CalculatedObservationsTest
     /// (e.g., "ECCO2r", "VVDL", "VA+V", "VVDL+V", "VV+V", "VVA").
     /// </summary>
     /// <param name="inputValue">The ECMO location code assigned to the <see cref="PatientObservation"/> value under test.</param>
+    /// <!-- aidoc:v1 sig=90b3dc0 body=064eda8 -->
     [Test]
         [TestCase("ECCO2r")]
         [TestCase("VVDL")]
@@ -430,6 +448,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the ECMO Location mapping does not alter the observation value when the provided value is not present in the recognized ECMO list, leaving the original value unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bfe3e66 body=de3ceb3 -->
     [Test]
         public async Task CalculateEcmoLocation_Should_Not_Change_Value_When_Not_In_Ecmo_List()
         {
@@ -443,6 +462,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the mapping of a <see cref="PatientObservation"/> through the calculated observations mapper returns the original observation unchanged, ensuring the mapping is a no-op for patient observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cd439fd body=1a3d8c5 -->
     [Test]
         public async Task CalculateEcmoLocation_Should_Return_Original_Observation_When_Not_PatientObservation()
         {
@@ -460,6 +480,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that an "Over_Analgesia" observation with value "True" is created when the patient has active analgesic treatments (Morfina, Remifentanilo) and the last ANI observation indicates a high value (80), suggesting over-analgesia.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0e024bd body=5783315 -->
     [Test]
         public async Task CalculateOverAnalgesia_Should_Create_Observation_When_Conditions_Are_Met()
         {
@@ -534,6 +555,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the mapping correctly calculates and inserts the driving pressure (Pmeset minus PEEP) when both source observations are available.
     /// </summary>
+    /// <!-- aidoc:v1 sig=52ff2df body=3ae93a9 -->
     [Test]
         public async Task CalculateDrivingPressure_Should_Calculate_Correctly_When_Both_Observations_Are_Present()
         {
@@ -594,6 +616,7 @@ public class CalculatedObservationsTest
     /// Verifies that the Rox Index is calculated correctly by dividing the SpO2/FiO2 ratio by the respiratory rate (FR)
     /// when both required observations are available, and that the result is persisted as a new "Rox_Index" observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3c50640 body=5d52d72 -->
     [Test]
         public async Task CalculateRoxIndex_Should_Calculate_Correctly_When_Both_Observations_Are_Present()
         {
@@ -654,6 +677,7 @@ public class CalculatedObservationsTest
     /// Verifies that the ROX index calculation is not performed when the respiratory rate (FR) is zero,
     /// preventing a division by zero error.
     /// </summary>
+    /// <!-- aidoc:v1 sig=30bf581 body=30b6497 -->
     [Test]
         public async Task CalculateRoxIndex_Should_Not_Calculate_When_FR_Is_Zero_To_Avoid_Division_By_Zero()
         {
@@ -682,6 +706,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the diuresis calculation produces the correct value when prior diuresis observations and a weight observation are available for the patient, resulting in a new "Calculated_Diuresis" observation being inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e5bb5b0 body=2792c9b -->
     [Test]
         public async Task CalculateDiuresis_Should_Calculate_Correctly_When_Observations_Are_Available()
         {
@@ -723,6 +748,7 @@ public class CalculatedObservationsTest
     /// Verifies that diuresis is not calculated when no diuresis observations are found for the patient.
     /// Ensures the mapping logic skips persistence of a calculated diuresis observation when required prior observations are missing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=014e5d8 body=794ece0 -->
     [Test]
         public async Task CalculateDiuresis_Should_Not_Calculate_If_Diuresis_Observations_Are_Missing()
         {
@@ -747,6 +773,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the diuresis calculation is not performed when the patient has no weight observation available, ensuring no new observation is inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c3e7f69 body=c70ddf8 -->
     [Test]
         public async Task CalculateDiuresis_Should_Not_Calculate_If_Weight_Is_Invalid()
         {
@@ -778,6 +805,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the rehabilitation observation mapping sets the status to Alert when the recent rehabilitation values meet the alert condition.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b72fc81 body=739bfe1 -->
     [Test]
         public async Task CalculateRehabilitationAlarm_Should_Set_Alert_When_Condition_Is_Met()
         {
@@ -809,6 +837,7 @@ public class CalculatedObservationsTest
     /// configured condition is not met, even when the most recent observation values are within an
     /// expected range and an out-of-range value is present among the evaluated history.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f5d4651 body=851916f -->
     [Test]
         public async Task CalculateRehabilitationAlarm_Should_Not_Set_Alert_When_Condition_Is_Not_Met()
         {
@@ -838,6 +867,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the <c>Map</c> method does not set an alert for a Rehabilitation observation when its value is greater than 2, returning the original observation unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4222131 body=b1c7f39 -->
     [Test]
         public async Task CalculateRehabilitationAlarm_Should_Not_Set_Alert_When_Value_Is_Greater_Than_2()
         {
@@ -856,6 +886,7 @@ public class CalculatedObservationsTest
     /// Verifies that the rehabilitation alarm calculation returns the same observation unchanged when the input observation is not a <see cref="PatientObservation"/>.
     /// This ensures that the mapping method does not perform any transformation for non-patient observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b686378 body=10526fb -->
     [Test]
         public async Task CalculateRehabilitationAlarm_Should_Return_Same_Observation_If_Not_PatientObservation()
         {
diff --git a/adas-core.Test/Customizations/HUVH/UCIN/CalculatedObservationsTest.cs b/adas-core.Test/Customizations/HUVH/UCIN/CalculatedObservationsTest.cs
index 246b2864..7c515a4e 100644
--- a/adas-core.Test/Customizations/HUVH/UCIN/CalculatedObservationsTest.cs
+++ b/adas-core.Test/Customizations/HUVH/UCIN/CalculatedObservationsTest.cs
@@ -1404,6 +1404,7 @@ public class CalculatedObservationsTest
     /// the Map method creates and inserts a multivalue observation (Respiratory_Device_Multivalue)
     /// containing the intervention description extracted from the observation value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=163c94e body=65cb819 -->
     [Test]
         public async Task Map_WithInterventionCodeInObservationValue_CallsCalculateInterventionMultiValueObservation()
         {
@@ -1437,6 +1438,7 @@ public class CalculatedObservationsTest
     /// Verifies that mapping an <c>Intervention_Out</c> observation updates an existing active multi-value observation
     /// (e.g., <c>Respiratory_Device_Multivalue</c>) for the patient by setting its end time, rather than inserting a new observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d1e8de8 body=707d6a7 -->
     [Test]
         public async Task Map_WithInterventionOut_UpdatesExistingMultiValueObservation()
         {
@@ -1483,6 +1485,10 @@ public class CalculatedObservationsTest
     /// Verifies that when a new "Intervention_In" observation is mapped via <c>Map</c> and the patient's prior "Respiratory_Device_Multivalue" observation is expired (so there is no existing active last observation), a new <see cref="PatientObservation"/> named "Respiratory_Device_Multivalue" is inserted containing the new intervention while the existing expired observation is left untouched.
     /// </summary>
     /// <!-- aidoc:v1 sig=4271f27 body=7d4a79d -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the newly inserted observation is 'containing the new intervention', but the assertion explicitly checks that the inserted value is NOT equal to the new intervention description (`((string[])o.Value)[0] != newInterventionDescription`). The test allows a value that is neither the old nor the new intervention, contradicting the documented behavior." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims 'the existing expired observation is left untouched', but the test only verifies that UpdateObservation is never called; there is no assertion specifically confirming the expired observation is untouched (e.g., it could still be replaced or modified via a path the mocks don't cover)." -->
     [Test]
     public async Task Map_WithNewInterventionNoExistingLastIntervention_NewMultiValueObservation()
     {
@@ -1541,6 +1547,8 @@ public class CalculatedObservationsTest
     /// new record through <see cref="IObservationService.InsertObservation"/>.
     /// </summary>
     /// <!-- aidoc:v1 sig=4e3257d body=697676f -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states 'the new intervention is appended to the existing multi-value observation via UpdateObservation', but the UpdateObservation assertion verifies the updated observation has Length == 1 with only the existing intervention (and Expired = true), NOT the new intervention appended. The assertions verify the existing observation is expired via UpdateObservation and that no combined InsertObservation occurs, contradicting the described append-via-UpdateObservation behavior." -->
     [Test]
     public async Task Map_WithNewInterventionAddsToExistingMultiValueObservation()
     {
@@ -1602,6 +1610,7 @@ public class CalculatedObservationsTest
     /// Verifies that mapping a surgery observation inserts a new Surgery_Multivalue observation
     /// when no existing multi-value observation is found, and does not trigger an update.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a509623 body=817f4ef -->
     [Test]
         public async Task Map_WithSurgeryObservation_InsertsNewSurgeryMultiValueObservation()
         {
@@ -1645,6 +1654,7 @@ public class CalculatedObservationsTest
     /// to be expired and replaced with a new multi-value observation that contains both the previously recorded
     /// surgery value and the newly mapped surgery value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d2c7ca7 body=551d45d -->
     [Test]
         public async Task Map_WithSurgeryObservation_UpdatesExistingSurgeryMultiValueObservation()
         {
@@ -1700,6 +1710,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that mapping a Surgery observation updates the existing Surgery_Multivalue observation by expiring the duplicate entry and inserting a new observation with the duplicate value removed.
     /// </summary>
+    /// <!-- aidoc:v1 sig=46caac9 body=55e3f72 -->
     [Test]
         public async Task Map_WithSurgeryObservation_UpdatesExistingSurgeryMultiValueObservation_RemovesDuplicate()
         {
@@ -1754,6 +1765,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that does not insert or update any observation when a surgery observation is provided with a non-string <c>Value</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e4795ba body=7bfc460 -->
     [Test]
         public async Task Map_WithSurgeryObservation_HandlesNonStringValue()
         {
@@ -1782,6 +1794,7 @@ public class CalculatedObservationsTest
     /// Verifies that the <see cref="CalculatedObservations.Map"/> method, when invoked with a respiratory device multivalue observation
     /// and no prior observations, inserts a "Complexity" observation with a value of 1.
     /// </summary>
+    /// <!-- aidoc:v1 sig=09fcb0a body=445a173 -->
     [Test]
         public async Task Map_WithRespiratoryDeviceMultiValueObservation_CallsCalculateComplexity_Return1()
         {
@@ -1887,6 +1900,8 @@ public class CalculatedObservationsTest
     /// </summary>
     /// <param name="observation">The <see cref="PatientObservation"/> instance passed implicitly to the
     /// test runner; not directly used as a method argument since this is a parameterless test method.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The test method has no parameters, but the documentation includes a <param name=\"observation\"> tag. While the text acknowledges it is parameterless, the tag itself should not exist." -->
     [Test]
         public async Task Map_WithTwoMedicationMultiValueObservation_CalculatesComplexity_Return4()
         {
@@ -1928,6 +1943,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a patient has a system multivalue observation, medication multivalue observations, and a newborn weight observation, the mapping process calculates a complexity value of 9 and inserts it as a new "Complexity" observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fdea61e body=5aa8c09 -->
     [Test]
         public async Task Map_WithSystemMedicationAndNewbornWeightMultiValueObservation_CalculatesComplexity_Return9()
         {
@@ -2025,6 +2041,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that the <c>Map</c> method correctly calculates a complexity value of 13 when the input observation represents surgery, medication, and newborn weight data, by aggregating the per-section contribution of each observation type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9b92aff body=952f1bc -->
     [Test]
         public async Task Map_WithSurgeryMedicationMewbornWeightMultiValueObservation_CalculatesComplexity_Returns13()
         {
@@ -2356,6 +2373,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that mapping a patient treatment with no placer order returns the original treatment unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4641a92 body=97aa6f6 -->
     [Test]
         public async Task Map_TreatmentWithNoPlacerOrder_ReturnsOriginalTreatment()
         {
@@ -2374,6 +2392,7 @@ public class CalculatedObservationsTest
     /// Verifies that mapping a treatment which has active older treatments sets the order control to <c>XO</c>
     /// (cancel as a result of a new order being accepted) and does not insert a new observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3fa3c83 body=55a8c26 -->
     [Test]
         public async Task Map_TreatmentWithActiveOlderTreatments_SetsOrderControlToXO()
         {
@@ -2399,6 +2418,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when mapping a patient treatment with no active older treatments, the resulting order control is set to <see cref="OrderControlType.Nw"/> and no patient observation is inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a3a0846 body=9a069fa -->
     [Test]
         public async Task Map_TreatmentWithNoActiveOlderTreatments_SetsOrderControlToNW()
         {
@@ -2423,6 +2443,7 @@ public class CalculatedObservationsTest
     /// <summary>
     /// Verifies that when a patient treatment has an end time set, mapping it sets the order control to <see cref="OrderControlType.Dc"/> and does not insert a new observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c977810 body=b9cabf5 -->
     [Test]
         public async Task Map_TreatmentWithEndTimeSet_SetsOrderControlToDC()
         {
diff --git a/adas-core.Test/Models/FakeLogger.cs b/adas-core.Test/Models/FakeLogger.cs
index 9259c207..0a5baf58 100644
--- a/adas-core.Test/Models/FakeLogger.cs
+++ b/adas-core.Test/Models/FakeLogger.cs
@@ -7,6 +7,7 @@ namespace adas_core.Test.Models;
 /// <summary>
 /// Represents a fake implementation of the ILogger interface, typically used as a test double to simulate logging behavior.
 /// </summary>
+/// <!-- aidoc:v1 sig=274aadb -->
 public class FakeLogger : ILogger
 {
     public List<string> Messages { get; } = [];
@@ -16,6 +17,7 @@ public class FakeLogger : ILogger
     /// </summary>
     /// <param name="enrichers">The collection of enrichers intended to add contextual properties to log events.</param>
     /// <returns>The current <see cref="ILogger"/> instance, without the supplied enrichers applied.</returns>
+    /// <!-- aidoc:v1 sig=2988ec2 body=62e89c5 -->
     public ILogger ForContext(IEnumerable<ILogEventEnricher> enrichers)
     {
         return this;
@@ -28,6 +30,8 @@ public class FakeLogger : ILogger
     /// <param name="value">The value associated with the property. Can be null.</param>
     /// <param name="destructureObjects">Indicates whether complex objects should be destructured. Defaults to false.</param>
     /// <returns>The current <see cref="ILogger"/> instance.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'Creates a logger context enriched with the specified property and value', but the implementation simply returns `this` without doing any enrichment or context creation. The `propertyName`, `value`, and `destructureObjects` parameters are completely ignored." -->
     public ILogger ForContext(string propertyName, object? value, bool destructureObjects = false)
     {
         return this;
@@ -38,6 +42,7 @@ public class FakeLogger : ILogger
     /// </summary>
     /// <typeparam name="TSource">The source type used to enrich the logger context.</typeparam>
     /// <returns>The current <see cref="ILogger"/> instance.</returns>
+    /// <!-- aidoc:v1 sig=11a41bb body=62e89c5 -->
     public ILogger ForContext<TSource>()
     {
         return this;
@@ -48,6 +53,7 @@ public class FakeLogger : ILogger
     /// </summary>
     /// <param name="source">The source type used to enrich the logger context.</param>
     /// <returns>The current <see cref="ILogger"/> instance.</returns>
+    /// <!-- aidoc:v1 sig=b6256d2 body=62e89c5 -->
     public ILogger ForContext(Type source)
     {
         return this;
@@ -57,6 +63,7 @@ public class FakeLogger : ILogger
     /// Appends the rendered message of the provided log event to the internal messages collection.
     /// </summary>
     /// <param name="logEvent">The log event whose rendered message will be added to the collection.</param>
+    /// <!-- aidoc:v1 sig=e35d092 body=03b8903 -->
     public void Write(LogEvent logEvent)
     {
         Messages.Add(logEvent.RenderMessage());
@@ -68,6 +75,7 @@ public class FakeLogger : ILogger
     /// <param name="level">The severity level of the log event.</param>
     /// <param name="messageTemplate">The message template containing placeholders for the property values.</param>
     /// <param name="propertyValues">An optional array of objects to format the message template. Can be <see langword="null"/>.</param>
+    /// <!-- aidoc:v1 sig=c2fa9db body=991505c -->
     public void Write(LogEventLevel level, string messageTemplate, params object?[]? propertyValues)
     {
         // Manejar la situación donde propertyValues es nulo, si es necesario
@@ -84,6 +92,7 @@ public class FakeLogger : ILogger
     /// <param name="level">The log event level associated with the entry being written.</param>
     /// <param name="messageTemplate">The message template containing a format placeholder for the property value.</param>
     /// <param name="propertyValue">The value to be inserted into the message template.</param>
+    /// <!-- aidoc:v1 sig=f334e80 body=d9646d0 -->
     public void Write<T>(LogEventLevel level, string messageTemplate, T propertyValue)
     {
         Messages.Add(string.Format(messageTemplate, propertyValue));
@@ -99,6 +108,7 @@ public class FakeLogger : ILogger
     /// <param name="exception">An optional exception whose message is recorded when not null.</param>
     /// <param name="messageTemplate">The message template to log, used directly when <paramref name="propertyValues"/> is null.</param>
     /// <param name="propertyValues">Optional values to substitute into <paramref name="messageTemplate"/> via <c>string.Format</c>.</param>
+    /// <!-- aidoc:v1 sig=e067f48 body=cc5019f -->
     public void Write(LogEventLevel level, Exception? exception, string messageTemplate,
             params object?[]? propertyValues)
     {
@@ -113,6 +123,7 @@ public class FakeLogger : ILogger
     /// </summary>
     /// <param name="level">The log event level to evaluate.</param>
     /// <returns><c>true</c> if logging is enabled for the given level; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=2702665 body=eb3da57 -->
     public bool IsEnabled(LogEventLevel level)
     {
         return true;
@@ -125,6 +136,7 @@ public class FakeLogger : ILogger
     /// <param name="exception">An optional exception whose message, when not null, is added to the Messages collection after the formatted message.</param>
     /// <param name="messageTemplate">The message template string used to format the log entry.</param>
     /// <param name="propertyValue">The value to be substituted into the message template.</param>
+    /// <!-- aidoc:v1 sig=b73f265 body=2727c3a -->
     public void Write<T>(LogEventLevel level, Exception? exception, string messageTemplate, T propertyValue)
     {
         Messages.Add(string.Format(messageTemplate, propertyValue));
diff --git a/adas-core.Test/Models/SignalR/SubscriberGroupedTest.cs b/adas-core.Test/Models/SignalR/SubscriberGroupedTest.cs
index d5503044..69636d73 100644
--- a/adas-core.Test/Models/SignalR/SubscriberGroupedTest.cs
+++ b/adas-core.Test/Models/SignalR/SubscriberGroupedTest.cs
@@ -22,6 +22,7 @@ public class SubscriberGroupedTest
     /// <see cref="WsSubscriberGrouped"/> instances configured for two distinct patients with shift- and
     /// hour-based regularities and last/last-filled result mappings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=c105125 -->
     [SetUp]
         public void Setup()
         {
@@ -108,6 +109,7 @@ public class SubscriberGroupedTest
     /// Verifies that the <see cref="ISubscriberGroupedService.GetGrouped"/> method returns the list of grouped subscribers provided by the mocked service.
     /// Ensures the service correctly returns the expected collection of <see cref="WsSubscriberGrouped"/> items without modification.
     /// </summary>
+    /// <!-- aidoc:v1 sig=861df1c body=dcd5b93 -->
     [Test]
         public void GetGroupeds_ReturnsExpectedResult()
         {
@@ -129,6 +131,7 @@ public class SubscriberGroupedTest
     /// <summary>
     /// Verifies the behavior of the <c>Compare</c> extension method by asserting that it returns <c>true</c> when the gender and patient identifiers match the active context, and <c>false</c> when they do not, covering both the primary and secondary contexts.
     /// </summary>
+    /// <!-- aidoc:v1 sig=56cc31f body=8311fa7 -->
     [Test]
         public void Compare_ExtensionResult()
         {
@@ -144,6 +147,7 @@ public class SubscriberGroupedTest
     /// <summary>
     /// Verifies that a new patient observation is considered relevant for its group when it is the first observation recorded within the current hour.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a709b13 body=23c06ac -->
     [Test]
         public void Observation_is_rrelevant_because_is_the_first_in_hour()
         {
@@ -160,6 +164,7 @@ public class SubscriberGroupedTest
     /// <summary>
     /// Verifies that a new patient observation is considered relevant for a grouped observation when an observation already exists within the configured hour interval and the grouping uses the Max result.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1d23e43 body=67f556f -->
     [Test]
         public void Grouped_Observation_Already_Observations_In_Hour_Should_Be_Relevant_By_Max_Result()
         {
@@ -212,6 +217,7 @@ public class SubscriberGroupedTest
     /// <summary>
     /// Verifies that a new observation is considered not relevant for a grouped observation when the grouping rule is set to "Max", the regularity is "Hour", an observation already exists within the same hour, and the new observation's value does not exceed the existing maximum value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f303af5 body=ff99dd7 -->
     [Test]
         public void Grouped_Observation_Already_Observations_In_Hour_Should_Be_IRelevant_By_Max_Result()
         {
diff --git a/adas-core.Test/Repositories/AdmissionRepositoryTest.cs b/adas-core.Test/Repositories/AdmissionRepositoryTest.cs
index 519b5b1c..409117b2 100644
--- a/adas-core.Test/Repositories/AdmissionRepositoryTest.cs
+++ b/adas-core.Test/Repositories/AdmissionRepositoryTest.cs
@@ -25,6 +25,7 @@ public class AdmissionRepositoryTest
     /// Initializes the integration test environment by resetting the admissions collection
     /// and seeding it with valid admission records to be used across the test fixture.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=3f12caf -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -57,6 +58,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AdmissionRepository.InsertOneAsync"/> successfully persists a valid admission so that it can subsequently be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6ca2d2e body=b9057c2 -->
     [Test]
         public async Task InsertOneAsync_Success()
         {
@@ -76,6 +78,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that the repository successfully deletes an admission record, ensuring that the deleted admission can no longer be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0c937b9 body=c7bb396 -->
     [Test]
         public async Task Delete_Success()
         {
@@ -94,6 +97,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="Admission"/> updates are persisted successfully by inserting an admission, modifying one of its fields, and asserting that the updated value is retrieved.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cadac73 body=ac0859e -->
     [Test]
         public async Task Update_Success()
         {
@@ -118,6 +122,7 @@ public class AdmissionRepositoryTest
     /// <c>PointOfCareId</c> of an existing admission to the specified new location identifier
     /// and that the change is persisted in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=25ab00f body=a9cfae4 -->
     [Test]
         public async Task UpdateLocation_Success()
         {
@@ -142,6 +147,7 @@ public class AdmissionRepositoryTest
     /// Verifies that the repository successfully updates the patient information of an existing admission,
     /// ensuring the updated admission can be retrieved and reflects the new patient's details.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cc5dc00 body=d8a50b1 -->
     [Test]
         public async Task UpdatePatient_Success()
         {
@@ -170,6 +176,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindAll operation successfully retrieves all admissions, returning a non-empty collection of exactly three records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9b3759c body=0845192 -->
     [Test]
         public async Task FindAll_Success()
         {
@@ -189,6 +196,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that the repository successfully retrieves an admission by its unique identifier after it has been inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2d082b2 body=9d58a46 -->
     [Test]
         public async Task FindById_Success()
         {
@@ -207,6 +215,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns <c>null</c> when queried with a non-existing identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=464d0a4 body=1ff6d58 -->
     [Test]
         public async Task FindById_NotFound()
         {
@@ -224,6 +233,7 @@ public class AdmissionRepositoryTest
     /// Verifies that <see cref="AdmissionRepository.FindByNhc"/> successfully retrieves an admission record from the repository using its NHC identifier.
     /// Confirms that the returned record is not null and that the NHC of the retrieved admission matches the one used in the lookup.
     /// </summary>
+    /// <!-- aidoc:v1 sig=313e6e8 body=dd6590c -->
     [Test]
         public async Task FindByNhc_Success()
         {
@@ -242,6 +252,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AdmissionRepository"/>.<c>FindByNhc</c> returns <c>null</c> when the provided NHC does not exist in the data source.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f2a806f body=99d3860 -->
     [Test]
         public async Task FindByNhc_NotFound()
         {
@@ -319,6 +330,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that inserting a valid admission through the repository returns the same admission and persists it so it can be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5e423f0 body=ff7f179 -->
     [Test]
         public async Task InsertOneAsyncAndReturn_Success()
         {
@@ -341,6 +353,7 @@ public class AdmissionRepositoryTest
     /// Tests that the repository's <c>GetAdmissionByUnitIdWithOutPoC</c> method returns only the admissions matching the specified unit identifier
     /// while excluding admissions that have an associated point-of-care identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5759221 body=88f5048 -->
     [Test]
         public async Task GetAdmissionByUnitIdWithOutPoC_Success()
         {
@@ -370,6 +383,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <c>GetAdmissionByUnitIdWithOutPoC</c> returns an empty result set (instead of null) when no admissions match the provided unit identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2150f4c body=a2de31a -->
     [Test]
         public async Task GetAdmissionByUnitIdWithOutPoC_NoMatch()
         {
@@ -387,6 +401,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindByPointOfCareId</c> method successfully retrieves the admission matching the specified point of care identifier, returning a single result and excluding admissions associated with different point of care identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=88efc70 body=b058bc3 -->
     [Test]
         public async Task FindByPointOfCareId_Success()
         {
@@ -410,6 +425,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AdmissionRepository"/>.FindByPointOfCareId returns a non-null empty collection when no point of care matches the provided identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=10c01cc body=b5fceef -->
     [Test]
         public async Task FindByPointOfCareId_NoMatch()
         {
@@ -424,6 +440,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AdmissionRepository"/>.<c>FindByDiagnosis</c> successfully returns a non-null result when retrieving admissions matching the specified diagnosis value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=070caef body=da3bf67 -->
     [Test]
         public async Task FindByDiagnosis_Success()
         {
@@ -445,6 +462,7 @@ public class AdmissionRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AdmissionRepository"/>.<c>FindByDiagnosis</c> returns an empty collection when no entity matches the provided diagnosis.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2b70ce2 body=fefa57f -->
     [Test]
         public async Task FindByDiagnosis_NoMatch()
         {
diff --git a/adas-core.Test/Repositories/AlarmRepositoryTest.cs b/adas-core.Test/Repositories/AlarmRepositoryTest.cs
index 296a005f..d20d97ec 100644
--- a/adas-core.Test/Repositories/AlarmRepositoryTest.cs
+++ b/adas-core.Test/Repositories/AlarmRepositoryTest.cs
@@ -27,6 +27,7 @@ public class AlarmRepositoryTest
     /// <see cref="PatientObservationAlarm"/> records by resetting the target
     /// collection and inserting the test data for use across the test fixture.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=0cc6054 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -87,6 +88,8 @@ public class AlarmRepositoryTest
     /// </summary>
     /// <param name="filter">The collection of <see cref="Field"/> objects used to filter observations; contains a single non-existent field to ensure no matches are found.</param>
     /// <returns>A task that completes after asserting the repository returns a non-null but empty result.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The test method has no parameters, but the documentation includes a <param name=\"filter\"> describing the local variable rather than a method parameter." -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Not_Found_Returns_Empty_List()
         {
@@ -109,6 +112,7 @@ public class AlarmRepositoryTest
     /// <summary>
     /// Verifies that AggregatedPatientLastObservationsByField returns exactly one aggregated result when matching last observations are found for the specified patient and field filter.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9bbf1e0 body=05c8194 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Found_Returns_1()
         {
@@ -131,6 +135,7 @@ public class AlarmRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AlarmRepository.AggregatedPatientLastObservationsByField"/> returns a non-null collection containing an entry for each matching field in the filter when observations are found for the given patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7bd117f body=144c5f6 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Found_Returns_2()
         {
@@ -159,6 +164,7 @@ public class AlarmRepositoryTest
     /// <summary>
     /// Verifies that the repository returns an empty list when querying aggregated patient last observations by field with a filter that specifies OnlyExpired as true, and the matching patient observation alarm is expired.
     /// </summary>
+    /// <!-- aidoc:v1 sig=80c2dcc body=92a6f2f -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_AllExpired_Returns_Empty_List()
         {
@@ -198,6 +204,7 @@ public class AlarmRepositoryTest
     /// <summary>
     /// Verifies that when multiple observations exist for the same field, the aggregation returns only the most recent observation based on the timestamp.
     /// </summary>
+    /// <!-- aidoc:v1 sig=36c9e3d body=9fe0818 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_MultipleObservations_Returns_Most_Recent()
         {
@@ -254,6 +261,7 @@ public class AlarmRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AlarmRepository.AggregatedPatientLastObservationsByField"/> returns all of a patient's last observations when no field filter is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=621b9bb body=6fff436 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_FilterObservations_Null_Returns_All()
         {
diff --git a/adas-core.Test/Repositories/AppointmentArchiveRepositoryTest.cs b/adas-core.Test/Repositories/AppointmentArchiveRepositoryTest.cs
index 16ae7be4..e04141d5 100644
--- a/adas-core.Test/Repositories/AppointmentArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/AppointmentArchiveRepositoryTest.cs
@@ -28,6 +28,7 @@ public class AppointmentArchiveRepositoryTest
     /// </summary>
     /// <returns>A <see cref="Task"/> that completes when the collection has been recreated and both
     /// seed appointments have been inserted.</returns>
+    /// <!-- aidoc:v1 sig=81c0015 body=d044105 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -95,6 +96,7 @@ public class AppointmentArchiveRepositoryTest
     /// with a timestamp earlier than the specified cutoff date (two hours before the current time),
     /// while retaining records dated at or after the cutoff for the given patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=7124e14 -->
     [Test]
         public async Task DeleteBeforeDate()
         {
diff --git a/adas-core.Test/Repositories/AppointmentRepositoryTest.cs b/adas-core.Test/Repositories/AppointmentRepositoryTest.cs
index c06b13b1..f0b6d3cf 100644
--- a/adas-core.Test/Repositories/AppointmentRepositoryTest.cs
+++ b/adas-core.Test/Repositories/AppointmentRepositoryTest.cs
@@ -22,6 +22,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Performs one-time setup for integration tests by resetting the patients_appointments collection and seeding it with two test patient appointments: one with minimal fields and another extended with visit number, appointment reason, and resource groups.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=af4b115 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -85,6 +86,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AppointmentRepository"/>.GetByPatient returns a non-null, non-empty list when a valid patient identifier is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b07f445 body=1ecc19f -->
     [Test]
         public async Task GetByPatient_Find_Patient_Return_List()
         {
@@ -97,6 +99,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AppointmentRepository.GetByPatient"/> returns a non-null, empty list when no records are found for the specified patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=11046fe body=f92c1ae -->
     [Test]
         public async Task GetByPatient_not_Find_Patient_Return_Empty_List()
         {
@@ -109,6 +112,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that the repository returns <c>null</c> when no patient is found matching the specified patient identifier and visit number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a3c1464 body=169eed1 -->
     [Test]
         public async Task FindByPatientAndVisitNumber_Not_Find_Patient_Return_Null()
         {
@@ -121,6 +125,7 @@ public class AppointmentRepositoryTest
     /// Verifies that the repository's FindByPatientAndVisitNumber method successfully retrieves
     /// the corresponding appointment when a valid patient identifier and an existing visit number are supplied.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c9fc233 body=1b1a8ee -->
     [Test]
         public async Task FindByPatientAndVisitNumber_Find_Patient_Return_Appointment()
         {
@@ -133,6 +138,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that the repository returns null when searching for an appointment by patient ID and a reason that does not match any existing appointment.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8261277 body=aaea632 -->
     [Test]
         public async Task FindByPatientAndReason_Not_Find_Patient_Return_Null()
         {
@@ -144,6 +150,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Tests that FindByPatientAndReason returns a non-null appointment containing the expected AppointmentReason for the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=97cceac body=2ab244e -->
     [Test]
         public async Task FindByPatientAndReason_Find_Patient_Return_Appointment()
         {
@@ -156,6 +163,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AppointmentRepository"/>.<c>FindByLocation</c> returns an empty (non-null) collection when no patient is associated with the specified location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ca32bb9 body=fbf72c8 -->
     [Test]
         public async Task FindByLocation_Not_Find_Patient_Return_Null()
         {
@@ -170,6 +178,7 @@ public class AppointmentRepositoryTest
     /// <summary>
     /// Verifies that <see cref="AppointmentRepository.FindByLocation"/> successfully retrieves the appointment associated with a patient located at the specified <see cref="PatientLocation"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=531bfca body=5f2109a -->
     [Test]
         public async Task FindByLocation_Find_Patient_Return_Appointment()
         {
diff --git a/adas-core.Test/Repositories/ConfigObservationRepositoryTest.cs b/adas-core.Test/Repositories/ConfigObservationRepositoryTest.cs
index 495f1194..f5c87339 100644
--- a/adas-core.Test/Repositories/ConfigObservationRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ConfigObservationRepositoryTest.cs
@@ -27,6 +27,7 @@ public class ConfigObservationRepositoryTest
     /// system references, original name mappings, and observations with min/max alert thresholds
     /// and forced alert behavior.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=14402f7 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -123,6 +124,7 @@ public class ConfigObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindById method returns a non-null configuration result when queried with a valid id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=90db18c body=1df1e1d -->
     [Test]
         public async Task FindById_Find_Id_Return_Configs()
         {
@@ -134,6 +136,7 @@ public class ConfigObservationRepositoryTest
     /// <summary>
     /// Verifies that the <c>FindById</c> repository method returns <c>null</c> when invoked with a newly generated, non-existing identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ec16c67 body=c6d06bf -->
     [Test]
         public async Task FindById_Not_Find_Id_Return_Empty()
         {
@@ -145,6 +148,7 @@ public class ConfigObservationRepositoryTest
     /// <summary>
     /// Verifies that an existing <see cref="ConfigObservation"/> can be retrieved by its identifier and subsequently updated, ensuring the updated entity reflects the new values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=920dd57 body=d0216be -->
     [Test]
         public async Task Update_Find_Id_Return_Update_Configs()
         {
@@ -170,6 +174,7 @@ public class ConfigObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's Update operation creates a new record when the provided identifier does not exist in the data store, instead of failing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=26cbb5c body=e514eb3 -->
     [Test]
         public async Task Update_Not_Find_Id_Create_It()
         {
@@ -192,6 +197,7 @@ public class ConfigObservationRepositoryTest
     /// Verifies that the base delete operation removes a <see cref="ConfigObservation"/> from the repository.
     /// The test confirms the entity is absent before insertion, present after insertion, and absent again after deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=59f0dda body=38d51c3 -->
     [Test]
         public async Task Delete_With_Base_DeleteAsync()
         {
diff --git a/adas-core.Test/Repositories/ConfigPumpsRepositoryTest.cs b/adas-core.Test/Repositories/ConfigPumpsRepositoryTest.cs
index 51a5e1b2..836428f2 100644
--- a/adas-core.Test/Repositories/ConfigPumpsRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ConfigPumpsRepositoryTest.cs
@@ -21,6 +21,7 @@ public class ConfigPumpsRepositoryTest
     /// <summary>
     /// Initializes the integration test environment by recreating the config_pumps collection and inserting a single configuration pump containing two empty items for use by subsequent tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=6340da1 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -56,6 +57,7 @@ public class ConfigPumpsRepositoryTest
     /// <summary>
     /// Verifies that <see cref="ConfigPumpsRepository.FindById"/> returns a non-null result when searching by the identifier "PV1".
     /// </summary>
+    /// <!-- aidoc:v1 sig=670411f body=fce7952 -->
     [Test]
         public async Task FindById_Find_id_Return_List()
         {
@@ -67,6 +69,7 @@ public class ConfigPumpsRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindById method returns null when no entity is found for the specified identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=97e50f0 body=5c74259 -->
     [Test]
         public async Task FindAsync_not_Find_id_Return_Empty_List()
         {
@@ -78,6 +81,7 @@ public class ConfigPumpsRepositoryTest
     /// <summary>
     /// Tests that inserting a new pump configuration with two items increases the total configuration count to two, that the inserted configuration can be retrieved by its identifier, and that the inserted configuration can be successfully deleted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=31a6d19 body=72a4a2d -->
     [Test]
         public async Task Insert_PumpConfig_returns2()
         {
diff --git a/adas-core.Test/Repositories/ConfigUnitsRepositoryTest.cs b/adas-core.Test/Repositories/ConfigUnitsRepositoryTest.cs
index 3c020f31..117ce153 100644
--- a/adas-core.Test/Repositories/ConfigUnitsRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ConfigUnitsRepositoryTest.cs
@@ -19,6 +19,7 @@ public class ConfigUnitsRepositoryTest
     /// <summary>
     /// Performs one-time setup for integration tests by resetting the <c>config_units</c> collection and seeding it with a single <see cref="ConfigUnits"/> document (Id "PV1") containing two empty <see cref="ConfigUnitItem"/> entries, then initializes the <see cref="ConfigUnitsRepository"/> used by the tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=726ef0c -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -54,6 +55,7 @@ public class ConfigUnitsRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns a non-null result when searching by the identifier "PV1".
     /// </summary>
+    /// <!-- aidoc:v1 sig=670411f body=fce7952 -->
     [Test]
         public async Task FindById_Find_id_Return_List()
         {
@@ -65,6 +67,7 @@ public class ConfigUnitsRepositoryTest
     /// <summary>
     /// Verifies that <see cref="ConfigUnitsRepository.FindById"/> returns null when invoked with an identifier ("PV2") that does not exist in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=97e50f0 body=5c74259 -->
     [Test]
         public async Task FindAsync_not_Find_id_Return_Empty_List()
         {
diff --git a/adas-core.Test/Repositories/DiagnosisArchiveRepositoryTest.cs b/adas-core.Test/Repositories/DiagnosisArchiveRepositoryTest.cs
index 3f01010a..bdc3197e 100644
--- a/adas-core.Test/Repositories/DiagnosisArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/DiagnosisArchiveRepositoryTest.cs
@@ -24,6 +24,7 @@ public class DiagnosisArchiveRepositoryTest
     /// archive collection in the integration database, and configuring the diagnosis archive
     /// repository used by the test suite.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=d9aae18 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -85,6 +86,7 @@ public class DiagnosisArchiveRepositoryTest
     /// for a given patient that were created before the specified cutoff date, while preserving records
     /// created on or after that date.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=4aa6f1c -->
     [Test]
         public async Task DeleteBeforeDate()
         {
diff --git a/adas-core.Test/Repositories/DiagnosisRepositoryTest.cs b/adas-core.Test/Repositories/DiagnosisRepositoryTest.cs
index f08fc640..138c2073 100644
--- a/adas-core.Test/Repositories/DiagnosisRepositoryTest.cs
+++ b/adas-core.Test/Repositories/DiagnosisRepositoryTest.cs
@@ -22,6 +22,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// One-time test setup that prepares the integration database for patient diagnosis tests by dropping and recreating the diagnoses collection, inserting three sample <see cref="PatientDiagnosis"/> records (one with predefined test identifiers and two with auto-generated identifiers), and initializing the <see cref="DiagnosisRepository"/> under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=df3edc3 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -81,6 +82,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// Verifies that the repository returns a non-null and non-empty collection when retrieving records for an existing patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b07f445 body=1ecc19f -->
     [Test]
         public async Task GetByPatient_Find_Patient_Return_List()
         {
@@ -93,6 +95,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// Verifies that <see cref="DiagnosisRepository.GetByPatient"/> returns an empty list when no records are found for the specified patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=11046fe body=f92c1ae -->
     [Test]
         public async Task GetByPatient_not_Find_Patient_Return_Empty_List()
         {
@@ -106,6 +109,7 @@ public class DiagnosisRepositoryTest
     /// Verifies that <see cref="DiagnosisRepository.FindByPatientIdAndCode"/> successfully retrieves a diagnosis for an existing patient using the provided patient identifier, diagnosis code, and diagnosis system.
     /// </summary>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=a4dcbd2 body=164b3c6 -->
     [Test]
         public async Task FindByPatientIdAndCode_Find_Patient_Return_Diagnois()
         {
@@ -118,6 +122,7 @@ public class DiagnosisRepositoryTest
     /// Verifies that <see cref="DiagnosisRepository.FindByPatientIdAndCode"/> returns <c>null</c> when no patient is found
     /// for the provided patient identifier, code, and diagnosis system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=610fb3e body=fb08982 -->
     [Test]
         public async Task FindByPatientIdAndCode_not_Find_Patient_Return_null()
         {
@@ -129,6 +134,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// Verifies that <see cref="DiagnosisRepository.FindByPatientIdAsync"/> returns a non-null, non-empty list when looking up an existing patient by their identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=93141f2 body=482ec71 -->
     [Test]
         public async Task FindByPatientIdAsync_Find_Patient_Return_List()
         {
@@ -141,6 +147,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByPatientIdAsync</c> returns a non-null empty list when no patient matches the provided patient ID.
     /// </summary>
+    /// <!-- aidoc:v1 sig=364bbfc body=f65d98f -->
     [Test]
         public async Task FindByPatientIdAsync_not_Find_Patient_Return_Empty_List()
         {
@@ -153,6 +160,7 @@ public class DiagnosisRepositoryTest
     /// <summary>
     /// Verifies that <c>DeleteAsync</c> removes a patient diagnosis record by its identifier: after insertion, the record is retrievable by patient id, and once deleted, the search by patient id returns no results.
     /// </summary>
+    /// <!-- aidoc:v1 sig=11927cd body=c622103 -->
     [Test]
         public async Task DeleteAsync_Find_id()
         {
@@ -181,6 +189,7 @@ public class DiagnosisRepositoryTest
     /// by inserting a diagnosis, confirming it can be found, deleting it by patient id, and then
     /// asserting that no diagnoses remain for that patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cecd641 body=81c52b1 -->
     [Test]
         public async Task DeleteByPatientId_Find_patientId()
         {
@@ -208,6 +217,7 @@ public class DiagnosisRepositoryTest
     /// Tests that <c>UpdateManyObjectId</c> correctly updates the <c>PatientId</c> field across all matching <see cref="PatientDiagnosis"/> documents by replacing the original ObjectId with a new one.
     /// Verifies that after the update, the document can be retrieved using the new patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7bfa39c body=54e7d90 -->
     [Test]
         public async Task UpdateManyObjectId_With_base_UpdateManyObjectIdAsync()
         {
diff --git a/adas-core.Test/Repositories/DischargeRepositoryTest.cs b/adas-core.Test/Repositories/DischargeRepositoryTest.cs
index bc1b5406..3b436929 100644
--- a/adas-core.Test/Repositories/DischargeRepositoryTest.cs
+++ b/adas-core.Test/Repositories/DischargeRepositoryTest.cs
@@ -23,6 +23,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Performs one-time test setup for discharge integration tests by initializing API settings, dropping and recreating the "discharge" collection in the integration database, and instantiating the <see cref="DischargeRepository"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=e05a801 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -43,6 +44,7 @@ public class DischargeRepositoryTest
     /// Verifies that <c>InsertOneAsync</c> successfully persists a discharge document and that the
     /// inserted record can be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8aeeb12 body=9280cf3 -->
     [Test]
         public async Task InsertOneAsync_ShouldInsertDischarge()
         {
@@ -59,6 +61,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the <c>Delete</c> repository operation removes a discharge so that subsequent lookups by its identifier return no result.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e74d1e2 body=34b5447 -->
     [Test]
         public async Task Delete_ShouldDeleteDischarge()
         {
@@ -76,6 +79,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that an existing discharge record is successfully updated in the repository with new field values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=02a52dc body=6496963 -->
     [Test]
         public async Task Update_DischargeSuccessfullyUpdated()
         {
@@ -142,6 +146,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns all discharge records previously inserted via <c>InsertManyAsync</c>, returning a non-null, non-empty collection whose count matches the number of inserted records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=127b3ea body=394171b -->
     [Test]
         public async Task FindAll_ReturnsAllDischarges()
         {
@@ -167,6 +172,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns the matching <c>Discharge</c> document when queried with an existing identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7d8ccce body=b1b5625 -->
     [Test]
         public async Task FindById_ExistingId_ReturnsDischarge()
         {
@@ -183,6 +189,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the discharge repository's FindById method returns <c>null</c> when queried with a non-existent <see cref="ObjectId"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=697e175 body=a0d5cfe -->
     [Test]
         public async Task FindById_NonExistentId_ReturnsNull()
         {
@@ -214,6 +221,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the discharge repository's FindByDestination method returns the matching discharge records when queried with an existing destination.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a740d08 body=7593742 -->
     [Test]
         public async Task FindByDestination_ExistingDestination_ReturnsDischarges()
         {
@@ -236,6 +244,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByDestination</c> returns an empty collection when the provided destination does not match any stored discharge records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=348dfce body=036788e -->
     [Test]
         public async Task FindByDestination_NonExistentDestination_ReturnsEmptyList()
         {
@@ -253,6 +262,7 @@ public class DischargeRepositoryTest
     /// Verifies that <see cref="DischargeRepository.FindByPoCId"/> returns the matching discharge
     /// when a discharge is associated with the supplied point-of-care identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81038e3 body=609221c -->
     [Test]
         public async Task FindByPoCId_ExistingPoCId_ReturnsDischarges()
         {
@@ -275,6 +285,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that the discharge repository's FindByPoCId method returns an empty list when queried with a non-existent PoCId.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d45faee body=ac91c12 -->
     [Test]
         public async Task FindByPoCId_NonExistentPoCId_ReturnsEmptyList()
         {
@@ -291,6 +302,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that <see cref="DischargeRepository.FindByService"/> returns the matching discharge record when a previously inserted discharge exists for the specified service name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e99c892 body=45c1f89 -->
     [Test]
         public async Task FindByService_ExistingService_ReturnsDischarges()
         {
@@ -313,6 +325,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByService</c> returns an empty list when queried with a service name that does not exist in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dfafcb5 body=cdd509d -->
     [Test]
         public async Task FindByService_NonExistentService_ReturnsEmptyList()
         {
@@ -348,6 +361,7 @@ public class DischargeRepositoryTest
     /// Verifies that <c>GetDischargeByLocation</c> returns <c>null</c> when queried with a location
     /// that does not exist in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e345a93 body=1c5b68f -->
     [Test]
         public async Task GetDischargeByLocation_NonExistentLocation_ReturnsNull()
         {
@@ -364,6 +378,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that <c>GetDischargeByPointOfCareId</c> returns the matching <c>Discharge</c> when queried with a point of care ID that already exists in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1dff722 body=e61125e -->
     [Test]
         public async Task GetDischargeByPointOfCareId_ExistingId_ReturnsDischarge()
         {
@@ -385,6 +400,7 @@ public class DischargeRepositoryTest
     /// <summary>
     /// Verifies that <c>GetDischargeByPointOfCareId</c> returns <c>null</c> when called with a non-existent point of care ID.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7cb9f72 body=decbb3c -->
     [Test]
         public async Task GetDischargeByPointOfCareId_NonExistentId_ReturnsNull()
         {
@@ -402,6 +418,7 @@ public class DischargeRepositoryTest
     /// Verifies that <c>GetByPatientId</c> returns the matching <see cref="Discharge"/> record
     /// when a discharge exists for the specified patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1bf90fa body=426641a -->
     [Test]
         public async Task GetByPatientId_ExistingPatientId_ReturnsDischarge()
         {
@@ -424,6 +441,7 @@ public class DischargeRepositoryTest
     /// Verifies that the <see cref="DischargeRepository.GetByPatientId"/> repository method returns <c>null</c>
     /// when called with a patient ID that does not exist in the data store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=07ad0d0 body=e034156 -->
     [Test]
         public async Task GetByPatientId_NonExistentPatientId_ReturnsNull()
         {
diff --git a/adas-core.Test/Repositories/DisplayConfigTest.cs b/adas-core.Test/Repositories/DisplayConfigTest.cs
index bf28c99e..f36c965d 100644
--- a/adas-core.Test/Repositories/DisplayConfigTest.cs
+++ b/adas-core.Test/Repositories/DisplayConfigTest.cs
@@ -23,6 +23,7 @@ public class DisplayConfigTest
     /// <summary>
     /// Performs one-time setup for integration tests by initializing the display configuration, card configuration, and detail configuration repositories with test data, including a valid display configuration, a card configuration, and a nurse card details configuration.
     /// </summary>
+    /// <!-- aidoc:v1 sig=518646b body=8037c13 -->
     [OneTimeSetUp]
         public async Task SetUp()
         {
@@ -59,6 +60,7 @@ public class DisplayConfigTest
     /// <summary>
     /// One-time teardown method that cleans up the integration test database by dropping the display configuration collections created during testing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2b9e932 body=c1885a2 -->
     [OneTimeTearDown]
         public async Task Cleanup()
         {
@@ -79,6 +81,7 @@ public class DisplayConfigTest
     /// <summary>
     /// Verifies that retrieving a display configuration by its identifier returns a non-null result with the associated card and detail configurations populated.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b0680cd body=57902f6 -->
     [Test]
         public async Task GetByIdShouldReturnAllConfigsAssociated()
         {
diff --git a/adas-core.Test/Repositories/DisplayRepisitoryTest.cs b/adas-core.Test/Repositories/DisplayRepisitoryTest.cs
index f923d812..ad0ab9a5 100644
--- a/adas-core.Test/Repositories/DisplayRepisitoryTest.cs
+++ b/adas-core.Test/Repositories/DisplayRepisitoryTest.cs
@@ -14,6 +14,7 @@ public class DisplayRepisitoryTest
     /// <summary>
     /// One-time setup method that resets the "displays" collection in the integration database by dropping and recreating it, ensuring a clean state before integration tests run.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f7b1b92 body=1664d64 -->
     [OneTimeSetUp]
         public async Task OneTimeSetUp()
         {
diff --git a/adas-core.Test/Repositories/HistoricalConfigChangesRepositoryTest.cs b/adas-core.Test/Repositories/HistoricalConfigChangesRepositoryTest.cs
index 12e2a883..ed9740a3 100644
--- a/adas-core.Test/Repositories/HistoricalConfigChangesRepositoryTest.cs
+++ b/adas-core.Test/Repositories/HistoricalConfigChangesRepositoryTest.cs
@@ -25,6 +25,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Performs one-time setup for the test fixture by initializing configuration options, a mocked logger, and the <see cref="HistoricalConfigChangesRepository"/> instance used across the tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=706266c body=5308091 -->
     [OneTimeSetUp]
         public void Init()
         {
@@ -39,6 +40,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Resets the integration test environment by dropping and recreating the <c>historicalConfigChanges</c> collection and then reinitializing the test data. Used as a teardown step to ensure a clean state between tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7ee5718 body=1347954 -->
     [TearDown]
         public async Task Cleanup()
         {
@@ -63,6 +65,8 @@ public class HistoricalConfigChangesRepositoryTest
     /// Seeds the repository with a series of historical configuration change records for an observation configuration
     /// (Hemoglobina), illustrating successive code updates from "54321" to "xxxxx" to "11111" to "99999" under the "adas" user.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary states the code progression ends with '11111' to '99999', but in the third record the OldConfig.Code is '111111' (six 1's), not '11111' (five 1's); the values in record 2's NewConfig ('11111') and record 3's OldConfig ('111111') differ." -->
     private async Task InitializeData()
         {
             var id = ObjectId.GenerateNewId();
@@ -143,6 +147,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns a non-null collection containing exactly three historical configuration change records after a cleanup operation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ddd8b40 body=ff905b3 -->
     [Test]
         public async Task Get_HistoricalConfigChanges_returns_count_3()
         {
@@ -158,6 +163,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Verifies that the repository <c>Update</c> operation for a <see cref="HistoricalConfigChanges"/> document returns a non-null result whose properties correspond to the updated record, after cleaning up existing data and retrieving an existing entry to be modified.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4eca1c1 body=4c340da -->
     [Test]
         public async Task HistoricalConfigChanges_returns_diferent_document()
         {
@@ -208,6 +214,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Verifies that <see cref="_repository"/>.FindLastHistoricalConfigChangesByUser returns exactly three historical configuration changes for the user "adas" after cleanup.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2af44db body=322238c -->
     [Test]
         public async Task FindLastHistoricalConfigChangesByUser_returns_3()
         {
@@ -221,6 +228,7 @@ public class HistoricalConfigChangesRepositoryTest
     /// <summary>
     /// Verifies that deleting a historical config change entry reduces the total count of records from three to two in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=95e0ef5 body=246dd28 -->
     [Test]
         public async Task Delete_HistoricalConfigChanges_returns_count_2()
         {
diff --git a/adas-core.Test/Repositories/IntegrationDb.cs b/adas-core.Test/Repositories/IntegrationDb.cs
index 1b89ab8a..c5bfd7a3 100644
--- a/adas-core.Test/Repositories/IntegrationDb.cs
+++ b/adas-core.Test/Repositories/IntegrationDb.cs
@@ -27,6 +27,7 @@ public class IntegrationDb
     /// <summary>
     /// Initializes the MongoDB integration test environment by starting a MongoDB runner, configuring MongoDB conventions and BSON class mappings, establishing a client from the runner's connection string, and obtaining the target database used by integration tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9ae459a body=d277949 -->
     [OneTimeSetUp]
         public void InitIntegrationTests()
         {
@@ -42,6 +43,7 @@ public class IntegrationDb
     /// If the server does not become available within the timeout, the runner is disposed and a <see cref="TimeoutException"/> is thrown.
     /// </summary>
     /// <exception cref="TimeoutException">Thrown when the MongoDB server does not respond within the configured timeout period.</exception>
+    /// <!-- aidoc:v1 sig=cd0b7ec body=775a1ab -->
     private static async Task StartMongoDbRunner()
         {
             Runner = MongoDbRunner.Start();
@@ -71,6 +73,7 @@ public class IntegrationDb
     /// Performs one-time teardown for integration tests by disposing the <see cref="Client"/> and <see cref="Runner"/> resources.
     /// Safely handles cases where either resource has not been initialized by using null-conditional disposal.
     /// </summary>
+    /// <!-- aidoc:v1 sig=004ce09 body=c8f0617 -->
     [OneTimeTearDown]
         public void TeardownIntegrationTests()
         {
diff --git a/adas-core.Test/Repositories/MasterListRepositoryTest.cs b/adas-core.Test/Repositories/MasterListRepositoryTest.cs
index 9e3eeccd..a27df99c 100644
--- a/adas-core.Test/Repositories/MasterListRepositoryTest.cs
+++ b/adas-core.Test/Repositories/MasterListRepositoryTest.cs
@@ -17,6 +17,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Performs one-time initialization for the test fixture by configuring <see cref="ApiSettings"/> with the expected master list property names, resetting the "MasterLists" collection in the integration database, and creating a <see cref="MasterListRepository{MasterList}"/> instance for use across tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=18370f8 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -70,6 +71,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Performs one-time cleanup after integration test execution by dropping the <c>MasterLists</c> collection from the integration test database to ensure a clean state between test runs.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2b9e932 body=c9319f6 -->
     [OneTimeTearDown]
         public async Task Cleanup()
         {
@@ -85,6 +87,7 @@ public class MasterListRepositoryTest
     /// Verifies that <see cref="MasterList"/> entities are correctly persisted in the repository via <c>InsertOneAsync</c>,
     /// by inserting an entity and confirming it can be retrieved by its identifier using the default locale.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bba0e89 body=0ea8cb9 -->
     [Test]
         public async Task InsertOneAsync_ShouldInsertEntity()
         {
@@ -104,6 +107,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Verifies that the repository's Delete operation successfully removes a MasterList entity, ensuring that a subsequent lookup by id returns no result.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0b44339 body=e17fa20 -->
     [Test]
         public async Task Delete_ShouldDeleteEntity()
         {
@@ -122,6 +126,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>Update</c> method successfully persists changes to an existing <see cref="MasterList"/> entity, allowing the modified record to be retrieved by its identifier with the updated values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=df0490c body=c7537fa -->
     [Test]
         public async Task Update_ShouldUpdateEntity()
         {
@@ -143,6 +148,7 @@ public class MasterListRepositoryTest
     /// Verifies that the repository's FindById method returns the matching entity when a master list with the specified identifier exists in the data store.
     /// </summary>
     /// <returns>A task representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=eb7d5be body=10ec339 -->
     [Test]
         public async Task FindById_ShouldReturnEntity_WhenFound()
         {
@@ -269,6 +275,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindByName method returns the matching entity when an entity with the specified name exists in the data store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e22b4c6 body=4c1dd17 -->
     [Test]
         public async Task FindByName_ShouldReturnEntity_WhenFound()
         {
@@ -287,6 +294,7 @@ public class MasterListRepositoryTest
     /// <summary>
     /// Verifies that the repository's GetAll method returns all entities, ensuring the result contains at least two items.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a5d7dd2 body=495d5eb -->
     [Test]
         public async Task GetAll_ShouldReturnAllEntities()
         {
diff --git a/adas-core.Test/Repositories/MedicineRepositoryTest.cs b/adas-core.Test/Repositories/MedicineRepositoryTest.cs
index 72984756..3b55f70f 100644
--- a/adas-core.Test/Repositories/MedicineRepositoryTest.cs
+++ b/adas-core.Test/Repositories/MedicineRepositoryTest.cs
@@ -22,6 +22,7 @@ public class MedicineRepositoryTest
     /// <summary>
     /// Performs one-time initialization for integration tests by seeding the medicines collection with a test record and verifying it can be retrieved by code or note.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=efc0f36 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -62,6 +63,7 @@ public class MedicineRepositoryTest
     /// <summary>
     /// Verifies that <c>GetMedicineByCodeOrNote</c> returns a non-null, empty list when invoked with an array containing an empty string.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0e171bf body=07fc7d9 -->
     [Test]
         public async Task Get_Medicines_Of_Treatments_Return_Empty_List()
         {
@@ -103,6 +105,7 @@ public class MedicineRepositoryTest
     /// <summary>
     /// Tests that the repository returns a non-null medicine when a valid medicine code is found.
     /// </summary>
+    /// <!-- aidoc:v1 sig=df645bd body=3280632 -->
     [Test]
         public async Task GetMedicine_Find_Code_Return_Medicine()
         {
@@ -114,6 +117,7 @@ public class MedicineRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>GetMedicine</c> method returns <c>null</c> when the provided medicine code does not match any existing record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=65393e1 body=4ad2d58 -->
     [Test]
         public async Task GetMedicine_Not_Find_Code_Return_Empty()
         {
@@ -126,6 +130,7 @@ public class MedicineRepositoryTest
     /// Verifies that the repository returns a non-null medicine when a medicine is found
     /// by the supplied note identifier ("note1"), confirming successful lookup by note.
     /// </summary>
+    /// <!-- aidoc:v1 sig=59684de body=fc53426 -->
     [Test]
         public async Task GetMedicine_Find_Note_Return_Medicine()
         {
@@ -137,6 +142,7 @@ public class MedicineRepositoryTest
     /// <summary>
     /// Verifies that UpdateMedicine returns the updated medicine and that the changes are persisted and retrievable via GetMedicineById, including the updated notes collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=64c3b04 body=e38bac9 -->
     [Test]
         public async Task UpdateMedicine_Return_Medicine()
         {
diff --git a/adas-core.Test/Repositories/MongodbMigrationTest.cs b/adas-core.Test/Repositories/MongodbMigrationTest.cs
index e8a6de70..09f2f839 100644
--- a/adas-core.Test/Repositories/MongodbMigrationTest.cs
+++ b/adas-core.Test/Repositories/MongodbMigrationTest.cs
@@ -37,6 +37,7 @@ public class MongodbMigrationTest
     /// <summary>
     /// Performs one-time initialization for the test fixture by dropping and recreating the "patients" collection, instantiating the PatientRepository, and seeding it with three test Patient records (one of which has a discharge time set to the current time) to verify they are persisted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=4ef5cc4 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -102,6 +103,7 @@ public class MongodbMigrationTest
     /// <summary>
     /// Performs one-time cleanup after integration tests by dropping the <c>patients</c> and <c>__migrations</c> collections from the integration database, ensuring a clean state for subsequent test runs.
     /// </summary>
+    /// <!-- aidoc:v1 sig=effc73b body=3589ba1 -->
     [OneTimeTearDown]
         public void Teardown()
         {
@@ -112,6 +114,7 @@ public class MongodbMigrationTest
     /// <summary>
     /// Verifies that the database is detected as outdated by creating a runner and asserting that <c>IsDatabaseUpToDate</c> returns <c>false</c> when using the primary read preference.
     /// </summary>
+    /// <!-- aidoc:v1 sig=321f15b body=4973696 -->
     [Test]
         [Order(1)]
         public void IsDatabaseOutdated_ShouldReturnTrue()
@@ -127,6 +130,7 @@ public class MongodbMigrationTest
     /// <summary>
     /// Verifies that after running the migration update to the latest version, the migration with ID 10 (version 0.1.0) is present among the applied migrations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=561899c body=96dbaf9 -->
     [Test]
         [Order(2)]
         public void AfterUpdateToLatest_MigrationShouldBeApplied()
@@ -159,6 +163,7 @@ public class MongodbMigrationTest
     /// Creates and configures a <see cref="MigrationRunner"/> for executing database migrations, using a locator that scans the assembly containing the patient data update migration.
     /// </summary>
     /// <returns>A configured <see cref="MigrationRunner"/> bound to the integration database and the migrations collection.</returns>
+    /// <!-- aidoc:v1 sig=10bca02 body=74d6fef -->
     private MigrationRunner CreateRunner()
         {
             var locator = new MigrationLocator();
@@ -174,6 +179,7 @@ public class MongodbMigrationTest
     /// Retrieves the identifiers of all applied migrations from the "__migrations" collection in the integration database.
     /// </summary>
     /// <returns>A list of migration identifiers extracted from the "_id" field of each migration document.</returns>
+    /// <!-- aidoc:v1 sig=24bca53 body=dc0f87b -->
     private List<int> GetAppliedMigrationIds()
         {
             var collection = IntegrationDb.Database.GetCollection<BsonDocument>("__migrations");
diff --git a/adas-core.Test/Repositories/ObservationArchiveRepositoryTest.cs b/adas-core.Test/Repositories/ObservationArchiveRepositoryTest.cs
index ca311d76..309955d1 100644
--- a/adas-core.Test/Repositories/ObservationArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ObservationArchiveRepositoryTest.cs
@@ -77,6 +77,7 @@ public class ObservationArchiveRepositoryTest
     /// Verifies that the repository's <c>DeleteBeforeDate</c> method removes all patient observations
     /// dated before the specified cutoff, leaving only a single observation remaining in the collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=7b01df8 -->
     [Test]
         public async Task DeleteBeforeDate()
         {
diff --git a/adas-core.Test/Repositories/ObservationRepositoryTest.cs b/adas-core.Test/Repositories/ObservationRepositoryTest.cs
index cc0732fe..b5e6023c 100644
--- a/adas-core.Test/Repositories/ObservationRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ObservationRepositoryTest.cs
@@ -33,6 +33,7 @@ public class ObservationRepositoryTest
     /// and seeds it with six <see cref="PatientObservation"/> records covering different codes, coding systems, and timestamps
     /// (including observations without a <c>SystemId</c>).
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=3e4af03 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -141,6 +142,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's last observations lookup returns a non-null list containing the expected number of observations for the specified patient, system ("SNM"), and observation code ("code1").
     /// </summary>
+    /// <!-- aidoc:v1 sig=88635f6 body=2067a8b -->
     [Test]
         public async Task FindLastObservations_Return_List()
         {
@@ -155,6 +157,7 @@ public class ObservationRepositoryTest
     /// Verifies that FindLastObservationsByCodingSystem returns a non-null list of the expected count
     /// of the most recent observations for the specified patient filtered by the "SNM" coding system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0c960a3 body=f8e4c58 -->
     [Test]
         public async Task FindLastObservationsByCodingSystem_Return_List()
         {
@@ -168,6 +171,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the AggregatedPatientLastObservations method returns a non-null list containing the expected number of aggregated last observations for the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1cb45c4 body=0919ea1 -->
     [Test]
         public async Task AggregatedPatientLastObservations_Null_Filter_Return_List()
         {
@@ -180,6 +184,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the AggregatedPatientLastObservations repository method returns a non-null filtered list with the expected number of entries when a name filter is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=af78004 body=f4c593b -->
     [Test]
         public async Task AggregatedPatientLastObservations_Filter_Return_List()
         {
@@ -194,6 +199,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that AggregatedPatientLastObservations returns an empty list when the provided filter does not match any observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b7e2192 body=ff9f765 -->
     [Test]
         public async Task AggregatedPatientLastObservations_Filter_Not_Find_Return_Empty_List()
         {
@@ -208,6 +214,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <c>AggregatedPatientLastObservationsByLastDate</c> returns a non-null list of aggregated patient last observations for a given patient and date, even when no filter is applied.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7a118f0 body=2447117 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByLastDate_Null_Filter_Return_List()
         {
@@ -220,6 +227,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that _repository.AggregatedPatientLastObservationsByLastDate returns a non-null list containing the expected number of aggregated patient last observations when a filter is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=effae73 body=630b754 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByLastDate_Filter_Return_List()
         {
@@ -234,6 +242,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that AggregatedPatientLastObservationsByLastDate returns an empty list when the provided filter does not match any patient observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a861d66 body=68738b9 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByLastDate_Filter_Not_Find_Return_Empty_List()
         {
@@ -249,6 +258,7 @@ public class ObservationRepositoryTest
     /// Verifies that AggregatedPatientLastObservationsByField returns a non-null list of aggregated patient last observations
     /// when the filter is <c>null</c>, confirming the expected fallback behavior and default result set.
     /// </summary>
+    /// <!-- aidoc:v1 sig=caf7033 body=c85338e -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Null_Filter_Return_List()
         {
@@ -261,6 +271,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Tests that filtering aggregated patient last observations by a specific field returns a non-null list containing the expected number of results.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5917458 body=a5282a6 -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Filter_Return_List()
         {
@@ -276,6 +287,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that _repository.AggregatedPatientLastObservationsByField returns an empty list when the filter field has <c>OnlyExpired</c> set to <c>true</c>, indicating no expired observations are available for the patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=276c465 body=3f97cba -->
     [Test]
         public async Task AggregatedPatientLastObservationsByField_Filter_OnlyExpired_Return_Empty_List()
         {
@@ -294,6 +306,7 @@ public class ObservationRepositoryTest
     /// The test inserts a single observation, confirms it is persisted, deletes it by
     /// patient id, and asserts that no records remain for that patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=79b17ee body=9f320fb -->
     [Test]
         public async Task DeleteByPatientId()
         {
@@ -327,6 +340,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that FindByPatientIdAsync returns a non-null cursor containing the expected number of records for the specified patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d18d952 body=133ddc6 -->
     [Test]
         public async Task FindByPatientIdAsync_Return_Cursor()
         {
@@ -339,6 +353,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <see cref="DeleteAsync"/> correctly removes a patient observation from the repository by inserting a record, confirming its presence, deleting it, and ensuring it is no longer retrievable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fff9e82 body=a6a87ee -->
     [Test]
         public async Task DeleteAsync()
         {
@@ -372,6 +387,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>DeleteOlderDaysAsync</c> method removes <see cref="PatientObservation"/> records older than the specified day threshold while keeping more recent ones, and that <c>DeleteByPatientId</c> subsequently clears the remaining records associated with the same patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=da9fb95 body=8dfd6d6 -->
     [Test]
         public async Task DeleteOlderDaysAsync()
         {
@@ -425,6 +441,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <c>DeleteOlderSecondsAsync</c> removes <c>PatientObservation</c> entries whose timestamp is older than the specified number of seconds, keeping more recent entries with the same name intact, and that <c>DeleteByPatientId</c> clears all remaining observations for the given patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9941ee8 body=377855c -->
     [Test]
         public async Task DeleteOlderSecondsAsync()
         {
@@ -479,6 +496,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>DeleteOlderNumberAsync</c> method retains only the most recent specified count of <see cref="PatientObservation"/> records sharing the same name, deleting the older entries, and that <c>DeleteByPatientId</c> subsequently removes all remaining records for the patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=340569b body=00db271 -->
     [Test]
         public async Task DeleteOlderNumberAsync()
         {
@@ -546,6 +564,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that _repository.<c>ExistBySystemId</c> returns a valid result when checking existence by the given patient and system identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4a76800 body=c1adb09 -->
     [Test]
         public async Task ExistBySystemId_Return_List()
         {
@@ -558,6 +577,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that FindLastObservationBeforeDate returns a non-null observation whose timestamp is earlier than the specified date, confirming a matching record is retrieved successfully.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c4f6209 body=029c0ad -->
     [Test]
         public async Task FindLastObservationBeforeDate_Return_Obs()
         {
@@ -571,6 +591,7 @@ public class ObservationRepositoryTest
     /// Verifies that the repository's <c>FindAnyWithSameDate</c> method returns a non-null list containing exactly one observation
     /// when searching for observations associated with the specified patient, name, and date.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f4d1d6e body=13ab188 -->
     [Test]
         public async Task FindAnyWithSameDate_Return_List_Obs()
         {
@@ -583,6 +604,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Tests that the repository returns a non-null list of two observations for a patient, found before the specified date (yesterday).
     /// </summary>
+    /// <!-- aidoc:v1 sig=7625bc5 body=4184aa0 -->
     [Test]
         public async Task FindAnyBeforeDate_Return_List_Obs()
         {
@@ -595,6 +617,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that AggregatedPatientActiveIntravenousLinesObservations returns a non-null, empty list of observations for the specified patient when no filter criteria are provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=443bc38 body=fa1727f -->
     [Test]
         public async Task AggregatedPatientActiveIntravenousLinesObservations_Null_Filter_Return_List_Obs()
         {
@@ -607,6 +630,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that _repository.AggregatedPatientActiveIntravenousLinesObservations returns an empty list of observations when the filter value is not the Patient Intravenous Lines value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=222e074 body=fa1727f -->
     [Test]
         public async Task
             AggregatedPatientActiveIntravenousLinesObservations_Filter_Not_PatientIntravenousLineasValue_Return_List_Obs()
@@ -622,6 +646,7 @@ public class ObservationRepositoryTest
     /// when filtering by patient id and the observation value is a <c>PatientIntravenousLinesValue</c> instance.
     /// The test inserts a single matching observation, asserts that exactly one record is returned, and confirms successful cleanup by deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=de0f13c body=e70da59 -->
     [Test]
         public async Task
             AggregatedPatientActiveIntravenousLinesObservations_Filter_PatientIntravenousLineasValue_Return_List_Obs()
@@ -663,6 +688,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository method <c>FindAllLastPatientObservationTime</c> returns a non-null collection containing at least one last patient observation time record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ae4ea39 body=e0d34c8 -->
     [Test]
         public async Task FindAllLastPatientObservationTime_Return_List()
         {
@@ -675,6 +701,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns <c>null</c> when the requested entity does not exist in the data store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fa5827c body=aa8e2ed -->
     [Test]
         public async Task FindById_Return_null()
         {
@@ -686,6 +713,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns a non-null entity whose identifier matches the requested <c>Id</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a8a8a1f body=5c4b5c9 -->
     [Test]
         public async Task FindById_Return_Obs()
         {
@@ -699,6 +727,7 @@ public class ObservationRepositoryTest
     /// Verifies that the repository's <c>UpdateExpiredObservations</c> method correctly marks all non-expired observations belonging to a patient as expired.
     /// The test inserts five fresh observations, asserts that none are expired, invokes the update, and then asserts that all five have been flagged as expired before cleaning up the inserted data.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b94178a body=272a747 -->
     [Test]
         public async Task UpdateExpiredObservations()
         {
@@ -753,6 +782,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns a non-null and non-empty collection of patient observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b6f854b body=d3aacf4 -->
     [Test]
         public async Task FindAll_Return_List_Obs()
         {
@@ -766,6 +796,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindNotExpired</c> method returns a non-empty collection of patient observations for the provided observation names.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8432757 body=44f224f -->
     [Test]
         public async Task FindNotExpired_Return_List_Obs()
         {
@@ -781,6 +812,7 @@ public class ObservationRepositoryTest
     /// configuration observations as expired so that a subsequent _repository.FindNotExpired
     /// call returns only the remaining non-expired observations, deduplicating the requested names.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f38e833 body=a355c89 -->
     [Test]
         public async Task ExpireExpiredObservations()
         {
@@ -824,6 +856,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindByName</c> method returns a non-null, non-empty list of <see cref="PatientObservation"/> objects when searching by the name "name1".
     /// </summary>
+    /// <!-- aidoc:v1 sig=4909264 body=8a20493 -->
     [Test]
         public async Task FindByName_Return_List_Obs()
         {
@@ -837,6 +870,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <c>AggregatedPatientGroupedObservations</c> returns a non-null, empty list when called with a default <see cref="GroupedField"/> instance for the given patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ba3950a body=ab60777 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Null_groupedField_Return_List_Emty()
         {
@@ -855,6 +889,7 @@ public class ObservationRepositoryTest
     /// are aggregated for a patient using the First result selection strategy with a maximum of 8 groups.
     /// Verifies successful aggregation and ensures all inserted test observations are removed by patient id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ddd2397 body=6da0755 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Hour_Firs_Return_List_9()
         {
@@ -908,6 +943,7 @@ public class ObservationRepositoryTest
     /// Inserts 30 observations, asserts the aggregated result count is 8, and confirms cleanup by patient id removes all inserted records.
     /// </summary>
     /// <returns>A task that completes when the test finishes, including assertions and cleanup.</returns>
+    /// <!-- aidoc:v1 sig=16bfc4b body=6ec573c -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Hour_Firs_Since_Last_Return_List_8()
         {
@@ -959,6 +995,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that inserting five patient observations with hourly regularity and aggregating them using the first result returns a list of four or five grouped entries, and ensures the inserted observations are removed by patient id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b1196b2 body=b383d16 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_Firs_Return_List_5()
         {
@@ -1010,6 +1047,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <c>AggregatedPatientGroupedObservations</c> returns a non-empty list when patient observations are grouped by a field with second-level regularity and the aggregation selects only the first result per group, and that the inserted observations are fully removed by the cleanup step.
     /// </summary>
+    /// <!-- aidoc:v1 sig=979ce59 body=7455833 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_second_Firs_Return_List()
         {
@@ -1060,6 +1098,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that the aggregated grouped observations query, configured with minute regularity, the <c>First</c> result and a maximum of 8, returns a list of exactly 8 entries even when 30 underlying observations exist for the patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=26e8af5 body=afe533b -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Minute_Firs_Return_List_8()
         {
@@ -1113,6 +1152,7 @@ public class ObservationRepositoryTest
     /// Also confirms that observations inserted for the test patient are removed by the cleanup step.
     /// </summary>
     /// <returns>A task that completes when the aggregation result is validated and the test data is cleaned up.</returns>
+    /// <!-- aidoc:v1 sig=ac82ee8 body=f55a331 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Day_Firs_Return_List_8()
         {
@@ -1163,6 +1203,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Verifies that <c>AggregatedPatientGroupedObservations</c> returns a list of 9 entries containing the "first" marker when grouping 30 patient observations by a shift-regularity field with a max of 8 and <c>Result.First</c> selected, and that all inserted observations are removed by the cleanup call.
     /// </summary>
+    /// <!-- aidoc:v1 sig=908c690 body=45a4df9 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Shift_Firs_Return_List_9()
         {
@@ -1216,6 +1257,8 @@ public class ObservationRepositoryTest
     /// Inserts two observations for each of the last 5 hours (at minutes 15 and 30), runs the aggregation for a new patient, and verifies the result count is 5 and that every entry contains the "last" marker.
     /// Cleanup is performed by deleting the inserted observations by patient id and asserting that the collection is empty afterwards.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "First sentence states '5 observations are inserted per hour' but the code inserts 2 observations per hour (at minutes 15 and 30) across 5 hours. The subsequent sentence correctly clarifies this." -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_last_Return_List_5()
         {
@@ -1293,6 +1336,7 @@ public class ObservationRepositoryTest
     /// into hourly groups and returns the sum of values for each hour when five hours of data are inserted.
     /// </summary>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=70c846f body=b222435 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_sum_Return_List_5()
         {
@@ -1377,6 +1421,7 @@ public class ObservationRepositoryTest
     /// AggregatedPatientGroupedObservations returns a list of five entries, each containing the minimum value of 3.
     /// Also confirms that observations are cleaned up by patient id after the test executes.
     /// </summary>
+    /// <!-- aidoc:v1 sig=46c6e82 body=eb3a01b -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_Min_Return_List_5()
         {
@@ -1455,6 +1500,7 @@ public class ObservationRepositoryTest
     /// maximum value for each group, producing one aggregated result per hour when inserting two observations
     /// (with different values) for each of five consecutive hours.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fe72045 body=5459e9e -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_Max_Return_List_5()
         {
@@ -1537,6 +1583,7 @@ public class ObservationRepositoryTest
     /// Inserts 10 observations across 5 different hours (two per hour with values 5 and 3), verifies the result count is 5, and asserts that each entry contains the "average" field with a value of 3 or 4.
     /// Cleans up by deleting all observations for the test patient after verification.
     /// </summary>
+    /// <!-- aidoc:v1 sig=41afdfe body=ac8d03f -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_Average_Return_List_5()
         {
@@ -1619,6 +1666,7 @@ public class ObservationRepositoryTest
     /// Inserts ten observations (two per hour for five consecutive hours) for a new patient, runs the aggregation, and asserts that the result contains five entries each reporting a count of 1 or 2.
     /// Also confirms that cleanup via <c>DeleteByPatientId</c> removes the inserted observations for the generated patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=86524d8 body=92a501b -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_Count_Return_List_5()
         {
@@ -1701,6 +1749,7 @@ public class ObservationRepositoryTest
     /// Inserts two sets of observations at different minute offsets across the last five hours, then asserts the aggregation result count matches the expected number of groups and the "all" subset is returned.
     /// Also validates cleanup by ensuring no observations remain for the test patient after deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2bb5c5e body=3897462 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_HalfHour_Return_List_5()
         {
@@ -1794,6 +1843,7 @@ public class ObservationRepositoryTest
     /// observation value (either 5 or 3 depending on insertion order) and that the inserted test data is
     /// cleaned up afterwards.
     /// </summary>
+    /// <!-- aidoc:v1 sig=40fc878 body=161ff4e -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_LastFilled_Return_List_5()
         {
@@ -1876,6 +1926,7 @@ public class ObservationRepositoryTest
     /// <summary>
     /// Tests that the repository's aggregated patient grouped observations, configured with hourly regularity and the LastAll result option, returns a list of 5 entries when 5 hours of data are inserted (with two observations per hour at minutes 15 and 31), and verifies that cleanup by patient ID removes all inserted records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=03215f8 body=3230a69 -->
     [Test]
         public async Task AggregatedPatientGroupedObservations_Insert_5_Hour_LastAll_Return_List_5()
         {
diff --git a/adas-core.Test/Repositories/PatientArchiveRepositoryTest.cs b/adas-core.Test/Repositories/PatientArchiveRepositoryTest.cs
index 80c0ba55..ba319b3a 100644
--- a/adas-core.Test/Repositories/PatientArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PatientArchiveRepositoryTest.cs
@@ -23,6 +23,7 @@ public class PatientArchiveRepositoryTest
     /// Performs one-time setup for integration tests by seeding the patient archive collection
     /// with three predefined <see cref="Patient"/> records after resetting the collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=325d090 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -92,6 +93,7 @@ public class PatientArchiveRepositoryTest
     /// <summary>
     /// Verifies that the FindByPatientNumber repository method returns null when no record is found for the provided patient number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=34ec3bc body=1ed0bbb -->
     [Test]
         public async Task FindByPatientNumber_Not_Find_Return_null()
         {
@@ -105,6 +107,7 @@ public class PatientArchiveRepositoryTest
     /// matching the provided patient number, ensuring the returned patient is not null and has
     /// the expected PatientNumber.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c0d3b04 body=73af217 -->
     [Test]
         public async Task FindByPatientNumber_Find_Return_Patient()
         {
@@ -117,6 +120,7 @@ public class PatientArchiveRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns a non-null list containing the expected number of patient records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d5ae514 body=7b8d43f -->
     [Test]
         public async Task FindAll_Return_List_Patients()
         {
diff --git a/adas-core.Test/Repositories/PatientRepositoryTest.cs b/adas-core.Test/Repositories/PatientRepositoryTest.cs
index 082d983b..1e6e5c2f 100644
--- a/adas-core.Test/Repositories/PatientRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PatientRepositoryTest.cs
@@ -31,6 +31,7 @@ public class PatientRepositoryTest
     /// list records, then verifies that the initial bulk insert yields exactly five patient
     /// documents.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=e3a0acd -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -239,6 +240,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that _repository.FindInActivePoC returns a non-null result containing exactly three inactive PoC entries.
     /// </summary>
+    /// <!-- aidoc:v1 sig=511005a body=96a1c82 -->
     [Test]
         public async Task FindInActivePoC()
         {
@@ -251,6 +253,7 @@ public class PatientRepositoryTest
     /// Verifies that _repository.FindInInactivePoC() returns a non-null collection containing exactly two inactive PoC records.
     /// </summary>
     /// <returns>A Task representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=00839fb body=3eb509a -->
     [Test]
         public async Task FindInInactivePoC()
         {
@@ -262,6 +265,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that FindById returns the expected <c>Patient</c> when a valid patient identifier is provided, ensuring the result is not null and the <c>PatientNumber</c> matches the expected value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4d059ea body=2e321e5 -->
     [Test]
         public async Task FindById_Find_Return_Patient()
         {
@@ -274,6 +278,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindByPatientNumber</c> method returns <c>null</c> when invoked with an empty patient number, confirming the not-found scenario for blank input.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3dd54bc body=1ed0bbb -->
     [Test]
         public async Task FindByPatientNumber_Not_Find_Return_Patient()
         {
@@ -287,6 +292,7 @@ public class PatientRepositoryTest
     /// a patient when called with a valid patient number, returning a non-null result
     /// with a matching <c>PatientNumber</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c0d3b04 body=73af217 -->
     [Test]
         public async Task FindByPatientNumber_Find_Return_Patient()
         {
@@ -299,6 +305,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns a non-null list containing all expected patient records (five entries).
     /// </summary>
+    /// <!-- aidoc:v1 sig=d5ae514 body=c6cf2c0 -->
     [Test]
         public async Task FindAll_Return_List_Patients()
         {
@@ -314,6 +321,7 @@ public class PatientRepositoryTest
     /// the new value is not present prior to the update operation. Also validates that the updated record
     /// is persisted with the modified value and that the patient can be cleaned up via <c>Delete</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=47a1bec body=826570a -->
     [Test]
         public async Task Update_with_base_UpdateOneAsync()
         {
@@ -367,6 +375,7 @@ public class PatientRepositoryTest
     /// Verifies that a patient can be successfully deleted from the repository by inserting a patient,
     /// confirming it exists, deleting it, and then confirming it is no longer retrievable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=122f4c1 body=bdb3f7b -->
     [Test]
         public async Task Delete()
         {
@@ -439,6 +448,7 @@ public class PatientRepositoryTest
     /// Tests that the attending doctor of a point of care entry can be successfully updated with a new doctor.
     /// Verifies that after the update, the entry retrieved by point of care reflects the new attending doctor's information.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6f5c72a body=7989ba8 -->
     [Test]
         public async Task UpdateAttendingDoctor()
         {
@@ -629,6 +639,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that _repository.FindByPatientId returns <c>null</c> when no patient is found for the provided patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2ee2a87 body=5435f7d -->
     [Test]
         public async Task FindByPatientId_Not_Find_Return_Patient()
         {
@@ -649,6 +660,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that the repository returns a non-null and non-empty collection of patients when searching by the identifier of an existing point of care.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3c4dd97 body=12ec03f -->
     [Test]
         public async Task FindByPointOfCare_Find_Return_Patients()
         {
@@ -662,6 +674,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that _repository.FindByPointOfCare returns a non-null empty collection when no patients match the provided point of care identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ddb2f09 body=bc4f7e5 -->
     [Test]
         public async Task FindByPointOfCare_Not_Find_Return_Patients()
         {
@@ -674,6 +687,7 @@ public class PatientRepositoryTest
     /// <summary>
     /// Verifies that the repository returns a non-null and non-empty collection of discharged patients when calling <c>FindDischargedPatients</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=35a586f body=e6a17fd -->
     [Test]
         public async Task FindDischargedPatients_Find_Return_Patients()
         {
diff --git a/adas-core.Test/Repositories/PoCMappingRepositoryTest.cs b/adas-core.Test/Repositories/PoCMappingRepositoryTest.cs
index 4d985045..486ccd54 100644
--- a/adas-core.Test/Repositories/PoCMappingRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PoCMappingRepositoryTest.cs
@@ -20,6 +20,7 @@ public class PoCMappingRepositoryTest
     /// <summary>
     /// Performs one-time setup for integration tests by seeding the "mappings" collection with a sample <see cref="PoCMapping"/> document, where a single point of care is mapped from an original value to a new one across eleven bed entries, and initializing the <see cref="PoCMappingRepository"/> against the integration database.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=cf0b9af -->
     [OneTimeSetUp]
     public async Task Init()
     {
@@ -71,6 +72,7 @@ public class PoCMappingRepositoryTest
     /// <summary>
     /// Verifies that finding a mapping by the key "PV1" returns a non-null result containing point of care entries with at least one associated bed.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2e75ef3 body=918af14 -->
     [Test]
     public async Task FindByKey_Find_Return_Mapping()
     {
@@ -84,6 +86,7 @@ public class PoCMappingRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindByKey method returns null when the provided key does not correspond to an existing entity, confirming the not-found behavior.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7839679 body=2c9e795 -->
     [Test]
     public async Task FindByKey_Not_Find_Return_Mapping()
     {
diff --git a/adas-core.Test/Repositories/PoCSettingsRepositoryTest.cs b/adas-core.Test/Repositories/PoCSettingsRepositoryTest.cs
index 78ab9277..55062fc8 100644
--- a/adas-core.Test/Repositories/PoCSettingsRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PoCSettingsRepositoryTest.cs
@@ -21,6 +21,7 @@ public class PoCSettingsRepositoryTest
     /// <summary>
     /// One-time setup that prepares the integration test environment by resetting the PoC settings collection in the integration database, seeding it with test data, and instantiating the <see cref="PoCSettingsRepository"/> used by the test fixture.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=dcc8a2f -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -55,6 +56,7 @@ public class PoCSettingsRepositoryTest
     /// <summary>
     /// Verifies that calling the Delete method with an existing PoCSettings identifier removes the corresponding record from the repository, resulting in a null lookup via FindById.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fe40c5f body=05bfdc8 -->
     [Test]
         public async Task Delete_WhenCalled_ShouldRemovePoCSettings()
         {
@@ -78,6 +80,7 @@ public class PoCSettingsRepositoryTest
     /// <summary>
     /// Verifies that the repository's <c>FindAll</c> method returns a non-null and non-empty collection of PoC settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7098a75 body=efda3dd -->
     [Test]
         public async Task FindAll_WhenCalled_ShouldReturnAllPoCSettings()
         {
@@ -92,6 +95,7 @@ public class PoCSettingsRepositoryTest
     /// <summary>
     /// Tests that FindById returns a non-null PoC settings object whose identifier matches the requested value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d657f65 body=3e8fc10 -->
     [Test]
         public async Task FindById_WhenCalled_ShouldReturnPoCSettings()
         {
@@ -106,6 +110,7 @@ public class PoCSettingsRepositoryTest
     /// <summary>
     /// Verifies that _repository.FindByLocation returns a PoC settings object matching the requested patient location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ad74af5 body=0b6fc4b -->
     [Test]
         public async Task FindByLocation_WhenCalled_ShouldReturnPoCSettings()
         {
@@ -121,6 +126,7 @@ public class PoCSettingsRepositoryTest
     /// Verifies that the repository correctly updates an existing PoCSettings entity, specifically ensuring that the associated PatientLocation properties (such as Bed) are persisted after the update operation.
     /// </summary>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=767a442 body=1a3df29 -->
     [Test]
         public async Task Update_WhenCalled_ShouldUpdatePoCSettings()
         {
diff --git a/adas-core.Test/Repositories/PointOfCareRepositoryTests.cs b/adas-core.Test/Repositories/PointOfCareRepositoryTests.cs
index 916842fb..3ada4204 100644
--- a/adas-core.Test/Repositories/PointOfCareRepositoryTests.cs
+++ b/adas-core.Test/Repositories/PointOfCareRepositoryTests.cs
@@ -25,6 +25,7 @@ public class PointOfCareRepositoryTests
     /// Performs one-time setup for integration tests by initializing mock dependencies and resetting the
     /// "pointOfCares" MongoDB collection before instantiating the <see cref="PointOfCareRepository"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=9ad8f9b -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -47,6 +48,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that InsertOneAsync successfully inserts a valid point of care into the repository and that the record can be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=00a9141 body=70e9995 -->
     [Test]
         public async Task InsertOneAsync_ValidPointOfCare_InsertsSuccessfully()
         {
@@ -65,6 +67,7 @@ public class PointOfCareRepositoryTests
     /// Verifies that the Delete method successfully removes a point of care from the repository when given a valid identifier.
     /// Inserts a point of care, deletes it by its identifier, and asserts that the entity can no longer be retrieved.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9eb1fdd body=846deca -->
     [Test]
         public async Task Delete_ValidId_DeletesSuccessfully()
         {
@@ -81,6 +84,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that <see cref="PointOfCare"/> entities can be updated successfully when valid data is provided, ensuring that modified properties such as <c>Room</c> and <c>Bed</c> are persisted and retrievable after the update operation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=99cfbc0 body=7b6162a -->
     [Test]
         public async Task Update_ValidPointOfCare_UpdatesSuccessfully()
         {
@@ -108,6 +112,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that the repository's <c>FindById</c> method returns the correct <c>PointOfCare</c> document when queried with an existing identifier, by inserting a document and asserting that the retrieved entity matches the expected one.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d0f97dc body=a90f309 -->
     [Test]
         public async Task FindById_ExistingId_ReturnsPointOfCare()
         {
@@ -131,6 +136,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that FindByUnitAndStatus returns the matching <c>PointOfCare</c> documents when queried with an existing unit identifier and status.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1ec4a01 body=7d0923f -->
     [Test]
         public async Task FindByUnitAndStatus_ExistingUnitAndStatus_ReturnsMatchingPointOfCares()
         {
@@ -156,6 +162,7 @@ public class PointOfCareRepositoryTests
     /// Inserts a valid <c>PointOfCare</c> into the repository and verifies the search by room returns a non-null collection
     /// containing the expected entity. Assertions are only executed when the inserted <c>PointOfCare</c> has a non-null <c>Unit</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b29834f body=5f527db -->
     [Test]
         public async Task FindByRoom_ValidRoom_ReturnsMatchingPointOfCares()
         {
@@ -180,6 +187,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that the repository returns the matching PointOfCare when queried with a valid bed identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ee4a489 body=e8d8078 -->
     [Test]
         public async Task FindByBed_ValidBed_ReturnsMatchingPointOfCares()
         {
@@ -203,6 +211,7 @@ public class PointOfCareRepositoryTests
     /// <summary>
     /// Verifies that the <c>GetAll</c> repository method returns all stored <c>PointOfCare</c> entries, including a newly inserted one identified by its assigned Id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=054a987 body=913ed8f -->
     [Test]
         public async Task GetAll_ReturnsAllPointOfCares()
         {
diff --git a/adas-core.Test/Repositories/PumpAlarmEventRepositoryTest.cs b/adas-core.Test/Repositories/PumpAlarmEventRepositoryTest.cs
index 71512b3b..387a86ca 100644
--- a/adas-core.Test/Repositories/PumpAlarmEventRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PumpAlarmEventRepositoryTest.cs
@@ -36,6 +36,8 @@ public class PumpAlarmEventRepositoryTest
     /// alarm events covering both Device and DeviceB across attention and occlusion
     /// alarm types. Verifies that exactly three documents are present after seeding.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_summary
+    ///      "The summary mentions 'covering both Device and DeviceB' instead of 'DeviceA and DeviceB' (DeviceA actually has 2 of the 3 seeded events)" -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -96,6 +98,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that InsertAsync correctly persists a <see cref="PumpAlarmEvent"/> to the repository by inserting an event and confirming it can be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2215003 body=c74afba -->
     [Test]
         public async Task InsertAsync_Works()
         {
@@ -120,6 +123,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByDeviceIdAsync</c> returns a non-empty collection of records for the specified device, ordered by time so that the most recent entry appears first.
     /// </summary>
+    /// <!-- aidoc:v1 sig=01527dc body=aa6b0c8 -->
     [Test]
         public async Task FindByDeviceIdAsync_ReturnsOrdered()
         {
@@ -137,6 +141,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByDeviceIdAsync</c> returns only pump alarm events whose timestamps fall within the specified date range.
     /// </summary>
+    /// <!-- aidoc:v1 sig=181c278 body=5238e21 -->
     [Test]
         public async Task FindByDeviceIdAsync_WithDateRange_Works()
         {
@@ -156,6 +161,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByDeviceIdAsync</c> returns at most the specified number of results when a limit is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=88ed78c body=d3ad079 -->
     [Test]
         public async Task FindByDeviceIdAsync_WithLimit_Works()
         {
@@ -195,6 +201,7 @@ public class PumpAlarmEventRepositoryTest
     /// Verifies that DeleteByPatientId correctly removes all alarm events associated with a given patient.
     /// Inserts a sample <c>PumpAlarmEvent</c> for a specific patient, deletes it by patient ID, and asserts that no matching events remain in the collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d53a759 body=f0c6227 -->
     [Test]
         public async Task DeleteByPatientId_Works()
         {
@@ -224,6 +231,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>UpdateManyObjectIdByFiledNameAsync</c> correctly updates documents matching the specified field name and old ObjectId value, replacing it with the new ObjectId, and that the changes are persisted and queryable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=de41de1 body=b093999 -->
     [Test]
         public async Task UpdateManyObjectIdByFiledNameAsync_Works()
         {
@@ -252,6 +260,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByDeviceIdAsync</c> returns an empty result when the queried date range falls outside of the available data window.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1cb5677 body=2bd06ed -->
     [Test]
         public async Task FindByDeviceIdAsync_ReturnsEmpty_WhenOutOfRange()
         {
@@ -267,6 +276,7 @@ public class PumpAlarmEventRepositoryTest
     /// Verifies that <c>FindByDeviceIdAsync</c> correctly applies the requested limit and orders results so that the most recent alarm event for the given device is returned first.
     /// Seeds multiple events for the target device, requests a single record, and asserts that the returned entry matches the latest event retrieved by <c>FindLastByDeviceIdAsync</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0ace983 body=f479d09 -->
     [Test]
         public async Task FindByDeviceIdAsync_RespectsLimitAndOrder()
         {
@@ -292,6 +302,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that InsertAsync successfully persists a <see cref="PumpAlarmEvent"/> when its optional fields (<c>PatientId</c> and <c>AlarmType</c>) are <c>null</c>, and that the record can be retrieved afterwards.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6674243 body=d84c3f0 -->
     [Test]
         public async Task InsertAsync_AllowsNullOptionalFields()
         {
@@ -313,6 +324,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>DeleteByPatientId</c> removes all alarm events associated with the given patient and can be invoked repeatedly without throwing once the records no longer exist.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2c04cf9 body=6548dfc -->
     [Test]
         public async Task DeleteByPatientId_DeletesMany_AndIsIdempotent()
         {
@@ -342,6 +354,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that <c>UpdateManyObjectIdByFiledNameAsync</c> updates the <c>PatientId</c> field from an old <see cref="ObjectId"/> to a new one across all matching documents, returning the modified count and persisting the new identifier in the collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=898d198 body=909945a -->
     [Test]
         public async Task UpdateManyObjectIdByFiledNameAsync_UpdatesMultiple()
         {
@@ -373,6 +386,7 @@ public class PumpAlarmEventRepositoryTest
     /// ensuring events whose timestamp matches the upper bound exactly are returned and that all returned
     /// events fall within the supplied range.
     /// </summary>
+    /// <!-- aidoc:v1 sig=21f5b81 body=0975796 -->
     [Test]
         public async Task FindByDeviceIdAsync_InclusiveRange_BoundsRespected()
         {
@@ -403,6 +417,7 @@ public class PumpAlarmEventRepositoryTest
     /// <summary>
     /// Verifies that FindLastByDeviceIdAsync returns the most recent alarm event for a given device and tracks newly inserted events as the latest entry.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d24d18d body=a473c62 -->
     [Test]
         public async Task FindLastByDeviceIdAsync_TracksNewest()
         {
@@ -428,6 +443,7 @@ public class PumpAlarmEventRepositoryTest
     /// and time range when multiple queries are issued against overlapping windows, ensuring each
     /// range returns only the event that falls within its boundaries.
     /// </summary>
+    /// <!-- aidoc:v1 sig=62e28e4 body=55ca12b -->
     [Test]
         public async Task FindByDeviceIdAsync_MultipleOverlappingRanges()
         {
diff --git a/adas-core.Test/Repositories/PumpAlarmStateRepositoryTest.cs b/adas-core.Test/Repositories/PumpAlarmStateRepositoryTest.cs
index 31d2d700..7275c3ba 100644
--- a/adas-core.Test/Repositories/PumpAlarmStateRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PumpAlarmStateRepositoryTest.cs
@@ -34,6 +34,7 @@ public class PumpAlarmStateRepositoryTest
     /// One-time setup that prepares the integration test environment for <see cref="PumpAlarmStateRepository"/>.
     /// Configures the API settings, drops and recreates the "pump_alarm_state" collection, instantiates the repository with its indexes, and seeds three initial alarm state records across two devices, verifying the seeded count.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=321fe16 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -96,6 +97,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that <c>FindActiveAsync</c> returns the correct active alarm matching the specified device identifier, alarm type, and alarm code.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6e7817c body=1072320 -->
     [Test]
         public async Task FindActiveAsync_ReturnsCorrectAlarm()
         {
@@ -113,6 +115,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that <c>FindActiveAsync</c> returns <c>null</c> when no active alarm matching the specified device, alarm type, and identifier exists.
     /// </summary>
+    /// <!-- aidoc:v1 sig=448af76 body=5d7c302 -->
     [Test]
         public async Task FindActiveAsync_ReturnsNull_WhenNotFound()
         {
@@ -128,6 +131,7 @@ public class PumpAlarmStateRepositoryTest
     /// when no existing alarm with the same device, type, and code is found, and that the inserted alarm
     /// can subsequently be retrieved via <c>FindActiveAsync</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=df40b99 body=b502791 -->
     [Test]
         public async Task UpsertActiveAsync_InsertsNew()
         {
@@ -179,6 +183,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that <c>RemoveAsync</c> correctly deletes an active alarm by device, alarm type, and alarm code, and that a subsequent lookup returns no result.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7cec1b8 body=57f46a1 -->
     [Test]
         public async Task RemoveAsync_Works()
         {
@@ -207,6 +212,7 @@ public class PumpAlarmStateRepositoryTest
     /// Verifies that the repository's <c>DeleteByPatientId</c> method successfully removes a previously upserted
     /// <see cref="PumpAlarmState"/> for the specified patient, ensuring no matching records remain in the collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d53a759 body=f655df6 -->
     [Test]
         public async Task DeleteByPatientId_Works()
         {
@@ -236,6 +242,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that <c>FindAllActiveByDeviceAsync</c> returns only active pump alarm states that belong to the specified device.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5c3d431 body=6ed6d8e -->
     [Test]
         public async Task FindAllActiveByDeviceAsync_ReturnsCorrect()
         {
@@ -254,6 +261,7 @@ public class PumpAlarmStateRepositoryTest
     /// from the old ObjectId to a new ObjectId for matching documents, returning the expected count of
     /// updated records and making the document retrievable by the new ObjectId.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ed519f8 body=169b572 -->
     [Test]
         public async Task UpdateManyObjectIdByFieldNameAsync_Works()
         {
@@ -312,6 +320,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that UpsertActiveAsync correctly inserts a PumpAlarmState record when the AlarmCodeMdc is null, and that the record can be retrieved via FindActiveAsync using a null alarm code.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1cd185f body=08dbadd -->
     [Test]
         public async Task UpsertActiveAsync_InsertsWhenAlarmCodeIsNull()
         {
@@ -336,6 +345,7 @@ public class PumpAlarmStateRepositoryTest
     /// <summary>
     /// Verifies that <c>RemoveAsync</c> removes every active alarm matching the specified device identifier and alarm type, not just a single record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e06229e body=5ac9fd3 -->
     [Test]
         public async Task RemoveAsync_RemovesAllMatching()
         {
diff --git a/adas-core.Test/Repositories/PumpArchiveRepositoryTest.cs b/adas-core.Test/Repositories/PumpArchiveRepositoryTest.cs
index 13b3c0b1..020916e4 100644
--- a/adas-core.Test/Repositories/PumpArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PumpArchiveRepositoryTest.cs
@@ -192,6 +192,7 @@ public class PumpArchiveRepositoryTest
     /// <summary>
     /// Verifies that the <c>DeleteBeforeDate</c> repository method removes all records with a date earlier than the specified cutoff, retaining only records dated on or after that cutoff.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=b97504a -->
     [Test]
         public async Task DeleteBeforeDate()
         {
diff --git a/adas-core.Test/Repositories/PumpObservationRepositoryTest.cs b/adas-core.Test/Repositories/PumpObservationRepositoryTest.cs
index b7541b7f..22e1eea3 100644
--- a/adas-core.Test/Repositories/PumpObservationRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PumpObservationRepositoryTest.cs
@@ -219,6 +219,8 @@ public class PumpObservationRepositoryTest
     /// Verifies that the aggregated last observations retrieved for the test <c>PatientId</c> are distinct by name, ensuring the resulting collection is non-empty and contains at most two entries.
     /// </summary>
     /// <!-- aidoc:v1 sig=878cf7b body=9a03f04 -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary states the test 'verifies that the aggregated last observations... are distinct by name', but the assertions only check that the result is non-empty and has at most two entries — no distinctness-by-name check is performed." -->
     [Test]
     public async Task AggregatedPatientLastObservations_DistinctByName()
     {
@@ -309,6 +311,8 @@ public class PumpObservationRepositoryTest
     /// Verifies that <see cref="_repo.DeleteKeepLastNAsync"/> correctly deletes the older records while preserving the most recent <paramref name="n"/> entries, returning the expected count of deleted items.
     /// </summary>
     /// <!-- aidoc:v1 sig=6f857ff body=814bec4 -->
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_param_role
+    ///      "<paramref name=\"n\"/> references a parameter named 'n' but the test method DeleteKeepLastNAsync_Works has no parameters; 'n' is actually an argument passed to the called method DeleteKeepLastNAsync(3)." -->
     [Test]
     public async Task DeleteKeepLastNAsync_Works()
     {
diff --git a/adas-core.Test/Repositories/PumpStateRepositoryTest.cs b/adas-core.Test/Repositories/PumpStateRepositoryTest.cs
index 6de21fb2..a520299b 100644
--- a/adas-core.Test/Repositories/PumpStateRepositoryTest.cs
+++ b/adas-core.Test/Repositories/PumpStateRepositoryTest.cs
@@ -35,6 +35,7 @@ public class PumpStateRepositoryTest
     /// "pump_states" MongoDB collection, building the repository indexes, and seeding two initial pump states (one
     /// actively infusing for a known patient/device and one not infusing) to verify the baseline document count.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=a2190cd -->
     [OneTimeSetUp]
     public async Task Init()
     {
@@ -89,6 +90,7 @@ public class PumpStateRepositoryTest
     /// <summary>
     /// Verifies that FindByDeviceIdAsync retrieves the correct infusion state for a given device, returning a non-null result that matches the requested device identifier and reflects the expected infusion status.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e52b862 body=d7db598 -->
     [Test]
     public async Task FindByDeviceIdAsync_ReturnsCorrectState()
     {
@@ -108,6 +110,7 @@ public class PumpStateRepositoryTest
     /// <summary>
     /// Verifies that <c>UpsertAsync</c> inserts a new <see cref="PumpState"/> record when no existing entry is found for the specified <c>DeviceId</c>, and that the persisted state retains the provided property values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=428a2bd body=4500878 -->
     [Test]
     public async Task UpsertAsync_InsertsNewWhenNotExists()
     {
@@ -131,6 +134,7 @@ public class PumpStateRepositoryTest
     /// the updated <see cref="PumpState"/> is persisted and retrievable with the modified <c>IsInfusing</c>,
     /// <c>Status</c>, and <c>LastUpdated</c> values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8838ddb body=654a229 -->
     [Test]
     public async Task UpsertAsync_UpdatesExistingState()
     {
@@ -165,6 +169,7 @@ public class PumpStateRepositoryTest
     /// <summary>
     /// Verifies that <c>GetAllAsync</c> returns a non-null collection of pump states containing at least two entries, including those associated with the seeded devices A and B.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a469772 body=1e9a940 -->
     [Test]
     public async Task GetAllAsync_ReturnsAllStates()
     {
@@ -190,6 +195,7 @@ public class PumpStateRepositoryTest
     /// <summary>
     /// Verifies that UpsertAsync updates an existing entity instead of inserting a duplicate, ensuring the total record count remains unchanged when upserting a <see cref="PumpState"/> for an already-known device identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0293756 body=e6aaf62 -->
     [Test]
     public async Task UpsertAsync_DoesNotCreateDuplicates()
     {
diff --git a/adas-core.Test/Repositories/RecordingAlertArchiveRepositoryTest.cs b/adas-core.Test/Repositories/RecordingAlertArchiveRepositoryTest.cs
index 27647c33..2f007eec 100644
--- a/adas-core.Test/Repositories/RecordingAlertArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/RecordingAlertArchiveRepositoryTest.cs
@@ -22,6 +22,7 @@ public class RecordingAlertArchiveRepositoryTest
     /// <summary>
     /// One-time test setup that prepares the archive collection for recording-alert integration tests by clearing it, creating a fresh instance of <see cref="RecordingAlertArchiveRepository"/>, and seeding it with two patient recording alerts (one matching the current patient with the current timestamp and one for a different patient dated ten days earlier), verifying that both records are persisted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=8b97155 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -69,6 +70,7 @@ public class RecordingAlertArchiveRepositoryTest
     /// Verifies that the repository's <c>DeleteBeforeDate</c> operation removes all documents dated before the specified cutoff date, leaving only documents on or after that date.
     /// Expects more than one document in the collection initially and exactly one remaining after deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=b97504a -->
     [Test]
         public async Task DeleteBeforeDate()
         {
diff --git a/adas-core.Test/Repositories/RecordingAlertRepositoryTest.cs b/adas-core.Test/Repositories/RecordingAlertRepositoryTest.cs
index 993d3775..cb381272 100644
--- a/adas-core.Test/Repositories/RecordingAlertRepositoryTest.cs
+++ b/adas-core.Test/Repositories/RecordingAlertRepositoryTest.cs
@@ -23,6 +23,7 @@ public class RecordingAlertRepositoryTest
     /// One-time test setup that initializes the recording alert repository with two sample patient recording alerts
     /// and ensures the underlying collection contains exactly two documents for integration test scenarios.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=9f3c759 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -69,6 +70,7 @@ public class RecordingAlertRepositoryTest
     /// <summary>
     /// Verifies that the repository's DeleteAsync method successfully removes a PatientRecordingAlert document, confirming the record exists prior to deletion and is no longer retrievable afterwards.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fff9e82 body=bbaa167 -->
     [Test]
         public async Task DeleteAsync()
         {
@@ -97,6 +99,7 @@ public class RecordingAlertRepositoryTest
     /// <summary>
     /// Tests that the <c>DeleteOlderDaysAsync</c> repository method removes patient recording alerts that exceed the specified age threshold and match the given recording name, while preserving alerts within the threshold.
     /// </summary>
+    /// <!-- aidoc:v1 sig=da9fb95 body=be75e5b -->
     [Test]
         public async Task DeleteOlderDaysAsync()
         {
@@ -142,6 +145,7 @@ public class RecordingAlertRepositoryTest
     /// Verifies that <c>DeleteOlderNumberAsync</c> removes older records with the specified name, keeping only the most recent ones according to the provided count.
     /// Inserts two <see cref="PatientRecordingAlert"/> entries sharing the same name but different timestamps, asserts both exist, performs the deletion, and confirms that only one record remains.
     /// </summary>
+    /// <!-- aidoc:v1 sig=340569b body=9066da5 -->
     [Test]
         public async Task DeleteOlderNumberAsync()
         {
@@ -180,6 +184,7 @@ public class RecordingAlertRepositoryTest
     /// <summary>
     /// Verifies that <c>DeleteByPatientId</c> removes a patient's recording alert from the repository, ensuring the alert cannot be retrieved after deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=79b17ee body=abcb960 -->
     [Test]
         public async Task DeleteByPatientId()
         {
@@ -216,6 +221,7 @@ public class RecordingAlertRepositoryTest
     /// <summary>
     /// Verifies that the repository returns a non-null result when searching for records by patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3d9563b body=644ea5e -->
     [Test]
         public async Task FindByPatientIdAsync()
         {
@@ -229,6 +235,7 @@ public class RecordingAlertRepositoryTest
     /// for a given patient and recording name, filtering out older entries based on the
     /// specified count limit, and that the returned observation matches the expected time.
     /// </summary>
+    /// <!-- aidoc:v1 sig=180119e body=50b755a -->
     [Test]
         public async Task FindLastObservations()
         {
@@ -278,6 +285,7 @@ public class RecordingAlertRepositoryTest
     /// <summary>
     /// Tests the repository's ability to update the <c>patientid</c> ObjectId field across records, verifying that after the update the original patient identifier no longer returns any alerts while the new patient identifier does, and that deletion by patient ID subsequently removes the record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ccbfce8 body=9bdadf4 -->
     [Test]
         public async Task UpdateManyObjectId()
         {
diff --git a/adas-core.Test/Repositories/ServiceConfigRepositoryTest.cs b/adas-core.Test/Repositories/ServiceConfigRepositoryTest.cs
index a7d3815d..4ef4204a 100644
--- a/adas-core.Test/Repositories/ServiceConfigRepositoryTest.cs
+++ b/adas-core.Test/Repositories/ServiceConfigRepositoryTest.cs
@@ -21,6 +21,7 @@ public class ServiceConfigRepositoryTest
     /// <summary>
     /// Performs one-time initialization for integration tests by creating a <see cref="ServiceConfig"/> entry in the test database and preparing the repository used by the test fixture.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=0b44aa1 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -57,6 +58,7 @@ public class ServiceConfigRepositoryTest
     /// Verifies that <see cref="_repository"/>.FindById returns a non-null entity when queried by its string identifier,
     /// and that the returned entity's <c>StrId</c> matches the supplied id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a6c49cf body=afa730e -->
     [Test]
         public async Task FindById_Find_string()
         {
@@ -70,6 +72,7 @@ public class ServiceConfigRepositoryTest
     /// Verifies that the repository's FindById method successfully retrieves an object by its identifier,
     /// returning a non-null result whose Id matches the requested identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=eb5b627 body=fbdee32 -->
     [Test]
         public async Task FindById_Find_ObjectId()
         {
diff --git a/adas-core.Test/Repositories/TreatmentArchiveRepositoryTest.cs b/adas-core.Test/Repositories/TreatmentArchiveRepositoryTest.cs
index 6c175659..598dfbf1 100644
--- a/adas-core.Test/Repositories/TreatmentArchiveRepositoryTest.cs
+++ b/adas-core.Test/Repositories/TreatmentArchiveRepositoryTest.cs
@@ -23,6 +23,7 @@ public class TreatmentArchiveRepositoryTest
     /// <summary>
     /// One-time setup method that prepares the integration test environment for the treatment archive repository by creating and inserting two sample patient treatments (one new and one discontinued) into a freshly created archive collection.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=4a90d78 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -82,6 +83,7 @@ public class TreatmentArchiveRepositoryTest
     /// Tests the <see cref="DeleteBeforeDate"/> repository method to ensure it correctly removes records older than the specified cutoff date,
     /// leaving only the most recent record. Verifies that when multiple patient records exist, deletion by date retains exactly one record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d3a5eeb body=7124e14 -->
     [Test]
         public async Task DeleteBeforeDate()
         {
@@ -101,6 +103,7 @@ public class TreatmentArchiveRepositoryTest
     /// <summary>
     /// Verifies that the repository successfully retrieves a non-empty collection of records associated with the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8768b4a body=58e5f0b -->
     [Test]
         public async Task FindAllFromPatient()
         {
diff --git a/adas-core.Test/Repositories/TreatmentRepositoryTest.cs b/adas-core.Test/Repositories/TreatmentRepositoryTest.cs
index 487fbd0a..6c16d862 100644
--- a/adas-core.Test/Repositories/TreatmentRepositoryTest.cs
+++ b/adas-core.Test/Repositories/TreatmentRepositoryTest.cs
@@ -24,6 +24,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// One-time test setup that resets the treatments collection, instantiates the repository, and seeds two patient treatments (one with OrderControlType.Nw and one with OrderControlType.Dc) to verify insert behavior.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=d7a95ac -->
     [OneTimeSetUp]
     public async Task Init()
     {
@@ -89,6 +90,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// Verifies that GetByPatientId returns an empty result collection rather than null when no patient treatments are found for the supplied patient identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5d6b968 body=becd285 -->
     [Test]
     public async Task GetByPatientId_Not_Find_Return_Null()
     {
@@ -103,6 +105,7 @@ public class TreatmentRepositoryTest
     /// Tests that the repository's <c>GetByPatientId</c> method returns the expected patient treatment records
     /// for the given patient, verifying that the result is not null and contains the expected number of entries.
     /// </summary>
+    /// <!-- aidoc:v1 sig=522d60f body=0afdfdf -->
     [Test]
     public async Task GetByPatientId_Find_Return_Null()
     {
@@ -117,6 +120,7 @@ public class TreatmentRepositoryTest
     /// Verifies that <see cref="DeleteAsync"/> successfully removes a persisted patient treatment from the repository.
     /// The test inserts a treatment, confirms it exists, deletes it by id, and asserts it is no longer retrievable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fff9e82 body=fe6c727 -->
     [Test]
     public async Task DeleteAsync()
     {
@@ -151,6 +155,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// Verifies that <c>FindByPatientIdAsync</c> returns a non-null list containing the expected number of treatments for the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bf1a413 body=cdada4a -->
     [Test]
     public async Task FindByPatientIdAsync_Find_Return_List_Traetments()
     {
@@ -163,6 +168,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// Verifies that <see cref="DeleteByPatientId"/> removes the patient treatment associated with the given patient identifier, ensuring no records remain for that patient after deletion.
     /// </summary>
+    /// <!-- aidoc:v1 sig=79b17ee body=fadf697 -->
     [Test]
     public async Task DeleteByPatientId()
     {
@@ -197,6 +203,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// Verifies that _repository.FindBolusTreatments returns a non-null collection containing exactly one bolus treatment for the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dfa52bd body=9cc200d -->
     [Test]
     public async Task FindBolusTreatments_Find_Return_Treatment()
     {
@@ -209,6 +216,7 @@ public class TreatmentRepositoryTest
     /// <summary>
     /// Verifies that FindByPatientIdAsync returns a non-null list containing the expected number of treatments for the specified patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=843efa7 body=cdada4a -->
     [Test]
     public async Task FindByPatientId_Find_Return_List_Traetments()
     {
diff --git a/adas-core.Test/Repositories/UnitRepositoryTest.cs b/adas-core.Test/Repositories/UnitRepositoryTest.cs
index 3e6fae81..33c90a80 100644
--- a/adas-core.Test/Repositories/UnitRepositoryTest.cs
+++ b/adas-core.Test/Repositories/UnitRepositoryTest.cs
@@ -22,6 +22,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// One-time setup method that prepares the integration test environment by configuring API settings, creating a fresh "units" collection in the database, and seeding it with two sample <see cref="Unit"/> records via the <see cref="UnitRepository"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=a56e489 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -65,6 +66,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// Verifies that inserting a valid <see cref="Unit"/> into the repository returns the unit and that the inserted unit can be successfully retrieved by its identifier, with key properties preserved.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9b26826 body=ddc8404 -->
     [Test]
         public async Task InsertOneUnit_ValidUnit_ReturnsUnit()
         {
@@ -132,6 +134,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// Verifies that FindById retrieves the matching <see cref="Unit"/> from the repository when a valid identifier is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=502c001 body=dc7d781 -->
     [Test]
         public async Task FindById_ValidId_ReturnsUnit()
         {
@@ -157,6 +160,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// Verifies that FindById returns <c>null</c> when queried with an ID that does not exist in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=eeda1b7 body=fa50971 -->
     [Test]
         public async Task FindById_InvalidId_ReturnsNull()
         {
@@ -214,6 +218,7 @@ public class UnitRepositoryTest
     /// Verifies that the repository's <c>FindByName</c> method returns the matching unit when called with a valid unit name.
     /// The test inserts a unit, retrieves it by name, and asserts that the returned entity is not null and has the expected name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1b153db body=e466985 -->
     [Test]
         public async Task FindByName_ValidName_ReturnsUnit()
         {
@@ -239,6 +244,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// Verifies that the repository's FindByName method returns null when invoked with a name that does not match any existing entity.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bca62d2 body=2ab2e2d -->
     [Test]
         public async Task FindByName_InvalidName_ReturnsNull()
         {
@@ -353,6 +359,7 @@ public class UnitRepositoryTest
     /// Verifies that <c>GetAll</c> returns a non-null collection containing the units that have been inserted into the repository.
     /// </summary>
     /// <exception cref="ArgumentNullException">Thrown when the <c>units</c> collection used to seed the repository is <c>null</c>.</exception>
+    /// <!-- aidoc:v1 sig=5b909a9 body=2d25d8f -->
     [Test]
         public async Task GetAll_ReturnsAllUnits()
         {
@@ -381,6 +388,7 @@ public class UnitRepositoryTest
     /// <summary>
     /// Verifies that UpdateUnit correctly updates an existing unit in the repository and returns the updated entity with the new title and the original identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0c12e38 body=287b440 -->
     [Test]
         public async Task UpdateUnit_ValidUnit_ReturnsUpdatedUnit()
         {
diff --git a/adas-core.Test/Repositories/UserRepositoryTest.cs b/adas-core.Test/Repositories/UserRepositoryTest.cs
index bc704f8c..4f5005ff 100644
--- a/adas-core.Test/Repositories/UserRepositoryTest.cs
+++ b/adas-core.Test/Repositories/UserRepositoryTest.cs
@@ -18,6 +18,7 @@ public class UserRepositoryTest
     /// <summary>
     /// One-time integration test setup that prepares a clean "users" collection in the test database and seeds it with two predefined users, ensuring a deterministic state for downstream test cases.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=4cb16c2 -->
     [OneTimeSetUp]
         public async Task Init()
         {
@@ -61,6 +62,7 @@ public class UserRepositoryTest
     /// <summary>
     /// Verifies that the <see cref="_repository"/>'s <c>GetUser</c> method asynchronously returns a non-null user with the expected username and password credentials.
     /// </summary>
+    /// <!-- aidoc:v1 sig=04ad7c8 body=29ee994 -->
     [Test]
         public async Task GetUser()
         {
diff --git a/adas-core.Test/Services/AdmissionServiceTest.cs b/adas-core.Test/Services/AdmissionServiceTest.cs
index 667cd4aa..be545cd8 100644
--- a/adas-core.Test/Services/AdmissionServiceTest.cs
+++ b/adas-core.Test/Services/AdmissionServiceTest.cs
@@ -18,6 +18,7 @@ namespace adas_core.Test.Services;
 /// <summary>
 /// Contains unit tests for verifying the behavior of the <see cref="AdmissionService"/> class.
 /// </summary>
+/// <!-- aidoc:v1 sig=0c8cbc0 -->
 public class AdmissionServiceTest
 {
     private Mock<IAdmissionRepository> _admissionRepositoryMock;
@@ -89,6 +90,7 @@ public class AdmissionServiceTest
     /// Verifies that the admission service successfully deletes a valid admission by ensuring the repository's
     /// Delete operation is invoked exactly once for the corresponding admission identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ff6349a body=41733f5 -->
     [Test]
         public async Task DeleteAdmissionAsync_ValidAdmission_DeletesSuccessfully()
         {
@@ -109,6 +111,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that <c>DeleteAdmissionByIdAsync</c> successfully deletes an admission when it exists in the repository, by ensuring the repository's <c>Delete</c> method is invoked exactly once for the given admission identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ca0aebd body=1a986c5 -->
     [Test]
         public async Task DeleteAdmissionByIdAsync_AdmissionExists_DeletesSuccessfully()
         {
@@ -131,6 +134,7 @@ public class AdmissionServiceTest
     /// associated patient location (unit, bed, and room) when the admission exists in the repository and the
     /// corresponding point of care is successfully resolved.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8868841 body=7a047e6 -->
     [Test]
         public async Task GetAdmissionByIdAsync_AdmissionExists_ReturnsAdmissionWithPatientLocation()
         {
@@ -160,6 +164,7 @@ public class AdmissionServiceTest
     /// Verifies that GetAdmissionsAsync returns admissions enriched with their associated patient location details
     /// retrieved from the point of care service.
     /// </summary>
+    /// <!-- aidoc:v1 sig=13eea4d body=5097039 -->
     [Test]
         public async Task GetAdmissionsAsync_ReturnsAdmissionsWithPatientLocations()
         {
@@ -233,6 +238,7 @@ public class AdmissionServiceTest
     /// invoking the repository's Update method and retrieving point-of-care information for both the new and the
     /// previous point of care associated with the admission.
     /// </summary>
+    /// <!-- aidoc:v1 sig=947fcb9 body=5539a54 -->
     [Test]
         public async Task UpdateAdmissionAsync_WhenAdmissionExists_UpdatesAdmission()
         {
@@ -287,6 +293,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that admitting a patient with a valid admission—where the associated unit is found and the point of care matches—results in a new patient being inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e2d99bb body=d8e5f1d -->
     [Test]
         public async Task AdmitPatient_WithValidAdmission_CreatesPatientAndDeletesAdmission()
         {
@@ -315,6 +322,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that GetAdmissionByLocation returns the expected list of admissions when a matching patient location is found, confirming the service correctly retrieves results from the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1bd035d body=629b781 -->
     [Test]
         public async Task GetAdmissionByLocation_LocationExists_ReturnsAdmissions()
         {
@@ -345,6 +353,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that <see cref="AdmissionService.GetAdmissionByLocation"/> returns an empty result when the requested location does not exist, simulating the not-found scenario by having the repository throw an exception.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3fa7d19 body=0413056 -->
     [Test]
         public async Task GetAdmissionByLocation_LocationNotFound_ReturnsNull()
         {
@@ -371,6 +380,7 @@ public class AdmissionServiceTest
     /// <c>GetAdmissionByPointOfCareId</c> are enriched with patient location details (unit name, bed, and room)
     /// retrieved from the corresponding Point of Care entity.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9e8788f body=f355f5f -->
     [Test]
         public async Task GetAdmissionByPointOfCareId_POCExists_ReturnsAdmissionsWithLocation()
         {
@@ -414,6 +424,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that <see cref="AdmissionService.GetAdmissionByPointOfCareId"/> returns an empty result when the underlying repository throws an exception while attempting to find an admission by point of care id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=38a42b6 body=272b246 -->
     [Test]
         public async Task GetAdmissionByPointOfCareId_POCNotFound_ReturnsNull()
         {
@@ -434,6 +445,7 @@ public class AdmissionServiceTest
     /// Verifies that <see cref="AdmissionService.GetAdmissionByUnitIdWithOutPoC"/> returns the expected list of admissions
     /// when a valid unit identifier is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=991c53f body=6e3b77c -->
     [Test]
         public async Task GetAdmissionByUnitIdWithOutPoC_UnitIdExists_ReturnsAdmissions()
         {
@@ -462,6 +474,8 @@ public class AdmissionServiceTest
     /// throws an exception while looking up the given unit identifier.
     /// </summary>
     /// <param name="unitId">The identifier of the unit whose admission record is being requested.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The <param name=\"unitId\"> tag documents a parameter that does not exist on the test method; unitId is a local variable, not a method parameter." -->
     [Test]
         public async Task GetAdmissionByUnitIdWithOutPoC_UnitIdNotFound_ReturnsNull()
         {
@@ -580,6 +594,7 @@ public class AdmissionServiceTest
     /// <summary>
     /// Verifies that InsertAdmission throws a NotFoundException and performs no insert or update operations when a required associated resource is not found while processing a valid admission.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bdfda99 body=4d28639 -->
     [Test]
         public async Task InsertAdmission_ValidAdmission_InsertsSuccessfullyWithUser()
         {
diff --git a/adas-core.Test/Services/AlarmServiceTest.cs b/adas-core.Test/Services/AlarmServiceTest.cs
index 1b8f9262..0002fe4e 100644
--- a/adas-core.Test/Services/AlarmServiceTest.cs
+++ b/adas-core.Test/Services/AlarmServiceTest.cs
@@ -17,6 +17,7 @@ namespace adas_core.Test.Services;
 /// <summary>
 /// Contains unit tests for verifying the behavior and functionality of the <see cref="AlarmService"/> class.
 /// </summary>
+/// <!-- aidoc:v1 sig=c43823a -->
 public class AlarmServiceTest
 {
     private readonly Mock<IAlarmRepository> _alarmRepositoryMock;
@@ -121,6 +122,7 @@ public class AlarmServiceTest
     /// <summary>
     /// Verifies that when an ORU_R40 type request is processed without any alarms, the patient is located but the observation is not persisted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a5366da body=1b7e9c5 -->
     [Test]
         public async Task SaveRequest_Oru_R40_Type_Without_Alarms_Dont_Insert()
         {
@@ -151,6 +153,7 @@ public class AlarmServiceTest
     /// <summary>
     /// Verifies that <see cref="AlarmService.ProcessAlarmObservations"/> inserts the provided alarm observations into the alarm repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=055d260 body=8ccc248 -->
     [Test]
         public async Task ProcessAlarmObservations_Should_Insert_Alarm_Observations()
         {
@@ -183,6 +186,7 @@ public class AlarmServiceTest
     /// (coding system "ADAS_EVENT", description "EVT_LO and EVT_EXTR_LO"), the alarm service does not insert a new observation,
     /// as indicated by the verification that <c>InsertObservation</c> is never invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=108393a body=30d7b84 -->
     [Test]
         public async Task CheckObservationAlarm_Alarm_EventPEEP_PEEP_bajo_create_Event()
         {
@@ -211,6 +215,7 @@ public class AlarmServiceTest
     /// observation with the original value preserved (e.g., "PEEP High") while the alarm
     /// configuration handles the red beacon signaling.
     /// </summary>
+    /// <!-- aidoc:v1 sig=eb5bfdd body=09dd5c4 -->
     [Test]
         public async Task CheckObservationAlarm_Should_Launch_Red_Alarm_And_Set_BeaconColor_Red()
         {
diff --git a/adas-core.Test/Services/CacheDispatcherTest.cs b/adas-core.Test/Services/CacheDispatcherTest.cs
index 1c99757c..d3839ab2 100644
--- a/adas-core.Test/Services/CacheDispatcherTest.cs
+++ b/adas-core.Test/Services/CacheDispatcherTest.cs
@@ -17,6 +17,7 @@ namespace adas_core.Test.Services;
 /// <summary>
 /// Provides a fake implementation of the <see cref="ILockProvider"/> interface, typically used as a test double or non-functional placeholder.
 /// </summary>
+/// <!-- aidoc:v1 sig=861367a -->
 public class FakeLockProvider : ILockProvider
 {
     /// <summary>
@@ -26,11 +27,13 @@ public class FakeLockProvider : ILockProvider
     /// <param name="key">The identifier of the resource to acquire.</param>
     /// <param name="timeout">The maximum time to wait for the resource to become available.</param>
     /// <returns>A <see cref="Task{TResult}"/> that always completes with <c>true</c>, indicating the resource was acquired.</returns>
+    /// <!-- aidoc:v1 sig=c012d6a -->
     public Task<bool> AcquireAsync(string key, TimeSpan timeout) => Task.FromResult(true);
     /// <summary>
     /// Releases the resource associated with the specified key. This implementation completes immediately without performing any additional operation.
     /// </summary>
     /// <param name="key">The identifier of the resource to release.</param>
+    /// <!-- aidoc:v1 sig=34ce6e6 -->
     public Task ReleaseAsync(string key) => Task.CompletedTask;
 }
 
@@ -40,6 +43,7 @@ public class FakeLockProvider : ILockProvider
 /// <remarks>
 /// Inherits all members from <see cref="LockManagerService"/> and is intended to be used in place of the real service when actual locking functionality is not required.
 /// </remarks>
+/// <!-- aidoc:v1 sig=912ee25 -->
 public class FakeLockManagerService : LockManagerService
 {
     /// <summary>
@@ -60,6 +64,7 @@ public class FakeLockManagerService : LockManagerService
 /// <remarks>
 /// This class combines the inheritance of <see cref="RedisService"/> with the contract of <see cref="ICacheService"/>, allowing it to stand in for a real Redis-backed cache during unit tests or development.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8effc11 -->
 public class FakeRedisService : RedisService, ICacheService
 {
     public bool WasCalled { get; private set; }
@@ -86,6 +91,7 @@ public class FakeRedisService : RedisService, ICacheService
     /// <param name="ttl">An optional time-to-live duration for the cached entry. Not used in this implementation.</param>
     /// <param name="cancellationToken">A token to observe for cancellation requests. Not used in this implementation.</param>
     /// <returns>A task that represents the asynchronous operation, containing the object produced by the factory.</returns>
+    /// <!-- aidoc:v1 sig=f7027e3 body=b366c2a -->
     Task<T> ICacheService.GetOrSetObjectAsync<T>(
             string key,
             Func<Task<T>> factory,
@@ -107,6 +113,7 @@ public class FakeRedisService : RedisService, ICacheService
     /// <param name="ttl">An optional time-to-live duration for the cached entry.</param>
     /// <param name="cancellationToken">The token used to cancel the asynchronous operation.</param>
     /// <returns>The value of type <typeparamref name="T"/> produced by the <paramref name="factory"/> delegate.</returns>
+    /// <!-- aidoc:v1 sig=efeef03 body=0bb8f50 -->
     Task<T> ICacheService.GetOrSetObjectAsync<T>(
             GroupedField groupedField,
             ObjectId patientId,
@@ -126,6 +133,7 @@ public class FakeRedisService : RedisService, ICacheService
 /// <remarks>
 /// This class combines inheritance from the concrete <see cref="CacheService"/> base class with the <see cref="ICacheService"/> contract, allowing it to be used wherever an <see cref="ICacheService"/> is required.
 /// </remarks>
+/// <!-- aidoc:v1 sig=db2971f -->
 public class FakeCacheService : CacheService, ICacheService
 {
     public bool WasCalled { get; private set; }
@@ -148,6 +156,15 @@ public class FakeCacheService : CacheService, ICacheService
     /// <param name="cancellationToken">Token to cancel the operation; ignored by this implementation.</param>
     /// <returns>The <see cref="Task{T}"/> produced by invoking <paramref name="factory"/>.</returns>
     /// <!-- aidoc:v1 sig=f7027e3 body=b366c2a -->
+    /// <summary>
+    /// Explicit <see cref="ICacheService"/> implementation that always invokes <paramref name="factory"/> and ignores <paramref name="ttl"/> and <paramref name="cancellationToken"/>, effectively bypassing the cache and returning the value freshly produced for the supplied <paramref name="key"/>.
+    /// </summary>
+    /// <param name="key">The cache key identifying the requested entry.</param>
+    /// <param name="factory">The asynchronous delegate invoked to produce the value.</param>
+    /// <param name="ttl">The optional cache lifetime. Not applied by this implementation.</param>
+    /// <param name="cancellationToken">The token used to cancel the operation. Not observed by this implementation.</param>
+    /// <returns>A <see cref="Task{T}"/> that completes with the value returned by <paramref name="factory"/>.</returns>
+    /// <!-- aidoc:v1 sig=f7027e3 body=b366c2a -->
     Task<T> ICacheService.GetOrSetObjectAsync<T>(
         string key,
         Func<Task<T>> factory,
@@ -170,6 +187,18 @@ public class FakeCacheService : CacheService, ICacheService
     /// <param name="cancellationToken">A <see cref="CancellationToken"/> to cancel the operation.</param>
     /// <returns>A <see cref="Task{T}"/> that resolves to the value returned by <paramref name="factory"/>.</returns>
     /// <!-- aidoc:v1 sig=efeef03 body=0bb8f50 -->
+    /// <summary>
+    /// Test implementation of <see cref="ICacheService.GetOrSetObjectAsync{T}"/> that bypasses caching
+    /// and directly invokes the supplied <paramref name="factory"/> delegate, recording the call via the
+    /// WasCalled flag for verification purposes.
+    /// </summary>
+    /// <param name="groupedField">The <see cref="GroupedField"/> identifying the group context for the cached or computed object.</param>
+    /// <param name="patientId">The <see cref="ObjectId"/> of the patient whose data is being retrieved.</param>
+    /// <param name="factory">The <see cref="Func{Task{T}}"/> delegate invoked to produce the result.</param>
+    /// <param name="ttl">Optional time-to-live duration; ignored by this implementation.</param>
+    /// <param name="cancellationToken">Token to observe for cancellation; ignored by this implementation.</param>
+    /// <returns>The <see cref="Task{T}"/> produced by invoking <paramref name="factory"/>.</returns>
+    /// <!-- aidoc:v1 sig=efeef03 body=0bb8f50 -->
     Task<T> ICacheService.GetOrSetObjectAsync<T>(
         GroupedField groupedField,
         ObjectId patientId,
@@ -189,6 +218,7 @@ public class FakeCacheService : CacheService, ICacheService
 /// <remarks>
 /// This class inherits from <see cref="NoCacheService"/> and implements the <see cref="ICacheService"/> interface, providing a non-functional cache suitable for unit tests or environments where caching should be bypassed.
 /// </remarks>
+/// <!-- aidoc:v1 sig=801fd16 -->
 public class FakeNoCacheService : NoCacheService, ICacheService
 {
     public bool WasCalled { get; private set; }
@@ -234,6 +264,7 @@ public class CacheDispatcherTest
     /// <summary>
     /// Initializes the test environment by instantiating fake implementations of the Redis, in-memory, and no-op cache services, along with default <see cref="CacheSettings"/>, and constructs a <see cref="CacheDispatcher"/> under test using these dependencies.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=9827af1 -->
     [SetUp]
         public void SetUp()
         {
@@ -358,6 +389,7 @@ public class CacheDispatcherTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Unknown"/> when the provided cache key does not start with any recognized prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=60a34b6 body=6a7aecd -->
     [Test]
         public void Classify_ReturnsUnknown_ForUnrecognizedPrefix()
         {
diff --git a/adas-core.Test/Services/CacheServiceTest.cs b/adas-core.Test/Services/CacheServiceTest.cs
index 3bcf6e50..c17d0d26 100644
--- a/adas-core.Test/Services/CacheServiceTest.cs
+++ b/adas-core.Test/Services/CacheServiceTest.cs
@@ -18,6 +18,7 @@ public class CacheServiceTest
     /// Initializes the test environment by creating a <see cref="LockManagerService"/> with a mock logger
     /// and an in-memory lock provider, and instantiating the <see cref="CacheService"/> under test with that lock manager.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=0002dc3 -->
     [SetUp]
         public void SetUp()
         {
@@ -55,6 +56,7 @@ public class CacheServiceTest
     /// <summary>
     /// Verifies that <c>GetOrSetObjectAsync</c> invokes the supplied factory on the first call, persists the produced value, and on subsequent calls returns the cached value without invoking the factory again.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9730504 body=5d35764 -->
     [Test]
         public async Task GetOrSetObjectAsync_InvokesFactory_StoresResult_AndDoesNotInvokeAgainOnSecondCall()
         {
@@ -89,6 +91,7 @@ public class CacheServiceTest
     /// <summary>
     /// Verifies that <c>GetOrSetObjectAsync</c> does not cache <see langword="null"/> results, ensuring the factory delegate is re-invoked on subsequent calls for the same key when the previously produced value was <see langword="null"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bb0d5c2 body=179c9ee -->
     [Test]
         public async Task GetOrSetObjectAsync_DoesNotCacheNullResult_AndInvokesFactoryOnSubsequentCalls()
         {
@@ -118,6 +121,7 @@ public class CacheServiceTest
     /// the second thread does not invoke its factory if the first thread has already inserted the value,
     /// and both threads receive the value produced by the first thread's factory.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6a067fe body=858fc91 -->
     [Test]
         public async Task GetOrSetObjectAsync_SecondCheckInLock_PreventsFactoryExecution_WhenValueAlreadyInsertedByFirstThread()
         {
@@ -161,6 +165,7 @@ public class CacheServiceTest
     /// <summary>
     /// Verifies that calling <c>DeleteObjectAsync</c> removes the stored value for the given key, and that the next call to <c>GetOrSetObjectAsync</c> invokes the factory delegate to produce a new value instead of returning a previously cached one.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c88be79 body=aaf8770 -->
     [Test]
         public async Task DeleteObjectAsync_RemovesKey_AndFactoryIsInvokedOnNextCall()
         {
@@ -188,6 +193,7 @@ public class CacheServiceTest
     /// <summary>
     /// Verifies that <c>DeleteByPatternAsync</c> removes only the cache entries whose keys match the supplied pattern while preserving unrelated keys that do not match.
     /// </summary>
+    /// <!-- aidoc:v1 sig=395241c body=7523f89 -->
     [Test]
         public async Task DeleteByPatternAsync_RemovesMatchingKeys_AndKeepsNonMatchingKeys()
         {
@@ -214,6 +220,7 @@ public class CacheServiceTest
     /// Verifies that <c>CleanCache</c> removes all entries from the cache, causing subsequent
     /// <c>GetOrSetObjectAsync</c> calls to invoke the provided factory delegate to repopulate the value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3336c2b body=de2514b -->
     [Test]
         public async Task CleanCache_RemovesAllKeys_AndFactoryIsInvokedAfterClean()
         {
diff --git a/adas-core.Test/Services/CameraServiceTest.cs b/adas-core.Test/Services/CameraServiceTest.cs
index dc893eaf..1f3d4206 100644
--- a/adas-core.Test/Services/CameraServiceTest.cs
+++ b/adas-core.Test/Services/CameraServiceTest.cs
@@ -18,6 +18,7 @@ internal class CameraServiceTest
     /// <summary>
     /// NUnit <see cref="SetUpAttribute"/> method executed before each test to initialize shared test state, such as camera configuration dictionaries, mocked camera and logger services, and a mocked subscribers service. Currently all initialization logic is commented out, so the method performs no setup actions.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=4448e1d -->
     [SetUp]
         public void Setup()
         {
@@ -50,6 +51,8 @@ internal class CameraServiceTest
     /// <summary>
     /// Verifies that the <c>MaskStream</c> operation on the camera service returns a valid response when invoked with activation and coordinate parameters against the configured camera settings. Covers the scenario where the underlying grab response is null, ensuring the service still produces a non-null response with the expected status code and content.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The entire method body is commented out, so no verification, assertions, or behavior described in the summary actually executes; the test has been effectively removed." -->
     public void MaskStream_Return_Ok()
         {
             //bool activate = true;
diff --git a/adas-core.Test/Services/ConfigObservationServiceTest.cs b/adas-core.Test/Services/ConfigObservationServiceTest.cs
index ebf78454..d560d288 100644
--- a/adas-core.Test/Services/ConfigObservationServiceTest.cs
+++ b/adas-core.Test/Services/ConfigObservationServiceTest.cs
@@ -83,6 +83,7 @@ public class ConfigObservationServiceTest
     /// Configures a default authenticated <see cref="ClaimsPrincipal"/> in the HTTP context and sets the cache mocks to bypass caching by executing the factory function directly,
     /// ensuring repository calls are invoked during tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=baa71ba -->
     [SetUp]
         public void Setup()
         {
@@ -144,6 +145,8 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that querying a patient observation by <c>CodingSystem</c> only, without specifying a code or name, returns a null result.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the query is performed 'without specifying a code or name', but the test code explicitly sets Code = \"Pump_X\" and Name = \"Alarm_Pump_X\" on the PatientObservation before calling _service.Get(obs)." -->
     [Test]
         public async Task Get_config_observation_item_by_codingSystem_only_return_null()
         {
@@ -163,6 +166,7 @@ public class ConfigObservationServiceTest
     /// Verifies that <c>Get</c> returns the matching patient observation configuration for a given observation identified by its code and coding system.
     /// Asserts that the resolved item is not null and that the displayed name is mapped from the configured lookup to the expected localized value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d32a79d body=97b6327 -->
     [Test]
         public async Task Get_config_observation_item_by_code_and_codingSystem()
         {
@@ -186,6 +190,7 @@ public class ConfigObservationServiceTest
     /// matching the requested observation against the list returned by the repository and returning
     /// the item with the expected name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3d7c0ca body=615f166 -->
     [Test]
         public async Task Get_config_observation_item_by_name()
         {
@@ -201,6 +206,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that the service returns null when a patient observation item is requested by a name that does not exist in the configuration list.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fa14228 body=beae3aa -->
     [Test]
         public async Task Get_config_observation_item_by_name_not_exist_returns_null()
         {
@@ -216,6 +222,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that the service retrieves the correct configuration by matching both the observation code with its coding system and the parent data code with its coding system, returning the configuration named "ph".
     /// </summary>
+    /// <!-- aidoc:v1 sig=2711221 body=baf8942 -->
     [Test]
         public async Task Get_config_by_code_and_parent()
         {
@@ -241,6 +248,7 @@ public class ConfigObservationServiceTest
     /// Verifies that the mapping service returns <c>null</c> when the observation name is unknown
     /// and the configuration is set to ignore unknown observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b604759 body=1c3599d -->
     [Test]
         public async Task Map_unknown_ignore_true_returns_null()
         {
@@ -257,6 +265,7 @@ public class ConfigObservationServiceTest
     /// the <c>Map</c> method returns the original observation as-is when no matching record is found
     /// in the repository, rather than discarding it as an unknown observation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bb05709 body=c204c4b -->
     [Test]
         public async Task Map_unknown_ignore_false_returns_obs()
         {
@@ -273,6 +282,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that mapping a patient observation with a value of 14 results in an "Ok" status, confirming the threshold mapping logic returns the expected outcome.
     /// </summary>
+    /// <!-- aidoc:v1 sig=81e9217 body=d5f8b5a -->
     [Test]
         public async Task Map_threshold_Ok()
         {
@@ -293,6 +303,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Tests that the Map method returns a Warning status when a patient observation value exceeds the configured threshold.
     /// </summary>
+    /// <!-- aidoc:v1 sig=62b87c5 body=8312d29 -->
     [Test]
         public async Task Map_threshold_Warning()
         {
@@ -313,6 +324,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that mapping a <see cref="PatientObservation"/> with a SOFA score of 9 through the configured service results in a result with an <see cref="StatusEnum.Type.Alert"/> status.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b9d47f9 body=ff5f81e -->
     [Test]
         public async Task Map_threshold_Alert()
         {
@@ -334,6 +346,7 @@ public class ConfigObservationServiceTest
     /// Verifies that mapping a parent <see cref="PatientObservation"/> returns an <see cref="StatusEnum.Type.Ok"/> status
     /// when the repository successfully locates the configuration by identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ba42824 body=c7bbf55 -->
     [Test]
         public async Task Map_parent_ok()
         {
@@ -354,6 +367,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that <c>UpdateConfig</c> successfully updates an existing configuration and returns the updated <see cref="ConfigObservation"/> with the new name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=18d4b11 body=f7f80a4 -->
     [Test]
         public async Task UpdateConfig_ok()
         {
@@ -376,6 +390,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that <c>UpdateConfig</c> throws a <see cref="NotFoundException"/> when the target <c>ConfigObservation</c> cannot be found by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=470341f body=33e9665 -->
     [Test]
         public async Task UpdateConfig_notfound()
         {
@@ -392,6 +407,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that the <c>CreateConfig</c> service method successfully inserts the provided configuration and returns the expected result.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4c4fb2f body=19b37b8 -->
     [Test]
         public async Task CreateConfig_ok()
         {
@@ -405,6 +421,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that <see cref="BadRequestException"/> is thrown when attempting to create a configuration that already exists.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ea4710c body=04477ed -->
     [Test]
         public void CreateConfig_duplicate_throws()
         {
@@ -420,6 +437,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that RemoveConfigItem successfully removes a configuration item and returns the deleted entity when the repository finds and deletes it.
     /// </summary>
+    /// <!-- aidoc:v1 sig=30c283f body=7951323 -->
     [Test]
         public async Task RemoveConfigItem_ok()
         {
@@ -436,6 +454,7 @@ public class ConfigObservationServiceTest
     /// <summary>
     /// Verifies that <c>RemoveConfigItem</c> returns <c>null</c> when the underlying delete operation on the repository yields no result, simulating the case where the configuration item does not exist.
     /// </summary>
+    /// <!-- aidoc:v1 sig=87b0794 body=76439aa -->
     [Test]
         public async Task RemoveConfigItem_null()
         {
diff --git a/adas-core.Test/Services/ConfigPumpsServiceTest.cs b/adas-core.Test/Services/ConfigPumpsServiceTest.cs
index 1c2e936b..ddaf3f15 100644
--- a/adas-core.Test/Services/ConfigPumpsServiceTest.cs
+++ b/adas-core.Test/Services/ConfigPumpsServiceTest.cs
@@ -27,6 +27,7 @@ public class ConfigPumpsServiceTest
     /// <summary>
     /// Initializes the test environment by creating mock dependencies and instantiating the <see cref="ConfigPumpsService"/> under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=4e72b76 -->
     [SetUp]
         public void Setup()
         {
@@ -72,6 +73,7 @@ public class ConfigPumpsServiceTest
     /// <summary>
     /// Verifies that the <see cref="ConfigPumpsService.Map"/> method returns the same <see cref="PumpObservation"/> instance unchanged when the <c>ConfigPumpsRequired</c> option is set to <c>false</c>, bypassing any pump configuration lookup or transformation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1d5bff3 body=48fe32c -->
     [Test]
         public async Task Map_configPumpsRequired_false_Return_same_pump()
         {
@@ -100,6 +102,7 @@ public class ConfigPumpsServiceTest
     /// Verifies that when pump configuration is required and the pump has no alarm type,
     /// the <c>Map</c> method returns the same pump instance unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3192070 body=bd61ede -->
     [Test]
         public async Task Map_not_alarmType_Return_same_pump()
         {
@@ -120,6 +123,7 @@ public class ConfigPumpsServiceTest
     /// <summary>
     /// Verifies that the <see cref="ConfigPumpsService.Map"/> method returns the original <see cref="PumpObservation"/> unchanged when the configuration pump item is empty, ensuring that no <c>UiConfiguration</c> is assigned in that case.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8a185e9 body=db91573 -->
     [Test]
         public async Task Map_Not_uiConfiguration_Return_same_pump()
         {
@@ -156,6 +160,7 @@ public class ConfigPumpsServiceTest
     /// alarm type, ensuring the resulting UI configuration contains the expected label
     /// entries such as the "screenAlarmLabel" mapped to the alarm type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=585a146 body=115a9b0 -->
     [Test]
         public async Task Map_uiConfiguration_Return_pump_uiConfiguration()
         {
diff --git a/adas-core.Test/Services/ConfigUnitsServiceTest.cs b/adas-core.Test/Services/ConfigUnitsServiceTest.cs
index a33e03f3..81c6de7b 100644
--- a/adas-core.Test/Services/ConfigUnitsServiceTest.cs
+++ b/adas-core.Test/Services/ConfigUnitsServiceTest.cs
@@ -20,6 +20,7 @@ public class ConfigUnitsServiceTest
     /// <summary>
     /// Initializes the test dependencies and creates a new instance of <see cref="ConfigUnitsService"/> with mocked repository, options, and logger for use in unit tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=f4122ef -->
     [SetUp]
         public void Setup()
         {
@@ -58,6 +59,7 @@ public class ConfigUnitsServiceTest
     /// <summary>
     /// Verifies that when <c>ConfigUnitsRequired</c> is set to <c>false</c>, the <see cref="ConfigUnitsService.Map"/> method returns the same observation instance without applying any unit mapping or transformation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bab3791 body=d6d820f -->
     [Test]
         public async Task Map_configUnitsRequired_false_Return_same_obs()
         {
@@ -84,6 +86,7 @@ public class ConfigUnitsServiceTest
     /// <summary>
     /// Verifies that mapping a patient observation that does not contain units returns the same observation unchanged, confirming the mapping logic preserves the original data when no unit conversion is applicable.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fc6d0dc body=239be85 -->
     [Test]
         public async Task Map_not_units_Return_same_obs()
         {
@@ -105,6 +108,7 @@ public class ConfigUnitsServiceTest
     /// <summary>
     /// Verifies that the Map method returns the original observation unchanged with a null Units property when configuration units are required and no matching config unit is found for the observation's code.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7e98721 body=91ddc62 -->
     [Test]
         public async Task Map_Not_Find_Config_Return_same_obs()
         {
@@ -140,6 +144,7 @@ public class ConfigUnitsServiceTest
     /// Verifies that Map returns the configured unit value for a patient observation when
     /// ConfigUnitsRequired is enabled and a matching config unit is found in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f7a66e6 body=4f13f04 -->
     [Test]
         public async Task Map_configUnits_Return_obs_ConfigUnit()
         {
diff --git a/adas-core.Test/Services/DiagnosisServiceTest.cs b/adas-core.Test/Services/DiagnosisServiceTest.cs
index a8dbc5dc..aa79f101 100644
--- a/adas-core.Test/Services/DiagnosisServiceTest.cs
+++ b/adas-core.Test/Services/DiagnosisServiceTest.cs
@@ -24,6 +24,7 @@ public class DiagnosisServiceTest
     /// <summary>
     /// Initializes the mocked dependencies (patient, diagnosis, unit, audit, subscribers and calculated observations services along with their repositories) and constructs the <see cref="DiagnosisService"/> instance under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=00b1d4d -->
     [SetUp]
         public void Setup()
         {
@@ -148,6 +149,7 @@ public class DiagnosisServiceTest
     /// Verifies that <c>SaveRequest</c> does not insert a diagnosis when the patient referenced by the <see cref="ApiRequest"/> cannot be found.
     /// </summary>
     /// <returns>A task representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=8c3ffda body=ba42756 -->
     [Test]
         public async Task SaveRequest_Not_FindPatient_Return_not_insert()
         {
@@ -172,6 +174,12 @@ public class DiagnosisServiceTest
     /// </summary>
     /// <param name="apiRequest">The API request containing the patient and observation data being evaluated.</param>
     /// <param name="null">Reserved parameter passed to <c>SaveRequest</c> as a null value.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states SaveRequest is invoked when the ApiRequest is 'not considered an observation request', but the test setup explicitly populates ObservationData (Code, CodingSystem, Value, Text, Time)." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The summary claims 'observations must be present to trigger a database insertion', yet the test contains a fully populated ObservationData and still expects InsertOneAsync to never be called." -->
+    /// <!-- aidoc-review:v1 severity=high kind=extra_param
+    ///      "The test method takes no parameters, but the documentation declares <param name='apiRequest'> and <param name='null'>, describing arguments passed to SaveRequest rather than test parameters." -->
     [Test]
         public async Task SaveRequest_Not_Observations_Return_not_insert()
         {
diff --git a/adas-core.Test/Services/DischargeServiceTest.cs b/adas-core.Test/Services/DischargeServiceTest.cs
index ea57c02e..cf877cd3 100644
--- a/adas-core.Test/Services/DischargeServiceTest.cs
+++ b/adas-core.Test/Services/DischargeServiceTest.cs
@@ -16,6 +16,7 @@ namespace adas_core.Test.Services;
 /// <summary>
 /// Provides unit tests for the <see cref="DischargeService"/> class, verifying the behavior and correctness of discharge-related operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=400fd1a -->
 public class DischargeServiceTest
 {
     private readonly Mock<ILocalAuditService> _auditServiceMock = new();
@@ -34,6 +35,7 @@ public class DischargeServiceTest
     /// <summary>
     /// Sets up the test environment by creating a mock authenticated user context and instantiating the <see cref="DischargeService"/> with its required dependencies for use in unit tests.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=c3b979f -->
     [SetUp]
         public void Setup()
         {
@@ -66,6 +68,8 @@ public class DischargeServiceTest
     /// when it exists in the repository.
     /// </summary>
     /// <param name="discharge">The discharge entity expected to be deleted; its identifier is used to invoke the repository delete operation.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The test method takes no parameters, but the documentation includes a <param name=\"discharge\"> tag. The discharge is an argument passed to the production method being tested, not a parameter of the test itself." -->
     [Test]
         public async Task DeleteDischargeAsync_WhenDischargeExists_DeletesDischarge()
         {
@@ -100,6 +104,7 @@ public class DischargeServiceTest
     /// <summary>
     /// Verifies that <see cref="DischargeService.GetDischargeByIdAsync"/> throws a <see cref="NotFoundException"/> when the requested discharge is not found.
     /// </summary>
+    /// <!-- aidoc:v1 sig=52f2a9a body=86f9d19 -->
     [Test]
         public void GetDischargeByIdAsync_WhenExceptionOccurs_ReturnsNullAndLogsError()
         {
@@ -114,6 +119,7 @@ public class DischargeServiceTest
     /// Verifies that the discharge service returns the expected discharges retrieved from the repository when the underlying repository call completes successfully without exceptions.
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=11f6fa6 body=746f877 -->
     [Test]
         public async Task GetDischargesAsync_WhenNoException_ReturnsDischarges()
         {
@@ -150,6 +156,7 @@ public class DischargeServiceTest
     /// Verifies that <see cref="DischargeService.InsertDischarge"/> returns the inserted discharge
     /// when the underlying repository successfully completes the insertion and the entity can be retrieved by its identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f69e0b9 body=aed5a93 -->
     [Test]
         public async Task InsertDischarge_WhenInsertionSuccessful_ReturnsInsertedDischarge()
         {
@@ -169,6 +176,7 @@ public class DischargeServiceTest
     /// <summary>
     /// Verifies that <see cref="DischargeService.InsertDischarge"/> handles repository insertion failures by propagating the exception thrown by the underlying data store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b44150e body=8660eb8 -->
     [Test]
         public void InsertDischarge_WhenInsertionFails_ReturnsNullAndLogsError()
         {
@@ -186,6 +194,7 @@ public class DischargeServiceTest
     /// Verifies that <see cref="DischargeService.GetDischargeByLocation"/> returns the discharge
     /// retrieved from the repository when a discharge exists for the specified patient location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a7b4f8b body=70251df -->
     [Test]
         public async Task GetDischargeByLocation_WhenDischargeExists_ReturnsDischarge()
         {
@@ -204,6 +213,7 @@ public class DischargeServiceTest
     /// <summary>
     /// Verifies that <see cref="IDischargeService.GetDischargeByLocation"/> returns <c>null</c> when the underlying discharge repository throws an exception while retrieving the discharge record for the specified patient location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2531264 body=4379b10 -->
     [Test]
         public async Task GetDischargeByLocation_WhenExceptionOccurs_ReturnsNullAndLogsError()
         {
@@ -236,6 +246,7 @@ public class DischargeServiceTest
     /// <summary>
     /// Verifies that <see cref="DischargeService.GetDischargeByPointOfCareId"/> returns <c>null</c> when the underlying repository throws an exception while attempting to retrieve a discharge by its point-of-care identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3c82b56 body=9141fcb -->
     [Test]
         public async Task GetDischargeByPointOfCareId_WhenExceptionOccurs_ReturnsNullAndLogsError()
         {
diff --git a/adas-core.Test/Services/DisplayServiceTest.cs b/adas-core.Test/Services/DisplayServiceTest.cs
index b8d58c4d..476ca965 100644
--- a/adas-core.Test/Services/DisplayServiceTest.cs
+++ b/adas-core.Test/Services/DisplayServiceTest.cs
@@ -46,6 +46,7 @@ public class DisplayServiceTest
     /// Initializes mocked dependencies and configuration required to construct a <see cref="DisplayService"/> instance for unit tests.
     /// Sets up the HTTP context with a test user claim, creates default cache settings, and wires all collaborators (repositories, services, logger, permissions) into the service under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=d0144e9 -->
     [SetUp]
     public void SetUp()
     {
@@ -93,6 +94,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that <see cref="DisplayService.InsertOne"/> inserts a display by resolving the default configuration for its type and persisting it through the repository's insert method.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8846ed1 body=36d74d2 -->
     [Test]
     public async Task InsertOne_ShouldInsertDisplay()
     {
@@ -121,6 +123,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that the <see cref="DisplayService"/> returns the expected <see cref="Display"/> instance when a matching id is provided through the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a7045b7 body=3124a14 -->
     [Test]
     public async Task GetById_ShouldReturnDisplay()
     {
@@ -140,6 +143,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that _displayService.GetAllByUser returns an empty collection when the user name is null.
     /// </summary>
+    /// <!-- aidoc:v1 sig=67b03d0 body=cceeae1 -->
     [Test]
     public async Task GetAllByUser_ShouldReturnEmpty_WhenUserNameNull()
     {
@@ -238,6 +242,7 @@ public class DisplayServiceTest
     /// from the display repository, ensuring the service correctly resolves configurations and
     /// their linked displays for the given display type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5eccacf body=8683226 -->
     [Test]
     public async Task GetByType_ShouldReturnDisplays()
     {
@@ -261,6 +266,7 @@ public class DisplayServiceTest
     /// Verifies that <see cref="DisplayService.GetByType"/> returns an empty collection when no display configurations are found for the specified display type.
     /// </summary>
     /// <returns>A task that completes when the assertion confirming the empty result has been executed.</returns>
+    /// <!-- aidoc:v1 sig=b325f8a body=dccb49c -->
     [Test]
     public async Task GetByType_ShouldReturnEmpty_WhenNoConfigsFound()
     {
@@ -280,6 +286,8 @@ public class DisplayServiceTest
     /// </summary>
     /// <param name="poc">The point of care used to look up associated displays.</param>
     /// <returns>A task representing the asynchronous test execution.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The <param name=\"poc\"> tag documents a parameter that does not exist on the test method (which takes no arguments)." -->
     [Test]
     public async Task GetByPointOfCare_ShouldReturnDisplays()
     {
@@ -301,6 +309,7 @@ public class DisplayServiceTest
     /// Verifies that <see cref="DisplayService.GetByConfigId"/> returns the displays associated with the specified configuration ID retrieved from the repository.
     /// </summary>
     /// <returns>A task that completes when the assertion confirms the returned collection contains the expected number of displays.</returns>
+    /// <!-- aidoc:v1 sig=0344410 body=2a414ec -->
     [Test]
     public async Task GetByConfigId_ShouldReturnDisplays()
     {
@@ -321,6 +330,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that the <see cref="DisplayService.GetByName"/> method throws a <see cref="NotFoundException"/> when no display matching the specified name is found in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9366b2d body=7fc914f -->
     [Test]
     public void GetByName_ShouldThrow_WhenNotFound()
     {
@@ -337,6 +347,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that <c>GetInfo</c> returns a <see cref="Display"/> with its associated <c>PointOfCare</c> entries populated when invoked with the "with POC" flag enabled and a valid display identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0097b05 body=1dea72f -->
     [Test]
     public async Task GetInfo_ShouldReturnDisplayWithPoc()
     {
@@ -381,6 +392,7 @@ public class DisplayServiceTest
     /// <summary>
     /// Verifies that <see cref="IDisplayService.GetByUnitId"/> returns the displays associated with the specified unit identifier when the repository contains matching records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2c9de1f body=4dae710 -->
     [Test]
     public async Task GetByUnitId_ShouldReturnDisplays()
     {
@@ -402,6 +414,7 @@ public class DisplayServiceTest
     /// Verifies that UpdatePointOfCareList throws a <see cref="NotFoundException"/> when the display with the specified identifier does not exist.
     /// </summary>
     /// <exception cref="NotFoundException">Thrown when no display is found for the given id.</exception>
+    /// <!-- aidoc:v1 sig=fe05ec6 body=46f08a3 -->
     [Test]
     public void UpdatePointOfCareList_ShouldThrow_WhenDisplayNotFound()
     {
@@ -422,6 +435,8 @@ public class DisplayServiceTest
     /// </summary>
     /// <param name="id">The unique identifier of the display whose configuration preset is being updated.</param>
     /// <param name="cfgId">The unique identifier of the configuration preset to associate with the display.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The method has no parameters; 'id' and 'cfgId' are local variables, not method parameters, so the <param> tags document non-existent parameters." -->
     [Test]
     public void UpdateConfigPreset_ShouldThrow_WhenUpdateFails()
     {
diff --git a/adas-core.Test/Services/GroupedObservationServiceTest.cs b/adas-core.Test/Services/GroupedObservationServiceTest.cs
index 0f023fdf..e5119f97 100644
--- a/adas-core.Test/Services/GroupedObservationServiceTest.cs
+++ b/adas-core.Test/Services/GroupedObservationServiceTest.cs
@@ -24,6 +24,7 @@ public class GroupedObservationServiceTest
     /// (configuration observation service, observation repository, logger, and cache service)
     /// and instantiating the <see cref="GroupedObservationService"/> under test with default API and cache settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=681afdf -->
     [SetUp]
         public void Setup()
         {
@@ -46,6 +47,7 @@ public class GroupedObservationServiceTest
     /// verifying the distribution of observations across shifts for the current day, the previous day, and two days prior when the
     /// Result.Last aggregation is applied with a maximum count of 36.
     /// </summary>
+    /// <!-- aidoc:v1 sig=49572e1 body=ce7d966 -->
     [Test]
         public void Generate_Shift_Observations()
         {
@@ -101,6 +103,7 @@ public class GroupedObservationServiceTest
     /// the current day, the previous day, and two days prior, ensuring that data is aggregated into the
     /// correct shift and day buckets.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d4b4f96 body=5a17087 -->
     [Test]
         public void Calculate_Shift_Observations()
         {
@@ -248,6 +251,7 @@ public class GroupedObservationServiceTest
     /// so that the returned sequence contains a complete set of five consecutive hourly observations
     /// (covering the last five hours relative to the current time) for a group with hourly regularity and a maximum of five entries.
     /// </summary>
+    /// <!-- aidoc:v1 sig=667f3ff body=a77fd75 -->
     [Test]
         public async Task Calculate_Last_Filled_Observations_should_add_Minus_4_hour_to_complete_last_five_hours()
         {
@@ -303,6 +307,7 @@ public class GroupedObservationServiceTest
     /// adding the <c>-1 hour</c> observation when it is not present in the provided list so that the returned
     /// collection always contains a complete five-hour window of last filled observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f2c5b12 body=9dbcc21 -->
     [Test]
         public async Task Calculate_Last_Filled_Observations_should_add_Minus_1_hour_to_complete_last_five_hours()
         {
@@ -356,6 +361,7 @@ public class GroupedObservationServiceTest
     /// <summary>
     /// Verifies that the service correctly fills hourly observations from half-hour observation data, grouping timestamped values by hour and forwarding missing slots up to the configured maximum (5) per hour.
     /// </summary>
+    /// <!-- aidoc:v1 sig=381b258 body=ed397dd -->
     [Test]
         public void FillHoursObservations()
         {
@@ -486,6 +492,7 @@ public class GroupedObservationServiceTest
     /// <param name="resultType">The result type that determines how the value is stored; aggregate types (HalfHour, Sum, Count, Min, Average, Max) are stored directly, while others are wrapped in a sub-document with time and stringified value.</param>
     /// <param name="all">Optional BsonArray of additional entries; when provided, it is appended to the result under the "all" key.</param>
     /// <returns>A BsonDocument containing the _id composite key, a time field, the result-type-specific payload, and optionally the "all" array.</returns>
+    /// <!-- aidoc:v1 sig=e94c5ea body=f4284ca -->
     private static BsonDocument GenerateBsonDocument(int? year, int? month, int? day, int? hour, int? minute,
             string name, object value, Result resultType, BsonArray? all)
         {
diff --git a/adas-core.Test/Services/HistoricalConfigChangesServiceTest.cs b/adas-core.Test/Services/HistoricalConfigChangesServiceTest.cs
index 0cbb4b83..2c643822 100644
--- a/adas-core.Test/Services/HistoricalConfigChangesServiceTest.cs
+++ b/adas-core.Test/Services/HistoricalConfigChangesServiceTest.cs
@@ -23,6 +23,7 @@ internal class HistoricalConfigChangesServiceTest
     /// <summary>
     /// Initializes the mock repository, mock logger, and the <see cref="HistoricalConfigChangesService"/> instance under test prior to each unit test execution.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=f227270 -->
     [SetUp]
         public void Setup()
         {
@@ -44,6 +45,8 @@ internal class HistoricalConfigChangesServiceTest
     /// </summary>
     /// <param name="configType">The type of configuration whose last historical changes are being retrieved.</param>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_param
+    ///      "The test method has no parameters, but the documentation includes a <param> tag for 'configType', which is actually a local variable, not a method parameter." -->
     [Test]
         public async Task FindLastConfigChanges_ReturnsLastConfigChange()
         {
@@ -66,6 +69,7 @@ internal class HistoricalConfigChangesServiceTest
     /// <summary>
     /// Verifies that the service returns <c>null</c> when the underlying repository throws an exception while inserting a <see cref="HistoricalConfigChanges"/> entity.
     /// </summary>
+    /// <!-- aidoc:v1 sig=095d7c4 body=2da7496 -->
     [Test]
         public async Task InsertOne_WhenExceptionOccurs_ReturnsNull()
         {
@@ -84,6 +88,7 @@ internal class HistoricalConfigChangesServiceTest
     /// <summary>
     /// Verifies that the service's <c>GetAll</c> method returns all historical configuration changes retrieved from the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=31f3dbb body=26fefb6 -->
     [Test]
         public async Task GetAll_ReturnsAllConfigChanges()
         {
@@ -105,6 +110,7 @@ internal class HistoricalConfigChangesServiceTest
     /// <summary>
     /// Verifies that the service's <c>GetByType</c> method returns the expected number of historical configuration changes for the specified configuration type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7b6a024 body=7e4b7fe -->
     [Test]
         public async Task GetByType_ReturnsCorrectAmountOfConfigs()
         {
@@ -129,6 +135,7 @@ internal class HistoricalConfigChangesServiceTest
     /// Verifies that the service returns the expected number of historical configuration changes for a given user,
     /// confirming the repository result is correctly forwarded to the caller.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bbf6fad body=0c5f8a6 -->
     [Test]
         public async Task GetByUser_ReturnsCorrectConfigs()
         {
@@ -151,6 +158,7 @@ internal class HistoricalConfigChangesServiceTest
     /// <summary>
     /// Verifies that the service returns null when an exception is thrown while updating a historical configuration change, ensuring graceful error handling.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f467039 body=fce2a66 -->
     [Test]
         public async Task UpdateHistoricalConfigChange_WhenExceptionOccurs_ReturnsNull()
         {
diff --git a/adas-core.Test/Services/InMemoryLockProviderTest.cs b/adas-core.Test/Services/InMemoryLockProviderTest.cs
index 67da4572..158fa21a 100644
--- a/adas-core.Test/Services/InMemoryLockProviderTest.cs
+++ b/adas-core.Test/Services/InMemoryLockProviderTest.cs
@@ -18,6 +18,7 @@ public class InMemoryLockProviderTest
     /// <summary>
     /// Initializes a fresh <see cref="InMemoryLockProvider"/> instance for the test fixture, ensuring each test starts with a clean, isolated provider state.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=68e18d0 -->
     [SetUp]
         public void SetUp()
         {
@@ -28,6 +29,7 @@ public class InMemoryLockProviderTest
     /// Retrieves the private <c>_locks</c> dictionary from the associated <see cref="InMemoryLockProvider"/> instance using reflection, exposing the underlying locks for inspection or manipulation in tests.
     /// </summary>
     /// <returns>The <see cref="ConcurrentDictionary{TKey, TValue}"/> mapping lock keys to their <see cref="SemaphoreSlim"/> instances held by the provider.</returns>
+    /// <!-- aidoc:v1 sig=4b79234 body=b646f1a -->
     private ConcurrentDictionary<string, SemaphoreSlim> GetLocks()
         {
             var field = typeof(InMemoryLockProvider)
@@ -39,6 +41,7 @@ public class InMemoryLockProviderTest
     /// <summary>
     /// Verifies that AcquireAsync returns <c>true</c> and creates a corresponding entry in the locks dictionary when called with a valid key and time span.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a1004f7 body=bd67473 -->
     [Test]
         public async Task AcquireAsync_ReturnsTrue_AndCreatesEntryInLocksDictionary()
         {
@@ -55,6 +58,7 @@ public class InMemoryLockProviderTest
     /// <summary>
     /// Verifies that AcquireAsync returns false when the semaphore for the specified key is already occupied and the requested timeout expires before the lock can be acquired, and that the underlying semaphore is restored to a count of 1 after release.
     /// </summary>
+    /// <!-- aidoc:v1 sig=095560b body=d74126f -->
     [Test]
         public async Task AcquireAsync_ReturnsFalse_WhenSemaphoreOccupiedAndTimeoutExpires()
         {
@@ -77,6 +81,7 @@ public class InMemoryLockProviderTest
     /// allowing a subsequent <c>AcquireAsync</c> for the same key to succeed and the semaphore's
     /// <c>CurrentCount</c> to transition back to its released value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f6c51b5 body=9922475 -->
     [Test]
         public async Task ReleaseAsync_MakesSemaphoreAvailableForNextAcquire()
         {
@@ -100,6 +105,7 @@ public class InMemoryLockProviderTest
     /// <summary>
     /// Verifies that <c>ReleaseAsync</c> does not throw when invoked without a prior <c>AcquireAsync</c> for the given key, and remains safe to call multiple times after a single successful acquire.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6c5ff9c body=919f96b -->
     [Test]
         public async Task ReleaseAsync_DoesNotThrow_WhenCalledWithoutPriorAcquire()
         {
@@ -115,6 +121,7 @@ public class InMemoryLockProviderTest
     /// <summary>
     /// Verifies that <c>AcquireAsync</c> is thread-safe for a given key, ensuring that only one caller can hold the semaphore at a time even when multiple tasks compete concurrently for the same key, and that a single semaphore instance is created and reused per key.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d53d431 body=e5e915a -->
     [Test]
         public async Task AcquireAsync_IsThreadSafe_OnlyOneHolderAtATime_SingleSemaphorePerKey()
         {
diff --git a/adas-core.Test/Services/LightBeaconServiceTest.cs b/adas-core.Test/Services/LightBeaconServiceTest.cs
index 59551f22..210fd784 100644
--- a/adas-core.Test/Services/LightBeaconServiceTest.cs
+++ b/adas-core.Test/Services/LightBeaconServiceTest.cs
@@ -27,6 +27,7 @@ public class LightBeaconServiceTest
     /// and instantiating the <see cref="LightBeaconService"/> under test with those mocks.
     /// This setup runs before each test to ensure a clean, isolated test environment.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=18cf5be -->
     [SetUp]
         public void Setup()
         {
@@ -66,6 +67,7 @@ public class LightBeaconServiceTest
     /// <summary>
     /// Integration test that verifies the light beacon service returns <see cref="LightBeaconColor.Off"/> for a given point of care when the patient has no associated beacon color.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fa06230 body=9e0a869 -->
     [Ignore("Integration test")]
         [Test]
         public async Task GetBeaconColor()
diff --git a/adas-core.Test/Services/MasterListServiceTest.cs b/adas-core.Test/Services/MasterListServiceTest.cs
index eb70cf2e..afc9b091 100644
--- a/adas-core.Test/Services/MasterListServiceTest.cs
+++ b/adas-core.Test/Services/MasterListServiceTest.cs
@@ -25,6 +25,7 @@ public class MasterListServiceTest
     /// for use in unit tests. Configures the HTTP context with a test user principal, registers the master list repository
     /// in the service provider, and supplies default API settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=b470369 -->
     [SetUp]
     public void Setup()
     {
@@ -95,6 +96,7 @@ public class MasterListServiceTest
     /// <summary>
     /// Verifies that <c>DeleteMasterListById</c> invokes the repository's <c>Delete</c> method once with the provided identifier when the master list is found.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ea99ebf body=df3195e -->
     [Test]
     public async Task DeleteMasterListById_ShouldCallRepositoryDelete_WhenMasterListFound()
     {
@@ -132,6 +134,7 @@ public class MasterListServiceTest
     /// <summary>
     /// Verifies that the service returns the master list when it is found by the specified id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ccec55b body=8cfdb62 -->
     [Test]
     public async Task GetMasterListById_ShouldReturnMasterList_WhenFound()
     {
@@ -151,6 +154,7 @@ public class MasterListServiceTest
     /// <summary>
     /// Verifies that <c>GetMasterListByName</c> returns the matching <see cref="MasterList"/> when a master list with the specified name is found in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e75f465 body=49f48d4 -->
     [Test]
     public async Task GetMasterListByName_ShouldReturnMasterList_WhenFound()
     {
@@ -170,6 +174,7 @@ public class MasterListServiceTest
     /// <summary>
     /// Verifies that the InsertMasterList service method returns the same <see cref="MasterList"/> instance that was inserted, ensuring the service correctly retrieves the inserted entity by its identifier after persistence.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d6a0851 body=1cc5b44 -->
     [Test]
     public async Task InsertMasterList_ShouldReturnInsertedMasterList()
     {
@@ -191,6 +196,7 @@ public class MasterListServiceTest
     /// Verifies that UpdateMasterList returns the updated master list when the repository successfully completes the update and finds the entity by id.
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=870cac2 body=e6d0735 -->
     [Test]
     public async Task UpdateMasterList_ShouldReturnUpdatedMasterList()
     {
diff --git a/adas-core.Test/Services/MedicineServiceTest.cs b/adas-core.Test/Services/MedicineServiceTest.cs
index b68a7918..683c2460 100644
--- a/adas-core.Test/Services/MedicineServiceTest.cs
+++ b/adas-core.Test/Services/MedicineServiceTest.cs
@@ -68,6 +68,8 @@ public class MedicineServiceTest
     /// </summary>
     /// <exception cref="ArgumentNullException">Thrown when the local <see cref="List{PatientTreatment}"/> collection is null.</exception>
     /// <!-- aidoc:v1 sig=6587029 body=89ace4d -->
+    /// <!-- aidoc-review:v1 severity=medium kind=extra_exception
+    ///      "ArgumentNullException is unreachable: patientTreatment is initialized to an empty list (List<PatientTreatment> patientTreatment = []) immediately before the null check, so the throw can never execute in practice." -->
     [Test]
     public async Task GetMedicinesOfTreatments_Null_Medicine_Return_0()
     {
diff --git a/adas-core.Test/Services/NoCacheServiceTest.cs b/adas-core.Test/Services/NoCacheServiceTest.cs
index e05c56c7..1fb2fc51 100644
--- a/adas-core.Test/Services/NoCacheServiceTest.cs
+++ b/adas-core.Test/Services/NoCacheServiceTest.cs
@@ -15,6 +15,7 @@ public class NoCacheServiceTest
     /// Initializes a fresh <see cref="NoCacheService"/> instance and assigns it to <c>_noCacheService</c>
     /// to provide a clean, dependency-free test fixture prior to executing each test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=f419747 -->
     [SetUp]
         public void SetUp()
         {
@@ -87,6 +88,7 @@ public class NoCacheServiceTest
     /// <summary>
     /// Verifies that the no-cache service implementation never persists data to any backend when <c>GetOrSetObjectAsync</c> is invoked, and confirms that a subsequent <c>DeleteObjectAsync</c> on the same key does not throw.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9b41a17 body=279c122 -->
     [Test]
         public async Task GetOrSetObjectAsync_DoesNotStoreData_InAnyBackend()
         {
@@ -114,6 +116,7 @@ public class NoCacheServiceTest
     /// <summary>
     /// Verifies that the no-cache service's <c>DeleteByPatternAsync</c> returns 0 and does not throw when invoked with arbitrary patterns, confirming the no-op delete behavior for any key pattern.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8ac365 body=97d47fa -->
     [Test]
         public async Task DeleteByPatternAsync_ReturnsZero_DoesNotThrow()
         {
@@ -134,6 +137,7 @@ public class NoCacheServiceTest
     /// Verifies that calling CleanCache on the no-cache service is a safe no-op that does not throw,
     /// and that subsequent calls to GetValue consistently return <c>null</c> for any key.
     /// </summary>
+    /// <!-- aidoc:v1 sig=732eb50 body=c99cdf2 -->
     [Test]
         public void CleanCache_IsNoOp_DoesNotThrow()
         {
@@ -149,6 +153,7 @@ public class NoCacheServiceTest
     /// <summary>
     /// Verifies that calling <c>SetValue</c> on the no-cache service is a no-op and does not throw any exception.
     /// </summary>
+    /// <!-- aidoc:v1 sig=93ab163 body=4352e8e -->
     [Test]
         public void SetValue_IsNoOp_DoesNotThrow()
         {
@@ -163,6 +168,7 @@ public class NoCacheServiceTest
     /// Verifies that the no-cache service's GetValue method returns null for any key,
     /// confirming that the no-op implementation does not return or simulate cached values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=11d9010 body=0d07264 -->
     [Test]
         public void GetValue_IsNoOp_ReturnsNull()
         {
diff --git a/adas-core.Test/Services/ObservationServiceTest.cs b/adas-core.Test/Services/ObservationServiceTest.cs
index cfdb6590..a3480064 100644
--- a/adas-core.Test/Services/ObservationServiceTest.cs
+++ b/adas-core.Test/Services/ObservationServiceTest.cs
@@ -31,6 +31,7 @@ public class ObservationServiceTest
     /// and pre-configuring common lookup behavior for the default "UCI5C" unit (including <c>FindByName</c>
     /// and <c>FindById</c>) along with the <c>ICalculatedObservationsService.Map</c> passthrough.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=fc042ee -->
     [SetUp]
         public void Setup()
         {
@@ -668,6 +669,7 @@ public class ObservationServiceTest
     /// <summary>
     /// Verifies that when an isolation observation is processed through SaveRequest, the configuration observation and units mapping services are invoked, and the resulting mapped observation is inserted into the observation repository with the expected value, patient identifier, name, time, message time, and coding system.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7f3122b body=1cb0aef -->
     [Test]
         public async Task ProcessIsolationObservation_Return_IsolationObs()
         {
@@ -755,6 +757,7 @@ public class ObservationServiceTest
     /// <summary>
     /// Verifies that processing a position observation through the observation service persists a new <see cref="PatientObservation"/> with the expected values (Value, PatientId, Name, Time, MessageTime, and CodingSystem) when a valid API request is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e65e6d9 body=fde3bdd -->
     [Test]
         public async Task ProcessPositionObservation_Return_PositionObs()
         {
diff --git a/adas-core.Test/Services/PatientServiceTest.cs b/adas-core.Test/Services/PatientServiceTest.cs
index b56d8616..2f2c696b 100644
--- a/adas-core.Test/Services/PatientServiceTest.cs
+++ b/adas-core.Test/Services/PatientServiceTest.cs
@@ -30,6 +30,7 @@ internal class PatientServiceTest
     /// dependencies and pre-configuring common lookup scenarios for units and points of care, including virtual
     /// point of care states (Pushed, Moved, Deleted, Cancelled, Recovered, Unknown) used across test cases.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=ff2a3d0 -->
     [SetUp]
         public void Setup()
         {
@@ -320,6 +321,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that the patient service correctly retrieves a patient from the database by matching the patient number supplied in the API request, returning a patient populated with the expected unit, point of care, and patient number values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ef29ee9 body=8931a6e -->
     [Test]
         public async Task Find_Patient_By_APIRequest_Get_Patient_By_PatientNumber()
         {
@@ -371,6 +373,7 @@ internal class PatientServiceTest
     /// Verifies that <see cref="PatientService.FindPatientByApiRequest"/> creates a new patient record
     /// when the requested patient does not exist and the <c>CreatePatientWithOru</c> option is set to <c>true</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=06e0a26 body=2d5f690 -->
     [Test]
         public async Task Find_Patient_By_APIRequest_Not_Exists_CreatePatientWithORU_True_Created_Patient()
         {
@@ -445,6 +448,7 @@ internal class PatientServiceTest
     /// while the target location is already occupied by another patient, and the <c>CreatePatientWithOru</c>
     /// option is enabled, the service creates a new patient in a temporal bed instead of reusing the occupied location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a57196b body=beeb5bf -->
     [Test]
         public async Task
             Find_Patient_By_APIRequest_Not_Exists_And_Location_Ocuped_CreatePatientWithORU_True_Created_In_Temporal_Bed()
@@ -530,6 +534,7 @@ internal class PatientServiceTest
     /// the <see cref="Patient"/> is not created in the temporal bed because <c>CreatePatientWithOru</c> is set to <c>false</c>.
     /// Ensures that <c>FindPatientByApiRequest</c> returns <c>null</c> and that the repository's <c>InsertOneAsync</c> is never invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e6921b4 body=35ecb59 -->
     [Test]
         public async Task Find_Patient_By_APIRequest_Not_Exists_CreatePatientWithORU_False_Not_Created_In_Temporal_Bed()
         {
@@ -596,6 +601,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when a patient is found by API request and the patient already exists in a different location in the database, the patient's location is not changed by the lookup operation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d023325 body=4efbf14 -->
     [Test]
         public async Task Find_Patient_By_APIRequest_Exists_In_Different_Location_NOT_Changes_Patient_Location()
         {
@@ -648,6 +654,7 @@ internal class PatientServiceTest
     /// Verifies that an ADT_A01 request correctly inserts a new patient into the specified unit and bed location
     /// by ensuring the patient repository is updated with the matching unit, bed, and patient number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=54b6ee5 body=52efd9d -->
     [Test]
         public async Task ADT_A01_New_Patient_Empty_Bed_Insert_In_Location()
         {
@@ -679,6 +686,7 @@ internal class PatientServiceTest
     /// Verifies that when an ADT_A01 request for a new patient is processed with an unknown location
     /// (i.e., the location mapping resolves to null), the patient is not inserted into the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a7816da body=592765f -->
     [Test]
         public async Task ADT_A01_New_Patient_Unknown_Location_Insert_Nothing()
         {
@@ -708,6 +716,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A01 admission request is received for a new patient targeting a bed that is already in use by an existing patient, the existing patient is moved to the temporal (pushed) bed while the new patient is admitted to the original bed.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f6f4884 body=f0a1e9f -->
     [Test]
         public async Task ADT_A01_New_Patient_Bed_In_Use_Moves_Existing_Patient_To_Temporal_Bed()
         {
@@ -839,6 +848,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A01 (Admit) message is received for a patient whose bed is already in use and whose patient number matches an existing patient, the patient's demographic data is updated while preserving the bed assignment and existing identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=207b25e body=bc34164 -->
     [Test]
         public async Task ADT_A01_New_Patient_Bed_In_Use_With_Same_Patient_Number_Updates_Demographic_Data()
         {
@@ -910,6 +920,10 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A05 message for a new patient in a new bed (PatientLocation) results in the patient being updated with the correct unit, point of care, and patient number, and that the point-of-care mapping service is invoked to create the location.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The documentation says 'ADT_A05 message' but the code sets apiRequest.Type = 'ADT_A01', so the test processes an ADT_A01 message, not ADT_A05." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The documentation claims the test verifies 'that the point-of-care mapping service is invoked to create the location', but there is no Verify call for _poCMappingServiceMock; only a Setup stub is configured, and only the patient repository's Update is verified." -->
     [Test]
         public async Task ADT_A05_New_Patient_New_Bed_Creates_Location()
         {
@@ -944,6 +958,7 @@ internal class PatientServiceTest
     /// the existing patient in that bed is moved to a temporal PointOfCare, while the new patient
     /// is assigned to the original PointOfCare location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fbe1c2f body=f3b3776 -->
     [Test]
         public async Task ADT_A05_New_Patient_Bed_In_Use_Moves_Existing_Patient_To_Temporal_Bed()
         {
@@ -1001,6 +1016,7 @@ internal class PatientServiceTest
     /// Verifies that when an ADT_A03 (End Visit) message is processed for a patient that does not exist,
     /// the patient repository's Update operation is never invoked, ensuring the system takes no action.
     /// </summary>
+    /// <!-- aidoc:v1 sig=569f0a9 body=4815209 -->
     [Test]
         public async Task ADT_A03_END_VISIT_PATIENT_NOT_EXISTS_DO_NOTHING()
         {
@@ -1032,6 +1048,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A03 (End Visit) request is processed for a patient that already exists in the database, the patient record is updated with the deleted Point of Care, the unit identifier is preserved, and the next admission check is triggered for the original Point of Care.
     /// </summary>
+    /// <!-- aidoc:v1 sig=df708cd body=1a6d3f8 -->
     [Test]
         public async Task ADT_A03_END_VISIT_PATIENT_EXISTS()
         {
@@ -1177,6 +1194,7 @@ internal class PatientServiceTest
     /// service to resolve the destination location, ensuring the save operation results in a single
     /// insert for the new patient.
     /// </summary>
+    /// <!-- aidoc:v1 sig=6bb7428 body=852c38d -->
     [Test]
         public async Task ADT_A02_TRANSFER_PATIENT_FROM_NOT_EXISTS_BED_TO_BED_SHOULD_CREATE_PATIENT()
         {
@@ -1223,6 +1241,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Tests the ADT_A02 transfer scenario where a patient is transferred from their current bed to a bed that is already occupied by another patient, verifying that the existing patient is moved to a new location, the transferring patient occupies the destination bed, and related discharge and next-admission checks are invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=445abff body=64dbe17 -->
     [Test]
         public async Task ADT_A02_TRANSFER_PATIENT_FROM_BED_TO_IN_USE_BED()
         {
@@ -1298,6 +1317,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A02 transfer message is processed for a patient moving from a location with no existing patient to a bed that is already occupied, the previously assigned patient is moved to a temporal bed and the new patient is inserted into the vacated bed.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4d1f5ba body=60f333b -->
     [Test]
         public async Task
             ADT_A02_TRANSFER_PATIENT_FROM_NOT_EXISTS_TO_NOT_EMPTY_BED_SHOULD_CHANGE_LAST_PATIENT_TO_TEMPORTAL_BED()
@@ -1354,6 +1374,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A02 transfer request for a patient whose patient number already exists in the destination bed updates the existing patient's demographic data instead of creating a new patient record.
     /// </summary>
+    /// <!-- aidoc:v1 sig=33bdcd5 body=a2f7027 -->
     [Test]
         public async Task
             ADT_A02_TRANSFER_PATIENT_FROM_NOT_EXISTS_BED_TO_NOT_EMPTY_BED_WITH_SAME_PATIENT_NUMBER_SHOULD_UPTADE_DEMOGRAPHIC_DATA()
@@ -1411,6 +1432,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A04 message for a new patient successfully creates and persists a patient record with the expected unit, point of care, and patient number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5feb5e2 body=5c4855e -->
     [Test]
         public async Task ADT_A04_New_Patient_Creates_Patient()
         {
@@ -1443,6 +1465,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when processing an ADT_A04 request for a new patient with a location whose POC mapping returns null, the patient is not persisted to the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ff36bdc body=a4fb145 -->
     [Test]
         public async Task ADT_A04_New_Patient_Not_Location_Creates_Patient()
         {
@@ -1473,6 +1496,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A08 request is received for a non-existent patient and the <c>CreatePatientWithAdtA08</c> option is enabled, the <see cref="PatientService"/> correctly creates the patient by calling the patient repository's <c>Update</c> method with the expected <c>UnitId</c>, <c>PointOfCareId</c>, and <c>PatientNumber</c> values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0011533 body=5222130 -->
     [Test]
         public async Task ADT_A08_No_exist_CreatePatientWithADT_A08_True_Patient_Creates_Patient()
         {
@@ -1541,6 +1565,7 @@ internal class PatientServiceTest
     /// Verifies that when an ADT_A08 message is processed for a patient that does not exist and the
     /// <c>CreatePatientWithAdtA08</c> option is disabled, the patient is not inserted into the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4787677 body=e1846b5 -->
     [Test]
         public async Task ADT_A08_No_exist_Patient_Not_Creates_Patient()
         {
@@ -1608,6 +1633,7 @@ internal class PatientServiceTest
     /// and patient creation on ADT_A08 is disabled, the patient is updated rather than created.
     /// </summary>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=f8df471 body=e1407e8 -->
     [Test]
         public async Task ADT_A08_Exist_Patient_Update_Patient()
         {
@@ -1681,6 +1707,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A11 (cancel admit/visit notification) message for an existing patient updates the patient's location to the cancelled point of care, leaving unit, patient number, and identity fields unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d05b038 body=5bf7535 -->
     [Test]
         public async Task ADT_A11_Exist_Patient_CANCELLED_Patient()
         {
@@ -1757,6 +1784,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A11 (cancel admit/visit notification) request is processed for a non-existent patient, the patient repository's <c>UpdateOneAsync</c> method is never invoked, since there is no existing patient record to update.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cc97dcc body=7db5096 -->
     [Test]
         public async Task ADT_A11_No_Exist_Patient_Not_CANCELLED_Patient()
         {
@@ -1819,6 +1847,7 @@ internal class PatientServiceTest
     /// Verifies that processing an ADT_A12 transfer message for a non-existing patient to an empty bed
     /// results in the patient being created and assigned to the target bed via the point-of-care mapping.
     /// </summary>
+    /// <!-- aidoc:v1 sig=eb39efa body=6eec376 -->
     [Test]
         public async Task ADT_A12_TRANSFER_PATIENT_NOT_EXISTS_TO_EMPTY_BED_SHOULD_CREATE_BED()
         {
@@ -1852,6 +1881,7 @@ internal class PatientServiceTest
     /// creates the bed (represented by a new point of care) and persists the patient's transfer to that
     /// new location under the configured unit.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7d75980 body=1a080c9 -->
     [Test]
         public async Task ADT_A12_TRANSFER_PATIENT_FROM_BED_TO_NOT_EXISTS_BED_SHOULD_CREATE_BED()
         {
@@ -1893,6 +1923,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A12 transfer request is processed, the new patient occupying the target bed has their data updated while the displaced patient is relocated to a different point of care, and that the legacy <c>Update</c> method is not invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=788fe08 body=89347c8 -->
     [Test]
         public async Task ADT_A12_TRANSFER_PATIENT_FROM_BED_TO_IN_USE_BED()
         {
@@ -1967,6 +1998,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A12 transfer is processed for a patient moving to a bed that is already occupied, the existing patient in that bed is moved to a temporary bed (different Point of Care), and the transferred patient is inserted into the target bed.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b3f2ed3 body=a43a5e5 -->
     [Test]
         public async Task
             ADT_A12_TRANSFER_PATIENT_NOT_EXISTS_TO_NOT_EMPTY_BED_SHOULD_CHANGE_LAST_PATIENT_TO_TEMPORTAL_BED()
@@ -2021,6 +2053,8 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A13 transfer request is processed for a patient moving to a bed that is already occupied, the previously assigned patient in that bed is moved to a temporal bed while the transferring patient is persisted in the requested location.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the previously assigned patient is moved to a temporal bed, but the test only verifies that the transferring patient is updated at the target location; no assertion or mock verifies the prior occupant's relocation to a temporal bed." -->
     [Test]
         public async Task
             ADT_A13_TRANSFER_PATIENT_NOT_EXISTS_TO_NOT_EMPTY_BED_SHOULD_CHANGE_LAST_PATIENT_TO_TEMPORTAL_BED()
@@ -2063,6 +2097,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A13 transfer request for a patient assigned to a deleted point of care moves the patient to the recovered (temporal) bed location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d80f16e body=ea343c5 -->
     [Test]
         public async Task ADT_A13_TRANSFER_PATIENT_NOT_EXISTS_TO_EMPTY_BED_SHOULD_CHANGE_LAST_PATIENT_TO_TEMPORTAL_BED()
         {
@@ -2112,6 +2147,7 @@ internal class PatientServiceTest
     /// Verifies that processing an ADT_A31 (Update Patient) HL7 request correctly updates the existing patient's demographic
     /// information (last name and birth date) while preserving the assigned unit and point of care identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d30f8e5 body=1a5e43f -->
     [Test]
         public async Task ADT_A31_Upadate_Patient()
         {
@@ -2159,6 +2195,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A31 update request is processed for a patient that does not exist, the patient is not updated. Ensures the repository's Update method is never invoked in the not-found scenario.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c01058d body=e9b1919 -->
     [Test]
         public async Task ADT_A31_Upadate_Patient_Not_Found_Not_Update()
         {
@@ -2191,6 +2228,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ADT_A39 merge patient request is processed, the old patient record is deleted after the new patient is resolved through the point-of-care mapping and patient repository lookups.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b442eb3 body=32ea4bf -->
     [Test]
         public async Task ADT_A39_Merge_Patient()
         {
@@ -2246,6 +2284,7 @@ internal class PatientServiceTest
     /// Verifies that when an <c>ADT_A39</c> request is processed and the patient is not an old patient (i.e., not a merge case),
     /// the <see cref="PatientService.SaveRequest"/> does not delete the existing patient from the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0442333 body=8b45017 -->
     [Test]
         public async Task ADT_A39_Not_OldPatient_Not_Merge_Patient()
         {
@@ -2285,6 +2324,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A39 (merge patient) request does not result in the deletion of the old patient record, even when the old patient is located by number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=85734e7 body=fdeab08 -->
     [Test]
         public async Task ADT_A39_Not_Patient_Not_Merge_Patient()
         {
@@ -2328,6 +2368,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that the patient service correctly handles an ADT_A44 patient merge/update request by locating the existing patient via the old patient number and updating it in the repository with the new patient information.
     /// </summary>
+    /// <!-- aidoc:v1 sig=cd35acc body=16982fd -->
     [Test]
         public async Task ADT_A44_Upadate_Patient()
         {
@@ -2369,6 +2410,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that processing an ADT_A44 request for a patient that is not an old patient does not trigger a patient update.
     /// </summary>
+    /// <!-- aidoc:v1 sig=84f3f56 body=0fdeb6d -->
     [Test]
         public async Task ADT_A44_Not_OldPatient_Not__Upadate_Patient()
         {
@@ -2402,6 +2444,7 @@ internal class PatientServiceTest
     /// through the patient service by calling <c>SaveRequest</c> with an <c>ApiRequest</c> of type "ICCA" containing four
     /// patients located in different points of care, and confirms each one is persisted exactly once via the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=db9be10 body=6c05a4c -->
     [Test]
         public async Task ICCA_Process_No_Patient_BD_Insert_ICCA_Patients()
         {
@@ -2470,6 +2513,7 @@ internal class PatientServiceTest
     /// <summary>
     /// Verifies that when an ICCA patient request is processed and a patient already exists in the database at the same point of care but with a different patient number, the existing patient is updated to the moved point of care and the new ICCA patient is inserted.
     /// </summary>
+    /// <!-- aidoc:v1 sig=844f9ba body=c4fd746 -->
     [Test]
         public async Task ICCA_Process_Patient_BD_Insert_ICCA_Patient_Pushed_Actual_Patient()
         {
@@ -2527,6 +2571,7 @@ internal class PatientServiceTest
     /// and the ICCA patients collection is empty, the existing patient is updated with the UNKNOWN
     /// PointOfCareId and no new patient is inserted into the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a53cb38 body=a8ccf49 -->
     [Test]
         public async Task ICCA_Process_Patient_BD_No_Insert_ICCA_Patient_UNKNOWN_Actual_Patient()
         {
diff --git a/adas-core.Test/Services/PointOfCareServiceTest.cs b/adas-core.Test/Services/PointOfCareServiceTest.cs
index ff90d20e..947d17c5 100644
--- a/adas-core.Test/Services/PointOfCareServiceTest.cs
+++ b/adas-core.Test/Services/PointOfCareServiceTest.cs
@@ -29,6 +29,7 @@ public class PointOfCareServiceTests
     /// Configures repository, service, cache, admission, unit, and HTTP context mocks, including a simulated authenticated user
     /// and cache behavior that invokes the supplied factory directly to return the produced <see cref="PointOfCare"/> instance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=249b5e3 -->
     [SetUp]
         public void SetUp()
         {
@@ -84,6 +85,7 @@ public class PointOfCareServiceTests
     /// when invoked with a valid <see cref="ObjectId"/> whose associated admission is <c>null</c>, ensuring
     /// the underlying repository's delete operation is invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fbe967c body=3dbace5 -->
     [Test]
         public async Task Delete_ValidObjectId_DeletesPointOfCare()
         {
@@ -105,6 +107,7 @@ public class PointOfCareServiceTests
     /// <see cref="PointOfCare"/> instance by delegating the operation to the underlying repository.
     /// </summary>
     /// <returns>A <see cref="Task"/> representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=ce1f679 body=430d93e -->
     [Test]
         public async Task Update_ValidPointOfCare_UpdatesPointOfCare()
         {
@@ -122,6 +125,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Verifies that <see cref="PointOfCareService.GetAll"/> returns the complete list of point of care records provided by the repository when invoked with no arguments.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1ff5b52 body=e781807 -->
     [Test]
         public async Task GetAll_NoArguments_ReturnsListOfPointOfCare()
         {
@@ -139,6 +143,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Verifies that <see cref="PointOfCareService.UpdateConfiguration"/> throws a <see cref="ConflictException"/> when invoked with a valid id and configuration, ensuring the service surfaces conflict conditions during the update operation.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1b073df body=7d7853b -->
     [Test]
         public void UpdateConfiguration_ValidIdAndConfiguration_InvokesRepositoryUpdateConfiguration()
         {
@@ -157,6 +162,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Verifies that <c>FindById</c> returns the expected <see cref="PointOfCare"/> when a valid identifier is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8808d2e body=a1b38fe -->
     [Test]
         public async Task FindById_ValidId_ReturnsPointOfCare()
         {
@@ -196,6 +202,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Verifies that <see cref="PointOfCareService.FindByUnitAndStatus"/> returns the expected list of point-of-care records when invoked with a valid unit identifier and status.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dda43eb body=2469c00 -->
     [Test]
         public async Task FindByUnitAndStatus_ValidUnitIdAndStatus_ReturnsListOfPointOfCare()
         {
@@ -300,6 +307,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Tests that the service's FindByRoom method, when called with a valid room, returns the collection provided by the repository and invokes the repository's FindByRoom exactly once.
     /// </summary>
+    /// <!-- aidoc:v1 sig=89ccc77 body=dd6415f -->
     [Test]
         public async Task FindByRoom_ValidRoom_CallsRepositoryFindByRoom()
         {
@@ -319,6 +327,7 @@ public class PointOfCareServiceTests
     /// <summary>
     /// Verifies that the <see cref="PointOfCareService.FindByBed"/> method correctly delegates to the repository's FindByBed method when a valid bed identifier is provided, returning the expected collection of point of care records.
     /// </summary>
+    /// <!-- aidoc:v1 sig=28d655e body=0851f2e -->
     [Test]
         public async Task FindByBed_ValidBed_CallsRepositoryFindByBed()
         {
diff --git a/adas-core.Test/Services/PublisherServiceTest.cs b/adas-core.Test/Services/PublisherServiceTest.cs
index a6e46af2..eb7f4b3a 100644
--- a/adas-core.Test/Services/PublisherServiceTest.cs
+++ b/adas-core.Test/Services/PublisherServiceTest.cs
@@ -21,6 +21,7 @@ public class PublisherServiceTest
     /// <summary>
     /// Initializes the test environment for <see cref="PublisherService"/> by configuring RabbitMQ settings, creating a mocked logger, and instantiating the service under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=b5bc3e1 -->
     [SetUp]
         public void Setup()
         {
@@ -50,6 +51,7 @@ public class PublisherServiceTest
     /// <summary>
     /// Verifies that the publisher service's SendMessage method returns a non-null result when sending a message to the observations queue.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ec11b0e body=15bae5a -->
     [Test]
         public void SendMessage_Return_true()
         {
@@ -63,6 +65,7 @@ public class PublisherServiceTest
     /// <summary>
     /// Verifies that <c>SendMessageError</c> returns a non-null result when publishing a new <see cref="Message{Error}"/> to the observations queue.
     /// </summary>
+    /// <!-- aidoc:v1 sig=565955d body=04f3cbb -->
     [Test]
         public void SendMessage_Error_Return_true()
         {
diff --git a/adas-core.Test/Services/PumpServiceTest.cs b/adas-core.Test/Services/PumpServiceTest.cs
index 90bd7fda..230df099 100644
--- a/adas-core.Test/Services/PumpServiceTest.cs
+++ b/adas-core.Test/Services/PumpServiceTest.cs
@@ -50,6 +50,7 @@ public class PumpServiceTest
     /// <summary>
     /// Initializes the unit test fixture by creating mock repositories, services, and a mocked <see cref="HttpContext"/> with a test claims principal, then instantiates the <see cref="PumpService"/> under test using the configured API settings (5-second pump expiration, zero pump messages disabled). Pass-through mappings are configured for <see cref="ICalculatedObservationsService"/>, <see cref="IConfigPumpsService"/>, and <see cref="IConfigUnitsService"/> so that supplied pump observations are returned unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=872fc6b -->
     [SetUp]
         public void Setup()
         {
@@ -115,6 +116,7 @@ public class PumpServiceTest
     /// Verifies that <see cref="ApiRequest"/> processing does not insert any <see cref="PumpObservation"/> records
     /// when the request is saved without associated observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=42b8c0e body=dd944a2 -->
     [Test]
         public async Task SaveRequest_Returns_When_No_Observations()
         {
@@ -126,6 +128,7 @@ public class PumpServiceTest
     /// <summary>
     /// Verifies that <c>SaveRequest</c> does not insert a <see cref="PumpObservation"/> when the <see cref="ApiRequest.Type"/> is an unrecognized value.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f664650 body=4ef2165 -->
     [Test]
         public async Task SaveRequest_UnknownType_DoesNotInsert()
         {
@@ -143,6 +146,7 @@ public class PumpServiceTest
     /// Verifies that SaveRequest converts a single <c>PumpObservation</c> on an incoming
     /// <c>ApiRequest</c> into a list with one entry on the request after processing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ffee994 body=257a0a7 -->
     [Test]
         public async Task SaveRequest_Converts_SingleObservation_ToList()
         {
@@ -164,6 +168,7 @@ public class PumpServiceTest
     /// <summary>
     /// Verifies that Service.SaveRequest sets the <c>Expires</c> property of the <see cref="PumpObservation"/> before persisting it via the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f82c67c body=9a75bd3 -->
     [Test]
         public async Task SaveRequest_SetsExpires_BeforeInsert()
         {
@@ -196,6 +201,7 @@ public class PumpServiceTest
     /// and does not create a <see cref="PumpObservation"/>, ensuring alarm-phase events are
     /// routed to the alarm event store rather than the observation store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=5d43d51 body=5d854f0 -->
     [Test]
         public async Task SaveRequest_ORU_R40_CreatesAlarmEvent()
         {
@@ -221,6 +227,7 @@ public class PumpServiceTest
     /// Verifies that processing a pump observation with <c>EventPhase.End</c> removes the corresponding alarm state
     /// by calling <c>RemoveAsync</c> on the alarm state repository with the matching device, alarm type, and MDC code.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bc95230 body=ed3bff2 -->
     [Test]
         public async Task ProcessAlarm_End_RemovesAlarmState()
         {
@@ -249,6 +256,7 @@ public class PumpServiceTest
     /// Verifies that <c>SaveRequest</c> creates and upserts a new <see cref="PumpState"/>
     /// for the device when no existing pump state is found in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a8ef24c body=b070da6 -->
     [Test]
         public async Task SaveRequest_CreatesPumpState_IfNotExists()
         {
@@ -273,6 +281,7 @@ public class PumpServiceTest
     /// Verifies that SaveRequest does not broadcast a message via the client when there are no active subscribers.
     /// </summary>
     /// <returns>A task that completes when the assertion has been executed.</returns>
+    /// <!-- aidoc:v1 sig=7b9c477 body=f817038 -->
     [Test]
         public async Task SaveRequest_NoSubscribers_NoBroadcast()
         {
@@ -372,6 +381,7 @@ public class PumpServiceTest
     /// <c>DeleteOlderThanDaysAsync</c> method with the configured retention value when the
     /// retention policy returned for the pump observation is <c>DeleteOlderDays</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d2dfd4d body=d351b0f -->
     [Test]
         public async Task SaveRequest_Retention_DeleteOlderDays_CallsRepo()
         {
@@ -399,6 +409,7 @@ public class PumpServiceTest
     /// Verifies that <c>GetPaginatedPump</c> returns the correct paginated results when filtering by patient identifier.
     /// Ensures the first page contains the most recent observation within the configured time tolerance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b7d70a0 body=0ac38ce -->
     [Test]
         public async Task GetPaginatedPump_ByPatient_Works()
         {
@@ -434,6 +445,7 @@ public class PumpServiceTest
     /// Verifies that <c>ArchiveByPatientId</c> inserts the patient's pump observations into the archive
     /// repository and then deletes them, along with their related alarm events and alarm states.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7f95b21 body=fcc366d -->
     [Test]
         public async Task ArchiveByPatientId_InsertsArchive_ThenDeletes()
         {
@@ -459,6 +471,7 @@ public class PumpServiceTest
     /// Verifies that <c>UpdateManyObjectId</c> correctly updates the patient identifier across observations, alarms, and alarm state repositories.
     /// </summary>
     /// <returns>A task representing the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=b51830b body=7584081 -->
     [Test]
         public async Task UpdateManyObjectId_UpdatesObs_Alarms_States()
         {
@@ -483,6 +496,7 @@ public class PumpServiceTest
     /// Verifies that <c>FindLastPumpObservations</c> returns pump observations ordered with the most recent first,
     /// returning only the specified number of latest entries when the repository provides multiple observations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7cbd1eb body=331060b -->
     [Test]
         public async Task FindLastPumpObservations_ReturnsOrdered()
         {
@@ -508,6 +522,7 @@ public class PumpServiceTest
     /// Verifies that InsertPumpObservation persists the observation and upserts the corresponding
     /// pump state when no existing state is found for the device and there are no active subscribers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=98c89e1 body=3e74c5d -->
     [Test]
         public async Task InsertPumpObservation_Inserts_AndBroadcasts()
         {
diff --git a/adas-core.Test/Services/RecordingAlertServiceTest.cs b/adas-core.Test/Services/RecordingAlertServiceTest.cs
index 4fdfa25e..3e887db3 100644
--- a/adas-core.Test/Services/RecordingAlertServiceTest.cs
+++ b/adas-core.Test/Services/RecordingAlertServiceTest.cs
@@ -21,6 +21,7 @@ public class RecordingAlertServiceTest
     /// <summary>
     /// Initializes the mocked dependencies and test infrastructure required by the <see cref="RecordingAlertService"/> unit tests, including service and repository mocks, a fake HTTP context with a "TestUser" claim, and the system-under-test instance.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=ef6880f -->
     [SetUp]
         public void Setup()
         {
@@ -88,6 +89,7 @@ public class RecordingAlertServiceTest
     /// <summary>
     /// Verifies that <see cref="RecordingAlertService.SaveRequest"/> does not persist a <see cref="PatientRecordingAlert"/> when the provided <see cref="ApiRequest"/> is neither a recording alert nor an ORU R01 message.
     /// </summary>
+    /// <!-- aidoc:v1 sig=25109a2 body=153205d -->
     [Test]
         public async Task SaveRequest_Not_RecordingAlert_Not_ORU_R01_Return_not_insert()
         {
@@ -101,6 +103,7 @@ public class RecordingAlertServiceTest
     /// <summary>
     /// Verifies that <see cref="RecordingAlertService.SaveRequest"/> does not insert a <see cref="PatientRecordingAlert"/> when both the patient number and point of care are null in the <see cref="ApiRequest"/>, even when the message type is "ORU_R11".
     /// </summary>
+    /// <!-- aidoc:v1 sig=84b4d02 body=8ae3d26 -->
     [Test]
         public async Task SaveRequest_patientNumber_and_pointOfCare_null_Return_not_insert()
         {
@@ -118,6 +121,7 @@ public class RecordingAlertServiceTest
     /// <summary>
     /// Verifies that the SaveRequest method does not insert a patient recording alert when the specified patient cannot be found.
     /// </summary>
+    /// <!-- aidoc:v1 sig=67b2be6 body=931ed14 -->
     [Test]
         public async Task SaveRequest_Not_Find_Patient_Return_not_insert()
         {
@@ -146,6 +150,7 @@ public class RecordingAlertServiceTest
     /// <summary>
     /// Verifies that SaveRequest inserts a new <see cref="PatientRecordingAlert"/> into the repository when the configuration observation service returns no retention actions for the given recording alert.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9d79768 body=ecbd046 -->
     [Test]
         public async Task SaveRequest_Alert_Return_insert()
         {
diff --git a/adas-core.Test/Services/RecordingServiceTest.cs b/adas-core.Test/Services/RecordingServiceTest.cs
index f7f2dd23..9b40dce5 100644
--- a/adas-core.Test/Services/RecordingServiceTest.cs
+++ b/adas-core.Test/Services/RecordingServiceTest.cs
@@ -31,6 +31,7 @@ public class RecordingServiceTest
     /// dependencies (logger, HTTP client factory, publisher, authentication, client message, subscribers, and patient services),
     /// and configuring the publisher mock to successfully send both regular messages and errors.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=858be2c -->
     [SetUp]
         public void Setup()
         {
@@ -108,6 +109,7 @@ public class RecordingServiceTest
     /// <summary>
     /// Verifies that <see cref="RecordingService.GetRecordings"/> returns an empty collection of <see cref="RecordingData"/> when the HTTP response indicates an unauthorized (401) status, ensuring the service correctly handles failed authentication scenarios by yielding no recordings rather than throwing or returning null.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2d4a973 body=2d5face -->
     [Test]
         public async Task GetRecordings_Return_Empty()
         {
@@ -138,6 +140,7 @@ public class RecordingServiceTest
     /// when the HTTP endpoint responds with a successful payload containing a recording and its associated patient.
     /// Asserts that the returned items match the source data for status, room identifier, and patient identity fields.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a268bca body=27cf99d -->
     [Test]
         public async Task GetRecordings_Return_RecordingData()
         {
@@ -187,6 +190,7 @@ public class RecordingServiceTest
     /// <summary>
     /// Tests that calling <c>SaveRequest</c> on the recording service throws a <see cref="NotImplementedException"/> when supplied with an <see cref="ApiRequest"/>, using a mocked HTTP message handler that returns a successful response.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e3a0b21 body=247c17b -->
     [Test]
         public Task SaveRequest()
         {
diff --git a/adas-core.Test/Services/RedisLockProviderTest.cs b/adas-core.Test/Services/RedisLockProviderTest.cs
index 61681d50..45704cf7 100644
--- a/adas-core.Test/Services/RedisLockProviderTest.cs
+++ b/adas-core.Test/Services/RedisLockProviderTest.cs
@@ -21,6 +21,7 @@ public class RedisLockProviderTest
     /// <summary>
     /// Initializes the test environment by creating a mock <see cref="IDatabase"/> and instantiating a <see cref="RedisLockProvider"/> configured to use the mocked database.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=aaffb29 -->
     [SetUp]
         public void SetUp()
         {
@@ -32,6 +33,7 @@ public class RedisLockProviderTest
     /// <summary>
     /// Verifies that <c>AcquireAsync</c> returns <c>true</c>, stores the lock token under the <c>lock:</c> prefixed key, applies the configured TTL, and uses the <c>When.NotExists</c> flag when Redis accepts the NX SET operation. Also asserts that a subsequent <c>ReleaseAsync</c> invokes the Redis release script.
     /// </summary>
+    /// <!-- aidoc:v1 sig=70f9b70 body=cb5fcc3 -->
     [Test]
         public async Task AcquireAsync_ReturnsTrue_AndStoresToken_WhenRedisAcceptsNxSet()
         {
@@ -78,6 +80,7 @@ public class RedisLockProviderTest
     /// Asserts the call is retried the expected number of times and that the elapsed time confirms
     /// delays were actually applied between attempts.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d11d703 body=9ec3583 -->
     [Test]
         public async Task AcquireAsync_RetriesWithDelays_UntilNxSucceeds()
         {
@@ -112,6 +115,7 @@ public class RedisLockProviderTest
     /// <summary>
     /// Verifies that AcquireAsync returns <c>false</c> and performs multiple retry attempts when the underlying lock acquisition operation consistently fails within the specified timeout.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b5c5d4f body=131b234 -->
     [Test]
         public async Task AcquireAsync_ReturnsFalse_AfterTimeoutWithMultipleRetries()
         {
@@ -142,6 +146,7 @@ public class RedisLockProviderTest
     /// <summary>
     /// Verifies that releasing a lock invokes the Lua script evaluation with the correct lock key (prefixed with "lock:") and the token previously captured during lock acquisition.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a27fd67 body=af51113 -->
     [Test]
         public async Task ReleaseAsync_CallsScriptEvaluateWithCorrectKeyAndToken()
         {
@@ -181,6 +186,7 @@ public class RedisLockProviderTest
     /// Verifies that ReleaseAsync is idempotent when invoked without a prior acquire operation,
     /// ensuring that no script evaluation is performed on the underlying database in this scenario.
     /// </summary>
+    /// <!-- aidoc:v1 sig=34ada35 body=27f9924 -->
     [Test]
         public async Task ReleaseAsync_IsIdempotent_WhenCalledWithoutPriorAcquire()
         {
diff --git a/adas-core.Test/Services/RedisServiceTest.cs b/adas-core.Test/Services/RedisServiceTest.cs
index d3cb5c22..bb9b26c3 100644
--- a/adas-core.Test/Services/RedisServiceTest.cs
+++ b/adas-core.Test/Services/RedisServiceTest.cs
@@ -24,6 +24,7 @@ public class RedisServiceTest
     /// <summary>
     /// Initializes test dependencies before each test execution by creating a mock <see cref="IDatabase"/> instance and instantiating the <see cref="LockManagerService"/> with a mocked logger and an in-memory lock provider.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=f7d3912 -->
     [SetUp]
         public void SetUp()
         {
@@ -40,6 +41,7 @@ public class RedisServiceTest
     /// <param name="settings">Optional cache settings to apply; when <c>null</c>, a new default <see cref="CacheSettings"/> instance is used.</param>
     /// <param name="redisAvailable">Flag indicating whether the Redis service should be marked as available; defaults to <c>true</c>.</param>
     /// <returns>A <see cref="RedisService"/> instance with the database and availability state initialized for testing.</returns>
+    /// <!-- aidoc:v1 sig=3b2c312 body=dfaacef -->
     private RedisService CreateSut(CacheSettings? settings = null, bool redisAvailable = true)
         {
             var sut = new RedisService(
@@ -59,6 +61,7 @@ public class RedisServiceTest
     /// <param name="target">The <see cref="RedisService"/> instance whose field will be set.</param>
     /// <param name="name">The name of the non-public instance field to assign.</param>
     /// <param name="value">The value to assign to the field. Can be null.</param>
+    /// <!-- aidoc:v1 sig=29fabd1 -->
     private static void SetField(object target, string name, object? value)
             => typeof(RedisService)
                 .GetField(name, BindingFlags.NonPublic | BindingFlags.Instance)!
@@ -67,6 +70,7 @@ public class RedisServiceTest
     /// <summary>
     /// Configures the mock database to return a successful result (<c>true</c>) for any invocation of <c>StringSetAsync</c>, regardless of the supplied key, value, expiry, overwrite flag, condition, or command flags.
     /// </summary>
+    /// <!-- aidoc:v1 sig=98682b4 -->
     private void SetupStringSetAsync()
             => _mockDb
                 .Setup(db => db.StringSetAsync(
@@ -77,6 +81,7 @@ public class RedisServiceTest
     /// <summary>
     /// Configures the mock Redis database to handle <c>KeyExpire</c> calls by returning <c>true</c> for any combination of key, expiration, condition, and command flag arguments.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0ffd573 -->
     private void SetupKeyExpire()
             => _mockDb
                 .Setup(db => db.KeyExpire(
@@ -88,6 +93,7 @@ public class RedisServiceTest
     /// <summary>
     /// Verifies that <c>GetOrSetObjectAsync</c> invokes the supplied factory when Redis is unavailable, returning the factory's result without attempting any Redis read or write operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1a73907 body=b6ad74e -->
     [Test]
         public async Task GetOrSetObjectAsync_ExecutesFactory_WhenRedisUnavailable()
         {
@@ -111,6 +117,7 @@ public class RedisServiceTest
     /// when a value is present in the cache, without invoking the factory delegate and without
     /// attempting to write back to Redis.
     /// </summary>
+    /// <!-- aidoc:v1 sig=ff045fa body=9481052 -->
     [Test]
         public async Task GetOrSetObjectAsync_ReturnsCachedObject_WhenRedisHit()
         {
@@ -138,6 +145,7 @@ public class RedisServiceTest
     /// Verifies that <c>GetObjectAsync</c> calls the underlying Redis <c>KeyExpire</c> command with the configured TTL
     /// when the <c>updateExpiration</c> flag is set to <c>true</c>, ensuring cache entries are refreshed upon a successful hit.
     /// </summary>
+    /// <!-- aidoc:v1 sig=066b548 body=8421fd4 -->
     [Test]
         public async Task GetObjectAsync_CallsKeyExpire_WhenUpdateExpirationIsTrue()
         {
@@ -167,6 +175,7 @@ public class RedisServiceTest
     /// Verifies that <c>GetObjectAsync</c> does not invoke the Redis key expiration command
     /// when the caller explicitly requests that the existing expiration be left unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=e10e6a3 body=d0256b9 -->
     [Test]
         public async Task GetObjectAsync_DoesNotCallKeyExpire_WhenUpdateExpirationIsFalse()
         {
@@ -190,6 +199,7 @@ public class RedisServiceTest
     /// Ensures the factory delegate is executed, the deserialized value matches the factory output, and the
     /// object is written to cache with the expected expiration.
     /// </summary>
+    /// <!-- aidoc:v1 sig=775bb73 body=a143def -->
     [Test]
         public async Task GetOrSetObjectAsync_InvokesFactoryAndPersists_WhenCacheMiss()
         {
@@ -232,6 +242,7 @@ public class RedisServiceTest
     /// Verifies that when the cache lookup returns no value and the factory delegate produces <c>null</c>,
     /// the method returns <c>null</c> and does not persist any value to the underlying cache store.
     /// </summary>
+    /// <!-- aidoc:v1 sig=67a4b2b body=95662d2 -->
     [Test]
         public async Task GetOrSetObjectAsync_DoesNotPersist_WhenFactoryReturnsNull()
         {
@@ -256,6 +267,7 @@ public class RedisServiceTest
     /// Verifies that <c>GetObjectAsync</c> successfully retrieves and deserializes the stored object while skipping the
     /// key-expiration refresh when <c>updateExpiration</c> is set to <c>false</c>, ensuring <c>KeyExpire</c> is never invoked.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f1dc303 body=114b61f -->
     [Test]
         public async Task GetObjectAsync_ReturnsObject_AndSkipsKeyExpire_WhenUpdateExpirationFalse()
         {
@@ -280,6 +292,7 @@ public class RedisServiceTest
     /// Verifies that <c>SetObjectAsync</c> serializes the supplied object to JSON and persists it in Redis
     /// with the entity-specific TTL (600 seconds) configured for the "Patients" entity in <see cref="CacheSettings"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=053126b body=05a7fbb -->
     [Test]
         public async Task SetObjectAsync_SerializesToJson_AndPersistsWithEntityTtl()
         {
diff --git a/adas-core.Test/Services/RelayServiceTest.cs b/adas-core.Test/Services/RelayServiceTest.cs
index 546b6fda..a766d620 100644
--- a/adas-core.Test/Services/RelayServiceTest.cs
+++ b/adas-core.Test/Services/RelayServiceTest.cs
@@ -23,6 +23,7 @@ public class RelayServiceTest
     /// <summary>
     /// Sets up the test environment by initializing mocks and dependencies required for unit testing the <see cref="RelayService"/>, including logger, HTTP client factory, HTTP message handler, relay settings, point-of-care service, and relay repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=f8dc12e -->
     [SetUp]
         public void Setup()
         {
@@ -62,6 +63,8 @@ public class RelayServiceTest
     /// <summary>
     /// Verifies that the relay service successfully powers off a relay by issuing an HTTP request through the configured HTTP client factory.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary claims the test 'verifies that the relay service successfully powers off a relay', but the test contains no assertions—it only sets up mocks and calls PowerOff without verifying any outcome." -->
     [Test]
         public async Task PowerOffAsync()
         {
@@ -100,6 +103,7 @@ public class RelayServiceTest
     /// <summary>
     /// Verifies that <see cref="RelayService.PowerOn"/> correctly sends a power-on request to the configured relay device using the HTTP client.
     /// </summary>
+    /// <!-- aidoc:v1 sig=44fe1e4 body=914160c -->
     [Test]
         public async Task PowerOnAsync()
         {
@@ -138,6 +142,7 @@ public class RelayServiceTest
     /// <summary>
     /// Verifies that <c>CheckRelayStatus</c> returns <see cref="RelayEnum.Status.On"/> when the mocked HTTP response indicates the relay is on.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2a547df body=bf57c2c -->
     [Test]
         public async Task CheckRelayStatus_Return_On()
         {
@@ -226,6 +231,7 @@ public class RelayServiceTest
     /// driver response does not match a recognized on/off state (e.g., the raw payload "\\Off" is not
     /// mapped to a known status).
     /// </summary>
+    /// <!-- aidoc:v1 sig=85fcbc2 body=fd57b78 -->
     [Test]
         public async Task CheckRelayStatus_Return_Unknown()
         {
diff --git a/adas-core.Test/Services/SchedulerServiceTest.cs b/adas-core.Test/Services/SchedulerServiceTest.cs
index f431d106..d0b4f6be 100644
--- a/adas-core.Test/Services/SchedulerServiceTest.cs
+++ b/adas-core.Test/Services/SchedulerServiceTest.cs
@@ -348,6 +348,7 @@ public class SchedulerServiceTest
     /// Verifies that the <see cref="CheckInactivePatientsJob"/> is executed when its Quartz.NET trigger fires,
     /// ensuring the scheduled job invokes the patient discharge process for inactive patients at the configured interval.
     /// </summary>
+    /// <!-- aidoc:v1 sig=433f153 body=564acd0 -->
     [Test]
         public void CheckInactivePatientsJob_ShouldExecuteOnTrigger()
         {
@@ -387,6 +388,7 @@ public class SchedulerServiceTest
     /// when triggered, and that the medicine service is invoked exactly once to retrieve medicines
     /// for the active treatments of the mocked patients.
     /// </summary>
+    /// <!-- aidoc:v1 sig=01d636e body=f71f2df -->
     [Test]
         public void CheckActiveTreatmentsJob_ShouldExecuteOnTrigger()
         {
@@ -460,6 +462,7 @@ public class SchedulerServiceTest
     /// <summary>
     /// Verifies that the <see cref="CheckExpiredObservationsJob"/> is executed at least once by the Quartz.NET scheduler when triggered with a recurring schedule.
     /// </summary>
+    /// <!-- aidoc:v1 sig=77a1a73 body=9a546f0 -->
     [Test]
         public void CheckExpiredObservationsJob_ShouldExecuteOnTrigger()
         {
@@ -493,6 +496,7 @@ public class SchedulerServiceTest
     /// <summary>
     /// Verifies that the <see cref="CheckExpiredAlertsJob"/> is executed when triggered by the Quartz.NET scheduler, ensuring that the <c>ExpireAlertsAndPowerOffAsync</c> method on the observation service is invoked at least once.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0e98299 body=a3d213c -->
     [Test]
         public void CheckExpiredAlertsJob_ShouldExecuteOnTrigger()
         {
@@ -527,6 +531,7 @@ public class SchedulerServiceTest
     /// <c>InsertObservation</c> with a <see cref="PatientObservation"/> whose <c>Name</c> is not "NEWS", ensuring
     /// that only NEWS observations are considered for persistence during scheduled execution.
     /// </summary>
+    /// <!-- aidoc:v1 sig=efdce93 body=5423389 -->
     [Test]
         public void GetProvidersObservationsJob_ShouldExecuteOnTrigger_Result_GetType_null()
         {
@@ -577,6 +582,7 @@ public class SchedulerServiceTest
     /// <summary>
     /// Verifies that the <see cref="CalculateNewsJob"/> is executed when triggered by the Quartz.NET scheduler, confirming that the associated <c>InsertObservation</c> call on the observation service is invoked at least once within the allowed execution window.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2db113b body=674d8bd -->
     [Test]
         public void CheckCalculateNewsJob_ShouldExecuteOnTrigger()
         {
@@ -610,6 +616,7 @@ public class SchedulerServiceTest
     /// <summary>
     /// Verifies that <see cref="CalculateNewsJob.Execute"/> correctly inserts NEWS observations with the expected calculated values (1 and 4) for multiple patients in a single execution.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a18d2b9 body=bc2ddd0 -->
     [Test]
         public async Task CalculateNewsJob_Insert_ObsFull_MultiplePatient_With_Correct_Value()
         {
diff --git a/adas-core.Test/Services/SendAlertServiceTest.cs b/adas-core.Test/Services/SendAlertServiceTest.cs
index 11be14cf..a808e0c9 100644
--- a/adas-core.Test/Services/SendAlertServiceTest.cs
+++ b/adas-core.Test/Services/SendAlertServiceTest.cs
@@ -19,6 +19,7 @@ public class SendAlertServiceTest
     /// RabbitMQ options, a mocked logger, an instance of the service under test, and the set
     /// of Windows platform identifiers used to validate platform-specific behavior.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=764cb7d -->
     [SetUp]
         public void Setup()
         {
@@ -54,6 +55,7 @@ public class SendAlertServiceTest
     /// reading (non-null with a positive <c>ValueTotal</c>) when executed on a Windows platform. When the
     /// host operating system is not Windows, the test is skipped with an ignore notice.
     /// </summary>
+    /// <!-- aidoc:v1 sig=679f280 body=1dd0797 -->
     [Ignore("Integration test to pull request")]
         [Test]
         public void GetConsumedCpu_Return_PerformanceCpu_data()
@@ -78,6 +80,7 @@ public class SendAlertServiceTest
     /// for <c>PercentageConsumed</c>, <c>ValueConsumed</c>, and <c>ValueTotal</c>. The test only executes on
     /// Windows platforms and is ignored on other operating systems.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7a39a99 body=abcb5c0 -->
     [Ignore("Integration test to pull request")]
         [Test]
         public void GetConsumedRAM_Return_PerformanceRAM_data()
@@ -104,6 +107,7 @@ public class SendAlertServiceTest
     /// <summary>
     /// Integration test that verifies the GetConsumedStorage method returns valid Performance data with positive percentage and value metrics for all ready drives on Windows platforms. The test is ignored when executed on a non-Windows platform.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a2098e9 body=3485f79 -->
     [Ignore("Integration test to pull request")]
         [Test]
         public void GetConsumedStorage_Return_PerformanceStorage_data()
diff --git a/adas-core.Test/Services/SeviceConfigServiceTest.cs b/adas-core.Test/Services/SeviceConfigServiceTest.cs
index 2a4aaeb5..7ac10476 100644
--- a/adas-core.Test/Services/SeviceConfigServiceTest.cs
+++ b/adas-core.Test/Services/SeviceConfigServiceTest.cs
@@ -17,6 +17,7 @@ public class ServiceConfigServiceTest
     /// <summary>
     /// Initializes the test environment by creating mock instances of the service configuration repository and logger, and instantiating the <see cref="ServiceConfigService"/> under test.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=beef729 -->
     [SetUp]
         public void Setup()
         {
@@ -41,6 +42,7 @@ public class ServiceConfigServiceTest
     /// Verifies that the <see cref="ServiceConfig"/> service returns a <see cref="ServiceConfig"/> instance
     /// when retrieving an existing configuration by its string identifier.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9b53d80 body=c9ed65c -->
     [Test]
         public async Task Get_Find_Id_Return_ServiceConfig()
         {
@@ -59,6 +61,7 @@ public class ServiceConfigServiceTest
     /// <summary>
     /// Verifies that the Get method returns a <see cref="ServiceConfig"/> when the specified id is not found by the repository's <c>FindById</c>, falling back to a lookup with any <see cref="ObjectId"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=575d813 body=2042ef1 -->
     [Test]
         public async Task Get_Not_Find_Id_Return_ServiceConfig()
         {
diff --git a/adas-core.Test/Services/TreatmentServiceTest.cs b/adas-core.Test/Services/TreatmentServiceTest.cs
index 8f5cb4f4..675b043c 100644
--- a/adas-core.Test/Services/TreatmentServiceTest.cs
+++ b/adas-core.Test/Services/TreatmentServiceTest.cs
@@ -23,6 +23,7 @@ public class TreatmentServiceTest
     /// <summary>
     /// Initializes the mock dependencies and creates a <see cref="TreatmentService"/> instance for unit testing.
     /// </summary>
+    /// <!-- aidoc:v1 sig=dee8bf2 body=e1a20f3 -->
     [SetUp]
     public void Setup()
     {
@@ -183,6 +184,7 @@ public class TreatmentServiceTest
     /// Verifies that saving an <see cref="ApiRequest"/> without the Case option throws an <see cref="ApiRequestException"/>, preventing the insert operation.
     /// </summary>
     /// <exception cref="ApiRequestException">Thrown by the service when the Case option is not provided in the request.</exception>
+    /// <!-- aidoc:v1 sig=e189a56 body=217df39 -->
     [Test]
     public void SaveRequest_Not_Case_option_Return_not_insert()
     {
@@ -195,6 +197,7 @@ public class TreatmentServiceTest
     /// <summary>
     /// Verifies that _treatmentService.SaveRequest throws an <see cref="ApiRequestException"/> when the <see cref="ApiRequest"/> is missing both the patient number and the point of care, preventing insertion of an incomplete request.
     /// </summary>
+    /// <!-- aidoc:v1 sig=641365f body=4992b53 -->
     [Test]
     public void SaveRequest_patientNumber_and_pointOfCare_null_Return_not_insert()
     {
@@ -211,6 +214,7 @@ public class TreatmentServiceTest
     /// <summary>
     /// Verifies that _treatmentService.SaveRequest does not insert a patient treatment record when the patient cannot be found in the archive.
     /// </summary>
+    /// <!-- aidoc:v1 sig=67b2be6 body=c16d218 -->
     [Test]
     public async Task SaveRequest_Not_Find_Patient_Return_not_insert()
     {
@@ -239,6 +243,7 @@ public class TreatmentServiceTest
     /// <summary>
     /// Verifies that SaveRequest does not insert a new patient treatment into the treatment archive when an existing patient is found by patient number.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2b730f8 body=b50d935 -->
     [Test]
     public async Task SaveRequest_Find_Patient_Return_insert()
     {
@@ -278,6 +283,7 @@ public class TreatmentServiceTest
     /// <summary>
     /// Verifies that <c>GetActiveTreatmentsByPatient</c> retrieves the full set of active treatments for the specified patient, returning a non-empty collection that includes all expected treatment records identified by their placer order entity identifiers.
     /// </summary>
+    /// <!-- aidoc:v1 sig=94cf97f body=366612d -->
     [Test]
     public async Task GetActiveTreatmentsByPatient()
     {
diff --git a/adas-core.Test/Services/UnitServiceTest.cs b/adas-core.Test/Services/UnitServiceTest.cs
index 94da3b39..acd8fe87 100644
--- a/adas-core.Test/Services/UnitServiceTest.cs
+++ b/adas-core.Test/Services/UnitServiceTest.cs
@@ -18,6 +18,7 @@ namespace adas_core.Test.Services;
 /// <remarks>
 /// This class is intended to contain test methods that validate the behavior and correctness of the UnitService.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d7fe647 -->
 public class UnitServiceTest
 {
     private readonly Mock<ILocalAuditService> _auditServiceMock = new();
@@ -35,6 +36,7 @@ public class UnitServiceTest
     /// Initializes mocked dependencies and a configured <see cref="UnitService"/> instance for each test,
     /// including a mock <see cref="HttpContext"/> with a test user claim.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d8eb19f body=9422220 -->
     [SetUp]
     public void SetUp()
     {
@@ -72,6 +74,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that the unit service returns all units retrieved from the repository, including the correct count and content.
     /// </summary>
+    /// <!-- aidoc:v1 sig=646f078 body=e817121 -->
     [Test]
     public async Task GetAll_ShouldReturnAllUnits()
     {
@@ -91,6 +94,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that the Get method on the unit service returns the expected unit when a valid identifier is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=0b84cdc body=a6e9915 -->
     [Test]
     public async Task Get_ShouldReturnUnitById()
     {
@@ -110,6 +114,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that the Get method retrieves a unit by name when the provided identifier is not a valid ObjectId, matching against either the unit's Title or Name.
     /// </summary>
+    /// <!-- aidoc:v1 sig=27de124 body=d6052b8 -->
     [Test]
     public async Task Get_ShouldReturnUnitByName_WhenIdIsNotObjectId()
     {
@@ -135,6 +140,7 @@ public class UnitServiceTest
     /// Verifies that _unitService" returns all units retrieved from the repository,
     /// ensuring the result is not null, contains the expected number of units, and matches the source data.
     /// </summary>
+    /// <!-- aidoc:v1 sig=58385af body=4797f02 -->
     [Test]
     public async Task GetAllUnits_ShouldReturnAllUnits()
     {
@@ -159,6 +165,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that _unitService.FindById" returns the matching <see cref="Unit"/> when the repository locates it by id.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4ba7a3f body=5b6115c -->
     [Test]
     public async Task GetUnitById_ShouldReturnUnit_WhenFound()
     {
@@ -179,6 +186,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that <c>GetByName</c> returns the matching unit when a unit with the specified name exists in the repository.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f3d4d6c body=e6fef50 -->
     [Test]
     public async Task GetUnitByName_ShouldReturnUnit_WhenFound()
     {
@@ -199,6 +207,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that <c>FindByPatientId</c> returns the associated unit when the patient is found in an active (in-use) point of care.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c94d17c body=783cf46 -->
     [Test]
     public async Task FindUnitByPatientId_ShouldReturnUnit_WhenPatientFoundInActivePoC()
     {
@@ -229,6 +238,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that the unit service returns the matching units retrieved from the repository when a call is made to find units by the specified master list identifier and type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=43926cf body=5d4a6ea -->
     [Test]
     public async Task FindUnitsByMasterListId_ShouldReturnUnits_WhenUnitsFound()
     {
@@ -255,6 +265,7 @@ public class UnitServiceTest
     /// Verifies that the unit service returns the matching units when the repository contains units
     /// whose point of care matches the specified patient location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f8afd28 body=15ba7bb -->
     [Test]
     public async Task FindByLocation_ShouldReturnUnits_WhenUnitsFound()
     {
@@ -282,6 +293,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that FindByLocation returns an empty list when no units match the specified patient location.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fd09042 body=3dd5efa -->
     [Test]
     public async Task FindByLocation_ShouldReturnEmptyList_WhenNoUnitsFound()
     {
@@ -301,6 +313,7 @@ public class UnitServiceTest
     /// Verifies that the unit service returns the expected unit when a valid unit identifier is provided.
     /// </summary>
     /// <returns>A task that represents the asynchronous test execution.</returns>
+    /// <!-- aidoc:v1 sig=bd2f214 body=ccde6a3 -->
     [Test]
     public async Task FindById_ShouldReturnUnit_WhenValidIdProvided()
     {
@@ -321,6 +334,7 @@ public class UnitServiceTest
     /// Verifies that the unit service's FindById method returns null when invoked with a null identifier,
     /// ensuring graceful handling of null input without throwing or returning a default entity.
     /// </summary>
+    /// <!-- aidoc:v1 sig=74278e6 body=91cce5c -->
     [Test]
     public async Task FindById_ShouldReturnNull_WhenNullIdProvided()
     {
@@ -336,6 +350,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that FindByName retrieves and returns the expected <c>Unit</c> when a valid unit name is provided.
     /// </summary>
+    /// <!-- aidoc:v1 sig=25b0fc0 body=3bf0b69 -->
     [Test]
     public async Task FindByName_ShouldReturnUnit_WhenValidNameProvided()
     {
@@ -356,6 +371,7 @@ public class UnitServiceTest
     /// <summary>
     /// Verifies that the unit service correctly delegates the insert operation to the repository and returns the inserted unit entity unchanged.
     /// </summary>
+    /// <!-- aidoc:v1 sig=24b4720 body=83a8f91 -->
     [Test]
     public async Task InsertOne_ShouldReturnInsertedUnit()
     {
diff --git a/adas-core.Test/Utilities/CacheKeyClassifierTest.cs b/adas-core.Test/Utilities/CacheKeyClassifierTest.cs
index 3cafcaf1..bb9463d5 100644
--- a/adas-core.Test/Utilities/CacheKeyClassifierTest.cs
+++ b/adas-core.Test/Utilities/CacheKeyClassifierTest.cs
@@ -13,6 +13,8 @@ namespace adas_core.Test.Utilities;
 /// Provides a <see cref="TestFixtureAttribute"/> that validates the behavior of <see cref="CacheKeyClassifier"/>.
 /// </summary>
 /// <!-- aidoc:v1 sig=417f7b7 -->
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The class is a [TestFixture] test class, not something that 'provides a TestFixtureAttribute'. The summary mischaracterizes the class as providing an attribute rather than being a test fixture for CacheKeyClassifier." -->
 [TestFixture]
 public class CacheKeyClassifierTest
 {
@@ -20,6 +22,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Patients"/> when the cache key starts with the "patients" prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=682114d body=31a0933 -->
     [Test]
         public void Classify_ReturnsPatients_ForKeyStartingWithPatients()
         {
@@ -37,6 +40,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Patients"/> when the cache key starts with the "patients:xyz:" prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9e918d0 body=93ae134 -->
     [Test]
         public void Classify_ReturnsPatients_ForKeyStartingWithPatientsXYZ()
         {
@@ -59,6 +63,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> correctly returns <see cref="CacheEnum.EntityType.Displays"/>
     /// for a cache key matching the "configDisplays:display:&lt;id&gt;:base" pattern.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b17fa26 body=686712a -->
     [Test]
         public void Classify_ReturnsDisplays_ForKeyStartingWithConfigDisplaysBase()
         {
@@ -77,6 +82,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Displays"/> when the supplied cache key begins with the <c>configDisplays:</c> prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3f418e8 body=4bc5ab2 -->
     [Test]
         public void Classify_ReturnsDisplays_ForKeyStartingWithConfigDisplaysConfig()
         {
@@ -96,6 +102,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.PumpObservations"/>
     /// when the provided cache key starts with the "pumpObs" prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=9e4e20b body=a0d32c5 -->
     [Test]
         public void Classify_ReturnsPumpObservations_ForKeyStartingWithPumpObs()
         {
@@ -115,6 +122,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Appointments"/> when the cache key starts with the "appointments:patient:" prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8ad1d4a body=138973c -->
     [Test]
         public void Classify_ReturnsAppointments_ForKeyStartingWithAppointmentsPatient()
         {
@@ -131,6 +139,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Appointments"/> when the provided cache key begins with the "appointments:PoC:" segment.
     /// </summary>
+    /// <!-- aidoc:v1 sig=372b44b body=783ce44 -->
     [Test]
         public void Classify_ReturnsAppointments_ForKeyStartingWithAppointmentsPoc()
         {
@@ -149,6 +158,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.GroupedObservations"/> for cache keys that begin with the "groupedObs:" prefix, such as those following the "groupedObs:HR:patient:{id}" pattern.
     /// </summary>
+    /// <!-- aidoc:v1 sig=db0234b body=f719cc7 -->
     [Test]
         public void Classify_ReturnsGroupedObservations_ForKeyStartingWithGroupedObs()
         {
@@ -167,6 +177,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.ConfigObservations"/> when the supplied cache key starts with the <c>configObservations:</c> prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=72d4f5d body=244b707 -->
     [Test]
         public void Classify_ReturnsConfigObservations_ForKeyStartingWithConfigObservations()
         {
@@ -185,6 +196,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that the cache key classifier returns <see cref="CacheEnum.EntityType.Unknown"/> when a key has a prefix that is not recognized.
     /// </summary>
+    /// <!-- aidoc:v1 sig=3a63e58 body=da49c26 -->
     [Test]
         public void Classify_ReturnsUnknown_ForUnrecognizedPrefixDiagnostics()
         {
@@ -201,6 +213,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Unknown"/> when the supplied cache key uses an unrecognized prefix.
     /// </summary>
+    /// <!-- aidoc:v1 sig=b3af5e5 body=b0ec253 -->
     [Test]
         public void Classify_ReturnsUnknown_ForUnrecognizedPrefixRandom()
         {
@@ -219,6 +232,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> returns <see cref="CacheEnum.EntityType.Patients"/> when the cache key is provided in upper case.
     /// </summary>
+    /// <!-- aidoc:v1 sig=77738e5 body=9bf0d62 -->
     [Test]
         public void Classify_ReturnsPatients_ForKeyInUpperCase()
         {
@@ -235,6 +249,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyClassifier.Classify"/> correctly returns the <see cref="CacheEnum.EntityType.Appointments"/> entity type when the supplied cache key contains a mixture of uppercase and lowercase characters, confirming that key classification is case-insensitive.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7902c13 body=b3cc6f8 -->
     [Test]
         public void Classify_ReturnsAppointments_ForKeyInMixedCase()
         {
@@ -253,6 +268,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeyTtl.ResolveForEntity"/> returns <c>null</c> when the global cache is disabled, regardless of the configured entity-specific cache mode and Redis TTL settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c5b16e1 body=08452e0 -->
     [Test]
         public void ResolveForEntity_ReturnsNull_WhenGlobalCacheDisabled()
         {
@@ -278,6 +294,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyTtl.ResolveForEntity"/> returns <c>null</c> for every supported entity type
     /// when caching is globally disabled via <see cref="CacheSettings.IsEnabled"/> set to <c>false</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=8ed737f body=f05fcd5 -->
     [Test]
         public void ResolveForEntity_ReturnsNull_WhenGlobalDisabled_ForAllEntities()
         {
@@ -310,6 +327,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyTtl.ResolveForEntity"/> returns <c>null</c> when the
     /// entity mode is set to <see cref="CacheEnum.Mode.None"/>, regardless of the in-memory TTL configuration.
     /// </summary>
+    /// <!-- aidoc:v1 sig=89b8b65 body=fc6e1ca -->
     [Test]
         public void ResolveForEntity_ReturnsNull_WhenEntityModeIsNone()
         {
@@ -338,6 +356,7 @@ public class CacheKeyClassifierTest
     /// (configured via <c>PatientsSeconds</c>) when the cache mode for the entity is set to
     /// <see cref="CacheEnum.Mode.Cache"/>, instead of falling back to the global TTL.
     /// </summary>
+    /// <!-- aidoc:v1 sig=98497f6 body=3120a51 -->
     [Test]
         public void ResolveForEntity_UsesEntitySpecificTtl_WhenModeIsCache()
         {
@@ -370,6 +389,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyTtl.ResolveForEntity"/> returns the entity-specific Redis TTL (AppointmentsSeconds)
     /// when the cache mode for the entity is set to <see cref="CacheEnum.Mode.Redis"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=86e80e5 body=ce8846d -->
     [Test]
         public void ResolveForEntity_UsesRedisTtl_WhenModeIsRedis()
         {
@@ -401,6 +421,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeyTtl.ResolveForEntity"/> falls back to the globally configured TTL
     /// (in seconds) when no entity-specific TTL is defined for the requested entity type.
     /// </summary>
+    /// <!-- aidoc:v1 sig=157850d body=dd84505 -->
     [Test]
         public void ResolveForEntity_UsesGlobalSeconds_WhenNoEntitySpecificTtl()
         {
@@ -431,6 +452,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <c>CacheKeyTtl.ResolveForEntity</c> returns <c>null</c> when the provided <c>CacheSettings</c> enable caching for the entity but no TTL values are configured (neither <c>GlobalSeconds</c> nor the entity-specific seconds).
     /// </summary>
+    /// <!-- aidoc:v1 sig=e16d5fc body=7d627cf -->
     [Test]
         public void ResolveForEntity_ReturnsNull_WhenNoTtlConfigured()
         {
@@ -461,6 +483,7 @@ public class CacheKeyClassifierTest
     /// and the Appointments mode is set to <see cref="CacheEnum.Mode.Cache"/>.
     /// </summary>
     /// <returns>A <see cref="void"/> method; assertions are used to validate the generated key and TTL values.</returns>
+    /// <!-- aidoc:v1 sig=afa01f3 body=7781a0d -->
     [Test]
         public void PatientAppointmentsTodayKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -491,6 +514,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeys.PocAppointmentsTodayKeyWithTtl"/> generates the expected cache key format
     /// ("appointments:PoC:{pocId}:{yyyyMMdd}") and returns the TTL value configured for point of care entries.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7eb5c8c body=1ba3125 -->
     [Test]
         public void PocAppointmentsTodayKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -520,6 +544,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that <see cref="CacheKeys.LatestObservationsKeyWithTtl"/> generates a deterministic cache key by sorting the supplied field names alphabetically, regardless of their input order.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4aa88c5 body=13534c8 -->
     [Test]
         public void LatestObservationsKeyWithTtl_SortsFieldNamesAlphabetically()
         {
@@ -544,6 +569,7 @@ public class CacheKeyClassifierTest
     /// <summary>
     /// Verifies that the cache key generated by <see cref="CacheKeys.LatestObservationsKeyWithTtl"/> excludes empty strings and null entries from the provided observation types, producing a clean delimiter-separated key for the remaining valid values.
     /// </summary>
+    /// <!-- aidoc:v1 sig=74800d4 body=25a1447 -->
     [Test]
         public void LatestObservationsKeyWithTtl_ExcludesEmptyFields()
         {
@@ -567,6 +593,7 @@ public class CacheKeyClassifierTest
     /// using the "configDisplays:display:{displayId}:base" format and returns the TTL value
     /// configured in the in-memory cache settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=262f298 body=9935dd9 -->
     [Test]
         public void DisplayBaseKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -597,6 +624,7 @@ public class CacheKeyClassifierTest
     /// "configDisplays:display:{displayId}:config" format and that it differs from the base display key
     /// generated by <see cref="CacheKeys.DisplayBaseKeyWithTtl"/>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fc7eeb0 body=28787b3 -->
     [Test]
         public void DisplayWithConfigKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -619,6 +647,7 @@ public class CacheKeyClassifierTest
     /// Verifies that <see cref="CacheKeys.PointOfCareBaseKeyWithTtl"/> generates a cache key with the expected
     /// "pointOfCare:{pocId}:base" format and applies the configured point-of-care TTL in seconds from the in-memory settings.
     /// </summary>
+    /// <!-- aidoc:v1 sig=f70a5a6 body=a971d77 -->
     [Test]
         public void PointOfCareBaseKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -649,6 +678,7 @@ public class CacheKeyClassifierTest
     /// "configObservations:all" consistently regardless of the supplied <see cref="CacheSettings"/>,
     /// including when TTL configuration and enabled state differ from defaults.
     /// </summary>
+    /// <!-- aidoc:v1 sig=617293d body=fd0040a -->
     [Test]
         public void ConfigObservationsAllKeyWithTtl_GeneratesCorrectFormat()
         {
@@ -684,6 +714,7 @@ public class CacheKeyClassifierTest
     /// </summary>
     /// <param name="entity">The entity type under test for which a cache key pattern is requested.</param>
     /// <param name="expectedPattern">The cache key pattern that <see cref="CacheKeyPatterns.ForEntity"/> is expected to return for the given entity type.</param>
+    /// <!-- aidoc:v1 sig=706f531 body=4554e7e -->
     [TestCase(CacheEnum.EntityType.Patients,            "patients:*")]
         [TestCase(CacheEnum.EntityType.Displays,            "displays:*")]
         [TestCase(CacheEnum.EntityType.PumpObservations,    "pumpObs:*")]
@@ -706,6 +737,7 @@ public class CacheKeyClassifierTest
     /// that embeds both the supplied prefix and patient identifier, producing the expected
     /// format of <c>{prefix}:*:{patientId}*</c>.
     /// </summary>
+    /// <!-- aidoc:v1 sig=946de85 body=59ea43e -->
     [Test]
         public void ByPatient_ReturnsPatternContainingPrefixAndPatientId()
         {
@@ -724,6 +756,7 @@ public class CacheKeyClassifierTest
     /// patient-specific pattern built via <c>CacheKeyPatterns.ByPatient</c>, leaving entries
     /// belonging to other patients and unrelated entity types intact, and reports the count of deleted keys.
     /// </summary>
+    /// <!-- aidoc:v1 sig=a914f8e body=de483fe -->
     [Test]
         public async Task ByPatient_DeleteByPatternAsync_OnlyRemovesMatchingPatientKeys()
         {
diff --git a/adas-core.Test/Utilities/TestUtilities.cs b/adas-core.Test/Utilities/TestUtilities.cs
index a71bb86e..463683f2 100644
--- a/adas-core.Test/Utilities/TestUtilities.cs
+++ b/adas-core.Test/Utilities/TestUtilities.cs
@@ -10,12 +10,14 @@ namespace adas_core.Test.Utilities;
 /// <summary>
 /// Provides a collection of utility members to support testing operations and helper functionality.
 /// </summary>
+/// <!-- aidoc:v1 sig=cfa891c -->
 public class TestUtilities
 {
     /// <summary>
     /// Creates and returns a fully populated, valid <see cref="PointOfCare"/> instance with predefined test values, typically used as a helper for unit testing or seeding sample data.
     /// </summary>
     /// <returns>A new <see cref="PointOfCare"/> object initialized with valid identifiers, room and bed information, an available status, a default configuration, and a referenced unit.</returns>
+    /// <!-- aidoc:v1 sig=154b0c7 body=e5193dc -->
     public static PointOfCare CreateValidPointOfCare()
         {
             return new PointOfCare
@@ -36,6 +38,7 @@ public class TestUtilities
     /// Creates a valid <see cref="Discharge"/> instance populated with generated identifiers, current UTC timestamps, and default test values for use in test scenarios.
     /// </summary>
     /// <returns>A fully populated <see cref="Discharge"/> object with all required fields set to valid values.</returns>
+    /// <!-- aidoc:v1 sig=37702fe body=ccb1310 -->
     public static Discharge CreateValidDischarge()
         {
             return new Discharge
@@ -59,6 +62,7 @@ public class TestUtilities
     /// Creates and returns a new <see cref="Patient"/> instance populated with valid test/default values, including a generated identifier, sample patient numbers, admission timestamp, and related option list entries for discharge status, altable, and origin.
     /// </summary>
     /// <returns>A fully initialized <see cref="Patient"/> object suitable for use in testing or seeding scenarios.</returns>
+    /// <!-- aidoc:v1 sig=1ae0cc0 body=cd990fb -->
     public static Patient CreateValidPatient()
         {
             return new Patient
@@ -105,6 +109,7 @@ public class TestUtilities
     /// Creates a new <see cref="OptionList"/> instance populated with predefined valid test values, typically used as a helper for unit tests or test data seeding.
     /// </summary>
     /// <returns>An <see cref="OptionList"/> with sample values, where <c>InitDate</c> is set to the current UTC time and <c>EndDate</c> is set to one day after the current UTC time.</returns>
+    /// <!-- aidoc:v1 sig=800f5e4 body=81a25fa -->
     public static OptionList CreateValidOptionList()
         {
             return new OptionList
@@ -123,6 +128,7 @@ public class TestUtilities
     /// Creates a valid <see cref="PatientLocation"/> instance populated with default test data for use in test scenarios.
     /// </summary>
     /// <returns>A <see cref="PatientLocation"/> with predefined unit name, bed, and room values.</returns>
+    /// <!-- aidoc:v1 sig=c28fe25 body=15ca463 -->
     private static PatientLocation CreateValidPatientLocation()
         {
             return new PatientLocation
@@ -137,6 +143,7 @@ public class TestUtilities
     /// Creates a new <see cref="Unit"/> instance populated with valid default values, typically used for testing or seeding purposes.
     /// </summary>
     /// <returns>A new <see cref="Unit"/> object with a generated unique identifier, default title and name, no last update timestamp, an empty list of point of care IDs, an OK status, and a configuration with auto ADT enabled.</returns>
+    /// <!-- aidoc:v1 sig=ecd91da body=ab80ac1 -->
     public static Unit CreateValidUnit()
         {
             return new Unit
@@ -158,6 +165,7 @@ public class TestUtilities
     /// Creates and returns a valid <see cref="Admission"/> instance populated with sample test data, including generated unique identifiers, a test person, option lists for origin, diagnosis, insulation, language barrier, allergies, and a patient location.
     /// </summary>
     /// <returns>A new <see cref="Admission"/> object fully initialized with valid test values.</returns>
+    /// <!-- aidoc:v1 sig=2ea4b69 body=37f7713 -->
     public static Admission CreateValidAdmission()
         {
             return new Admission
@@ -195,6 +203,7 @@ public class TestUtilities
     /// </summary>
     /// <param name="id">The optional identifier for the configuration. If <c>null</c>, a new <see cref="ObjectId"/> is generated.</param>
     /// <returns>A newly created <see cref="CardConfig"/> populated with the default valid configuration.</returns>
+    /// <!-- aidoc:v1 sig=7d0e8fd body=d62f12a -->
     public static CardConfig CreateValidCardConfig(ObjectId? id = null)
         {
             return new CardConfig
@@ -220,6 +229,7 @@ public class TestUtilities
     /// </summary>
     /// <param name="id">The optional identifier to assign to the configuration. When <c>null</c>, a new <see cref="ObjectId"/> is generated.</param>
     /// <returns>A <see cref="CardDetailsConfig"/> populated with the nurse display configuration.</returns>
+    /// <!-- aidoc:v1 sig=b545d8d body=a2d6d5b -->
     public static CardDetailsConfig CreateValidCardDetailsNurseConfig(ObjectId? id = null)
         {
             return new CardDetailsConfig
@@ -259,6 +269,7 @@ public class TestUtilities
     /// </summary>
     /// <param name="id">The optional identifier to assign to the configuration. When <c>null</c>, a new <see cref="ObjectId"/> is generated.</param>
     /// <returns>A <see cref="CardDetailsConfig"/> configured with a predefined smart section layout.</returns>
+    /// <!-- aidoc:v1 sig=ea55729 body=77525b6 -->
     public static CardDetailsConfig CreateValidCardDetailsSmartConfig(ObjectId? id = null)
         {
             return new CardDetailsConfig
@@ -301,6 +312,7 @@ public class TestUtilities
     /// <param name="idCard">The optional card config identifier. A new <see cref="ObjectId"/> is generated when <c>null</c>.</param>
     /// <param name="idDetail">The optional detail config identifier. A new <see cref="ObjectId"/> is generated when <c>null</c>.</param>
     /// <returns>A fully populated <see cref="DisplayConfig"/> with default field and hospital values.</returns>
+    /// <!-- aidoc:v1 sig=8e7f94f body=bd71343 -->
     public static DisplayConfig CreateValidDisplayConfig(DisplayConfigEnums.DisplayType type, ObjectId? id,
             ObjectId? idCard, ObjectId? idDetail)
         {
diff --git a/adas-core.module.LightBeacons/Devices/LightBeacon.cs b/adas-core.module.LightBeacons/Devices/LightBeacon.cs
index faab067e..1c97d860 100644
--- a/adas-core.module.LightBeacons/Devices/LightBeacon.cs
+++ b/adas-core.module.LightBeacons/Devices/LightBeacon.cs
@@ -8,6 +8,7 @@ namespace adas_core.module.LightBeacons.Devices;
 /// The specific implementation of these methods will depend on the type of light beacon being used and the requirements of the application.
 /// </summary>
 /// <param name="options">A dictionary containing configuration options for the light beacon. This can include settings such as the beacon's IP address, port number, color configurations, and other relevant parameters.</param>
+/// <!-- aidoc:v1 sig=f70cccd -->
 public abstract class LightBeacon(EquatableDictionary<string, object> options)
 {
     /// <summary>
@@ -19,24 +20,28 @@ public abstract class LightBeacon(EquatableDictionary<string, object> options)
     /// Turns the light beacon blue. This method should be implemented to control the beacon's hardware or software interface to change its color to blue.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=2fdc9f9 -->
     public abstract Task BlueCode();
 
     /// <summary>
     /// Turns the light beacon red. This method should be implemented to control the beacon's hardware or software interface to change its color to red.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=8664798 -->
     public abstract Task RedCode();
 
     /// <summary>
     /// Turns the light beacon yellow. This method should be implemented to control the beacon's hardware or software interface to change its color to yellow.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=7741a6b -->
     public abstract Task YellowCode();
 
     /// <summary>
     /// Turns off the light beacon. This method should be implemented to control the beacon's hardware or software interface to turn off the light, regardless of its current color.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=a171807 -->
     public abstract Task PowerOffLed();
 
     /// <summary>
@@ -45,11 +50,13 @@ public abstract class LightBeacon(EquatableDictionary<string, object> options)
     /// </summary>
     /// <param name="obs">The patient observation used to determine the appropriate color alert.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=a91a8f7 -->
     public abstract Task GenerateColorAlert(PatientObservation obs);
 
     /// <summary>
     /// Retrieves the current color of the light beacon. This method should be implemented to query the beacon's hardware or software interface to determine its current color state and return it as a value from the LightBeaconColor enumeration.
     /// </summary>
     /// <returns>A task representing the asynchronous operation, with a result of the current color of the light beacon.</returns>
+    /// <!-- aidoc:v1 sig=e132b45 -->
     public abstract Task<Domain.Enums.LightBeaconColor> GetBeaconColor();
 }
\ No newline at end of file
diff --git a/adas-core.module.LightBeacons/Devices/LightBeaconAbstract.cs b/adas-core.module.LightBeacons/Devices/LightBeaconAbstract.cs
index ef8e89fc..d41c7354 100644
--- a/adas-core.module.LightBeacons/Devices/LightBeaconAbstract.cs
+++ b/adas-core.module.LightBeacons/Devices/LightBeaconAbstract.cs
@@ -7,6 +7,7 @@ namespace adas_core.module.LightBeacons.Devices;
 /// </summary>
 /// <param name="host">The host address of the LightBeacon device. This is typically the IP address or hostname used to connect to the device for controlling its LED states.</param>
 /// <param name="password">The password used for authenticating with the LightBeacon device. This is required to establish a connection and control the device's LED states securely.</param>
+/// <!-- aidoc:v1 sig=d775c30 -->
 public abstract class LightBeaconAbstract(string host, string password)
 {
     /// <summary>
@@ -23,24 +24,28 @@ public abstract class LightBeaconAbstract(string host, string password)
     /// Abstract method to set the LightBeacon device to Code Blue state. This method should be implemented by each specific LightBeacon model to control the LED state accordingly.
     /// </summary> 
     /// <param name="entry">An object parameter that can be used to pass additional information or context needed for setting the LED state.</param>
+    /// <!-- aidoc:v1 sig=0d7f136 -->
     public abstract void CodeBlue(object entry);
 
     /// <summary>
     /// Abstract method to set the LightBeacon device to Code Red state. This method should be implemented by each specific LightBeacon model to control the LED state accordingly.
     /// </summary>
     /// <param name="entry">An object parameter that can be used to pass additional information or context needed for setting the LED state.</param>
+    /// <!-- aidoc:v1 sig=f600697 -->
     public abstract void CodeRed(object entry);
 
     /// <summary>
     /// Abstract method to set the LightBeacon device to Code Yellow state. This method should be implemented by each specific LightBeacon model to control the LED state accordingly.
     /// </summary>
     /// <param name="entry">An object parameter that can be used to pass additional information or context needed for setting the LED state.</param>
+    /// <!-- aidoc:v1 sig=2ed3bae -->
     public abstract void CodeYellow(object entry);
 
     /// <summary>
     /// Abstract method to power off the LED of the LightBeacon device. This method should be implemented by each specific LightBeacon model to control the LED state accordingly.
     /// </summary>
     /// <param name="entry">An object parameter that can be used to pass additional information or context needed for setting the LED state.</param>
+    /// <!-- aidoc:v1 sig=70c2fef -->
     public abstract void PowerOffLed(object entry);
 
     /// <summary>
@@ -51,6 +56,7 @@ public abstract class LightBeaconAbstract(string host, string password)
     /// <param name="host">The host address of the LightBeacon device.</param>
     /// <param name="password">The password for authenticating with the LightBeacon device.</param>
     /// <returns>An instance of the specific LightBeacon device, or null if the driver class is not found or cannot be instantiated.</returns>
+    /// <!-- aidoc:v1 sig=93cfab7 body=2607338 -->
     public static LightBeaconAbstract? GetBeaconDevice(string driver, string host, string password)
     {
         var modelType = Type.GetType($"adas_core.Drivers.LightBeacon.{driver}");
diff --git a/adas-core.module.LightBeacons/Devices/Turktbens2LightBeacon.cs b/adas-core.module.LightBeacons/Devices/Turktbens2LightBeacon.cs
index 02cc2c30..56a48a3a 100644
--- a/adas-core.module.LightBeacons/Devices/Turktbens2LightBeacon.cs
+++ b/adas-core.module.LightBeacons/Devices/Turktbens2LightBeacon.cs
@@ -10,6 +10,7 @@ namespace adas_core.module.LightBeacons.Devices;
 ///   This class represents a light beacon device that can be controlled via HTTP requests. It retrieves the current color of the beacon by parsing HTML pages and sends commands to change the beacon's color. 
 ///   The class includes error handling and retry logic for network operations, and it can be configured to emulate the beacon for testing purposes.
 /// </summary>
+/// <!-- aidoc:v1 sig=483377a -->
 public class Turktbens2LightBeacon : LightBeacon
 {
     /// <summary>
@@ -81,6 +82,7 @@ public class Turktbens2LightBeacon : LightBeacon
     /// </summary>
     /// <param name="options">A dictionary containing the configuration options for the beacon.</param>
     /// <exception cref="ArgumentException">Thrown when required options are missing or invalid.</exception>
+    /// <!-- aidoc:v1 sig=e320a8e body=1b6dc81 -->
     public Turktbens2LightBeacon(EquatableDictionary<string, object> options) : base(options)
     {
         _logger = Log.ForContext<Turktbens2LightBeacon>();
@@ -108,6 +110,10 @@ public class Turktbens2LightBeacon : LightBeacon
     ///     returns OFF when some error appears or try to parse the bits to BalizaColors enum
     /// </summary>
     /// <returns>The current color of the beacon as a LightBeaconColor enum value.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary contains leftover template placeholder 'GetByCodeSysAndCode' at the start, which is not meaningful in this context." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'BalizaColors' enum, but the code uses 'LightBeaconColor' (also confirmed by the <returns> tag)." -->
     public override async Task<LightBeaconColor> GetBeaconColor()
     {
         if (_emulate)
@@ -194,6 +200,7 @@ public class Turktbens2LightBeacon : LightBeacon
     ///   If an error occurs, it logs the error message and rethrows the exception to be handled by the caller.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=18624ee body=9cbaa1f -->
     public override async Task BlueCode()
     {
         try
@@ -211,6 +218,7 @@ public class Turktbens2LightBeacon : LightBeacon
     ///  The RedCode method sends a command to the beacon's web interface to change the beacon's color to red.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=a28d324 body=00b8012 -->
     public override async Task RedCode()
     {
         try
@@ -228,6 +236,7 @@ public class Turktbens2LightBeacon : LightBeacon
     /// The YellowCode method sends a command to the beacon's web interface to change the beacon's color to yellow.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=5e4bc69 body=34c7285 -->
     public override async Task YellowCode()
     {
         try
@@ -245,6 +254,10 @@ public class Turktbens2LightBeacon : LightBeacon
     /// The GreenCode method sends a command to the beacon's web interface to change the beacon's color to green.
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation describes a 'GreenCode' method that changes the beacon's color to green, but the actual method is PowerOffLed that sends an off code." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Documentation references a GreenCode behavior (changing color to green) that the code does not implement." -->
     public override async Task PowerOffLed()
     {
         try
@@ -264,6 +277,7 @@ public class Turktbens2LightBeacon : LightBeacon
     /// <param name="obs">The patient observation based on which the color alert should be generated.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="NotImplementedException"></exception>
+    /// <!-- aidoc:v1 sig=7b58387 body=bfa6f2f -->
     public override Task GenerateColorAlert(PatientObservation obs)
     {
         throw new NotImplementedException();
@@ -274,6 +288,7 @@ public class Turktbens2LightBeacon : LightBeacon
     /// </summary>
     /// <param name="colorCodes">The color code to be sent to the beacon.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=9c8fbe5 body=e3eb8e4 -->
     private async Task Send(ColorsCodes colorCodes)
     {
         var clr = ((int)colorCodes).ToString().PadLeft(3, '0');
@@ -306,6 +321,8 @@ public class Turktbens2LightBeacon : LightBeacon
     /// <param name="body">The body parameters to be sent in the HTTP POST request.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="InvalidOperationException"></exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary describes the method as 'private' but it is declared as 'protected'." -->
     protected async Task SendMessage(Dictionary<string, string> body)
     {
         if (string.IsNullOrEmpty(_url)) throw new InvalidOperationException("URL is not set.");
diff --git a/adas-core.module.LightBeacons/Services/LightBeaconService.cs b/adas-core.module.LightBeacons/Services/LightBeaconService.cs
index 13cc20fc..7e42350f 100644
--- a/adas-core.module.LightBeacons/Services/LightBeaconService.cs
+++ b/adas-core.module.LightBeacons/Services/LightBeaconService.cs
@@ -24,6 +24,7 @@ namespace adas_core.module.LightBeacons.Services;
 /// It interacts with the point of care service to determine which beacons are associated with specific locations and maintains an in-memory cache of the current color state of each location's beacon. 
 /// The service also handles CRUD operations for light beacon configurations stored in a MongoDB repository.
 /// </summary>
+/// <!-- aidoc:v1 sig=3a68be9 -->
 public class LightBeaconService : ILightBeaconService
 {
     private readonly IClientMessageService _clientMessageService;
@@ -44,6 +45,7 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="subscribersService">The subscribers service for managing subscribers.</param>
     /// <param name="pointOfCareService">The point of care service for retrieving point of care information.</param>
     /// <param name="lightBeaconRepository">The light beacon repository for managing light beacon data.</param>
+    /// <!-- aidoc:v1 sig=9216b6b body=faa90fc -->
     public LightBeaconService(
         IOptions<ApiSettings> apiSettings,
         ILogger<LightBeaconService> logger,
@@ -82,6 +84,10 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="pocId">The ID of the point of care for which to power off the LED.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation claims the method 'checks if there are any associated beacons' and 'sends a command to turn off the LED for each associated beacon', but the code only checks if the POC is null and calls PowerOffLed(poc) once." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation claims the method 'updates the in-memory cache to reflect that the beacon is now off for the specified location', but there is no cache update visible in the code." -->
     public async Task PowerOffLed(ObjectId pocId)
     {
         var poc = await _pointOfCareService.FindById(pocId);
@@ -100,6 +106,7 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="beacon">The light beacon configuration to insert.</param>
     /// <returns>The inserted light beacon configuration, or null if the insertion failed.</returns>
     /// <exception cref="Exception">Thrown if a light beacon with the same name already exists.</exception>
+    /// <!-- aidoc:v1 sig=1e12f08 body=64da6ee -->
     public async Task<LightBeacon?> InsertOne(LightBeacon beacon)
     {
         var beaconFound = await _lightBeaconRepository.GetByName(beacon.Name);
@@ -113,6 +120,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="filter">The pagination filter to apply when retrieving the light beacons.</param>
     /// <returns>A paginated response containing the light beacons that match the specified filter.</returns>
+    /// <!-- aidoc:v1 sig=415719d body=b8cd5a5 -->
     public async Task<PaginationResponse<LightBeacon>> GetPaginatedBeacons(PaginationFilter filter)
     {
         var usedRelayIds = await _pointOfCareService.FindAllIdBeaconsInUse();
@@ -158,6 +166,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="textToSearch">The text to search for in the names of the light beacons.</param>
     /// <returns>A list of light beacons whose names contain the specified search text.</returns>
+    /// <!-- aidoc:v1 sig=31a792d body=850cd31 -->
     public async Task<List<LightBeacon>> GetSearchByName(string textToSearch)
     {
         return await _lightBeaconRepository.GetSearchByName(textToSearch);
@@ -169,6 +178,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="beacon">The light beacon object with updated properties.</param>
     /// <returns>The updated light beacon configuration, or null if the update failed.</returns>
+    /// <!-- aidoc:v1 sig=44d83e6 body=0b996e1 -->
     public async Task<LightBeacon?> UpdateOne(LightBeacon beacon)
     {
         await _lightBeaconRepository.UpdateOneAsync(beacon.Id, beacon);
@@ -181,6 +191,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="poc">The point of care for which to power off the LED.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=3da8578 body=b74440d -->
     public async Task PowerOffLed(PointOfCare poc)
     {
         if (_locationsWithColor.TryGetValue(poc.Id, out var lightBeaconColor) &&
@@ -209,6 +220,7 @@ public class LightBeaconService : ILightBeaconService
     /// Generates a color alert for a patient observation by determining the appropriate color based on the observation's status and configured colors for warnings and alerts.
     /// </summary>
     /// <param name="obs">The patient observation for which to generate the color alert.</param>
+    /// <!-- aidoc:v1 sig=c0724e7 body=242d283 -->
     public void GenerateColorAlert(PatientObservation obs)
     {
         try
@@ -294,6 +306,8 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="pocId">The ID of the point of care for which to send the color command.</param>
     /// <param name="color">The color to set on the light beacon.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation claims the method checks for associated beacons and sends a color command for each associated beacon, but the code only checks if the point of care is null and calls a single SendColor overload without any beacon check or iteration." -->
     public async Task SendColor(ObjectId pocId, LightBeaconColor color)
     {
         var poc = await _pointOfCareService.FindById(pocId);
@@ -308,6 +322,7 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="poc">The point of care for which to send the color command.</param>
     /// <param name="color">The color to set on the light beacon.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=5217200 body=5ad71ce -->
     public async Task SendColor(PointOfCare poc, LightBeaconColor color)
     {
         try
@@ -361,6 +376,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="pocId">The ID of the point of care for which to retrieve the color state.</param>
     /// <returns>A task representing the asynchronous operation, with the current color state of the light beacon.</returns>
+    /// <!-- aidoc:v1 sig=e927281 body=f729d62 -->
     public async Task<LightBeaconColor> GetColor(ObjectId pocId)
     {
         var poc = await _pointOfCareService.FindById(pocId);
@@ -373,6 +389,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="poc">The point of care for which to retrieve the color state.</param>
     /// <returns>A task representing the asynchronous operation, with the current color state of the light beacon.</returns>
+    /// <!-- aidoc:v1 sig=9ff58e8 body=3531e3b -->
     public async Task<LightBeaconColor> GetColor(PointOfCare poc)
     {
         try
@@ -403,6 +420,7 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="poc">The point of care for which to send the color command.</param>
     /// <param name="color">The color to set on the light beacon.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=e30390e body=ebb3633 -->
     public async Task SendBeaconBroadcast(PointOfCare poc, LightBeaconColor color)
     {
         var subscribers = _subscribersService.GetSubscribers()
@@ -420,6 +438,7 @@ public class LightBeaconService : ILightBeaconService
     /// <param name="pocId">The ID of the point of care for which to send the color command.</param>
     /// <param name="color">The color to set on the light beacon.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=e72960d body=fd03c04 -->
     public async Task SendBeaconBroadcast(ObjectId pocId, LightBeaconColor color)
     {
         var poc = await _pointOfCareService.FindById(pocId);
@@ -433,6 +452,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="body">The body of the message to send.</param>
     /// <returns>A task representing the asynchronous operation.</returns>
+    /// <!-- aidoc:v1 sig=df9f7f5 body=365678a -->
     private async Task SendMessage(string body)
     {
         if (string.IsNullOrEmpty(Url))
@@ -465,6 +485,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="lightBeaconId">The ID of the light beacon to retrieve.</param>
     /// <returns>A task representing the asynchronous operation, with a result of the light beacon device instance if found; otherwise, null.</returns>
+    /// <!-- aidoc:v1 sig=f305e9f body=070796e -->
     private async Task<LightBeaconDevice?> GetBeacon(ObjectId lightBeaconId)
     {
         var cfg = await _lightBeaconRepository.GetById(lightBeaconId);
@@ -491,6 +512,7 @@ public class LightBeaconService : ILightBeaconService
     /// </summary>
     /// <param name="dictionary"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=ee90706 body=21dd886 -->
     public static string DictionaryToString(ConcurrentDictionary<ObjectId, LightBeaconColor> dictionary)
     {
         var builder = new StringBuilder();
diff --git a/adas-core.module.ProxyDevices/Devices/HttpDevice.cs b/adas-core.module.ProxyDevices/Devices/HttpDevice.cs
index 9377a940..b06999c1 100644
--- a/adas-core.module.ProxyDevices/Devices/HttpDevice.cs
+++ b/adas-core.module.ProxyDevices/Devices/HttpDevice.cs
@@ -6,6 +6,7 @@ namespace adas_core.module.ProxyDevices.Devices;
 /// <summary>
 /// Device that can be used to get content via http with digest auth
 /// </summary>
+/// <!-- aidoc:v1 sig=6b29da8 -->
 public class HttpDevice : IProxyDevice
 {
     /// <summary>
@@ -46,6 +47,7 @@ public class HttpDevice : IProxyDevice
     /// <param name="deviceParameters">A dictionary containing the parameters required to initialize the device.</param>
     /// <exception cref="InvalidOperationException">Thrown when the device is already initialized.</exception>
     /// <exception cref="ArgumentNullException">Thrown when a required parameter is missing or invalid.</exception>
+    /// <!-- aidoc:v1 sig=cc2f188 body=492cad9 -->
     public void Initialize(Dictionary<string, object?> deviceParameters)
     {
         if (_isInitialized) throw new InvalidOperationException("Device already initialized");
@@ -68,6 +70,7 @@ public class HttpDevice : IProxyDevice
     /// </summary>
     /// <returns>An HttpResponseMessage representing the response from the HTTP request.</returns>
     /// <exception cref="TimeoutException">Thrown when the request times out.</exception>
+    /// <!-- aidoc:v1 sig=0a36db0 body=b4557da -->
     public async Task<HttpResponseMessage> Process()
     {
         try
@@ -89,6 +92,7 @@ public class HttpDevice : IProxyDevice
     /// </summary>
     /// <returns>An HttpResponseMessage representing the response from the HTTP request.</returns>
     /// <exception cref="TimeoutException">Thrown when the request times out.</exception>
+    /// <!-- aidoc:v1 sig=457d0fb body=be43e89 -->
     public async Task<HttpResponseMessage> Stream()
     {
         try
@@ -110,6 +114,7 @@ public class HttpDevice : IProxyDevice
     /// </summary>
     /// <returns>An HttpClient instance configured with the appropriate credentials.</returns>
     /// <exception cref="InvalidOperationException">Thrown when the device is not initialized.</exception>
+    /// <!-- aidoc:v1 sig=f389022 body=9ab96aa -->
     private HttpClient GetHttpClient()
     {
         if (!_isInitialized) throw new InvalidOperationException("Device not initialized");
@@ -124,6 +129,7 @@ public class HttpDevice : IProxyDevice
     /// Returns a string representation of the HttpDevice instance, including its name, URI, username, password, and domain. This can be useful for logging or debugging purposes to quickly identify the configuration of the device.
     /// </summary>
     /// <returns>A string representation of the HttpDevice instance.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=ba2b91d -->
     public override string ToString()
     {
         return $"[HttpDevice] ({_name} {_uri} {_username} {_password} {_domain})";
diff --git a/adas-core.module.ProxyDevices/Devices/IProxyDevice.cs b/adas-core.module.ProxyDevices/Devices/IProxyDevice.cs
index f39f059f..9cf80ea2 100644
--- a/adas-core.module.ProxyDevices/Devices/IProxyDevice.cs
+++ b/adas-core.module.ProxyDevices/Devices/IProxyDevice.cs
@@ -11,17 +11,21 @@ public interface IProxyDevice
     /// The parameters can include any necessary configuration settings for the device, such as connection details, authentication information, or other relevant data.
     /// </summary>
     /// <param name="deviceParameters">A dictionary containing the parameters required to initialize the device.</param>
+    /// <!-- aidoc:v1 sig=f89923c -->
     void Initialize(Dictionary<string, object?> deviceParameters);
 
     /// <summary>
     /// Processes the data received by the proxy device. This method should contain the logic for handling incoming data, performing any necessary transformations or computations, and preparing the data for further use.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Process method.</returns>
+    /// <!-- aidoc:v1 sig=6f73799 -->
     Task<HttpResponseMessage> Process();
 
     /// <summary>
     /// Streams data from the proxy device. This method should contain the logic for handling outgoing data, performing any necessary transformations or computations, and preparing the data for further use.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Stream method.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "The second sentence ('This method should contain the logic for handling outgoing data, performing any necessary transformations or computations, and preparing the data for further use.') is template/placeholder text describing what an implementation should contain, not what the method actually does. The code is just a method signature with no body, and there is no evidence it specifically handles 'outgoing data' or performs 'transformations or computations'." -->
     Task<HttpResponseMessage> Stream();
 }
\ No newline at end of file
diff --git a/adas-core.module.ProxyDevices/ProxyDeviceSettings.cs b/adas-core.module.ProxyDevices/ProxyDeviceSettings.cs
index 03adc853..2e372e07 100644
--- a/adas-core.module.ProxyDevices/ProxyDeviceSettings.cs
+++ b/adas-core.module.ProxyDevices/ProxyDeviceSettings.cs
@@ -4,6 +4,8 @@
 /// Represents the settings for proxy devices, which are used to define and manage virtual devices that can be used for testing, simulation, or other purposes within the ADAS (Advanced Driver Assistance Systems) core module. 
 /// Each proxy device can have its own unique identifier, type, enabled status, and a set of parameters that can be customized as needed.
 /// </summary>
+/// <!-- aidoc:v1 sig=35d0e43 -->
+/// <!-- aidoc:v1 sig=c03ae6e -->
 public class ProxyDeviceSettings : List<ProxyDevice>
 {
 }
diff --git a/adas-core.module.ProxyDevices/Services/IProxyDeviceService.cs b/adas-core.module.ProxyDevices/Services/IProxyDeviceService.cs
index 51e1ad7c..03cd2cac 100644
--- a/adas-core.module.ProxyDevices/Services/IProxyDeviceService.cs
+++ b/adas-core.module.ProxyDevices/Services/IProxyDeviceService.cs
@@ -10,6 +10,8 @@ public interface IProxyDeviceService
     /// </summary>
     /// <param name="deviceId">The unique identifier of the proxy device to be processed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Process method.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary is truncated mid-sentence ('This method is responsible for handling') and does not complete the description of the method's behavior." -->
     Task<HttpResponseMessage> Process(string deviceId);
 
     /// <summary>
@@ -17,5 +19,6 @@ public interface IProxyDeviceService
     /// </summary>
     /// <param name="deviceId">The unique identifier of the proxy device to be streamed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Stream method.</returns>
+    /// <!-- aidoc:v1 sig=d395251 -->
     Task<HttpResponseMessage> Stream(string deviceId);
 }
\ No newline at end of file
diff --git a/adas-core.module.ProxyDevices/Services/ProxyDeviceService.cs b/adas-core.module.ProxyDevices/Services/ProxyDeviceService.cs
index c49334c1..5af102d0 100644
--- a/adas-core.module.ProxyDevices/Services/ProxyDeviceService.cs
+++ b/adas-core.module.ProxyDevices/Services/ProxyDeviceService.cs
@@ -10,6 +10,7 @@ namespace adas_core.module.ProxyDevices.Services;
 /// The service handles HTTP requests and returns appropriate responses based on the device's availability and functionality.
 /// </summary>
 /// <param name="settings">The settings for the proxy devices, including their configuration and parameters.</param>
+/// <!-- aidoc:v1 sig=f2b6616 -->
 public class ProxyDeviceService(IOptions<ProxyDeviceSettings> settings) : IProxyDeviceService
 {
     /// <summary>
@@ -23,6 +24,8 @@ public class ProxyDeviceService(IOptions<ProxyDeviceSettings> settings) : IProxy
     /// </summary>
     /// <param name="deviceId">The unique identifier of the proxy device to be processed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Process method.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the method 'creates a new instance if it doesn't exist', but the code only returns a NotFound HttpResponseMessage when GetDevice returns null; no instance is ever created." -->
     public async Task<HttpResponseMessage> Process(string deviceId)
     {
         try
@@ -45,6 +48,8 @@ public class ProxyDeviceService(IOptions<ProxyDeviceSettings> settings) : IProxy
     /// </summary>
     /// <param name="deviceId">The unique identifier of the proxy device to be streamed.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the HttpResponseMessage returned by the device's Stream method.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'creates a new instance if [the device] doesn't exist', but the code only calls GetDevice(deviceId) and returns NotFound when the result is null, with no creation logic visible." -->
     public async Task<HttpResponseMessage> Stream(string deviceId)
     {
         try
@@ -68,6 +73,10 @@ public class ProxyDeviceService(IOptions<ProxyDeviceSettings> settings) : IProxy
     /// <param name="deviceId">The unique identifier of the proxy device to be retrieved.</param>
     /// <returns>The proxy device instance corresponding to the given deviceId.</returns>
     /// <exception cref="HttpRequestException">Thrown when the device is not found or not enabled.</exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "HttpRequestException is also thrown with HttpStatusCode.NotImplemented when the device type cannot be resolved via Type.GetType; the documentation only documents the 'not found or not enabled' case." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "The return type is IProxyDevice? and the method can return null (e.g., when Activator.CreateInstance produces an instance that is not IProxyDevice), but the documentation describes it simply as 'The proxy device instance'." -->
     private IProxyDevice? GetDevice(string deviceId)
     {
         var device = settings.Value.FirstOrDefault(d => d.Id == deviceId);
diff --git a/adas-core.module.Relays/Devices/FakeRelay.cs b/adas-core.module.Relays/Devices/FakeRelay.cs
index 4e5825ba..a8d0fc1d 100644
--- a/adas-core.module.Relays/Devices/FakeRelay.cs
+++ b/adas-core.module.Relays/Devices/FakeRelay.cs
@@ -10,6 +10,7 @@ namespace adas_core.module.Relays.Devices;
 /// </summary>
 /// <param name="relay">The Relay object representing the relay device.</param>
 /// <param name="relaySettings">The RelaySettings object containing the configuration settings for the relay device.</param>
+/// <!-- aidoc:v1 sig=a63ae6e -->
 internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice(relay, relaySettings)
 {
     /// <summary>
@@ -17,6 +18,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// In a real implementation, this method would contain logic to check the actual status of the hardware device.
     /// </summary>
     /// <returns>True if the device is functioning properly, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=20f7821 body=eb3da57 -->
     public override bool CheckDevice()
     {
         return true;
@@ -26,6 +28,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Gets the status of the fake relay device. Since this is a simulated device, it always returns true, indicating that the device is on.
     /// </summary>
     /// <returns>True if the device is on, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=351e317 body=eb3da57 -->
     public override bool GetStatusRelay()
     {
         return true;
@@ -36,6 +39,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// In a real implementation, this method would contain logic to send a command to the hardware device to power off the specified outlet.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to power off</param>
+    /// <!-- aidoc:v1 sig=df0a638 body=4448e1d -->
     public override void PowerOffRelay(int outletId)
     {
     }
@@ -44,6 +48,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Powers on the relay for the specified outlet ID. Since this is a simulated device, this method does not perform any actual operations.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to power on.</param>
+    /// <!-- aidoc:v1 sig=a106116 body=4448e1d -->
     public override void PowerOnRelay(int outletId)
     {
     }
@@ -51,6 +56,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// <summary>
     /// Powers off all relays. Since this is a simulated device, this method does not perform any actual operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bfcd3b2 body=4448e1d -->
     public override void PowerOffAll()
     {
     }
@@ -58,6 +64,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// <summary>
     /// Powers on all relays. Since this is a simulated device, this method does not perform any actual operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c24d19e body=4448e1d -->
     public override void PowerOnAll()
     {
     }
@@ -67,6 +74,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// </summary>
     /// <param name="outletId">The ID of the outlet to get the status for.</param>
     /// <returns>The status of the specified outlet.</returns>
+    /// <!-- aidoc:v1 sig=2d49b50 body=6d71a28 -->
     public override RelayEnum.Status GetStatusRelay(int outletId)
     {
         const string status = "00000000";
@@ -79,6 +87,7 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Reboots the relay for the specified outlet ID. Since this is a simulated device, this method does not perform any actual operations.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to reboot.</param>
+    /// <!-- aidoc:v1 sig=1edae69 body=4448e1d -->
     public override void RebootOutlet(int outletId)
     {
     }
@@ -87,6 +96,8 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Reboots all relays. Since this is a simulated device, this method does not perform any actual operations. 
     /// However, it includes a delay based on the RebootDelay property of the Relay object to simulate the time taken for a reboot process.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states 'this method does not perform any actual operations', but the code clearly performs operations by calling PowerOffAll(), optionally Thread.Sleep(Relay.RebootDelay), and PowerOnAll()." -->
     public override void Reboot()
     {
         PowerOffAll();
@@ -98,6 +109,14 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Asynchronously gets the status of the relay for the specified outlet ID. Since this is a simulated device, it returns a hardcoded status string "00000000", which indicates that all outlets are off.
     /// </summary>
     /// <returns>A task that represents the asynchronous operation. The task result contains the status of the specified outlet.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documents returning a hardcoded string '00000000' but the method actually returns a boolean true via Task.FromResult(true)" -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns tag says task result contains 'the status of the specified outlet' (implied string), but the method returns Task<bool> with value true" -->
+    /// <!-- aidoc-review:v1 severity=high kind=extra_param
+    ///      "Summary references 'the specified outlet ID' but the method takes no parameters" -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "Describes returning an 8-character status string indicating all outlets are off, which is not present in the code" -->
     public override Task<bool> GetStatusRelayAsync()
     {
         return Task.FromResult(true);
@@ -107,6 +126,12 @@ internal class FakeRelay(Relay relay, RelaySettings relaySettings) : RelayDevice
     /// Asynchronously gets the status of the relay for the specified outlet ID. 
     /// Since this is a simulated device, it returns a hardcoded status string "00000000", which indicates that all outlets are off.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documents async status retrieval and returning a hardcoded string, but the method is void with an empty body" -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Summary says it returns a status string, but the method return type is void" -->
+    /// <!-- aidoc-review:v1 severity=high kind=extra_param
+    ///      "References 'the specified outlet ID' but the method has no parameters" -->
     public override void CheckStatus()
     {
     }
diff --git a/adas-core.module.Relays/Devices/KMTronicRelay.cs b/adas-core.module.Relays/Devices/KMTronicRelay.cs
index 12ae6a44..983590ba 100644
--- a/adas-core.module.Relays/Devices/KMTronicRelay.cs
+++ b/adas-core.module.Relays/Devices/KMTronicRelay.cs
@@ -12,6 +12,7 @@ namespace adas_core.module.Relays.Devices;
 /// </summary>
 /// <param name="relay">The Relay object representing the relay device.</param>
 /// <param name="relaySettings">The RelaySettings object containing the configuration settings for the relay device.</param>
+/// <!-- aidoc:v1 sig=0480f2b -->
 public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     : RelayDevice(relay, relaySettings)
 {
@@ -30,6 +31,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// If the response indicates that the status is unknown, it returns false, indicating that the device is not reachable or not responding correctly. Otherwise, it returns true, indicating that the device is online and responsive.
     /// </summary>
     /// <returns>True if the device is online and responsive, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=20f7821 body=470606e -->
     public override bool CheckDevice()
     {
         CheckStatus();
@@ -42,6 +44,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// If the response is null or empty, it indicates that the device is not reachable or not responding correctly, and it returns false. Otherwise, it returns true, indicating that the device is online and responsive.
     /// </summary>
     /// <returns>True if the device is online and responsive, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=351e317 body=526bfc0 -->
     public override bool GetStatusRelay()
     {
         var status = Send("FF0000");
@@ -60,6 +63,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// </summary>
     /// <param name="outletId">The ID of the outlet to retrieve the status for.</param>
     /// <returns>The status of the specified outlet.</returns>
+    /// <!-- aidoc:v1 sig=2d49b50 body=d2e7365 -->
     public override RelayEnum.Status GetStatusRelay(int outletId)
     {
         var status = Send("FF0000");
@@ -102,6 +106,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// Powers off a specific outlet on the KMTronic relay device by sending a command to either open or close the relay, depending on the configured mode.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to power off.</param>
+    /// <!-- aidoc:v1 sig=df0a638 body=d1228ed -->
     public override void PowerOffRelay(int outletId)
     {
         if (Relay.Mode == RelayEnum.Mode.OpenedOffClosedOn) OpenRelay(outletId);
@@ -112,6 +117,10 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// Powers on a specific outlet on the KMTronic relay device by sending a command to either open or close the relay, depending on the configured mode.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to power on.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says 'Powers on' a specific outlet, but the method is OpenRelay and the inline comment confirms it cuts current ('corta la corriente'), i.e., it powers the outlet off, not on." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the command is sent 'depending on the configured mode' (open or close), but the code unconditionally sends a fixed 'FF0{outletId}01' command with no mode-based branching." -->
     public void OpenRelay(int outletId)
     {
         //Activa el relé por lo que corta la corriente del dispositivo conectado
@@ -122,6 +131,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// Powers on a specific outlet on the KMTronic relay device by sending a command to either open or close the relay, depending on the configured mode.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to power on.</param>
+    /// <!-- aidoc:v1 sig=a106116 body=4891d13 -->
     public override void PowerOnRelay(int outletId)
     {
         if (Relay.Mode == RelayEnum.Mode.OpenedOffClosedOn) CloseRelay(outletId);
@@ -133,6 +143,8 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// This method is used to power on the outlet by allowing the current to flow through it.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to close.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the command is sent 'depending on the configured mode', but the code unconditionally sends a fixed command 'FF0{outletId}00' with no mode-based branching." -->
     public void CloseRelay(int outletId)
     {
         //Desactiva el relé por lo que deja pasar la corriente del dispositivo conectado
@@ -143,6 +155,8 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// <summary>
     /// Powers off all outlets on the KMTronic relay device by sending a command to either open or close all relays, depending on the configured mode.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Documentation states the method sends 'a command to either open or close all relays, depending on the configured mode', but the code unconditionally sends a single fixed command 'FFE0FF' with no mode-based branching visible in this override." -->
     public override void PowerOffAll()
     {
         //Activa el relé por lo que corta la corriente de todos los dispositivo conectados
@@ -152,6 +166,8 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// <summary>
     /// Powers on all outlets on the KMTronic relay device by sending a command to either open or close all relays, depending on the configured mode.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the command sent depends on a 'configured mode' (open vs. close relays), but the code unconditionally sends a single fixed command 'FFE000' with no mode-based branching." -->
     public override void PowerOnAll()
     {
         //Desactiva el relé por lo que deja pasar la corriente a todos dispositivo conectados
@@ -161,6 +177,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// <summary>
     /// Checks the status of the KMTronic relay device by calling the GetStatusRelay method and updating the DeviceStatus property accordingly.
     /// </summary>
+    /// <!-- aidoc:v1 sig=abdef98 body=abb4ab7 -->
     public override void CheckStatus()
     {
         DeviceStatus = GetStatusRelay();
@@ -170,6 +187,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// Reboots a specific outlet on the KMTronic relay device by first powering it off, waiting for a specified delay, and then powering it back on. This method is used to reset the connected device by briefly cutting off its power supply.
     /// </summary>
     /// <param name="outletId">The ID of the outlet to reboot.</param>
+    /// <!-- aidoc:v1 sig=1edae69 body=deab68d -->
     public override void RebootOutlet(int outletId)
     {
         //Reinicia el relé del dispositivo conectado            
@@ -179,6 +197,7 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// <summary>
     /// Reboots all outlets on the KMTronic relay device by first powering them off, waiting for a specified delay, and then powering them back on. This method is used to reset all connected devices by briefly cutting off their power supply.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1be2480 body=f0389f8 -->
     public override void Reboot()
     {
         PowerOffAll();
@@ -191,6 +210,8 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// </summary>
     /// <returns>A task representing the asynchronous operation.</returns>
     /// <exception cref="NotImplementedException"></exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "Method returns Task<bool> (relay status), but <returns> only says 'A task representing the asynchronous operation' without describing the boolean result." -->
     public override Task<bool> GetStatusRelayAsync()
     {
         throw new NotImplementedException();
@@ -199,6 +220,8 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// <summary>
     /// Asynchronously retrieves the status of a specific outlet on the KMTronic relay device. This method is not implemented in this class, and it throws a NotImplementedException when called.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Documentation describes an asynchronous outlet status retrieval method that throws NotImplementedException, but the actual code creates/closes a UdpClient to connect to the relay device." -->
     protected virtual void Connect()
     {
         if (_udpClient == null)
@@ -244,6 +267,10 @@ public class KmTronicRelay(Relay relay, RelaySettings relaySettings)
     /// </summary>
     /// <param name="datagrama">The command to send to the KMTronic relay device.</param>
     /// <returns>The response from the KMTronic relay device.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "The method explicitly throws `t.Exception` when the receive task faults within the timeout window, but no <exception> tag is documented." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary says the method 'checks if the UDP client is initialized and connected'; the code only checks for null (not connection status) and does not mention the 5-second timeout that causes an empty string to be returned on failure." -->
     protected virtual string Send(string datagrama)
     {
         if (_udpClient == null) Connect();
diff --git a/adas-core.module.Relays/Devices/KMTronicV2Relay.cs b/adas-core.module.Relays/Devices/KMTronicV2Relay.cs
index 24b53d7d..86a6856a 100644
--- a/adas-core.module.Relays/Devices/KMTronicV2Relay.cs
+++ b/adas-core.module.Relays/Devices/KMTronicV2Relay.cs
@@ -11,6 +11,7 @@ namespace adas_core.module.Relays.Devices;
 /// <summary>
 /// Class representing a KMTronic V2 relay device. This class inherits from the RelayDevice class and provides specific implementations for checking the device status, getting the status of individual relays, and controlling the power state of the relays for a KMTronic V2 relay device.
 /// </summary>
+/// <!-- aidoc:v1 sig=72b48d3 -->
 public class KmTronicV2Relay : RelayDevice
 {
     /// <summary>
@@ -18,6 +19,7 @@ public class KmTronicV2Relay : RelayDevice
     /// </summary>
     /// <param name="relay">The Relay object representing the relay device.</param>
     /// <param name="relaySettings">The RelaySettings object containing the configuration settings for the relay device.</param>
+    /// <!-- aidoc:v1 sig=3bbe6ca body=0353383 -->
     public KmTronicV2Relay(Relay relay, RelaySettings relaySettings) : base(relay, relaySettings)
     {
         CheckDevice();
@@ -29,6 +31,7 @@ public class KmTronicV2Relay : RelayDevice
     /// The method returns true if the device is responsive and provides a valid status, and false otherwise.
     /// </summary>
     /// <returns>True if the device is responsive and provides a valid status, false otherwise.</returns>
+    /// <!-- aidoc:v1 sig=b02a15f body=470606e -->
     public sealed override bool CheckDevice()
     {
         CheckStatus();
@@ -42,6 +45,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <remarks>
     /// The method sends an HTTP GET request to the "status.xml" endpoint of the KMTronic V2 relay device and parses the XML response to update the internal status of each relay.
     /// </remarks>
+    /// <!-- aidoc:v1 sig=abdef98 body=7148801 -->
     public override void CheckStatus()
     {
         try
@@ -91,6 +95,10 @@ public class KmTronicV2Relay : RelayDevice
     /// Gets the status of a specific relay outlet by sending a request to the KMTronic V2 relay device. The method returns the status of the specified relay outlet, which can be On, Off, or Unknown.
     /// </summary>
     /// <returns>True if the specified relay outlet is On, false otherwise.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary refers to 'a specific relay outlet' and 'the specified relay outlet', but this overload takes no parameters and always checks relay 1." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the status can be 'On, Off, or Unknown', but the method returns a bool, not a status value." -->
     public override bool GetStatusRelay()
     {
         return GetStatusRelay(1) == RelayEnum.Status.On;
@@ -100,6 +108,10 @@ public class KmTronicV2Relay : RelayDevice
     /// Gets the status of a specific relay outlet by sending a request to the KMTronic V2 relay device. The method returns the status of the specified relay outlet, which can be On, Off, or Unknown.
     /// </summary>
     /// <returns>True if the specified relay outlet is On, false otherwise.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'the specified relay outlet' but the method takes no parameters to specify a relay." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states the method returns 'On, Off, or Unknown' but it returns a bool (true/false)." -->
     public override Task<bool> GetStatusRelayAsync()
     {
         var result = GetStatusRelay();
@@ -110,6 +122,8 @@ public class KmTronicV2Relay : RelayDevice
     /// Gets the status of a specific relay outlet by retrieving the status from the internal status dictionary. The method returns the status of the specified relay outlet, which can be On, Off, or Unknown.    
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary describes getting/returning relay status, but the method PowerOnRelay turns a relay on by calling PowerRelay(outletId, RelayEnum.Status.On) and returns void." -->
     public override void PowerOnRelay(int outletId)
     {
         PowerRelay(outletId, RelayEnum.Status.On);
@@ -119,6 +133,10 @@ public class KmTronicV2Relay : RelayDevice
     /// Gets the status of a specific relay outlet by retrieving the status from the internal status dictionary. The method returns the status of the specified relay outlet, which can be On, Off, or Unknown.
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary describes getting/retrieving the status of a relay outlet, but the method actually powers off a relay outlet." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Summary states the method returns a status (On, Off, or Unknown), but the method returns void." -->
     public override void PowerOffRelay(int outletId)
     {
         PowerRelay(outletId, RelayEnum.Status.Off);
@@ -131,6 +149,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <param name="path">The path of the relay device.</param>
     /// <param name="query">The query parameters for the request.</param>
     /// <returns>The constructed URI.</returns>
+    /// <!-- aidoc:v1 sig=995f6fd body=c5da058 -->
     private Uri GetUri(string path, string? query = null)
     {
         var uriBuilder = new UriBuilder
@@ -146,6 +165,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <param name="method">The HTTP method for the request.</param>
     /// <param name="query">The query parameters for the request.</param>
     /// <returns>The constructed HttpRequestMessage.</returns>
+    /// <!-- aidoc:v1 sig=82d34b3 body=c3d1721 -->
     private HttpRequestMessage GetRequest(string path, HttpMethod method, string? query = null)
     {
         var uri = GetUri(path, query);
@@ -169,6 +189,10 @@ public class KmTronicV2Relay : RelayDevice
     /// <param name="method">The HTTP method for the request.</param>
     /// <param name="query">The query parameters for the request.</param>
     /// <returns>The HttpResponseMessage received from the relay device.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> tag states the method returns 'The HttpResponseMessage received from the relay device', but when an exception is caught the method returns a locally constructed new HttpResponseMessage(HttpStatusCode.Gone), not one received from the relay." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary's final sentence implies the returned message comes from the relay device after exception handling, but the catch branch synthesizes a HttpStatusCode.Gone response instead; this behavior (and the synthetic Gone return) is not documented." -->
     private HttpResponseMessage SendRequest(string path, HttpMethod method, string? query = null)
     {
         using var client = new HttpClient();
@@ -194,6 +218,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <param name="outletId">The ID of the relay outlet to control.</param>
     /// <param name="toState">The desired state for the relay outlet (On or Off).</param>
     /// <param name="checkStatus">Whether to check the status of the device after sending the request.</param>
+    /// <!-- aidoc:v1 sig=36b130b body=ee2cc07 -->
     private void PowerRelay(int outletId, RelayEnum.Status toState, bool checkStatus = true)
     {
         if (Relay.Mode == RelayEnum.Mode.OpenedOffClosedOn)
@@ -227,6 +252,8 @@ public class KmTronicV2Relay : RelayDevice
     /// The method iterates through all relay outlets and sends requests to change their state to the desired state (On or Off). 
     /// After sending the requests, it checks the status of the device to ensure that the state changes were successful.
     /// </summary>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "Summary describes the method as changing state to 'On or Off', but the method only sets state to On (RelayEnum.Status.On) since it is PowerOnAll." -->
     public override void PowerOnAll()
     {
         PowerAll(RelayEnum.Status.On);
@@ -235,6 +262,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <summary>
     /// Controls the power state of all relay outlets by sending requests to the KMTronic V2 relay device.
     /// </summary>
+    /// <!-- aidoc:v1 sig=bfcd3b2 body=2d798c0 -->
     public override void PowerOffAll()
     {
         PowerAll(RelayEnum.Status.Off);
@@ -244,6 +272,7 @@ public class KmTronicV2Relay : RelayDevice
     /// Controls the power state of all relay outlets by sending requests to the KMTronic V2 relay device.
     /// </summary>
     /// <param name="toState">The desired state for all relay outlets (On or Off).</param>
+    /// <!-- aidoc:v1 sig=b155bab body=11e41a0 -->
     private void PowerAll(RelayEnum.Status toState)
     {
         Enumerable.Range(1, Relay.Total).ToList().ForEach(outletId => { PowerRelay(outletId, toState, false); });
@@ -253,6 +282,7 @@ public class KmTronicV2Relay : RelayDevice
     /// <summary>
     /// Reboots the KMTronic V2 relay device by first powering off all relay outlets, then waiting for a specified delay (if configured), and finally powering on all relay outlets again.
     /// </summary>
+    /// <!-- aidoc:v1 sig=1be2480 body=f0389f8 -->
     public override void Reboot()
     {
         PowerOffAll();
@@ -264,6 +294,7 @@ public class KmTronicV2Relay : RelayDevice
     /// Reboots a specific relay outlet by first powering it off, then waiting for a specified delay (30 seconds in this case), and finally powering it on again.
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet to reboot.</param>
+    /// <!-- aidoc:v1 sig=1edae69 body=1a46256 -->
     public override void RebootOutlet(int outletId)
     {
         PowerOffRelay(outletId);
diff --git a/adas-core.module.Relays/Devices/RelayDevice.cs b/adas-core.module.Relays/Devices/RelayDevice.cs
index 71f99b99..9cfd4cb6 100644
--- a/adas-core.module.Relays/Devices/RelayDevice.cs
+++ b/adas-core.module.Relays/Devices/RelayDevice.cs
@@ -12,6 +12,7 @@ namespace adas_core.module.Relays.Devices;
 /// The class also includes an event to notify when the status of a relay changes. 
 /// The implementation of the methods is left to the derived classes, which will provide specific functionality based on the type of relay device being used.
 /// </summary>
+/// <!-- aidoc:v1 sig=d49d435 -->
 public abstract class RelayDevice
 {
     /// <summary>
@@ -42,6 +43,7 @@ public abstract class RelayDevice
     /// </summary>
     /// <param name="relay">The Relay object representing the relay device.</param>
     /// <param name="relaySettings">The RelaySettings object containing the configuration settings for the relay device.</param>
+    /// <!-- aidoc:v1 sig=4036497 body=4a2098e -->
     protected RelayDevice(Relay relay, RelaySettings relaySettings)
     {
         Relay = relay;
@@ -69,23 +71,32 @@ public abstract class RelayDevice
     /// Checks the status of the relay device. This method is abstract and must be implemented by derived classes to provide specific functionality for checking the status of the relay device.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The <returns> tag is empty; the method returns a bool but its meaning (e.g., true = device OK/connected, false = fault/not found) is not documented." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "The summary specifies 'relay device', but the code (CheckDevice) and signature provide no evidence the device is a relay; the term appears to be an unsupported assumption." -->
     public abstract bool CheckDevice();
 
     /// <summary>
     /// Checks the status of the relays. This method is abstract and must be implemented by derived classes to provide specific functionality for checking the status of the relays.
     /// </summary>
+    /// <!-- aidoc:v1 sig=7c1569a -->
     public abstract void CheckStatus();
 
     /// <summary>
     /// Gets the status of the relay device. This method is abstract and must be implemented by derived classes to provide specific functionality for retrieving the status of the relay device.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "The <returns> tag is empty; the method returns a bool indicating the relay status, which is not described." -->
     public abstract bool GetStatusRelay();
 
     /// <summary>
     /// Gets the status of the relays. This method is abstract and must be implemented by derived classes to provide specific functionality for retrieving the status of the relays.
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=low kind=missing_returns
+    ///      "The <returns> tag is empty and does not describe what the Task<bool> return value represents." -->
     public abstract Task<bool> GetStatusRelayAsync();
 
     /// <summary>
@@ -93,6 +104,7 @@ public abstract class RelayDevice
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet.</param>
     /// <returns>The status of the specified relay outlet.</returns>
+    /// <!-- aidoc:v1 sig=72e92a5 body=80cb7be -->
     public virtual RelayEnum.Status GetStatusRelay(int outletId)
     {
         lock (_relaysStatus)
@@ -106,6 +118,7 @@ public abstract class RelayDevice
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet.</param>
     /// <param name="status">The new status of the relay outlet.</param>
+    /// <!-- aidoc:v1 sig=82b3cca body=3d9883a -->
     public virtual void SetStatusRelay(int outletId, RelayEnum.Status status)
     {
         lock (_relaysStatus)
@@ -123,6 +136,8 @@ public abstract class RelayDevice
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet.</param>
     /// <param name="milliseconds">The duration in milliseconds for which the relay outlet should be powered off.</param>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "The summary states the method 'waits' for the specified milliseconds between PowerOffRelay and PowerOnRelay, but Task.Delay's returned Task is not awaited, so PowerOnRelay runs immediately after PowerOffRelay with no actual delay." -->
     public virtual void PowerOnOffRelay(int outletId, int milliseconds)
     {
         Task.Run(() =>
@@ -137,6 +152,7 @@ public abstract class RelayDevice
     /// <summary>
     /// Refreshes the status of the relay device. This method is virtual and can be overridden by derived classes to provide specific functionality for refreshing the status of the relay device.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d883f16 body=4448e1d -->
     public virtual void Refresh()
     {
     }
@@ -145,32 +161,38 @@ public abstract class RelayDevice
     /// Powers on a specific relay outlet. This method is abstract and must be implemented by derived classes to provide specific functionality for powering on a relay outlet with the specified outlet ID.
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet to power on.</param>
+    /// <!-- aidoc:v1 sig=d94c874 -->
     public abstract void PowerOnRelay(int outletId);
 
     /// <summary>
     /// Powers off a specific relay outlet. This method is abstract and must be implemented by derived classes to provide specific functionality for powering off a relay outlet with the specified outlet ID.
     /// </summary>
     /// <param name="outletId">The ID of the relay outlet to power off.</param>
+    /// <!-- aidoc:v1 sig=5394819 -->
     public abstract void PowerOffRelay(int outletId);
     
     /// <summary>
     /// Powers on all relay outlets. This method is abstract and must be implemented by derived classes to provide specific functionality for powering on all relay outlets.
     /// </summary>
+    /// <!-- aidoc:v1 sig=c996518 -->
     public abstract void PowerOnAll();
 
     /// <summary>
     /// Powers off all relay outlets. This method is abstract and must be implemented by derived classes to provide specific functionality for powering off all relay outlets.
     /// </summary>
+    /// <!-- aidoc:v1 sig=489ea3b -->
     public abstract void PowerOffAll();
 
     /// <summary>
     /// Reboots a specific relay outlet. This method is abstract and must be implemented by derived classes to provide specific functionality for rebooting a relay outlet with the specified outlet ID.
     /// </summary>
     /// <param name="outletId"></param>
+    /// <!-- aidoc:v1 sig=a3e578d -->
     public abstract void RebootOutlet(int outletId);
 
     /// <summary>
     /// Reboots all relay outlets. This method is abstract and must be implemented by derived classes to provide specific functionality for rebooting all relay outlets.
     /// </summary>
+    /// <!-- aidoc:v1 sig=4b9c90f -->
     public abstract void Reboot();
 }
\ No newline at end of file
diff --git a/adas-core.module.Relays/Models/PowerOutletsConfig.cs b/adas-core.module.Relays/Models/PowerOutletsConfig.cs
index 65cd3199..51b8207b 100644
--- a/adas-core.module.Relays/Models/PowerOutletsConfig.cs
+++ b/adas-core.module.Relays/Models/PowerOutletsConfig.cs
@@ -7,6 +7,7 @@ namespace adas_core.module.Relays.Models;
 /// This class includes properties to enable or disable power off and reset functionalities, 
 /// as well as details about the outlet such as its ID, name, type, and whether to show the power outlet in the user interface.
 /// </summary>
+/// <!-- aidoc:v1 sig=09b10b4 -->
 public class PowerOutletsConfig
 {
     /// <summary>
@@ -57,6 +58,7 @@ public class PowerOutletsConfig
     /// String representation of the PowerOutletsConfig object, including its ID, name, outlet number, and type.
     /// </summary>
     /// <returns>A string representation of the PowerOutletsConfig object.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=3ed41e1 -->
     public override string ToString()
     {
         return "PowerOutletsConfig id" + Id +
diff --git a/adas-core.module.Relays/Models/RelaySettings.cs b/adas-core.module.Relays/Models/RelaySettings.cs
index b7eabe65..76b7740b 100644
--- a/adas-core.module.Relays/Models/RelaySettings.cs
+++ b/adas-core.module.Relays/Models/RelaySettings.cs
@@ -4,6 +4,7 @@
 /// Represents the settings for a relay device, including caching behavior, refresh intervals, and data source URLs. 
 /// These settings allow for flexible configuration of the relay's operation, enabling it to optimize performance and ensure up-to-date information based on the specified parameters.
 /// </summary>
+/// <!-- aidoc:v1 sig=2d0c50f -->
 public class RelaySettings
 {
     /// <summary>
diff --git a/adas-core.module.Relays/Utils/HttpUtils.cs b/adas-core.module.Relays/Utils/HttpUtils.cs
index 5bd13943..1455b5e4 100644
--- a/adas-core.module.Relays/Utils/HttpUtils.cs
+++ b/adas-core.module.Relays/Utils/HttpUtils.cs
@@ -6,6 +6,7 @@ namespace adas_core.module.Relays.Utils;
 /// <summary>
 /// Utility class for handling HTTP-related operations, such as adding basic authentication headers to HTTP requests.
 /// </summary>
+/// <!-- aidoc:v1 sig=02c5c5e -->
 public static class HttpUtils
 {
     /// <summary>
@@ -15,6 +16,7 @@ public static class HttpUtils
     /// <param name="password">The password for basic authentication.</param>
     /// <param name="headers">The HttpRequestHeaders to which the authentication will be added.</param>
     /// <returns>The HttpRequestHeaders with the added basic authentication.</returns>
+    /// <!-- aidoc:v1 sig=adadc62 body=7d07c47 -->
     public static HttpRequestHeaders AddBasicAuth(string username, string password, HttpRequestHeaders headers)
     {
         var auth = Encoding.ASCII.GetBytes($"{username}:{password}");
diff --git a/adas-core/Configurations/ServiceExtension.cs b/adas-core/Configurations/ServiceExtension.cs
index d4e2a7c8..23e1576d 100644
--- a/adas-core/Configurations/ServiceExtension.cs
+++ b/adas-core/Configurations/ServiceExtension.cs
@@ -13,6 +13,7 @@ namespace adas_core.Configurations
     /// <summary>
     /// Provides static extension methods for service-related operations.
     /// </summary>
+    /// <!-- aidoc:v1 sig=d11e782 -->
     public static class ServiceExtension
     {
         /// <summary>
@@ -21,6 +22,7 @@ namespace adas_core.Configurations
         /// corresponding configuration sections.
         /// </summary>
         /// <param name="builder">The <see cref="WebApplicationBuilder"/> whose services and configuration are used to register the option bindings.</param>
+        /// <!-- aidoc:v1 sig=2478ebf body=f196ab6 -->
         public static void CreateConfigEntitiesFromAppSettingsSections(this WebApplicationBuilder builder)
         {
             builder.Services.Configure<DatabaseSettings>(builder.Configuration.GetSection("DatabaseSettings"));
@@ -41,6 +43,7 @@ namespace adas_core.Configurations
         /// </summary>
         /// <param name="builder">The <see cref="WebApplicationBuilder"/> used to configure services and application settings.</param>
         /// <exception cref="ArgumentNullException">Thrown when <paramref name="builder"/> is <c>null</c>.</exception>
+        /// <!-- aidoc:v1 sig=bbe3253 body=6d4c036 -->
         public static void UseProxyDevices(this WebApplicationBuilder builder)
         {
             if (builder == null)
@@ -56,6 +59,7 @@ namespace adas_core.Configurations
         /// </summary>
         /// <param name="builder">The <see cref="WebApplicationBuilder"/> to which authentication and authorization services are added.</param>
         /// <exception cref="Exception">Thrown when the JWT signing key is not configured in the application settings.</exception>
+        /// <!-- aidoc:v1 sig=1a2abf6 body=10aa18a -->
         public static void ConfigureJwtAuthentication(this WebApplicationBuilder builder)
         {
             var auth = new AuthSettings();
diff --git a/adas-core/Controllers/AdmissionController.cs b/adas-core/Controllers/AdmissionController.cs
index 9f2a8b9b..930bda7b 100644
--- a/adas-core/Controllers/AdmissionController.cs
+++ b/adas-core/Controllers/AdmissionController.cs
@@ -12,6 +12,7 @@ namespace adas_core.Controllers;
 /// <summary>
 /// Provides API endpoints for managing patient admission records in the ADAS system.
 /// </summary>
+/// <!-- aidoc:v1 sig=1e539e4 -->
 [Route("admissions")]
 [ApiController]
 public class AdmissionController : ControllerBase
@@ -33,6 +34,8 @@ public class AdmissionController : ControllerBase
     /// <paramref name="patientService"/>, or <paramref name="unitService"/> is <c>null</c>.
     /// </exception>
  
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The constructor body contains no null checks and does not throw ArgumentNullException; the exception is fabricated by the documentation." -->
     public AdmissionController(ILogger<AdmissionController> logger, IAdmissionService admissionService,
         IPatientService patientService, IUnitService unitService)
     {
@@ -48,6 +51,7 @@ public class AdmissionController : ControllerBase
     /// Retrieves all admissions records.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of admissions with an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=b102b92 body=50bb967 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -65,6 +69,7 @@ public class AdmissionController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the admission details when found.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no admission matching the provided <paramref name="id"/> is found.</exception>
+    /// <!-- aidoc:v1 sig=7be76af body=a2887ff -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -87,6 +92,7 @@ public class AdmissionController : ControllerBase
     /// <param name="admission">The admission data to create, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly created admission wrapped in an OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="admission"/> is null or when its NHC field is null or empty.</exception>
+    /// <!-- aidoc:v1 sig=1d7b8e4 body=e9f96f2 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -104,6 +110,7 @@ public class AdmissionController : ControllerBase
     /// <param name="admission">The admission entity containing the updated information to persist.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the outcome of the update operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the admission's NHC is null or empty.</exception>
+    /// <!-- aidoc:v1 sig=bcb547a body=ac87b6b -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -122,6 +129,7 @@ public class AdmissionController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> that returns OK when the admission is successfully deleted.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
     /// <exception cref="NotFoundException">Thrown when no admission is found for the specified id.</exception>
+    /// <!-- aidoc:v1 sig=7740585 body=b1c3426 -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -143,6 +151,7 @@ public class AdmissionController : ControllerBase
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no admission exists for the given id, or when the admission's unit configuration cannot be found.</exception>
     /// <exception cref="ConflictException">Thrown when the unit's configuration has manual admit disabled, or when no patient record matches the admission's patient number.</exception>
+    /// <!-- aidoc:v1 sig=00893ec body=1f6740b -->
     [HttpPost("{id}/admission")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -177,6 +186,7 @@ public class AdmissionController : ControllerBase
     /// <exception cref="BadRequestException">Thrown when the <paramref name="admission"/> parameter is null.</exception>
     /// <exception cref="NotFoundException">Thrown when no unit configuration is found for the specified unit identifier.</exception>
     /// <exception cref="ConflictException">Thrown when the target unit operates in automatic census mode, or when the patient cannot be retrieved after the admission is registered.</exception>
+    /// <!-- aidoc:v1 sig=d0012f7 body=7de6f36 -->
     [HttpPost("admit/new-patient")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -209,6 +219,7 @@ public class AdmissionController : ControllerBase
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid identifier format.</exception>
     /// <exception cref="NotFoundException">Thrown when no unit configuration is found for the patient's unit.</exception>
     /// <exception cref="ConflictException">Thrown when the unit's configuration has manual move disabled, indicating the census is in automatic mode.</exception>
+    /// <!-- aidoc:v1 sig=f89c172 body=daa26be -->
     [HttpPost("{id}/patient-to-admission")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -238,6 +249,7 @@ public class AdmissionController : ControllerBase
     /// <param name="id">The string representation of the patient's identifier from the route, expected to be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> that returns HTTP 200 (OK) when the patient is successfully returned to admissions.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not in a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=bca1131 body=2086d8c -->
     [HttpPost("{id}/temporal-bed")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -259,6 +271,7 @@ public class AdmissionController : ControllerBase
     /// <param name="unitId">The identifier of the unit used to scope the admission search; must be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> containing the matching admission records returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="unitId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=a8a8a19 body=24401df -->
     [HttpGet("{patientNumber}/{unitId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/AlarmController.cs b/adas-core/Controllers/AlarmController.cs
index cfa27002..33c6836b 100644
--- a/adas-core/Controllers/AlarmController.cs
+++ b/adas-core/Controllers/AlarmController.cs
@@ -14,6 +14,7 @@ namespace adas_core.Controllers;
 /// Controller responsible for handling HTTP requests related to alarm observations.
 /// Provides endpoints to retrieve, process, and manage alarm data.
 /// </summary>
+/// <!-- aidoc:v1 sig=ac2a6ff -->
 [Route("alarm-observations")]
 [ApiController]
 public class AlarmController : ControllerBase
@@ -27,6 +28,8 @@ public class AlarmController : ControllerBase
     /// <param name="logger">The logger instance used to log diagnostic and operational information for the controller.</param>
     /// <param name="alarmService">The alarm service instance used to perform alarm-related operations.</param>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="logger"/> or <paramref name="alarmService"/> is <c>null</c>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "The constructor body does not perform any null checks; it directly assigns logger and alarmService to fields, so ArgumentNullException is never thrown." -->
     public AlarmController(ILogger<AlarmController> logger, IAlarmService alarmService)
     {
         LogExecutionContext.TrySetTraceIdentifier(Guid.NewGuid().ToString(), true);
@@ -43,6 +46,7 @@ public class AlarmController : ControllerBase
     /// </summary>
     /// <param name="alarmDto">The observation alarm data transfer object containing patient, location, alarm, and timing information.</param>
     /// <returns>An <see cref="IActionResult"/> containing the processed <see cref="ApiRequest"/> with HTTP 200 status.</returns>
+    /// <!-- aidoc:v1 sig=781bd64 body=11511fb -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpPost]
     [Route("")]
diff --git a/adas-core/Controllers/ApplicationController.cs b/adas-core/Controllers/ApplicationController.cs
index 5451a2bb..0eff1e9f 100644
--- a/adas-core/Controllers/ApplicationController.cs
+++ b/adas-core/Controllers/ApplicationController.cs
@@ -12,6 +12,7 @@ namespace adas_core.Controllers;
 /// <summary>
 /// Provides API endpoints for managing application-level operations such as subscribers, file uploads, asset management, and cache cleaning.
 /// </summary>
+/// <!-- aidoc:v1 sig=2ba7571 -->
 [Route("application")]
 [ApiController]
 public class ApplicationController : ControllerBase
@@ -38,6 +39,8 @@ public class ApplicationController : ControllerBase
     /// Thrown when <paramref name="fileService"/>, <paramref name="subscribersService"/>,
     /// <paramref name="subscriberGroupedService"/>, or <paramref name="clientMessageService"/> is <see langword="null"/>.
     /// </exception>
+    /// <!-- aidoc-review:v1 severity=high kind=extra_exception
+    ///      "The constructor body contains no null checks and never throws ArgumentNullException, but the doc claims it does for four parameters." -->
     public ApplicationController(
         IFileService fileService,
         ISubscribersService subscribersService,
@@ -59,6 +62,7 @@ public class ApplicationController : ControllerBase
     /// Handles an anonymous HTTP GET request to retrieve the list of subscribers by delegating to the subscribers service and returning the result.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the subscribers data returned by <c>_subscribersService.GetSubscribers()</c>.</returns>
+    /// <!-- aidoc:v1 sig=602ca3e body=bd12f5b -->
     [HttpGet("subscribers")]
     [AllowAnonymous]
     public IActionResult GetSubscribersVersion()
@@ -71,6 +75,7 @@ public class ApplicationController : ControllerBase
     /// The grouped result is obtained from the subscriber grouping service and returned with an HTTP 200 OK status.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the grouped subscribers returned by the subscriber grouping service wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=f63e9e6 body=59f9233 -->
     [HttpGet("subscribers-group")]
     [AllowAnonymous]
     public IActionResult GetSubscribersGroup()
@@ -83,6 +88,7 @@ public class ApplicationController : ControllerBase
     /// </summary>
     /// <param name="boxes">The list of patient locations to be dispatched to the boxes for update.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response when the update messages are successfully dispatched.</returns>
+    /// <!-- aidoc:v1 sig=51aeb49 body=2d40274 -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpPost]
     public IActionResult UpdateApplications([FromBody] List<PatientLocation> boxes)
@@ -97,6 +103,7 @@ public class ApplicationController : ControllerBase
     /// </summary>
     /// <param name="files">The list of files submitted for upload.</param>
     /// <returns>An <see cref="ActionResult"/> indicating the result of the upload operation.</returns>
+    /// <!-- aidoc:v1 sig=fb01588 body=3c17fe3 -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpPost("upload")]
     [RequestSizeLimit(300_000_000)]
@@ -116,6 +123,7 @@ public class ApplicationController : ControllerBase
     /// <param name="files">The collection of files to upload to the resolved theme.</param>
     /// <returns>An <see cref="ActionResult"/> containing an HTTP 200 OK response when the files are successfully uploaded.</returns>
     /// <exception cref="InvalidFormatException">Thrown when the provided <paramref name="theme"/> cannot be parsed into a valid <c>FileEnum.AssetTheme</c> value.</exception>
+    /// <!-- aidoc:v1 sig=0b143ac body=63af40d -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpPost("upload/{theme}/{category}/asset")]
     [RequestSizeLimit(300_000_000)]
@@ -135,6 +143,7 @@ public class ApplicationController : ControllerBase
     /// <param name="theme">The theme name to parse into an <see cref="FileEnum.AssetTheme"/> value used to look up the associated asset files.</param>
     /// <returns>An <see cref="ActionResult"/> containing the list of asset files for the resolved theme.</returns>
     /// <exception cref="InvalidFormatException">Thrown when the <paramref name="theme"/> parameter cannot be parsed into a valid <see cref="FileEnum.AssetTheme"/> value.</exception>
+    /// <!-- aidoc:v1 sig=207c655 body=bf97856 -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpGet("{theme}/{category}/asset")]
     public ActionResult UGetAssetFile(string theme)
@@ -149,6 +158,7 @@ public class ApplicationController : ControllerBase
     /// </summary>
     /// <returns>An <see cref="ActionResult"/> containing an HTTP 200 OK response when the cache is successfully cleared.</returns>
     /// <exception cref="InvalidFormatException">Thrown when the Redis service is not available.</exception>
+    /// <!-- aidoc:v1 sig=8048b0a body=be5a215 -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [HttpGet("cleaning")]
     public ActionResult CleanCache()
diff --git a/adas-core/Controllers/AuditController.cs b/adas-core/Controllers/AuditController.cs
index a9d2dfe7..07d08e3c 100644
--- a/adas-core/Controllers/AuditController.cs
+++ b/adas-core/Controllers/AuditController.cs
@@ -12,6 +12,7 @@ namespace adas_core.Controllers;
 ///     consulta de registros de auditoría del sistema. Proporciona operaciones para recuperar,
 ///     filtrar y exportar logs de auditoría a través de peticiones HTTP.
 /// </summary>
+/// <!-- aidoc:v1 sig=ee62ccf -->
 [Route("audits")]
 [ApiController]
 public class AuditController(IAuditService auditService) : ControllerBase // Hereda de ControllerBase
@@ -34,6 +35,8 @@ public class AuditController(IAuditService auditService) : ControllerBase // Her
     ///     Una respuesta de acción que puede ser una lista de registros de auditoria o un mensaje de error.
     ///     Retorna <c>Ok</c> con los registros encontrados o <c>BadRequest</c> si hay un error en los parámetros.
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation claims the method returns BadRequest when parameters are invalid, but the code throws CustomArgumentException instead and never returns BadRequest." -->
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
     [HttpPost]
diff --git a/adas-core/Controllers/BoxController.cs b/adas-core/Controllers/BoxController.cs
index d0720a1c..beee4df8 100644
--- a/adas-core/Controllers/BoxController.cs
+++ b/adas-core/Controllers/BoxController.cs
@@ -12,6 +12,7 @@ namespace adas_core.Controllers;
 /// <summary>
 /// Provides API endpoints for managing box-related operations, including units, patients, and insulation lists.
 /// </summary>
+/// <!-- aidoc:v1 sig=1cd9041 -->
 [Route("Box")]
 [ApiController]
 public class BoxController : ControllerBase
@@ -31,6 +32,8 @@ public class BoxController : ControllerBase
     /// <param name="pointOfCareService">The service used to manage point of care operations.</param>
     /// <param name="userService">The service used to manage user-related operations.</param>
     /// <exception cref="ArgumentNullException">Thrown when any of the provided service dependencies is <c>null</c>.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+    ///      "The constructor body contains only field assignments and does not throw ArgumentNullException; no null checks are present in the body." -->
     public BoxController(IUnitService unitService, IPatientService patientService, IMasterListService<InsulationList> isulationListService, IPointOfCareService pointOfCareService, IUserService userService)
     {
         _unitService = unitService;
@@ -48,6 +51,7 @@ public class BoxController : ControllerBase
     /// <param name="elementSwitjAction">The action that determines which observation list to switch (e.g., "Isolation", "Mobility").</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the operation.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user identity name is not available in the HTTP context.</exception>
+    /// <!-- aidoc:v1 sig=9bae3b4 body=f24254b -->
     [HttpGet("{boxNumber}/{elementSwitjAction}/switch-data")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> SwitchData(string boxNumber, string elementSwitjAction)
diff --git a/adas-core/Controllers/CameraController.cs b/adas-core/Controllers/CameraController.cs
index bee9fe2f..e3b591ca 100644
--- a/adas-core/Controllers/CameraController.cs
+++ b/adas-core/Controllers/CameraController.cs
@@ -11,6 +11,8 @@ namespace adas_core.Controllers;
 /// <summary>
 /// Retrieves API endPoints for managing Camera Service
 /// </summary>
+/// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+///      "Summary says the class 'Retrieves API endPoints', but a controller exposes/defines endpoints; the verb 'Retrieves' misrepresents the controller's role." -->
 [ApiController]
 public class CameraController(ICameraService cameraService) : ControllerBase
 {
@@ -22,6 +24,7 @@ public class CameraController(ICameraService cameraService) : ControllerBase
     /// <param name="withPoCs">Indicates whether the result should include PoCs (Points of Contact).</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated cameras returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> parameter is null.</exception>
+    /// <!-- aidoc:v1 sig=9eef38c body=cac86f1 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetPaginatedCamera([FromBody] PaginationFilter request, bool withPoCs)
@@ -35,6 +38,7 @@ public class CameraController(ICameraService cameraService) : ControllerBase
     /// </summary>
     /// <param name="textToSearch">The text used to search for cameras by name.</param>
     /// <returns>An <see cref="IActionResult"/> containing the list of cameras that match the search criteria.</returns>
+    /// <!-- aidoc:v1 sig=417f166 body=547f4e4 -->
     [HttpGet("{textToSearch}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetSearchByName(string textToSearch)
@@ -48,6 +52,7 @@ public class CameraController(ICameraService cameraService) : ControllerBase
     /// </summary>
     /// <param name="camera">The camera entity to be created, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly inserted camera wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=6151935 body=d02b7cc -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> CreateCamera([FromBody] Camera camera)
@@ -63,6 +68,7 @@ public class CameraController(ICameraService cameraService) : ControllerBase
     /// <param name="camera">The camera payload containing the updated information.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated camera when the operation succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided id is not a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=1b1bb88 body=23768bd -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> UpdateCamera(string id, [FromBody] Camera camera)
@@ -77,6 +83,7 @@ public class CameraController(ICameraService cameraService) : ControllerBase
     /// <param name="id">The string representation of the camera's ObjectId to be deleted.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the delete operation when the id is valid.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=155e80f body=86ecc13 -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> DeleteCamera(string id)
diff --git a/adas-core/Controllers/ConfigDisplayController.cs b/adas-core/Controllers/ConfigDisplayController.cs
index 094e1f84..c9b52904 100644
--- a/adas-core/Controllers/ConfigDisplayController.cs
+++ b/adas-core/Controllers/ConfigDisplayController.cs
@@ -22,6 +22,8 @@ namespace adas_core.Controllers;
 ///     A new instance of <see cref="ConfigDisplayController"/>.
 /// </returns>
 /// <exception cref="ArgumentNullException">Thrown when <paramref name="displayConfigService"/> is <see langword="null"/>.</exception>
+/// <!-- aidoc-review:v1 severity=high kind=wrong_exception
+///      "The primary constructor body contains no null check and does not throw ArgumentNullException; ASP.NET Core DI would throw InvalidOperationException for an unresolvable service." -->
 [Route("config-displays")]
 [ApiController]
 public class ConfigDisplayController(
@@ -35,6 +37,10 @@ public class ConfigDisplayController(
     /// <returns>
     ///     List<DisplayConfig />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'GetByCodeSysAndCode', but the method is named List and calls GetAll() with no code/sys parameters." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns type documented as 'List<DisplayConfig />', but the method signature returns 'IActionResult' (Ok(await displayConfigService.GetAll()))." -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -49,6 +55,12 @@ public class ConfigDisplayController(
     /// <returns>
     ///     List<DisplayConfig />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary contains 'GetByCodeSysAndCode' which does not match the method's behavior; the method lists all display configs paginated based on a PaginationFilter, not by any code system/code lookup." -->
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "'GetByCodeSysAndCode' prefix suggests filtering by a code system and code value, but the method only accepts a PaginationFilter and calls GetAllCompactPaginated." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The 'request' parameter of type PaginationFilter is not documented." -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -63,6 +75,10 @@ public class ConfigDisplayController(
     /// <returns>
     ///     List<DisplayConfig />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary mentions 'GetByCodeSysAndCode' but the method is ListCompact which calls GetAllCompact() with no code/sys filtering." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documents return type as 'List<DisplayConfig />' but method signature returns Task<IActionResult> (Ok(...) wrapper)." -->
     [HttpGet("compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> ListCompact()
@@ -76,6 +92,12 @@ public class ConfigDisplayController(
     /// <returns>
     ///     List<DisplayConfig />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'GetByCodeSysAndCode' (a different method name) instead of describing ListByType's behavior." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documents return type as 'List<DisplayConfig />' but the method returns 'IActionResult' (Ok(await displayConfigService.GetByType(type)))." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "Parameter 'type' (DisplayConfigEnums.DisplayType) is not documented." -->
     [HttpGet("{type}/type")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -90,6 +112,8 @@ public class ConfigDisplayController(
     /// <returns>
     ///     displayConfig
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary mentions 'GetByCodeSysAndCode' but the method is ListById which retrieves a display config by object id only, not by CodeSysAndCode." -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -106,6 +130,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="config">The display configuration to insert, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the inserted display configuration wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=28ecd0b body=fe9f7f7 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -120,6 +145,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="config">The display configuration payload received in the request body, which may optionally include a display config ID template.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the insertion operation.</returns>
+    /// <!-- aidoc:v1 sig=d181afe body=c4f81e1 -->
     [HttpPost("compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -136,6 +162,7 @@ public class ConfigDisplayController(
     /// Handles a GET request to the "insertion-test" endpoint, performing a test insertion via the display configuration service. Requires the caller to have the <see cref="PermissionEnum.RolesType.AuthSome"/> role and the "Source.DisplayId" permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the result of the test insertion wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=288a724 body=765313a -->
     [HttpGet("insertion-test")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -151,6 +178,10 @@ public class ConfigDisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the method 'notify subscribers' but the method body only calls displayConfigService.UpdateConfig and returns the result; no notification logic is present." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "Parameters 'id' and 'newDisplayConfig' are not documented." -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -171,6 +202,7 @@ public class ConfigDisplayController(
     /// <param name="colorConfig">The new color configuration to apply.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result on success, or a not-modified status when the update produces no changes.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=09b9352 body=06ee6ba -->
     [HttpPut("{idConfig}/color-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -191,6 +223,7 @@ public class ConfigDisplayController(
     /// <param name="headerConfig">The header configuration payload to be applied to the display configuration.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result on success, or a response indicating that the resource was not modified when no changes were made.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=9bc76df body=595adbd -->
     [HttpPut("{idConfig}/header-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -213,6 +246,7 @@ public class ConfigDisplayController(
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no display configuration is found for the parsed id.</exception>
     /// <exception cref="BadRequestException">Thrown when the found display configuration is not of type <see cref="DisplayConfigEnums.DisplayType.DisplayNurse"/>.</exception>
+    /// <!-- aidoc:v1 sig=fead30b body=50576b1 -->
     [HttpPut("{idConfig}/home-banner")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -233,6 +267,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="baseConfig">The display configuration to apply as the base configuration.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result, or an "OkResouceNotModified" response when no changes were made.</returns>
+    /// <!-- aidoc:v1 sig=0979b81 body=e3ad8d7 -->
     [HttpPut("update/base-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -248,6 +283,10 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="baseConfig">The card configuration data to be updated.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated configuration or a not-modified response.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states the method 'Returns the updated configuration on success', but the code returns Ok(result) where 'result' is the boolean from displayConfigService.UpdateCardConfig, not the configuration object." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns tag claims the IActionResult contains 'the updated configuration', but the success branch returns the boolean service result, not the updated CardConfig." -->
     [HttpPut("update/card-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -263,6 +302,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="baseConfig">The card details configuration to be updated.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result, or a not-modified message if the resource was not changed.</returns>
+    /// <!-- aidoc:v1 sig=f1f5ecd body=4e1da7a -->
     [HttpPut("update/detail-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -278,6 +318,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="baseConfig">The chart configuration to update.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result, or an OkResouceNotModified response when the configuration was not changed.</returns>
+    /// <!-- aidoc:v1 sig=70c83ed body=86a8d36 -->
     [HttpPut("update/chart-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -295,6 +336,7 @@ public class ConfigDisplayController(
     /// <param name="fields">The list of fields to be applied to the specified display configuration.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the update operation.</returns>
     /// <exception cref="InvalidFormatException">Thrown when the provided <paramref name="idConfig"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=980c7a2 body=299f781 -->
     [HttpPut("{idConfig}/field-list")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -315,6 +357,7 @@ public class ConfigDisplayController(
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the new display configuration name.</param>
     /// <returns>An <see cref="IActionResult"/> containing the update result, or a not-modified status when the name is unchanged.</returns>
     /// <exception cref="InvalidFormatException">Thrown when the configuration ID is not a valid format or when the display name is empty.</exception>
+    /// <!-- aidoc:v1 sig=4be0c29 body=0dca87e -->
     [HttpPost("{idConfig}/name")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -335,6 +378,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the card configuration details to be created.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the insert operation wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=4ed254d body=64533de -->
     [HttpPost("card-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -350,6 +394,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the details of the card display configuration to create.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the insert operation wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=b69bfbf body=67d7276 -->
     [HttpPost("detail-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -364,6 +409,7 @@ public class ConfigDisplayController(
     /// </summary>
     /// <param name="updateDisplayConfigNameDto">The data transfer object containing the chart configuration details to be created.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the chart configuration insertion wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=3657ff0 body=ded78f3 -->
     [HttpPost("chart-config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -378,6 +424,7 @@ public class ConfigDisplayController(
     /// This endpoint allows anonymous access and returns the complete list of card configurations.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the HTTP 200 OK response with all card configurations.</returns>
+    /// <!-- aidoc:v1 sig=0600594 body=3cc39f9 -->
     [HttpGet("get-all-card-config")]
     [AllowAnonymous]
     public async Task<IActionResult> GetAllCardConfig()
@@ -394,6 +441,7 @@ public class ConfigDisplayController(
     /// <returns>An <see cref="IActionResult"/> containing the result of the deletion when successful.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid identifier format.</exception>
     /// <exception cref="ConflictException">Thrown when the display configuration could not be deleted.</exception>
+    /// <!-- aidoc:v1 sig=44e13d1 body=9953e1a -->
     [HttpDelete("{idConfig}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -414,6 +462,7 @@ public class ConfigDisplayController(
     /// <returns>An <see cref="IActionResult"/> that returns HTTP 200 (OK) with the result of the deletion when the chart configuration is successfully removed.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid identifier format.</exception>
     /// <exception cref="ConflictException">Thrown when the chart configuration cannot be deleted due to a conflict.</exception>
+    /// <!-- aidoc:v1 sig=76c3857 body=40265f4 -->
     [HttpDelete("chart-config/{idConfig}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -435,6 +484,7 @@ public class ConfigDisplayController(
     /// <returns>The chart configuration wrapped in an HTTP 200 OK response when found.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no chart configuration matches the provided identifier.</exception>
+    /// <!-- aidoc:v1 sig=9cf0065 body=6d0e675 -->
     [HttpGet("chart-config/{idConfig}")]
     [AllowAnonymous]
     public async Task<IActionResult> GetChartConfig(string idConfig)
@@ -454,6 +504,7 @@ public class ConfigDisplayController(
     /// <param name="idConfig">The display configuration identifier used to look up its associated locations.</param>
     /// <returns>The display configuration locations returned by the service.</returns>
     /// <exception cref="InvalidFormatException">Thrown when <paramref name="idConfig"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=455a7cd body=a45a5b7 -->
     [HttpGet("{idConfig}/locations")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -474,6 +525,10 @@ public class ConfigDisplayController(
     /// <exception cref="InvalidFormatException"></exception>
     //[AuthorizeRoles(RolesType.Some)]
     //[TypeFilter(type: typeof(AuthorizePermissionsAttribute), Arguments = new object[] { "DisplayId", AuthorizeUserByServiceType.CONFIGDISPLAY })]
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary 'Search media element' misrepresents the method, which streams a media file (returning a FileStreamResult with range processing), not a search/query operation." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The filename parameter has no description." -->
     [HttpGet]
     [AllowAnonymous]
     [Route("{id}/getMedia/{filename}")]
@@ -534,6 +589,8 @@ public class ConfigDisplayController(
     /// <param name="id">display config id</param>
     /// <returns>File details list</returns>
     /// <exception cref="InvalidFormatException"></exception>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary contains the stale prefix 'GetByCodeSysAndCode' which is leftover from another method and does not match the current method GetAllMediaFiles." -->
     [AllowAnonymous]
     [HttpGet("allMediaFiles/{id}")]
     public async Task<IActionResult> GetAllMediaFiles(string id)
diff --git a/adas-core/Controllers/ConfigObservationController.cs b/adas-core/Controllers/ConfigObservationController.cs
index 93407bc4..85b5e9c0 100644
--- a/adas-core/Controllers/ConfigObservationController.cs
+++ b/adas-core/Controllers/ConfigObservationController.cs
@@ -44,6 +44,7 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the active configuration observations.</returns>
     /// <exception cref="NotFoundException">Thrown when no configuration observations are returned by the service.</exception>
+    /// <!-- aidoc:v1 sig=8c7780e body=43c1aa3 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -58,6 +59,10 @@ public class ConfigObservationController : ControllerBase
     ///     GetByCodeSysAndCode compact configs
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says 'GetByCodeSysAndCode compact configs' but the method is GetAllCompact, which retrieves all compact configs without filtering by code/sys." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_returns
+    ///      "The <returns> tag is empty and does not describe the IActionResult containing configObservation data." -->
     [HttpGet("compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -73,6 +78,12 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "Method throws InvalidFormatException when id is not a valid ObjectId, but no exception is documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "Method throws NotFoundException when the config observation is not found, but no exception is documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary says 'Get config by id' but the method retrieves a config observation; consider 'Get config observation by id'" -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -91,6 +102,8 @@ public class ConfigObservationController : ControllerBase
     ///     Get a list of paginated items
     /// </summary>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The 'filter' parameter of type PaginationFilter is not documented with a <param> tag." -->
     [HttpPost("paginated-items")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -107,6 +120,7 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="configObservation"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=f157e31 body=ba2ec54 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -126,6 +140,8 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="configObservationItem"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "The method throws ConflictException (HttpEnum.ErrorMessage.ConflictCreationFailed) when CreateConfig returns null, but it is not documented." -->
     [HttpPost("item")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -145,6 +161,10 @@ public class ConfigObservationController : ControllerBase
     /// <param name="configId"></param>
     /// <param name="configObservationItem"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "BadRequestException is thrown when configId is not a valid ObjectId, but is not documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "NotFoundException is thrown when the config observation is not found, but is not documented" -->
     [HttpPut("{configId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -166,6 +186,7 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="itemName"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=e7c5b3a body=ba39e44 -->
     [HttpGet("itemName/{itemName}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -180,6 +201,7 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="data"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=9df5989 body=611b08a -->
     [HttpGet("item/by-code-sys-and-code/{data}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -202,6 +224,7 @@ public class ConfigObservationController : ControllerBase
     /// <param name="configObservationItem">The configuration observation item to delete, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the deletion operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="configObservationItem"/> is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=f6b0600 body=8526bee -->
     [HttpDelete("delete/item")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -219,6 +242,12 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="itemName"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'GetByCodeSysAndCode' and mentions no CodeSys/Code parameters exist; the method is GetConfigObservationItemsByName with only an itemName parameter." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_exception
+    ///      "Method throws BadRequestException when itemName.Length < 2, but no <exception> tag documents this." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_returns
+    ///      "<returns> tag is empty; the method returns IActionResult (Ok with config observation items)." -->
     [HttpGet("{itemName}/name")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -233,6 +262,7 @@ public class ConfigObservationController : ControllerBase
     /// Retrieves the list of configuration names available for observations, restricted to users with the required role and source-level display permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the configuration names returned by the observation service wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=acfc5f7 body=cd591f9 -->
     [HttpGet("get-name-obs")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -247,6 +277,7 @@ public class ConfigObservationController : ControllerBase
     /// </summary>
     /// <param name="newConfigObservation">The new configuration observation to log, or <c>null</c> to indicate the configuration was removed.</param>
     /// <param name="oldConfigObservation">The previous configuration observation to log, or <c>null</c> to indicate no prior configuration existed.</param>
+    /// <!-- aidoc:v1 sig=fcb81f0 body=ac21cc9 -->
     private async Task LogHistoricalConfigChanged(ConfigObservation? newConfigObservation,
             ConfigObservation? oldConfigObservation)
     {
diff --git a/adas-core/Controllers/DeviceController.cs b/adas-core/Controllers/DeviceController.cs
index 6a99bc86..bd5819d5 100644
--- a/adas-core/Controllers/DeviceController.cs
+++ b/adas-core/Controllers/DeviceController.cs
@@ -34,6 +34,7 @@ public class DeviceController : ControllerBase
     /// </summary>
     /// <param name="device">The device data transfer object containing the information of the device to be created.</param>
     /// <returns>An IActionResult containing the created device on success, or a Conflict response if the creation fails.</returns>
+    /// <!-- aidoc:v1 sig=7fe07a8 body=329a937 -->
     [HttpPost("add")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> CreateDevice([FromBody] DeviceDto device)
@@ -48,6 +49,7 @@ public class DeviceController : ControllerBase
     /// </summary>
     /// <param name="id">The string representation of the device's ObjectId to delete.</param>
     /// <returns>An IActionResult indicating the outcome of the delete operation.</returns>
+    /// <!-- aidoc:v1 sig=f2ea0f1 body=426dc08 -->
     [HttpDelete("delete/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> CreateDevice(string id)
@@ -63,6 +65,10 @@ public class DeviceController : ControllerBase
     /// </summary>
     /// <param name="device">The device data transfer object containing the updated device information.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated device on success, or a <see cref="ConflictResult"/> when the update returns null.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states the method returns a conflict response when result is null, but the if statement lacks braces so the Conflict(...) call is discarded; the method always falls through to return Ok(result)" -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Returns tag references ConflictResult as a possible return value, but the method never returns a conflict response because the single-line if without braces makes Conflict(...) dead code" -->
     [HttpPut("edit")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> EditDevice([FromBody] DeviceDto device)
@@ -78,6 +84,7 @@ public class DeviceController : ControllerBase
     /// </summary>
     /// <param name="device">The device payload received in the request body to be processed as an event.</param>
     /// <returns>An <see cref="IActionResult"/> that returns <see cref="OkResult"/> on successful processing, or <see cref="ConflictResult"/> with a message when the service cannot create the device.</returns>
+    /// <!-- aidoc:v1 sig=7ae3581 body=dc6e53b -->
     [HttpPost("event")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> ReceiveEventDevice([FromBody] DeviceDto device)
diff --git a/adas-core/Controllers/DiagnosisController.cs b/adas-core/Controllers/DiagnosisController.cs
index f6ae09eb..380443c6 100644
--- a/adas-core/Controllers/DiagnosisController.cs
+++ b/adas-core/Controllers/DiagnosisController.cs
@@ -38,6 +38,7 @@ public class DiagnosisController : ControllerBase
     /// </summary>
     /// <param name="diagnosisDto">The diagnosis payload received in the request body, containing the patient number, location, observation data, observations, diagnosis text, message timestamp, and a flag indicating whether the caller wants to wait for the result.</param>
     /// <returns>An <see cref="IActionResult"/> that returns an HTTP 200 OK response when the request is accepted for processing.</returns>
+    /// <!-- aidoc:v1 sig=8c96f8f body=98d5d44 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/DischargeController.cs b/adas-core/Controllers/DischargeController.cs
index 8a46162d..fc56472f 100644
--- a/adas-core/Controllers/DischargeController.cs
+++ b/adas-core/Controllers/DischargeController.cs
@@ -41,6 +41,7 @@ public class DischargeController : ControllerBase
     /// Retrieves all discharge records available in the system.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of discharges with an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=a5b5bda body=7e71cc2 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -57,6 +58,7 @@ public class DischargeController : ControllerBase
     /// <param name="id">The string identifier of the discharge to retrieve, expected to be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> containing the discharge data when found.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=d9f2e96 body=b1149a1 -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -75,6 +77,7 @@ public class DischargeController : ControllerBase
     /// <param name="discharge">The discharge information, including the patient identifier, to be persisted.</param>
     /// <returns>An <see cref="IActionResult"/> that returns an OK response when the discharge is successfully recorded.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="discharge"/> parameter is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=62afe59 body=be2e3fc -->
     [HttpPost("patient")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -94,6 +97,7 @@ public class DischargeController : ControllerBase
     /// <param name="discharge">The discharge entity supplied in the request body, identified by its <c>Id</c>.</param>
     /// <returns>An <see cref="IActionResult"/> that yields an <c>Ok</c> response on successful update.</returns>
     /// <exception cref="BadRequestException">Thrown when the supplied <paramref name="discharge"/> payload is <c>null</c>.</exception>
+    /// <!-- aidoc:v1 sig=eddb6cd body=fab4e6c -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -114,6 +118,7 @@ public class DischargeController : ControllerBase
     /// <param name="discharge">The discharge entity to insert, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the inserted discharge wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="discharge"/> parameter is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=d2cf075 body=66fc8cc -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -132,6 +137,7 @@ public class DischargeController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> representing the result of the delete operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="ConflictException">Thrown when the patient's <c>Altable</c> option type is not <c>Altable</c>, preventing the deletion.</exception>
+    /// <!-- aidoc:v1 sig=51efb40 body=bd08fdd -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/DisplayController.cs b/adas-core/Controllers/DisplayController.cs
index b3df5591..2679c64f 100644
--- a/adas-core/Controllers/DisplayController.cs
+++ b/adas-core/Controllers/DisplayController.cs
@@ -31,6 +31,8 @@ public class DisplayController(
     /// <returns>
     ///     List<Display />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "The <returns> tag documents List<Display>, but the method's return type is Task<IActionResult> (the list is wrapped in Ok())." -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     //[PermissionAuthorize("Source", "DisplayId")]
@@ -44,6 +46,7 @@ public class DisplayController(
     /// Retrieves a compact list of all displays, requiring the caller to be authenticated with the <see cref="PermissionEnum.RolesType.AuthSome"/> role and to have the "Source" / "DisplayId" permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the HTTP 200 response with the compact display list returned by the display service.</returns>
+    /// <!-- aidoc:v1 sig=0de17df body=d638355 -->
     [HttpGet("compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -58,6 +61,7 @@ public class DisplayController(
     /// <param name="request">The pagination filter containing paging criteria sent in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated displays wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> payload is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=d147dce body=aeb5c23 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -75,6 +79,7 @@ public class DisplayController(
     /// <returns>
     ///     List<Display />
     /// </returns>
+    /// <!-- aidoc:v1 sig=b296779 body=a8b8cfd -->
     [HttpGet("{type}/type")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -89,6 +94,10 @@ public class DisplayController(
     /// <returns>
     ///     List<Display />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary states 'Get By type all minimal display list' but the implementation calls GetAllDisplaySection() without using the {type} route parameter to filter by type" -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documented returns is 'List<Display />' but the method signature returns IActionResult (though Ok() wraps a list, the convention of documenting the response body type for IActionResult is debatable)" -->
     [HttpGet("{type}/compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -103,6 +112,8 @@ public class DisplayController(
     /// <returns>
     ///     List<Display />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The method accepts a [FromBody] PointOfCare pointOfCare parameter that is not documented." -->
     [HttpPost("poc")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -117,6 +128,8 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The 'name' parameter is not documented" -->
     [HttpGet("{name}/name")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -132,6 +145,12 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The 'localeEnum' parameter is a required route parameter used to filter the result by locale, but it is not documented anywhere in the XML comment." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "The method throws BadRequestException when id or localeEnum cannot be parsed, but no <exception> tag is present." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "Summary 'Get display by object id' omits the locale-based filtering that the method performs via the localeEnum parameter." -->
     [HttpGet("{localeEnum}/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -149,6 +168,7 @@ public class DisplayController(
     /// <param name="id">The string representation of the display's unique identifier.</param>
     /// <returns>An <see cref="IActionResult"/> containing the requested display entity.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=28b37ba body=449233d -->
     [HttpGet("{id}/adm-panel")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -167,6 +187,14 @@ public class DisplayController(
     /// <returns>
     ///     List<Unit />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Method returns IActionResult (Ok(result)), not List<Unit>; the underlying result from displayService.GetByUnitId is also likely displays, not units." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The 'id' parameter is not documented." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_exception
+    ///      "BadRequestException is thrown when 'id' is not a valid ObjectId format, but it is not documented." -->
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary contains a typo ('it unit' instead of 'its unit') and is vague about behavior." -->
     [HttpGet("{id}/unitId")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -184,6 +212,12 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "Parameters 'id', 'fillPointOfCare', and 'fillDisplayList' are not documented." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "BadRequestException (thrown for invalid ObjectId) is not documented." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "NotFoundException (thrown when result is null) is not documented." -->
     [HttpGet("{id}/info")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -205,6 +239,7 @@ public class DisplayController(
     /// <param name="type">The display type used to filter the configuration lookup.</param>
     /// <returns>An <see cref="IActionResult"/> containing the display configuration retrieved for the supplied identifier and type.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=ee73862 body=113b65c -->
     [HttpGet("{id}/unitId/{type}/type")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -221,6 +256,7 @@ public class DisplayController(
     /// </summary>
     /// <param name="displayIds">The collection of display identifiers used to look up the available points of contact.</param>
     /// <returns>An <see cref="IActionResult"/> containing the list of available points of contact matching the provided display identifiers.</returns>
+    /// <!-- aidoc:v1 sig=518b71c body=210cc24 -->
     [HttpPost("poc-available")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -237,6 +273,7 @@ public class DisplayController(
     /// <param name="displayId">The display identifier used to look up the associated POCs.</param>
     /// <returns>An <see cref="IActionResult"/> containing the POC list returned by the display service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="displayId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=5069a0d body=2842d45 -->
     [HttpGet("{displayId}/pocs")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -255,6 +292,10 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "Parameter 'id' (route string for display id) is not documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "Parameter 'pointOfCareIdList' (List<string> of PointOfCare ids) is not documented" -->
     [HttpPut("{id}/pocs-ids")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     // [PermissionAuthorize("Source", "DisplayId")]
@@ -280,6 +321,14 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary claims the method 'notify subscribers', but the body performs no notification; it only validates IDs, fetches the display and config, calls UpdateConfigPreset, and returns the result." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "<returns> says 'display', but the method returns the result of displayService.UpdateConfigPreset(objectIdDisplay, objectIdConfigDisplay), which is an update operation result, not a display entity." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "Parameters idDisplay and idConfig are not documented." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_exception
+    ///      "BadRequestException (on invalid ObjectId format) and NotFoundException (when the display is not found) are thrown but not documented." -->
     [HttpPut("{idDisplay}/config-preset/{idConfig}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     // [PermissionAuthorize("Source", "DisplayId")]
@@ -302,6 +351,14 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The 'id' parameter is not documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The 'name' parameter is not documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "BadRequestException is thrown when 'id' is not a valid ObjectId, but is not documented" -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "Returns tag describes 'display' but the method returns IActionResult (Ok(result))" -->
     [HttpPut("{id}/{name}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     // [PermissionAuthorize("Source", "DisplayId")]
@@ -319,6 +376,8 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The method accepts a [FromBody] Display display parameter, but no <param> documentation is provided for it." -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     // [PermissionAuthorize("Source", "DisplayId")]
@@ -335,6 +394,12 @@ public class DisplayController(
     /// <returns>
     ///     display
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "The method takes a string 'id' parameter but no <param> tag documents it." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "The method throws BadRequestException when 'id' is not a valid ObjectId, but no <exception> tag documents this." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_returns
+    ///      "<returns> says 'display' but the method returns IActionResult (Ok(result)) where 'result' comes from displayService.DeleteDisplay; the description is too vague and could mislead." -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     // [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/GroupedObservationsController.cs b/adas-core/Controllers/GroupedObservationsController.cs
index a3fba356..680c1005 100644
--- a/adas-core/Controllers/GroupedObservationsController.cs
+++ b/adas-core/Controllers/GroupedObservationsController.cs
@@ -43,6 +43,7 @@ public class GroupedObservationsController : ControllerBase
     /// <param name="groupedConfig">The configuration that defines how observations should be grouped.</param>
     /// <returns>An <see cref="IActionResult"/> containing the generated grouped observation wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is null, empty, or not in a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=8aad3ce body=28435f1 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/LightBeaconController.cs b/adas-core/Controllers/LightBeaconController.cs
index 1f9fcfcf..67066088 100644
--- a/adas-core/Controllers/LightBeaconController.cs
+++ b/adas-core/Controllers/LightBeaconController.cs
@@ -45,6 +45,7 @@ public class LightBeaconController : ControllerBase
     /// <param name="request">The pagination filter containing the paging parameters used to query the beacons.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated list of beacons returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> parameter is null, indicating missing parameters.</exception>
+    /// <!-- aidoc:v1 sig=99b7e9e body=891948e -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetPaginatedUnits([FromBody] PaginationFilter request)
@@ -59,6 +60,8 @@ public class LightBeaconController : ControllerBase
     /// </summary>
     /// <param name="beac">The light beacon data to create the camera from, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the created light beacon.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_summary
+    ///      "Summary claims to create a 'camera record', but the code inserts and returns a LightBeacon via _lightBeaconService.InsertOne; the camera/light-beacon terminology is internally inconsistent and misleading." -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> CreateCamera([FromBody] LightBeacon beac)
@@ -73,6 +76,7 @@ public class LightBeaconController : ControllerBase
     /// <param name="beacon">The light beacon payload containing the updated information, sourced from the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated light beacon returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=6557d7b body=3e758f0 -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> UpdateCamera(string id, [FromBody] LightBeacon beacon)
@@ -87,6 +91,8 @@ public class LightBeaconController : ControllerBase
     /// </summary>
     /// <param name="textToSearch">The text used to search for the light beacon by name.</param>
     /// <returns>An <see cref="IActionResult"/> containing the matching beacon, or a not-found response if no match exists.</returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documentation claims the method may return a not-found response if no match exists, but the code unconditionally returns Ok(beacon); a null result would yield a 200 OK with a null body, not a 404." -->
     [HttpGet("{textToSearch}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetSearchByName(string textToSearch)
@@ -103,6 +109,7 @@ public class LightBeaconController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> indicating successful completion.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="patientId"/> is not a valid <see cref="ObjectId"/> format.</exception>
     /// <exception cref="NotFoundException">Thrown when the patient cannot be found or has no associated point of care.</exception>
+    /// <!-- aidoc:v1 sig=c0dfa16 body=36d96d2 -->
     [HttpPost("on/{color}")]
     public async Task<IActionResult> On([FromBody] string patientId, string color)
     {
@@ -148,6 +155,7 @@ public class LightBeaconController : ControllerBase
     /// </summary>
     /// <param name="pocId">The string representation of the POC ObjectId whose light beacon LED should be powered off.</param>
     /// <exception cref="BadRequestException">Thrown when <paramref name="pocId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=a94d526 body=40c3b8c -->
     [HttpPost("off")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public IActionResult Off([FromBody] string pocId)
@@ -164,6 +172,7 @@ public class LightBeaconController : ControllerBase
     /// </summary>
     /// <param name="beacon">The light beacon data to be created, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the inserted beacon on success, or a conflict response if the insertion fails.</returns>
+    /// <!-- aidoc:v1 sig=7d3d15b body=bf277e2 -->
     [HttpPost("create")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> Create([FromBody] adas_core.Domain.Models.MongoModels.LightBeacon beacon)
diff --git a/adas-core/Controllers/MasterListController.cs b/adas-core/Controllers/MasterListController.cs
index 31e4c6aa..fa0ba559 100644
--- a/adas-core/Controllers/MasterListController.cs
+++ b/adas-core/Controllers/MasterListController.cs
@@ -31,6 +31,7 @@ public class MasterListController(
     /// Retrieves the master list settings for the authenticated user with the required permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the master list settings on success.</returns>
+    /// <!-- aidoc:v1 sig=4401884 body=bddf972 -->
     [HttpGet("list-settings")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public IActionResult GetMasterListSettings()
@@ -44,6 +45,7 @@ public class MasterListController(
     /// <param name="typeName">The name of the master list type used to resolve the corresponding service.</param>
     /// <returns>An <see cref="IActionResult"/> containing the master list data when the specified type is valid.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a valid <c>MasterListType</c> value.</exception>
+    /// <!-- aidoc:v1 sig=978267c body=62e694e -->
     [HttpGet("{typeName}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -62,6 +64,7 @@ public class MasterListController(
     /// Retrieves all master list entries (without their associated options) for every <see cref="MasterListType"/> value, aggregating the results from each type's dedicated service resolved through the service factory.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 response with the combined collection of <see cref="MasterListDto"/> items gathered from all master list services.</returns>
+    /// <!-- aidoc:v1 sig=b0f1dda body=55225cc -->
     [HttpGet("no-options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -86,6 +89,7 @@ public class MasterListController(
     /// <param name="request">The pagination filter containing paging criteria applied to the master list query.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated master list result wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed into a valid <see cref="MasterListType"/> value.</exception>
+    /// <!-- aidoc:v1 sig=d7e25d4 body=b77051a -->
     [HttpPost("{typeName}/paginated-options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -107,6 +111,7 @@ public class MasterListController(
     /// <param name="typeName">The name of the master list type to count, parsed into the <see cref="MasterListType"/> enum.</param>
     /// <returns>An <see cref="IActionResult"/> containing the count of master list items.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="typeName"/> cannot be parsed into a valid <see cref="MasterListType"/>.</exception>
+    /// <!-- aidoc:v1 sig=2017532 body=aebaa7d -->
     [HttpGet("{typeName}/count")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -125,6 +130,7 @@ public class MasterListController(
     /// Requires the "AuthSome" role and the "DisplayId" permission on the "Source" resource.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing a <see cref="Dictionary{TKey, TValue}"/> that maps each <see cref="MasterListType"/> to its total record count, returned with HTTP 200 OK.</returns>
+    /// <!-- aidoc:v1 sig=7dc9e6e body=e5d84fd -->
     [HttpGet("count")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -148,6 +154,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the requested master list entry.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed as a valid <c>MasterListType</c>.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not in a valid <c>ObjectId</c> format.</exception>
+    /// <!-- aidoc:v1 sig=a6d5d1a body=43356f1 -->
     [HttpGet("{typeName}/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -174,6 +181,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the paginated master list options returned by the resolved service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a valid <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=a0bc5c8 body=9357e06 -->
     [HttpPost("{typeName}/{id}/master-list-paginated-options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -197,6 +205,7 @@ public class MasterListController(
     /// <param name="typeName">The name of the master list type used to resolve the corresponding service through the service factory.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated master list result with its options.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="typeName"/> cannot be parsed as a valid <c>MasterListType</c>.</exception>
+    /// <!-- aidoc:v1 sig=ef30b97 body=5b1da62 -->
     [HttpPost("{typeName}/paginated-master-list-paginated-options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -228,6 +237,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the paginated options payload.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed as a valid <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid <see cref="ObjectId"/> format.</exception>
+    /// <!-- aidoc:v1 sig=07c177f body=f796792 -->
     [HttpPost("{typeName}/{id}/paginated-options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -261,6 +271,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the master list options names returned by the resolved service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed as a <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid <see cref="ObjectId"/> format.</exception>
+    /// <!-- aidoc:v1 sig=03aac96 body=8c24929 -->
     [HttpGet("{typeName}/{id}/master-list-options-names")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -285,6 +296,7 @@ public class MasterListController(
     /// <param name="name">The name of the master list entry to look up.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the master list lookup.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed into a valid <see cref="MasterListType"/>.</exception>
+    /// <!-- aidoc:v1 sig=feea3eb body=eed22a5 -->
     [HttpGet("{typeName}/{name}/name")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -308,6 +320,7 @@ public class MasterListController(
     /// <param name="targetCategory">The name of the target <see cref="MasterListType"/> used to resolve the related options service.</param>
     /// <returns>The <see cref="MasterList"/> containing the related options for the requested category.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> or <paramref name="targetCategory"/> cannot be parsed as a valid <see cref="MasterListType"/>, or when <paramref name="listId"/> is not a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=15bce14 body=1c245ce -->
     [HttpGet("{typeName}/{listId}/related-options/{targetCategory}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -337,6 +350,12 @@ public class MasterListController(
     /// <param name="id">id de la lista</param>
     /// <param name="searchOptions"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_param
+    ///      "<param name=\"searchOptions\"> has no description, but it represents the filter criteria sent in the request body." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_returns
+    ///      "<returns> is empty; the method returns an IActionResult with the master list options." -->
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "No <exception> documents BadRequestException, which is thrown for invalid typeName or id." -->
     [HttpPost("{typeName}/{id}/options")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -370,6 +389,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the filtered master list results returned by the resolved service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed to a valid <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="textSearch"/> is provided but is shorter than 3 characters.</exception>
+    /// <!-- aidoc:v1 sig=29d34f2 body=e701375 -->
     [HttpGet("{typeName}/{textSearch}/text")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -399,6 +419,7 @@ public class MasterListController(
     /// <param name="typeName">The string identifier of the master list type, which is parsed into the <see cref="MasterListType"/> enum to resolve the appropriate service.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated master list result.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed into a valid <see cref="MasterListType"/> value.</exception>
+    /// <!-- aidoc:v1 sig=1f8505a body=7856eaf -->
     [HttpPost("{typeName}/paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -428,6 +449,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the result of the insert operation.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="master"/> is null.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed into a valid <see cref="MasterListType"/>.</exception>
+    /// <!-- aidoc:v1 sig=1ab70df body=b007df2 -->
     [HttpPost("{typeName}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -448,6 +470,7 @@ public class MasterListController(
     /// <param name="master">The master list payload containing the new values to persist.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the update operation.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="master"/> is <see langword="null"/>; when <paramref name="typeName"/> cannot be parsed into a <see cref="MasterListType"/>; or when <paramref name="id"/> is not a valid <see cref="ObjectId"/>.</exception>
+    /// <!-- aidoc:v1 sig=b2a5623 body=d442281 -->
     [HttpPut("{typeName}/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -474,6 +497,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> containing the result of the add operation.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed into a valid <c>MasterListType</c> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid <c>ObjectId</c> format.</exception>
+    /// <!-- aidoc:v1 sig=3def712 body=d05de82 -->
     [HttpPost("{typeName}/{id}/item")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -505,6 +529,7 @@ public class MasterListController(
     /// <param name="opt">The option payload containing the updated values.</param>
     /// <returns>The updated master list result on success; otherwise, a 409 Conflict when the update fails.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> is not a valid <see cref="MasterListType"/>, when <paramref name="locale"/> is not a valid <see cref="LocaleEnum"/>, or when <paramref name="id"/> is not a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=c003b55 body=0d841b2 -->
     [HttpPut("{locale}/{typeName}/{id}/item")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -538,6 +563,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> that returns the updated result on success or a <c>Conflict</c> response when the update fails.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not match a valid <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid <see cref="ObjectId"/> format.</exception>
+    /// <!-- aidoc:v1 sig=fef80db body=bdf3351 -->
     [HttpPut("{typeName}/{id}/item")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -569,6 +595,7 @@ public class MasterListController(
     /// <param name="opt">The payload containing the new details to apply to the master list entry.</param>
     /// <returns>The updated master list result wrapped in an <see cref="IActionResult"/>, or a conflict response when the update fails.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a valid master list type, or when <paramref name="id"/> is not a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=562777f body=05d4dfa -->
     [HttpPut("{typeName}/{id}/details")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -601,6 +628,7 @@ public class MasterListController(
     /// <param name="udpateListNameAndDescriptionDto">The payload containing the new name to apply to the master list.</param>
     /// <returns>An <see cref="IActionResult"/> with the result of the update, <see cref="BadRequestResult"/> when the name is missing, or <see cref="ConflictObjectResult"/> when the update fails.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a known master list type, or when <paramref name="id"/> is not a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=53b7c5a body=1f02b5f -->
     [HttpPut("{typeName}/{id}/name")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -633,6 +661,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> that returns OK on success, BadRequest when the description is null, or Conflict when the update does not succeed.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a valid master list type.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not in a valid identifier format.</exception>
+    /// <!-- aidoc:v1 sig=ac94f22 body=c5c2dfd -->
     [HttpPut("{typeName}/{id}/description")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -671,6 +700,7 @@ public class MasterListController(
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not match a known master list type.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> or <paramref name="itemId"/> are not valid ObjectId values.</exception>
     /// <exception cref="ConflictException">Thrown when the deletion operation returns no result.</exception>
+    /// <!-- aidoc:v1 sig=df0bea0 body=2839209 -->
     [HttpDelete("{typeName}/{id}/item/{itemId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -703,6 +733,7 @@ public class MasterListController(
     /// <returns>An <see cref="IActionResult"/> that returns <c>Ok</c> when the master list item is successfully deleted.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> cannot be parsed as a <see cref="MasterListType"/> value.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=891993c body=0473bf0 -->
     [HttpDelete("{typeName}/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/MedicinesController.cs b/adas-core/Controllers/MedicinesController.cs
index 9da14aa1..538641bf 100644
--- a/adas-core/Controllers/MedicinesController.cs
+++ b/adas-core/Controllers/MedicinesController.cs
@@ -44,6 +44,7 @@ public class MedicinesController : ControllerBase
     /// Retrieves all active medicines, restricted to users with the required authorization role and source/display permissions.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of active medicines returned by the medicine service wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=a52711d body=1180a3a -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -61,6 +62,7 @@ public class MedicinesController : ControllerBase
     /// <param name="patientId">The identifier of the patient whose active medicines are being requested.</param>
     /// <returns>An <see cref="IActionResult"/> containing the active medicines for the patient wrapped in an HTTP 200 response.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="patientId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=5d7e4ef body=39439cd -->
     [HttpGet("{patientId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -81,6 +83,7 @@ public class MedicinesController : ControllerBase
     /// <param name="request">The pagination filter containing paging criteria used to query the medicines.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated medicines result on success.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=bad09f2 body=446a4eb -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -97,6 +100,7 @@ public class MedicinesController : ControllerBase
     /// <param name="medicine">The medicine payload supplied in the request body to be created.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly inserted medicine wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="medicine"/> is <c>null</c>, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=3503688 body=89267a6 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -115,6 +119,7 @@ public class MedicinesController : ControllerBase
     /// <param name="medicine">The medicine payload containing the updated information to apply.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated medicine returned in an Ok response.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=69cd1be body=68c4e16 -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -132,6 +137,7 @@ public class MedicinesController : ControllerBase
     /// </summary>
     /// <param name="id">The unique identifier of the medicine to delete.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response upon successful deletion.</returns>
+    /// <!-- aidoc:v1 sig=eda258d body=8f20fb9 -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -146,6 +152,7 @@ public class MedicinesController : ControllerBase
     /// Access is restricted to users with the required role and permission for the "Source" entity's "DisplayId" action.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the list of all medicine groups returned by the medicine service.</returns>
+    /// <!-- aidoc:v1 sig=f0fe4d5 body=cd29a17 -->
     [HttpGet("groups")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -158,6 +165,7 @@ public class MedicinesController : ControllerBase
     /// Retrieves all available medicine types, requiring authentication with the appropriate role and permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the list of all medicine types if successful.</returns>
+    /// <!-- aidoc:v1 sig=103395b body=9c32bae -->
     [HttpGet("types")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -170,6 +178,7 @@ public class MedicinesController : ControllerBase
     /// Retrieves the list of all medicine names. Requires the user to have the specified role permission and "DisplayId" permission for the "Source" resource.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of medicine names returned by the service.</returns>
+    /// <!-- aidoc:v1 sig=d0d227a body=db1556d -->
     [HttpGet("names")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -182,6 +191,7 @@ public class MedicinesController : ControllerBase
     /// Retrieves the list of all medicine codes available in the system.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of medicine codes with an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=5487a20 body=7e2a330 -->
     [HttpGet("codes")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/NoticeController.cs b/adas-core/Controllers/NoticeController.cs
index d7a9e667..ef741426 100644
--- a/adas-core/Controllers/NoticeController.cs
+++ b/adas-core/Controllers/NoticeController.cs
@@ -38,6 +38,7 @@ public class NoticeController : ControllerBase
     /// Retrieves all notices for the authorized source, requiring the "DisplayId" permission under the "Source" resource and the AuthSome role.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the list of notices returned by the notice service, wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=d479c92 body=309ff47 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -52,6 +53,7 @@ public class NoticeController : ControllerBase
     /// </summary>
     /// <param name="type">The notice type used to filter and retrieve the relevant notices.</param>
     /// <returns>An <see cref="IActionResult"/> containing the notices that match the specified type.</returns>
+    /// <!-- aidoc:v1 sig=bafe528 body=d087c2a -->
     [HttpGet("{type}/type")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -66,6 +68,7 @@ public class NoticeController : ControllerBase
     /// </summary>
     /// <param name="id">The identifier of the notice to retrieve.</param>
     /// <returns>An <see cref="IActionResult"/> containing the notice data returned by the notice service.</returns>
+    /// <!-- aidoc:v1 sig=c30fcd8 body=c0e24e0 -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -84,6 +87,7 @@ public class NoticeController : ControllerBase
     /// <param name="displayId">The display identifier supplied via the request header, which must be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result produced by the notice service insert operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="displayId"/> header value is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=7416ebc body=1b58ae3 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -103,6 +107,7 @@ public class NoticeController : ControllerBase
     /// <param name="notice">The notice payload containing the updated information.</param>
     /// <returns>An <see cref="IActionResult"/> that produces a 200 OK response when the update succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not in a valid object identifier format.</exception>
+    /// <!-- aidoc:v1 sig=d17dfb8 body=24d1bad -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -121,6 +126,7 @@ public class NoticeController : ControllerBase
     /// <param name="id">The string representation of the notice's ObjectId to be deleted.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the delete operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=32e01f3 body=656f369 -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/ObservationsController.cs b/adas-core/Controllers/ObservationsController.cs
index 1621fc5f..7b9c7f4d 100644
--- a/adas-core/Controllers/ObservationsController.cs
+++ b/adas-core/Controllers/ObservationsController.cs
@@ -46,6 +46,7 @@ public class ObservationController : ControllerBase
     /// </summary>
     /// <param name="observationDto">The observation data transfer object containing the patient number, location, observation data, observations, message time, and wait result used to build the API request.</param>
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 204 No Content response after the request is handled.</returns>
+    /// <!-- aidoc:v1 sig=6fb109a body=6797ad0 -->
     [HttpPost]
     [Route("")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
@@ -75,6 +76,7 @@ public class ObservationController : ControllerBase
     /// </summary>
     /// <param name="observationDto">The observation data received in the request body, including patient, location, and measurement details.</param>
     /// <returns>An <see cref="IActionResult"/> representing a 204 No Content response after the request is queued for saving.</returns>
+    /// <!-- aidoc:v1 sig=3b3851a body=5d52daf -->
     [HttpPost]
     [Route("NurseObservations")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
@@ -107,6 +109,7 @@ public class ObservationController : ControllerBase
     /// <c>WaitResult</c> is <c>true</c>, the request is saved synchronously; otherwise it is
     /// saved asynchronously.</param>
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=ccad44e body=5c5d172 -->
     [HttpPost]
     [Route("apiRequest")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
@@ -124,6 +127,7 @@ public class ObservationController : ControllerBase
     /// Expires all observations by invoking the observation service's expiration process.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> representing the HTTP 200 OK response indicating a successful expiration operation.</returns>
+    /// <!-- aidoc:v1 sig=38c6836 body=a4376a0 -->
     [HttpPost("expired")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -140,6 +144,7 @@ public class ObservationController : ControllerBase
     /// <param name="request">The pagination filter containing the paging criteria sent in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated observations returned by the observation service.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=134af4c body=2812f93 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -157,6 +162,7 @@ public class ObservationController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the observations found between the specified dates for the resolved patient.</returns>
     /// <exception cref="BadRequestException">Thrown when the request does not include a patient number.</exception>
     /// <exception cref="NotFoundException">Thrown when no patient matching the supplied patient number exists in either the active or archived records.</exception>
+    /// <!-- aidoc:v1 sig=9c664b7 body=212d7fc -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -186,6 +192,7 @@ public class ObservationController : ControllerBase
     /// <param name="patientid">The unique identifier of the patient for whom the observation is being recorded.</param>
     /// <param name="value">The NEWS score value to associate with the observation.</param>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="patientid"/> is not a valid ObjectId format or when the <paramref name="value"/> is not a valid integer.</exception>
+    /// <!-- aidoc:v1 sig=1be2ec0 body=7fb40a2 -->
     [HttpPost("{patientId}/force-news/{value}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/PatientAppointmentController.cs b/adas-core/Controllers/PatientAppointmentController.cs
index 3c5491e7..877bcd0c 100644
--- a/adas-core/Controllers/PatientAppointmentController.cs
+++ b/adas-core/Controllers/PatientAppointmentController.cs
@@ -40,6 +40,7 @@ public class PatientAppointmentController : ControllerBase
     /// </summary>
     /// <param name="appointmentDto">The appointment data received in the request body, containing patient number, location, appointments, message time, and wait result.</param>
     /// <returns>An <see cref="IActionResult"/> that returns an HTTP 200 OK response when the request is successfully saved.</returns>
+    /// <!-- aidoc:v1 sig=d3b0a51 body=d57751e -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public IActionResult ProcessRequest([FromBody] AppointmentDto appointmentDto)
diff --git a/adas-core/Controllers/PatientController.cs b/adas-core/Controllers/PatientController.cs
index b8c842fc..3e871d47 100644
--- a/adas-core/Controllers/PatientController.cs
+++ b/adas-core/Controllers/PatientController.cs
@@ -41,6 +41,7 @@ public class PatientController : ControllerBase
     /// <param name="userService">The service responsible for user management and authentication.</param>
     /// <param name="unitService">The service responsible for unit-related operations.</param>
 
+    /// <!-- aidoc:v1 sig=426b7c2 body=0fecab1 -->
     public PatientController(
         IPatientService patientService,
         IObservationService observationService,
@@ -61,6 +62,7 @@ public class PatientController : ControllerBase
     /// and a granted "DisplayId" permission on the "Source" resource.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the full collection of patients retrieved from the patient service.</returns>
+    /// <!-- aidoc:v1 sig=b4aff7e body=aa2bb5d -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -74,6 +76,7 @@ public class PatientController : ControllerBase
     /// </summary>
     /// <param name="patientNumber">The unique patient number used to look up the patient.</param>
     /// <returns>An <see cref="IActionResult"/> containing the patient information returned by the service.</returns>
+    /// <!-- aidoc:v1 sig=99d0ba6 body=e189703 -->
     [HttpGet("find-by-patientnumber/{patientNumber}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetByPatientNumber(string patientNumber)
@@ -88,6 +91,7 @@ public class PatientController : ControllerBase
     /// <param name="patientId">The patient's identifier expected to be a valid ObjectId string.</param>
     /// <returns>An <see cref="IActionResult"/> containing the last observation payload on success.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="patientId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=ab0358e body=3a0aee0 -->
     [HttpGet("{patientId}/last-observation")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -104,6 +108,7 @@ public class PatientController : ControllerBase
     /// Access is restricted to authorized users with the required role and source display permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of active patients returned by the service.</returns>
+    /// <!-- aidoc:v1 sig=2360c28 body=3f1b4a6 -->
     [HttpGet("active-poc")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -120,6 +125,7 @@ public class PatientController : ControllerBase
     /// <param name="request">The pagination filter containing criteria for querying patients.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated patients when successful.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=e7de6c2 body=c6b68e9 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -134,6 +140,7 @@ public class PatientController : ControllerBase
     /// Retrieves a basic list of all persons associated with registered patients, requiring the <c>AuthSome</c> role and the <c>Source.DisplayId</c> permission.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 response with the collection of person records derived from all patients.</returns>
+    /// <!-- aidoc:v1 sig=d0c23fc body=0eb05b2 -->
     [HttpGet("basic")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -150,6 +157,7 @@ public class PatientController : ControllerBase
     /// </summary>
     /// <param name="patientDto">The patient data transfer object containing the patient number, location, patient details, message time, and wait result used to build the request.</param>
     /// <returns>An <see cref="IActionResult"/> containing the patient record retrieved after the request is saved.</returns>
+    /// <!-- aidoc:v1 sig=ccb4ecf body=10ec411 -->
     [HttpPost("request")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -178,6 +186,7 @@ public class PatientController : ControllerBase
     /// </summary>
     /// <param name="apiRequest">The API request payload received from the request body to be saved.</param>
     /// <returns>An <see cref="IActionResult"/> that returns HTTP 200 (OK) when the request is successfully persisted.</returns>
+    /// <!-- aidoc:v1 sig=49b2927 body=8f7134f -->
     [HttpPost("api-request")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -194,6 +203,7 @@ public class PatientController : ControllerBase
     /// <param name="id">The patient's identifier expected to be a valid ObjectId string.</param>
     /// <returns>An <see cref="IActionResult"/> containing the patient data when found.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=df31bd5 body=9baaeeb -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -215,6 +225,7 @@ public class PatientController : ControllerBase
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no unit configuration is found for the patient's unit.</exception>
     /// <exception cref="ConflictException">Thrown when the unit operates in automatic census mode, disallowing manual discharge.</exception>
+    /// <!-- aidoc:v1 sig=93e744c body=dbf0a4a -->
     [HttpPost("{id}/exit")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -246,6 +257,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the updated patient data when the operation succeeds.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user identity name is not available in the HTTP context.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid identifier.</exception>
+    /// <!-- aidoc:v1 sig=7e26860 body=94528b8 -->
     [HttpPost("{id}/archived-procedure")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -275,6 +287,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the updated patient record on success.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user has no identity name associated with the request.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided patient id is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=2a14587 body=220fd7d -->
     [HttpPost("{id}/archived-test")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -304,6 +317,7 @@ public class PatientController : ControllerBase
     /// <returns>The updated patient data after the treatment has been archived.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user's identity name is not available in the HTTP context.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided patient ID is not in a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=d75c038 body=708c2b6 -->
     [HttpPost("{id}/archived-treatment")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -335,6 +349,7 @@ public class PatientController : ControllerBase
     /// <param name="newPatient">The updated patient data sent in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated patient on success.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=53d5e8a body=23f9c4b -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -356,6 +371,7 @@ public class PatientController : ControllerBase
     /// <exception cref="NotFoundException">Thrown when no unit configuration is found for the patient's current unit.</exception>
     /// <exception cref="ConflictException">Thrown when the patient's unit is operating in automatic census mode, disallowing manual moves.</exception>
     /// <exception cref="ConflictException">Thrown when the move operation fails to complete successfully.</exception>
+    /// <!-- aidoc:v1 sig=5f04ff3 body=937e88a -->
     [HttpGet("{patientId}/{oldPoc}/new-location/{newPoc}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -393,6 +409,7 @@ public class PatientController : ControllerBase
     /// <exception cref="BadRequestException">Thrown when the supplied <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="NotFoundException">Thrown when no unit configuration is found for the patient's unit.</exception>
     /// <exception cref="ConflictException">Thrown when the patient's unit is not configured for manual editing.</exception>
+    /// <!-- aidoc:v1 sig=02b91ec body=fbed9d7 -->
     [HttpPut("{id}/{patientNumber}/data")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -426,6 +443,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 200 OK response when the update succeeds.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user identity name is not available in the HTTP context.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=aec2679 body=d0b9305 -->
     [HttpPut("{id}/incoming-data")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -465,6 +483,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> that returns an HTTP 200 OK response when the update succeeds.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current HTTP user identity name is not available.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=949264f body=a13b1cd -->
     [HttpPut("{id}/demographic-data")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -492,6 +511,7 @@ public class PatientController : ControllerBase
     /// <exception cref="UnauthorizedException">Thrown when the current user has no identity name available.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
     /// <exception cref="BadRequestException">Thrown when <paramref name="typeName"/> does not correspond to a valid <see cref="MasterListType"/> value.</exception>
+    /// <!-- aidoc:v1 sig=2f4eb7a body=6da255f -->
     [HttpPost("{id}/master-list/{typeName}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -521,6 +541,7 @@ public class PatientController : ControllerBase
     /// <param name="request">The administration panel request payload containing the patient details, including the patient number to be used for the new record.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly created patient on success, or a <c>Conflict</c> result if a patient with the same number already exists.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="request"/> does not contain a valid patient number.</exception>
+    /// <!-- aidoc:v1 sig=ece0493 body=41f5481 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -540,6 +561,8 @@ public class PatientController : ControllerBase
     /// <param name="request">The admin panel request payload containing the patient information to update, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the updated patient data wrapped in an <see cref="Microsoft.AspNetCore.Mvc.OkResult"/>.</returns>
     /// <exception cref="NotFoundException">Thrown when no patient matching the request can be found.</exception>
+    /// <!-- aidoc-review:v1 severity=low kind=wrong_returns
+    ///      "Ok(value) returns OkObjectResult, not OkResult; the cref should reference Microsoft.AspNetCore.Mvc.OkObjectResult." -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -555,6 +578,7 @@ public class PatientController : ControllerBase
     /// </summary>
     /// <param name="patient">The patient payload containing the identifier of the patient to update and the new <c>AdmTime</c> value to apply.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated patient with the new admission date when the operation succeeds.</returns>
+    /// <!-- aidoc:v1 sig=1df6147 body=a6a4e47 -->
     [HttpPut("entry-date")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -572,6 +596,7 @@ public class PatientController : ControllerBase
     /// </summary>
     /// <param name="request">The admin panel request containing the data needed to update the patient location.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the patient location update operation.</returns>
+    /// <!-- aidoc:v1 sig=565e4f7 body=d9b2597 -->
     [HttpPut("location")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -589,6 +614,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the updated patient on success.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the current user's identity name is not available in the HTTP context.</exception>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=7585f68 body=84a827b -->
     [HttpPut("{id}/altable")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -611,6 +637,7 @@ public class PatientController : ControllerBase
     /// <returns>An <see cref="IActionResult"/> containing the archived patient wrapped in an Ok response.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
     /// <exception cref="NotFoundException">Thrown when no patient is found matching the specified id.</exception>
+    /// <!-- aidoc:v1 sig=423bd50 body=8dd0a81 -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/PointOfCareController.cs b/adas-core/Controllers/PointOfCareController.cs
index 82369198..850ca5b6 100644
--- a/adas-core/Controllers/PointOfCareController.cs
+++ b/adas-core/Controllers/PointOfCareController.cs
@@ -27,6 +27,10 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <returns>
     ///     List<Unit />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says 'GetByCodeSysAndCode all PoC list' but the method is List() which calls GetAll() with no filtering parameters; the documented 'GetByCodeSysAndCode' behavior does not exist in the code." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documented returns 'List<Unit />' but the method's declared return type is Task<IActionResult>, and the actual payload type from pointOfCareService.GetAll() is not known to be List<Unit>." -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -41,6 +45,10 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <returns>
     ///     List<Unit />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'GetByCodeSysAndCode' which is not part of this method's behavior; the method simply returns all VirtualPointOfCare enum names." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "<returns> is documented as 'List<Unit />' but the method returns an IActionResult containing a List<string> of VirtualPointOfCare enum names." -->
     [HttpGet("get-all-virtual")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public IActionResult VirtualPocList()
@@ -56,6 +64,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="request">The pagination filter containing the paging criteria to apply to the PoCs query.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated PoCs returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=9ac90a4 body=fcb58fc -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -72,6 +81,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// </summary>
     /// <param name="pointOfCare">The point of care entity supplied in the request body to be created.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the insertion wrapped in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=9e05d64 body=8851c22 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -89,6 +99,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="status">The string representation of the new status to apply.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the status update operation.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId or <paramref name="status"/> cannot be parsed as a <see cref="StatusEnum.PointOfCare"/> value.</exception>
+    /// <!-- aidoc:v1 sig=98f8cec body=44697a2 -->
     [HttpPut("{id}/{status}/status")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -107,6 +118,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="id">The unit identifier expected to be a valid ObjectId.</param>
     /// <returns>An HTTP 200 response containing the list of Points of Care for the unit, or null if no results are found.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=ff0d5a4 body=05e6319 -->
     [HttpGet("{id}/unit-id")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -127,6 +139,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="status">The string representation of the status filter, parsed into the <see cref="StatusEnum.PointOfCare"/> enumeration.</param>
     /// <returns>An <see cref="IActionResult"/> containing the Point of Care records that match the provided unit and status.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="unitId"/> is not a valid ObjectId or <paramref name="status"/> cannot be parsed into a <see cref="StatusEnum.PointOfCare"/> value.</exception>
+    /// <!-- aidoc:v1 sig=123e7c7 body=716bae6 -->
     [HttpGet("{unitId}/unit-id/{status}/status")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -145,6 +158,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// </summary>
     /// <param name="poc">The Point of Care object containing the updated information, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the update operation.</returns>
+    /// <!-- aidoc:v1 sig=7a748d3 body=8405af6 -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -162,6 +176,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="pocConfig">The new configuration payload to apply to the Point of Care.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response when the configuration is successfully updated.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=38b2760 body=7d1fdd8 -->
     [HttpPut("{id}/config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -178,6 +193,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// </summary>
     /// <param name="poc">The Point of Care object containing the updated relay configuration details.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the operation; returns <see cref="OkResult"/> on successful update.</returns>
+    /// <!-- aidoc:v1 sig=bb6556e body=e750481 -->
     [HttpPut("relay")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -195,6 +211,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="id">The identifier of the PoC whose unit configuration should be updated, expected to be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> that produces an HTTP 200 (OK) response when the update succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when the supplied <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=f912787 body=6a18418 -->
     [HttpPut("{id}/unit")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -212,6 +229,7 @@ public class PointOfCareController(IPointOfCareService pointOfCareService)
     /// <param name="id">The string representation of the PoC's ObjectId to be deleted.</param>
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 200 OK response when the deletion succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=e0ae37f body=c175eaa -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/ProxyDeviceController.cs b/adas-core/Controllers/ProxyDeviceController.cs
index 8c752d1d..e2c2dc79 100644
--- a/adas-core/Controllers/ProxyDeviceController.cs
+++ b/adas-core/Controllers/ProxyDeviceController.cs
@@ -26,6 +26,7 @@ public class ProxyDeviceController(IProxyDeviceService proxyDeviceService) : Con
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose stream should be retrieved.</param>
     /// <returns>A <see cref="FileStreamResult"/> containing the proxied device stream, or a <see cref="StatusCodeResult"/> reflecting the upstream HTTP status when the proxy call fails.</returns>
+    /// <!-- aidoc:v1 sig=d2c2f50 body=a0b42a2 -->
     [HttpGet("{deviceId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetStreamById(string deviceId)
@@ -44,6 +45,7 @@ public class ProxyDeviceController(IProxyDeviceService proxyDeviceService) : Con
     /// </summary>
     /// <param name="deviceId">The unique identifier of the device whose content is being requested.</param>
     /// <returns>An <see cref="IActionResult"/> containing the proxied content stream for the specified device.</returns>
+    /// <!-- aidoc:v1 sig=4812787 body=de62b8b -->
     [HttpGet("{deviceId}/content")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetContentById(string deviceId)
@@ -61,6 +63,7 @@ public class ProxyDeviceController(IProxyDeviceService proxyDeviceService) : Con
     /// Forwards the upstream status code when the proxy call is not successful, defaults the response content type to <c>multipart/x-mixed-replace</c> when none is provided, and returns 404 (or the original status code) if the upstream request fails.
     /// </summary>
     /// <param name="deviceId">The identifier of the device whose MJPEG stream should be retrieved and forwarded to the caller.</param>
+    /// <!-- aidoc:v1 sig=727bd90 body=1ebb922 -->
     [HttpGet("{deviceId}/mjpeg-stream")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task GetAsMpegStreamById(string deviceId)
diff --git a/adas-core/Controllers/PumpsController.cs b/adas-core/Controllers/PumpsController.cs
index 25de599c..c733c5da 100644
--- a/adas-core/Controllers/PumpsController.cs
+++ b/adas-core/Controllers/PumpsController.cs
@@ -44,6 +44,7 @@ public class PumpController : ControllerBase
     /// </summary>
     /// <param name="pumpDto">The pump data transfer object received in the request body, containing the patient number, location, pump observations, message time, and wait result flag.</param>
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=e6d26d1 body=f8ed0cd -->
     [HttpPost("request")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -72,6 +73,7 @@ public class PumpController : ControllerBase
     /// Requires the caller to have the "AuthSome" role and "DisplayId" permission on the "Source" resource.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the result of <c>_pumpService.GetAllPumpConfig()</c>.</returns>
+    /// <!-- aidoc:v1 sig=f0b0fe2 body=ef4e339 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -85,6 +87,7 @@ public class PumpController : ControllerBase
     /// </summary>
     /// <param name="id">The unique identifier of the pump configuration to retrieve.</param>
     /// <returns>An HTTP 200 response containing the pump configuration that matches the specified identifier.</returns>
+    /// <!-- aidoc:v1 sig=93c59a0 body=de31f9a -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -100,6 +103,7 @@ public class PumpController : ControllerBase
     /// <param name="configPumps">The pump configuration data to update, provided in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated pump configuration wrapped in an Ok response.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="configPumps"/> parameter is null.</exception>
+    /// <!-- aidoc:v1 sig=793e330 body=06d12b7 -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -120,6 +124,7 @@ public class PumpController : ControllerBase
     /// <param name="config">The pump configuration data supplied in the request body to be inserted.</param>
     /// <returns>An <see cref="IActionResult"/> containing the outcome of the pump configuration insertion.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="config"/> is null, indicating that required parameters are missing.</exception>
+    /// <!-- aidoc:v1 sig=5c5e235 body=a33665f -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -136,6 +141,7 @@ public class PumpController : ControllerBase
     /// </summary>
     /// <param name="id">The identifier of the pump configuration to delete.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the deletion operation.</returns>
+    /// <!-- aidoc:v1 sig=af97ca3 body=61abe4f -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -154,6 +160,7 @@ public class PumpController : ControllerBase
     /// <param name="config">The pagination filter that defines the paging parameters for the pump query.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated pump result.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="config"/> parameter is null.</exception>
+    /// <!-- aidoc:v1 sig=43f409f body=d32ce39 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -170,6 +177,7 @@ public class PumpController : ControllerBase
     /// </summary>
     /// <param name="newConfigO">The new pump configuration to be logged, or <see langword="null"/> if not applicable.</param>
     /// <param name="oldConfig">The previous pump configuration to be logged, or <see langword="null"/> if not applicable.</param>
+    /// <!-- aidoc:v1 sig=88e20b9 body=f2a9b56 -->
     private async Task LogHistoricalConfigChanged(ConfigPumps? newConfigO, ConfigPumps? oldConfig)
     {
         var user = HttpContext.User.Identity?.Name ?? HttpContext.Connection.RemoteIpAddress?.ToString();
diff --git a/adas-core/Controllers/RabbitController.cs b/adas-core/Controllers/RabbitController.cs
index 62a319ce..c3126cfd 100644
--- a/adas-core/Controllers/RabbitController.cs
+++ b/adas-core/Controllers/RabbitController.cs
@@ -20,6 +20,7 @@ public class RabbitController(ReceiverService receiverService) : ControllerBase
     /// </summary>
     /// <param name="queueName">The name of the error queue to be consumed.</param>
     /// <returns>An <see cref="IActionResult"/> containing a 200 OK response when the queue consumption is initiated.</returns>
+    /// <!-- aidoc:v1 sig=851dab8 body=e184144 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [Route("start-consume/{queueName}")]
@@ -36,6 +37,7 @@ public class RabbitController(ReceiverService receiverService) : ControllerBase
     /// </summary>
     /// <param name="queueName">The name of the error queue to process and stop consuming.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response once the error queue has been processed.</returns>
+    /// <!-- aidoc:v1 sig=18da1da body=e184144 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [Route("stop-consume/{queueName}")]
diff --git a/adas-core/Controllers/RecordingAlertController.cs b/adas-core/Controllers/RecordingAlertController.cs
index 47a6ca75..0abf26f7 100644
--- a/adas-core/Controllers/RecordingAlertController.cs
+++ b/adas-core/Controllers/RecordingAlertController.cs
@@ -24,6 +24,7 @@ public class RecordingAlertController : ControllerBase
     /// Initializes a new instance of the <see cref="RecordingAlertController"/> class with the specified recording alert service.
     /// </summary>
     /// <param name="recordingAlertService"> The service that handles the recording alert operations.</param> 
+    /// <!-- aidoc:v1 sig=860fe32 body=842e180 -->
     public RecordingAlertController(IRecordingAlertService recordingAlertService)
     {
         LogExecutionContext.TrySetTraceIdentifier(Guid.NewGuid().ToString(), true);
@@ -36,6 +37,7 @@ public class RecordingAlertController : ControllerBase
     /// Processes an incoming recording alert request by mapping the incoming DTO to an internal API request and persisting it either synchronously or asynchronously based on whether the caller requires a result.
     /// </summary>
     /// <param name="recordingAlertDto">The recording alert payload containing the patient number, location, recording alerts, recording data, message time, and a flag indicating whether the operation should wait for completion.</param>
+    /// <!-- aidoc:v1 sig=9fd7813 body=096e423 -->
     [HttpPost]
     [Route("")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
diff --git a/adas-core/Controllers/RelayController.cs b/adas-core/Controllers/RelayController.cs
index 698d6e4d..22f0786c 100644
--- a/adas-core/Controllers/RelayController.cs
+++ b/adas-core/Controllers/RelayController.cs
@@ -21,6 +21,8 @@ namespace adas_core.Controllers;
 /// Marked with <see cref="ApiControllerAttribute"/> to enable API-specific conventions and with <see cref="RouteAttribute"/> set to <c>Relay</c> to define the controller's route template. Inherits from <see cref="ControllerBase"/>.
 /// </remarks>
 /// <!-- aidoc:v1 sig=9e8b3f2 -->
+/// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+///      "The summary states actions are 'defined by its derived type', but RelayController is a concrete class (not a base class) and defines the actions itself; there is no derived type implied by the code." -->
 [ApiController]
 [Route("Relay")]
 public class RelayController : ControllerBase
@@ -57,6 +59,7 @@ public class RelayController : ControllerBase
     /// Retrieves the status of point-of-care sections by querying the relay status for each configured box and its associated relays. Returns a 404 Not Found when no configurations are available, or a list containing the unit, bed, and status for each relay when configurations exist.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> that is either a 404 Not Found when no configurations are found, or an HTTP 200 OK response containing a collection of objects with the unit name, bed, and relay status.</returns>
+    /// <!-- aidoc:v1 sig=2f5a4bb body=1d6bb17 -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("status")]
@@ -84,6 +87,7 @@ public class RelayController : ControllerBase
     /// </summary>
     /// <param name="action">The request payload containing the identifiers of the unit, point of care, and bed to power on.</param>
     /// <returns>An <see cref="IActionResult"/> representing the result of the power-on operation.</returns>
+    /// <!-- aidoc:v1 sig=8c6e90b body=d58ffb7 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("powerOn")]
@@ -100,6 +104,7 @@ public class RelayController : ControllerBase
     /// </summary>
     /// <param name="action">The power action request containing the unit identifier, point of care identifier, and bed information.</param>
     /// <returns>An <see cref="IActionResult"/> representing the result of the power off operation.</returns>
+    /// <!-- aidoc:v1 sig=8a35306 body=6af0b5d -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("powerOff")]
@@ -119,6 +124,7 @@ public class RelayController : ControllerBase
     /// <param name="bed">The bed identifier associated with the point of care.</param>
     /// <param name="action">The asynchronous operation to invoke against each relay found in the configuration.</param>
     /// <returns>An <see cref="IActionResult"/> that returns <c>Ok</c> when the action runs on the relays, <c>Conflict</c> if <paramref name="pointOfCareId"/> cannot be parsed as an <see cref="ObjectId"/>, or <c>NotFound</c> if the box or its relay configuration is missing.</returns>
+    /// <!-- aidoc:v1 sig=27c82fb body=302e63e -->
     private async Task<IActionResult> PowerAction(string unitId, string pointOfCareId, string bed, Func<Relay, Task> action)
     {
         if (!ObjectId.TryParse(pointOfCareId, out var poc)) return Conflict("Cannot parse to OBjectId");
@@ -150,6 +156,7 @@ public class RelayController : ControllerBase
     /// <param name="username">The username used for relay authentication.</param>
     /// <param name="password">The password used for relay authentication.</param>
     /// <returns>An <see cref="IActionResult"/> containing the relay status result returned by the relay service.</returns>
+    /// <!-- aidoc:v1 sig=040e0d5 body=ebc9c7b -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     [Route("{id}/status")]
@@ -190,6 +197,7 @@ public class RelayController : ControllerBase
     /// <param name="username">The username used to authenticate with the relay device.</param>
     /// <param name="password">The optional password used to authenticate with the relay device.</param>
     /// <returns>An <see cref="IActionResult"/> containing HTTP 200 with a success value on success, or HTTP 500 if the relay service fails.</returns>
+    /// <!-- aidoc:v1 sig=c060e85 body=8f6647f -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("{id}/power/on")]
@@ -238,6 +246,7 @@ public class RelayController : ControllerBase
     /// <param name="username">The username used for relay authentication.</param>
     /// <param name="password">The optional password used for relay authentication.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the outcome: Ok with a false value on success, or an Internal Server Error status if the power off operation fails.</returns>
+    /// <!-- aidoc:v1 sig=eb9f5dd body=de15b45 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("{id}/power/off")]
@@ -279,6 +288,7 @@ public class RelayController : ControllerBase
     /// <param name="pocId">The identifier of the point of connection, which must be a valid ObjectId string.</param>
     /// <param name="type">The relay type as a string, which is parsed into <see cref="RelayEnum.Type"/>.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the outcome: <see cref="BadRequestResult"/> for invalid input, <see cref="StatusCodeResult"/> for internal server errors, or <see cref="OkObjectResult"/> with <c>false</c> on success.</returns>
+    /// <!-- aidoc:v1 sig=b823aaf body=3c28a45 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [Route("manual/{status}")]
@@ -308,6 +318,8 @@ public class RelayController : ControllerBase
     /// <param name="withPoCs">Flag indicating whether to include related point of contact data in the response.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated relays.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=mentions_removed_behavior
+    ///      "The withPoCs parameter is documented as a flag controlling inclusion of point of contact data, but the method body never references withPoCs and just calls _relayService.GetPaginatedRelays(request) without it." -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> GetPaginatedUnits([FromBody] PaginationFilter request, bool withPoCs)
@@ -323,6 +335,7 @@ public class RelayController : ControllerBase
     /// <param name="request">The relay data to create, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the created relay.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=54d0394 body=9ba620f -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> CreateRelay([FromBody] Relay? request)
@@ -338,6 +351,7 @@ public class RelayController : ControllerBase
     /// <param name="id">The identifier of the relay to update, expected to be a valid ObjectId.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated relay when the operation succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> cannot be parsed as a valid ObjectId.</exception>
+    /// <!-- aidoc:v1 sig=0f5de22 body=6bdbf52 -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     public async Task<IActionResult> UpdateRelay([FromBody] Relay relay, string id)
@@ -352,6 +366,7 @@ public class RelayController : ControllerBase
 /// <summary>
 /// Represents a request to perform a power-related action, encapsulating the data required to execute the operation.
 /// </summary>
+/// <!-- aidoc:v1 sig=7a9eead -->
 public class PowerActionRequest
 {
     public string UnitId { get; set; } = null!;
diff --git a/adas-core/Controllers/SendAlertController.cs b/adas-core/Controllers/SendAlertController.cs
index 96baee83..5f190503 100644
--- a/adas-core/Controllers/SendAlertController.cs
+++ b/adas-core/Controllers/SendAlertController.cs
@@ -39,6 +39,7 @@ public class SendAlertController : ControllerBase
     /// Retrieves the list of error queues from the alert service.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the error queues returned by the service.</returns>
+    /// <!-- aidoc:v1 sig=bc15624 body=517f039 -->
     [HttpGet("rabbit")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public async Task<IActionResult> GetErrorQueues()
@@ -52,6 +53,7 @@ public class SendAlertController : ControllerBase
     /// Requires the AuthAdmin role; the performance data is fetched from the send alert service and returned in an HTTP 200 OK response.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the performance data returned by the service.</returns>
+    /// <!-- aidoc:v1 sig=21cf3fb body=7090353 -->
     [HttpGet("performance")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public IActionResult GetPerformance()
@@ -64,6 +66,7 @@ public class SendAlertController : ControllerBase
     /// Retrieves the list of configured API clients. Restricted to users with the AuthAdmin role.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the collection of API clients returned by the send alert service.</returns>
+    /// <!-- aidoc:v1 sig=27a031e body=b1ab33b -->
     [HttpGet("api-clients")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public async Task<IActionResult> GetApiClients()
@@ -77,6 +80,7 @@ public class SendAlertController : ControllerBase
     /// </summary>
     /// <param name="sub">The push subscription payload received from the client, containing the endpoint and cryptographic keys required for delivering web push notifications.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response with a confirmation message indicating the subscription was accepted.</returns>
+    /// <!-- aidoc:v1 sig=b3d3d17 body=cafc5c7 -->
     [HttpPost("web-subscribe")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public IActionResult WebSubscribe([FromBody] PushSubscription sub)
@@ -90,6 +94,7 @@ public class SendAlertController : ControllerBase
     /// </summary>
     /// <param name="sub">The push subscription to remove, identified by its endpoint.</param>
     /// <returns>An <see cref="IActionResult"/> containing a success message when the subscription is removed, or a failure message when no matching subscription is found.</returns>
+    /// <!-- aidoc:v1 sig=5a00ee5 body=b8a0c6f -->
     [HttpPost("web-unsubscribe")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public IActionResult WebUnSubscribe([FromBody] PushSubscription sub)
@@ -110,6 +115,7 @@ public class SendAlertController : ControllerBase
     /// <param name="sub">The endpoint identifier of the push subscription that will receive the notification.</param>
     /// <param name="message">The payload to send, serialized to JSON before transmission.</param>
     /// <returns>An <see cref="IActionResult"/> that returns NotFound if the subscription is not found, or Ok when the notification is sent successfully.</returns>
+    /// <!-- aidoc:v1 sig=55ecc8f body=50db4af -->
     [HttpPost("broadcast/{sub}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public IActionResult Broadcast(string sub, [FromBody] object message)
diff --git a/adas-core/Controllers/ServiceConfigController.cs b/adas-core/Controllers/ServiceConfigController.cs
index 85bc0028..26a3a2e3 100644
--- a/adas-core/Controllers/ServiceConfigController.cs
+++ b/adas-core/Controllers/ServiceConfigController.cs
@@ -36,6 +36,7 @@ public class ServiceConfigController : ControllerBase
     /// </summary>
     /// <param name="id">The unique identifier of the service configuration to retrieve.</param>
     /// <returns>An <see cref="IActionResult"/> containing the requested service configuration.</returns>
+    /// <!-- aidoc:v1 sig=bd2ffbf body=1db1264 -->
     [HttpGet("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthAdmin)]
     public async Task<IActionResult> Find(string id)
diff --git a/adas-core/Controllers/TreatmentsController.cs b/adas-core/Controllers/TreatmentsController.cs
index 14a1311a..0161693e 100644
--- a/adas-core/Controllers/TreatmentsController.cs
+++ b/adas-core/Controllers/TreatmentsController.cs
@@ -47,6 +47,7 @@ public class TreatmentsController : ControllerBase
     /// <param name="treatmentDto">The treatment payload received in the request body, providing patient number, location, message time, wait result, and the optional treatment to forward.</param>
     /// <returns>An <see cref="IActionResult"/> that yields <c>200 OK</c> once the request has been successfully saved.</returns>
     /// <exception cref="NotFoundException">Thrown when no patient is found for the <c>PatientNumber</c> provided in <paramref name="treatmentDto"/>.</exception>
+    /// <!-- aidoc:v1 sig=0bcf26e body=a86f9eb -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -100,6 +101,7 @@ public class TreatmentsController : ControllerBase
     /// <param name="patientid">The patient's identifier used to look up their treatments.</param>
     /// <returns>An <see cref="IActionResult"/> containing the first 50 treatments for the patient, sorted by order time.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="patientid"/> is not a valid identifier format.</exception>
+    /// <!-- aidoc:v1 sig=9596c16 body=d879c65 -->
     [HttpGet("{patientid}/patient-id")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -118,6 +120,7 @@ public class TreatmentsController : ControllerBase
     /// </summary>
     /// <param name="request">The <see cref="PatientTreatment"/> payload containing the treatment data to update.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated treatment in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=d7fba3e body=5d8e24b -->
     [HttpPut]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -135,6 +138,7 @@ public class TreatmentsController : ControllerBase
     /// <param name="patientId">The string representation of the patient's ObjectId used to identify the treatment to delete.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the delete operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="patientId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=e1bbe71 body=347424b -->
     [HttpDelete("{patientid}/patient-id")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -152,6 +156,7 @@ public class TreatmentsController : ControllerBase
     /// <param name="treatmentId">The unique identifier of the treatment to delete.</param>
     /// <returns>An <see cref="IActionResult"/> representing the result of the deletion operation.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="treatmentId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=a94480e body=63bffdf -->
     [HttpDelete("{treatmentId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -170,6 +175,7 @@ public class TreatmentsController : ControllerBase
     /// <param name="request">The pagination filter containing paging parameters used to query the treatments.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated treatments returned by the service.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=db316aa body=7eee186 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/UnitController.cs b/adas-core/Controllers/UnitController.cs
index 543e958f..08c55139 100644
--- a/adas-core/Controllers/UnitController.cs
+++ b/adas-core/Controllers/UnitController.cs
@@ -34,6 +34,12 @@ public class UnitController(
     /// <returns>
     ///     List<Unit />
     /// </returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary refers to 'GetByCodeSysAndCode' and 'all unit list', but the method is named List, takes a bool withPoCs parameter, and retrieves units via unitService.GetAll(withPoCs); there is no CodeSys/Code parameter." -->
+    /// <!-- aidoc-review:v1 severity=high kind=missing_param
+    ///      "The bool withPoCs route/query parameter is not documented." -->
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "Documented as 'List<Unit />' but the method signature returns Task<IActionResult> (with units wrapped in Ok)." -->
     [HttpGet("{withPoCs}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -47,6 +53,7 @@ public class UnitController(
     /// Retrieves a compact list of units, typically used for lightweight UI scenarios such as dropdowns or lookups.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the compact collection of units on success.</returns>
+    /// <!-- aidoc:v1 sig=0de17df body=66267bd -->
     [HttpGet("compact")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -63,6 +70,7 @@ public class UnitController(
     /// <param name="id">The string identifier of the unit to retrieve; must be a parseable identifier or a bad request is raised.</param>
     /// <returns>An <see cref="IActionResult"/> containing the compact unit payload when the id is valid.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> cannot be parsed as a valid identifier.</exception>
+    /// <!-- aidoc:v1 sig=d987898 body=7485af3 -->
     [HttpGet("compact/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -81,6 +89,7 @@ public class UnitController(
     /// <param name="withPoCs">A flag indicating whether the response should include the related PoCs for each unit.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated units wrapped in an HTTP 200 OK response.</returns>
     /// <exception cref="BadRequestException">Thrown when the <paramref name="request"/> parameter is null, indicating missing required parameters.</exception>
+    /// <!-- aidoc:v1 sig=f4816ee body=eb392f1 -->
     [HttpPost("paginated/{withPoCs}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -98,6 +107,8 @@ public class UnitController(
     /// <param name="id"></param>
     /// <param name="listFilled"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary references 'GetByCodeSysAndCode' but the method retrieves a unit by MongoDB ObjectId via ObjectId.TryParse, not by code system and code." -->
     [HttpGet("{id}/{listFilled}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -116,6 +127,8 @@ public class UnitController(
     /// </summary>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary 'GetByCodeSysAndCode unit status' references a 'GetByCodeSysAndCode' method/behavior not present in this code; the method just parses an id as ObjectId and returns the unit's status." -->
     [HttpGet("status/{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -134,6 +147,8 @@ public class UnitController(
     /// </summary>
     /// <param name="unitName"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=stale_summary
+    ///      "Summary references 'GetByCodeSysAndCode' which does not appear in the code; the method is named 'Config' and calls unitService.GetByName(unitName), not GetByCodeSysAndCode." -->
     [HttpGet("{unitName}/config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -148,6 +163,7 @@ public class UnitController(
     /// </summary>
     /// <param name="patientId"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=93e96bf body=66557cd -->
     [HttpGet("{patientId}/patient-id")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -166,6 +182,7 @@ public class UnitController(
     /// </summary>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=58556fd body=487f27d -->
     [HttpGet("{id}/point-of-cares")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -185,6 +202,8 @@ public class UnitController(
     /// </summary>
     /// <param name="unit"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "The method throws a ConflictException (HttpEnum.ErrorMessage.ConflictResourceAlreadyExists) when a unit with the same Id already exists, but this exception is not documented." -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -201,6 +220,8 @@ public class UnitController(
     /// </summary>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_summary
+    ///      "Summary says 'Post unit' but the method is a DELETE operation (HttpDelete attribute and DeleteUnit method name) that removes a unit, not creates/posts one." -->
     [HttpDelete("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -223,6 +244,8 @@ public class UnitController(
     /// <param name="id"></param>
     /// <param name="unit"></param>
     /// <returns></returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=missing_exception
+    ///      "Method throws BadRequestException when id is not a valid ObjectId, but no <exception> tag documents it" -->
     [HttpPut("{id}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -242,6 +265,7 @@ public class UnitController(
     /// </summary>
     /// <param name="updateUnitListDto"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=a466f6b body=c674264 -->
     [HttpPut("master-list-id")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -264,6 +288,7 @@ public class UnitController(
     /// <param name="unitConfiguration">The new configuration values supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the updated unit configuration when the operation succeeds.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="unitId"/> cannot be parsed as a valid id format.</exception>
+    /// <!-- aidoc:v1 sig=6a063de body=94c3a12 -->
     [HttpPut("{unitId}/config")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -281,6 +306,7 @@ public class UnitController(
     /// <param name="request"></param>
     /// <param name="id"></param>
     /// <returns></returns>
+    /// <!-- aidoc:v1 sig=a134102 body=bd6c88d -->
     [HttpPut("{id}/info")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -302,6 +328,7 @@ public class UnitController(
     /// <returns>An <see cref="IActionResult"/> containing the unit dependency DTO on success.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="id"/> is not a valid format or when the dependency DTO result cannot be retrieved.</exception>
     /// <exception cref="NotFoundException">Thrown when no unit exists with the specified identifier.</exception>
+    /// <!-- aidoc:v1 sig=305768c body=9e77614 -->
     [HttpGet("{id}/dependency")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/Controllers/UserController.cs b/adas-core/Controllers/UserController.cs
index 4e806097..276231f9 100644
--- a/adas-core/Controllers/UserController.cs
+++ b/adas-core/Controllers/UserController.cs
@@ -34,6 +34,7 @@ public class UserController(
     /// </summary>
     /// <param name="loginInfo">The login payload containing the username and password to authenticate.</param>
     /// <returns>An <see cref="IActionResult"/> containing a successful response with the authenticated <see cref="TokenResult"/>.</returns>
+    /// <!-- aidoc:v1 sig=831e97b body=f708739 -->
     [AllowAnonymous]
     [HttpPost("login")]
     public async Task<IActionResult> Login([FromBody] LoginInfo loginInfo)
@@ -49,6 +50,7 @@ public class UserController(
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing the generated JWT token and user authorization details wrapped in a <see cref="UciResponse{T}"/>.</returns>
     /// <exception cref="UnauthorizedException">Thrown when no user is found in <c>HttpContext.Items["User"]</c>, indicating the user is not registered.</exception>
+    /// <!-- aidoc:v1 sig=f93e890 body=c08677a -->
     [AllowAnonymous]
     [HttpGet("token")]
     public async Task<IActionResult> LoginWithBearer()
@@ -66,6 +68,7 @@ public class UserController(
     /// </summary>
     /// <param name="token">The access token supplied via the query string used to perform the login.</param>
     /// <returns>An <see cref="IActionResult"/> containing a successful response with the access token information and its expiry time.</returns>
+    /// <!-- aidoc:v1 sig=1d6cd0a body=e357316 -->
     [AllowAnonymous]
     [HttpGet("login")]
     public async Task<IActionResult> LoginWithAccessToken([FromQuery] string token)
@@ -83,6 +86,7 @@ public class UserController(
     /// </summary>
     /// <param name="refreshToken">The refresh token obtained from a previous authentication request, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing a <see cref="UciResponse{TokenResult}"/> with the refreshed token details on success.</returns>
+    /// <!-- aidoc:v1 sig=7dea9d0 body=8423dfa -->
     [AllowAnonymous]
     [HttpPost("refresh-token")]
     public async Task<IActionResult> RefreshToken([FromBody] string refreshToken)
@@ -98,6 +102,7 @@ public class UserController(
     /// <param name="ticket">The CAS ticket to validate against the user service.</param>
     /// <returns>A 200 OK response with a JWT token if the user is found; otherwise, a 404 Not Found response.</returns>
     /// <exception cref="UnauthorizedException">Thrown when an error occurs during user lookup or JWT generation, indicating the user is not authorized.</exception>
+    /// <!-- aidoc:v1 sig=9505873 body=d585fc3 -->
     [AllowAnonymous]
     [HttpGet("login-cas")]
     public async Task<IActionResult> LoginWithCas([FromQuery] string service, [FromQuery] string ticket)
@@ -126,6 +131,7 @@ public class UserController(
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing a successful response with the authenticated <see cref="User"/>.</returns>
     /// <exception cref="UnauthorizedException">Thrown when the user retrieved from the HTTP context items is null, indicating the user is not registered.</exception>
+    /// <!-- aidoc:v1 sig=6093fec body=2e5f4e8 -->
     [HttpGet("me")]
     public IActionResult Me()
     {
@@ -138,6 +144,7 @@ public class UserController(
     /// Retrieves all users from the system.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing a <see cref="UciResponse{T}"/> with the list of <see cref="User"/> objects retrieved via the user service.</returns>
+    /// <!-- aidoc:v1 sig=05e6ade body=4a6a44e -->
     [HttpGet]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -152,6 +159,7 @@ public class UserController(
     /// Retrieves all available authorities. Requires the AuthSome role and permission to display Source entities.
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing a successful response with the list of <see cref="Authorization"/> objects.</returns>
+    /// <!-- aidoc:v1 sig=1373b6d body=3b049da -->
     [HttpGet("authorities")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -168,6 +176,7 @@ public class UserController(
     /// <param name="config">The pagination filter applied to the user query, supplied in the request body.</param>
     /// <returns>An <see cref="IActionResult"/> containing the paginated users produced by the user service.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="config"/> is <c>null</c>.</exception>
+    /// <!-- aidoc:v1 sig=317949f body=3b52dd1 -->
     [HttpPost("paginated")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -185,6 +194,7 @@ public class UserController(
     /// </summary>
     /// <param name="loginInfo">The login credentials (username and password) used to authenticate the user.</param>
     /// <returns>A successful response containing the authentication token, the user's authorities, and the resolved panel permissions.</returns>
+    /// <!-- aidoc:v1 sig=4c2cf8a body=36a9c4c -->
     [AllowAnonymous]
     [HttpPost("login/adm-panel")]
     public async Task<IActionResult> LoginPanel([FromBody] LoginInfo loginInfo)
@@ -205,6 +215,7 @@ public class UserController(
     /// </summary>
     /// <returns>An <see cref="IActionResult"/> containing a successful <see cref="UciResponse{T}"/> of <see cref="TokenResultPanel"/> with the generated token, the user's authorization, and the permissions applicable to the panel.</returns>
     /// <exception cref="UnauthorizedException">Thrown when no user is found in <c>HttpContext.Items["User"]</c>, indicating an unauthorized user that is not registered.</exception>
+    /// <!-- aidoc:v1 sig=8758741 body=053547f -->
     [AllowAnonymous]
     [HttpGet("token/adm-panel")]
     public async Task<IActionResult> LoginWithBearerPanel()
@@ -226,6 +237,7 @@ public class UserController(
     /// </summary>
     /// <param name="token">The access token used to authenticate the user for the administrative panel.</param>
     /// <returns>An <see cref="IActionResult"/> containing a successful response with the token result and the associated panel permissions.</returns>
+    /// <!-- aidoc:v1 sig=f8ffae8 body=107f44e -->
     [AllowAnonymous]
     [HttpGet("login/adm-panel")]
     public async Task<IActionResult> LoginWithAccessTokenPanel([FromQuery] string token)
@@ -244,6 +256,7 @@ public class UserController(
     /// </summary>
     /// <param name="refreshToken">The refresh token string provided in the request body used to obtain a new access token.</param>
     /// <returns>An <see cref="IActionResult"/> containing a <see cref="UciResponse{TokenResultPanel}"/> with the refreshed token result and the associated permissions for the panel.</returns>
+    /// <!-- aidoc:v1 sig=925766f body=df73d2c -->
     [HttpPost("refresh-token/adm-panel")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -263,6 +276,7 @@ public class UserController(
     /// </summary>
     /// <param name="u">The user data submitted in the request used to create the new user.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly created user in an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=018356b body=aab5bb2 -->
     [HttpPost]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -277,6 +291,7 @@ public class UserController(
     /// </summary>
     /// <param name="createUserWithAuthDto">The DTO containing the new user's information and the authorities to assign.</param>
     /// <returns>An <see cref="IActionResult"/> containing the created user returned via an HTTP 200 OK response.</returns>
+    /// <!-- aidoc:v1 sig=a9a9a53 body=b7843af -->
     [HttpPost("authorities")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -294,6 +309,7 @@ public class UserController(
     /// <returns>An <see cref="IActionResult"/> indicating a successful operation via <see cref="OkResult"/> when the user is removed.</returns>
     /// <exception cref="BadRequestException">Thrown when <paramref name="userId"/> is not a valid identifier format.</exception>
     /// <exception cref="ConflictException">Thrown when the user could not be deleted.</exception>
+    /// <!-- aidoc:v1 sig=942d9d8 body=055b3cb -->
     [HttpDelete("{userId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -319,6 +335,7 @@ public class UserController(
     /// <param name="updatePass">Indicates whether the password should be updated as part of the operation.</param>
     /// <returns>An <see cref="IActionResult"/> representing a successful update (<c>200 OK</c>).</returns>
     /// <exception cref="ConflictException">Thrown when <c>userService.UpdateUsersByRequest</c> returns <c>null</c>, indicating the update could not be completed.</exception>
+    /// <!-- aidoc:v1 sig=2736dc0 body=1014159 -->
     [HttpPut("{updatePass}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -336,6 +353,7 @@ public class UserController(
     /// <param name="updateUserWithAuthDto">The data transfer object containing the updated user information and authority assignments.</param>
     /// <param name="updatePass">Flag indicating whether the user's password should be updated.</param>
     /// <returns>An <see cref="IActionResult"/> representing an HTTP 200 OK response on successful update.</returns>
+    /// <!-- aidoc:v1 sig=fbf97e3 body=d0636c8 -->
     [HttpPut("{updatePass}/authorities")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -351,6 +369,7 @@ public class UserController(
     /// </summary>
     /// <param name="authorization">The authorization data used to create the new authority.</param>
     /// <returns>An <see cref="IActionResult"/> containing the newly created authority.</returns>
+    /// <!-- aidoc:v1 sig=d47a60b body=a1bfa6e -->
     [HttpPost("authority")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -366,6 +385,7 @@ public class UserController(
     /// </summary>
     /// <param name="authorityId">The identifier of the authority to delete.</param>
     /// <returns>An <see cref="IActionResult"/> containing an HTTP 200 OK response upon successful deletion.</returns>
+    /// <!-- aidoc:v1 sig=74181b5 body=940f132 -->
     [HttpDelete("authority/{authorityId}")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -380,6 +400,7 @@ public class UserController(
     /// </summary>
     /// <param name="auths">The list of authority identifiers to be deleted.</param>
     /// <returns>An <see cref="IActionResult"/> indicating the result of the operation; returns <see cref="OkResult"/> upon successful completion.</returns>
+    /// <!-- aidoc:v1 sig=dde695d body=9493c21 -->
     [HttpPut("authorities")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -396,6 +417,7 @@ public class UserController(
     /// <param name="updatePasswordDto">The data transfer object containing the current and new password values.</param>
     /// <returns>An <see cref="IActionResult"/> containing the result of the password update operation.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="id"/> is not a valid identifier format.</exception>
+    /// <!-- aidoc:v1 sig=efa6e5d body=755730a -->
     [HttpPost("{id}/password")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -414,6 +436,7 @@ public class UserController(
     /// </summary>
     /// <param name="authorization">The authorization details to be applied to the user.</param>
     /// <returns>An <see cref="IActionResult"/> containing an <see cref="Microsoft.AspNetCore.Mvc.OkResult"/> when the authority update succeeds.</returns>
+    /// <!-- aidoc:v1 sig=f17d90d body=3eec90c -->
     [HttpPut("authority")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
@@ -430,6 +453,7 @@ public class UserController(
     /// <param name="userId">The string representation of the user's identifier whose authorities are being requested.</param>
     /// <returns>An HTTP 200 response containing a <see cref="UciResponse{T}"/> with the list of <see cref="Authorization"/> objects for the user.</returns>
     /// <exception cref="BadRequestException">Thrown when the provided <paramref name="userId"/> is not a valid ObjectId format.</exception>
+    /// <!-- aidoc:v1 sig=8a665e9 body=6cf2ba4 -->
     [HttpGet("{userId}/authority")]
     [AuthorizeRoles(PermissionEnum.RolesType.AuthSome)]
     [PermissionAuthorize("Source", "DisplayId")]
diff --git a/adas-core/ErrorMiddleware/ErrorHandlerMiddleware.cs b/adas-core/ErrorMiddleware/ErrorHandlerMiddleware.cs
index bb788984..ab568ffc 100644
--- a/adas-core/ErrorMiddleware/ErrorHandlerMiddleware.cs
+++ b/adas-core/ErrorMiddleware/ErrorHandlerMiddleware.cs
@@ -11,6 +11,7 @@ namespace adas_core.ErrorMiddleware;
 /// This middleware is typically registered in the application's request pipeline to intercept and handle exceptions
 /// thrown by subsequent middleware components, while leveraging the injected logger to record error information.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8f8e99a -->
 public class ErrorHandlerMiddleware(RequestDelegate next, ILogger<ErrorHandlerMiddleware> logger)
 {
     /// <summary>
@@ -18,6 +19,7 @@ public class ErrorHandlerMiddleware(RequestDelegate next, ILogger<ErrorHandlerMi
     /// For unrecognized exceptions, it falls back to a 500 Internal Server Error response without exposing internal details.
     /// </summary>
     /// <param name="context">The current HTTP request context used to invoke the next middleware, read the trace identifier, and write the error response.</param>
+    /// <!-- aidoc:v1 sig=660b696 body=1c80c6b -->
     public async Task InvokeAsync(HttpContext context)
     {
         try
diff --git a/adas-core/Logging/LogExecutionContext.cs b/adas-core/Logging/LogExecutionContext.cs
index 0d9178b1..508465f8 100644
--- a/adas-core/Logging/LogExecutionContext.cs
+++ b/adas-core/Logging/LogExecutionContext.cs
@@ -8,6 +8,7 @@ namespace adas_core.Logging;
 /// <remarks>
 /// This class serves as a centralized holder for execution-scoped data that can be referenced by logging components throughout the application lifecycle.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8206cf9 -->
 public static class LogExecutionContext
 {
     private static readonly AsyncLocal<string> AsyncLocalTraceIdentifier = new();
@@ -18,6 +19,7 @@ public static class LogExecutionContext
     /// 
     /// Trace identifier.
     /// If existing trace ID should be replaced (set to true ONLY if you receive and handle traced entities in a constant context)!
+    /// <!-- aidoc:v1 sig=a1fc905 body=a291060 -->
     public static bool TrySetTraceIdentifier(string traceIdentifier, bool force = false)
     {
         return TrySetValue(nameof(TraceIdentifier), traceIdentifier, AsyncLocalTraceIdentifier, string.IsNullOrEmpty,
@@ -33,6 +35,7 @@ public static class LogExecutionContext
     /// <param name="valueInvalidator">Predicate that returns true for values that must not be accepted, applied to both the new and current value.</param>
     /// <param name="force">When true, bypasses the existing-value check and always overwrites the ambient value.</param>
     /// <returns><c>true</c> if the new value was applied to <paramref name="ambientHolder"/>; otherwise <c>false</c>, including when the candidate is invalid, the ambient already holds a different non-null valid value, or no change was needed.</returns>
+    /// <!-- aidoc:v1 sig=f57df9f body=5cebb49 -->
     private static bool TrySetValue(
             string contextPropertyName,
             string newValue,
diff --git a/adas-core/Logging/LogProvider.cs b/adas-core/Logging/LogProvider.cs
index 148f4ec6..a318f3bf 100644
--- a/adas-core/Logging/LogProvider.cs
+++ b/adas-core/Logging/LogProvider.cs
@@ -9,6 +9,7 @@ namespace adas_core.Logging;
 /// As a static class, it cannot be instantiated or inherited and is intended to expose
 /// logging operations as shared members.
 /// </remarks>
+/// <!-- aidoc:v1 sig=abe48d9 -->
 public static class LogProvider
 {
     private static ILoggerFactory? _loggerFactory;
@@ -17,6 +18,7 @@ public static class LogProvider
     ///     Sets the current log provider based on logger factory.
     /// </summary>
     /// <param name="loggerFactory">The logger factory.</param>
+    /// <!-- aidoc:v1 sig=3cf26f7 body=3b66d6e -->
     public static void SetLogProvider(ILoggerFactory loggerFactory)
     {
         _loggerFactory = loggerFactory;
@@ -27,6 +29,7 @@ public static class LogProvider
     /// </summary>
     /// <param name="category">The category name for the logger to create.</param>
     /// <returns>An <see cref="ILogger"/> instance for the specified category, or a <see cref="NullLogger"/> when no logger factory is available.</returns>
+    /// <!-- aidoc:v1 sig=3d00893 body=86a88e0 -->
     public static ILogger CreateLogger(string category)
     {
         if (_loggerFactory != null) return _loggerFactory.CreateLogger(category);
@@ -38,6 +41,7 @@ public static class LogProvider
     /// Creates an <see cref="ILogger{T}"/> instance using the configured logger factory, or returns a <see cref="NullLogger{T}"/> instance when no factory has been set.
     /// </summary>
     /// <returns>An <see cref="ILogger{T}"/> produced by the underlying <see cref="ILoggerFactory"/> if available; otherwise, a shared <see cref="NullLogger{T}"/> instance used as a no-op fallback.</returns>
+    /// <!-- aidoc:v1 sig=76698e3 body=249c786 -->
     public static ILogger<T> CreateLogger<T>()
     {
         if (_loggerFactory != null) return _loggerFactory.CreateLogger<T>();
@@ -49,6 +53,7 @@ public static class LogProvider
         /// <summary>
         /// Provides static utility members for caching values within the assembly.
         /// </summary>
+        /// <!-- aidoc:v1 sig=e4e77ec -->
         internal static class Cached
         {
             internal static readonly System.Lazy<System.Diagnostics.DiagnosticListener> Default =
diff --git a/adas-core/WebSocket/Hubs/UciHub.cs b/adas-core/WebSocket/Hubs/UciHub.cs
index 287b35c5..c68ec3f4 100644
--- a/adas-core/WebSocket/Hubs/UciHub.cs
+++ b/adas-core/WebSocket/Hubs/UciHub.cs
@@ -30,6 +30,7 @@ public class UciHub(
     /// that shares the same connection id to avoid duplicates on reconnection, and then invoking the base connection handler.
     /// Any exception encountered during processing is logged and surfaced as a failed task.
     /// </summary>
+    /// <!-- aidoc:v1 sig=2439e13 body=ce921ee -->
     public override async Task OnConnectedAsync()
     {
         try
@@ -62,6 +63,7 @@ public class UciHub(
     /// when an exception is provided, while normal disconnections are logged at debug level.
     /// </summary>
     /// <param name="exception">The exception that caused the disconnection, or <c>null</c> when the disconnection was not caused by an error.</param>
+    /// <!-- aidoc:v1 sig=ef306e8 body=ea6c34d -->
     public override async Task OnDisconnectedAsync(Exception? exception)
     {
         if (exception != null)
@@ -105,6 +107,7 @@ public class UciHub(
     /// any exception thrown during processing is caught and logged without rethrowing.
     /// </summary>
     /// <param name="subMessage">The raw JSON payload received from the client representing the subscription request.</param>
+    /// <!-- aidoc:v1 sig=1352107 body=e83ed0f -->
     [HubMethodName("subscribe")]
     public async Task OnSubscribe(string subMessage)
     {
@@ -142,6 +145,7 @@ public class UciHub(
     /// Unsubscribes the current SignalR client by removing its connection from the subscribers service. 
     /// Logs and swallows any error encountered during connection removal.
     /// </summary>
+    /// <!-- aidoc:v1 sig=fcf3887 body=a6b90b9 -->
     [HubMethodName("unsubscribe")]
     public void UnSubscribe()
     {
@@ -161,6 +165,7 @@ public class UciHub(
     /// Deserializes the payload into a <see cref="Message"/> instance and delegates processing to the client message service, logging and ignoring malformed payloads or unexpected errors.
     /// </summary>
     /// <param name="message">The raw JSON payload of the chat message sent by the client.</param>
+    /// <!-- aidoc:v1 sig=b6ed6d8 body=b3b1ce7 -->
     [HubMethodName("chatMessage")]
     public async Task OnChatMessage(string message)
     {
diff --git a/adas-core/WebSocket/WebSocketMessageService.cs b/adas-core/WebSocket/WebSocketMessageService.cs
index 8a5b75ca..701d9fe3 100644
--- a/adas-core/WebSocket/WebSocketMessageService.cs
+++ b/adas-core/WebSocket/WebSocketMessageService.cs
@@ -81,6 +81,7 @@ public class WebSocketMessageService(
     /// </param>
     /// <param name="connectionId">The unique identifier of the WebSocket subscriber that originated the request.</param>
     /// <returns>A <see cref="Task"/> that completes when the demo request has been processed and all patient data has been dispatched.</returns>
+    /// <!-- aidoc:v1 sig=acb669a body=29942dd -->
     private async Task ProcessDemoRequest(Message msg, string connectionId)
     {
         var sub = subscribersService.GetById(connectionId);
@@ -151,6 +152,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The message to process, whose data and user name are used to identify the subscriber.</param>
     /// <param name="connectionId">The connection identifier of the admin subscriber that will receive the message display.</param>
+    /// <!-- aidoc:v1 sig=2dca0a8 body=1793c22 -->
     private void ProcessAdminSubscriber(Message msg, string connectionId)
     {
         if (msg.Data?.UserName == null) return;
@@ -172,6 +174,7 @@ public class WebSocketMessageService(
     /// <param name="connectionId">The unique identifier of the WebSocket subscriber that originated the request.</param>
     /// <returns>A <see cref="Task"/> that completes once the synchronous portion of the processing has finished; 
     /// several sub-tasks (display list, recordings, relay states, beacons) are dispatched fire-and-forget.</returns>
+    /// <!-- aidoc:v1 sig=67f1e79 body=fcb0ee9 -->
     private async Task ProcessDisplaySubscriber(Message msg, string connectionId)
     {
         var id = msg.Data?.DisplayId;
@@ -409,6 +412,7 @@ public class WebSocketMessageService(
     /// <param name="suscriptionType">The subscription type that determines whether additional box-specific data should be dispatched.</param>
     /// <param name="display">The display whose configuration and points of care will be processed; only valid when its configuration is a <c>StandarDisplay</c> with a non-null section configuration.</param>
     /// <param name="connectionId">The identifier of the client connection that will receive the emitted messages.</param>
+    /// <!-- aidoc:v1 sig=9cf850a body=18ab364 -->
     private async Task ProcessStandard(SubscriptionEnum.Type suscriptionType, Display display, string connectionId)
     {
         var standarDisplayCast = display.DisplayConfig as StandarDisplay;
@@ -460,6 +464,7 @@ public class WebSocketMessageService(
     /// <param name="displayId">The identifier of the display configuration to query.</param>
     /// <param name="dataUserName">The optional user name used to filter the display section results.</param>
     /// <param name="connectionId">The identifier of the connection to which the display list will be sent.</param>
+    /// <!-- aidoc:v1 sig=ddaf6f8 body=70d05bd -->
     private async Task ProcessDisplayList(
             DisplayConfigEnums.DisplayType displayType,
             ObjectId displayId,
@@ -477,6 +482,7 @@ public class WebSocketMessageService(
     /// <param name="displayPointOfCares">The list of PointOfCare objects to process.</param>
     /// <param name="connectionId">The ID of the connection for which to send the data.</param>
     /// <param name="msg">The message object.</param>
+    /// <!-- aidoc:v1 sig=b170754 body=8e7ac22 -->
     private async Task ProcessPocList(List<PointOfCare> displayPointOfCares, string connectionId, Message msg)
     {
         //TODO revisar si es necesario que se envíen los pocs aquí si no está en modo demo ¿redundante?
@@ -499,6 +505,7 @@ public class WebSocketMessageService(
     /// <param name="id">The identifier of the unit whose master lists should be processed and pushed to the client.</param>
     /// <param name="connectionId">The identifier of the client connection that will receive the unit information and master list updates.</param>
     /// <param name="dataLocale">The optional locale used to localize the retrieved unit data and master lists.</param>
+    /// <!-- aidoc:v1 sig=c9f696b body=27d3a5c -->
     private async void ProcessMasterList(ObjectId id, string connectionId, LocaleEnum? dataLocale)
     {
         try
@@ -545,6 +552,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="displayId">The display identifier used to look up the notice; if it cannot be parsed as an ObjectId, the method returns without further action.</param>
     /// <param name="connectionId">The identifier of the connection to which each retrieved notice is dispatched as a new-notice operation.</param>
+    /// <!-- aidoc:v1 sig=dbc78f8 body=769d3f4 -->
     private async void ProcessNotice(string displayId, string connectionId)
     {
         try
@@ -578,6 +586,7 @@ public class WebSocketMessageService(
     /// <param name="dataLocations">The list of point-of-care location identifiers to process for discharge data.</param>
     /// <param name="connectionId">The identifier of the client connection used to send the new discharge notification.</param>
     /// <param name="dataLocale">The locale used to retrieve the discharge data.</param>
+    /// <!-- aidoc:v1 sig=d1bcb4e body=a9a7686 -->
     private async void ProcessDischarge(List<ObjectId> dataLocations, string connectionId, LocaleEnum dataLocale)
     {
         try
@@ -612,6 +621,7 @@ public class WebSocketMessageService(
     /// <param name="displayUnitId">The optional display unit identifier; when provided, admissions assigned to that unit without a point of care are also broadcast.</param>
     /// <param name="connectionId">The identifier of the client connection to which the admission updates are sent.</param>
     /// <param name="dataLocale">The locale used to filter admissions retrieved for the given data locations.</param>
+    /// <!-- aidoc:v1 sig=00fafc2 body=3d2767d -->
     private async void ProcessAdmission(List<ObjectId> dataLocations, ObjectId? displayUnitId,
             string connectionId, LocaleEnum dataLocale)
     {
@@ -645,6 +655,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The message to process, containing the operation type and payload.</param>
     /// <param name="connectionId">The identifier of the connection that originated the message.</param>
+    /// <!-- aidoc:v1 sig=61dc511 body=060ae25 -->
     public async Task ProcessMessage(Message msg, string connectionId)
     {
         try
@@ -696,6 +707,7 @@ public class WebSocketMessageService(
     /// <param name="msg">The message containing the location, optional time zone, and grouped fields to process.</param>
     /// <param name="connectionId">The identifier of the client connection used to send the generated observations.</param>
     /// <returns>A task that represents the asynchronous processing of the grouped observations.</returns>
+    /// <!-- aidoc:v1 sig=269edd5 body=683ecb2 -->
     private async Task ProcessGroupedObservations(Message msg, string connectionId)
     {
         if (msg.Data is { GroupedFields: not null } && msg.Data.GroupedFields.Any())
@@ -744,6 +756,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The incoming message containing the current recordings to be broadcast.</param>
     /// <param name="connectionId">The identifier of the subscriber's connection used to look up the subscriber and target the alert.</param>
+    /// <!-- aidoc:v1 sig=53affe0 body=75aa973 -->
     private async Task ProcessRecordingMessage(Message msg, string connectionId)
     {
         //var subscribers = Subscribers.Instance.GetSubscribers();
@@ -764,6 +777,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The message payload carrying the patient reference, either as a <c>PatientId</c> or a location.</param>
     /// <param name="connectionId">The identifier of the connection to which the resolved patient data should be sent.</param>
+    /// <!-- aidoc:v1 sig=040dec0 body=57f542b -->
     private async Task ProcessPatientData(Message msg, string connectionId)
     {
         Patient? patient = new();
@@ -790,6 +804,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The incoming message envelope whose <c>Data</c> contains the source location, destination location, section, timestamp, and chat text.</param>
     /// <param name="connectionId">The connection identifier used to deliver the chat message via <c>SendAsync</c>.</param>
+    /// <!-- aidoc:v1 sig=40739c8 body=aee2e09 -->
     private async Task ProcessChatMessage(Message msg, string connectionId)
     {
         var fromLocation = msg.Data?.Location;
@@ -823,6 +838,7 @@ public class WebSocketMessageService(
     /// Sends an update message to all subscribers associated with the given patient locations. If the location has no bed specified, subscribers are matched by section; otherwise, subscribers are matched by both box (bed) and section.
     /// </summary>
     /// <param name="patientLocations">The list of patient locations used to determine which subscribers should receive the update message.</param>
+    /// <!-- aidoc:v1 sig=2dd2993 body=ed2ace3 -->
     public void SendUpdateMessageToBoxes(List<PatientLocation> patientLocations)
     {
         var subscribers = new List<WsSubscriber>();
@@ -855,6 +871,7 @@ public class WebSocketMessageService(
     /// <param name="connectionId">The identifier of the client connection that will receive the data.</param>
     /// <param name="configObservations">Optional collection of configuration observations used when sending the latest alarms.</param>
     /// <param name="ct">Cancellation token to cancel the asynchronous operations.</param>
+    /// <!-- aidoc:v1 sig=3772c2a body=877c09b -->
     private async Task SendPatientData(
             Patient patient,
             Message msg,
@@ -896,6 +913,7 @@ public class WebSocketMessageService(
     /// <param name="data">The message payload that provides the fields to query and indicates whether a demo data source should be used.</param>
     /// <param name="connectionId">The identifier of the target client connection that will receive the observations.</param>
     /// <param name="ct">The cancellation token used to cancel the observation retrieval operation.</param>
+    /// <!-- aidoc:v1 sig=ed4a70f body=514256c -->
     private async Task SendLatestObservationsAsync(
             Patient patient,
             MessageData data,
@@ -933,6 +951,7 @@ public class WebSocketMessageService(
     /// <param name="msgData">The originating message data used for logging context when an error occurs.</param>
     /// <param name="subscriberId">The identifier of the subscriber that will receive the appointment notifications.</param>
     /// <param name="ct">The cancellation token used to cancel the appointment retrieval operation.</param>
+    /// <!-- aidoc:v1 sig=014a8e9 body=59ff510 -->
     private async Task SendPatientAppointmentsAsync(
             Patient patient,
             MessageData msgData,
@@ -962,6 +981,7 @@ public class WebSocketMessageService(
     /// <param name="data">The message data containing the alarm fields to evaluate and the demo mode flag.</param>
     /// <param name="configObservations">Optional configuration observations used to select the alarm lookup strategy.</param>
     /// <param name="connectionId">The identifier of the target client connection to which the alarm observations are sent.</param>
+    /// <!-- aidoc:v1 sig=93b4ced body=7d4fea9 -->
     private async Task SendLatestAlarmsAsync(
             Patient patient,
             MessageData data,
@@ -1011,6 +1031,8 @@ public class WebSocketMessageService(
     /// <param name="data">Message metadata containing the timestamp used to scope the lookup of recent observations.</param>
     /// <param name="connectionId">The identifier of the connection to which the mapped pump observations are dispatched.</param>
     /// <param name="ct">Token used to cancel the asynchronous operation.</param>
+    /// <!-- aidoc-review:v1 severity=medium kind=wrong_param_role
+    ///      "The `ct` parameter is documented as 'Token used to cancel the asynchronous operation', but it is never passed to any awaited call in the method body (FindLastPumpObservations, MapPumpObservation) and therefore does not actually enable cancellation." -->
     private async Task SendLatestPumpsAsync(
             Patient patient,
             MessageData data,
@@ -1047,6 +1069,7 @@ public class WebSocketMessageService(
     /// <param name="patient">The patient whose treatments should be retrieved and transmitted.</param>
     /// <param name="data">The message data associated with the current operation.</param>
     /// <param name="connectionId">The identifier of the connection used to dispatch the treatment messages.</param>
+    /// <!-- aidoc:v1 sig=d3dda51 body=efb168c -->
     private async Task SendTreatmentsAsync(
             Patient patient,
             MessageData data,
@@ -1077,6 +1100,7 @@ public class WebSocketMessageService(
     /// <param name="patient">The patient whose diagnosis records should be retrieved and sent.</param>
     /// <param name="data">The message data associated with the current operation, used for logging purposes.</param>
     /// <param name="connectionId">The identifier of the connection used to send the diagnosis messages.</param>
+    /// <!-- aidoc:v1 sig=6420c6b body=e167a23 -->
     private async Task SendDiagnosisAsync(
             Patient patient,
             MessageData data,
@@ -1109,6 +1133,7 @@ public class WebSocketMessageService(
     /// <param name="data">The message data containing the grouped fields, demo flag, and optional timezone used to drive the generation path.</param>
     /// <param name="connectionId">The identifier of the connection used to dispatch the grouped observations.</param>
     /// <param name="ct">The cancellation token used to cancel the grouped observation generation.</param>
+    /// <!-- aidoc:v1 sig=f293260 body=57548e4 -->
     private async Task SendGroupedObsAsync(
             Patient patient,
             MessageData data,
@@ -1148,6 +1173,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="poc">The point of care whose beacon color and identifiers will be transmitted.</param>
     /// <param name="connectionId">The identifier of the target client connection that will receive the beacon payload.</param>
+    /// <!-- aidoc:v1 sig=52c8f51 body=867b1c3 -->
     private async Task SendBeaconsData(
             PointOfCare poc,
             string connectionId)
@@ -1166,6 +1192,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="msg">The incoming message whose operation determines the subscription type and whose data provides the section and bed/box information.</param>
     /// <param name="connectionId">The unique identifier of the WebSocket connection used to look up or register the subscriber.</param>
+    /// <!-- aidoc:v1 sig=419b672 body=a880e43 -->
     private void AddMessagetoSubcriber(Message msg, string connectionId)
     {
         SubscriptionEnum.WsType? subType = null;
@@ -1233,6 +1260,7 @@ public class WebSocketMessageService(
     /// <param name="msg">The incoming message whose display data (locations, location ids, display id, locale, and user name) is applied to the subscriber.</param>
     /// <param name="connectionId">The unique identifier of the WebSocket connection used to look up an existing subscriber.</param>
     /// <param name="subType">The optional WebSocket subscription type to assign to the subscriber.</param>
+    /// <!-- aidoc:v1 sig=5495c37 body=b78ab5d -->
     private void AddMessageDisplayToSubcriber(Message msg, string connectionId, SubscriptionEnum.WsType? subType)
     {
         var subscriber = subscribersService.GetSubscribers().FirstOrDefault(s => s.Id == connectionId);
@@ -1278,6 +1306,7 @@ public class WebSocketMessageService(
     /// <param name="subscriberId">The identifier of the SignalR client connection that should receive the message.</param>
     /// <param name="type">The optional operation type associated with the message, included in the payload as its string representation when present.</param>
     /// <param name="msg">The message object to serialize and send. May be <c>null</c>.</param>
+    /// <!-- aidoc:v1 sig=07c74e4 body=ab17e64 -->
     public async Task SendAsync(string subscriberId, OperationType? type, object? msg)
     {
         try
@@ -1305,6 +1334,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="type">The operation type that identifies the kind of message being broadcast.</param>
     /// <param name="msg">The message payload to serialize and send. Can be null.</param>
+    /// <!-- aidoc:v1 sig=e81fa21 body=c3c74e3 -->
     public async Task SendToAllAsync(OperationType type, object? msg)
     {
         var settings = new JsonSerializerSettings
@@ -1326,6 +1356,7 @@ public class WebSocketMessageService(
     /// </summary>
     /// <param name="errorMessage">The error description to include in the message body sent to the client.</param>
     /// <param name="connectionId">The SignalR connection identifier of the target client that should receive the error message.</param>
+    /// <!-- aidoc:v1 sig=f463d25 body=7054a96 -->
     private async Task SendErrorMessage(string errorMessage, string connectionId)
     {
         var msg = JsonConvert.SerializeObject(new Dictionary<string, object>