feat(commissions): add customer records and kanban workflow baseline

TODO.md

@@ -124,7 +124,7 @@ This file is the single source of truth for roadmap and delivery progress.
   S3/local upload adapter, media processing presets, metadata input flows, admin media CRUD UI
 - [~] [P1] `todo/mvp1-pages-navigation-builder`:
   page CRUD, navigation tree, reusable page blocks (forms/price cards/gallery embeds)
-- [ ] [P1] `todo/mvp1-commissions-customers`:
+- [~] [P1] `todo/mvp1-commissions-customers`:
   commission request intake + admin CRUD + kanban + customer entity/linking
 - [ ] [P1] `todo/mvp1-announcements-news`:
   announcement management/rendering + news/blog CRUD and public rendering
@@ -156,10 +156,10 @@ This file is the single source of truth for roadmap and delivery progress.
 - [ ] [P1] Users management (invite, roles, status)
 - [ ] [P1] Disable/ban user function and enforcement in auth/session checks
 - [~] [P1] Owner/support protection rules in user management actions (cannot delete/demote)
-- [ ] [P1] Commissions management (request intake, owner, due date, notes, linked customer, linked artworks)
+- [~] [P1] Commissions management (request intake, owner, due date, notes, linked customer, linked artworks)
-- [ ] [P1] Customer records (contact profile, notes, consent flags, recurrence marker)
+- [~] [P1] Customer records (contact profile, notes, consent flags, recurrence marker)
-- [ ] [P1] Customer-to-commission linkage and reuse workflow (no re-entry for recurring customers)
+- [~] [P1] Customer-to-commission linkage and reuse workflow (no re-entry for recurring customers)
-- [ ] [P1] Kanban workflow for commissions (new, scoped, in-progress, review, done)
+- [~] [P1] Kanban workflow for commissions (new, scoped, in-progress, review, done)
 - [ ] [P1] Header banner management (message, CTA, active window)
 - [ ] [P1] Announcements management (prominent site notices with schedule, priority, and audience targeting)
 - [ ] [P2] News/blog editorial workflow (draft/review/publish, authoring metadata)
@@ -276,6 +276,7 @@ This file is the single source of truth for roadmap and delivery progress.
 - [2026-02-12] Admin media CRUD now includes list-to-detail flow (`/media/:id`) with metadata edit and delete actions.
 - [2026-02-12] MVP1 pages/navigation baseline started: `Page`, `NavigationMenu`, and `NavigationItem` models plus admin CRUD routes (`/pages`, `/pages/:id`, `/navigation`).
 - [2026-02-12] Public app now renders CMS-managed navigation (header) and CMS-managed pages by slug (including homepage when `home` page exists).
+- [2026-02-12] Commissions/customer baseline added: admin `/commissions` now supports customer creation, commission intake, status transitions, and a basic kanban board.
 
 ## How We Use This File
 

apps/admin/src/app/commissions/page.tsx

@@ -1,34 +1,454 @@
-import { AdminSectionPlaceholder } from "@/components/admin-section-placeholder"
+import {
+  commissionKanbanOrder,
+  createCommission,
+  createCustomer,
+  listCommissions,
+  listCustomers,
+  updateCommissionStatus,
+} from "@cms/db"
+import { Button } from "@cms/ui/button"
+import { revalidatePath } from "next/cache"
+import { redirect } from "next/navigation"
+
 import { AdminShell } from "@/components/admin-shell"
 import { requirePermissionForRoute } from "@/lib/route-guards"
 
 export const dynamic = "force-dynamic"
 
-export default async function CommissionsManagementPage() {
+type SearchParamsInput = Record<string, string | string[] | undefined>
+
+function readFirstValue(value: string | string[] | undefined): string | null {
+  if (Array.isArray(value)) {
+    return value[0] ?? null
+  }
+
+  return value ?? null
+}
+
+function readInputString(formData: FormData, field: string): string {
+  const value = formData.get(field)
+  return typeof value === "string" ? value.trim() : ""
+}
+
+function readNullableString(formData: FormData, field: string): string | null {
+  const value = readInputString(formData, field)
+  return value.length > 0 ? value : null
+}
+
+function readNullableNumber(formData: FormData, field: string): number | null {
+  const value = readInputString(formData, field)
+
+  if (!value) {
+    return null
+  }
+
+  const parsed = Number.parseFloat(value)
+
+  if (!Number.isFinite(parsed)) {
+    return null
+  }
+
+  return parsed
+}
+
+function readNullableDate(formData: FormData, field: string): Date | null {
+  const value = readInputString(formData, field)
+
+  if (!value) {
+    return null
+  }
+
+  const parsed = new Date(value)
+
+  if (Number.isNaN(parsed.getTime())) {
+    return null
+  }
+
+  return parsed
+}
+
+function redirectWithState(params: { notice?: string; error?: string }) {
+  const query = new URLSearchParams()
+
+  if (params.notice) {
+    query.set("notice", params.notice)
+  }
+
+  if (params.error) {
+    query.set("error", params.error)
+  }
+
+  const value = query.toString()
+  redirect(value ? `/commissions?${value}` : "/commissions")
+}
+
+async function createCustomerAction(formData: FormData) {
+  "use server"
+
+  await requirePermissionForRoute({
+    nextPath: "/commissions",
+    permission: "commissions:write",
+    scope: "own",
+  })
+
+  try {
+    await createCustomer({
+      name: readInputString(formData, "name"),
+      email: readNullableString(formData, "email"),
+      phone: readNullableString(formData, "phone"),
+      instagram: readNullableString(formData, "instagram"),
+      notes: readNullableString(formData, "notes"),
+      isRecurring: readInputString(formData, "isRecurring") === "true",
+    })
+  } catch {
+    redirectWithState({ error: "Failed to create customer." })
+  }
+
+  revalidatePath("/commissions")
+  redirectWithState({ notice: "Customer created." })
+}
+
+async function createCommissionAction(formData: FormData) {
+  "use server"
+
+  await requirePermissionForRoute({
+    nextPath: "/commissions",
+    permission: "commissions:write",
+    scope: "own",
+  })
+
+  try {
+    await createCommission({
+      title: readInputString(formData, "title"),
+      description: readNullableString(formData, "description"),
+      status: readInputString(formData, "status"),
+      customerId: readNullableString(formData, "customerId"),
+      assignedUserId: readNullableString(formData, "assignedUserId"),
+      budgetMin: readNullableNumber(formData, "budgetMin"),
+      budgetMax: readNullableNumber(formData, "budgetMax"),
+      dueAt: readNullableDate(formData, "dueAt"),
+    })
+  } catch {
+    redirectWithState({ error: "Failed to create commission." })
+  }
+
+  revalidatePath("/commissions")
+  redirectWithState({ notice: "Commission created." })
+}
+
+async function updateCommissionStatusAction(formData: FormData) {
+  "use server"
+
+  await requirePermissionForRoute({
+    nextPath: "/commissions",
+    permission: "commissions:transition",
+    scope: "own",
+  })
+
+  try {
+    await updateCommissionStatus({
+      id: readInputString(formData, "id"),
+      status: readInputString(formData, "status"),
+    })
+  } catch {
+    redirectWithState({ error: "Failed to transition commission." })
+  }
+
+  revalidatePath("/commissions")
+  redirectWithState({ notice: "Commission status updated." })
+}
+
+function formatDate(value: Date | null) {
+  if (!value) {
+    return "-"
+  }
+
+  return value.toLocaleDateString("en-US")
+}
+
+export default async function CommissionsManagementPage({
+  searchParams,
+}: {
+  searchParams: Promise<SearchParamsInput>
+}) {
   const role = await requirePermissionForRoute({
     nextPath: "/commissions",
     permission: "commissions:read",
     scope: "own",
   })
 
+  const [resolvedSearchParams, customers, commissions] = await Promise.all([
+    searchParams,
+    listCustomers(200),
+    listCommissions(300),
+  ])
+
+  const notice = readFirstValue(resolvedSearchParams.notice)
+  const error = readFirstValue(resolvedSearchParams.error)
+
   return (
     <AdminShell
       role={role}
       activePath="/commissions"
       badge="Admin App"
       title="Commissions"
-      description="Prepare commissions intake and kanban workflow tooling."
+      description="Manage customers and commission requests with kanban-style status transitions."
     >
-      <AdminSectionPlaceholder
+      {notice ? (
-        feature="Commissions Workflow"
+        <section className="rounded-xl border border-emerald-300 bg-emerald-50 px-4 py-3 text-sm text-emerald-800">
-        summary="This route is reserved for request intake, ownership assignment, and kanban transitions."
+          {notice}
-        requiredPermission="commissions:read (own)"
+        </section>
-        nextSteps={[
+      ) : null}
-          "Add commissions board with status columns.",
+
-          "Add assignment, due-date, and notes editing.",
+      {error ? (
-          "Add transition rules and audit history.",
+        <section className="rounded-xl border border-red-300 bg-red-50 px-4 py-3 text-sm text-red-800">
-        ]}
+          {error}
-      />
+        </section>
+      ) : null}
+
+      <section className="grid gap-4 xl:grid-cols-2">
+        <article className="rounded-xl border border-neutral-200 p-6">
+          <h2 className="text-xl font-medium">Create Customer</h2>
+          <form action={createCustomerAction} className="mt-4 space-y-3">
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Name</span>
+              <input
+                name="name"
+                required
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <div className="grid gap-3 md:grid-cols-2">
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Email</span>
+                <input
+                  name="email"
+                  type="email"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                />
+              </label>
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Phone</span>
+                <input
+                  name="phone"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                />
+              </label>
+            </div>
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Instagram</span>
+              <input
+                name="instagram"
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Notes</span>
+              <textarea
+                name="notes"
+                rows={3}
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <label className="inline-flex items-center gap-2 text-sm text-neutral-700">
+              <input name="isRecurring" type="checkbox" value="true" className="size-4" />
+              Recurring customer
+            </label>
+            <Button type="submit">Create customer</Button>
+          </form>
+        </article>
+
+        <article className="rounded-xl border border-neutral-200 p-6">
+          <h2 className="text-xl font-medium">Create Commission</h2>
+          <form action={createCommissionAction} className="mt-4 space-y-3">
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Title</span>
+              <input
+                name="title"
+                required
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Description</span>
+              <textarea
+                name="description"
+                rows={3}
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <div className="grid gap-3 md:grid-cols-2">
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Status</span>
+                <select
+                  name="status"
+                  defaultValue="new"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                >
+                  {commissionKanbanOrder.map((status) => (
+                    <option key={status} value={status}>
+                      {status}
+                    </option>
+                  ))}
+                </select>
+              </label>
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Customer</span>
+                <select
+                  name="customerId"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                >
+                  <option value="">(none)</option>
+                  {customers.map((customer) => (
+                    <option key={customer.id} value={customer.id}>
+                      {customer.name}
+                    </option>
+                  ))}
+                </select>
+              </label>
+            </div>
+            <div className="grid gap-3 md:grid-cols-3">
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Assigned user id</span>
+                <input
+                  name="assignedUserId"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                />
+              </label>
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Budget min</span>
+                <input
+                  name="budgetMin"
+                  type="number"
+                  min={0}
+                  step="0.01"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                />
+              </label>
+              <label className="space-y-1">
+                <span className="text-xs text-neutral-600">Budget max</span>
+                <input
+                  name="budgetMax"
+                  type="number"
+                  min={0}
+                  step="0.01"
+                  className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+                />
+              </label>
+            </div>
+            <label className="space-y-1">
+              <span className="text-xs text-neutral-600">Due date</span>
+              <input
+                name="dueAt"
+                type="date"
+                className="w-full rounded border border-neutral-300 px-3 py-2 text-sm"
+              />
+            </label>
+            <Button type="submit">Create commission</Button>
+          </form>
+        </article>
+      </section>
+
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">Kanban Board</h2>
+        <div className="grid gap-3 xl:grid-cols-6">
+          {commissionKanbanOrder.map((status) => {
+            const items = commissions.filter((commission) => commission.status === status)
+
+            return (
+              <article
+                key={status}
+                className="rounded-xl border border-neutral-200 bg-neutral-50 p-3"
+              >
+                <header className="mb-3 flex items-center justify-between">
+                  <h3 className="text-sm font-semibold uppercase tracking-wide text-neutral-700">
+                    {status}
+                  </h3>
+                  <span className="text-xs text-neutral-500">{items.length}</span>
+                </header>
+
+                <div className="space-y-2">
+                  {items.length === 0 ? (
+                    <p className="text-xs text-neutral-500">No commissions</p>
+                  ) : (
+                    items.map((commission) => (
+                      <form
+                        key={commission.id}
+                        action={updateCommissionStatusAction}
+                        className="rounded border border-neutral-200 bg-white p-2"
+                      >
+                        <input type="hidden" name="id" value={commission.id} />
+                        <div className="space-y-1">
+                          <p className="text-sm font-medium">{commission.title}</p>
+                          <p className="text-xs text-neutral-600">
+                            {commission.customer?.name ?? "No customer"}
+                          </p>
+                          <p className="text-xs text-neutral-500">
+                            Due: {formatDate(commission.dueAt)}
+                          </p>
+                        </div>
+                        <div className="mt-2 flex items-center gap-2">
+                          <select
+                            name="status"
+                            defaultValue={commission.status}
+                            className="w-full rounded border border-neutral-300 px-2 py-1 text-xs"
+                          >
+                            {commissionKanbanOrder.map((value) => (
+                              <option key={value} value={value}>
+                                {value}
+                              </option>
+                            ))}
+                          </select>
+                          <button
+                            type="submit"
+                            className="rounded border border-neutral-300 px-2 py-1 text-xs"
+                          >
+                            Move
+                          </button>
+                        </div>
+                      </form>
+                    ))
+                  )}
+                </div>
+              </article>
+            )
+          })}
+        </div>
+      </section>
+
+      <section className="rounded-xl border border-neutral-200 p-6">
+        <h2 className="text-xl font-medium">Customers</h2>
+        <div className="mt-4 overflow-x-auto">
+          <table className="min-w-full text-left text-sm">
+            <thead className="text-xs uppercase tracking-wide text-neutral-500">
+              <tr>
+                <th className="py-2 pr-4">Name</th>
+                <th className="py-2 pr-4">Email</th>
+                <th className="py-2 pr-4">Phone</th>
+                <th className="py-2 pr-4">Recurring</th>
+              </tr>
+            </thead>
+            <tbody>
+              {customers.length === 0 ? (
+                <tr>
+                  <td className="py-3 text-neutral-500" colSpan={4}>
+                    No customers yet.
+                  </td>
+                </tr>
+              ) : (
+                customers.map((customer) => (
+                  <tr key={customer.id} className="border-t border-neutral-200">
+                    <td className="py-3 pr-4">{customer.name}</td>
+                    <td className="py-3 pr-4 text-neutral-600">{customer.email ?? "-"}</td>
+                    <td className="py-3 pr-4 text-neutral-600">{customer.phone ?? "-"}</td>
+                    <td className="py-3 pr-4">{customer.isRecurring ? "yes" : "no"}</td>
+                  </tr>
+                ))
+              )}
+            </tbody>
+          </table>
+        </div>
+      </section>
     </AdminShell>
   )
 }

packages/content/src/commissions.ts

@@ -0,0 +1,40 @@
+import { z } from "zod"
+
+export const commissionStatusSchema = z.enum([
+  "new",
+  "scoped",
+  "in_progress",
+  "review",
+  "done",
+  "canceled",
+])
+
+export const createCustomerInputSchema = z.object({
+  name: z.string().min(1).max(180),
+  email: z.string().email().max(320).nullable().optional(),
+  phone: z.string().max(80).nullable().optional(),
+  instagram: z.string().max(120).nullable().optional(),
+  notes: z.string().max(4000).nullable().optional(),
+  isRecurring: z.boolean().default(false),
+})
+
+export const createCommissionInputSchema = z.object({
+  title: z.string().min(1).max(180),
+  description: z.string().max(4000).nullable().optional(),
+  status: commissionStatusSchema.default("new"),
+  customerId: z.string().uuid().nullable().optional(),
+  assignedUserId: z.string().max(120).nullable().optional(),
+  budgetMin: z.number().nonnegative().nullable().optional(),
+  budgetMax: z.number().nonnegative().nullable().optional(),
+  dueAt: z.date().nullable().optional(),
+})
+
+export const updateCommissionStatusInputSchema = z.object({
+  id: z.string().uuid(),
+  status: commissionStatusSchema,
+})
+
+export type CommissionStatus = z.infer<typeof commissionStatusSchema>
+export type CreateCustomerInput = z.infer<typeof createCustomerInputSchema>
+export type CreateCommissionInput = z.infer<typeof createCommissionInputSchema>
+export type UpdateCommissionStatusInput = z.infer<typeof updateCommissionStatusInputSchema>

packages/content/src/index.ts

@@ -1,5 +1,6 @@
 import { z } from "zod"
 
+export * from "./commissions"
 export * from "./media"
 export * from "./pages-navigation"
 export * from "./rbac"

packages/db/prisma/migrations/20260212203000_commissions_customers/migration.sql

@@ -0,0 +1,52 @@
+-- CreateTable
+CREATE TABLE "Customer" (
+    "id" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "email" TEXT,
+    "phone" TEXT,
+    "instagram" TEXT,
+    "notes" TEXT,
+    "isRecurring" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Customer_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Commission" (
+    "id" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "description" TEXT,
+    "status" TEXT NOT NULL,
+    "customerId" TEXT,
+    "assignedUserId" TEXT,
+    "budgetMin" DOUBLE PRECISION,
+    "budgetMax" DOUBLE PRECISION,
+    "dueAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Commission_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "Customer_email_idx" ON "Customer"("email");
+
+-- CreateIndex
+CREATE INDEX "Customer_isRecurring_idx" ON "Customer"("isRecurring");
+
+-- CreateIndex
+CREATE INDEX "Commission_status_idx" ON "Commission"("status");
+
+-- CreateIndex
+CREATE INDEX "Commission_customerId_idx" ON "Commission"("customerId");
+
+-- CreateIndex
+CREATE INDEX "Commission_assignedUserId_idx" ON "Commission"("assignedUserId");
+
+-- AddForeignKey
+ALTER TABLE "Commission" ADD CONSTRAINT "Commission_customerId_fkey" FOREIGN KEY ("customerId") REFERENCES "Customer"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Commission" ADD CONSTRAINT "Commission_assignedUserId_fkey" FOREIGN KEY ("assignedUserId") REFERENCES "user"("id") ON DELETE SET NULL ON UPDATE CASCADE;

packages/db/prisma/schema.prisma

@@ -34,6 +34,7 @@ model User {
   isProtected   Boolean   @default(false)
   sessions      Session[]
   accounts      Account[]
+  commissions   Commission[] @relation("CommissionAssignee")
 
   @@unique([email])
   @@index([role])
@@ -302,3 +303,39 @@ model NavigationItem {
   @@index([parentId])
   @@unique([menuId, parentId, sortOrder, label])
 }
+
+model Customer {
+  id          String       @id @default(uuid())
+  name        String
+  email       String?
+  phone       String?
+  instagram   String?
+  notes       String?
+  isRecurring Boolean      @default(false)
+  createdAt   DateTime     @default(now())
+  updatedAt   DateTime     @updatedAt
+  commissions Commission[]
+
+  @@index([email])
+  @@index([isRecurring])
+}
+
+model Commission {
+  id             String    @id @default(uuid())
+  title          String
+  description    String?
+  status         String
+  customerId     String?
+  assignedUserId String?
+  budgetMin      Float?
+  budgetMax      Float?
+  dueAt          DateTime?
+  createdAt      DateTime  @default(now())
+  updatedAt      DateTime  @updatedAt
+  customer       Customer? @relation(fields: [customerId], references: [id], onDelete: SetNull)
+  assignedUser   User?     @relation("CommissionAssignee", fields: [assignedUserId], references: [id], onDelete: SetNull)
+
+  @@index([status])
+  @@index([customerId])
+  @@index([assignedUserId])
+}

packages/db/prisma/seed.ts

@@ -158,6 +158,54 @@ async function main() {
       },
     })
   }
+
+  const existingCustomer = await db.customer.findFirst({
+    where: {
+      email: "collector@example.com",
+    },
+    select: {
+      id: true,
+    },
+  })
+
+  const seededCustomer = existingCustomer
+    ? await db.customer.update({
+        where: {
+          id: existingCustomer.id,
+        },
+        data: {
+          name: "Collector One",
+          phone: "+1-555-0101",
+          isRecurring: true,
+          notes: "Interested in recurring portrait commissions.",
+        },
+      })
+    : await db.customer.create({
+        data: {
+          name: "Collector One",
+          email: "collector@example.com",
+          phone: "+1-555-0101",
+          isRecurring: true,
+          notes: "Interested in recurring portrait commissions.",
+        },
+      })
+
+  await db.commission.upsert({
+    where: {
+      id: "11111111-1111-1111-1111-111111111111",
+    },
+    update: {},
+    create: {
+      id: "11111111-1111-1111-1111-111111111111",
+      title: "Portrait Commission Baseline",
+      description: "Initial seeded commission request for MVP1 board validation.",
+      status: "new",
+      customerId: seededCustomer.id,
+      budgetMin: 400,
+      budgetMax: 900,
+      dueAt: new Date(Date.now() + 14 * 24 * 60 * 60 * 1000),
+    },
+  })
 }
 
 main()

packages/db/src/commissions.test.ts

@@ -0,0 +1,64 @@
+import { beforeEach, describe, expect, it, vi } from "vitest"
+
+const { mockDb } = vi.hoisted(() => ({
+  mockDb: {
+    customer: {
+      create: vi.fn(),
+      findMany: vi.fn(),
+    },
+    commission: {
+      create: vi.fn(),
+      findMany: vi.fn(),
+      update: vi.fn(),
+    },
+  },
+}))
+
+vi.mock("./client", () => ({
+  db: mockDb,
+}))
+
+import { createCommission, createCustomer, updateCommissionStatus } from "./commissions"
+
+describe("commissions service", () => {
+  beforeEach(() => {
+    for (const value of Object.values(mockDb)) {
+      for (const fn of Object.values(value)) {
+        if (typeof fn === "function") {
+          fn.mockReset()
+        }
+      }
+    }
+  })
+
+  it("creates customer and commission payloads", async () => {
+    mockDb.customer.create.mockResolvedValue({ id: "customer-1" })
+    mockDb.commission.create.mockResolvedValue({ id: "commission-1" })
+
+    await createCustomer({
+      name: "Ada Lovelace",
+      email: "ada@example.com",
+      isRecurring: true,
+    })
+
+    await createCommission({
+      title: "Portrait Request",
+      status: "new",
+      customerId: "550e8400-e29b-41d4-a716-446655440000",
+    })
+
+    expect(mockDb.customer.create).toHaveBeenCalledTimes(1)
+    expect(mockDb.commission.create).toHaveBeenCalledTimes(1)
+  })
+
+  it("updates commission status", async () => {
+    mockDb.commission.update.mockResolvedValue({ id: "commission-1", status: "done" })
+
+    await updateCommissionStatus({
+      id: "550e8400-e29b-41d4-a716-446655440001",
+      status: "done",
+    })
+
+    expect(mockDb.commission.update).toHaveBeenCalledTimes(1)
+  })
+})

packages/db/src/commissions.ts

@@ -0,0 +1,66 @@
+import {
+  commissionStatusSchema,
+  createCommissionInputSchema,
+  createCustomerInputSchema,
+  updateCommissionStatusInputSchema,
+} from "@cms/content"
+
+import { db } from "./client"
+
+export const commissionKanbanOrder = commissionStatusSchema.options
+
+export async function listCustomers(limit = 200) {
+  return db.customer.findMany({
+    orderBy: [{ updatedAt: "desc" }],
+    take: limit,
+  })
+}
+
+export async function createCustomer(input: unknown) {
+  const payload = createCustomerInputSchema.parse(input)
+
+  return db.customer.create({
+    data: payload,
+  })
+}
+
+export async function listCommissions(limit = 300) {
+  return db.commission.findMany({
+    orderBy: [{ updatedAt: "desc" }],
+    take: limit,
+    include: {
+      customer: {
+        select: {
+          id: true,
+          name: true,
+          email: true,
+          isRecurring: true,
+        },
+      },
+      assignedUser: {
+        select: {
+          id: true,
+          name: true,
+          username: true,
+        },
+      },
+    },
+  })
+}
+
+export async function createCommission(input: unknown) {
+  const payload = createCommissionInputSchema.parse(input)
+
+  return db.commission.create({
+    data: payload,
+  })
+}
+
+export async function updateCommissionStatus(input: unknown) {
+  const payload = updateCommissionStatusInputSchema.parse(input)
+
+  return db.commission.update({
+    where: { id: payload.id },
+    data: { status: payload.status },
+  })
+}

packages/db/src/index.ts

@@ -1,4 +1,12 @@
 export { db } from "./client"
+export {
+  commissionKanbanOrder,
+  createCommission,
+  createCustomer,
+  listCommissions,
+  listCustomers,
+  updateCommissionStatus,
+} from "./commissions"
 export {
   attachArtworkRendition,
   createAlbum,