paragon-playground/README.md

# ParagonPlayground — Getting Started

A application harness to explore using Paragon for integrations.

## Prerequisites

- Docker Desktop
- .NET 10 SDK
- Node.js 24+

## Setup

### 1. Generate TLS certificates

```powershell
# Run once to create + trust a local CA and sign a wildcard cert
.\scripts\setup-certs.ps1
```

> **Run this from an elevated (Admin) PowerShell prompt.** `mkcert` needs admin rights to install the CA into the JDK system trust store. Without elevation the OS and browsers still trust the cert, but Java tools will reject it.

This uses [mkcert](https://github.com/FiloSottile/mkcert) (installed automatically if missing). No hosts file entries needed — `*.paragonplayground.localhost` resolves to 127.0.0.1 natively.

### 2. Start infrastructure

```powershell
cd src\ParagonPlayground
docker compose -f docker-compose.dev.yml up -d
```

### 3. Seed data (via CLI)

```powershell
cd src\ParagonPlayground\backend
dotnet run --project src\ParagonPlayground.Cli -- provision seed
```

Or create your own org + user:

```powershell
dotnet run --project src\ParagonPlayground.Cli -- provision org --name "Test Corp" --slug testcorp
dotnet run --project src\ParagonPlayground.Cli -- provision user --email admin@testcorp.com --password s3cret --name "Admin" --org-slug testcorp
```

### 4. Open the app

Navigate to **https://acme.paragonplayground.localhost** and sign in with:

- **Email:** alice@acme.com
- **Password:** password123

## CLI Reference

```powershell
# Run from the backend directory
dotnet run --project src\ParagonPlayground.Cli -- provision org --name "Name" --slug name
dotnet run --project src\ParagonPlayground.Cli -- provision user --email e@x.com --password p --name "User" --org-slug name
dotnet run --project src\ParagonPlayground.Cli -- provision seed
```