workproof-ai

Tamper-proof visual escrow that replaces subjective inspections with mathematical AI proof for construction contractors

Comment

🛡️ WorkProof AI: Cryptographic Before/After Contractor Milestone Verification

RevenueCat Shipaton 2026 Built for US & India License: MIT TypeScript Vite TailwindCSS

The tamper-proof milestone proof-of-work platform with Ghost Overlay photo matching, on-glass client vector signatures, cryptographic SHA-256 PDF audit certificates, and dual-rail US (Stripe) & India (UPI QR) payment payouts.

💡 The Problem

In the residential renovation and construction industries worldwide:

  • Disputed Milestones: 38% of contractor payment disputes stem from subjective visual disagreements ("this doesn't look straight", "is that the same tile?").
  • Angle Distortion: Technicians struggle to reproduce the exact lighting, framing, and vantage point of the "Before" photo when documenting completion.
  • Payment Delays: Contractors wait an average of 19 days to receive milestone draws while owners physically inspect the premises.
  • Fragmented Global Invoicing: US contractors rely on Stripe/credit card invoices, while Indian contractors and solar installation teams demand instant zero-fee UPI QR codes.

⚡ The Solution: WorkProof AI

WorkProof AI eliminates payment friction by transforming contractor smartphones into cryptographic inspection tools:

  1. Ghost Camera Overlay Viewfinder: Real-time HUD that renders a translucent ghost overlay (adjustable opacity) of the original "Before" photo directly over the live camera feed, ensuring 100% angle and perspective parity.
  2. Cryptographic Proof Watermarking: Every frame is embedded with hardware-level GPS coordinates (latitude, longitude, altitude, accuracy radius), ISO-8601 UTC timestamp, and a SHA-256 cryptographic digest.
  3. Interactive Before/After Split Slider: Seamless dual-layer comparison canvas with smooth touch-drag handle.
  4. Vector Touch Signature Pad: On-glass vector signature capture for homeowners and general contractors with audit trails.
  5. Instant PDF Audit Certificate: Single-click client-side compilation of a tamper-proof A4 certificate ready for banks, insurance adjusters, and government subsidy audits (e.g., US Inflation Reduction Act heat pump rebates, India PM Surya Ghar Muft Bijli Yojana rooftop solar verification).
  6. Dual-Rail Instant Settlement:
    • United States: One-tap Stripe Checkout links.
    • India: Dynamic UPI QR generation (upi://pay?pa=...&am=...) supporting PhonePe, Google Pay, and Paytm.
  7. RevenueCat Paywalls v2 Monetization: Native Pro Contractor subscription tier ($9.99/mo / ₹799/mo) and team fleet tiers unlocked via RevenueCat web/app SDK hooks.

📱 RevenueCat Shipaton 2026 Integration Architecture

WorkProof AI implements RevenueCat Paywalls v2 architecture to power recurring SaaS revenue:

  • Entitlements: pro_features (unlimited certificates, custom branding, high-res PDF exports, multi-crew dispatch).
  • Offerings: default containing monthly and annual subscription packages with localized micro-pricing:
    • US Market: $9.99/month or $89.99/year ($7.50/mo effective).
    • India Market: ₹799/month or ₹6,999/year with regional payment methods.
  • Customer Info Sync: Reactive subscriber state management with instant paywall unlock and restored purchase reconciliation.

🛠️ Technology Stack

  • Frontend & UI: React 19, TypeScript, Vite, Tailwind CSS v4, Lucide Icons, Canvas Confetti.
  • Computer Vision & Graphics: HTML5 Canvas 2D Context, WebRTC MediaStream API, Image Processing Filters.
  • Cryptographic Security: Web Crypto API (crypto.subtle.digest('SHA-256')).
  • Document Engine: jsPDF vector PDF generation.
  • Monetization Engine: RevenueCat Paywall Integration Engine, Stripe SDK simulation, UPI URI generator.
  • Testing: Vitest test suite.

🚀 Quick Start & Submission Setup

1. Start the Backend API Server (FastAPI + SQLite WAL)

cd backend
pip install -r requirements.txt  # Or: pip install fastapi uvicorn sqlalchemy pydantic pytest
python -m uvicorn app:app --host 127.0.0.1 --port 8003 --reload

API docs available at: http://127.0.0.1:8003/docs
Health check: http://127.0.0.1:8003/health

2. Run Backend Automated Test Suite

cd backend
python -m pytest -v test_workproof.py

(15/15 tests passing: cryptographic proof hashing, lien waiver generation, RevenueCat webhooks, Alexa voice intents, SQLite CRUD, scale telemetry)

3. Start Frontend UI

# In the root repository directory
npm install
npm run dev

Navigate to http://localhost:5173 (or http://localhost:5176).

4. Build Optimized Production Bundle

npm run build

🏛️ RESTful CRUD API Endpoints

  • GET /api/jobs: List all contractor jobs with nested milestones.
  • POST /api/jobs: Create new job file.
  • GET /api/jobs/{id}, PUT /api/jobs/{id}, DELETE /api/jobs/{id}: Full CRUD with cascade delete.
  • POST /api/jobs/{id}/milestones: Add new milestone stage.
  • PUT /api/milestones/{id}, DELETE /api/milestones/{id}: Edit or delete milestone stage.
  • POST /api/milestones/{id}/capture: Persist before/after photo, GPS, and SHA-256 integrity hash.
  • POST /api/milestones/{id}/sign: Record on-glass signature and auto-issue statutory lien waiver.
  • POST /api/milestones/{id}/pay: Record instant payout settlement (Stripe/UPI).
  • POST /api/revenuecat/subscribe: Activate Pro Contractor subscription in SQLite WAL database.
  • GET /api/alexa/punchlist, POST /api/alexa/punchlist, PUT /api/alexa/punchlist/{id}, DELETE /api/alexa/punchlist/{id}: Alexa+ voice punch-list CRUD.

👥 Authors & Team

📄 License

This project is open-source under the MIT License.

Built With

Share this project:

Updates