How f0whb/zugzwang works
ZUGZWANG is a local-first desktop workstation for finding German employers, enriching leads, reviewing applications, and sending paced SMTP outreach. The documented path runs from a user search through scraping and local lead results, then contact enrichment, application-PDF preparation, and email dispatch; import/export and saved profiles support that workflow. The graph includes only relationships evidenced by the README or supplied source/index references. Several feature modules are unsampled, so their internal call paths are not asserted.
Main entry points: orchestrator.py Scraping orchestrator · config.py Local SQLite data · email_sender_page.py Outreach workspace · main_window.py Application window
Components 25
Discovery and leads
- Scraping orchestrator
src/services/orchestrator.py - Portal scrapers
src/services - Browser automation
src/services/browser.py - Lead records
src/core/models.py - Lead import and export
src/services/export_service.py
Enrichment and outreach
- Website and email enrichment
src/services/website_crawler.py - Email extraction
src/services/email_extractor.py - Application PDF builder
src/services/bewerbung_pdf_service.py - Sender and applicant profiles
src/services/profile_service.py - SMTP mail service
Desktop experience
- Search workspace
src/ui/search_page.py - Results review
src/ui/results_page.py - Lead editing
src/ui/edit_page.py - Outreach workspace
src/ui/email_sender_page.py - UI event bridge
src/ui/event_bridge.py - Application window
src/ui/main_window.py
Local services
- Local SQLite data
src/core/config.py - Application events
src/core/events.py - License and trial controls
src/core/security.py - Diagnostics
src/diagnostics.py - Backup and recovery
src/services/backup_service.py
Other components
- Candidate or recruiter
- German job and business portals
- Employer websites
- User SMTP account
Connections 30
- Candidate or recruiter → Search workspace: enters search
- Search workspace → Scraping orchestrator: starts searches
src/ui/search_page.py - Scraping orchestrator → Portal scrapers: dispatches jobs
src/services/orchestrator.py - Scraping orchestrator → Browser automation: manages sessions
src/services/orchestrator.py - Portal scrapers → German job and business portals: collect listings
- Portal scrapers → Lead records: produce leads
src/services/export_service.py - Scraping orchestrator → Lead import and export: uses import/export
src/services/orchestrator.py - Scraping orchestrator → Application events: publishes job events
src/core/events.py - Results review → Scraping orchestrator: uses job results
src/ui/results_page.py - Results review → Lead import and export: exports results
src/ui/results_page.py - Lead editing → Sender and applicant profiles: manages profiles
src/ui/edit_page.py - Lead editing → Email extraction: uses extraction
src/ui/edit_page.py - Lead editing → Application PDF builder: builds applications
src/ui/edit_page.py - Email extraction → Employer websites: finds contacts
- Outreach workspace → Sender and applicant profiles: loads profiles
src/ui/email_sender_page.py - Outreach workspace → SMTP mail service: sends paced mail
- SMTP mail service → User SMTP account: authenticates and sends
- Outreach workspace → Scraping orchestrator: records outreach
src/services/orchestrator.py - Lead import and export → Local SQLite data: saves project data
src/services/export_service.py - Sender and applicant profiles → Local SQLite data: stores profile data
src/services/profile_service.py - Search workspace → Local SQLite data: uses search history
src/core/config.py - Application window → Search workspace: hosts workspace
src/ui/main_window.py - Application window → Results review: hosts results
src/ui/main_window.py - Application window → Lead editing: hosts editor
src/ui/main_window.py - Application window → Outreach workspace: hosts outreach
src/ui/main_window.py - UI event bridge → Application events: subscribes events
src/ui/event_bridge.py - License and trial controls → Local SQLite data: persists trial settings
src/core/security.py - Diagnostics → Local SQLite data: reads configuration
src/diagnostics.py - Backup and recovery → Local SQLite data: backs up settings
src/services/backup_service.py - Candidate or recruiter → Outreach workspace: reviews and sends