akadmin
e9f5377e0a
- Added MTGOnlineGame, GamePlayer, GameHistory models - Implemented full game CRUD endpoints (create, list, get, join, leave, start, end) - Integrated WebSocket game server with database persistence - Added Commander deck validation service (100-card min, color identity, ban list) - Created Alembic migration 006 for new game tables - All game endpoints now database-backed (no more stubs)
85 lines
4.9 KiB
JSON
85 lines
4.9 KiB
JSON
{
|
|
"context": {
|
|
"project_summary": "MTG Online backend API — a FastAPI/SQLAlchemy application for managing MTG card decks, user accounts, game replays, and social features. Uses PostgreSQL with a separate mtg_data database for canonical card/set data.",
|
|
"roadmap": [
|
|
{"phase": "1", "status": "completed", "description": "Architecture simplification: unified database config, security, settings"},
|
|
{"phase": "2", "status": "completed", "description": "Model consolidation: 10+ files → 2 (models.py, mtg_models.py)"},
|
|
{"phase": "3", "status": "completed", "description": "Router consolidation and cleanup: 54+ files → 37 files"},
|
|
{"phase": "4", "status": "completed", "description": "Docker packaging (Dockerfile, docker-compose.yml)"},
|
|
{"phase": "5", "status": "pending", "description": "Core game engine implementation (Commander focus)"}
|
|
],
|
|
"tech_stack": ["Python 3.12", "FastAPI", "SQLAlchemy 2.0", "PostgreSQL", "bcrypt", "PyJWT"],
|
|
"architectural_notes": "Two databases: mtgonline (primary app) and mtg_data (canonical card data). Models use string-based back_populates for cross-file relationships. Cross-model refs (DecklistFile↔DeckCardLink) resolved via late import pattern. Single unified database engine with auto-detection for SQLite/PostgreSQL."
|
|
},
|
|
"working": {
|
|
"task_description": "Phase 5: Core game engine implementation - ready to begin (all game endpoints are stubs, no game models exist)",
|
|
"current_step": "Phase 5 pending. Game endpoints are mocks/stubs. No MTG OnlineGames model exists. WebSocket server exists but not integrated with database.",
|
|
"files_created": [
|
|
"backend/run.py (simple startup script)",
|
|
"backend/app/core/config.py (configuration management)",
|
|
"backend/app/core/logging.py (logging configuration)",
|
|
"backend/app/routers/auth_router.py (consolidated auth)",
|
|
"backend/app/routers/users_router.py (consolidated users)",
|
|
"backend/app/routers/decks_router.py (consolidated decks)",
|
|
"backend/app/routers/cards_router.py (consolidated cards)",
|
|
"backend/app/routers/user_data_router.py (consolidated user data)",
|
|
"backend/app/routers/games_router.py (consolidated games/rooms/websocket)",
|
|
"backend/app/routers/admin.py (admin functions)",
|
|
"backend/SIMPLIFICATION_SUMMARY.md (documentation)"
|
|
],
|
|
"files_modified": [
|
|
"backend/app/main.py (updated router registrations)",
|
|
"backend/app/core/database.py (unified engine, backward compat aliases)",
|
|
"backend/app/core/redis_client.py (use config instead of settings)",
|
|
"backend/app/core/security.py (updated imports)",
|
|
"backend/app/routers/__init__.py (updated exports)",
|
|
"backend/app/schemas/__init__.py (removed stale imports)",
|
|
"backend/app/services/__init__.py (removed stale imports)",
|
|
"backend/app/services/card_search_service.py (updated model imports)",
|
|
"backend/app/services/deck_manager.py (updated model imports)",
|
|
"backend/app/services/deck_suggestion_service.py (updated model imports)",
|
|
"backend/app/services/import_batch_processor.py (updated model imports)"
|
|
],
|
|
"files_deleted": [
|
|
"backend/app/routers/auth.py",
|
|
"backend/app/routers/users.py",
|
|
"backend/app/routers/decks.py",
|
|
"backend/app/routers/card_router.py",
|
|
"backend/app/routers/interactions.py",
|
|
"backend/app/routers/user_data.py",
|
|
"backend/app/routers/rooms.py",
|
|
"backend/app/routers/refresh.py",
|
|
"backend/app/routers/card_import.py",
|
|
"backend/app/routers/ws.py",
|
|
"backend/app/routers/games/router.py",
|
|
"backend/app/core/logging_config.py",
|
|
"backend/app/core/settings.py",
|
|
"backend/app/schemas/proto_messages.py",
|
|
"backend/app/schemas/protocol_constants.py",
|
|
"backend/app/services/card_mirror_service.py",
|
|
"backend/app/services/mtgjson_loader.py",
|
|
"backend/app/services/mtgjson_uploader.py"
|
|
],
|
|
"decisions": [
|
|
"All 11 old router files removed, replaced with 6 consolidated routers",
|
|
"Duplicate core files (logging_config.py, settings.py) removed",
|
|
"Unused services removed (card_mirror_service, mtgjson_loader, mtgjson_uploader)",
|
|
"Unused schemas removed (proto_messages, protocol_constants)",
|
|
"Created run.py for simple startup: python3 run.py",
|
|
"SQLite by default for development, PostgreSQL via DATABASE_URL",
|
|
"All model imports updated to use consolidated app.models.models",
|
|
"Backward compatibility aliases added to database.py for old import paths"
|
|
],
|
|
"next_steps": [
|
|
"Create MTG OnlineGames, GamePlayer, GameHistory models in app/models/mtg_models.py",
|
|
"Implement real game CRUD endpoints (replace stubs in games_router.py)",
|
|
"Integrate WebSocket game server with database",
|
|
"Implement Commander deck validation logic",
|
|
"Write unit tests for game services"
|
|
],
|
|
"blockers": null,
|
|
"commit_hash": "0e6506d",
|
|
"timestamp": "2025-08-27T04:45:00Z"
|
|
}
|
|
}
|