How samcooksdc/hilldesk works
HillDesk is a private-office scheduling workflow: Outlook messages are ingested, screened without AI, converted into structured draft candidates, and presented for staff review before events are committed. Approved events then support calendar operations, recurring series, contact linking, briefings, exports, and House floor context. The central orchestration and several model/provider modules are evidenced by excerpts or the source index; UI and authentication details are included at subsystem level where implementation was not sampled.
Main entry points: pipeline.py Pipeline task · tasks.py Event background tasks · services.py Review services · models.py Events and series
Components 24
Mail Intake
- Graph client
apps/email_processing/graph_client.py - Reception sync
apps/email_processing/tasks/reception.py - Message ledger
apps/email_processing/models.py - Deterministic funnel
apps/email_processing/funnel/engine.py - Filter audit
apps/email_processing/models.py
Extraction Review
- Pipeline task
apps/email_processing/tasks/pipeline.py - Mail channels
apps/email_processing/channels - Extraction providers
apps/email_processing/llm_providers - Candidate schema
apps/email_processing/llm_providers/schema.py - Draft candidates
apps/email_processing/models.py - Review workflow
apps/api/views.py - Review services
apps/api/services.py
Scheduling
- Events and series
apps/event_management/models.py - Calendar interface
apps/event_management/views/calendar_views.py - Contact matching
apps/contacts/services.py - Briefings and exports
apps/event_management/services/export_service.py - Event background tasks
apps/event_management/tasks.py
Office Access
- Authentication and security
apps/authentication/models.py - Access permissions
apps/authentication/permissions.py
External Context
- House floor feeds
apps/event_management/services/house_floor_service.py - Floor proceedings
apps/event_management/services/house_floor_proceedings_service.py
Other components
- Office staff
- Outlook mailbox
- House legislative feeds
Connections 24
- Outlook mailbox → Graph client: provides mail
README.md - Reception sync → Graph client: fetches messages
- Reception sync → Message ledger: records messages
- Message ledger → Pipeline task: enqueues processing
apps/email_processing/tasks/pipeline.py - Pipeline task → Deterministic funnel: screens message
apps/email_processing/tasks/pipeline.py - Deterministic funnel → Filter audit: writes stage audit
apps/email_processing/funnel/engine.py - Pipeline task → Mail channels: parses channels
apps/email_processing/tasks/pipeline.py - Pipeline task → Extraction providers: extracts candidates
apps/email_processing/tasks/pipeline.py - Extraction providers → Candidate schema: validates output
apps/email_processing/llm_providers/__init__.py - Pipeline task → Draft candidates: persists drafts
apps/email_processing/tasks/pipeline.py - Office staff → Review workflow: reviews drafts
README.md - Review workflow → Review services: invokes review actions
- Review services → Events and series: commits decisions
apps/api/services.py - Review services → Contact matching: resolves contacts
apps/api/services.py - Office staff → Calendar interface: manages schedule
- Calendar interface → Events and series: reads and updates events
- Event background tasks → Briefings and exports: renders briefings
apps/event_management/tasks.py - Briefings and exports → Events and series: reads event data
apps/event_management/services/export_service.py - Office staff → Authentication and security: signs in
- Access permissions → Authentication and security: checks identities
apps/authentication/permissions.py - Event background tasks → House floor feeds: refreshes schedule
apps/event_management/tasks.py - Event background tasks → Floor proceedings: refreshes feed
apps/event_management/tasks.py - House floor feeds → House legislative feeds: fetches schedule
- Floor proceedings → House legislative feeds: fetches proceedings