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.jpgdesign/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.
- Open
/demo. The first screen shows $190 short on Friday and Ask Alex to pay by Thursday.
- Preview Jamie only, Alex only, both, and Alex arriving Monday. Friday closes at −$110, +$50, +$130, and −$190.
- Open Alex’s invoice, select the mixer tap, and confirm the transcript highlights “$110” while the photo circles the tap and points to it.
- Draft the simulated reminder, then open the labeled buyer page.
- Simulate payment. The invoice is paid and Friday’s baseline buffer is $50 under the labeled Thursday availability assumption.
- Start a second job from New job. Replaying Alex’s sample returns the existing INV-024 instead of a second copy.
- 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:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
