dg-client-portal

# CLAUDE.md — DigiGrow Client Portal

## Project Overview

DigiGrow Client Portal: a white-label web platform for DigiGrow's website clients (UK tradespeople). Clients use it to view billing, capture leads from their website, and get real-time support — all under the DigiGrow brand.

- **Dashboard**: KPI cards (leads, invoices, tickets) + module navigation tiles
- **Billing Module**: Invoice history, package info, Pay Now links
- **Lead Capture Feed**: Webhook-powered form submissions from client websites
- **Support Module**: Real-time messaging bridged to Discord threads via Redis pub/sub
- **Module Request System**: Clients browse and request additional features

## Common Commands

```bash
# Start all services (dev mode with hot reload)
docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build

# Run database migrations
docker compose exec backend alembic upgrade head

# Create a new migration
docker compose exec backend alembic revision --autogenerate -m "description"

# Frontend dev (if running outside Docker)
cd frontend && pnpm install && pnpm dev

# Backend dev (if running outside Docker)
cd backend && uvicorn app.main:app --reload --port 3000
```

## Tech Stack

- **Backend:** Python 3.12, FastAPI, SQLAlchemy 2.0 (async), Alembic, Pydantic v2, aiosmtplib
- **Bot:** Python 3.12, discord.py 2.x (dedicated support bot)
- **Frontend:** React 18, Vite 5, TypeScript, Tailwind CSS 3, shadcn/ui, Radix UI, TanStack React Query, React Router, Lucide React, Inter font
- **Database:** PostgreSQL 16 + Redis 7
- **Auth:** Passwordless magic link email via custom…