doc compare

server/src/modules/purchasing/service.ts

@@ -1,5 +1,14 @@
 import { Prisma } from "@prisma/client";
-import type { PurchaseLineInput, PurchaseOrderDetailDto, PurchaseOrderInput, PurchaseOrderStatus, PurchaseOrderSummaryDto, PurchaseVendorOptionDto } from "@mrp/shared";
+import type {
+  PurchaseLineInput,
+  PurchaseOrderDetailDto,
+  PurchaseOrderInput,
+  PurchaseOrderRevisionDto,
+  PurchaseOrderRevisionSnapshotDto,
+  PurchaseOrderStatus,
+  PurchaseOrderSummaryDto,
+  PurchaseVendorOptionDto,
+} from "@mrp/shared";
 import type { PurchaseReceiptDto, PurchaseReceiptInput } from "@mrp/shared/dist/purchasing/types.js";
 
 import { logAuditEvent } from "../../lib/audit.js";
@@ -102,6 +111,18 @@ type PurchaseReceiptRecord = {
   lines: PurchaseReceiptLineRecord[];
 };
 
+type PurchaseOrderRevisionRecord = {
+  id: string;
+  revisionNumber: number;
+  reason: string;
+  snapshot: string;
+  createdAt: Date;
+  createdBy: {
+    firstName: string;
+    lastName: string;
+  } | null;
+};
+
 type PurchaseOrderRecord = {
   id: string;
   documentNumber: string;
@@ -121,6 +142,7 @@ type PurchaseOrderRecord = {
   };
   lines: PurchaseLineRecord[];
   receipts: PurchaseReceiptRecord[];
+  revisions: PurchaseOrderRevisionRecord[];
 };
 
 function roundMoney(value: number) {
@@ -147,6 +169,10 @@ function getCreatedByName(createdBy: PurchaseReceiptRecord["createdBy"]) {
   return createdBy ? `${createdBy.firstName} ${createdBy.lastName}`.trim() : "System";
 }
 
+function getUserDisplayName(user: { firstName: string; lastName: string } | null) {
+  return user ? `${user.firstName} ${user.lastName}`.trim() : null;
+}
+
 function mapPurchaseReceipt(record: PurchaseReceiptRecord, purchaseOrderId: string): PurchaseReceiptDto {
   const lines = record.lines.map((line: PurchaseReceiptLineRecord) => ({
     id: line.id,
@@ -177,6 +203,21 @@ function mapPurchaseReceipt(record: PurchaseReceiptRecord, purchaseOrderId: stri
   };
 }
 
+function parseRevisionSnapshot(snapshot: string): PurchaseOrderRevisionSnapshotDto {
+  return JSON.parse(snapshot) as PurchaseOrderRevisionSnapshotDto;
+}
+
+function mapPurchaseOrderRevision(record: PurchaseOrderRevisionRecord): PurchaseOrderRevisionDto {
+  return {
+    id: record.id,
+    revisionNumber: record.revisionNumber,
+    reason: record.reason,
+    createdAt: record.createdAt.toISOString(),
+    createdByName: getUserDisplayName(record.createdBy),
+    snapshot: parseRevisionSnapshot(record.snapshot),
+  };
+}
+
 function normalizeLines(lines: PurchaseLineInput[]) {
   return lines
     .map((line, index) => ({
@@ -319,6 +360,10 @@ function mapPurchaseOrder(record: PurchaseOrderRecord): PurchaseOrderDetailDto {
     .slice()
     .sort((left, right) => right.receivedAt.getTime() - left.receivedAt.getTime())
     .map((receipt) => mapPurchaseReceipt(receipt, record.id));
+  const revisions = record.revisions
+    .slice()
+    .sort((left, right) => right.revisionNumber - left.revisionNumber)
+    .map(mapPurchaseOrderRevision);
 
   return {
     id: record.id,
@@ -341,9 +386,87 @@ function mapPurchaseOrder(record: PurchaseOrderRecord): PurchaseOrderDetailDto {
     lineCount: lines.length,
     lines,
     receipts,
+    revisions,
   };
 }
 
+function buildPurchaseOrderRevisionSnapshot(document: PurchaseOrderDetailDto) {
+  return JSON.stringify({
+    documentNumber: document.documentNumber,
+    vendorId: document.vendorId,
+    vendorName: document.vendorName,
+    status: document.status,
+    issueDate: document.issueDate,
+    taxPercent: document.taxPercent,
+    taxAmount: document.taxAmount,
+    freightAmount: document.freightAmount,
+    subtotal: document.subtotal,
+    total: document.total,
+    notes: document.notes,
+    paymentTerms: document.paymentTerms,
+    currencyCode: document.currencyCode,
+    lines: document.lines.map((line) => ({
+      itemId: line.itemId,
+      itemSku: line.itemSku,
+      itemName: line.itemName,
+      description: line.description,
+      quantity: line.quantity,
+      unitOfMeasure: line.unitOfMeasure,
+      unitCost: line.unitCost,
+      lineTotal: line.lineTotal,
+      receivedQuantity: line.receivedQuantity,
+      remainingQuantity: line.remainingQuantity,
+      salesOrderId: line.salesOrderId,
+      salesOrderLineId: line.salesOrderLineId,
+      salesOrderNumber: line.salesOrderNumber,
+      position: line.position,
+    })),
+    receipts: document.receipts.map((receipt) => ({
+      id: receipt.id,
+      receiptNumber: receipt.receiptNumber,
+      purchaseOrderId: receipt.purchaseOrderId,
+      receivedAt: receipt.receivedAt,
+      notes: receipt.notes,
+      createdAt: receipt.createdAt,
+      createdByName: receipt.createdByName,
+      warehouseId: receipt.warehouseId,
+      warehouseCode: receipt.warehouseCode,
+      warehouseName: receipt.warehouseName,
+      locationId: receipt.locationId,
+      locationCode: receipt.locationCode,
+      locationName: receipt.locationName,
+      totalQuantity: receipt.totalQuantity,
+      lineCount: receipt.lineCount,
+      lines: receipt.lines.map((line) => ({
+        id: line.id,
+        purchaseOrderLineId: line.purchaseOrderLineId,
+        itemId: line.itemId,
+        itemSku: line.itemSku,
+        itemName: line.itemName,
+        quantity: line.quantity,
+      })),
+    })),
+  });
+}
+
+async function createPurchaseOrderRevision(documentId: string, detail: PurchaseOrderDetailDto, reason: string, actorId?: string | null) {
+  const aggregate = await prisma.purchaseOrderRevision.aggregate({
+    where: { purchaseOrderId: documentId },
+    _max: { revisionNumber: true },
+  });
+  const nextRevisionNumber = (aggregate._max.revisionNumber ?? 0) + 1;
+
+  await prisma.purchaseOrderRevision.create({
+    data: {
+      purchaseOrderId: documentId,
+      revisionNumber: nextRevisionNumber,
+      reason,
+      snapshot: buildPurchaseOrderRevisionSnapshot(detail),
+      createdById: actorId ?? null,
+    },
+  });
+}
+
 async function nextDocumentNumber() {
   const next = (await purchaseOrderModel.count()) + 1;
   return `PO-${String(next).padStart(5, "0")}`;
@@ -423,6 +546,17 @@ const purchaseOrderInclude = Prisma.validator<Prisma.PurchaseOrderInclude>()({
     },
     orderBy: [{ receivedAt: "desc" }, { createdAt: "desc" }],
   },
+  revisions: {
+    include: {
+      createdBy: {
+        select: {
+          firstName: true,
+          lastName: true,
+        },
+      },
+    },
+    orderBy: [{ revisionNumber: "desc" }],
+  },
 });
 
 function normalizeReceiptLines(lines: PurchaseReceiptInput["lines"]) {
@@ -605,6 +739,23 @@ export async function getPurchaseOrderById(documentId: string) {
   return record ? mapPurchaseOrder(record as unknown as PurchaseOrderRecord) : null;
 }
 
+export async function listPurchaseOrderRevisions(documentId: string) {
+  const revisions = await prisma.purchaseOrderRevision.findMany({
+    where: { purchaseOrderId: documentId },
+    include: {
+      createdBy: {
+        select: {
+          firstName: true,
+          lastName: true,
+        },
+      },
+    },
+    orderBy: [{ revisionNumber: "desc" }],
+  });
+
+  return revisions.map((revision) => mapPurchaseOrderRevision(revision as PurchaseOrderRevisionRecord));
+}
+
 export async function createPurchaseOrder(payload: PurchaseOrderInput, actorId?: string | null) {
   const validatedLines = await validateLines(payload.lines);
   if (!validatedLines.ok) {
@@ -640,6 +791,7 @@ export async function createPurchaseOrder(payload: PurchaseOrderInput, actorId?:
 
   const detail = await getPurchaseOrderById(created.id);
   if (detail) {
+    await createPurchaseOrderRevision(created.id, detail, payload.revisionReason?.trim() || "Initial issue", actorId);
     await logAuditEvent({
       actorId,
       entityType: "purchase-order",
@@ -700,6 +852,7 @@ export async function updatePurchaseOrder(documentId: string, payload: PurchaseO
 
   const detail = await getPurchaseOrderById(documentId);
   if (detail) {
+    await createPurchaseOrderRevision(documentId, detail, payload.revisionReason?.trim() || "Document edited", actorId);
     await logAuditEvent({
       actorId,
       entityType: "purchase-order",
@@ -735,6 +888,7 @@ export async function updatePurchaseOrderStatus(documentId: string, status: Purc
 
   const detail = await getPurchaseOrderById(documentId);
   if (detail) {
+    await createPurchaseOrderRevision(documentId, detail, `Status changed to ${status}`, actorId);
     await logAuditEvent({
       actorId,
       entityType: "purchase-order",
@@ -796,6 +950,7 @@ export async function createPurchaseReceipt(orderId: string, payload: PurchaseRe
 
   const detail = await getPurchaseOrderById(orderId);
   if (detail) {
+    await createPurchaseOrderRevision(orderId, detail, `Receipt posted on ${payload.receivedAt}`, createdById);
     await logAuditEvent({
       actorId: createdById,
       entityType: "purchase-order",