Merge pull request #316 from Rustmail/315-panel-statistics

feat(panel): add panel statistics

Author: Akinator31

.run/Run.run.xml

@@ -16,7 +16,7 @@
     <option name="isRedirectInput" value="false" />
     <option name="redirectInputPath" value="" />
     <method v="2">
-      <option name="ToolBeforeRunTask" enabled="true" actionId="Tool_External Tools_trunk" />
+      <option name="ToolBeforeRunTask" enabled="true" actionId="Tool_External Tools_Trunk" />
       <option name="CARGO.BUILD_TASK_PROVIDER" enabled="true" />
     </method>
   </configuration>

docs/guides/panel.md

@@ -63,11 +63,7 @@ Panel access requires one of:
 
 ### Dashboard
 
-The home view displays:
-
-- Bot status (online/offline)
-- Active ticket count
-- Quick statistics
+The home view displays a statistics dashboard with key metrics about your support activity. See [Statistics](#statistics) for details.
 
 ### Tickets
 
@@ -107,6 +103,74 @@ For super administrators:
 
 ---
 
+## Statistics
+
+The statistics dashboard provides insights into your support team's performance. It is visible to all users with the **View Panel** permission.
+
+### Period Selector
+
+Use the period selector to view statistics for different time ranges:
+
+- **7 days** - Recent activity
+- **30 days** - Monthly overview (default)
+- **90 days** - Quarterly trends
+
+### Overview Cards
+
+Key metrics displayed at the top:
+
+| Metric              | Description                                            |
+|---------------------|--------------------------------------------------------|
+| Open Tickets        | Number of currently open tickets                       |
+| Closed Today        | Tickets closed since midnight (server time)            |
+| Closed This Week    | Tickets closed in the last 7 days                      |
+| Total Closed        | All-time closed ticket count                           |
+| Avg Response Time   | Average time from ticket creation to first staff reply |
+| Avg Resolution Time | Average time from ticket creation to closure           |
+
+**Note:** Response time is calculated from when a user creates a ticket until a staff member sends their first message in that ticket.
+
+### Activity Chart
+
+A bar chart showing daily ticket activity:
+
+- **Blue bars** - Tickets created
+- **Green bars** - Tickets closed
+
+Hover over bars to see exact counts for each day. The chart is scrollable horizontally for longer periods (90 days).
+
+### Categories
+
+Breakdown of closed tickets by category. Shows:
+
+- Category name
+- Number of tickets
+- Percentage of total
+
+Categories are defined when tickets are moved to specific channels or assigned categories through commands.
+
+### Top Performers
+
+Highlights the top-performing staff members:
+
+| Award               | Criteria                                         |
+|---------------------|--------------------------------------------------|
+| Fastest Responder   | Lowest average response time (minimum 5 tickets) |
+| Most Messages       | Highest message count in tickets                 |
+| Most Tickets Closed | Highest number of closed tickets                 |
+
+### Staff Leaderboard
+
+Ranks staff members by activity within the selected period:
+
+- Username
+- Messages sent in tickets
+- Tickets closed
+
+Click **Show all** to expand beyond the top 5.
+
+---
+
 ## Permission System
 
 ### Super Administrators

rustmail/src/api/handler/bot/mod.rs

@@ -1,13 +1,15 @@
 pub mod config;
 pub mod restart;
 pub mod start;
+pub mod statistics;
 pub mod status;
 pub mod stop;
 pub mod tickets;
 
 pub use config::*;
 pub use restart::*;
 pub use start::*;
+pub use statistics::*;
 pub use status::*;
 pub use stop::*;
 pub use tickets::*;

rustmail/src/api/handler/bot/statistics.rs

@@ -0,0 +1,50 @@
+use crate::prelude::db::*;
+use crate::prelude::types::*;
+use axum::Json;
+use axum::extract::{Query, State};
+use axum::http::StatusCode;
+use axum::response::IntoResponse;
+use std::sync::Arc;
+use tokio::sync::Mutex;
+
+#[derive(serde::Deserialize)]
+pub struct StatisticsQuery {
+    #[serde(default = "default_days")]
+    pub days: i64,
+}
+
+fn default_days() -> i64 {
+    30
+}
+
+pub async fn handle_statistics(
+    State(bot_state): State<Arc<Mutex<BotState>>>,
+    Query(query): Query<StatisticsQuery>,
+) -> impl IntoResponse {
+    let days = match query.days {
+        7 | 30 | 90 => query.days,
+        _ => 30,
+    };
+
+    let state_lock = bot_state.lock().await;
+
+    let pool = match &state_lock.db_pool {
+        Some(p) => p.clone(),
+        None => {
+            return (
+                StatusCode::SERVICE_UNAVAILABLE,
+                Json(serde_json::json!({"error": "Database not available"})),
+            );
+        }
+    };
+
+    drop(state_lock);
+
+    match get_statistics(&pool, days).await {
+        Ok(stats) => (StatusCode::OK, Json(serde_json::to_value(stats).unwrap())),
+        Err(e) => (
+            StatusCode::INTERNAL_SERVER_ERROR,
+            Json(serde_json::json!({"error": format!("Failed to fetch statistics: {}", e)})),
+        ),
+    }
+}

rustmail/src/api/routes/bot.rs

@@ -32,6 +32,7 @@ pub fn create_bot_router(bot_state: Arc<Mutex<BotState>>) -> Router<Arc<Mutex<Bo
         .route("/status", get(handle_status_bot))
         .route("/tickets", get(handle_tickets_bot))
         .route("/config", get(handle_get_config))
+        .route("/statistics", get(handle_statistics))
         .layer(axum::middleware::from_fn_with_state(
             bot_state.clone(),
             move |state, jar, req, next| {

rustmail/src/db/operations/mod.rs

@@ -6,6 +6,7 @@ pub mod messages;
 pub mod reminders;
 pub mod scheduled;
 pub mod snippets;
+pub mod statistics;
 pub mod threads;
 
 pub use api_keys::*;
@@ -16,4 +17,5 @@ pub use messages::*;
 pub use reminders::*;
 pub use scheduled::*;
 pub use snippets::*;
+pub use statistics::*;
 pub use threads::*;