bdc61b4e2f
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>
60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
# Paper Dynasty Database API
|
|
|
|
FastAPI backend for baseball card game data. Peewee ORM with PostgreSQL.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
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
|