From 0973311d9f9916b2af3e9e9c76857c7cd018fba1 Mon Sep 17 00:00:00 2001
From: Jim Lancaster <40281233+zoltan57@users.noreply.github.com>
Date: Wed, 29 Jul 2026 14:12:18 -0500
Subject: [PATCH] Update documentation for consistency and refactor the code.
An unresolved error in testing still exists.
---
docs/requirements.md | 2 +-
docs/schema.md | 1 +
docs/ver1/ver1.md | 6 +-
src/transcription/db/operations.py | 18 +-
src/transcription/models.py | 29 ++-
src/transcription/providers/base.py | 14 --
src/transcription/services/documents.py | 27 +--
src/transcription/services/jobs.py | 19 +-
src/transcription/services/store.py | 15 +-
src/transcription/services/transcription.py | 172 ++++++++++------
src/transcription/services/workflows.py | 43 ++--
.../ui/components/document_panzoom.py | 24 +--
src/transcription/ui/components/job_detail.py | 62 +++---
src/transcription/ui/components/table/jobs.py | 16 +-
src/transcription/ui/components/transcript.py | 60 ++++--
src/transcription/ui/pages/jobs_page.py | 60 +++---
tests/integration/test_pipeline_flow.py | 63 +++---
tests/test_db.py | 7 +-
tests/test_models.py | 190 ++++++++----------
...3-aedc-35f2167c49b6_Book Two - page 61.jpg | Bin 1256451 -> 0 bytes
...-ba94ee227d6a_Time Rolls On - page 013.jpg | Bin 1856920 -> 0 bytes
...-74ea764bdae7_Time Rolls On - page 011.jpg | Bin 1749929 -> 0 bytes
...3-8612-2da1a8ba23d2_Book Two - page 03.jpg | Bin 1250779 -> 0 bytes
23 files changed, 451 insertions(+), 377 deletions(-)
delete mode 100644 uploads/287bb88d-80c1-4553-aedc-35f2167c49b6_Book Two - page 61.jpg
delete mode 100644 uploads/7c6ee648-4171-4e70-b901-ba94ee227d6a_Time Rolls On - page 013.jpg
delete mode 100644 uploads/b04b640b-dce2-4543-b8da-74ea764bdae7_Time Rolls On - page 011.jpg
delete mode 100644 uploads/f2984991-e861-4db3-8612-2da1a8ba23d2_Book Two - page 03.jpg
diff --git a/docs/requirements.md b/docs/requirements.md
index f616583..62dcf09 100644
--- a/docs/requirements.md
+++ b/docs/requirements.md
@@ -27,7 +27,7 @@ This page captures a SysML v1.6-style requirements baseline for the production s
| REQ-10 | Design Constraint | Keep schema bootstrap explicit and opt-in; normal startup does not mutate production schema. | high | inspection |
| REQ-11 | Design Constraint | Use service-backed persistence for core document and job data. | medium | inspection |
| REQ-12 | Design Constraint | Store transcription prompts as individual Markdown artifacts for iterative refinement. | medium | inspection |
-| REQ-13 | Functional | Allow users to revise transcription text from either original text or a previous revision. | low | test |
+| REQ-13 | Functional | Allow users to create one optional revision of transcription text derived from the original job transcription. | low | test |
### Requirement Relationships
diff --git a/docs/schema.md b/docs/schema.md
index 2a5614b..d7c630e 100644
--- a/docs/schema.md
+++ b/docs/schema.md
@@ -58,6 +58,7 @@ erDiagram
* A source can belong to only one job (which contains the original transcription). A source can only belong to one document. A source may have one optional transcription revision.
* A job can process one or more sources. A job can belong to only one document.
* A revision can belong to only one source. A source may have one optional revision.
+* 1:1 optionality is enforced by uniqueness on `revision.source_id` (no revision history chain).
* `Job.text` stores the original immutable provider transcription.
* Revision rows are optional user-authored edits and are derived from the original transcription. Unlike jobs, revision rows can be updated.
diff --git a/docs/ver1/ver1.md b/docs/ver1/ver1.md
index ad27827..3d16674 100644
--- a/docs/ver1/ver1.md
+++ b/docs/ver1/ver1.md
@@ -16,7 +16,7 @@ V1 is complete when all of the following are true:
1. **Functional complete**
- Upload, queue, processing, status display, and transcription result inspection work end-to-end.
- - Optional revision workflow is implemented (create/list/view).
+ - Optional revision workflow is implemented (create/view/update single revision).
2. **Data-model complete**
- Runtime behavior, persistence, and tests all align to `Document` / `Source` / `Job` / `Revision`.
3. **Operational complete**
@@ -83,7 +83,7 @@ V1 is complete when all of the following are true:
### Tasks
1. Update job detail and related UI components:
- Display original immutable transcription from `Job.text`.
- - Display optional revision sourced from `Source.revisions`.
+ - Display optional revision sourced from `Source.revision` (0 or 1).
2. Align date fields with new schema naming.
3. Preserve clear user messaging when no revisions exist.
@@ -125,7 +125,7 @@ V1 is complete when all of the following are true:
- `Document`, `Source`, `Job`, `Revision` relationships and invariants.
2. Rewrite service/integration tests:
- Worker success/failure paths using `Job.text` / `Job.error_detail`.
- - Optional revision creation and lineage behavior.
+ - Optional single-revision creation/update behavior.
3. Update UI tests for new job-detail/revision rendering behavior.
4. Re-enable strict CI quality gates (lint, type, tests).
diff --git a/src/transcription/db/operations.py b/src/transcription/db/operations.py
index 00919e1..3a5dcb8 100644
--- a/src/transcription/db/operations.py
+++ b/src/transcription/db/operations.py
@@ -22,7 +22,7 @@ async def get_next_queued_job(*, session: AsyncSession) -> Job | None:
result = await session.exec(
select(Job)
.where(Job.status == JobStatus.QUEUED)
- .order_by(Job.created_at) # pyright: ignore[reportArgumentType]
+ .order_by(Job.date_created) # pyright: ignore[reportArgumentType]
.limit(1)
) # fmt: skip
return result.first()
@@ -58,8 +58,14 @@ def _ensure_sqlite_compat_columns(connection: Connection) -> None:
connection.execute(text("ALTER TABLE job ADD COLUMN retry_count INTEGER NOT NULL DEFAULT 0"))
logger.warning("Applied SQLite compatibility schema patch table=job column=retry_count default=0")
- if "transcript" in table_names:
- transcript_columns = {column["name"] for column in inspector.get_columns("transcript")}
- if "model" not in transcript_columns:
- connection.execute(text("ALTER TABLE transcript ADD COLUMN model VARCHAR NOT NULL DEFAULT 'unknown'"))
- logger.warning("Applied SQLite compatibility schema patch table=transcript column=model default=unknown")
+ if "revision" in table_names:
+ revision_columns = {column["name"] for column in inspector.get_columns("revision")}
+ if "source_id" in revision_columns:
+ has_unique_source = False
+ for index in inspector.get_indexes("revision"):
+ if index.get("unique") and index.get("column_names") == ["source_id"]:
+ has_unique_source = True
+ break
+ if not has_unique_source:
+ connection.execute(text("CREATE UNIQUE INDEX IF NOT EXISTS ux_revision_source_id ON revision(source_id)"))
+ logger.warning("Applied SQLite compatibility schema patch table=revision unique_index=ux_revision_source_id")
diff --git a/src/transcription/models.py b/src/transcription/models.py
index ca30bbf..89f96d8 100644
--- a/src/transcription/models.py
+++ b/src/transcription/models.py
@@ -1,7 +1,9 @@
"""SQLModel domain models for the transcription system.
-Three models capture the MVP lifecycle:
- Document -> one-to-many -> Source -> one-to-many -> Job -> one-to-many -> Transcript
+Core V1 lifecycle:
+ Document -> one-to-many -> Source
+ Document -> one-to-many -> Job
+ Source -> one-to-one? -> Revision (optional)
"""
from datetime import UTC
@@ -36,7 +38,7 @@ class Document(SQLModel, table=True):
class Source(SQLModel, table=True):
- """A document source (image or pdf)."""
+ """A document source (image or PDF)."""
id: UUID = Field(default_factory=uuid4, primary_key=True)
document_id: UUID = Field(foreign_key="document.id")
@@ -52,7 +54,10 @@ class Source(SQLModel, table=True):
# Relationships
document: Optional["Document"] = Relationship(back_populates="sources")
job: Optional["Job"] = Relationship(back_populates="sources")
- revisions: list["Revision"] = Relationship(back_populates="source")
+ revision: "Revision | None" = Relationship(
+ back_populates="source",
+ sa_relationship_kwargs={"uselist": False},
+ )
class Job(SQLModel, table=True):
@@ -64,11 +69,11 @@ class Job(SQLModel, table=True):
retry_count: int = Field(default=0, ge=0)
date_created: datetime = Field(default_factory=lambda: datetime.now(UTC))
date_updated: datetime = Field(default_factory=lambda: datetime.now(UTC))
- provider: str
+ provider: str | None = None
"""Name of the transcription provider used to generate this transcript."""
- model: str
+ model: str | None = None
"""Model identifier used to generate this transcript."""
- prompt_name: str
+ prompt_name: str | None = None
"""Name of the prompt used to generate this transcript."""
text: str | None = None
"""The transcribed text. This may be None if the job failed or is still in progress."""
@@ -81,8 +86,10 @@ class Job(SQLModel, table=True):
@property
def filename(self) -> str:
- """Return the filename of the associated document."""
- return self.source.filename if self.source else "unknown"
+ """Return the filename of the associated source, when available."""
+ if not self.sources:
+ return "unknown"
+ return self.sources[0].filename
class Revision(SQLModel, table=True):
@@ -97,7 +104,7 @@ class Revision(SQLModel, table=True):
"""The revised text."""
date_created: datetime = Field(default_factory=lambda: datetime.now(UTC))
- # __table_args__ = (UniqueConstraint("job_id", "revision", name="uq_transcript_job_revision"),)
+ __table_args__ = (UniqueConstraint("source_id", name="uq_revision_source_id"),)
# Relationships
- source: Optional["Source"] = Relationship(back_populates="revisions")
+ source: Optional["Source"] = Relationship(back_populates="revision")
diff --git a/src/transcription/providers/base.py b/src/transcription/providers/base.py
index 25a017e..9056f45 100644
--- a/src/transcription/providers/base.py
+++ b/src/transcription/providers/base.py
@@ -2,9 +2,6 @@
from dataclasses import dataclass
from typing import Protocol
-from uuid import UUID
-
-from ..models import Transcript
class ProviderError(RuntimeError):
@@ -28,17 +25,6 @@ class TranscriptionResult:
prompt_name: str
model: str
- def to_transcript(self, job_id: UUID, *, revision: int = 0) -> Transcript:
- """Convert a TranscriptionResult to a Transcript model instance."""
- return Transcript(
- job_id=job_id,
- revision=revision,
- provider=self.provider,
- prompt_name=self.prompt_name,
- model=self.model,
- text=self.text,
- )
-
class TranscriptionProvider(Protocol):
"""Contract every transcription provider adapter must satisfy."""
diff --git a/src/transcription/services/documents.py b/src/transcription/services/documents.py
index 03a66f0..d67a94d 100644
--- a/src/transcription/services/documents.py
+++ b/src/transcription/services/documents.py
@@ -21,8 +21,8 @@ class DocumentError(AppError):
"""Raised when document operations fail."""
-class MissingImageError(DocumentError):
- """Raised when a required image is missing."""
+class MissingSourceError(DocumentError):
+ """Raised when a document has no associated sources."""
class UploadError(DocumentError):
@@ -30,7 +30,7 @@ class UploadError(DocumentError):
class DocumentAlreadyExistsError(DocumentError):
- """Raised when a document with the same filename already exists in the database."""
+ """Raised when a document with the same name already exists in the database."""
@dataclass(frozen=True)
@@ -72,13 +72,16 @@ class DocumentService(ServiceBase):
async def read_document(self, document_id: UUID, *, session: AsyncSession | None = None) -> Document:
"""Read an existing document from the database.
- The selectinload option is used to eagerly load related jobs for the document.
+ The selectinload option is used to eagerly load related jobs and sources.
"""
async with self._session_scope(session) as _session:
document = await _session.get(
Document,
document_id,
- options=(selectinload(Document.jobs),), # pyright: ignore[reportArgumentType]
+ options=(
+ selectinload(Document.jobs), # pyright: ignore[reportArgumentType]
+ selectinload(Document.sources), # pyright: ignore[reportArgumentType]
+ ),
)
if document is None:
raise DocumentError(
@@ -86,11 +89,11 @@ class DocumentService(ServiceBase):
category=ErrorCategory.NOT_FOUND,
suggestion="Re-upload the source document and retry.",
)
- elif not Path(document.file_path).exists():
- raise MissingImageError(
- f"Document with id {document_id} is missing its image file in {self.settings.upload_dir:!s}",
+ elif not document.sources:
+ raise MissingSourceError(
+ f"Document with id {document_id} has no associated source records",
category=ErrorCategory.NOT_FOUND,
- suggestion="Re-upload the source document and retry.",
+ suggestion="Upload at least one source for this document and retry.",
)
return document
@@ -110,13 +113,13 @@ class DocumentService(ServiceBase):
# Query Operations
async def query_documents(
- self, *, filename: str | None = None, session: AsyncSession | None = None
+ self, *, name: str | None = None, session: AsyncSession | None = None
) -> Sequence[Document]:
"""Query documents from the database based on provided filters."""
async with self._session_scope(session) as _session:
query = select(Document)
- if filename is not None:
- query = query.where(Document.filename == filename)
+ if name is not None:
+ query = query.where(Document.name == name)
result = await _session.exec(query)
return result.all()
diff --git a/src/transcription/services/jobs.py b/src/transcription/services/jobs.py
index 8d94321..66a8a56 100644
--- a/src/transcription/services/jobs.py
+++ b/src/transcription/services/jobs.py
@@ -9,6 +9,7 @@ from sqlmodel.ext.asyncio.session import AsyncSession
from ..models import Job
from ..models import JobStatus
+from ..models import Source
from .base import ServiceBase
@@ -37,7 +38,7 @@ class JobService(ServiceBase):
select(Job)
.options(
selectinload(Job.document), # pyright: ignore[reportArgumentType]
- selectinload(Job.transcripts), # pyright: ignore[reportArgumentType]
+ selectinload(Job.sources).selectinload(Source.revision), # pyright: ignore[reportArgumentType]
)
.where(Job.id == job_id)
.execution_options(populate_existing=True)
@@ -71,11 +72,14 @@ class JobService(ServiceBase):
) -> Sequence[Job]:
"""Query jobs from the database based on provided filters."""
async with self._session_scope(session) as _session:
- query = select(Job).options(selectinload(Job.document)) # pyright: ignore[reportArgumentType]
+ query = select(Job).options(
+ selectinload(Job.document), # pyright: ignore[reportArgumentType]
+ selectinload(Job.sources), # pyright: ignore[reportArgumentType]
+ )
if status is not None:
query = query.where(Job.status == status)
if filename is not None:
- query = query.where(Job.document.filename == filename)
+ query = query.where(Job.sources.any(Source.filename == filename))
result = await _session.exec(query)
return result.all()
@@ -88,7 +92,10 @@ class JobService(ServiceBase):
"""List all jobs in the database with eagerly loaded documents."""
_ = load_docs
async with self._session_scope(session) as _session:
- query = select(Job).options(selectinload(Job.document)) # pyright: ignore[reportArgumentType]
+ query = select(Job).options(
+ selectinload(Job.document), # pyright: ignore[reportArgumentType]
+ selectinload(Job.sources), # pyright: ignore[reportArgumentType]
+ )
result = await _session.exec(query)
return result.all()
@@ -129,7 +136,7 @@ class JobService(ServiceBase):
job.status = status
if retry_count_increment:
job.retry_count += retry_count_increment
- job.updated_at = datetime.now(UTC)
+ job.date_updated = datetime.now(UTC)
await self._finalize(session=_session, caller_session=session, refresh=(job,))
return job
@@ -144,6 +151,6 @@ class JobService(ServiceBase):
select(Job)
.options(selectinload(Job.document)) # pyright: ignore[reportArgumentType]
.where(Job.status == JobStatus.QUEUED)
- .order_by(Job.created_at) # pyright: ignore[reportArgumentType]
+ .order_by(Job.date_created) # pyright: ignore[reportArgumentType]
)
return (await _session.exec(query)).first()
diff --git a/src/transcription/services/store.py b/src/transcription/services/store.py
index aeda0e3..95eb293 100644
--- a/src/transcription/services/store.py
+++ b/src/transcription/services/store.py
@@ -13,6 +13,7 @@ from transcription.errors import ErrorCategory
from ..models import Document
from ..models import Job
+from ..models import Source
from .documents import UploadJobResult
logger = logging.getLogger(__name__)
@@ -69,14 +70,24 @@ async def _create_upload_records(
stored_path: Path,
) -> tuple[Document, Job]:
document = Document(
- filename=Path(original_filename).name,
- file_path=str(stored_path),
+ name=Path(original_filename).name,
)
session.add(document)
await session.flush()
job = Job(document_id=document.id)
session.add(job)
+ await session.flush()
+
+ source = Source(
+ document_id=document.id,
+ job_id=job.id,
+ upload_name=Path(original_filename).name,
+ filename=stored_path.name,
+ file_path=str(stored_path),
+ )
+ session.add(source)
+
await session.commit()
await session.refresh(document)
await session.refresh(job)
diff --git a/src/transcription/services/transcription.py b/src/transcription/services/transcription.py
index 3225080..9475c8a 100644
--- a/src/transcription/services/transcription.py
+++ b/src/transcription/services/transcription.py
@@ -6,10 +6,11 @@ import logging
import mimetypes
from collections.abc import Sequence
from contextlib import contextmanager
+from datetime import UTC
+from datetime import datetime
from pathlib import Path
from uuid import UUID
-from sqlalchemy import func
from sqlalchemy.ext.asyncio import async_sessionmaker
from sqlalchemy.orm import selectinload
from sqlmodel import select
@@ -19,7 +20,9 @@ from transcription.config import Settings
from transcription.config import get_settings
from transcription.errors import AppError
from transcription.errors import ErrorCategory
-from transcription.models import Transcript
+from transcription.models import Job
+from transcription.models import Revision
+from transcription.models import Source
from transcription.providers import ProviderAuthError
from transcription.providers import ProviderError
from transcription.providers import ProviderResponseError
@@ -44,13 +47,11 @@ class TranscriptionError(AppError):
class TranscriptionNotFoundError(TranscriptionError):
- """Raised when a transcription is not found in the database."""
+ """Raised when a transcription-related resource is not found."""
class TranscriptionService(ServiceBase):
- """Service class for managing transcription operations.
-
- This is the top-level service that composes functionality from the other services."""
+ """Service class for job transcription output and optional source revisions."""
provider: TranscriptionProvider
@@ -58,43 +59,52 @@ class TranscriptionService(ServiceBase):
super().__init__(session_factory=session_factory)
self.provider = get_transcription_provider(settings=self.settings)
- async def create_transcript(self, transcript: Transcript, *, session: AsyncSession | None = None) -> Transcript:
- """Create a new transcript in the database."""
+ async def create_revision(self, revision: Revision, *, session: AsyncSession | None = None) -> Revision:
+ """Create a new revision in the database."""
async with self._session_scope(session) as _session:
- _session.add(transcript)
- await self._finalize(session=_session, caller_session=session, refresh=(transcript,))
- return transcript
+ _session.add(revision)
+ await self._finalize(session=_session, caller_session=session, refresh=(revision,))
+ return revision
- async def read_transcript(self, transcript_id: UUID, *, session: AsyncSession | None = None) -> Transcript:
- """Read an existing transcript from the database."""
+ async def read_revision(self, revision_id: UUID, *, session: AsyncSession | None = None) -> Revision:
+ """Read an existing revision from the database."""
async with self._session_scope(session) as _session:
- transcript = await _session.get(
- Transcript,
- transcript_id,
- # Makes the full Job model object available in the return Transcript object
- options=(selectinload(Transcript.job),), # pyright: ignore[reportArgumentType]
+ revision = await _session.get(
+ Revision,
+ revision_id,
+ options=(selectinload(Revision.source),), # pyright: ignore[reportArgumentType]
)
- if transcript is None:
+ if revision is None:
raise TranscriptionNotFoundError(
- f"Transcript with id {transcript_id} not found",
+ f"Revision with id {revision_id} not found",
category=ErrorCategory.NOT_FOUND,
- suggestion="Verify the transcript id and retry.",
+ suggestion="Verify the revision id and retry.",
)
- return transcript
+ return revision
- async def update_transcript(self, transcript: Transcript, *, session: AsyncSession | None = None) -> Transcript:
- """Update an existing transcript in the database."""
+ async def update_revision(self, revision: Revision, *, session: AsyncSession | None = None) -> Revision:
+ """Update an existing revision in the database."""
async with self._session_scope(session) as _session:
- merged = await _session.merge(transcript)
+ merged = await _session.merge(revision)
await self._finalize(session=_session, caller_session=session, refresh=(merged,))
return merged
- async def delete_transcript(self, transcript: Transcript, *, session: AsyncSession | None = None) -> None:
- """Delete a transcript from the database."""
+ async def delete_revision(self, revision: Revision, *, session: AsyncSession | None = None) -> None:
+ """Delete a revision from the database."""
async with self._session_scope(session) as _session:
- await _session.delete(transcript)
+ await _session.delete(revision)
await self._finalize(session=_session, caller_session=session)
+ # Temporary compatibility methods for callers still using transcript naming.
+
+ async def read_transcript(self, transcript_id: UUID, *, session: AsyncSession | None = None) -> Revision:
+ """Backward-compatible alias for read_revision."""
+ return await self.read_revision(transcript_id, session=session)
+
+ async def delete_transcript(self, transcript: Revision, *, session: AsyncSession | None = None) -> None:
+ """Backward-compatible alias for delete_revision."""
+ await self.delete_revision(transcript, session=session)
+
async def transcribe_document(
self,
image_path: str | Path,
@@ -102,7 +112,7 @@ class TranscriptionService(ServiceBase):
*,
prompt_name: str = DEFAULT_PROMPT_FILE,
session: AsyncSession | None = None,
- ):
+ ) -> None:
"""Transcribe a local image using the configured prompt and provider."""
result = await transcribe_document_image(
image_path=image_path,
@@ -110,16 +120,17 @@ class TranscriptionService(ServiceBase):
settings=self.settings,
provider=self.provider,
)
- await self.create_transcript_for_job(
+ await self.update_job_transcription(
job_id=job_id,
text=result.text,
+ error_detail=None,
provider=result.provider,
model=result.model,
prompt_name=result.prompt_name,
session=session,
)
- async def create_transcript_for_job(
+ async def update_job_transcription(
self,
*,
job_id: UUID,
@@ -129,61 +140,88 @@ class TranscriptionService(ServiceBase):
model: str | None = None,
prompt_name: str = DEFAULT_PROMPT_FILE,
session: AsyncSession | None = None,
- ) -> Transcript:
- """Create a new transcript revision for a job id."""
+ ) -> Job:
+ """Persist original transcription output fields on a job."""
async with self._session_scope(session) as _session:
- rev_query = select(func.max(Transcript.revision)).where(Transcript.job_id == job_id)
- rev_result = await _session.exec(rev_query)
- max_revision = -1 if (rev := rev_result.one_or_none()) is None else rev
- next_revision = max_revision + 1
+ job = await _session.get(Job, job_id)
+ if job is None:
+ raise TranscriptionNotFoundError(
+ f"Job with id {job_id} not found",
+ category=ErrorCategory.NOT_FOUND,
+ suggestion="Verify the job id and retry.",
+ )
- transcript = Transcript(
- job_id=job_id,
- revision=next_revision,
- provider=provider or self.settings.provider.value,
- model=model or _resolve_transcript_model(provider=self.provider, settings=self.settings),
- prompt_name=prompt_name,
- text=text,
- error_detail=error_detail,
- )
- _session.add(transcript)
- await self._finalize(session=_session, caller_session=session, refresh=(transcript,))
- return transcript
+ job.text = text
+ job.error_detail = error_detail
+ job.provider = provider or job.provider or self.settings.provider.value
+ job.model = model or job.model or _resolve_transcript_model(provider=self.provider, settings=self.settings)
+ job.prompt_name = prompt_name or job.prompt_name or DEFAULT_PROMPT_FILE
+ job.date_updated = datetime.now(UTC)
- async def read_latest_transcript_by_job(
+ await self._finalize(session=_session, caller_session=session, refresh=(job,))
+ return job
+
+ async def upsert_revision_for_source(
self,
- job_id: UUID,
+ *,
+ source_id: UUID,
+ text: str,
+ session: AsyncSession | None = None,
+ ) -> Revision:
+ """Create or replace the single optional revision for a source."""
+ async with self._session_scope(session) as _session:
+ source = await _session.get(Source, source_id)
+ if source is None:
+ raise TranscriptionNotFoundError(
+ f"Source with id {source_id} not found",
+ category=ErrorCategory.NOT_FOUND,
+ suggestion="Verify the source id and retry.",
+ )
+
+ query = select(Revision).where(Revision.source_id == source_id)
+ existing = (await _session.exec(query)).one_or_none()
+
+ if existing is None:
+ revision = Revision(source_id=source_id, text=text)
+ _session.add(revision)
+ await self._finalize(session=_session, caller_session=session, refresh=(revision,))
+ return revision
+
+ existing.text = text
+ merged = await _session.merge(existing)
+ await self._finalize(session=_session, caller_session=session, refresh=(merged,))
+ return merged
+
+ async def read_revision_by_source(
+ self,
+ source_id: UUID,
*,
session: AsyncSession | None = None,
- ) -> Transcript | None:
- """Read the latest transcript revision for a job id."""
+ ) -> Revision | None:
+ """Read the single optional revision for a source."""
async with self._session_scope(session) as _session:
- query = _transcript_job_query(job_id=job_id).limit(1)
+ query = select(Revision).where(Revision.source_id == source_id)
result = await _session.exec(query)
return result.one_or_none()
- async def list_transcripts_by_job(
+ async def list_revisions_by_job(
self,
job_id: UUID,
*,
session: AsyncSession | None = None,
- ) -> Sequence[Transcript]:
- """List transcript revisions for a job id in ascending revision order."""
+ ) -> Sequence[Revision]:
+ """List revisions connected to all sources for a job."""
async with self._session_scope(session) as _session:
- query = _transcript_job_query(job_id=job_id)
+ query = (
+ select(Revision)
+ .join(Source, Source.id == Revision.source_id)
+ .where(Source.job_id == job_id)
+ .order_by(Revision.date_created) # pyright: ignore[reportArgumentType]
+ )
result = await _session.exec(query)
return result.all()
-def _transcript_job_query(job_id: UUID):
- return (
- select(Transcript)
- .where(Transcript.job_id == job_id)
- .options(selectinload(Transcript.job)) # pyright: ignore[reportArgumentType]
- .order_by(Transcript.revision) # pyright: ignore[reportArgumentType]
- ) # fmt: skip
-
-
def _resolve_transcript_model(*, provider: TranscriptionProvider, settings: Settings) -> str:
provider_model = getattr(provider, "model", None)
if isinstance(provider_model, str) and provider_model.strip():
diff --git a/src/transcription/services/workflows.py b/src/transcription/services/workflows.py
index 9c4a114..c06ffb1 100644
--- a/src/transcription/services/workflows.py
+++ b/src/transcription/services/workflows.py
@@ -10,6 +10,7 @@ from ..errors import classify_unexpected_error
from ..errors import format_error_detail
from ..models import Job
from ..models import JobStatus
+from ..models import Source
from ..providers import TranscriptionResult
from . import ServiceBundle
from .transcription import DEFAULT_PROMPT_FILE
@@ -64,18 +65,17 @@ async def process_queued_job(
job = await services.jobs.mark_job_status(job.id, JobStatus.PROCESSING, session=session)
await session.commit()
- document = job.document
- assert document is not None, (
- f"Job {job.id} has no associated document or the document failed to be loaded by the job service."
- )
+ source = _resolve_primary_source(job)
+ assert source is not None, f"Job {job.id} has no associated source record."
try:
- result = await transcribe_document_image(document.file_path)
+ result = await transcribe_document_image(source.file_path)
job = await _finalize_transcribed(job=job, services=services, result=result, session=session)
logger.info(
- "Job transcribed operation=worker.process_job job_id=%s document_id=%s provider=%s",
+ "Job transcribed operation=worker.process_job job_id=%s document_id=%s source_id=%s provider=%s",
job.id,
- document.id,
+ job.document_id,
+ source.id,
result.provider,
)
except Exception as exc: # noqa: BLE001
@@ -87,9 +87,10 @@ async def process_queued_job(
job = await _finalize_failed(job=job, services=services, error=error, session=session)
logger.error(
- "Job failed operation=worker.process_job job_id=%s document_id=%s error_id=%s category=%s",
+ "Job failed operation=worker.process_job job_id=%s document_id=%s source_id=%s error_id=%s category=%s",
job.id,
- document.id,
+ job.document_id,
+ source.id,
error.error_id,
error.category.value,
)
@@ -118,10 +119,10 @@ async def _finalize_transcribed(
result: TranscriptionResult,
session: AsyncSession | None = None,
) -> Job:
- """Transaction B: transcript + TRANSCRIBED in one commit."""
+ """Transaction B: job transcription output + TRANSCRIBED in one commit."""
if session is None:
async with services.jobs._session_scope() as local_session:
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=result.text,
error_detail=None,
@@ -138,7 +139,7 @@ async def _finalize_transcribed(
await local_session.commit()
return updated_job
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=result.text,
error_detail=None,
@@ -164,10 +165,10 @@ async def _finalize_retry(
settings: Settings,
session: AsyncSession | None = None,
) -> Job:
- """Transaction C: transcript error + QUEUED + retry increment in one commit."""
+ """Transaction C: job error detail + QUEUED + retry increment in one commit."""
if session is None:
async with services.jobs._session_scope() as local_session:
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=None,
error_detail=format_error_detail(error),
@@ -182,7 +183,7 @@ async def _finalize_retry(
)
await local_session.commit()
else:
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=None,
error_detail=format_error_detail(error),
@@ -209,10 +210,10 @@ async def _finalize_failed(
error: AppError,
session: AsyncSession | None = None,
) -> Job:
- """Transaction B: transcript error + FAILED in one commit."""
+ """Transaction B: job error detail + FAILED in one commit."""
if session is None:
async with services.jobs._session_scope() as local_session:
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=None,
error_detail=format_error_detail(error),
@@ -227,7 +228,7 @@ async def _finalize_failed(
await local_session.commit()
return updated_job
- await services.transcriptions.create_transcript_for_job(
+ await services.transcriptions.update_job_transcription(
job_id=job.id,
text=None,
error_detail=format_error_detail(error),
@@ -241,3 +242,9 @@ async def _finalize_failed(
)
await session.commit()
return updated_job
+
+
+def _resolve_primary_source(job: Job) -> Source | None:
+ if not job.sources:
+ return None
+ return job.sources[0]
diff --git a/src/transcription/ui/components/document_panzoom.py b/src/transcription/ui/components/document_panzoom.py
index bd10965..9d3695c 100644
--- a/src/transcription/ui/components/document_panzoom.py
+++ b/src/transcription/ui/components/document_panzoom.py
@@ -10,24 +10,24 @@ from uuid import uuid4
from nicegui import ui
from transcription.config import get_settings
-from transcription.models import Document
+from transcription.models import Source
PANGOZOOM_CDN_URL = "https://unpkg.com/@panzoom/panzoom@4.6.2/dist/panzoom.min.js"
UPLOADS_URL_PREFIX = "/uploads"
-def render_document_panzoom(*, document: Document) -> None:
- """Render a document preview with pan and zoom interactions."""
+def render_document_panzoom(*, source: Source) -> None:
+ """Render a source preview with pan and zoom interactions."""
_register_panzoom_assets()
host_id = f"document-panzoom-{uuid4().hex}"
- document_url = _document_url(document)
- document_kind = _document_kind(document)
+ document_url = _document_url(source)
+ document_kind = _document_kind(source)
with ui.card().classes("w-full q-pa-md"):
with ui.row().classes("w-full items-center justify-between no-wrap"):
ui.label("Document preview").classes("text-subtitle1 text-weight-medium")
- ui.label(document.filename).classes("text-caption text-grey-4 ellipsis").style(
+ ui.label(source.filename).classes("text-caption text-grey-4 ellipsis").style(
"max-width: 60%; text-align: right;"
)
@@ -40,13 +40,13 @@ def render_document_panzoom(*, document: Document) -> None:
if document_kind == "pdf":
ui.html(
f'"
)
else:
ui.html(
f'![{document.filename}]()
"
)
@@ -98,8 +98,8 @@ def _register_panzoom_assets() -> None:
)
-def _document_url(document: Document) -> str:
- file_path = Path(document.file_path)
+def _document_url(source: Source) -> str:
+ file_path = Path(source.file_path)
upload_dir = get_settings().upload_dir
relative_path: Path
@@ -117,8 +117,8 @@ def _document_url(document: Document) -> str:
return f"{UPLOADS_URL_PREFIX}/{encoded_relative_path}"
-def _document_kind(document: Document) -> str:
- suffix = Path(document.file_path).suffix.lower()
+def _document_kind(source: Source) -> str:
+ suffix = Path(source.file_path).suffix.lower()
if suffix == ".pdf":
return "pdf"
return "image"
diff --git a/src/transcription/ui/components/job_detail.py b/src/transcription/ui/components/job_detail.py
index 70d624a..e7d18e3 100644
--- a/src/transcription/ui/components/job_detail.py
+++ b/src/transcription/ui/components/job_detail.py
@@ -3,14 +3,15 @@
from __future__ import annotations
import logging
-from collections.abc import Sequence
from nicegui import ui
-from transcription.models import Document
from transcription.models import Job
-from transcription.models import Transcript
+from transcription.models import Revision
+from transcription.models import Source
from transcription.ui.components.document_panzoom import render_document_panzoom
+from transcription.ui.components.transcript import render_original_transcription_card
+from transcription.ui.components.transcript import render_revision_row
logger = logging.getLogger(__name__)
@@ -33,50 +34,35 @@ def _metadata_row(label: str, value: str) -> None:
ui.label(value).classes("text-body2 text-right text-grey-1 break-all")
-def _render_document_section(document: Document) -> None:
+def _render_source_section(source: Source) -> None:
with ui.card().classes("w-full q-pa-md"):
- ui.label("Document").classes("text-subtitle1 text-weight-medium")
+ ui.label("Source").classes("text-subtitle1 text-weight-medium")
ui.separator().classes("q-my-sm")
with ui.column().classes("w-full q-gutter-y-xs"):
- _metadata_row("Filename", document.filename)
- _metadata_row("File path", document.file_path)
+ _metadata_row("Upload name", source.upload_name)
+ _metadata_row("Stored filename", source.filename)
+ _metadata_row("File path", source.file_path)
+ _metadata_row("Uploaded", source.date_uploaded.isoformat())
ui.separator().classes("q-my-md")
- render_document_panzoom(document=document)
+ render_document_panzoom(source=source)
-def _render_transcript_section(transcripts: Sequence[Transcript]) -> None:
+def _render_revision_section(revision: Revision | None) -> None:
with ui.card().classes("w-full q-pa-md"):
- ui.label("Transcripts").classes("text-subtitle1 text-weight-medium")
+ ui.label("Revision").classes("text-subtitle1 text-weight-medium")
ui.separator().classes("q-my-sm")
- if not transcripts:
- ui.label("Transcript history is not available yet.").classes("text-body2 text-grey-3")
+ if revision is None:
+ ui.label("No revision exists for this source.").classes("text-body2 text-grey-3")
return
- for transcript in transcripts:
- with ui.column().classes("w-full q-gutter-y-xs"):
- _metadata_row("Revision", str(transcript.revision))
- _metadata_row("Provider", transcript.provider)
- _metadata_row("Prompt", transcript.prompt_name)
- _metadata_row("Created", transcript.created_at.isoformat())
-
- if transcript.text:
- ui.separator().classes("q-my-sm")
- with ui.card().classes("w-fullq-pa-sm"):
- ui.markdown(transcript.text).classes("text-grey-1")
- elif transcript.error_detail:
- ui.separator().classes("q-my-sm")
- with ui.card().classes("w-full bg-red-1 text-red-10 q-pa-sm"):
- ui.label("Failure detail").classes("text-caption text-uppercase")
- ui.label(transcript.error_detail).classes("text-body2")
-
- ui.separator().classes("q-my-md bg-blue-grey-7")
+ render_revision_row(revision=revision, initially_expanded=True)
-def render_job_detail(*, job: Job, document: Document | None, transcripts: Sequence[Transcript]) -> None:
+def render_job_detail(*, job: Job, source: Source | None, revision: Revision | None) -> None:
"""Render all sections for the job detail page."""
- logger.debug("Rendering job detail for job ID %s with %d transcripts", job.id, len(transcripts))
+ logger.debug("Rendering job detail for job ID %s", job.id)
status_text = job.status.value
with ui.column().classes("w-full max-w-4xl q-gutter-md"):
with ui.card().classes("w-full q-pa-lg"):
@@ -93,11 +79,13 @@ def render_job_detail(*, job: Job, document: Document | None, transcripts: Seque
ui.separator().classes("q-my-md bg-blue-grey-7")
with ui.column().classes("w-full q-gutter-y-xs"):
- _metadata_row("Created", job.created_at.isoformat())
- _metadata_row("Updated", job.updated_at.isoformat())
+ _metadata_row("Created", job.date_created.isoformat())
+ _metadata_row("Updated", job.date_updated.isoformat())
_metadata_row("Retries", str(job.retry_count))
- if document is not None:
- _render_document_section(document)
+ render_original_transcription_card(job=job)
- _render_transcript_section(transcripts)
+ if source is not None:
+ _render_source_section(source)
+
+ _render_revision_section(revision)
diff --git a/src/transcription/ui/components/table/jobs.py b/src/transcription/ui/components/table/jobs.py
index a52d786..44f1c22 100644
--- a/src/transcription/ui/components/table/jobs.py
+++ b/src/transcription/ui/components/table/jobs.py
@@ -22,8 +22,8 @@ class JobTableRow:
status: str
filename: str
retry_count: int
- created_at: str
- updated_at: str
+ date_created: str
+ date_updated: str
def _format_timestamp(value: str) -> str:
@@ -43,10 +43,10 @@ def _serialize_rows(rows: Sequence[JobTableRow]) -> list[dict[str, Any]]:
"status": row.status,
"filename": row.filename,
"retry_count": row.retry_count,
- "created_at": _format_timestamp(row.created_at),
- "updated_at": _format_timestamp(row.updated_at),
- "created_sort": row.created_at,
- "updated_sort": row.updated_at,
+ "date_created": _format_timestamp(row.date_created),
+ "date_updated": _format_timestamp(row.date_updated),
+ "created_sort": row.date_created,
+ "updated_sort": row.date_updated,
}
for row in rows
]
@@ -65,8 +65,8 @@ def render_jobs_table(rows: Sequence[JobTableRow]) -> None:
{"name": "status", "label": "Status", "field": "status", "sortable": True},
{"name": "filename", "label": "Filename", "field": "filename", "sortable": True},
{"name": "retry_count", "label": "Retries", "field": "retry_count", "sortable": True},
- {"name": "created_at", "label": "Created", "field": "created_at", "sortable": True},
- {"name": "updated_at", "label": "Updated", "field": "updated_at", "sortable": True},
+ {"name": "date_created", "label": "Created", "field": "date_created", "sortable": True},
+ {"name": "date_updated", "label": "Updated", "field": "date_updated", "sortable": True},
],
default_sort_by="created_sort",
default_descending=True,
diff --git a/src/transcription/ui/components/transcript.py b/src/transcription/ui/components/transcript.py
index 3ec2cad..6ddf3c6 100644
--- a/src/transcription/ui/components/transcript.py
+++ b/src/transcription/ui/components/transcript.py
@@ -9,22 +9,49 @@ from typing import Any
from nicegui import ui
-from transcription.models import Transcript
+from transcription.models import Job
+from transcription.models import Revision
-type TranscriptAction = Callable[[Transcript], Awaitable[None] | None]
+type RevisionAction = Callable[[Revision], Awaitable[None] | None]
-def render_transcript_revision_row(
+def render_original_transcription_card(*, job: Job, classes: str = "w-full") -> Any:
+ """Render the immutable original job transcription output."""
+ status_label = "Failed" if job.error_detail else "Transcribed"
+ header = f"Original Transcription | {status_label}"
+ provider = job.provider or "unknown"
+ model = job.model or "unknown"
+ caption = f"{provider} | {model} | {_format_created_at(job.date_updated)}"
+
+ card = ui.card().classes(f"{classes} q-pa-md bg-blue-grey-10")
+ with card, ui.column().classes("w-full q-gutter-y-sm"):
+ ui.label(header).classes("text-subtitle1 text-weight-medium")
+ ui.label(caption).classes("text-caption text-grey-5")
+ _metadata_row(label="Prompt", value=job.prompt_name or "unknown")
+ _metadata_row(label="Updated", value=_format_created_at(job.date_updated))
+
+ if job.text:
+ with ui.card().classes("w-full q-pa-sm"):
+ ui.markdown(job.text)
+
+ if job.error_detail:
+ with ui.card().classes("w-full bg-red-1 text-red-10 q-pa-sm"):
+ ui.label("Failure detail").classes("text-caption text-uppercase")
+ ui.label(job.error_detail).classes("text-body2")
+
+ return card
+
+
+def render_revision_row(
*,
- transcript: Transcript,
+ revision: Revision,
initially_expanded: bool = False,
classes: str = "w-full",
- on_delete: TranscriptAction | None = None,
+ on_delete: RevisionAction | None = None,
) -> Any:
- """Render one collapsible row for a single transcript revision."""
- status_label = "Failed" if transcript.error_detail else "Transcribed"
- header = f"Revision {transcript.revision} | {status_label}"
- caption = f"{transcript.provider} | {transcript.model} | {_format_created_at(transcript.created_at)}"
+ """Render a collapsible row for the single optional source revision."""
+ header = "Revision | User-authored"
+ caption = _format_created_at(revision.date_created)
expansion = ui.expansion(value=initially_expanded, group="group").classes(
f"{classes} rounded-borders bg-blue-grey-10"
@@ -51,7 +78,7 @@ def render_transcript_revision_row(
if not confirmed:
return
- maybe_awaitable = on_delete(transcript)
+ maybe_awaitable = on_delete(revision)
if isinstance(maybe_awaitable, Awaitable):
await maybe_awaitable
@@ -59,18 +86,11 @@ def render_transcript_revision_row(
ui.button(icon="delete", on_click=delete_current_transcript).props(
'flat round dense color="negative"'
)
- _metadata_row(label="Provider", value=transcript.provider)
- _metadata_row(label="Model", value=transcript.model)
- _metadata_row(label="Created", value=_format_created_at(transcript.created_at))
+ _metadata_row(label="Created", value=_format_created_at(revision.date_created))
- if transcript.text:
+ if revision.text:
with ui.card().classes("w-full q-pa-sm"):
- ui.markdown(transcript.text)
-
- if transcript.error_detail:
- with ui.card().classes("w-full bg-red-1 text-red-10 q-pa-sm"):
- ui.label("Failure detail").classes("text-caption text-uppercase")
- ui.label(transcript.error_detail).classes("text-body2")
+ ui.markdown(revision.text)
return expansion
diff --git a/src/transcription/ui/pages/jobs_page.py b/src/transcription/ui/pages/jobs_page.py
index b7afa91..5d446ab 100644
--- a/src/transcription/ui/pages/jobs_page.py
+++ b/src/transcription/ui/pages/jobs_page.py
@@ -8,7 +8,9 @@ from fastapi import Request
from nicegui import ui
from transcription.app_state import resolve_session_factory
+from transcription.models import Job
from transcription.models import JobStatus
+from transcription.models import Source
from transcription.services.jobs import JobService
from transcription.services.transcription import TranscriptionService
from transcription.ui.components.app_shell import render_navigation_header
@@ -17,7 +19,8 @@ from transcription.ui.components.table.jobs import render_jobs_table
from ..components.document_panzoom import render_document_panzoom
from ..components.table.jobs import JobTableRow
-from ..components.transcript import render_transcript_revision_row
+from ..components.transcript import render_original_transcription_card
+from ..components.transcript import render_revision_row
def register_page() -> None:
@@ -37,8 +40,8 @@ def register_page() -> None:
status=job.status.value,
filename=job.filename,
retry_count=job.retry_count,
- created_at=job.created_at.isoformat(),
- updated_at=job.updated_at.isoformat(),
+ date_created=job.date_created.isoformat(),
+ date_updated=job.date_updated.isoformat(),
)
for job in await jobs_service.list_jobs()
]
@@ -55,10 +58,14 @@ def register_page() -> None:
render_navigation_header(current_path="/jobs")
job = await jobs_service.read_job(job_id=UUID(job_id))
+ source = _resolve_primary_source(job)
with ui.splitter(value=30).classes("w-full h-[calc(100vh-64px)]") as splitter:
with splitter.before, ui.column(align_items="stretch").classes("w-full h-full p-4 gap-3"):
- render_document_panzoom(document=job.document)
+ if source is not None:
+ render_document_panzoom(source=source)
+ else:
+ ui.label("No source preview is available for this job.").classes("text-body2 text-grey-3")
with splitter.after, ui.column(align_items="stretch").classes("w-full h-full p-4 gap-3"):
with ui.row():
ui.button(icon="arrow_back", on_click=ui.navigate.back)
@@ -70,30 +77,37 @@ def register_page() -> None:
case _:
ui.label(f"{job.status.value}").classes("text-subtitle1 text-weight-medium")
- async def delete_transcript_by_id(transcript_id: UUID, revision: int) -> None:
+ render_original_transcription_card(job=job)
+
+ async def delete_revision_by_id(revision_id: UUID) -> None:
try:
- transcript = await transcription_service.read_transcript(transcript_id=transcript_id)
- await transcription_service.delete_transcript(transcript)
+ revision = await transcription_service.read_revision(revision_id=revision_id)
+ await transcription_service.delete_revision(revision)
except Exception as exc: # noqa: BLE001
- show_error(exc, title="Delete failed", operation="jobs.delete_transcript")
+ show_error(exc, title="Delete failed", operation="jobs.delete_revision")
return
- ui.notify(f"Deleted revision {revision}", type="positive")
- await render_transcript_list.refresh()
+ ui.notify("Deleted revision", type="positive")
+ await render_revision_panel.refresh()
@ui.refreshable
- async def render_transcript_list() -> None:
+ async def render_revision_panel() -> None:
refreshed_job = await jobs_service.read_job(job_id=UUID(job_id))
- for i, transcript in enumerate(refreshed_job.transcripts):
- render_transcript_revision_row(
- transcript=transcript,
- initially_expanded=(i == 0),
- on_delete=(
- lambda _transcript, tid=transcript.id, rev=transcript.revision: delete_transcript_by_id(
- tid,
- rev,
- )
- ),
- )
+ refreshed_source = _resolve_primary_source(refreshed_job)
+ if refreshed_source is None or refreshed_source.revision is None:
+ ui.label("No revision exists for this source.").classes("text-body2 text-grey-3")
+ return
- await render_transcript_list()
+ render_revision_row(
+ revision=refreshed_source.revision,
+ initially_expanded=True,
+ on_delete=lambda _revision, rid=refreshed_source.revision.id: delete_revision_by_id(rid),
+ )
+
+ await render_revision_panel()
+
+
+def _resolve_primary_source(job: Job) -> Source | None:
+ if not job.sources:
+ return None
+ return job.sources[0]
diff --git a/tests/integration/test_pipeline_flow.py b/tests/integration/test_pipeline_flow.py
index 4e83315..481f893 100644
--- a/tests/integration/test_pipeline_flow.py
+++ b/tests/integration/test_pipeline_flow.py
@@ -3,12 +3,12 @@
from pathlib import Path
import pytest
-from sqlmodel import select
from transcription.config import Settings
-from transcription.models import Job, JobStatus, Transcript
+from transcription.models import Job
+from transcription.models import JobStatus
from transcription.providers.base import TranscriptionResult
-from transcription.services.upload import create_upload_job
+from transcription.services.store import create_upload_job
from transcription.worker import process_next_queued_job
@@ -16,61 +16,64 @@ from transcription.worker import process_next_queued_job
class TestPipelineSuccessFlow:
"""Verify end-to-end success lifecycle behavior."""
- def test_upload_then_worker_persists_transcribed_terminal_state(self, session, tmp_path: Path, monkeypatch):
- """Upload followed by worker processing persists transcript and transcribed status."""
+ @pytest.mark.asyncio
+ async def test_upload_then_worker_persists_transcribed_terminal_state(
+ self, async_session, tmp_path: Path, monkeypatch
+ ):
+ """Upload followed by worker processing persists job transcription and transcribed status."""
settings = Settings(openrouter_api_key="test-key", upload_dir=tmp_path)
- upload_result = create_upload_job(
+ upload_result = await create_upload_job(
filename="pipeline.jpg",
file_bytes=b"pipeline-bytes",
- session=session,
+ session=async_session,
settings=settings,
)
- def _fake_transcribe(_path: str) -> TranscriptionResult:
- return TranscriptionResult(text="Pipeline transcript", provider="openrouter", model="test-model")
+ async def _fake_transcribe(*, prompt_text: str, image_bytes: bytes, mime_type: str) -> TranscriptionResult:
+ _ = (prompt_text, image_bytes, mime_type)
+ return TranscriptionResult(text="Pipeline transcript", provider="openrouter", model="test-model", prompt_name="transcribe_document.md")
- monkeypatch.setattr("transcription.worker.transcribe_document_image", _fake_transcribe)
+ monkeypatch.setattr("transcription.services.transcription.OpenRouterTranscriptionProvider.transcribe", _fake_transcribe)
- processed = process_next_queued_job(session=session)
- job = session.get(Job, upload_result.job_id)
- transcript = session.exec(select(Transcript).where(Transcript.job_id == upload_result.job_id)).first()
+ processed = await process_next_queued_job(session=async_session)
+ job = await async_session.get(Job, upload_result.job_id)
assert processed is True
assert job is not None
assert job.status == JobStatus.TRANSCRIBED
- assert transcript is not None
- assert transcript.text == "Pipeline transcript"
- assert transcript.error_detail is None
+ assert job.text == "Pipeline transcript"
+ assert job.error_detail is None
@pytest.mark.integration
class TestPipelineFailureFlow:
"""Verify end-to-end failure lifecycle behavior."""
- def test_upload_then_worker_persists_failed_terminal_state(self, session, tmp_path: Path, monkeypatch):
- """Upload followed by worker processing persists error detail and failed status."""
+ @pytest.mark.asyncio
+ async def test_upload_then_worker_persists_failed_terminal_state(self, async_session, tmp_path: Path, monkeypatch):
+ """Upload followed by worker processing persists error detail and failed status on the job."""
settings = Settings(openrouter_api_key="test-key", upload_dir=tmp_path)
- upload_result = create_upload_job(
+ upload_result = await create_upload_job(
filename="pipeline.jpg",
file_bytes=b"pipeline-bytes",
- session=session,
+ session=async_session,
settings=settings,
)
- def _fake_transcribe(_path: str) -> TranscriptionResult:
+ async def _fake_transcribe(*, prompt_text: str, image_bytes: bytes, mime_type: str) -> TranscriptionResult:
+ _ = (prompt_text, image_bytes, mime_type)
raise RuntimeError("pipeline provider failure")
- monkeypatch.setattr("transcription.worker.transcribe_document_image", _fake_transcribe)
+ monkeypatch.setattr("transcription.services.transcription.OpenRouterTranscriptionProvider.transcribe", _fake_transcribe)
- processed = process_next_queued_job(session=session)
- job = session.get(Job, upload_result.job_id)
- transcript = session.exec(select(Transcript).where(Transcript.job_id == upload_result.job_id)).first()
+ processed = await process_next_queued_job(session=async_session)
+ job = await async_session.get(Job, upload_result.job_id)
assert processed is True
assert job is not None
assert job.status == JobStatus.FAILED
- assert transcript is not None
- assert transcript.text is None
- assert "pipeline provider failure" in transcript.error_detail
- assert "[internal_unexpected_error]" in transcript.error_detail
- assert "error_id=" in transcript.error_detail
+ assert job.text is None
+ assert job.error_detail is not None
+ assert "pipeline provider failure" in job.error_detail
+ assert "[internal_unexpected_error]" in job.error_detail
+ assert "error_id=" in job.error_detail
diff --git a/tests/test_db.py b/tests/test_db.py
index d6d615f..8e069f0 100644
--- a/tests/test_db.py
+++ b/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:
diff --git a/tests/test_models.py b/tests/test_models.py
index d2b710b..b85ad8f 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -1,31 +1,28 @@
-"""Tests for transcription.models — Document, Job, Transcript persistence and relationships."""
+"""Tests for transcription.models — Document, Source, Job, Revision persistence and relationships."""
from uuid import UUID
import pytest
from sqlalchemy.exc import IntegrityError
-from transcription.models import Document, Job, JobStatus, Transcript
+from transcription.models import Document, Job, JobStatus, Revision, Source
def _make_document(**overrides) -> Document:
- """Create a Document with sensible defaults."""
- defaults = {"filename": "letter.jpg", "file_path": "/uploads/letter.jpg"}
+ defaults = {"name": "letter bundle"}
defaults.update(overrides)
return Document(**defaults)
def _persist_document(session) -> Document:
- """Create, persist, and return a Document."""
- doc = _make_document()
- session.add(doc)
+ document = _make_document()
+ session.add(document)
session.commit()
- session.refresh(doc)
- return doc
+ session.refresh(document)
+ return document
def _persist_job(session, document: Document) -> Job:
- """Create, persist, and return a Job linked to a Document."""
job = Job(document_id=document.id)
session.add(job)
session.commit()
@@ -33,147 +30,132 @@ def _persist_job(session, document: Document) -> Job:
return job
-class TestDocumentModel:
- """Verify Document creation and default field population."""
+def _persist_source(session, document: Document, job: Job, **overrides) -> Source:
+ defaults = {
+ "document_id": document.id,
+ "job_id": job.id,
+ "upload_name": "letter.jpg",
+ "filename": "stored-letter.jpg",
+ "file_path": "/uploads/stored-letter.jpg",
+ }
+ defaults.update(overrides)
+ source = Source(**defaults)
+ session.add(source)
+ session.commit()
+ session.refresh(source)
+ return source
+
+class TestDocumentModel:
def test_can_be_persisted(self, session):
- """A Document round-trips through the database with correct fields."""
- doc = _persist_document(session)
- fetched = session.get(Document, doc.id)
+ document = _persist_document(session)
+ fetched = session.get(Document, document.id)
assert fetched is not None
- assert fetched.filename == "letter.jpg"
- assert fetched.file_path == "/uploads/letter.jpg"
+ assert fetched.name == "letter bundle"
def test_defaults_are_populated(self, session):
- """id is a UUID and uploaded_at is populated on creation."""
- doc = _persist_document(session)
- assert isinstance(doc.id, UUID)
- assert doc.uploaded_at is not None
+ document = _persist_document(session)
+ assert isinstance(document.id, UUID)
class TestJobModel:
- """Verify Job creation, defaults, and status transitions."""
-
def test_can_be_created_for_document(self, session):
- """A Job linked to a Document via FK persists correctly."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
+ document = _persist_document(session)
+ job = _persist_job(session, document)
fetched = session.get(Job, job.id)
assert fetched is not None
- assert fetched.document_id == doc.id
+ assert fetched.document_id == document.id
def test_defaults_are_populated(self, session):
- """Default status is queued; created_at and updated_at are populated."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
+ document = _persist_document(session)
+ job = _persist_job(session, document)
assert job.status == JobStatus.QUEUED
assert job.retry_count == 0
- assert job.created_at is not None
- assert job.updated_at is not None
+ assert job.date_created is not None
+ assert job.date_updated is not None
def test_transitions_to_transcribed(self, session):
- """Status updates from queued to processing to transcribed."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
- assert job.status == JobStatus.QUEUED
+ document = _persist_document(session)
+ job = _persist_job(session, document)
job.status = JobStatus.PROCESSING
session.add(job)
session.commit()
session.refresh(job)
- assert job.status == JobStatus.PROCESSING
job.status = JobStatus.TRANSCRIBED
session.add(job)
session.commit()
session.refresh(job)
+
assert job.status == JobStatus.TRANSCRIBED
- def test_transitions_to_failed(self, session):
- """Status updates from processing to failed."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
- job.status = JobStatus.PROCESSING
- session.add(job)
- session.commit()
- session.refresh(job)
+class TestSourceModel:
+ def test_can_be_created_for_document_and_job(self, session):
+ document = _persist_document(session)
+ job = _persist_job(session, document)
+ source = _persist_source(session, document, job)
- job.status = JobStatus.FAILED
- session.add(job)
- session.commit()
- session.refresh(job)
- assert job.status == JobStatus.FAILED
-
-
-class TestTranscriptModel:
- """Verify Transcript persistence for success and failure cases."""
-
- def test_success_record_persists(self, session):
- """A Transcript with text set and error_detail None persists correctly."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
- transcript = Transcript(job_id=job.id, text="Dear Sir, ...")
- session.add(transcript)
- session.commit()
- session.refresh(transcript)
-
- fetched = session.get(Transcript, transcript.id)
+ fetched = session.get(Source, source.id)
assert fetched is not None
- assert fetched.text == "Dear Sir, ..."
- assert fetched.error_detail is None
+ assert fetched.document_id == document.id
+ assert fetched.job_id == job.id
+ assert fetched.date_uploaded is not None
- def test_failure_record_persists(self, session):
- """A Transcript with text None and error_detail set persists correctly."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
- transcript = Transcript(job_id=job.id, error_detail="Provider timeout")
- session.add(transcript)
+
+class TestRevisionModel:
+ def test_revision_persists_for_source(self, session):
+ document = _persist_document(session)
+ job = _persist_job(session, document)
+ source = _persist_source(session, document, job)
+
+ revision = Revision(source_id=source.id, text="Edited revision text")
+ session.add(revision)
session.commit()
- session.refresh(transcript)
+ session.refresh(revision)
- fetched = session.get(Transcript, transcript.id)
+ fetched = session.get(Revision, revision.id)
assert fetched is not None
- assert fetched.text is None
- assert fetched.error_detail == "Provider timeout"
+ assert fetched.text == "Edited revision text"
+ assert fetched.date_created is not None
- def test_job_id_is_unique(self, session):
- """Inserting two transcripts with the same job_id raises an integrity error."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
+ def test_source_id_is_unique(self, session):
+ document = _persist_document(session)
+ job = _persist_job(session, document)
+ source = _persist_source(session, document, job)
- t1 = Transcript(job_id=job.id, text="First")
- session.add(t1)
+ first = Revision(source_id=source.id, text="First")
+ session.add(first)
session.commit()
- t2 = Transcript(job_id=job.id, text="Duplicate")
- session.add(t2)
+ duplicate = Revision(source_id=source.id, text="Duplicate")
+ session.add(duplicate)
with pytest.raises(IntegrityError):
session.commit()
class TestRelationships:
- """Verify SQLModel relationship navigation between models."""
+ def test_document_exposes_jobs_and_sources(self, session):
+ document = _persist_document(session)
+ job = _persist_job(session, document)
+ _persist_source(session, document, job)
- def test_document_exposes_jobs(self, session):
- """document.jobs returns the linked Job list."""
- doc = _persist_document(session)
- _persist_job(session, doc)
- _persist_job(session, doc)
+ session.refresh(document)
+ assert len(document.jobs) == 1
+ assert len(document.sources) == 1
- session.refresh(doc)
- assert len(doc.jobs) == 2
- assert all(isinstance(j, Job) for j in doc.jobs)
+ def test_source_exposes_optional_single_revision(self, session):
+ document = _persist_document(session)
+ job = _persist_job(session, document)
+ source = _persist_source(session, document, job)
- def test_job_exposes_transcript(self, session):
- """job.transcript returns the linked Transcript."""
- doc = _persist_document(session)
- job = _persist_job(session, doc)
- transcript = Transcript(job_id=job.id, text="Transcribed text")
- session.add(transcript)
+ assert source.revision is None
+
+ revision = Revision(source_id=source.id, text="Edited")
+ session.add(revision)
session.commit()
- session.refresh(job)
- assert job.transcript is not None
- assert isinstance(job.transcript, Transcript)
- assert job.transcript.text == "Transcribed text"
+ session.refresh(source)
+ assert source.revision is not None
+ assert source.revision.text == "Edited"
diff --git a/uploads/287bb88d-80c1-4553-aedc-35f2167c49b6_Book Two - page 61.jpg b/uploads/287bb88d-80c1-4553-aedc-35f2167c49b6_Book Two - page 61.jpg
deleted file mode 100644
index de4eac7672be22539fbe32b4dcd1d14d520867e8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 1256451
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