
SoCap Solar Platform
Multi-tenant SaaS for solar financing: 3 interconnected apps (Marketing, Portal, Admin), 43 database migrations, 204 React components, 15,758 lines of server actions. Figure API loan integration, Svix webhook management, Stack Auth multi-app authentication. Milestone-based project workflow (M0-M3) with document approval and payout management.
Enterprise Solar Financing & Project Management Platform
SoCap Solar is a comprehensive multi-tenant SaaS platform for managing solar installation projects and financing. The ecosystem consists of three independent Next.js applications working together to serve contractors, homeowners, and SoCap administrators.
🏗️ Platform Architecture
Marketing Website: Public-facing landing pages with contractor onboarding forms, product comparisons, and email notifications via React Email + Resend.
Organization Portal: Contractor management system with multi-tenant project management, document versioning, financial calculators, and team role-based access (org admin, sales manager, sales rep).
Admin Backoffice: SoCap internal management portal with organization onboarding, cross-organization project oversight, approval queues, and payout management.
📊 Milestone Workflow System
M0 - Project Start: Initial customer information, property details, and financing application
M1 - Notice to Proceed: Document collection, utility bill verification, loan approval
M2 - Install Complete: Installation documentation, photo verification, inspection scheduling
M3 - PTO + Audit: Permission to operate, final audit, payout processing
💰 Financial Integration
- Figure API Integration: Direct HELOC loan application workflow with real-time status tracking
- Multiple Product Types: Prepaid PPA, PPA Loan, PPA+, PPA+ Loan with different financing structures
- Payout Management: Eligibility calculations, commission tracking, and payment processing
- Financial Calculators: Customer savings analysis, contractor cost breakdown, and ROI comparisons
🔧 Technical Highlights
Scale & Quality:
- 204 React components (atomic design)
- 15,758 lines of server action logic
- 20+ Supabase database tables
- 86 documentation files
Modern Stack:
- Next.js 15.5.9, React 19
- TypeScript strict mode
- Stack Auth v2.8+ authentication
- Tailwind CSS v4 + shadcn/ui
📱 Key Features
- Document Management: Versioning, photo categorization, PDF contract generation, signature workflows
- Approval Workflows: Multi-stage approval queues with audit trails and compliance tracking
- Kanban Boards: Drag-and-drop project management with TanStack Table v8.21
- Real-time Activity Feeds: Live updates on project changes, approvals, and team actions
- Email Notifications: Automated notifications via React Email + Resend
🔐 Security Model
Endpoint-Level Authorization: Server-side authorization on all API routes rather than RLS
Multi-Tenant Isolation: Organization data completely separated in queries
Full Audit Logging: IP address, user agent, and action tracking for compliance
Production-Grade Platform: This project demonstrates enterprise SaaS development capabilities including complex domain modeling (solar financing), third-party API integration (Figure loans), and comprehensive documentation (86 files). The atomic design component system and server actions architecture showcase modern full-stack patterns.