Cal Corum bdc61b4e2f ci: switch to tag-based Docker builds

Replace branch/PR-triggered Docker builds with tag-only triggers.
Images are now built only when a CalVer tag is pushed
(git tag YYYY.M.BUILD && git push origin YYYY.M.BUILD).

- Remove calver, docker-tags, and gitea-tag reusable actions
- Add inline version extraction from tag ref
- Add build cache (was missing)
- Update CLAUDE.md: remove stale next-release release workflow

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-23 10:49:23 -05:00

2.5 KiB

Raw Blame History

Paper Dynasty Database API

FastAPI backend for baseball card game data. Peewee ORM with PostgreSQL.

Commands

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000  # Dev server
python main.py                                              # Alt start
python db_migrations.py                                     # Run migrations
docker build -t paper-dynasty-db .                          # Build image

Architecture

Routers: Domain-based in app/routers_v2/ (cards, players, teams, packs, stats, gauntlets, scouting)
ORM: Peewee with PostgreSQL
Card images: Playwright/Chromium renders HTML templates → screenshots (see routers_v2/players.py)
Logging: Rotating files in logs/database/{date}.log

Key Constants

LIVE_CARDSET_ID: 24 (current active cardset, in db_engine.py)
ranked_cardsets: Legal cardsets for ranked play
CARDSETS: Configuration for game modes and card availability

Environments & Troubleshooting

	Dev	Prod
URL	pddev.manticorum.com	pd.manticorum.com
Host	`ssh pd-database`	`ssh akamai` → `/root/container-data/paper-dynasty`
API container	`dev_pd_database`	`pd_api`
PostgreSQL	`pd_postgres` (port 5432)	`pd_postgres`
Adminer	port 8081	—
API port	816	815
Image	`manticorum67/paper-dynasty-database`	`manticorum67/paper-dynasty-database`

Logs

Container logs: docker logs --since 1h pd_api
Log file (in container): logs/database/YYYY-MM-DD.log (date-stamped daily, no rotation)
API docs: /api/docs and /api/redoc

Key Env Vars

API_TOKEN, LOG_LEVEL, DATABASE_TYPE, POSTGRES_HOST, POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD

Common Issues

502 Bad Gateway → API container crashed; check docker logs pd_api
Card image generation failures → Playwright/Chromium issue; check for missing dependencies
DB connection errors → verify POSTGRES_HOST points to correct container name
CI/CD: Gitea Actions on CalVer tag push — builds Docker image and pushes to Docker Hub
Release: git tag YYYY.M.BUILD && git push origin YYYY.M.BUILD → CI builds + pushes image + notifies Discord

Important

Docker image installs only Playwright Chromium (not all browsers) to optimize size
Teams have dynamic card pricing based on market activity
Supports both human players and AI teams
Gauntlet events use special reward structures and card pools

2.5 KiB Raw Blame History