Update documentation for consistency and refactor the code. An unresolved error in testing still exists.

tests/test_db.py

@@ -18,10 +18,10 @@ class TestSchemaBootstrap:
     """Verify create_all produces the expected table set."""
 
     def test_create_all_creates_expected_tables(self):
-        """After create_all(), document, job, and transcript tables exist."""
+        """After create_all(), document, source, job, and revision tables exist."""
         engine = _in_memory_engine()
         # Ensure models are imported so metadata is populated
-        from transcription.models import Document, Job, Transcript  # noqa: F401
+        from transcription.models import Document, Job, Revision, Source  # noqa: F401
 
         import transcription.db as db_module
 
@@ -31,7 +31,8 @@ class TestSchemaBootstrap:
         table_names = set(inspector.get_table_names())
         assert "document" in table_names
         assert "job" in table_names
-        assert "transcript" in table_names
+        assert "source" in table_names
+        assert "revision" in table_names
 
 
 class TestSessionFactory: