# Forgejo Tickets

A customer-facing support ticket system that bridges a web UI with Forgejo issue
tracking. Customers create and manage support tickets through a clean web
interface, while tickets automatically sync to Forgejo repositories as issues
for internal team tracking.

## Quick Start

```bash
cp .env.example .env
# Edit .env with your database URL, session secret, etc.
make build
make run
```

The public server starts on `:8080` and the admin server on `:8081`.

## Documentation

| Topic | Description |
|-------|-------------|
| [Architecture](docs/architecture.md) | Two-server design, directory structure, package responsibilities, request lifecycle |
| [Configuration](docs/configuration.md) | Full environment variable reference with defaults and descriptions |
| [Deployment](docs/deployment.md) | Local dev, Docker, Nomad, Makefile targets, database setup |
| [User Guide](docs/user-guide.md) | Registration, login, tickets, comments, email notifications |
| [Admin Guide](docs/admin-guide.md) | Dashboard, user/ticket/repo management, Tailscale auth |
| [Forgejo Integration](docs/forgejo-integration.md) | Issue sync, comment sync, webhooks, auto-close flow |
| [SSO Integration](docs/SSO_INTEGRATION.md) | JWT SSO with Ed25519 for auto-provisioning users from external apps |