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

canvas_sdk/v1/data/observation.py

@@ -3,17 +3,19 @@ from typing import cast
 from django.db import models
 
 from canvas_sdk.v1.data.base import (
+    AuditedModel,
     BaseModelManager,
     CommittableQuerySetMixin,
     ForPatientQuerySetMixin,
     IdentifiableModel,
-    Model,
+    TimestampedModel,
     ValueSetLookupQuerySet,
 )
+from canvas_sdk.v1.data.coding import Coding
 
 
 class ObservationQuerySet(
-    ValueSetLookupQuerySet, CommittableQuerySetMixin, ForPatientQuerySetMixin
+    CommittableQuerySetMixin, ForPatientQuerySetMixin, ValueSetLookupQuerySet
 ):
     """ObservationQuerySet."""
 
@@ -23,7 +25,7 @@ class ObservationQuerySet(
 ObservationManager = BaseModelManager.from_queryset(ObservationQuerySet)
 
 
-class Observation(IdentifiableModel):
+class Observation(AuditedModel, IdentifiableModel):
     """Observation."""
 
     class Meta:
@@ -31,18 +33,6 @@ class Observation(IdentifiableModel):
 
     objects = cast(ObservationQuerySet, ObservationManager())
 
-    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="+"
-    )
-    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="+"
-    )
-    deleted = models.BooleanField()
     patient = models.ForeignKey(
         "v1.Patient", on_delete=models.DO_NOTHING, related_name="observations", null=True
     )
@@ -57,30 +47,23 @@ class Observation(IdentifiableModel):
     effective_datetime = models.DateTimeField()
 
 
-class ObservationCoding(Model):
+class ObservationCoding(Coding):
     """ObservationCoding."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_observationcoding_001"
 
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    user_selected = models.BooleanField()
     observation = models.ForeignKey(
         Observation, on_delete=models.DO_NOTHING, related_name="codings", null=True
     )
 
 
-class ObservationComponent(Model):
+class ObservationComponent(TimestampedModel):
     """ObservationComponent."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_observationcomponent_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     observation = models.ForeignKey(
         Observation, on_delete=models.DO_NOTHING, related_name="components", null=True
     )
@@ -89,33 +72,23 @@ class ObservationComponent(Model):
     name = models.TextField()
 
 
-class ObservationComponentCoding(Model):
+class ObservationComponentCoding(Coding):
     """ObservationComponentCoding."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_observationcomponentcoding_001"
 
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    user_selected = models.BooleanField()
     observation_component = models.ForeignKey(
         ObservationComponent, on_delete=models.DO_NOTHING, related_name="codings", null=True
     )
 
 
-class ObservationValueCoding(Model):
+class ObservationValueCoding(Coding):
     """ObservationValueCoding."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_observationvaluecoding_001"
 
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    user_selected = models.BooleanField()
     observation = models.ForeignKey(
         Observation, on_delete=models.DO_NOTHING, related_name="value_codings", null=True
     )

canvas_sdk/v1/data/organization.py

@@ -1,32 +1,93 @@
 from django.db import models
 
-from canvas_sdk.v1.data.base import Model
-from canvas_sdk.v1.data.common import TaxIDType
+from canvas_sdk.v1.data.base import IdentifiableModel, TimestampedModel
+from canvas_sdk.v1.data.common import (
+    AddressState,
+    AddressType,
+    AddressUseWithBilling,
+    ContactPointState,
+    ContactPointSystem,
+    ContactPointUse,
+    TaxIDType,
+)
 
 
-class Organization(Model):
+class Organization(TimestampedModel):
     """Organization."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_organization_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     full_name = models.CharField(max_length=255)
     short_name = models.CharField(max_length=255)
     subdomain = models.CharField(max_length=100)
     logo_url = models.CharField(max_length=255)
     background_image_url = models.CharField(max_length=255)
     background_gradient = models.CharField(max_length=255)
-    active = models.BooleanField()
+    active = models.BooleanField(default=True)
     tax_id = models.CharField(null=True, max_length=25)
     tax_id_type = models.CharField(choices=TaxIDType.choices, max_length=1)
     group_npi_number = models.CharField(max_length=10)
     group_taxonomy_number = models.CharField(max_length=10)
-    include_zz_qualifier = models.BooleanField()
+    include_zz_qualifier = models.BooleanField(default=False)
     main_location = models.OneToOneField(
-        "v1.PracticeLocation", on_delete=models.DO_NOTHING, related_name="+"
+        "PracticeLocation", related_name="+", null=True, on_delete=models.PROTECT
     )
 
 
-__exports__ = ("Organization",)
+class OrganizationAddress(IdentifiableModel):
+    """Organization Address."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_organizationaddress_001"
+
+    organization = models.ForeignKey(
+        "v1.Organization", on_delete=models.PROTECT, related_name="addresses"
+    )
+    use = models.CharField(
+        choices=AddressUseWithBilling.choices, max_length=10, default=AddressUseWithBilling.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, default=AddressState.ACTIVE
+    )
+    address_search_index = models.TextField(default="", null=True, blank=True)
+    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, blank=True, default="")
+    state_code = models.CharField(max_length=2)
+    postal_code = models.CharField(max_length=255)
+
+
+class OrganizationContactPoint(IdentifiableModel):
+    """OrganizationContactPoint."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_organizationcontactpoint_001"
+
+    organization = models.ForeignKey(
+        "v1.Organization", on_delete=models.PROTECT, related_name="telecom"
+    )
+    system = models.CharField(choices=ContactPointSystem.choices, max_length=20, db_index=True)
+    value = models.CharField(max_length=100, db_index=True)
+    use = models.CharField(
+        choices=ContactPointUse.choices, max_length=20, default=ContactPointUse.HOME
+    )
+    use_notes = models.CharField(max_length=255, blank=True, default="")
+    rank = models.IntegerField(default=1)
+    state = models.CharField(
+        choices=ContactPointState.choices, max_length=20, default=ContactPointState.ACTIVE
+    )
+
+
+__exports__ = (
+    "Organization",
+    "OrganizationAddress",
+    "OrganizationContactPoint",
+)

canvas_sdk/v1/data/patient.py

@@ -7,7 +7,7 @@ from django.contrib.postgres.fields import ArrayField
 from django.db import models
 from django.db.models import TextChoices
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
+from canvas_sdk.v1.data.base import IdentifiableModel, TimestampedModel
 from canvas_sdk.v1.data.common import (
     AddressState,
     AddressType,
@@ -39,7 +39,7 @@ class PatientSettingConstants:
     PREFERRED_SCHEDULING_TIMEZONE = "preferredSchedulingTimezone"
 
 
-class Patient(Model):
+class Patient(TimestampedModel):
     """A class representing a patient."""
 
     class Meta:
@@ -72,6 +72,9 @@ class Patient(Model):
     biological_race_codes = ArrayField(
         models.CharField(max_length=100, default="", blank=True), default=list, blank=True
     )
+    cultural_ethnicity_codes = ArrayField(
+        models.CharField(max_length=100, default="", blank=True), default=list, blank=True
+    )
     last_known_timezone = models.CharField(max_length=32, null=True, blank=True)
     mrn = models.CharField(max_length=9, unique=True, default=generate_mrn)
     active = models.BooleanField(default=True)
@@ -103,10 +106,7 @@ class Patient(Model):
         blank=True,
         related_name="default_patients",
     )
-    user = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
-
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
+    user = models.OneToOneField("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
 
     @classmethod
     def find(cls, id: str) -> Patient:
@@ -240,14 +240,12 @@ class PatientAddress(IdentifiableModel):
         return f"id={self.id}"
 
 
-class PatientExternalIdentifier(IdentifiableModel):
+class PatientExternalIdentifier(TimestampedModel, IdentifiableModel):
     """A class representing a patient external identifier."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_patientexternalidentifier_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     patient = models.ForeignKey(
         "v1.Patient",
         related_name="external_identifiers",
@@ -265,14 +263,12 @@ class PatientExternalIdentifier(IdentifiableModel):
         return f"id={self.id}"
 
 
-class PatientSetting(Model):
+class PatientSetting(TimestampedModel):
     """PatientSetting."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_patientsetting_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     patient = models.ForeignKey(
         "v1.Patient", on_delete=models.DO_NOTHING, related_name="settings", null=True
     )

canvas_sdk/v1/data/patient_consent.py

@@ -1,20 +1,15 @@
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
+from canvas_sdk.v1.data.base import IdentifiableModel
+from canvas_sdk.v1.data.coding import Coding
 
 
-class PatientConsentRejectionCoding(Model):
+class PatientConsentRejectionCoding(Coding):
     """Patient Consent Rejection Coding."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_patientconsentrejectioncoding_001"
 
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    user_selected = models.BooleanField()
-
 
 class PatientConsentExpirationRule(models.TextChoices):
     """PatientConsentExpirationRule."""
@@ -24,17 +19,12 @@ class PatientConsentExpirationRule(models.TextChoices):
     END_OF_YEAR = "end_of_year", "End of year"
 
 
-class PatientConsentCoding(Model):
+class PatientConsentCoding(Coding):
     """Patient Consent Coding."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_patientconsentcoding_001"
 
-    system = models.CharField(max_length=255)
-    version = models.CharField(max_length=255)
-    code = models.CharField(max_length=255)
-    display = models.CharField(max_length=1000)
-    user_selected = models.BooleanField()
     expiration_rule = models.CharField(choices=PatientConsentExpirationRule.choices, max_length=255)
     is_mandatory = models.BooleanField()
     is_proof_required = models.BooleanField()

canvas_sdk/v1/data/payment_collection.py

@@ -1,6 +1,6 @@
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel
+from canvas_sdk.v1.data.base import IdentifiableModel, TimestampedModel
 
 
 class PostingMethods(models.TextChoices):
@@ -12,7 +12,7 @@ class PostingMethods(models.TextChoices):
     OTHER = "other", "Other"
 
 
-class PaymentCollection(IdentifiableModel):
+class PaymentCollection(TimestampedModel, IdentifiableModel):
     """Stores the total collected amount and the payment method."""
 
     class Meta:
@@ -27,8 +27,5 @@ class PaymentCollection(IdentifiableModel):
 
     description = models.TextField()
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
-
 
 __exports__ = ("PaymentCollection", "PostingMethods")

canvas_sdk/v1/data/posting.py

@@ -3,7 +3,7 @@ from typing import Self
 
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
+from canvas_sdk.v1.data.base import IdentifiableModel, TimestampedModel
 from canvas_sdk.v1.data.utils import quantize
 
 
@@ -15,7 +15,7 @@ class PostingQuerySet(models.QuerySet):
         return self.filter(entered_in_error__isnull=True)
 
 
-class BasePosting(Model):
+class BasePosting(TimestampedModel):
     """
     Base model to aggregate multiple line item transactions on a claim.
     """
@@ -40,9 +40,6 @@ class BasePosting(Model):
         "v1.CanvasUser", on_delete=models.PROTECT, null=True, blank=True
     )
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
-
     @property
     def paid_amount(self) -> Decimal:
         """Returns the total amount paid for this posting."""
@@ -149,7 +146,7 @@ class PatientPosting(BasePosting):
         return self.discounted_amount + self.paid_amount
 
 
-class AbstractBulkPosting(IdentifiableModel):
+class AbstractBulkPosting(TimestampedModel, IdentifiableModel):
     """Patient and Insurance bulk posting shared columns."""
 
     class Meta:
@@ -161,9 +158,6 @@ class AbstractBulkPosting(IdentifiableModel):
 
     total_paid = models.DecimalField(max_digits=8, decimal_places=2)
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
-
 
 class BulkPatientPosting(AbstractBulkPosting):
     """Model to aggregate bulk patient payments on multiple claims."""

canvas_sdk/v1/data/practicelocation.py

@@ -1,7 +1,15 @@
 from django.db import models
 
-from canvas_sdk.v1.data.base import IdentifiableModel, Model
-from canvas_sdk.v1.data.common import TaxIDType
+from canvas_sdk.v1.data.base import IdentifiableModel, Model, TimestampedModel
+from canvas_sdk.v1.data.common import (
+    AddressState,
+    AddressType,
+    AddressUse,
+    ContactPointState,
+    ContactPointSystem,
+    ContactPointUse,
+    TaxIDType,
+)
 
 
 class PracticeLocationPOS(models.TextChoices):
@@ -53,14 +61,12 @@ class PracticeLocationPOS(models.TextChoices):
     OTHER = "99", "Other Place of Service"
 
 
-class PracticeLocation(IdentifiableModel):
+class PracticeLocation(TimestampedModel, IdentifiableModel):
     """PracticeLocation."""
 
     class Meta:
         db_table = "canvas_sdk_data_api_practicelocation_001"
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     organization = models.ForeignKey(
         "v1.Organization", on_delete=models.DO_NOTHING, related_name="practice_locations", null=True
     )
@@ -69,7 +75,7 @@ class PracticeLocation(IdentifiableModel):
     short_name = models.CharField(max_length=255)
     background_image_url = models.CharField(max_length=255)
     background_gradient = models.CharField(max_length=255)
-    active = models.BooleanField()
+    active = models.BooleanField(default=True)
     npi_number = models.CharField(max_length=10)
     bill_through_organization = models.BooleanField()
     tax_id = models.CharField(max_length=25)
@@ -77,12 +83,42 @@ class PracticeLocation(IdentifiableModel):
     billing_location_name = models.CharField(max_length=255)
     group_npi_number = models.CharField(max_length=10)
     taxonomy_number = models.CharField(max_length=10)
-    include_zz_qualifier = models.BooleanField()
+    include_zz_qualifier = models.BooleanField(default=False)
 
     def __str__(self) -> str:
         return self.full_name
 
 
+class PracticeLocationAddress(Model):
+    """PracticeLocationAddress."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_practicelocationaddress_001"
+
+    practice_location = models.ForeignKey(
+        "v1.PracticeLocation", on_delete=models.DO_NOTHING, related_name="addresses", null=True
+    )
+    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, 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, default=AddressUse.WORK)
+    type = models.CharField(choices=AddressType.choices, max_length=10, default=AddressType.BOTH)
+    longitude = models.FloatField(null=True, blank=True)
+    latitude = models.FloatField(null=True, 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, default=AddressState.ACTIVE
+    )
+
+    def __str__(self) -> str:
+        return f"Address for {self.practice_location}"
+
+
 class PracticeLocationSetting(Model):
     """PracticeLocationSetting."""
 
@@ -99,8 +135,31 @@ class PracticeLocationSetting(Model):
         return self.name
 
 
+class PracticeLocationContactPoint(IdentifiableModel):
+    """PracticeLocationContactPoint."""
+
+    class Meta:
+        db_table = "canvas_sdk_data_api_practicelocationcontactpoint_001"
+
+    practice_location = models.ForeignKey(
+        "v1.PracticeLocation", on_delete=models.PROTECT, related_name="telecom"
+    )
+    system = models.CharField(choices=ContactPointSystem.choices, max_length=20, db_index=True)
+    value = models.CharField(max_length=100, db_index=True)
+    use = models.CharField(
+        choices=ContactPointUse.choices, max_length=20, default=ContactPointUse.HOME
+    )
+    use_notes = models.CharField(max_length=255, blank=True, default="")
+    rank = models.IntegerField(default=1)
+    state = models.CharField(
+        choices=ContactPointState.choices, max_length=20, default=ContactPointState.ACTIVE
+    )
+
+
 __exports__ = (
     "PracticeLocationPOS",
     "PracticeLocation",
+    "PracticeLocationContactPoint",
     "PracticeLocationSetting",
+    "PracticeLocationAddress",
 )

canvas_sdk/v1/data/protocol_override.py

@@ -8,6 +8,7 @@ from canvas_sdk.v1.data.base import (
     CommittableQuerySetMixin,
     ForPatientQuerySetMixin,
     IdentifiableModel,
+    TimestampedModel,
 )
 
 
@@ -26,7 +27,7 @@ class Status(models.TextChoices):
     INACTIVE = "inactive", "inactive"
 
 
-class ProtocolOverrideQuerySet(BaseQuerySet, ForPatientQuerySetMixin, CommittableQuerySetMixin):
+class ProtocolOverrideQuerySet(ForPatientQuerySetMixin, CommittableQuerySetMixin, BaseQuerySet):
     """ProtocolOverrideQuerySet."""
 
     pass
@@ -35,7 +36,7 @@ class ProtocolOverrideQuerySet(BaseQuerySet, ForPatientQuerySetMixin, Committabl
 ProtocolOverrideManager = BaseModelManager.from_queryset(ProtocolOverrideQuerySet)
 
 
-class ProtocolOverride(IdentifiableModel):
+class ProtocolOverride(TimestampedModel, IdentifiableModel):
     """ProtocolOverride."""
 
     class Meta:
@@ -43,8 +44,6 @@ class ProtocolOverride(IdentifiableModel):
 
     objects = cast(ProtocolOverrideQuerySet, ProtocolOverrideManager())
 
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
     deleted = models.BooleanField()
     committer = models.ForeignKey(
         "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"

canvas_sdk/v1/data/protocol_result.py

@@ -1,6 +1,8 @@
 from django.contrib.postgres.fields import ArrayField
 from django.db import models
 
+from canvas_sdk.v1.data.base import TimestampedModel
+
 
 class ProtocolResultStatus(models.TextChoices):
     """Constants for ProtocolResultStatus."""
@@ -12,7 +14,7 @@ class ProtocolResultStatus(models.TextChoices):
     STATUS_NOT_RELEVANT = "not_relevant"
 
 
-class ProtocolResult(models.Model):
+class ProtocolResult(TimestampedModel):
     """ProtocolResult."""
 
     class Meta:
@@ -36,8 +38,6 @@ class ProtocolResult(models.Model):
     next_review = models.DateTimeField(null=True)
     feedback_enabled = models.BooleanField(default=False)
     plugin_can_be_snoozed = models.BooleanField(default=False)
-    created = models.DateTimeField(auto_now_add=True)
-    modified = models.DateTimeField(auto_now=True)
 
 
 __exports__ = (