Update QE guide with complete Python tutorial

Author: aclark4life

docs/topics/queryable-encryption.rst

@@ -18,35 +18,46 @@ your sensitive data.
 The basics
 ----------
 
-For example, you can define a model with encrypted fields
-like this:
+For example, you can define models with encrypted fields like this:
 
 .. code-block:: python
 
-    from django.db import models
-    from django_mongodb_backend.fields import EncryptedCharField
+    class Patient(EncryptedTestModel):
+        patient_name = models.CharField(max_length=255)
+        patient_id = models.BigIntegerField()
+        patient_record = EmbeddedModelField("PatientRecord")
+
+        def __str__(self):
+            return f"{self.patient_name} ({self.patient_id})"
 
 
-    class Patient(models.Model):
-        name = models.CharField(max_length=255)
+    class PatientRecord(EmbeddedModel):
         ssn = EncryptedCharField(max_length=11)
+        billing = EncryptedEmbeddedModelField("Billing")
+        bill_amount = models.DecimalField(max_digits=10, decimal_places=2)
 
-        def __str__(self):
-            return self.name
 
-Once you have defined your model, created migrations with ``python manage.py
-makemigrations`` and run migrations with ``python manage.py migrate``, you can
+    class Billing(EmbeddedModel):
+        cc_type = models.CharField(max_length=50)
+        cc_number = models.CharField(max_length=20)
+
+
+Once you have defined your models, create the migrations with ``python manage.py
+makemigrations`` and run the migrations with ``python manage.py migrate``. Then
 create and manipulate instances of the data just like any other Django model
 data. The fields will automatically handle encryption and decryption, ensuring
 that sensitive data is stored securely in the database.
 
-From an encrypted client, you can access the data::
+From an encrypted client, enter the secure data::
 
-    from myapp.models import Patient
-
-    >>> bob = Patient.objects.create(name="Bob", ssn="123-45-6789")
-    >>> bob.ssn
-    '123-45-6789'
+    >>> from myapp.models import Patient, PatientRecord, Billing
+    >>> billing = Billing(cc_type="Visa", cc_number="4111111111111111")
+    >>> patient_record = PatientRecord(ssn="123-45-6789", billing=self.billing)
+    >>> patient = Patient.objects.create(
+            patient_name="John Doe",
+            patient_id=123456789,
+            patient_record=self.patient_record,
+        )
 
 From an unencrypted client, you can still access the data, but the sensitive
 fields will be encrypted. For example, if you try to access the ``ssn`` field
@@ -55,7 +66,7 @@ from an unencrypted client, you will see the encrypted value::
     from myapp.models import Patient
 
     >>> bob = Patient.objects.get(name="Bob")
-    >>> bob.ssn
+    >>> bob.patient_record.ssn
     Binary(b'\x0e\x97sv\xecY\x19Jp\x81\xf1\\\x9cz\t1\r\x02...', 6)
 
 Querying encrypted fields
@@ -67,16 +78,10 @@ query type in the model field definition. For example, if you want to query the
 
 .. code-block:: python
 
-    from django.db import models
-    from django_mongodb_backend.fields import EncryptedCharField
-
-
-    class Patient(models.Model):
-        name = models.CharField(max_length=255)
+    class PatientRecord(EmbeddedModel):
         ssn = EncryptedCharField(max_length=11, queries={"queryType": "equality"})
-
-        def __str__(self):
-            return self.name
+        billing = EncryptedEmbeddedModelField("Billing")
+        bill_amount = models.DecimalField(max_digits=10, decimal_places=2)
 
 Query types
 ~~~~~~~~~~~
@@ -96,7 +101,7 @@ For example, to find a patient by their SSN, you can do the following::
 
     from myapp.models import Patient
 
-    >>> patient = Patient.objects.get(ssn="123-45-6789")
+    >>> patient = Patient.objects.get(patient_record__ssn="123-45-6789")
     >>> patient.name
     'Bob'