feat(sp14): 5-lane Inbox UI with Payer-Rejected acknowledge action
Closes the gap between the SP10 backend (5 lanes) and the SP6
frontend (4 lanes). The Payer-Rejected lane (277CA STC A4/A6/A7)
is now rendered alongside Rejected/Candidates/Unmatched/Done,
with an Acknowledge bulk action that drops claims from the
working surface without erasing the original 277CA rejection
event (audit log stays intact, SP11).
Backend:
* Migration 0010: add payer_rejected_acknowledged_at +
payer_rejected_acknowledged_actor columns + partial index.
* db.py: surface the two new columns on the Claim model.
* inbox_lanes.py: filter acknowledged claims out of the
payer_rejected lane; expose the new fields on the row payload
for forward-compat (e.g. a future 'Recently acknowledged' view).
* api.py:
- POST /api/inbox/payer-rejected/acknowledge
Bulk-acknowledge. Idempotent. Returns transitioned /
already_acked / not_found / not_rejected counts so the UI
can show '3 of 5 were already acknowledged' on a noop bulk.
Writes a 'claim.payer_rejected_acknowledged' event to the
SP11 hash-chained audit log.
- GET /api/inbox/export.csv: accept 'payer_rejected' lane.
* test_acks.py: bump user_version assertion to 10.
* test_lane_filter_acknowledged.py: 4 tests for the lane filter
and forward-compat row payload.
* test_payer_rejected_acknowledge.py: 6 tests for the endpoint
(happy path, idempotency, no-op on non-rejected, missing
ids, 400 on empty, audit-log wiring + chain integrity).
Frontend:
* lib/inbox-api.ts: add payer_rejected to InboxLanes, add
acknowledgePayerRejected(), update exportInboxCsvUrl union.
* hooks/useInboxLanes.ts: add payer_rejected to initial state.
* hooks/useInboxLanes.test.ts: add payer_rejected to mocks.
* components/inbox/BulkBar.tsx: add 'payer_rejected' lane with
Acknowledge action (no Resubmit, no Dismiss — payer-rejected
is not eligible for either).
* components/inbox/BulkBar.test.tsx: add payer_rejected test.
* pages/Inbox.tsx: render the 5th lane, hook up onAcknowledge,
include payer_rejected in the needEyes count.
* pages/Inbox.test.tsx: 3 new tests (5-lane render, need-eyes
count, acknowledge action hits the right endpoint).
* components/inbox/InboxHeader.tsx: doc comment now explains
why payer_rejected rolls up into need-eyes.
Pre-existing typecheck warnings in BulkBar.test.tsx / InboxRow
.test.tsx / Lane.tsx / download.test.ts are unchanged from
main — not touched here.
Test counts: backend 724 -> 734 (+10). Frontend 350 -> 354 (+4).
This commit is contained in:
Tyler
@@ -1,6 +1,6 @@
|
||||
// @vitest-environment happy-dom
|
||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||
import { cleanup, render, screen, fireEvent } from "@testing-library/react";
|
||||
import { cleanup, render, fireEvent } from "@testing-library/react";
|
||||
import { BulkBar } from "./BulkBar";
|
||||
|
||||
afterEach(() => cleanup());
|
||||
@@ -12,6 +12,7 @@ describe("BulkBar", () => {
|
||||
lane="rejected"
|
||||
count={3}
|
||||
onResubmit={vi.fn()}
|
||||
onAcknowledge={() => {}}
|
||||
onDismiss={vi.fn()}
|
||||
onExport={vi.fn()}
|
||||
/>,
|
||||
@@ -28,6 +29,7 @@ describe("BulkBar", () => {
|
||||
lane="rejected"
|
||||
count={2}
|
||||
onResubmit={onResubmit}
|
||||
onAcknowledge={() => {}}
|
||||
onDismiss={() => {}}
|
||||
onExport={() => {}}
|
||||
/>,
|
||||
@@ -39,12 +41,36 @@ describe("BulkBar", () => {
|
||||
expect(onResubmit).toHaveBeenCalledOnce();
|
||||
});
|
||||
|
||||
it("SP14: payer_rejected lane shows Acknowledge (not Resubmit/Dismiss)", () => {
|
||||
// Payer-rejected claims are not eligible for resubmit (the payer
|
||||
// already said no); the operator can only acknowledge them as
|
||||
// "I've seen this" and export the row set for follow-up.
|
||||
const onAcknowledge = vi.fn();
|
||||
const { container, getByTestId } = render(
|
||||
<BulkBar
|
||||
lane="payer_rejected"
|
||||
count={4}
|
||||
onResubmit={() => {}}
|
||||
onAcknowledge={onAcknowledge}
|
||||
onDismiss={() => {}}
|
||||
onExport={() => {}}
|
||||
/>,
|
||||
);
|
||||
expect(container.textContent).toMatch(/acknowledge/i);
|
||||
expect(container.textContent).not.toMatch(/re-?submit/i);
|
||||
expect(container.textContent).not.toMatch(/dismiss/i);
|
||||
const ack = getByTestId("payer-rejected-acknowledge");
|
||||
fireEvent.click(ack);
|
||||
expect(onAcknowledge).toHaveBeenCalledOnce();
|
||||
});
|
||||
|
||||
it("hides when count is zero", () => {
|
||||
const { container } = render(
|
||||
<BulkBar
|
||||
lane="rejected"
|
||||
count={0}
|
||||
onResubmit={() => {}}
|
||||
onAcknowledge={() => {}}
|
||||
onDismiss={() => {}}
|
||||
onExport={() => {}}
|
||||
/>,
|
||||
|
||||
@@ -1,13 +1,40 @@
|
||||
// ---------------------------------------------------------------------------
|
||||
// BulkBar
|
||||
//
|
||||
// Per-lane floating action bar. Each Inbox lane has its own BulkBar —
|
||||
// the bar shows when the lane has a selection and exposes the actions
|
||||
// appropriate to that lane:
|
||||
//
|
||||
// * rejected → Re-submit (move back to SUBMITTED)
|
||||
// * payer_rejected → Acknowledge (drop from working surface; SP14)
|
||||
// * candidates → Dismiss (suppress a remit/claim pair)
|
||||
// * unmatched → (no destructive action; just export)
|
||||
// * done_today → (read-only; just export)
|
||||
//
|
||||
// Every lane gets the Export CSV action so the operator can ship
|
||||
// anything actionable to a file for off-system follow-up (appeals,
|
||||
// re-keying, posting to the billing system of record, etc).
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
type LaneKey =
|
||||
| "rejected"
|
||||
| "payer_rejected"
|
||||
| "candidates"
|
||||
| "unmatched"
|
||||
| "done_today";
|
||||
|
||||
export function BulkBar({
|
||||
lane,
|
||||
count,
|
||||
onResubmit,
|
||||
onAcknowledge,
|
||||
onDismiss,
|
||||
onExport,
|
||||
}: {
|
||||
lane: "rejected" | "candidates" | "unmatched" | "done_today";
|
||||
lane: LaneKey;
|
||||
count: number;
|
||||
onResubmit: () => void;
|
||||
onAcknowledge: () => void;
|
||||
onDismiss: () => void;
|
||||
onExport: () => void;
|
||||
}) {
|
||||
@@ -52,6 +79,16 @@ export function BulkBar({
|
||||
Re-submit ({count})
|
||||
</button>
|
||||
)}
|
||||
{lane === "payer_rejected" && (
|
||||
<button
|
||||
onClick={onAcknowledge}
|
||||
data-testid="payer-rejected-acknowledge"
|
||||
className="px-2.5 py-1 rounded-sm uppercase tracking-[0.12em] transition-colors hover:bg-[color:var(--tt-amber)]/10 focus-visible:outline-none focus-visible:bg-[color:var(--tt-amber)]/10"
|
||||
style={{ color: "var(--tt-ink)", fontWeight: 600 }}
|
||||
>
|
||||
Acknowledge ({count})
|
||||
</button>
|
||||
)}
|
||||
{lane === "candidates" && (
|
||||
<button
|
||||
onClick={onDismiss}
|
||||
|
||||
@@ -1,3 +1,16 @@
|
||||
// ---------------------------------------------------------------------------
|
||||
// InboxHeader
|
||||
//
|
||||
// Compact working-surface header: the day/date, a live clock, and the
|
||||
// two top-line counts ("N items need eyes" and "N done today") that
|
||||
// anchor the operator's day. "Need eyes" is computed by the Inbox
|
||||
// page (sum of actionable lanes) and passed in.
|
||||
//
|
||||
// SP14: payer_rejected (277CA) is now part of the actionable lanes —
|
||||
// it's a working-surface rejection that needs operator follow-up.
|
||||
// The Inbox page sums it into the needEyes count.
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
export function InboxHeader({
|
||||
needEyesCount,
|
||||
doneTodayCount,
|
||||
|
||||
Reference in New Issue
Block a user