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

adas-core.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; }