feat(shared): add volume series to AdminOverviewDTO

Author: Ripwords

packages/shared/src/admin.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, test } from "bun:test"
+import { AdminOverviewDTO } from "./admin"
+
+const base = {
+  counts: {
+    total: 0,
+    byStatus: { open: 0, in_progress: 0, resolved: 0, closed: 0 },
+    byPriority: { low: 0, normal: 0, high: 0, urgent: 0 },
+    last7Days: 0,
+  },
+  projects: { total: 0, withGithub: 0 },
+  recentReports: [],
+  recentEvents: [],
+  perProject: [],
+}
+
+describe("AdminOverviewDTO.volume", () => {
+  test("accepts a zero-filled volume series", () => {
+    const parsed = AdminOverviewDTO.parse({
+      ...base,
+      volume: [
+        { date: "2026-05-18", count: 3 },
+        { date: "2026-05-19", count: 0 },
+      ],
+    })
+    expect(parsed.volume).toEqual([
+      { date: "2026-05-18", count: 3 },
+      { date: "2026-05-19", count: 0 },
+    ])
+  })
+
+  test("rejects a payload missing volume", () => {
+    expect(() => AdminOverviewDTO.parse(base)).toThrow()
+  })
+
+  test("rejects a non-integer count", () => {
+    expect(() =>
+      AdminOverviewDTO.parse({ ...base, volume: [{ date: "2026-05-19", count: 1.5 }] }),
+    ).toThrow()
+  })
+})

packages/shared/src/admin.ts

@@ -60,5 +60,14 @@ export const AdminOverviewDTO = z.object({
   recentReports: z.array(AdminRecentReportDTO),
   recentEvents: z.array(AdminRecentEventDTO),
   perProject: z.array(AdminProjectBreakdownDTO),
+  // Zero-filled daily report counts for the trend chart. Ordered oldest →
+  // newest; every UTC day in the trailing window is present (gaps = 0).
+  // `date` is a `YYYY-MM-DD` UTC day string.
+  volume: z.array(
+    z.object({
+      date: z.string(),
+      count: z.number().int(),
+    }),
+  ),
 })
 export type AdminOverviewDTO = z.infer<typeof AdminOverviewDTO>