Initial commit: Port Nimara CRM (Layers 0-4)

Full CRM rebuild with Next.js 15, TypeScript, Tailwind, Drizzle ORM,
PostgreSQL, Redis, BullMQ, MinIO, and Socket.io. Includes 461 source
files covering clients, berths, interests/pipeline, documents/EOI,
expenses/invoices, email, notifications, dashboard, admin, and
client portal. CI/CD via Gitea Actions with Docker builds.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/app/api/v1/invoices/[id]/generate-pdf/route.ts

@@ -0,0 +1,21 @@
+import { NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { errorResponse } from '@/lib/errors';
+import { generateInvoicePdf } from '@/lib/services/invoices';
+
+export const POST = withAuth(
+  withPermission('invoices', 'edit', async (_req, ctx, params) => {
+    try {
+      const fileRecord = await generateInvoicePdf(params.id!, ctx.portId, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return NextResponse.json({ data: fileRecord });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);

src/app/api/v1/invoices/[id]/payment/route.ts

@@ -0,0 +1,24 @@
+import { NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { parseBody } from '@/lib/api/route-helpers';
+import { errorResponse } from '@/lib/errors';
+import { recordPayment } from '@/lib/services/invoices';
+import { recordPaymentSchema } from '@/lib/validators/invoices';
+
+export const PATCH = withAuth(
+  withPermission('invoices', 'edit', async (req, ctx, params) => {
+    try {
+      const body = await parseBody(req, recordPaymentSchema);
+      const invoice = await recordPayment(params.id!, ctx.portId, body, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return NextResponse.json({ data: invoice });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);

src/app/api/v1/invoices/[id]/route.ts

@@ -0,0 +1,51 @@
+import { NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { parseBody } from '@/lib/api/route-helpers';
+import { errorResponse } from '@/lib/errors';
+import { getInvoiceById, updateInvoice, deleteInvoice } from '@/lib/services/invoices';
+import { updateInvoiceSchema } from '@/lib/validators/invoices';
+
+export const GET = withAuth(
+  withPermission('invoices', 'view', async (_req, ctx, params) => {
+    try {
+      const invoice = await getInvoiceById(params.id!, ctx.portId);
+      return NextResponse.json({ data: invoice });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);
+
+export const PATCH = withAuth(
+  withPermission('invoices', 'edit', async (req, ctx, params) => {
+    try {
+      const body = await parseBody(req, updateInvoiceSchema);
+      const invoice = await updateInvoice(params.id!, ctx.portId, body, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return NextResponse.json({ data: invoice });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);
+
+export const DELETE = withAuth(
+  withPermission('invoices', 'delete', async (_req, ctx, params) => {
+    try {
+      await deleteInvoice(params.id!, ctx.portId, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return new NextResponse(null, { status: 204 });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);

src/app/api/v1/invoices/[id]/send/route.ts

@@ -0,0 +1,21 @@
+import { NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { errorResponse } from '@/lib/errors';
+import { sendInvoice } from '@/lib/services/invoices';
+
+export const POST = withAuth(
+  withPermission('invoices', 'create', async (_req, ctx, params) => {
+    try {
+      const invoice = await sendInvoice(params.id!, ctx.portId, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return NextResponse.json({ data: invoice });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);

src/app/api/v1/invoices/route.ts

@@ -0,0 +1,50 @@
+import { NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { parseQuery, parseBody } from '@/lib/api/route-helpers';
+import { errorResponse } from '@/lib/errors';
+import { listInvoices, createInvoice } from '@/lib/services/invoices';
+import { listInvoicesSchema, createInvoiceSchema } from '@/lib/validators/invoices';
+
+export const GET = withAuth(
+  withPermission('invoices', 'view', async (req, ctx) => {
+    try {
+      const query = parseQuery(req, listInvoicesSchema);
+      const result = await listInvoices(ctx.portId, query);
+
+      const { page, limit } = query;
+      const totalPages = Math.ceil(result.total / limit);
+
+      return NextResponse.json({
+        data: result.data,
+        pagination: {
+          page,
+          pageSize: limit,
+          total: result.total,
+          totalPages,
+          hasNextPage: page < totalPages,
+          hasPreviousPage: page > 1,
+        },
+      });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);
+
+export const POST = withAuth(
+  withPermission('invoices', 'create', async (req, ctx) => {
+    try {
+      const body = await parseBody(req, createInvoiceSchema);
+      const invoice = await createInvoice(ctx.portId, body, {
+        userId: ctx.userId,
+        portId: ctx.portId,
+        ipAddress: ctx.ipAddress,
+        userAgent: ctx.userAgent,
+      });
+      return NextResponse.json({ data: invoice }, { status: 201 });
+    } catch (error) {
+      return errorResponse(error);
+    }
+  }),
+);