System Architecture

Jump to bottom

Sinbad Adjuik edited this page Apr 6, 2026 · 1 revision

System Architecture

Core Components

The application is centered around:

src/main.py
src/validation.py

Main Processing Model

The GUI chooses a workflow and then runs one shared batch pipeline.

Shared concepts:

folder discovery
pre-flight validation
CSV reporting
output-only packaging
post-processing validation
reconciliation reporting

Photo Workflow Path

Photo runs:

discover photo sets
pair images with XML metadata
convert the current asset to TIFF inside an output-side scratch workspace
package TIFF + XML + manifest.ini
clean the scratch workspace

Patent Workflow Path

Patent runs:

discover patent batch directories
validate the shared manifest structure
extract IID and normalized document ID from XML
locate the matching PDF locally or through fallback roots
package PDF + XML + manifest.ini

Output Strategy

The current system is non-mutating:

source folders are read only
staging output goes to staging_output/
production output goes to output/
scratch work lives under .work/ inside the active output root

Validation Layer

Validation is workflow-aware and checks:

output counts
ZIP structure
reconciliation totals

User Interface

The GUI has been refreshed to reflect the current system:

workflow-first selection
folder readiness summary
run-settings dialog
garnet-and-gold theme

Last updated: April 6, 2026