How hrushii1305/deskhive works
DeskHive is a multi-tenant helpdesk: users register or join an organization, then work with tickets and comments under organization and role-based access controls. Ticket creation scopes the ticket to its organization, assigns a least-loaded agent when available, records audit activity, and dispatches email tasks; agents can also claim tickets, while scheduled work escalates stale tickets. The README documents onboarding, REST and web interfaces, notifications, and WebSockets. Some capabilities are documented but their implementation was not sampled, so those links are identified as documented rather than inferred from unseen code.
Main entry points: tickets/views.py Ticket & comment API · index.html Web UI & API clients · accounts/views.py Registration & approvals · tasks.py Ticket email tasks
Components 19
Organizations & Access
- Organization catalog
organizations/views.py - Registration & approvals
accounts/views.py - Member roles & permissions
accounts/models.py - Approved-member guard
accounts/permissions.py - Organizations
organizations/models.py - Members
accounts/models.py
Ticket Support
- Ticket & comment API
tickets/views.py - Ticket serializers
tickets/serializers.py - Agent assignment
tickets/services.py - Tickets, comments & audit
tickets/models.py
Background & Realtime
- Ticket email tasks
tickets/tasks.py - Agent email tasks
accounts/tasks.py - Celery & escalation schedule
deskhive/celery.py - WebSocket routing
tickets/routing.py - Ticket WebSocket consumer
tickets/consumers.py
User Interfaces
- Web UI & API clients
templates/index.html - OpenAPI / Swagger
deskhive/urls.py
Other components
- Helpdesk users
- SMTP email
Connections 22
- Helpdesk users → Web UI & API clients: use
README.md - Web UI & API clients → Organization catalog: list organizations
README.md - Web UI & API clients → Registration & approvals: register or request access
README.md - Registration & approvals → Members: create or update
accounts/views.py - Registration & approvals → Agent email tasks: dispatch email
accounts/views.py - Agent email tasks → Members: read member
accounts/tasks.py - Agent email tasks → SMTP email: send email
accounts/tasks.py - Registration & approvals → Member roles & permissions: apply roles
accounts/views.py - Ticket & comment API → Approved-member guard: require approved member
tickets/views.py - Ticket & comment API → Tickets, comments & audit: query and persist
tickets/views.py - Ticket & comment API → Ticket serializers: serialize requests
tickets/views.py - Ticket & comment API → Agent assignment: select agent
tickets/views.py - Agent assignment → Members: count active assignments
tickets/services.py - Ticket & comment API → Ticket email tasks: dispatch email tasks
tickets/views.py - Ticket email tasks → Tickets, comments & audit: read ticket
tickets/tasks.py - Ticket email tasks → SMTP email: send email
tickets/tasks.py - Celery & escalation schedule → Ticket email tasks: schedule escalation
deskhive/celery.py - Web UI & API clients → Ticket & comment API: manage tickets
README.md - WebSocket routing → Ticket WebSocket consumer: route connections
tickets/routing.py - Ticket & comment API → Ticket WebSocket consumer: broadcast comments
tickets/views.py - Helpdesk users → WebSocket routing: connect for updates
README.md - Web UI & API clients → OpenAPI / Swagger: inspect API
README.md