canvas 0.63.0__py3-none-any.whl → 0.89.0__py3-none-any.whl

canvas_sdk/v1/data/questionnaire.py

@@ -10,19 +10,17 @@ from canvas_sdk.v1.data.base import (
     CommittableQuerySetMixin,
     ForPatientQuerySetMixin,
     IdentifiableModel,
-    Model,
+    TimestampedModel,
     ValueSetLookupByNameQuerySet,
 )
 
 
-class ResponseOptionSet(Model):
+class ResponseOptionSet(TimestampedModel):
     """ResponseOptionSet."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_responseoptionset_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     name = models.CharField(max_length=255)
     code_system = models.CharField(max_length=255)
@@ -31,14 +29,12 @@ class ResponseOptionSet(Model):
     use_in_shx = models.BooleanField()
 
 
-class ResponseOption(Model):
+class ResponseOption(TimestampedModel):
     """ResponseOption."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_responseoption_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     name = models.CharField(max_length=255)
     code = models.CharField(max_length=100)
@@ -50,14 +46,12 @@ class ResponseOption(Model):
     ordering = models.IntegerField()
 
 
-class Question(IdentifiableModel):
+class Question(TimestampedModel, IdentifiableModel):
     """Question."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_question_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     name = models.CharField(max_length=255)
     response_option_set = models.ForeignKey(
@@ -78,7 +72,7 @@ class QuestionnaireValueSetLookupQuerySet(ValueSetLookupByNameQuerySet):
         return Q(code_system=system, code__in=codes)
 
 
-class Questionnaire(IdentifiableModel):
+class Questionnaire(TimestampedModel, IdentifiableModel):
     """Questionnaire."""
 
     class Meta:
@@ -86,8 +80,6 @@ class Questionnaire(IdentifiableModel):
 
     objects = models.Manager.from_queryset(QuestionnaireValueSetLookupQuerySet)()
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     name = models.CharField(max_length=255)
     expected_completion_time = models.FloatField()
@@ -104,20 +96,18 @@ class Questionnaire(IdentifiableModel):
     carry_forward = models.TextField()
 
 
-class QuestionnaireQuestionMap(Model):
+class QuestionnaireQuestionMap(TimestampedModel):
     """QuestionnaireQuestionMap."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_questionnairequestionmap_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     questionnaire = models.ForeignKey(Questionnaire, on_delete=models.DO_NOTHING, null=True)
     question = models.ForeignKey(Question, on_delete=models.DO_NOTHING, null=True)
 
 
-class InterviewQuerySet(BaseQuerySet, ForPatientQuerySetMixin, CommittableQuerySetMixin):
+class InterviewQuerySet(ForPatientQuerySetMixin, CommittableQuerySetMixin, BaseQuerySet):
     """InterviewQuerySet."""
 
     pass
@@ -126,7 +116,7 @@ class InterviewQuerySet(BaseQuerySet, ForPatientQuerySetMixin, CommittableQueryS
 InterviewManager = BaseModelManager.from_queryset(InterviewQuerySet)
 
 
-class Interview(IdentifiableModel):
+class Interview(TimestampedModel, IdentifiableModel):
     """Interview."""
 
     class Meta:
@@ -155,31 +145,25 @@ class Interview(IdentifiableModel):
         through="v1.InterviewQuestionnaireMap",
     )
     progress_status = models.CharField(max_length=3)
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
 
 
-class InterviewQuestionnaireMap(Model):
+class InterviewQuestionnaireMap(TimestampedModel):
     """InterviewQuestionnaireMap."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_interviewquestionnairemap_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     interview = models.ForeignKey(Interview, on_delete=models.DO_NOTHING, null=True)
     questionnaire = models.ForeignKey(Questionnaire, on_delete=models.DO_NOTHING, null=True)
 
 
-class InterviewQuestionResponse(Model):
+class InterviewQuestionResponse(TimestampedModel):
     """InterviewQuestionResponse."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_interviewquestionresponse_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     status = models.CharField(max_length=2)
     interview = models.ForeignKey(
         Interview, on_delete=models.DO_NOTHING, related_name="interview_responses", null=True

canvas_sdk/v1/data/reason_for_visit.py

@@ -2,9 +2,10 @@ from django.contrib.postgres.fields import ArrayField
 from django.db import models
 
 from canvas_sdk.v1.data.base import IdentifiableModel
+from canvas_sdk.v1.data.coding import Coding
 
 
-class ReasonForVisitSettingCoding(IdentifiableModel):
+class ReasonForVisitSettingCoding(IdentifiableModel, Coding):
     """ReasonForVisitSettingCoding."""
 
     class Meta:
@@ -12,11 +13,6 @@ class ReasonForVisitSettingCoding(IdentifiableModel):
 
     objects: models.Manager["ReasonForVisitSettingCoding"]
 
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-
     duration = ArrayField(models.DurationField())
 
 

canvas_sdk/v1/data/referral.py

@@ -1,29 +1,26 @@
 import json
+from typing import cast
 
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel
+from canvas_sdk.v1.data.base import (
+    AuditedModel,
+    BaseModelManager,
+    BaseQuerySet,
+    CommittableQuerySetMixin,
+    ForPatientQuerySetMixin,
+    IdentifiableModel,
+    TimestampedModel,
+)
 from canvas_sdk.v1.data.task import Task
 
 
-class Referral(IdentifiableModel):
+class Referral(AuditedModel, IdentifiableModel):
     """Referral."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_referral_001"
 
-    created = models.DateTimeField()
-    modified = models.DateTimeField()
-    originator = models.ForeignKey(
-        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
-    )
-    deleted = models.BooleanField()
-    committer = models.ForeignKey(
-        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
-    )
-    entered_in_error = models.ForeignKey(
-        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
-    )
     patient = models.ForeignKey("v1.Patient", on_delete=models.DO_NOTHING)
     note = models.ForeignKey("v1.Note", on_delete=models.DO_NOTHING)
     service_provider = models.ForeignKey(
@@ -66,14 +63,38 @@ class Referral(IdentifiableModel):
         return f"Referral {self.id}"
 
 
-class ReferralReport(IdentifiableModel):
+class ReferralReviewQuerySet(CommittableQuerySetMixin, ForPatientQuerySetMixin, BaseQuerySet):
+    """A queryset for referral reviews."""
+
+    pass
+
+
+ReferralReviewManager = BaseModelManager.from_queryset(ReferralReviewQuerySet)
+
+
+class ReferralReview(AuditedModel, IdentifiableModel):
+    """ReferralReview."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_referralreview_001"
+
+    objects = cast(ReferralReviewQuerySet, ReferralReviewManager())
+
+    internal_comment = models.TextField()
+    message_to_patient = models.CharField(max_length=2048)
+    status = models.CharField(max_length=50)
+    patient = models.ForeignKey(
+        "v1.Patient", on_delete=models.DO_NOTHING, related_name="referral_reviews", null=True
+    )
+    patient_communication_method = models.CharField(max_length=30)
+
+
+class ReferralReport(TimestampedModel, IdentifiableModel):
     """ReferralReport."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_referralreport_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     originator = models.ForeignKey(
         "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
     )
@@ -94,6 +115,9 @@ class ReferralReport(IdentifiableModel):
         Referral, on_delete=models.DO_NOTHING, related_name="reports", null=True
     )
     specialty = models.CharField(max_length=250)
+    review = models.ForeignKey(
+        "ReferralReview", related_name="reports", null=True, blank=True, on_delete=models.SET_NULL
+    )
     original_date = models.DateField(null=True)
     comment = models.TextField()
     priority = models.BooleanField(default=False)

canvas_sdk/v1/data/staff.py

@@ -5,7 +5,7 @@ from django.db import models
 from django.db.models.enums import TextChoices
 from timezone_utils.fields import TimeZoneField
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
+from canvas_sdk.v1.data.base import IdentifiableModel, Model, TimestampedModel
 from canvas_sdk.v1.data.common import (
     AddressState,
     AddressType,
@@ -19,7 +19,7 @@ from canvas_sdk.v1.data.common import (
 from canvas_sdk.v1.data.utils import create_key
 
 
-class Staff(Model):
+class Staff(TimestampedModel):
     """Staff."""
 
     class Meta:
@@ -35,8 +35,6 @@ class Staff(Model):
         editable=False,
         default=create_key,
     )
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     prefix = models.CharField(max_length=100)
     suffix = models.CharField(max_length=100)
     first_name = models.CharField(max_length=255)
@@ -44,7 +42,7 @@ class Staff(Model):
     last_name = models.CharField(max_length=255)
     maiden_name = models.CharField(max_length=255)
     nickname = models.CharField(max_length=255)
-    previous_names = models.JSONField()
+    previous_names = models.JSONField(default=list)
     birth_date = models.DateField(null=True)
     sex_at_birth = models.CharField(choices=PersonSex.choices, max_length=3)
     sexual_orientation_term = models.CharField(max_length=255)
@@ -57,14 +55,14 @@ class Staff(Model):
     cultural_ethnicity_codes = ArrayField(models.CharField(max_length=100))
     cultural_ethnicity_terms = ArrayField(models.CharField(max_length=255))
     last_known_timezone = TimeZoneField(null=True)
-    active = models.BooleanField()
+    active = models.BooleanField(default=True)
     primary_practice_location = models.ForeignKey(
         "v1.PracticeLocation", on_delete=models.DO_NOTHING, null=True
     )
     npi_number = models.CharField(max_length=10)
     nadean_number = models.CharField(max_length=20)
     group_npi_number = models.CharField(max_length=10)
-    bill_through_organization = models.BooleanField()
+    bill_through_organization = models.BooleanField(default=True)
     tax_id = models.CharField(max_length=25)
     tax_id_type = models.CharField(choices=TaxIDType.choices, max_length=1)
     spi_number = models.CharField(max_length=50)
@@ -72,9 +70,9 @@ class Staff(Model):
     # language = models.ForeignKey('v1.Language', on_delete=models.DO_NOTHING, related_name="staff_speakers", null=True)
     # language_secondary = models.ForeignKey('v1.Language', on_delete=models.DO_NOTHING, related_name="staff_secondary_speakers", null=True)
     personal_meeting_room_link = models.URLField(null=True)
-    state = models.JSONField()
-    user = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
-    schedule_column_ordering = models.IntegerField()
+    state = models.JSONField(default=dict, blank=True)
+    user = models.OneToOneField("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
+    schedule_column_ordering = models.IntegerField(default=999)
     default_supervising_provider = models.ForeignKey(
         "v1.Staff", on_delete=models.DO_NOTHING, related_name="supervising_team", null=True
     )
@@ -135,10 +133,14 @@ class StaffContactPoint(IdentifiableModel):
 
     system = models.CharField(choices=ContactPointSystem.choices, max_length=20)
     value = models.CharField(max_length=100)
-    use = models.CharField(choices=ContactPointUse.choices, max_length=20)
+    use = models.CharField(
+        choices=ContactPointUse.choices, max_length=20, default=ContactPointUse.HOME
+    )
     use_notes = models.CharField(max_length=255)
-    rank = models.IntegerField()
-    state = models.CharField(choices=ContactPointState.choices, max_length=20)
+    rank = models.IntegerField(default=1)
+    state = models.CharField(
+        choices=ContactPointState.choices, max_length=20, default=ContactPointState.ACTIVE
+    )
     staff = models.ForeignKey(Staff, on_delete=models.DO_NOTHING, related_name="telecom")
 
 
@@ -148,31 +150,31 @@ class StaffAddress(IdentifiableModel):
     class Meta:
         db_table = "canvas_sdk_data_api_staffaddress_001"
 
-    line1 = models.CharField(max_length=255)
-    line2 = models.CharField(max_length=255)
+    line1 = models.CharField(max_length=255, default="", blank=True)
+    line2 = models.CharField(max_length=255, default="", blank=True)
     city = models.CharField(max_length=255)
-    district = models.CharField(max_length=255)
+    district = models.CharField(max_length=255, blank=True, default="")
     state_code = models.CharField(max_length=2)
     postal_code = models.CharField(max_length=255)
-    use = models.CharField(choices=AddressUse.choices, max_length=10)
-    type = models.CharField(choices=AddressType.choices, max_length=10)
-    longitude = models.FloatField()
-    latitude = models.FloatField()
-    start = models.DateField()
-    end = models.DateField()
+    use = models.CharField(choices=AddressUse.choices, max_length=10, default=AddressUse.HOME)
+    type = models.CharField(choices=AddressType.choices, max_length=10, default=AddressType.BOTH)
+    longitude = models.FloatField(null=True, default=None, blank=True)
+    latitude = models.FloatField(null=True, default=None, blank=True)
+    start = models.DateField(null=True, blank=True)
+    end = models.DateField(null=True, blank=True)
     country = models.CharField(max_length=255)
-    state = models.CharField(choices=AddressState.choices, max_length=20)
+    state = models.CharField(
+        choices=AddressState.choices, max_length=20, default=AddressState.ACTIVE
+    )
     staff = models.ForeignKey(Staff, on_delete=models.DO_NOTHING, related_name="addresses")
 
 
-class StaffPhoto(Model):
+class StaffPhoto(TimestampedModel):
     """StaffPhoto."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_staffphoto_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     staff = models.ForeignKey(Staff, on_delete=models.CASCADE, related_name="photos")
     url = models.CharField(
         default="https://d3hn0m4rbsz438.cloudfront.net/avatar1.png", max_length=512
@@ -185,6 +187,12 @@ class StaffRole(Model):
 
     class Meta:
         db_table = "canvas_sdk_data_api_staffrole_001"
+        constraints = [
+            models.UniqueConstraint(
+                fields=["staff", "internal_code"],
+                name="staff_internal_code_unique",
+            )
+        ]
 
     class RoleDomain(TextChoices):
         CLINICAL = "CLI", "Clinical"

canvas_sdk/v1/data/stop_medication_event.py

@@ -0,0 +1,27 @@
+from django.db import models
+
+from canvas_sdk.v1.data.base import AuditedModel, IdentifiableModel
+
+
+class StopMedicationEvent(AuditedModel, IdentifiableModel):
+    """StopMedicationEvent."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_stopmedicationevent_001"
+
+    patient = models.ForeignKey(
+        "v1.Patient", on_delete=models.DO_NOTHING, related_name="stopped_medications"
+    )
+    note = models.ForeignKey(
+        "v1.Note", on_delete=models.DO_NOTHING, related_name="stopped_medications"
+    )
+    medication = models.ForeignKey(
+        "v1.Medication",
+        on_delete=models.DO_NOTHING,
+        related_name="stopmedicationevent_set",
+        null=True,
+    )
+    rationale = models.CharField(max_length=1024, default="")
+
+
+__exports__ = ("StopMedicationEvent",)

canvas_sdk/v1/data/task.py

@@ -1,7 +1,7 @@
 from django.contrib.postgres.fields import ArrayField
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
+from canvas_sdk.v1.data.base import IdentifiableModel, Model, TimestampedModel
 from canvas_sdk.v1.data.common import ColorEnum, Origin
 
 
@@ -31,16 +31,15 @@ class TaskLabelModule(models.TextChoices):
 
     CLAIMS = "claims", "Claims"
     TASKS = "tasks", "Tasks"
+    APPOINTMENTS = "appointments", "Appointments"
 
 
-class Task(IdentifiableModel):
+class Task(TimestampedModel, IdentifiableModel):
     """Task."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_task_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     creator = models.ForeignKey(
         "v1.Staff", on_delete=models.DO_NOTHING, related_name="creator_tasks", null=True
     )
@@ -60,14 +59,12 @@ class Task(IdentifiableModel):
     status = models.CharField(choices=TaskStatus.choices, max_length=9)
 
 
-class TaskComment(IdentifiableModel):
+class TaskComment(TimestampedModel, IdentifiableModel):
     """TaskComment."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_taskcomment_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     creator = models.ForeignKey(
         "v1.Staff", on_delete=models.DO_NOTHING, related_name="comments", null=True
     )
@@ -82,12 +79,22 @@ class TaskLabel(IdentifiableModel):
         db_table = "canvas_sdk_data_api_tasklabel_001"
 
     tasks = models.ManyToManyField(Task, related_name="labels", through="TaskTaskLabel")  # type: ignore[var-annotated]
+    claims = models.ManyToManyField("v1.Claim", related_name="labels", through="v1.ClaimLabel")
+    appointments = models.ManyToManyField(
+        "v1.Appointment", related_name="labels", through="v1.AppointmentLabel"
+    )
     position = models.IntegerField()
-    color = models.CharField(choices=ColorEnum.choices, max_length=50)
-    task_association = ArrayField(models.CharField(choices=Origin.choices, max_length=32))
+    color = models.CharField(choices=ColorEnum.choices, max_length=50, blank=True, default="")
+    task_association = ArrayField(
+        models.CharField(choices=Origin.choices, max_length=32), blank=True, default=list
+    )
     name = models.CharField(max_length=255)
-    active = models.BooleanField()
-    modules = ArrayField(models.CharField(choices=TaskLabelModule.choices, max_length=32))
+    active = models.BooleanField(default=True)
+    modules = ArrayField(
+        models.CharField(choices=TaskLabelModule.choices, max_length=32),
+        blank=True,
+        default=list,
+    )
 
 
 class TaskTaskLabel(Model):
@@ -100,6 +107,17 @@ class TaskTaskLabel(Model):
     task = models.ForeignKey(Task, on_delete=models.DO_NOTHING, null=True)
 
 
+class TaskMetadata(IdentifiableModel):
+    """TaskMetadata."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_taskmetadata_001"
+
+    task = models.ForeignKey(Task, on_delete=models.CASCADE, related_name="metadata")
+    key = models.CharField(max_length=32)
+    value = models.CharField(max_length=255)
+
+
 __exports__ = (
     "TaskType",
     "EventType",
@@ -109,4 +127,5 @@ __exports__ = (
     "TaskComment",
     "TaskLabel",
     "TaskTaskLabel",
+    "TaskMetadata",
 )

canvas_sdk/v1/data/team.py

@@ -1,7 +1,7 @@
 from django.contrib.postgres.fields import ArrayField
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel
+from canvas_sdk.v1.data.base import IdentifiableModel, TimestampedModel
 from canvas_sdk.v1.data.common import ContactPointState, ContactPointSystem, ContactPointUse
 
 
@@ -39,14 +39,12 @@ class TeamResponsibility(models.TextChoices):
     REVIEW_COVERAGES = "REVIEW_COVERAGES", "Review incomplete patient coverages"
 
 
-class Team(IdentifiableModel):
+class Team(TimestampedModel, IdentifiableModel):
     """Team."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_team_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     name = models.CharField(max_length=200)
     responsibilities = ArrayField(
         models.CharField(choices=TeamResponsibility.choices, max_length=64)

canvas_sdk/v1/data/uncategorized_clinical_document.py

@@ -0,0 +1,84 @@
+from typing import cast
+
+from django.db import models
+
+from canvas_sdk.v1.data.base import (
+    AuditedModel,
+    BaseModelManager,
+    BaseQuerySet,
+    CommittableQuerySetMixin,
+    ForPatientQuerySetMixin,
+    IdentifiableModel,
+    TimestampedModel,
+)
+
+
+class UncategorizedClinicalDocumentReviewQuerySet(
+    CommittableQuerySetMixin, ForPatientQuerySetMixin, BaseQuerySet
+):
+    """A queryset for uncategorized clinical document reviews."""
+
+    pass
+
+
+UncategorizedClinicalDocumentReviewManager = BaseModelManager.from_queryset(
+    UncategorizedClinicalDocumentReviewQuerySet
+)
+
+
+class UncategorizedClinicalDocumentReview(AuditedModel, IdentifiableModel):
+    """UncategorizedClinicalDocumentReview."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_uncategorizeddocumentreview_001"
+
+    objects = cast(
+        UncategorizedClinicalDocumentReviewQuerySet, UncategorizedClinicalDocumentReviewManager()
+    )
+
+    internal_comment = models.TextField()
+    message_to_patient = models.CharField(max_length=2048)
+    status = models.CharField(max_length=50)
+    patient = models.ForeignKey(
+        "v1.Patient",
+        on_delete=models.DO_NOTHING,
+        related_name="uncategorized_clinical_document_reviews",
+        null=True,
+    )
+    patient_communication_method = models.CharField(max_length=30)
+
+
+class UncategorizedClinicalDocument(TimestampedModel, IdentifiableModel):
+    """UncategorizedClinicalDocument."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_uncategorizedclinicaldocument_001"
+
+    patient = models.ForeignKey("v1.Patient", on_delete=models.DO_NOTHING, related_name="+")
+    originator = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
+    assigned_by = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
+    review = models.ForeignKey(
+        "v1.UncategorizedClinicalDocumentReview",
+        related_name="reports",
+        null=True,
+        blank=True,
+        on_delete=models.SET_NULL,
+    )
+    team = models.ForeignKey("v1.Team", on_delete=models.DO_NOTHING, null=True)
+
+    name = models.CharField(max_length=255)
+    review_mode = models.CharField(max_length=2)
+    junked = models.BooleanField(default=False)
+    requires_signature = models.BooleanField(default=False)
+    assigned_date = models.DateTimeField(null=True)
+    team_assigned_date = models.DateTimeField(null=True)
+    original_date = models.DateField(null=True)
+    comment = models.TextField(default="", blank=True)
+    priority = models.BooleanField(default=False)
+
+
+__exports__ = ("UncategorizedClinicalDocumentReview", "UncategorizedClinicalDocument")

canvas_sdk/v1/data/user.py

@@ -1,7 +1,13 @@
+from functools import cached_property
+from typing import TYPE_CHECKING
+
 from django.db import models
 
 from canvas_sdk.v1.data.base import Model
 
+if TYPE_CHECKING:
+    from canvas_sdk.v1.data import Patient, Staff
+
 
 class CanvasUser(Model):
     """A class representing a Canvas User."""
@@ -13,6 +19,14 @@ class CanvasUser(Model):
     phone_number = models.CharField(db_column="phone_number", max_length=255)
     last_invite_date_time = models.DateTimeField(null=True, blank=True)
     is_portal_registered = models.BooleanField(default=False)
+    is_staff = models.BooleanField(default=False)
+
+    @cached_property
+    def person_subclass(self) -> "Staff | Patient":
+        """
+        Return either the related Staff or Patient object.
+        """
+        return self.staff if self.is_staff else self.patient
 
 
 __exports__ = ("CanvasUser",)

canvas_sdk/v1/data/utils.py

@@ -29,4 +29,9 @@ def generate_mrn(length: int = 9, max_attempts: int = 100) -> str:
     raise RuntimeError(f"Unable to generate a unique MRN after {max_attempts} attempts")
 
 
+def empty_note_body() -> list[dict[str, str]]:
+    """Generates an empty note body with 15 empty text elements."""
+    return [{"type": "text", "value": ""}] * 15
+
+
 __exports__ = ()

canvas_sdk/value_set/v2026/__init__.py

@@ -0,0 +1 @@
+__exports__ = ()