feat: payment PDF extraction, import, and remittance tracking

- Add Upload Payment Documents section with Extract & Download (Excel)
  and Extract & Import (database) buttons
- PDF extractor (pdfplumber) parses MassHealth RA PDFs: two-pass
  strategy joins summary-page ICN/patient map with detail-page
  procedure data (CDT code, paid code, tooth, date, allowed amount)
- RA cover-page summary (Payee ID, RA #, Payment Amount, etc.)
  included as separate Excel sheet; numeric values written as numbers
- Backend PDF import route groups rows by Member #, finds/creates
  patient, creates Payment + ServiceLines with ICN per procedure
- Add icn, paidCode, allowedAmount fields to ServiceLine schema
- Payments table: status simplified to Paid in Full / Balance;
  adjustment auto-computed on mhPaidAmount/copayment change;
  Paid in Full and Revert buttons with confirmation dialogs
- Edit Payment modal: shows ICN, Paid Code, Allowed Amount per line
- PDF Import badge distinguishes from OCR imports in payments table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Gitead
2026-05-07 12:53:50 -04:00
parent e204d30ff6
commit dd0df4a435
76 changed files with 1570 additions and 96 deletions

View File

@@ -103,8 +103,6 @@ export default function PaymentsRecentTable({
const [editingMhPaidValue, setEditingMhPaidValue] = useState<string>("");
const [editingCopaymentId, setEditingCopaymentId] = useState<number | null>(null);
const [editingCopaymentValue, setEditingCopaymentValue] = useState<string>("");
const [editingAdjustmentId, setEditingAdjustmentId] = useState<number | null>(null);
const [editingAdjustmentValue, setEditingAdjustmentValue] = useState<string>("");
const [isRevertOpen, setIsRevertOpen] = useState(false);
const [revertPaymentId, setRevertPaymentId] = useState<number | null>(null);
@@ -394,6 +392,12 @@ export default function PaymentsRecentTable({
const [isUnvoidOpen, setIsUnvoidOpen] = useState(false);
const [unvoidPaymentId, setUnvoidPaymentId] = useState<number | null>(null);
const [isPaidInFullOpen, setIsPaidInFullOpen] = useState(false);
const [paidInFullPaymentId, setPaidInFullPaymentId] = useState<number | null>(null);
const [isRevertPaidOpen, setIsRevertPaidOpen] = useState(false);
const [revertPaidPaymentId, setRevertPaidPaymentId] = useState<number | null>(null);
const handleConfirmVoid = () => {
if (!voidPaymentId) return;
handleVoid(voidPaymentId);
@@ -408,6 +412,20 @@ export default function PaymentsRecentTable({
setIsUnvoidOpen(false);
};
const handleConfirmPaidInFull = () => {
if (!paidInFullPaymentId) return;
updatePaymentStatusMutation.mutate({ paymentId: paidInFullPaymentId, status: "PAID" });
setPaidInFullPaymentId(null);
setIsPaidInFullOpen(false);
};
const handleConfirmRevertPaid = () => {
if (!revertPaidPaymentId) return;
updatePaymentStatusMutation.mutate({ paymentId: revertPaidPaymentId, status: "PENDING" });
setRevertPaidPaymentId(null);
setIsRevertPaidOpen(false);
};
// Pagination
useEffect(() => {
if (onPageChange) onPageChange(currentPage);
@@ -660,9 +678,13 @@ export default function PaymentsRecentTable({
</TableCell>
)}
<TableCell>
<span className="text-sm font-mono">
{payment.claim?.claimNumber ?? <span className="text-gray-400"></span>}
</span>
{payment.claim?.claimNumber ? (
<span className="text-sm font-mono">{payment.claim.claimNumber}</span>
) : payment.notes?.startsWith("PDF import") ? (
<span className="text-xs font-medium bg-blue-100 text-blue-800 px-2 py-0.5 rounded-full">PDF Import</span>
) : (
<span className="text-gray-400"></span>
)}
</TableCell>
<TableCell>
@@ -717,37 +739,19 @@ export default function PaymentsRecentTable({
<TableCell>
<div className="flex items-center gap-2">
{(() => {
// VOID and DENIED are manual decisions — show as-is
if (payment.status === "VOID" || payment.status === "DENIED" || payment.status === "OVERPAID") {
const { label, color, icon } = getStatusInfo(payment.status);
return (
<span className={`px-2 py-1 text-xs font-medium rounded-full ${color}`}>
<span className="flex items-center">{icon}{label}</span>
</span>
);
}
// Compute status from numbers
if (totalDue === 0) {
return (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-teal-100 text-teal-800">
<span className="flex items-center"><CheckCircle className="h-3 w-3 mr-1" />Paid in Full</span>
</span>
);
}
if (totalCollected > 0) {
return (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-blue-100 text-blue-800">
<span className="flex items-center"><DollarSign className="h-3 w-3 mr-1" />Partially Paid</span>
</span>
);
}
return (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-red-100 text-red-800">
<span className="flex items-center"><Clock className="h-3 w-3 mr-1" />Pending</span>
</span>
);
})()}
{payment.status === "VOID" ? (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-gray-100 text-gray-800 flex items-center">
<Ban className="h-3 w-3 mr-1" />Void
</span>
) : payment.status === "PAID" ? (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-teal-100 text-teal-800 flex items-center">
<CheckCircle className="h-3 w-3 mr-1" />Paid in Full
</span>
) : (
<span className="px-2 py-1 text-xs font-medium rounded-full bg-yellow-100 text-yellow-800 flex items-center">
<Clock className="h-3 w-3 mr-1" />Balance
</span>
)}
</div>
</TableCell>
@@ -875,50 +879,11 @@ export default function PaymentsRecentTable({
)}
</TableCell>
{/* Adjustment */}
{/* Adjustment — auto-computed: totalBilled - mhPaid - copayment */}
<TableCell>
{editingAdjustmentId === payment.id ? (
<input
type="number"
min="0"
step="0.01"
autoFocus
className="w-24 border border-blue-400 rounded px-1 py-0.5 text-sm focus:outline-none focus:ring-2 focus:ring-blue-300"
value={editingAdjustmentValue}
onChange={(e) => setEditingAdjustmentValue(e.target.value)}
onKeyDown={(e) => {
if (e.key === "Enter") e.currentTarget.blur();
else if (e.key === "Escape") setEditingAdjustmentId(null);
}}
onBlur={async () => {
const val = parseFloat(editingAdjustmentValue);
if (!isNaN(val) && val >= 0) {
try {
const res = await apiRequest("PATCH", `/api/payments/${payment.id}/adjustment`, { adjustment: val });
if (res.ok) {
await queryClient.invalidateQueries({ queryKey: QK_PAYMENTS_RECENT_BASE });
} else {
toast({ title: "Error", description: "Failed to save adjustment.", variant: "destructive" });
}
} catch {
toast({ title: "Error", description: "Failed to save adjustment.", variant: "destructive" });
}
}
setEditingAdjustmentId(null);
}}
/>
) : (
<span
className="text-sm font-medium text-orange-700 cursor-pointer hover:underline hover:text-orange-900"
title="Click to edit"
onClick={() => {
setEditingAdjustmentId(payment.id);
setEditingAdjustmentValue(Number(payment.adjustment ?? 0).toFixed(2));
}}
>
${Number(payment.adjustment ?? 0).toFixed(2)}
</span>
)}
<span className="text-sm font-medium text-orange-700">
${adjustment.toFixed(2)}
</span>
</TableCell>
<TableCell className="text-right">
@@ -949,6 +914,38 @@ export default function PaymentsRecentTable({
</Button>
)}
{/* Paid in Full — only when not already paid or voided */}
{payment.status !== "PAID" &&
payment.status !== "VOID" &&
payment.status !== "DENIED" && (
<Button
variant="default"
size="sm"
className="bg-teal-600 hover:bg-teal-700 text-white"
onClick={() => {
setPaidInFullPaymentId(payment.id);
setIsPaidInFullOpen(true);
}}
>
Paid in Full
</Button>
)}
{/* Revert — only when already Paid in Full */}
{payment.status === "PAID" && (
<Button
variant="outline"
size="sm"
className="border-teal-400 text-teal-700 hover:bg-teal-50"
onClick={() => {
setRevertPaidPaymentId(payment.id);
setIsRevertPaidOpen(true);
}}
>
Revert
</Button>
)}
{/* Show Void unless already voided or denied */}
{payment.status !== "VOID" &&
payment.status !== "DENIED" && (
@@ -1010,6 +1007,28 @@ export default function PaymentsRecentTable({
onCancel={() => setIsRevertOpen(false)}
/>
{/* Revert Paid in Full Confirmation Dialog */}
<ConfirmationDialog
isOpen={isRevertPaidOpen}
title="Revert Paid in Full?"
message="This will revert the status back to Balance. The amounts stay unchanged. Continue?"
confirmLabel="Revert"
confirmColor="bg-yellow-600 hover:bg-yellow-700"
onConfirm={handleConfirmRevertPaid}
onCancel={() => setIsRevertPaidOpen(false)}
/>
{/* Paid in Full Confirmation Dialog */}
<ConfirmationDialog
isOpen={isPaidInFullOpen}
title="Mark as Paid in Full?"
message="This will set the status to Paid in Full and close the balance for this payment. Continue?"
confirmLabel="Paid in Full"
confirmColor="bg-teal-600 hover:bg-teal-700"
onConfirm={handleConfirmPaidInFull}
onCancel={() => setIsPaidInFullOpen(false)}
/>
{/* NEW: Void Confirmation Dialog */}
<ConfirmationDialog
isOpen={isVoidOpen}