Service Layer Adoption — Completed 2026-05-07

Overview

All API routes and Next.js API routes now delegate data access to service classes. The migration is complete. This document is kept for historical reference.

Pattern

Services (apps/api/src/services/, apps/dashboard/src/services/, apps/manage/src/services/):

• Import db directly: import { db } from "../db" (API) or import { db } from "@/lib/db" (Next.js apps)
• Export plain async functions containing all Prisma queries and business logic

Routes / handlers:

• Import service functions only — no import { db }
• Responsible for: auth checks, request/response mapping, writeAuditLog, queue enqueue calls

Exception: apps/api/src/routers/auth.ts and apps/api/src/routers/tenant/credits.ts retain import { db } because @leadmetrics/billing external functions (getOrCreateCreditBalance, createTopupOrder, applyTopupPayment) require db passed as a parameter. Those signatures cannot be changed.

Coverage

Fastify API (apps/api/src/routers/) — 88 routers, all clean

Service files under apps/api/src/services/:

Dashboard Next.js (apps/dashboard/src/app/api/) — 26 routes, all clean

Service files under apps/dashboard/src/services/:

• activities.service.ts — activities/*, calendar/
• calendar.service.ts — calendar/
• leads.service.ts — leads/*
• backlinks.service.ts — backlinks/*
• notifications.service.ts — notifications/*
• stats.service.ts — dashboard/stats
• agent-progress.service.ts — internal/agent-progress
• reports.service.ts — reports/generate
• search.service.ts — search/
• socket-token.service.ts — socket-token/
• media.service.ts — tenant/media/*

Manage Next.js (apps/manage/src/app/api/) — 2 routes, all clean

Service files under apps/manage/src/services/:

• billing.service.ts — admin/billing/*

DM Next.js (apps/dm/src/app/api/) — Clean (delegates to Fastify API)

Known Quirks

• auth.ts and tenant/credits.ts import db only to satisfy @leadmetrics/billing function signatures — this is intentional and not a violation.
• tenants.service.ts was previously unused; it is now wired into admin/tenants.ts alongside admin-tenants.service.ts.