Inspiration

Extra work often starts with a short message: “Can you also redesign the mobile version?” The price gets discussed, the client approves it, and the conversation moves on. By the time a freelancer prepares the invoice, that approval can be buried under a dozen other messages.

That creates two problems: approved work can go unbilled, and a quote can be mistaken for permission to charge. I wanted to make that moment easier to review, for both the freelancer and the client. ScopeProof brings the agreement, the conversation, and the invoice into one workflow.

What it does

ScopeProof turns a project brief and a chronological client conversation into a reviewable PayPal invoice.

Gemini proposes line items, classifies them as approved, pending, cancelled, or needing review, and links its decisions to the original source messages. The freelancer can inspect the evidence and decision timeline, choose the approved charges to include, and confirm the recipient before creating an invoice.

The sample makes the distinction concrete:

  • The original landing page costs USD 300.
  • The client explicitly approves a USD 75 mobile redesign.
  • A USD 80 rush-delivery quote remains undecided and stays out of the invoice.
  • The reviewed invoice totals USD 375.
  • If the client later cancels the redesign, a fresh analysis marks it cancelled and reduces the billable total to USD 300.

After review, ScopeProof creates a payable invoice through PayPal Sandbox. The buyer pays on PayPal's hosted checkout, and the freelancer can refresh the invoice status in ScopeProof to retrieve its current state directly from PayPal.

How I built it

The interface uses HTML, CSS, and JavaScript, with a Node.js backend. Gemini 3.1 Flash-Lite returns structured billing proposals with references to numbered source records. The server checks those references and validates proposed amounts against the cited text before presenting the review. It displays the original source text alongside each decision.

PayPal Invoicing v2 handles invoice creation, the buyer invoice link, and status retrieval. SQLite records invoice operations to guard against repeated creation requests. The app also includes a Supabase Auth integration for accounts, while a one-click demo gives judges a direct way to explore the sample workflow.

The working demo runs on Render. Payments in this prototype use PayPal Sandbox test funds.

Challenges I ran into

The hardest part was separating a conversation about money from an actual approval. A client asking what rush delivery would cost has not agreed to buy it. A later cancellation also needs to change the outcome of an earlier approval, and conflicting prices need to remain unresolved until the evidence supports one amount.

Another challenge was keeping the payment step consistent with the review. The selected charges, confirmed recipient, PayPal invoice, and retrieved payment status needed to stay connected. I added validation and repeat-request handling, then tested the flow through an actual Sandbox payment.

Accomplishments I'm proud of

The complete flow works with Gemini and PayPal Sandbox: conversation analysis, source-linked review, human confirmation, invoice creation, checkout, and a verified PAID response back in the app.

I also tested cases beyond the happy path: an unapproved rush quote, a later cancellation, and an approval with conflicting prices. The decision timeline makes those outcomes easier to inspect and explain.

What I learned

Useful AI in a payment workflow needs more than a plausible answer. It needs visible evidence, clear handling of uncertainty, and a review step before an action moves forward. Connecting that review to a payable invoice helped me think about the whole product experience, from the first pasted message to the final payment status.

What's next for ScopeProof

Next, I want to test the workflow with freelancers using realistic, permissioned project conversations. I would use that feedback to improve the review experience and evaluation cases, then add document imports, webhook-based payment updates, and support for more currencies. The goal is to make everyday billing easier to explain and easier to trust.

Built With

Share this project:

Updates

Submission history