27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# 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 |
|