artifacts-dashboard/backend/app/api/exchange.py
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

82 lines
2.3 KiB
Python

"""Grand Exchange API router."""
import logging
from typing import Any
from fastapi import APIRouter, HTTPException, Query, Request
from httpx import HTTPStatusError
from app.database import async_session_factory
from app.services.artifacts_client import ArtifactsClient
from app.services.exchange_service import ExchangeService
logger = logging.getLogger(__name__)
router = APIRouter(prefix="/api/exchange", tags=["exchange"])
def _get_client(request: Request) -> ArtifactsClient:
return request.app.state.artifacts_client
def _get_exchange_service(request: Request) -> ExchangeService:
service: ExchangeService | None = getattr(request.app.state, "exchange_service", None)
if service is None:
raise HTTPException(
status_code=503,
detail="Exchange service is not available",
)
return service
@router.get("/orders")
async def get_orders(request: Request) -> dict[str, Any]:
"""Get all active Grand Exchange orders."""
client = _get_client(request)
service = _get_exchange_service(request)
try:
orders = await service.get_orders(client)
except HTTPStatusError as exc:
raise HTTPException(
status_code=exc.response.status_code,
detail=f"Artifacts API error: {exc.response.text}",
) from exc
return {"orders": orders}
@router.get("/history")
async def get_history(request: Request) -> dict[str, Any]:
"""Get Grand Exchange transaction history."""
client = _get_client(request)
service = _get_exchange_service(request)
try:
history = await service.get_history(client)
except HTTPStatusError as exc:
raise HTTPException(
status_code=exc.response.status_code,
detail=f"Artifacts API error: {exc.response.text}",
) from exc
return {"history": history}
@router.get("/prices/{item_code}")
async def get_price_history(
item_code: str,
request: Request,
days: int = Query(default=7, ge=1, le=90, description="Number of days of history"),
) -> dict[str, Any]:
"""Get price history for a specific item."""
service = _get_exchange_service(request)
async with async_session_factory() as db:
entries = await service.get_price_history(db, item_code, days)
return {
"item_code": item_code,
"days": days,
"entries": entries,
}