pelagia-portal/App/app/(portal)/approvals/[id]/page.tsx
Hardik 99c928213b
All checks were successful
PR checks / checks (pull_request) Successful in 43s
PR checks / integration (pull_request) Successful in 30s
feat(po): manager sets advance payment on approval (issue #92)
The approving Manager decides how much of the PO is paid first, via a
0–100% slider on the approval card (default 100% = full). The slider is
convenience only — the resolved ABSOLUTE amount is stored on
PurchaseOrder.suggestedAdvancePayment (Decimal(12,2), nullable).

- schema + migration: add suggestedAdvancePayment (null = no explicit
  advance ⇒ full payment, preserves legacy behaviour).
- approvePo(): accepts the amount, clamps to [0, totalAmount], persists
  it, records it on the APPROVED audit row. Set once at approval; never
  edited afterwards.
- approval-actions.tsx: whole-percent slider showing the resolved ₹
  amount + remaining balance; value sent with Approve / Approve-with-Remarks.
- Accounts surface: payment queue + PO detail show the advance; it
  prefills the FIRST payment amount (only when nothing is paid yet and
  it is a true partial). Balance runs the normal PARTIALLY_PAID loop.
- Not shown on the exported PO/invoice (po-export-layout untouched).
- Tests: persist + audit metadata + clamp-to-total.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 01:40:20 +05:30

129 lines
4.8 KiB
TypeScript

import { auth } from "@/auth";
import { db } from "@/lib/db";
import { hasPermission } from "@/lib/permissions";
import { notFound, redirect } from "next/navigation";
import { ApprovalActions } from "./approval-actions";
import { PoDetail } from "@/components/po/po-detail";
import { ManagerEditPoForm } from "./manager-edit-po-form";
import { buildAccountGroups } from "@/lib/cost-centre-groups";
import type { CompanyOption } from "@/app/(portal)/po/new/new-po-form";
import type { Metadata } from "next";
interface Props {
params: Promise<{ id: string }>;
}
export const metadata: Metadata = { title: "Review PO" };
export default async function ApprovalDetailPage({ params }: Props) {
const session = await auth();
if (!session?.user) redirect("/login");
if (!hasPermission(session.user.role, "approve_po")) redirect("/dashboard");
const { id } = await params;
const currentUser = await db.user.findUnique({
where: { id: session.user.id },
select: { signatureKey: true },
});
const hasSignature = !!(currentUser?.signatureKey);
const [po, vessels, leafAccounts, vendors, companies] = await Promise.all([
db.purchaseOrder.findUnique({
where: { id },
include: {
submitter: true,
vessel: true,
site: { select: { id: true, name: true } },
account: true,
vendor: true,
lineItems: { orderBy: { sortOrder: "asc" } },
documents: { orderBy: { uploadedAt: "desc" } },
actions: { include: { actor: true }, orderBy: { createdAt: "asc" } },
receipt: true,
},
}),
db.vessel.findMany({ where: { isActive: true }, orderBy: { name: "asc" }, select: { id: true, name: true, code: true } }),
db.account.findMany({
where: { isActive: true, children: { none: {} } },
orderBy: { code: "asc" },
select: { id: true, code: true, name: true, parent: { select: { name: true, code: true, parent: { select: { name: true, code: true } } } } },
}),
db.vendor.findMany({ where: { isActive: true }, orderBy: { name: "asc" } }),
db.company.findMany({ where: { isActive: true }, orderBy: { name: "asc" }, select: { id: true, name: true, code: true } }),
]);
if (!po) notFound();
if (po.status !== "MGR_REVIEW") redirect(`/po/${id}`);
const accounts = buildAccountGroups(leafAccounts);
const serializedPo = {
...po,
totalAmount: po.totalAmount.toNumber(),
lineItems: po.lineItems.map((li) => ({
...li,
quantity: li.quantity.toNumber(),
unitPrice: li.unitPrice.toNumber(),
totalPrice: li.totalPrice.toNumber(),
gstRate: li.gstRate.toNumber(),
})),
};
return (
<div className="max-w-6xl">
<div className="mb-4 md:mb-6 flex items-center justify-between">
<div>
<h1 className="text-lg md:text-2xl font-semibold text-neutral-900">Review Purchase Order</h1>
<p className="mt-0.5 text-sm text-neutral-500">{po.poNumber} {po.title}</p>
</div>
</div>
{!po.vendorId && (
<div className="mb-4 rounded-lg border border-danger-100 bg-danger-50 px-4 py-3">
<p className="text-sm font-medium text-danger-700">Vendor required before approval</p>
<p className="text-sm text-danger-600 mt-0.5">
This PO has no vendor assigned. Use &ldquo;Request Vendor ID&rdquo; to route it for vendor selection, or assign a vendor via the Edit PO form on desktop.
</p>
</div>
)}
<PoDetail po={po} currentUserId={session.user.id} currentRole={session.user.role} readOnly />
<div className="hidden md:block">
<ManagerEditPoForm
po={serializedPo}
vessels={vessels}
accounts={accounts}
vendors={vendors}
companies={companies}
/>
</div>
<div className="mt-4 md:mt-6">
{hasSignature ? (
<ApprovalActions
poId={po.id}
poStatus={po.status}
totalAmount={Number(po.totalAmount)}
currency={po.currency}
/>
) : (
<div className="rounded-lg border border-warning-200 bg-warning-50 p-4 md:p-5 flex items-start gap-3">
<span className="text-warning-500 text-xl leading-none mt-0.5"></span>
<div>
<p className="text-sm font-semibold text-warning-800">Signature required to approve POs</p>
<p className="text-sm text-warning-700 mt-0.5">
You must upload your approval signature before you can approve, reject, or request edits on purchase orders.
</p>
<a href="/profile" className="mt-2 inline-block text-sm font-medium text-primary-600 hover:text-primary-700 underline">
Go to Profile to upload your signature
</a>
</div>
</div>
)}
</div>
</div>
);
}