feat: add tracking link schemas for creation, update, and querying

app/components/AppTopBar.vue

@@ -126,7 +126,7 @@
   { label: 'Applications', to: '/dashboard/applications', icon: FileText, exact: false },
   { label: 'Interviews', to: '/dashboard/interviews', icon: Calendar, exact: false },
   { label: 'Timeline', to: '/dashboard/timeline', icon: History, exact: true },
-  { label: 'Source Tracking', to: '/dashboard/source-tracking', icon: Radio, exact: true, comingSoon: true },
+  { label: 'Source Tracking', to: '/dashboard/source-tracking', icon: Radio, exact: true },
   { label: 'AI Analysis', to: '/dashboard/ai-analysis', icon: Sparkles, exact: true },
   { label: 'Settings', to: '/dashboard/settings', icon: Settings, exact: false },
 ]
@@ -191,7 +191,7 @@
               <component :is="item.icon" class="size-4" />
               {{ item.label }}
               <span
                 v-if="item.comingSoon"
                 class="ml-0.5 inline-flex items-center rounded-full bg-amber-50 dark:bg-amber-950/40 px-1.5 py-0.5 text-[9px] font-semibold leading-none text-amber-700 dark:text-amber-400 ring-1 ring-inset ring-amber-200/60 dark:ring-amber-800/40"
               >
                 Soon
@@ -364,7 +364,7 @@
                     <component :is="item.icon" class="size-4" />
                     {{ item.label }}
                     <span
                       v-if="item.comingSoon"
                       class="ml-auto inline-flex items-center rounded-full bg-amber-50 dark:bg-amber-950/40 px-1.5 py-0.5 text-[9px] font-semibold leading-none text-amber-700 dark:text-amber-400 ring-1 ring-inset ring-amber-200/60 dark:ring-amber-800/40"
                     >
                       Soon
@@ -487,7 +487,7 @@
             <component :is="item.icon" class="size-4" />
             {{ item.label }}
             <span
               v-if="item.comingSoon"
               class="ml-auto inline-flex items-center rounded-full bg-amber-50 dark:bg-amber-950/40 px-1.5 py-0.5 text-[9px] font-semibold leading-none text-amber-700 dark:text-amber-400 ring-1 ring-inset ring-amber-200/60 dark:ring-amber-800/40"
             >
               Soon

app/composables/useSourceTracking.ts

@@ -0,0 +1,200 @@
+/**
+ * Composable for source tracking analytics and tracking link management.
+ * Provides data for the source tracking dashboard and link CRUD operations.
+ */
+
+interface TrackingLink {
+  id: string
+  jobId: string | null
+  jobTitle: string | null
+  channel: string
+  name: string
+  code: string
+  utmSource: string | null
+  utmMedium: string | null
+  utmCampaign: string | null
+  utmTerm: string | null
+  utmContent: string | null
+  clickCount: number
+  applicationCount: number
+  isActive: boolean
+  createdAt: string
+  updatedAt: string
+}
+
+interface SourceStats {
+  channelBreakdown: { channel: string; count: number }[]
+  topLinks: {
+    id: string
+    name: string
+    channel: string
+    code: string
+    jobTitle: string | null
+    clickCount: number
+    applicationCount: number
+    isActive: boolean
+  }[]
+  funnel: Record<string, Record<string, number>>
+  dailyTrend: { date: string; channel: string; count: number }[]
+  recentAttributed: {
+    applicationId: string
+    channel: string
+    utmSource: string | null
+    utmCampaign: string | null
+    referrerDomain: string | null
+    trackingLinkName: string | null
+    candidateFirstName: string
+    candidateLastName: string
+    candidateEmail: string
+    jobTitle: string
+    status: string
+    appliedAt: string
+  }[]
+  topReferrerDomains: { domain: string | null; count: number }[]
+  summary: {
+    totalTracked: number
+    totalUntracked: number
+    attributionRate: number
+  }
+}
+
+export function useSourceTracking(options?: {
+  jobId?: Ref<string | undefined> | string
+  from?: Ref<string | undefined> | string
+  to?: Ref<string | undefined> | string
+}) {
+  const jobId = computed(() => toValue(options?.jobId))
+  const from = computed(() => toValue(options?.from))
+  const to = computed(() => toValue(options?.to))
+
+  // ─── Source stats ─────────────────────────
+  const {
+    data: stats,
+    status: statsStatus,
+    error: statsError,
+    refresh: refreshStats,
+  } = useFetch<SourceStats>('/api/source-tracking/stats', {
+    key: 'source-stats',
+    headers: useRequestHeaders(['cookie']),
+    query: computed(() => {
+      const q: Record<string, string> = {}
+      if (jobId.value) q.jobId = jobId.value
+      if (from.value) q.from = from.value
+      if (to.value) q.to = to.value
+      return q
+    }),
+  })
+
+  const channelBreakdown = computed(() => stats.value?.channelBreakdown ?? [])
+  const topLinks = computed(() => stats.value?.topLinks ?? [])
+  const funnel = computed(() => stats.value?.funnel ?? {})
+  const dailyTrend = computed(() => stats.value?.dailyTrend ?? [])
+  const recentAttributed = computed(() => stats.value?.recentAttributed ?? [])
+  const topReferrerDomains = computed(() => stats.value?.topReferrerDomains ?? [])
+  const summary = computed(() => stats.value?.summary ?? { totalTracked: 0, totalUntracked: 0, attributionRate: 0 })
+
+  return {
+    channelBreakdown,
+    topLinks,
+    funnel,
+    dailyTrend,
+    recentAttributed,
+    topReferrerDomains,
+    summary,
+    statsStatus,
+    statsError,
+    refreshStats,
+  }
+}
+
+/**
+ * Composable for managing tracking links (CRUD operations).
+ */
+export function useTrackingLinks(options?: {
+  jobId?: Ref<string | undefined> | string
+  channel?: Ref<string | undefined> | string
+}) {
+  const toast = useToast()
+
+  const jobId = computed(() => toValue(options?.jobId))
+  const channel = computed(() => toValue(options?.channel))
+
+  const {
+    data,
+    status: fetchStatus,
+    error,
+    refresh,
+  } = useFetch<{ data: TrackingLink[]; total: number }>('/api/tracking-links', {
+    key: 'tracking-links',
+    headers: useRequestHeaders(['cookie']),
+    query: computed(() => {
+      const q: Record<string, string> = {}
+      if (jobId.value) q.jobId = jobId.value
+      if (channel.value) q.channel = channel.value
+      return q
+    }),
+  })
+
+  const links = computed<TrackingLink[]>(() => data.value?.data ?? [])
+  const total = computed(() => data.value?.total ?? 0)
+
+  async function createLink(payload: {
+    jobId?: string
+    channel?: string
+    name: string
+    utmSource?: string
+    utmMedium?: string
+    utmCampaign?: string
+    utmTerm?: string
+    utmContent?: string
+  }) {
+    const created = await $fetch('/api/tracking-links', {
+      method: 'POST',
+      body: payload,
+    })
+    await refresh()
+    toast.success('Tracking link created')
+    return created
+  }
+
+  async function updateLink(id: string, payload: {
+    name?: string
+    channel?: string
+    utmSource?: string
+    utmMedium?: string
+    utmCampaign?: string
+    utmTerm?: string
+    utmContent?: string
+    isActive?: boolean
+  }) {
+    const updated = await $fetch(`/api/tracking-links/${id}`, {
+      method: 'PATCH',
+      body: payload,
+    })
+    await refresh()
+    return updated
+  }
+
+  async function deleteLink(id: string) {
+    await $fetch(`/api/tracking-links/${id}`, { method: 'DELETE' })
+    await refresh()
+    toast.success('Tracking link deleted')
+  }
+
+  async function toggleLink(id: string, isActive: boolean) {
+    await updateLink(id, { isActive })
+    toast.success(isActive ? 'Link activated' : 'Link deactivated')
+  }
+
+  return {
+    links,
+    total,
+    fetchStatus,
+    error,
+    refresh,
+    createLink,
+    updateLink,
+    deleteLink,
+    toggleLink,
+  }
+}

app/pages/dashboard/index.vue

@@ -41,12 +41,15 @@ const {
 // ─────────────────────────────────────────────
 
 const now = new Date()
-const weekFromNow = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000)
+// Truncate to start-of-day so the useFetch key is identical on server & client
+// (prevents SSR/hydration mismatch from sub-second timestamp drift)
+const today = new Date(now.getFullYear(), now.getMonth(), now.getDate())
+const weekFromToday = new Date(today.getTime() + 7 * 24 * 60 * 60 * 1000)
 
 const { interviews: upcomingInterviews } = useInterviews({
   status: 'scheduled',
-  from: now.toISOString(),
-  to: weekFromNow.toISOString(),
+  from: today.toISOString(),
+  to: weekFromToday.toISOString(),
   limit: 5,
 })