Hopsworks Managed SaaS Bridge

A Next.js application that manages SaaS users, billing, and cluster access before handing them off to shared Hopsworks environments.

Quick Start

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Run development server
npm run dev

Documentation

• Architecture Overview – System design, SaaS/Hopsworks boundary, and integrations
• Database Documentation – Schema, migrations, and stored procedures
• Billing System – OpenCost ingestion and Stripe metered billing
• Stripe Setup – Stripe products, price IDs, and webhook configuration
• HubSpot Integration – Corporate deal validation and prepaid onboarding
• Resend Integration – Team invite delivery workflow
• API Reference – Endpoints and admin tools
• Deployment Guide – Environment configuration and rollout steps
• Known Issues – Common problems and mitigations

Admin Interface

Access the admin panel at /admin47392 (requires admin privileges).

Environment Variables

See .env.example for required configuration.

Development

npm run dev        # Development server
npm run build      # Production build
npm run lint       # ESLint

Testing

npm run test              # Run all tests
npm run test:watch        # Watch mode
npm run test:regression   # Regression tests only
npm run test:integration  # Integration tests (requires local Supabase)

See Tests Documentation for setup and details.

Deployment

This project is configured for Vercel deployment. See Deployment Guide for details.