feat: add dashboard activity chart and user stats endpoint

Add GET /api/v1/auth/me/stats endpoint returning daily session counts
(last 30 days) and status totals across all accessible installations.
Add SVG-based ActivityChart component (no external deps). Wire stats
into dashboard stat strip and display chart above installation cards.

Author: mariuspruvot

apps/api/src/helprs/modules/identity/router.py

@@ -8,12 +8,13 @@
 
 from helprs.core.dependencies import DbSession, GetSettings, get_current_user
 from helprs.core.middleware import limiter
-from helprs.modules.identity.schemas import TokenResponse, UserResponse
+from helprs.modules.identity.schemas import TokenResponse, UserResponse, UserStatsResponse
 from helprs.modules.identity.service import (
     create_token_pair,
     exchange_code_for_token,
     fetch_github_user,
     get_or_create_user,
+    get_user_stats,
     refresh_tokens,
 )
 
@@ -148,6 +149,19 @@ async def refresh(
     return response
 
 
+@router.get("/me/stats", response_model=UserStatsResponse)
+@limiter.limit("30/minute")
+async def get_my_stats(
+    request: Request,
+    session: DbSession,
+    settings: GetSettings,
+    user=Depends(get_current_user),  # noqa: B008
+):
+    """Return session statistics for the authenticated user."""
+    stats = await get_user_stats(session, user, settings)
+    return UserStatsResponse(**stats)
+
+
 @router.get("/me", response_model=UserResponse)
 @limiter.limit("30/minute")
 async def get_me(

apps/api/src/helprs/modules/identity/schemas.py

@@ -24,3 +24,20 @@ class TokenResponse(BaseModel):
 
 class RefreshRequest(BaseModel):
     pass
+
+
+class DailyCount(BaseModel):
+    date: datetime
+    count: int
+
+
+class StatusTotals(BaseModel):
+    completed: int
+    failed: int
+    timeout: int
+    total: int
+
+
+class UserStatsResponse(BaseModel):
+    daily_counts: list[DailyCount]
+    totals: StatusTotals

apps/api/src/helprs/modules/identity/service.py

@@ -152,3 +152,62 @@ async def refresh_tokens(
         raise UnauthorizedError("User not found")
 
     return create_token_pair(user, settings)
+
+
+async def get_user_stats(
+    session: AsyncSession,
+    user: GitHubUser,
+    settings: "Settings",
+) -> dict:
+    """Return session stats for the authenticated user across all accessible installations."""
+    from datetime import UTC, datetime, timedelta
+
+    from sqlalchemy import case, cast, func
+    from sqlalchemy.types import Date
+
+    from helprs.modules.container.models import ContainerSession, ContainerStatus
+    from helprs.modules.installation.service import get_installations_for_user
+
+    installations = await get_installations_for_user(session, user, settings)
+    installation_ids = [i.id for i in installations]
+
+    if not installation_ids:
+        return {
+            "daily_counts": [],
+            "totals": {"completed": 0, "failed": 0, "timeout": 0, "total": 0},
+        }
+
+    # Status totals
+    totals_result = await session.execute(
+        select(
+            func.count(ContainerSession.id).label("total"),
+            func.count(case((ContainerSession.status == ContainerStatus.COMPLETED, 1))).label("completed"),
+            func.count(case((ContainerSession.status == ContainerStatus.FAILED, 1))).label("failed"),
+            func.count(case((ContainerSession.status == ContainerStatus.TIMEOUT, 1))).label("timeout"),
+        ).where(ContainerSession.installation_id.in_(installation_ids))
+    )
+    row = totals_result.one()
+    totals = {
+        "completed": row.completed,
+        "failed": row.failed,
+        "timeout": row.timeout,
+        "total": row.total,
+    }
+
+    # Daily counts (last 30 days)
+    cutoff = datetime.now(UTC) - timedelta(days=30)
+    daily_result = await session.execute(
+        select(
+            cast(ContainerSession.created_at, Date).label("day"),
+            func.count(ContainerSession.id).label("count"),
+        )
+        .where(
+            ContainerSession.installation_id.in_(installation_ids),
+            ContainerSession.created_at >= cutoff,
+        )
+        .group_by("day")
+        .order_by("day")
+    )
+    daily_counts = [{"date": row.day, "count": row.count} for row in daily_result.all()]
+
+    return {"daily_counts": daily_counts, "totals": totals}

apps/web/src/features/dashboard/ActivityChart.tsx

@@ -0,0 +1,74 @@
+/**
+ * ActivityChart — simple SVG bar chart for session activity over 30 days.
+ * No external charting library — just proportional <rect> elements.
+ */
+
+interface DailyCount {
+  date: string
+  count: number
+}
+
+interface ActivityChartProps {
+  data: DailyCount[]
+}
+
+export default function ActivityChart({ data }: ActivityChartProps) {
+  if (data.length === 0) {
+    return (
+      <div className="text-dim text-xs font-mono py-4 text-center">
+        // no sessions in the last 30 days
+      </div>
+    )
+  }
+
+  const maxCount = Math.max(...data.map((d) => d.count), 1)
+  const barCount = data.length
+  const chartWidth = 100
+  const chartHeight = 80
+  const barGap = 1
+  const barWidth = Math.max(1, (chartWidth - barGap * (barCount - 1)) / barCount)
+
+  return (
+    <svg
+      viewBox={`0 0 ${chartWidth} ${chartHeight + 16}`}
+      className="w-full"
+      style={{ height: '100px' }}
+      preserveAspectRatio="none"
+    >
+      {data.map((d, i) => {
+        const barHeight = Math.max(1, (d.count / maxCount) * chartHeight)
+        const x = i * (barWidth + barGap)
+        const y = chartHeight - barHeight
+
+        return (
+          <g key={d.date}>
+            <rect
+              x={x}
+              y={y}
+              width={barWidth}
+              height={barHeight}
+              rx={0.5}
+              fill="var(--color-accent)"
+              opacity={0.65}
+            >
+              <title>{`${d.date}: ${d.count} session${d.count !== 1 ? 's' : ''}`}</title>
+            </rect>
+            {/* Show label every 7 bars */}
+            {i % 7 === 0 && (
+              <text
+                x={x + barWidth / 2}
+                y={chartHeight + 10}
+                textAnchor="middle"
+                fill="var(--color-dim)"
+                fontSize="3"
+                fontFamily="var(--font-family-mono)"
+              >
+                {new Date(d.date).toLocaleDateString('en', { month: 'short', day: 'numeric' })}
+              </text>
+            )}
+          </g>
+        )
+      })}
+    </svg>
+  )
+}

apps/web/src/features/dashboard/InstallationList.tsx

@@ -6,24 +6,30 @@
 import { useState, useEffect, useCallback } from 'react'
 import { useNavigate } from 'react-router'
 import { useAuthStore } from '../auth/store'
-import { fetchInstallations } from './dashboardApi'
-import type { InstallationSummary } from './dashboardApi'
+import { fetchInstallations, fetchUserStats } from './dashboardApi'
+import type { InstallationSummary, UserStats } from './dashboardApi'
 import { Card, Chip, Dot, Overline, StatCard } from '../../shared/components'
+import ActivityChart from './ActivityChart'
 
 const INSTALL_URL = `https://github.com/apps/${import.meta.env.VITE_GITHUB_APP_SLUG ?? 'helprs'}/installations/new`
 
 export default function InstallationList() {
   const navigate = useNavigate()
   const user = useAuthStore((s) => s.user)
   const [installations, setInstallations] = useState<InstallationSummary[]>([])
+  const [stats, setStats] = useState<UserStats | null>(null)
   const [loading, setLoading] = useState(true)
   const [error, setError] = useState<string | null>(null)
 
   const load = useCallback(async () => {
     setLoading(true)
     try {
-      const data = await fetchInstallations()
-      setInstallations(data.items)
+      const [instData, statsData] = await Promise.all([
+        fetchInstallations(),
+        fetchUserStats().catch(() => null),
+      ])
+      setInstallations(instData.items)
+      setStats(statsData)
     } catch {
       setError('Failed to load installations')
     } finally {
@@ -57,10 +63,18 @@ export default function InstallationList() {
       <div className="grid grid-cols-2 md:grid-cols-4 gap-3 mb-8">
         <StatCard label="Installations" value={installations.length} />
         <StatCard label="Configured" value={configured} color={configured > 0 ? 'ok' : 'warn'} sub={`of ${installations.length}`} />
-        <StatCard label="Total sessions" value={totalSessions} color="accent" />
-        <StatCard label="Status" value={error ? 'Error' : 'Live'} color={error ? 'danger' : 'ok'} />
+        <StatCard label="Total sessions" value={stats?.totals.total ?? totalSessions} color="accent" />
+        <StatCard label="Completed" value={stats?.totals.completed ?? 0} color="ok" />
       </div>
 
+      {/* Activity chart */}
+      {stats && stats.daily_counts.length > 0 && (
+        <Card className="mb-8 px-4 py-3">
+          <Overline className="mb-3">{'\u25b8'} ACTIVITY {'\u00b7'} last 30 days</Overline>
+          <ActivityChart data={stats.daily_counts} />
+        </Card>
+      )}
+
       {/* Error */}
       {error && (
         <Card className="mb-6 border-danger/30">

apps/web/src/features/dashboard/dashboardApi.ts

@@ -49,6 +49,29 @@ export async function fetchInstallations(): Promise<InstallationListResponse> {
   return resp.json() as Promise<InstallationListResponse>
 }
 
+export interface DailyCount {
+  date: string
+  count: number
+}
+
+export interface StatusTotals {
+  completed: number
+  failed: number
+  timeout: number
+  total: number
+}
+
+export interface UserStats {
+  daily_counts: DailyCount[]
+  totals: StatusTotals
+}
+
+export async function fetchUserStats(): Promise<UserStats> {
+  const resp = await apiFetch('/api/v1/auth/me/stats')
+  if (!resp.ok) throw new Error(`Failed to fetch stats: ${resp.status}`)
+  return resp.json() as Promise<UserStats>
+}
+
 export async function fetchInstallationSessions(
   installationId: number,
   page: number = 1,