How soraou/archiveapp works
Office Document Archive is a local desktop finding aid: staff file scans with type-specific details and tags, then search, preview and open them later. The workflow starts in the Tkinter app, uses Archive business rules to validate and record metadata and stored files, and serves results in the main window. Separate capabilities cover type/tag administration, OCR-assisted filing, integrity checks, backups and restore, activity history, and an optional read-only browser view that excludes confidential documents. Relationships are limited to calls documented by excerpts, the source index, or README; unsampled internals are not inferred.
Main entry points: main_window.py Search window · services.py Archive rules · add_dialog.py File document · pending_window.py Pending documents
Components 24
Desktop experience
- Application startup
app.py - Search window
ui/main_window.py - Shared UI dialogs
ui/common.py
Archive workflows
- File document
ui/add_dialog.py - Bulk import
ui/import_dialog.py - Pending documents
ui/pending_window.py - Document preview
ui/preview.py - Type administration
ui/type_manager.py - Type setup dialogs
ui/type_dialogs.py - Tag administration
ui/tag_manager.py - OCR review
ui/ocr_dialog.py
Archive data
- Archive rules
services.py - Archive database
db.py - Scanned file storage
storage.py - OCR extraction
ocr.py
Operations and access
- Backup and checks
ui/maintenance.py - Backup engine
backup.py - Restore utility
restore.py - Recycle bin
ui/recycle_bin.py - Activity history
ui/activity_log.py - Browser controls
ui/web_dialog.py - Read-only browser
webserver.py
Other components
- Office staff
- Archive operator
Connections 36
- Office staff → Application startup: starts
README.md - Application startup → Search window: opens
app.py - Search window → Archive rules: searches
ui/main_window.py - Search window → File document: opens filing
ui/main_window.py - Search window → Bulk import: opens import
ui/main_window.py - Search window → Pending documents: opens queue
ui/main_window.py - Search window → Document preview: shows preview
ui/main_window.py - Search window → Type administration: opens types
ui/main_window.py - Search window → Tag administration: opens tags
ui/main_window.py - Search window → OCR review: opens OCR
ui/main_window.py - Search window → Backup and checks: opens tools
ui/main_window.py - Search window → Recycle bin: opens bin
ui/main_window.py - Search window → Activity history: opens log
ui/main_window.py - Search window → Browser controls: opens browser
ui/main_window.py - File document → Archive rules: files records
ui/add_dialog.py - File document → Document preview: previews scans
ui/add_dialog.py - File document → Type setup dialogs: configures types
ui/add_dialog.py - Bulk import → Archive rules: imports records
ui/import_dialog.py - Pending documents → File document: files selected
ui/pending_window.py - Pending documents → Archive rules: loads records
ui/pending_window.py - Type administration → Archive rules: manages types
ui/type_manager.py - Type administration → Type setup dialogs: edits fields
ui/type_manager.py - Tag administration → Archive rules: manages tags
ui/tag_manager.py - OCR review → Archive rules: updates records
ui/ocr_dialog.py - Archive rules → Archive database: reads and writes
services.py - Archive rules → Scanned file storage: stores scans
services.py - Archive rules → OCR extraction: extracts text
services.py - Backup and checks → Backup engine: runs backup
ui/maintenance.py - Backup and checks → Archive rules: checks integrity
ui/maintenance.py - Archive operator → Restore utility: restores backup
README.md - Restore utility → Backup engine: reads backup
restore.py - Recycle bin → Archive rules: manages deletions
ui/recycle_bin.py - Activity history → Archive rules: reads history
- Browser controls → Read-only browser: controls server
ui/web_dialog.py - Read-only browser → Archive rules: searches publicly
webserver.py - Archive operator → Read-only browser: browses archive
README.md