Overview
FreelanceOS consolidates the client lifecycle into one workspace: quick estimates expand into structured AI proposals, contracts are scanned for legal red flags, invoices render server-side as themed PDFs, and a health score quantifies client reliability from real payment latency.
Problem & Context
Freelancers lose billable hours to fragmented admin work — writing bespoke proposals, reviewing risky client contracts, chasing invoices, and having no clear view of which clients pay late.
Key Capabilities
- AI proposal generation with section-by-section regeneration
- Contract red-flag scanner over uploaded PDFs
- Themed server-side PDF invoicing with tax calculation
- Client CRM with 0–100 health scoring
- Hourly cron-driven payment reminders and follow-ups
- Purchasing-power-parity pricing (INR / USD)
Engineering Notes
Server-side multi-tenant context derivation
getOrgContext cross-references the authenticated user against Membership records on every request, eliminating IDOR by never trusting a client-supplied org id.
Atomic AI quota accounting
Add-on credits decrement via conditional SQL and base-plan usage runs inside Serializable transactions, preventing concurrent overdrafts.
Serverless PDF pipeline
@react-pdf/renderer streams documents to storage as signed URLs, avoiding headless-browser cold-start cost.
Idempotent payment ledger
A unique constraint on processed order ids plus capture verification blocks replay and double-crediting on webhooks.
Verified in the Repository
Facts below are verified in the project's source repository (static code audit). They are not runtime or business metrics.
- 33 automated tests across 6 suites; 0 TypeScript errors across 185 files
- Production build compiles 62 routes
- 15 Prisma models with 45+ composite indexes
- All AI actions run on Groq llama-3.3-70b-versatile
Current Status & Limitations
MVP · Release Candidate.
- Agency plan is capped at three team seats.
- Contract signing is manual; native e-signature is planned for v2.
- The payments summary sums records without cross-currency FX conversion.
Tech Stack
Links & Availability
Source repository and demo access are shared during technical discovery.