Admin pricing moves from flat, code-adjacent config knobs to a versioned, append-only commercial model: staff publish immutable India/US Individual and Firm rate-card versions, record and reverse offline page grants against a firm's pool, and read staff-only unit economics — all backed by the new admin billing API from pramaan-functions PR#699.
/pricing edited a flat, mutable
PricingConfigView (AI markup, FX peg, GST, min
top-up) and per-plan credit/storage fields directly. A separate
/billing page let any staff member post a signed
credit adjustment to a firm's wallet with no ledger read-back
beyond the current session. Neither surface distinguished
historical receipts from live config, and there was no unit
economics view.
/pricing is now a rate-card editor: staff publish
the next immutable version per (region, account type) with
validated terms; nothing is ever edited in place. The Firm
Billing tab shows the firm's page pool, its full immutable
grant/reversal ledger, an offline-grant wizard
(form → confirm → success) with a live projected pool increase,
reversal-with-reason, and a staff-only monthly unit economics
panel (revenue, Textract, inference, storage, contribution) with
a matter/document/receipt-id drill-down — no legal content.
Old AI-markup, credit, top-up, and customer storage-price admin
controls are removed per the Story-2544 acceptance criteria. The
functions endpoints they called
(/admin/billing/pricing-config,
/admin/billing/plans,
/admin/firms/{firmId}/billing/credits/adjustment)
are untouched here — this PR is the admin UI only; retiring the
backend routes is out of scope and tracked separately.
| Removed | Replaced by |
|---|---|
src/components/pricing/pricing-view.tsx |
src/components/pricing/rate-card-editor.tsx |
src/components/pricing/config-form.tsx |
react-hook-form + zod fields inlined in the rate-card editor |
src/lib/actions/pricing.ts |
createRateCardVersion in src/lib/actions/billing.ts |
src/app/(admin)/billing/page.tsx (global credit-adjustment page) |
Firm Billing tab: FirmPagePoolPanel + FirmUnitEconomicsPanel |
src/components/billing/credit-adjustment-form.tsx (+ stories) |
PageGrantModal (offline grant wizard) |
src/lib/actions/credit-adjustment.ts |
recordPageGrant / reversePageGrant in src/lib/actions/billing.ts |
formatCredits() in src/lib/formatters.ts (orphaned) |
formatMicros / formatUsdMicros in src/lib/billing/micros.ts |
| Rail nav "Billing" top-level item | Removed — page grants and unit economics live on Firms > Billing, not a duplicate top-level page. "Pricing" relabeled "Rate cards". |
/pricing (RateCardEditor): current-terms
summary for IN/US × Individual/Firm, a validated
"publish a new version" form (account-type-conditional fields:
per-page price for Individual; seat price, min seats/term,
included pages, overage price, onboarding pool for Firm), and
the full version history table.
FirmPagePoolPanel (available/
monthly/offline/onboarding pool counts, immutable grant/
reversal history table, "Record offline grant" action, per-row
"Reverse" action gated to un-reversed grants only — no edit or
delete anywhere) and FirmUnitEconomicsPanel (month
picker over the last 3 fetched months, revenue/Textract/
inference/storage/total-direct-cost/contribution KPIs, and a
drill-down table of vendor cost events by matter/document/
receipt id).
PageGrantModal: the offline-purchase / commercial-
adjustment wizard — form (firm implied, rate card, pages,
amount, payment method, cheque/receipt reference, received
date, validity date, reason) → confirmation (firm, page count,
amount, reference, validity) → submit → success screen with the
projected pool increase from the server-confirmed response.
fetchFirmBillingExtras in
src/lib/billing/firm-billing-extras.ts) and
threaded down as props — no new client-side data fetch or
/api/internal proxy route was needed.
recordPageGrant, reversePageGrant,
createRateCardVersion in
src/lib/actions/billing.ts), which already carry
the ADR-124 business-action audit logging (success/denied/
failed outcomes). Per HR-6/component doctrine, admin writes are
server-confirmed only: on success the client calls
router.refresh(); there is no optimistic cache
flip.
import a
"use server" action file directly — Storybook's
Vite bundler does not understand the "use server" transform and
pulls the action's server-only dependencies (Clerk, the
gateway) into the browser bundle, which broke every story that
rendered the tree with a bare ReferenceError: __dirname
is not defined. The fix mirrors the existing
onResendInvite pattern: the RSC page imports the
action and passes it down as a prop
(onRecordGrant, onReverseGrant,
onPublishRateCard); leaf components only import
the action's types.
GatewayError and render the shared
AccessRestricted primitive instead of the data
view; every write already returns an audited "denied" outcome
on 403 via the existing action logging.
Per the acceptance criteria (grant form, confirmation, success, reversal, validation, denied):
Firms/PageGrantModal: Form, Validation errors, Confirmation, Success, Submission failed.Firms/FirmPagePoolPanel: Default, Empty, Denied, Reversal dialog, Record grant dialog.Firms/FirmUnitEconomicsPanel: Default, No activity this month, Denied.Pricing/RateCardEditor: Default, No cards published yet, Validation error.pnpm exec tsc --noEmit passed.pnpm run lint passed with only the existing TanStack/React-Compiler incompatible-library warnings, unrelated to this change.pnpm run test passed: 94 files, 594 tests.pnpm run test:storybook passed: 114 files, 414 tests (Chromium, includes every new story's play function).NEXT_PUBLIC_ENV=local pnpm run build succeeded; the route table confirms /billing is gone and /pricing and /firms/[firmRef] compile.