tsk-C

compleate

src/app/api/crm/customers/[id]/contacts/[contactId]/route.ts

@@ -0,0 +1,119 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditDelete, auditUpdate } from '@/features/foundation/audit-log/service';
+import {
+  listCustomerContacts,
+  softDeleteCustomerContact,
+  updateCustomerContact
+} from '@/features/crm/customers/server/service';
+import { customerContactSchema } from '@/features/crm/customers/schemas/customer.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string; contactId: string }>;
+};
+
+export async function PATCH(request: NextRequest, { params }: Params) {
+  try {
+    const { id, contactId } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmContactUpdate
+    });
+    const payload = customerContactSchema.parse(await request.json());
+    const before = (await listCustomerContacts(id, organization.id)).find(
+      (contact) => contact.id === contactId
+    );
+
+    if (!before) {
+      return NextResponse.json({ message: 'Contact not found' }, { status: 404 });
+    }
+
+    const updated = await updateCustomerContact(
+      id,
+      contactId,
+      organization.id,
+      session.user.id,
+      payload
+    );
+
+    await auditUpdate({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_customer_contact',
+      entityId: contactId,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Contact updated successfully',
+      contact: updated
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { message: error.issues[0]?.message ?? 'Invalid payload' },
+        { status: 400 }
+      );
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to update contact' }, { status: 500 });
+  }
+}
+
+export async function DELETE(_request: NextRequest, { params }: Params) {
+  try {
+    const { id, contactId } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmContactDelete
+    });
+    const before = (await listCustomerContacts(id, organization.id)).find(
+      (contact) => contact.id === contactId
+    );
+
+    if (!before) {
+      return NextResponse.json({ message: 'Contact not found' }, { status: 404 });
+    }
+
+    const updated = await softDeleteCustomerContact(
+      id,
+      contactId,
+      organization.id,
+      session.user.id
+    );
+
+    await auditDelete({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_customer_contact',
+      entityId: contactId,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Contact deleted successfully'
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to delete contact' }, { status: 500 });
+  }
+}

src/app/api/crm/customers/[id]/contacts/route.ts

@@ -0,0 +1,86 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditCreate } from '@/features/foundation/audit-log/service';
+import {
+  createCustomerContact,
+  listCustomerContacts
+} from '@/features/crm/customers/server/service';
+import { customerContactSchema } from '@/features/crm/customers/schemas/customer.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string }>;
+};
+
+export async function GET(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmContactRead
+    });
+    const items = await listCustomerContacts(id, organization.id);
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Customer contacts loaded successfully',
+      items
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to load contacts' }, { status: 500 });
+  }
+}
+
+export async function POST(request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmContactCreate
+    });
+    const payload = customerContactSchema.parse(await request.json());
+    const created = await createCustomerContact(id, organization.id, session.user.id, payload);
+
+    await auditCreate({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_customer_contact',
+      entityId: created.id,
+      afterData: created
+    });
+
+    return NextResponse.json(
+      {
+        success: true,
+        message: 'Contact created successfully',
+        contact: created
+      },
+      { status: 201 }
+    );
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { message: error.issues[0]?.message ?? 'Invalid payload' },
+        { status: 400 }
+      );
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to create contact' }, { status: 500 });
+  }
+}

src/app/api/crm/customers/[id]/route.ts

@@ -0,0 +1,134 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditDelete, auditUpdate } from '@/features/foundation/audit-log/service';
+import {
+  getCustomerActivity,
+  getCustomerDetail,
+  softDeleteCustomer,
+  updateCustomer
+} from '@/features/crm/customers/server/service';
+import { customerSchema } from '@/features/crm/customers/schemas/customer.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string }>;
+};
+
+const customerRequestSchema = customerSchema.extend({
+  branchId: z.string().nullable().optional(),
+  leadChannel: z.string().nullable().optional(),
+  customerGroup: z.string().nullable().optional()
+});
+
+export async function GET(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmCustomerRead
+    });
+    const [customer, activity] = await Promise.all([
+      getCustomerDetail(id, organization.id),
+      getCustomerActivity(id, organization.id)
+    ]);
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Customer loaded successfully',
+      customer,
+      activity
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to load customer' }, { status: 500 });
+  }
+}
+
+export async function PATCH(request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmCustomerUpdate
+    });
+    const payload = customerRequestSchema.parse(await request.json());
+    const before = await getCustomerDetail(id, organization.id);
+    const updated = await updateCustomer(id, organization.id, session.user.id, payload);
+
+    await auditUpdate({
+      organizationId: organization.id,
+      branchId: updated.branchId,
+      userId: session.user.id,
+      entityType: 'crm_customer',
+      entityId: id,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Customer updated successfully',
+      customer: updated
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { message: error.issues[0]?.message ?? 'Invalid payload' },
+        { status: 400 }
+      );
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to update customer' }, { status: 500 });
+  }
+}
+
+export async function DELETE(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmCustomerDelete
+    });
+    const before = await getCustomerDetail(id, organization.id);
+    const updated = await softDeleteCustomer(id, organization.id, session.user.id);
+
+    await auditDelete({
+      organizationId: organization.id,
+      branchId: updated.branchId,
+      userId: session.user.id,
+      entityType: 'crm_customer',
+      entityId: id,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Customer deleted successfully'
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to delete customer' }, { status: 500 });
+  }
+}

src/app/api/crm/customers/route.ts

@@ -0,0 +1,104 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditCreate } from '@/features/foundation/audit-log/service';
+import { createCustomer, listCustomers } from '@/features/crm/customers/server/service';
+import { customerSchema } from '@/features/crm/customers/schemas/customer.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+const customerRequestSchema = customerSchema.extend({
+  branchId: z.string().nullable().optional(),
+  leadChannel: z.string().nullable().optional(),
+  customerGroup: z.string().nullable().optional()
+});
+
+export async function GET(request: NextRequest) {
+  try {
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmCustomerRead
+    });
+    const { searchParams } = request.nextUrl;
+    const page = Number(searchParams.get('page') ?? 1);
+    const limit = Number(searchParams.get('limit') ?? 10);
+    const search = searchParams.get('search') ?? undefined;
+    const customerStatus = searchParams.get('customerStatus') ?? undefined;
+    const customerType = searchParams.get('customerType') ?? undefined;
+    const branch = searchParams.get('branch') ?? undefined;
+    const sort = searchParams.get('sort') ?? undefined;
+    const result = await listCustomers(organization.id, {
+      page,
+      limit,
+      search,
+      customerStatus,
+      customerType,
+      branch,
+      sort
+    });
+    const offset = (page - 1) * limit;
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Customers loaded successfully',
+      totalItems: result.totalItems,
+      offset,
+      limit,
+      items: result.items
+    });
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to load customers' }, { status: 500 });
+  }
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmCustomerCreate
+    });
+    const payload = customerRequestSchema.parse(await request.json());
+    const created = await createCustomer(organization.id, session.user.id, payload);
+
+    await auditCreate({
+      organizationId: organization.id,
+      branchId: created.branchId,
+      userId: session.user.id,
+      entityType: 'crm_customer',
+      entityId: created.id,
+      afterData: created
+    });
+
+    return NextResponse.json(
+      {
+        success: true,
+        message: 'Customer created successfully',
+        customer: created
+      },
+      { status: 201 }
+    );
+  } catch (error) {
+    if (error instanceof AuthError) {
+      return NextResponse.json({ message: error.message }, { status: error.status });
+    }
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { message: error.issues[0]?.message ?? 'Invalid payload' },
+        { status: 400 }
+      );
+    }
+
+    if (error instanceof Error) {
+      return NextResponse.json({ message: error.message }, { status: 400 });
+    }
+
+    return NextResponse.json({ message: 'Unable to create customer' }, { status: 500 });
+  }
+}

src/app/dashboard/crm/customers/[id]/page.tsx

@@ -1,5 +1,11 @@
+import { auth } from '@/auth';
+import { HydrationBoundary, dehydrate } from '@tanstack/react-query';
 import PageContainer from '@/components/layout/page-container';
-import { CrmProductionPlaceholder } from '@/features/foundation/components/crm-production-placeholder';
+import { CustomerDetail } from '@/features/crm/customers/components/customer-detail';
+import { customerByIdOptions, customerContactsOptions } from '@/features/crm/customers/api/queries';
+import { getCustomerReferenceData } from '@/features/crm/customers/server/service';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { getQueryClient } from '@/lib/query-client';
 
 type PageProps = {
   params: Promise<{ id: string }>;
@@ -7,24 +13,69 @@ type PageProps = {
 
 export default async function CustomerDetailRoute({ params }: PageProps) {
   const { id } = await params;
+  const session = await auth();
+  const canRead =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerRead)));
+  const canUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerUpdate)));
+  const canContactCreate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmContactCreate)));
+  const canContactUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmContactUpdate)));
+  const canContactDelete =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmContactDelete)));
+  const queryClient = getQueryClient();
+
+  if (canRead) {
+    void queryClient.prefetchQuery(customerByIdOptions(id));
+    void queryClient.prefetchQuery(customerContactsOptions(id));
+  }
+
+  const referenceData =
+    canRead && session?.user?.activeOrganizationId
+      ? await getCustomerReferenceData(session.user.activeOrganizationId)
+      : null;
 
   return (
     <PageContainer
       pageTitle='Customer Detail'
-      pageDescription={`Production detail route placeholder for customer ${id}.`}
+      pageDescription='Customer profile, contacts, audit timeline, and future CRM document handoff.'
+      access={canRead}
+      accessFallback={
+        <div className='text-muted-foreground rounded-lg border border-dashed p-8 text-center'>
+          You do not have access to this customer record.
+        </div>
+      }
     >
-      <CrmProductionPlaceholder
-        title='Customer detail pending'
-        summary='This detail route is intentionally isolated from legacy demo state until the production Customer module is implemented.'
-        foundationItems={[
-          'Current organization context',
-          'Permission checks',
-          'Branch validation abstraction',
-          'Audit log helper'
-        ]}
-        nextStep='Implement customer detail using real customer, contact, enquiry, and audit data from production APIs.'
-        demoHref={`/dashboard/crm-demo/customers/${id}`}
-      />
+      {referenceData ? (
+        <HydrationBoundary state={dehydrate(queryClient)}>
+          <CustomerDetail
+            customerId={id}
+            referenceData={referenceData}
+            canUpdate={canUpdate}
+            canManageContacts={{
+              create: canContactCreate,
+              update: canContactUpdate,
+              delete: canContactDelete
+            }}
+          />
+        </HydrationBoundary>
+      ) : null}
     </PageContainer>
   );
 }

src/app/dashboard/crm/customers/page.tsx

@@ -1,29 +1,74 @@
+import { auth } from '@/auth';
 import PageContainer from '@/components/layout/page-container';
-import { CrmProductionPlaceholder } from '@/features/foundation/components/crm-production-placeholder';
+import CustomerListing from '@/features/crm/customers/components/customer-listing';
+import { CustomerFormSheetTrigger } from '@/features/crm/customers/components/customer-form-sheet';
+import { getCustomerReferenceData } from '@/features/crm/customers/server/service';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { searchParamsCache } from '@/lib/searchparams';
+import type { SearchParams } from 'nuqs/server';
 
 export const metadata = {
   title: 'Dashboard: CRM Customers'
 };
 
-export default function CustomersRoute() {
+type PageProps = {
+  searchParams: Promise<SearchParams>;
+};
+
+export default async function CustomersRoute(props: PageProps) {
+  const searchParams = await props.searchParams;
+  const session = await auth();
+  const canRead =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerRead)));
+  const canCreate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerCreate)));
+  const canUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerUpdate)));
+  const canDelete =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmCustomerDelete)));
+
+  searchParamsCache.parse(searchParams);
+
+  const referenceData =
+    canRead && session?.user?.activeOrganizationId
+      ? await getCustomerReferenceData(session.user.activeOrganizationId)
+      : null;
+
   return (
     <PageContainer
       pageTitle='Customers'
-      pageDescription='Production customer CRUD has not started yet. This route is reserved for the Task C implementation path.'
+      pageDescription='Production customer registry with organization scoping, branch filters, contact management, and audit-backed history.'
+      access={canRead}
+      accessFallback={
+        <div className='text-muted-foreground rounded-lg border border-dashed p-8 text-center'>
+          You do not have access to CRM customer records.
+        </div>
+      }
+      pageHeaderAction={
+        canCreate && referenceData ? (
+          <CustomerFormSheetTrigger referenceData={referenceData} />
+        ) : null
+      }
     >
-      <CrmProductionPlaceholder
-        title='Customer module pending'
-        summary='The old customer list and form flow has been moved to the demo path so this route no longer depends on mock services.'
-        foundationItems={[
-          'Organization-first access boundary',
-          'Customer status options from master options',
-          'Branch scope abstraction for customer ownership',
-          'Document code generation for customer records',
-          'Audit hooks for future mutations'
-        ]}
-        nextStep='Implement Customer list, detail, and create/edit flows with real route handlers and persistence.'
-        demoHref='/dashboard/crm-demo/customers'
-      />
+      {referenceData ? (
+        <CustomerListing
+          referenceData={referenceData}
+          canUpdate={canUpdate}
+          canDelete={canDelete}
+        />
+      ) : null}
     </PageContainer>
   );
 }