feat: ajouter des statistiques de tableau de bord pour les commandes, groupes, tags et copies

Author: serge-eric-kalaga

backend/api/models.py

@@ -118,3 +118,18 @@ class Command(Base):
     @property
     def tags(self) -> list[str]:
         return sorted({t.name for t in self.tag_entities})
+
+
+class CopyEvent(Base):
+    __tablename__ = "copy_events"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    command_id: Mapped[int] = mapped_column(
+        ForeignKey("commands.id", ondelete="CASCADE"), index=True
+    )
+    delta: Mapped[int] = mapped_column(Integer, default=1)
+    created_at: Mapped[dt.datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), index=True
+    )
+
+    command: Mapped[Command] = relationship()

backend/api/routers/__init__.py

@@ -4,6 +4,7 @@
 from .imports import router as imports_router
 from .search import router as search_router
 from .tags import router as tags_router
+from .stats import router as stats_router
 
 __all__ = [
     "auth_router",
@@ -12,4 +13,5 @@
     "imports_router",
     "search_router",
     "tags_router",
+    "stats_router",
 ]

backend/api/routers/commands.py

@@ -6,7 +6,7 @@
 
 from ..database import get_db
 from ..deps import require_ready_user
-from ..models import Command, Group, Tag
+from ..models import Command, CopyEvent, Group, Tag
 from ..schemas import (
     CommandCreate,
     CommandOut,
@@ -191,6 +191,8 @@ def update_command(
 
     data = payload.model_dump(exclude_unset=True)
 
+    prev_copy_count = cmd.copy_count
+
     if "group_id" in data and data["group_id"] is not None:
         group = db.get(Group, data["group_id"])
         if group is None:
@@ -208,6 +210,12 @@ def update_command(
     for key, value in data.items():
         setattr(cmd, key, value)
 
+    if "copy_count" in data and data.get("copy_count") is not None:
+        next_copy_count = int(cmd.copy_count or 0)
+        if next_copy_count > int(prev_copy_count or 0):
+            delta = next_copy_count - int(prev_copy_count or 0)
+            db.add(CopyEvent(command_id=cmd.id, delta=delta))
+
     db.add(cmd)
     db.commit()
     db.refresh(cmd)

backend/api/routers/stats.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import datetime as dt
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy import func, select
+from sqlalchemy.orm import Session
+
+from ..database import get_db
+from ..deps import require_ready_user
+from ..models import Command, CopyEvent, Group, Tag
+from ..schemas import DashboardStatsResponse
+
+router = APIRouter(
+    prefix="/stats", tags=["stats"], dependencies=[Depends(require_ready_user)]
+)
+
+
+def _default_range() -> tuple[dt.date, dt.date]:
+    today = dt.date.today()
+    return (today - dt.timedelta(days=30), today)
+
+
+@router.get("/dashboard", response_model=DashboardStatsResponse)
+def dashboard_stats(
+    from_date: dt.date | None = Query(
+        default=None, description="Start date (YYYY-MM-DD)"
+    ),
+    to_date: dt.date | None = Query(default=None, description="End date (YYYY-MM-DD)"),
+    db: Session = Depends(get_db),
+) -> DashboardStatsResponse:
+    if from_date is None or to_date is None:
+        d0, d1 = _default_range()
+        from_date = from_date or d0
+        to_date = to_date or d1
+
+    if from_date > to_date:
+        from_date, to_date = to_date, from_date
+
+    # Inclusive day range: [from 00:00, to+1day 00:00)
+    start_dt = dt.datetime.combine(from_date, dt.time.min)
+    end_dt = dt.datetime.combine(to_date + dt.timedelta(days=1), dt.time.min)
+
+    commands = int(db.scalar(select(func.count(Command.id))) or 0)
+    groups = int(db.scalar(select(func.count(Group.id))) or 0)
+    tags = int(db.scalar(select(func.count(Tag.id))) or 0)
+
+    copies_stmt = select(func.coalesce(func.sum(CopyEvent.delta), 0)).where(
+        CopyEvent.created_at >= start_dt,
+        CopyEvent.created_at < end_dt,
+    )
+    copies = int(db.scalar(copies_stmt) or 0)
+
+    return DashboardStatsResponse(
+        commands=commands,
+        groups=groups,
+        tags=tags,
+        copies=copies,
+        from_date=from_date,
+        to_date=to_date,
+    )

backend/api/schemas.py

@@ -108,3 +108,12 @@ class CommandStatsResponse(BaseModel):
 
 class SearchResponse(BaseModel):
     items: list[CommandOut]
+
+
+class DashboardStatsResponse(BaseModel):
+    commands: int
+    groups: int
+    tags: int
+    copies: int
+    from_date: dt.date
+    to_date: dt.date

backend/main.py

@@ -10,6 +10,7 @@
     groups_router,
     imports_router,
     search_router,
+    stats_router,
     tags_router,
 )
 from api.routers.auth import ensure_default_admin
@@ -48,6 +49,7 @@ async def lifespan(_: FastAPI):
 app.include_router(imports_router)
 app.include_router(search_router)
 app.include_router(tags_router)
+app.include_router(stats_router)
 
 
 @app.get("/health")

backend/tests/test_stats_dashboard.py

@@ -0,0 +1,76 @@
+import datetime as dt
+
+
+def _login(client, username: str, password: str) -> dict:
+    res = client.post("/auth/login", json={"username": username, "password": password})
+    assert res.status_code == 200
+    return res.json()
+
+
+def _auth_headers(token: str) -> dict[str, str]:
+    return {"Authorization": f"Bearer {token}"}
+
+
+def test_dashboard_stats_counts_and_copies_range(client):
+    login = _login(client, "admin", "admin")
+    token = login["access_token"]
+
+    # Need to be a "ready" user
+    res = client.post(
+        "/auth/change-password",
+        json={"old_password": "admin", "new_password": "admin123"},
+        headers=_auth_headers(token),
+    )
+    assert res.status_code == 200
+
+    login2 = _login(client, "admin", "admin123")
+    token2 = login2["access_token"]
+
+    # Create group
+    res = client.post(
+        "/groups",
+        json={"name": "Projet A"},
+        headers=_auth_headers(token2),
+    )
+    assert res.status_code == 201
+    group = res.json()
+
+    # Create command with 2 tags
+    res = client.post(
+        "/commands",
+        json={
+            "group_id": group["id"],
+            "title": "Hello",
+            "command": "echo hi",
+            "tags": ["docker", "git"],
+        },
+        headers=_auth_headers(token2),
+    )
+    assert res.status_code == 201
+    cmd = res.json()
+
+    # Simulate 3 copies (PATCH copy_count)
+    res = client.patch(
+        f"/commands/{cmd['id']}",
+        json={"copy_count": 3},
+        headers=_auth_headers(token2),
+    )
+    assert res.status_code == 200
+    assert res.json()["copy_count"] == 3
+
+    today = dt.date.today().isoformat()
+
+    res = client.get(
+        "/stats/dashboard",
+        params={"from_date": today, "to_date": today},
+        headers=_auth_headers(token2),
+    )
+    assert res.status_code == 200
+    data = res.json()
+
+    assert data["commands"] == 1
+    assert data["groups"] == 1
+    assert data["tags"] == 2
+    assert data["copies"] == 3
+    assert data["from_date"] == today
+    assert data["to_date"] == today

frontend/src/components/AppSidebar.tsx

@@ -1,6 +1,6 @@
 import { useState, useRef } from "react";
 import {
-  Star, FolderOpen, Plus, Download, Upload, Sun, Moon, Menu, X, LogOut, Loader2,
+  Star, FolderOpen, Plus, Download, Upload, Sun, Moon, Menu, X, LogOut, Loader2, BarChart3,
 } from "lucide-react";
 import { Group, CommandStats } from "@/hooks/useCommandVault";
 import { Skeleton } from "@/components/ui/skeleton";
@@ -64,6 +64,16 @@ export default function AppSidebar({
 
       {/* Nav */}
       <div className="flex-1 overflow-y-auto p-3 space-y-1">
+        <button
+          onClick={() => nav("dashboard")}
+          disabled={loading}
+          className={`w-full flex items-center gap-2.5 px-3 py-2 rounded-md text-sm transition-colors ${activeView === "dashboard" ? "bg-surface-active text-foreground font-medium" : "text-sidebar-fg hover:bg-surface-hover"
+            }`}
+        >
+          <BarChart3 className="w-4 h-4" />
+          <span>Dashboard</span>
+        </button>
+
         <button
           onClick={() => nav("all")}
           disabled={loading}