How frappe/helpdesk works
Frappe Helpdesk is a customer-support system with an agent desk and customer portal. The main workflow is submitting or finding a ticket, agent handling and communication, then tracking response and resolution against policy. The repository also documents knowledge-base search, assignment rules, saved replies, and analytics. The graph preserves these product stages and major capabilities; many backend feature files are listed but unsampled, so their internal call relationships are not asserted.
Main entry points: hd_ticket.py Ticket Records · TicketAgent.vue Ticket Workspace · router.ts Customer Portal · App.vue Agent Desk
Components 20
Portals
- Agent Desk
desk/src/App.vue - Desk Bootstrap
desk/src/main.js - Customer Portal
studio/helpdesk/router.ts
Ticket Handling
- Ticket Records
helpdesk/helpdesk/doctype/hd_ticket/hd_ticket.py - Customer Ticket Rules
helpdesk/helpdesk/doctype/hd_ticket/customer_edit_controller.py - Ticket Workspace
desk/src/pages/ticket/TicketAgent.vue - Customer Records
helpdesk/helpdesk/doctype/hd_customer/hd_customer.py
Support Automation
- Assignment Rules
helpdesk/api/assignment_rule.py - SLA Tracking
helpdesk/helpdesk/doctype/hd_service_level_agreement/hd_service_level_agreement.py - Saved Replies
helpdesk/api/saved_replies.py
Knowledge and Search
- Knowledge Base
helpdesk/api/knowledge_base.py - Article Service
helpdesk/api/article.py - Search Service
helpdesk/api/search.py - Command Palette
desk/src/components/command-palette/useCommandPalette.ts
Backend Services
- Ticket Analytics
helpdesk/api/ticket_analytics.py - Agent Identity
helpdesk/api/auth.py - Telephony Integration
desk/src/components/telephony/CallUI.vue - Realtime Events
realtime/handlers.js
Other components
- Support Agent
- Customer
Connections 17
- Support Agent → Agent Desk: uses
README.md - Customer → Customer Portal: uses
README.md - Desk Bootstrap → Agent Desk: mounts
desk/src/main.js - Desk Bootstrap → Agent Desk: installs router
desk/src/main.js - Customer Portal → Ticket Records: submits tickets
- Customer Portal → Knowledge Base: browses articles
- Customer Portal → Search Service: searches articles
- Agent Desk → Ticket Workspace: renders workspace
- Ticket Workspace → Ticket Records: handles tickets
- Customer Ticket Rules → Ticket Records: guards edits
helpdesk/helpdesk/doctype/hd_ticket/customer_edit_controller.py - Ticket Records → SLA Tracking: tracks targets
- Ticket Workspace → Assignment Rules: assigns tickets
- Ticket Workspace → Saved Replies: uses replies
- Knowledge Base → Article Service: manages articles
- Command Palette → Ticket Records: finds ticket actions
- Ticket Records → Ticket Analytics: supplies metrics
- Ticket Workspace → Telephony Integration: supports calls