How adoocat/tez works
TEz is a local-first systematic literature review workbench, delivered through a web UI in a Tauri desktop app and a Python API backed by a local SQLite library. The principal workflow moves from federated search and file imports through screening, appraisal, and PRISMA/bibliography reporting; library management and reading support that work. The README documents these product stages, while sampled backend services and the application factory show selected internal calls and route registration. Several feature implementations were not sampled, so their links are documented or left unverified rather than inferred from filenames.
Main entry points: main.py HTTP application · screening/service.py Screening · search/service.py Federated search · paper_service.py Paper library
Components 20
User experience
- Review workspace
apps/web/src/app/App.tsx
Discovery and library
- Federated search
backend/src/tez/modules/search/service.py - Academic sources
backend/src/tez/modules/search/providers/registry.py - File imports
backend/src/tez/modules/importers - Paper library
backend/src/tez/modules/library/paper_service.py - PDF files
backend/src/tez/modules/files - PDF reader
apps/web/src/features/reader/ReaderPage.tsx
Review methods
- Review setup
backend/src/tez/modules/reviews/service.py - Screening
backend/src/tez/modules/screening/service.py - Reviewer agreement
backend/src/tez/modules/dual_screening/service.py - Citation snowballing
backend/src/tez/modules/snowballing - Grey literature
backend/src/tez/modules/greylit - Quality appraisal
backend/src/tez/modules/quality/service.py - PRISMA reporting
backend/src/tez/modules/prisma - Bibliography export
backend/src/tez/modules/export
Local platform
- HTTP application
backend/src/tez/main.py - SQLite library
backend/src/tez/core/db.py - Background jobs
backend/src/tez/modules/jobs - Backup and restore
backend/src/tez/modules/backup
Other components
- Researcher
Connections 34
- Researcher → Review workspace: uses
README.md - Review workspace → HTTP application: requests
- HTTP application → Federated search: registers routes
backend/src/tez/main.py - HTTP application → Review setup: registers routes
backend/src/tez/main.py - HTTP application → Screening: registers routes
backend/src/tez/main.py - HTTP application → Reviewer agreement: registers routes
backend/src/tez/main.py - HTTP application → Quality appraisal: registers routes
backend/src/tez/main.py - HTTP application → File imports: registers routes
backend/src/tez/main.py - HTTP application → PRISMA reporting: registers routes
backend/src/tez/main.py - HTTP application → Bibliography export: registers routes
backend/src/tez/main.py - HTTP application → PDF files: registers routes
backend/src/tez/main.py - HTTP application → Background jobs: registers routes
backend/src/tez/main.py - HTTP application → Backup and restore: registers routes
backend/src/tez/main.py - Federated search → Academic sources: queries sources
backend/src/tez/modules/search/service.py - Federated search → Paper library: stores papers
backend/src/tez/modules/search/service.py - File imports → Paper library: adds records
- Review setup → Screening: provides review data
backend/src/tez/modules/screening/service.py - Screening → Paper library: reads papers
backend/src/tez/modules/screening/service.py - Quality appraisal → Review setup: uses review data
backend/src/tez/modules/quality/service.py - Quality appraisal → Screening: uses decisions
backend/src/tez/modules/quality/service.py - Reviewer agreement → Review setup: uses review data
backend/src/tez/modules/dual_screening/service.py - Reviewer agreement → Screening: uses decisions
backend/src/tez/modules/dual_screening/service.py - Citation snowballing → Federated search: reuses search
backend/src/tez/modules/snowballing/service.py - Citation snowballing → Background jobs: dispatches work
backend/src/tez/modules/snowballing/service.py - Screening → SQLite library: reads and writes
backend/src/tez/modules/screening/service.py - Paper library → SQLite library: reads and writes
backend/src/tez/modules/library/paper_service.py - PDF files → PDF reader: serves PDFs
- Federated search → SQLite library: records results
backend/src/tez/modules/search/service.py - Researcher → PDF reader: reads papers
README.md - Researcher → PRISMA reporting: reviews flow
README.md - Researcher → Bibliography export: exports bibliography
README.md - Researcher → Citation snowballing: finds citations
README.md - Researcher → Grey literature: adds sources
README.md - Researcher → Backup and restore: backs up library
README.md