Gamify your issue backlog review. Each team member votes on issues (-3 to +3) one at a time, and the results are aggregated into a leaderboard.

• Python 3.11+
• uv (recommended) or pip

# 1. Install dependencies
uv sync            # or: pip install -e .

# 2. Set up environment variables (see below)
#    Create a .env file with the required variables

# 3. Run the app
uv run uvicorn app.main:app --reload --port 8000

Open http://localhost:8000 and sign in with GitHub.

1. Go to GitHub Developer Settings > OAuth Apps (for an org: Settings > Developer settings > OAuth Apps)
2. Click New OAuth App and fill in:
   • Application name: IssueMatch (or anything you like)
   • Homepage URL: http://localhost:8000
   • Authorization callback URL: http://localhost:8000/auth/callback
3. Click Register application
4. On the app page, copy the Client ID
5. Click Generate a new client secret and copy it

Put both values in your .env file as GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET.

Create a .env file in the project root with the following variables:

Issue fetching is done from the Admin panel in the web UI. Admin users can:

1. Navigate to the Admin page
2. Set a GitHub personal access token (stored encrypted, never retrievable)
3. Use the Fetch form to pull issues or pull requests from any GitHub repository by specifying the org, repo, type, and optional label filters

1. Open http://localhost:8000
2. Sign in with your GitHub account
3. A random issue is shown as a card — vote -3 to +3, or skip
4. Each vote loads the next unvoted issue automatically (no page reload)
5. Once you've voted on everything, you'll see an "All done" message

Visit http://localhost:8000/results to see all issues ranked by average score.

Commits follow Conventional Commits via commitizen. Versions are bumped automatically from the commit history.

# 1. Stage your changes and commit with the interactive prompt
uv run --extra dev cz commit

# 2. When ready to release, bump the version (updates pyproject.toml,
#    app/version.py, CHANGELOG.md, runs `uv lock`, commits, and tags)
uv run --extra dev cz bump          # auto-determines bump level
uv run --extra dev cz bump --minor  # force a minor bump

# 3. Push the commit and tag
git push origin main --tags

# 4. Build and push the container image
podman build -t ghcr.io/inknos/issuematch:v<VERSION> -t ghcr.io/inknos/issuematch:latest .
podman push ghcr.io/inknos/issuematch:v<VERSION>
podman push ghcr.io/inknos/issuematch:latest

# 5. Roll out the new image on OpenShift
oc rollout restart deployment/inknos-issuematch
oc rollout restart deployment/inknos-issuematch-dev

Production pins to a tagged image (e.g. :v0); dev uses :latest. See oc/README.md for full deployment details.

Interactive API docs are available at http://localhost:8000/docs (Swagger UI).