How tostman1/notenarchiv works
Notenarchiv is a local Django application for a music association. The verified source documents durable job recovery and cancellation, German-language management of works and members, and bounded PDF inspection primitives; the published preview is more limited. Archive indexing, review, and publication code is present, but the README says those product capabilities remain unavailable, so they are shown as an implementation subsystem rather than an available user workflow. The excerpts support several internal calls; other connections are omitted where wiring was not shown.
Main entry points: files.py Safe file access · indexing.py Archive indexing · publication.py Copy and publication · queue.py Queue and claims
Components 23
Catalog management
- Catalog CRUD and search
apps/catalog/views.py - Catalog services
apps/catalog/services.py - Works and arrangements
apps/catalog/models.py - Members and assignments
apps/members/models.py
Durable jobs
- Job management
apps/jobs/views.py - Jobs and leases
apps/jobs/models.py - Queue and claims
apps/jobs/services/queue.py - Job lifecycle
apps/jobs/services/lifecycle.py - Worker runner
apps/jobs/services/worker.py - Storage validation
apps/jobs/services/storage.py
Archive implementation
- Archive indexing
apps/archive/indexing.py - Archive records
apps/archive/models.py - Archive transitions
apps/archive/services.py - Review orchestration
apps/archive/review_services.py - Copy and publication
apps/archive/publication.py - Authorized preview
apps/archive/preview_services.py
Local processing
- Safe file access
core/files.py - Verified snapshots
core/preview.py - PDF processing API
core/pdf/api.py - Isolated PDF worker
core/pdf/_worker.py - Process control
core/processes.py - Path validation
core/paths.py
Other components
- Archivist
Connections 26
- Archivist → Catalog CRUD and search: manages catalog
README.md - Catalog CRUD and search → Catalog services: delegates to
- Catalog services → Works and arrangements: updates
apps/catalog/services.py - Archivist → Job management: manages jobs
README.md - Worker runner → Queue and claims: claims and heartbeats
apps/jobs/services/worker.py - Worker runner → Job lifecycle: completes attempts
apps/jobs/services/worker.py - Queue and claims → Jobs and leases: updates queue state
apps/jobs/services/queue.py - Job lifecycle → Queue and claims: uses queue
apps/jobs/services/lifecycle.py - Worker runner → Safe file access: uses locks
apps/jobs/services/worker.py - Storage validation → Safe file access: validates roots
- Archive indexing → Archive records: records index
apps/archive/indexing.py - Archive indexing → Archive transitions: uses transitions
apps/archive/indexing.py - Archive indexing → Copy and publication: queues copies
apps/archive/indexing.py - Archive indexing → Queue and claims: queues jobs
apps/archive/indexing.py - Archive indexing → Safe file access: reads files
apps/archive/indexing.py - Review orchestration → Archive transitions: validates and records
apps/archive/review_services.py - Review orchestration → Authorized preview: verifies bytes
apps/archive/review_services.py - Review orchestration → Copy and publication: queues approval
apps/archive/review_services.py - Authorized preview → Verified snapshots: reads snapshot
apps/archive/preview_services.py - Authorized preview → PDF processing API: renders thumbnail
apps/archive/preview_services.py - Verified snapshots → Safe file access: opens managed file
core/preview.py - Copy and publication → Safe file access: publishes copies
apps/archive/publication.py - Copy and publication → Works and arrangements: uses catalog records
apps/archive/publication.py - PDF processing API → Process control: runs isolated process
core/pdf/api.py - Isolated PDF worker → Process control: worker process
core/pdf/_worker.py - Safe file access → Path validation: validates references
core/files.py