Done & Due

Done & Due turns a job photo and a voice note into an editable, evidence-backed invoice for an independent tradesperson. After the contractor confirms the bill, the PayPal Sandbox workspace can create a hosted PayPal invoice, send it or share a payment link, and refresh payment status. The public demo does the same journey with simulated delivery and payment.

The product name is Done & Due.

Inspection

The repository started as a single README.md heading. There was no package manager, app code, or reference image in the tree. The two design references arrived as chat attachments and are stored at:

• design/reference/fieldnote-overview-dashboard.jpg
• design/reference/fieldnote-invoice-review.jpg

The redistributable sample job photo is public/demo/kitchen-tap.jpg.

Stack: Next.js 15 App Router, React 19, TypeScript, Tailwind CSS 4, Radix dialogs, Lucide, Zod, Supabase (@supabase/ssr), @google/genai, PayPal Invoicing v2 over HTTPS. Package manager is npm 10. Node 22 (engines and .nvmrc).

Checklist

Priority	Item	Status
P0a	Public demo: capture, draft, evidence, approval, simulated buyer and payment	Implemented. Browser verification is recorded in Verification.
P0b	PayPal Sandbox workspace, real invoice creation, link-only delivery, refresh, webhook	Implemented. Live Sandbox smoke is pending until the operator adds credentials. Contract fixtures cover create, uncertain outcome, delivery vs settlement, and webhook signatures.
P0c	Gemini transcription, grounded lines, evidence markers	Implemented behind GEMINI_API_KEY. Manual lines and typed notes work when Gemini is absent. A real photo-and-voice smoke test is pending a key.
P1	Webhook reconciliation, invoice history, price list, overview	Implemented. Race and retry behavior is covered by the PayPal service tests. Email delivery against a real Sandbox buyer is an operator step.
P2	Extra dashboards and deployment polish	Overview, jobs, invoices, price list, CSV export, health check, Dockerfile, and Vercel notes are in place. Notification bell is hidden. Production PayPal is deferred.

Two entry points

Path	Who	After approval
/ then Try the demo → /demo	Anyone	Done & Due simulates sending and payment in the browser. No Gemini, Supabase, or PayPal calls.
/ then Open PayPal workspace → /app	Allowlisted contractor	Done & Due creates a PayPal Sandbox invoice. Missing credentials show setup names and never fall back to simulation.

The workspace badge reads Demo · Simulated or PayPal Sandbox. Route and server workspace binding choose the adapter. A URL parameter or a demo id cannot promote an invoice. Provider routes reject ids that start with demo_.

Local start

npm ci
npm run dev

Open http://localhost:3000. The demo works with every secret unset.

npm run lint
npm run typecheck
npm test
npm run eval
npm run build

npm run eval:live is opt-in. It does not call Gemini unless staged voice files are added; the current manifest has text fixtures and one published photo.

Demo

The public demo opens on Cashflow Pulse for the week of 11 November 2026. Opening cash is $310 as of that Wednesday. Reece Plumbing’s $500 bill is due Friday 13 November. Alex Morgan’s kitchen tap invoice INV-024 is $240 ($120 labor, $110 mixer tap, $10 consumables). Jamie Reed’s overdue service call INV-023 is $80.

1. Open /demo. The first screen shows $190 short on Friday and Ask Alex to pay by Thursday.
2. Preview Jamie only, Alex only, both, and Alex arriving Monday. Friday closes at −$110, +$50, +$130, and −$190.
3. Open Alex’s invoice, select the mixer tap, and confirm the transcript highlights “$110” while the photo circles the tap and points to it.
4. Draft the simulated reminder, then open the labeled buyer page.
5. Simulate payment. The invoice is paid and Friday’s baseline buffer is $50 under the labeled Thursday availability assumption.
6. Start a second job from New job. Replaying Alex’s sample returns the existing INV-024 instead of a second copy.
7. Reload keeps the demo. Reset demo returns the $190 Friday gap.

Load missing-duration example leaves labor unresolved so approval stays blocked. Renaming a line to "tap" abstains between the catalog mixer taps. An empty recipient email also blocks approval.

Forecast

Business dates are YYYY-MM-DD in the workspace timezone. The demo timezone is Australia/Perth and the labeled reference date is 2026-11-11. The opening balance is end of day on the as-of date. The forecast starts the next day.

cash_in(d)  = eligible receipts available on d
cash_out(d) = committed outflows scheduled on d
closing(d)  = opening + sum(cash_in(t) - cash_out(t)) through d
shortfall(d) = max(0, -closing(d))
buffer(d)    = max(0,  closing(d))

A scenario adds selected collectible amounts on their assumed dates and does not write those amounts into the ledger. Confirmed payment and funds available to spend stay separate. A paid invoice with no availability date stays out of the baseline and reads Paid · availability unknown.

Migrations

Apply supabase/migrations/001_init.sql, then 002_cash_ledger.sql. Cash figures are stored in workspaces.state.cash. The second migration adds a read-only workspace_cash view.

Demo audio is local playback. Typed notes are the transcription path. Photos and recordings stay in IndexedDB when the browser supports it.

Configuration

Copy .env.example to .env.local. Names used by the code:

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗