Better Auth Integration

​

Quick Links

• Quick Start Guide - Get up and running in 5 minutes
• Authentication Module - Authentication architecture and implementation
• Webhook Testing Guide - Testing webhook events
• Role Assignment - How user roles are determined

​

Overview

• ✅ JWT-based user authentication
• ✅ Automatic user sync via NATS events
• ✅ Organization management with multi-tenant support
• ✅ Redis caching for performance
• ✅ PostgreSQL as single source of truth

​

Getting Started

1. Follow the Quick Start Guide
2. Review Authentication Module for detailed architecture
3. Test user sync via NATS events
4. Verify user creation in PostgreSQL

​

Architecture

User Signs Up (Better Auth)
    ↓
user.sync Event (NATS)
    ↓
User Sync Handler
    ↓
SyncUser(authID, email, name, org_id)
    ↓
PostgreSQL User Created/Updated
    ↓
Redis Cache Invalidated

​

Environment Variables

BETTER_AUTH_URL=http://localhost:3100
BETTER_AUTH_SECRET=your_secret_key

​

Other Documentation

• API Documentation (coming soon)
• Database Schema (coming soon)
• Deployment Guide (coming soon)