Skip to content

Commit 657fbae

Browse files
committed
docs(panel): document statistics dashboard
1 parent 181b1a2 commit 657fbae

1 file changed

Lines changed: 69 additions & 5 deletions

File tree

docs/guides/panel.md

Lines changed: 69 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,11 +63,7 @@ Panel access requires one of:
6363

6464
### Dashboard
6565

66-
The home view displays:
67-
68-
- Bot status (online/offline)
69-
- Active ticket count
70-
- Quick statistics
66+
The home view displays a statistics dashboard with key metrics about your support activity. See [Statistics](#statistics) for details.
7167

7268
### Tickets
7369

@@ -107,6 +103,74 @@ For super administrators:
107103

108104
---
109105

106+
## Statistics
107+
108+
The statistics dashboard provides insights into your support team's performance. It is visible to all users with the **View Panel** permission.
109+
110+
### Period Selector
111+
112+
Use the period selector to view statistics for different time ranges:
113+
114+
- **7 days** - Recent activity
115+
- **30 days** - Monthly overview (default)
116+
- **90 days** - Quarterly trends
117+
118+
### Overview Cards
119+
120+
Key metrics displayed at the top:
121+
122+
| Metric | Description |
123+
|---------------------|--------------------------------------------------------|
124+
| Open Tickets | Number of currently open tickets |
125+
| Closed Today | Tickets closed since midnight (server time) |
126+
| Closed This Week | Tickets closed in the last 7 days |
127+
| Total Closed | All-time closed ticket count |
128+
| Avg Response Time | Average time from ticket creation to first staff reply |
129+
| Avg Resolution Time | Average time from ticket creation to closure |
130+
131+
**Note:** Response time is calculated from when a user creates a ticket until a staff member sends their first message in that ticket.
132+
133+
### Activity Chart
134+
135+
A bar chart showing daily ticket activity:
136+
137+
- **Blue bars** - Tickets created
138+
- **Green bars** - Tickets closed
139+
140+
Hover over bars to see exact counts for each day. The chart is scrollable horizontally for longer periods (90 days).
141+
142+
### Categories
143+
144+
Breakdown of closed tickets by category. Shows:
145+
146+
- Category name
147+
- Number of tickets
148+
- Percentage of total
149+
150+
Categories are defined when tickets are moved to specific channels or assigned categories through commands.
151+
152+
### Top Performers
153+
154+
Highlights the top-performing staff members:
155+
156+
| Award | Criteria |
157+
|---------------------|--------------------------------------------------|
158+
| Fastest Responder | Lowest average response time (minimum 5 tickets) |
159+
| Most Messages | Highest message count in tickets |
160+
| Most Tickets Closed | Highest number of closed tickets |
161+
162+
### Staff Leaderboard
163+
164+
Ranks staff members by activity within the selected period:
165+
166+
- Username
167+
- Messages sent in tickets
168+
- Tickets closed
169+
170+
Click **Show all** to expand beyond the top 5.
171+
172+
---
173+
110174
## Permission System
111175

112176
### Super Administrators

0 commit comments

Comments
 (0)