task-d complate

src/app/api/crm/enquiries/[id]/followups/[followupId]/route.ts

@@ -0,0 +1,124 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditDelete, auditUpdate } from '@/features/foundation/audit-log/service';
+import {
+  listEnquiryFollowups,
+  softDeleteEnquiryFollowup,
+  updateEnquiryFollowup
+} from '@/features/crm/enquiries/server/service';
+import { enquiryFollowupSchema } from '@/features/crm/enquiries/schemas/enquiry.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string; followupId: string }>;
+};
+
+const followupRequestSchema = enquiryFollowupSchema.extend({
+  contactId: z.string().nullable().optional(),
+  nextFollowupDate: z.string().nullable().optional()
+});
+
+export async function PATCH(request: NextRequest, { params }: Params) {
+  try {
+    const { id, followupId } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryFollowupUpdate
+    });
+    const payload = followupRequestSchema.parse(await request.json());
+    const before = (await listEnquiryFollowups(id, organization.id)).find(
+      (item) => item.id === followupId
+    );
+
+    if (!before) {
+      return NextResponse.json({ message: 'Follow-up not found' }, { status: 404 });
+    }
+
+    const updated = await updateEnquiryFollowup(
+      id,
+      followupId,
+      organization.id,
+      session.user.id,
+      payload
+    );
+
+    await auditUpdate({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_enquiry_followup',
+      entityId: followupId,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Enquiry follow-up updated successfully',
+      followup: 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 enquiry follow-up' }, { status: 500 });
+  }
+}
+
+export async function DELETE(_request: NextRequest, { params }: Params) {
+  try {
+    const { id, followupId } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryFollowupDelete
+    });
+    const before = (await listEnquiryFollowups(id, organization.id)).find(
+      (item) => item.id === followupId
+    );
+
+    if (!before) {
+      return NextResponse.json({ message: 'Follow-up not found' }, { status: 404 });
+    }
+
+    const updated = await softDeleteEnquiryFollowup(
+      id,
+      followupId,
+      organization.id,
+      session.user.id
+    );
+
+    await auditDelete({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_enquiry_followup',
+      entityId: followupId,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Enquiry follow-up 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 enquiry follow-up' }, { status: 500 });
+  }
+}

src/app/api/crm/enquiries/[id]/followups/route.ts

@@ -0,0 +1,91 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditCreate } from '@/features/foundation/audit-log/service';
+import {
+  createEnquiryFollowup,
+  listEnquiryFollowups
+} from '@/features/crm/enquiries/server/service';
+import { enquiryFollowupSchema } from '@/features/crm/enquiries/schemas/enquiry.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string }>;
+};
+
+const followupRequestSchema = enquiryFollowupSchema.extend({
+  contactId: z.string().nullable().optional(),
+  nextFollowupDate: z.string().nullable().optional()
+});
+
+export async function GET(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryFollowupRead
+    });
+    const items = await listEnquiryFollowups(id, organization.id);
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Enquiry follow-ups 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 enquiry follow-ups' }, { status: 500 });
+  }
+}
+
+export async function POST(request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryFollowupCreate
+    });
+    const payload = followupRequestSchema.parse(await request.json());
+    const created = await createEnquiryFollowup(id, organization.id, session.user.id, payload);
+
+    await auditCreate({
+      organizationId: organization.id,
+      userId: session.user.id,
+      entityType: 'crm_enquiry_followup',
+      entityId: created.id,
+      afterData: created
+    });
+
+    return NextResponse.json(
+      {
+        success: true,
+        message: 'Enquiry follow-up created successfully',
+        followup: 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 enquiry follow-up' }, { status: 500 });
+  }
+}

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

@@ -0,0 +1,137 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditDelete, auditUpdate } from '@/features/foundation/audit-log/service';
+import {
+  getEnquiryActivity,
+  getEnquiryDetail,
+  softDeleteEnquiry,
+  updateEnquiry
+} from '@/features/crm/enquiries/server/service';
+import { enquirySchema } from '@/features/crm/enquiries/schemas/enquiry.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+type Params = {
+  params: Promise<{ id: string }>;
+};
+
+const enquiryRequestSchema = enquirySchema.extend({
+  contactId: z.string().nullable().optional(),
+  branchId: z.string().nullable().optional(),
+  leadChannel: z.string().nullable().optional(),
+  estimatedValue: z.number().nullable().optional(),
+  chancePercent: z.number().nullable().optional(),
+  expectedCloseDate: z.string().nullable().optional()
+});
+
+export async function GET(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryRead
+    });
+    const [enquiry, activity] = await Promise.all([
+      getEnquiryDetail(id, organization.id),
+      getEnquiryActivity(id, organization.id)
+    ]);
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Enquiry loaded successfully',
+      enquiry,
+      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 enquiry' }, { status: 500 });
+  }
+}
+
+export async function PATCH(request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryUpdate
+    });
+    const payload = enquiryRequestSchema.parse(await request.json());
+    const before = await getEnquiryDetail(id, organization.id);
+    const updated = await updateEnquiry(id, organization.id, session.user.id, payload);
+
+    await auditUpdate({
+      organizationId: organization.id,
+      branchId: updated.branchId,
+      userId: session.user.id,
+      entityType: 'crm_enquiry',
+      entityId: id,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Enquiry updated successfully',
+      enquiry: 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 enquiry' }, { status: 500 });
+  }
+}
+
+export async function DELETE(_request: NextRequest, { params }: Params) {
+  try {
+    const { id } = await params;
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryDelete
+    });
+    const before = await getEnquiryDetail(id, organization.id);
+    const updated = await softDeleteEnquiry(id, organization.id, session.user.id);
+
+    await auditDelete({
+      organizationId: organization.id,
+      branchId: updated.branchId,
+      userId: session.user.id,
+      entityType: 'crm_enquiry',
+      entityId: id,
+      beforeData: before,
+      afterData: updated
+    });
+
+    return NextResponse.json({
+      success: true,
+      message: 'Enquiry 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 enquiry' }, { status: 500 });
+  }
+}

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

@@ -0,0 +1,111 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+import { auditCreate } from '@/features/foundation/audit-log/service';
+import { createEnquiry, listEnquiries } from '@/features/crm/enquiries/server/service';
+import { enquirySchema } from '@/features/crm/enquiries/schemas/enquiry.schema';
+import { PERMISSIONS } from '@/lib/auth/rbac';
+import { AuthError, requireOrganizationAccess } from '@/lib/auth/session';
+
+const enquiryRequestSchema = enquirySchema.extend({
+  contactId: z.string().nullable().optional(),
+  branchId: z.string().nullable().optional(),
+  leadChannel: z.string().nullable().optional(),
+  estimatedValue: z.number().nullable().optional(),
+  chancePercent: z.number().nullable().optional(),
+  expectedCloseDate: z.string().nullable().optional()
+});
+
+export async function GET(request: NextRequest) {
+  try {
+    const { organization } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryRead
+    });
+    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 status = searchParams.get('status') ?? undefined;
+    const productType = searchParams.get('productType') ?? undefined;
+    const priority = searchParams.get('priority') ?? undefined;
+    const branch = searchParams.get('branch') ?? undefined;
+    const customer = searchParams.get('customer') ?? undefined;
+    const sort = searchParams.get('sort') ?? undefined;
+    const result = await listEnquiries(organization.id, {
+      page,
+      limit,
+      search,
+      status,
+      productType,
+      priority,
+      branch,
+      customer,
+      sort
+    });
+    const offset = (page - 1) * limit;
+
+    return NextResponse.json({
+      success: true,
+      time: new Date().toISOString(),
+      message: 'Enquiries 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 enquiries' }, { status: 500 });
+  }
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const { organization, session } = await requireOrganizationAccess({
+      permission: PERMISSIONS.crmEnquiryCreate
+    });
+    const payload = enquiryRequestSchema.parse(await request.json());
+    const created = await createEnquiry(organization.id, session.user.id, payload);
+
+    await auditCreate({
+      organizationId: organization.id,
+      branchId: created.branchId,
+      userId: session.user.id,
+      entityType: 'crm_enquiry',
+      entityId: created.id,
+      afterData: created
+    });
+
+    return NextResponse.json(
+      {
+        success: true,
+        message: 'Enquiry created successfully',
+        enquiry: 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 enquiry' }, { status: 500 });
+  }
+}

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

@@ -4,6 +4,7 @@ import PageContainer from '@/components/layout/page-container';
 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 { listCustomerEnquiryRelations } from '@/features/crm/enquiries/server/service';
 import { PERMISSIONS } from '@/lib/auth/rbac';
 import { getQueryClient } from '@/lib/query-client';
 
@@ -50,6 +51,10 @@ export default async function CustomerDetailRoute({ params }: PageProps) {
     canRead && session?.user?.activeOrganizationId
       ? await getCustomerReferenceData(session.user.activeOrganizationId)
       : null;
+  const relatedEnquiries =
+    canRead && session?.user?.activeOrganizationId
+      ? await listCustomerEnquiryRelations(id, session.user.activeOrganizationId)
+      : [];
 
   return (
     <PageContainer
@@ -73,6 +78,7 @@ export default async function CustomerDetailRoute({ params }: PageProps) {
               update: canContactUpdate,
               delete: canContactDelete
             }}
+            relatedEnquiries={relatedEnquiries}
           />
         </HydrationBoundary>
       ) : null}

src/app/dashboard/crm/enquiries/[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 { enquiryByIdOptions, enquiryFollowupsOptions } from '@/features/crm/enquiries/api/queries';
+import { EnquiryDetail } from '@/features/crm/enquiries/components/enquiry-detail';
+import { getEnquiryReferenceData } from '@/features/crm/enquiries/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 EnquiryDetailRoute({ 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.crmEnquiryRead)));
+  const canUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryUpdate)));
+  const canFollowupCreate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryFollowupCreate)));
+  const canFollowupUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryFollowupUpdate)));
+  const canFollowupDelete =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryFollowupDelete)));
+  const queryClient = getQueryClient();
+
+  if (canRead) {
+    void queryClient.prefetchQuery(enquiryByIdOptions(id));
+    void queryClient.prefetchQuery(enquiryFollowupsOptions(id));
+  }
+
+  const referenceData =
+    canRead && session?.user?.activeOrganizationId
+      ? await getEnquiryReferenceData(session.user.activeOrganizationId)
+      : null;
 
   return (
     <PageContainer
       pageTitle='Enquiry Detail'
-      pageDescription={`Production detail route placeholder for enquiry ${id}.`}
+      pageDescription='Opportunity context, follow-up timeline, and future quotation 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 enquiry.
+        </div>
+      }
     >
-      <CrmProductionPlaceholder
-        title='Enquiry detail pending'
-        summary='This route is reserved for the production enquiry detail page and no longer imports the demo in-memory service.'
-        foundationItems={[
-          'Organization context',
-          'Branch validation',
-          'Master option lookups',
-          'Audit logging'
-        ]}
-        nextStep='Implement enquiry detail on top of persisted enquiry, activity, and relationship data.'
-        demoHref={`/dashboard/crm-demo/enquiries/${id}`}
-      />
+      {referenceData ? (
+        <HydrationBoundary state={dehydrate(queryClient)}>
+          <EnquiryDetail
+            enquiryId={id}
+            referenceData={referenceData}
+            canUpdate={canUpdate}
+            canManageFollowups={{
+              create: canFollowupCreate,
+              update: canFollowupUpdate,
+              delete: canFollowupDelete
+            }}
+          />
+        </HydrationBoundary>
+      ) : null}
     </PageContainer>
   );
 }

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

@@ -1,29 +1,70 @@
+import { auth } from '@/auth';
 import PageContainer from '@/components/layout/page-container';
-import { CrmProductionPlaceholder } from '@/features/foundation/components/crm-production-placeholder';
+import EnquiryListing from '@/features/crm/enquiries/components/enquiry-listing';
+import { EnquiryFormSheetTrigger } from '@/features/crm/enquiries/components/enquiry-form-sheet';
+import { getEnquiryReferenceData } from '@/features/crm/enquiries/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 Enquiries'
 };
 
-export default function EnquiriesRoute() {
+type PageProps = {
+  searchParams: Promise<SearchParams>;
+};
+
+export default async function EnquiriesRoute(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.crmEnquiryRead)));
+  const canCreate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryCreate)));
+  const canUpdate =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryUpdate)));
+  const canDelete =
+    session?.user?.systemRole === 'super_admin' ||
+    (!!session?.user?.activeOrganizationId &&
+      (session.user.activeMembershipRole === 'admin' ||
+        session.user.activePermissions.includes(PERMISSIONS.crmEnquiryDelete)));
+
+  searchParamsCache.parse(searchParams);
+
+  const referenceData =
+    canRead && session?.user?.activeOrganizationId
+      ? await getEnquiryReferenceData(session.user.activeOrganizationId)
+      : null;
+
   return (
     <PageContainer
       pageTitle='Enquiries'
-      pageDescription='Production enquiry flows are intentionally blocked from mock services until the real module is built.'
+      pageDescription='Production opportunity registry with customer linkage, follow-up workflow, and audit-backed activity.'
+      access={canRead}
+      accessFallback={
+        <div className='text-muted-foreground rounded-lg border border-dashed p-8 text-center'>
+          You do not have access to CRM enquiries.
+        </div>
+      }
+      pageHeaderAction={
+        canCreate && referenceData ? (
+          <EnquiryFormSheetTrigger referenceData={referenceData} />
+        ) : null
+      }
     >
-      <CrmProductionPlaceholder
-        title='Enquiry module pending'
-        summary='The demo enquiry workflow remains available only under crm-demo while this production route stays foundation-safe.'
-        foundationItems={[
-          'Master option statuses',
-          'Organization-scoped document sequences',
-          'Branch scope abstraction',
-          'Permission layer',
-          'Audit logging'
-        ]}
-        nextStep='Implement enquiry listing and detail flows on production APIs after Customer and Contact are in place.'
-        demoHref='/dashboard/crm-demo/enquiries'
-      />
+      {referenceData ? (
+        <EnquiryListing referenceData={referenceData} canUpdate={canUpdate} canDelete={canDelete} />
+      ) : null}
     </PageContainer>
   );
 }