artifacts-dashboard/docs/DEPLOYMENT.md
Paweł Orzech f845647934
Some checks failed
Release / release (push) Has been cancelled
Initial release: Artifacts MMO Dashboard & Automation Platform
Full-stack dashboard for controlling, automating, and analyzing
Artifacts MMO characters via the game's HTTP API.

Backend (FastAPI):
- Async Artifacts API client with rate limiting and retry
- 6 automation strategies (combat, gathering, crafting, trading, task, leveling)
- Automation engine with runner, manager, cooldown tracker, pathfinder
- WebSocket relay (game server -> frontend)
- Game data cache, character snapshots, price history, analytics
- 9 API routers, 7 database tables, 3 Alembic migrations
- 108 unit tests

Frontend (Next.js 15 + shadcn/ui):
- Live character dashboard with HP/XP bars and cooldowns
- Character detail with stats, equipment, inventory, skills, manual actions
- Automation management with live log streaming
- Interactive canvas map with content-type coloring and zoom/pan
- Bank management, Grand Exchange with price charts
- Events, logs, analytics pages with Recharts
- WebSocket auto-reconnect with query cache invalidation
- Settings page, error boundaries, dark theme

Infrastructure:
- Docker Compose (dev + prod)
- GitHub Actions CI/CD
- Documentation (Architecture, Automation, Deployment, API)
2026-03-01 19:46:45 +01:00

830 B

Deployment

Docker Compose (Production)

cp .env.example .env
# Edit .env with production values
docker compose -f docker-compose.prod.yml up -d

Coolify

  1. Connect your GitHub repository in Coolify
  2. Set environment variables in the Coolify dashboard
  3. Deploy — Coolify will build from docker-compose.prod.yml

Environment Variables

Variable Required Description
ARTIFACTS_TOKEN Yes Your Artifacts MMO API token
DATABASE_URL Yes PostgreSQL connection string
CORS_ORIGINS No Allowed CORS origins (JSON array)
POSTGRES_USER Yes PostgreSQL username
POSTGRES_PASSWORD Yes PostgreSQL password
POSTGRES_DB Yes PostgreSQL database name
NEXT_PUBLIC_API_URL Yes Backend API URL for frontend