jade-game
build a powerful and unique game for upload to a playstore
Comments (0)
Sign in to leave a comment
Project Tasks44
Build Save Progress API
As a player, I want my game progress saved automatically so that I never lose my level completion history or earned items. Implement FastAPI endpoints for creating, updating, and retrieving player progress records using MySQL for relational progress data and MongoDB for flexible checkpoint state blobs.
Build Player Management API
As an admin, I want API endpoints to list, search, filter, and update player accounts so that I can manage the player base efficiently. Implement FastAPI CRUD endpoints for player profiles, account status updates, and role assignments backed by MySQL.
Build System Settings API
As an admin, I want API endpoints to read and write platform configuration settings so that system behavior can be adjusted without a deployment. Implement FastAPI endpoints for feature flag management, game parameter tuning, and notification rule configuration stored in MySQL.
Build Multiplayer Session API
As a player, I want to create and join multiplayer sessions so that I can play with others in real time. Implement FastAPI WebSocket and REST endpoints for session creation, joining, player sync, and session termination. Use MongoDB for flexible session state storage.
Build Dynamic Visuals Generation Service
As a player, I want game environments and crystal visuals to update dynamically based on my level and actions so that the game world feels alive. Implement a FastAPI service that calls Google Nano Banana API via Langchain for procedural visual asset generation, caches results in MongoDB, and returns asset URLs to the client.
Implement Role-Based Access Control
As a system, I want admin and player roles enforced at both API and UI routing levels so that players cannot access admin screens and unauthenticated users cannot access protected routes. Add FastAPI role middleware and React Navigation auth guards aligned to existing login/auth.
Implement Global Theme Structure
As a developer, I want to establish the global theme system so that all pages consistently reflect the Jade Green, Midnight Blue, and Gold color palette defined in the design pages. This includes setting up shared style constants, typography scales, spacing tokens, and reusable component primitives (buttons, cards, inputs) that match the v2 design mock pages exactly.
Build Player Preferences API
As a player, I want my game customization preferences saved to the server so that my settings persist across devices and reinstalls. Implement FastAPI endpoints for reading and writing player preference documents stored in MongoDB.
Build Game Logic API
As a player, I want the game engine to process my moves and return updated game state so that gameplay is consistent and fair. Implement FastAPI endpoints for level initialization, move validation, score calculation, and level completion detection backed by MySQL for structured game state.
Build Analytics Data Pipeline
As an admin, I want gameplay and player behavior events aggregated into analytics so that I can generate meaningful reports. Implement event ingestion endpoints in FastAPI, store raw events in MongoDB, and aggregate into MySQL summary tables for dashboard queries.
Build Dashboard Summary API
As an admin, I want a dedicated dashboard summary endpoint that returns all KPI metrics in a single response so that the dashboard loads quickly without multiple round trips. Aggregate active sessions, new players, daily completions, and system health into one FastAPI response.
Apply RBAC Guards to Frontend Routes
As a system, I want the frontend to redirect unauthorized users away from admin screens so that role boundaries are enforced at the UI layer. Implement route guard HOCs in React Native navigation that check user role from auth context and redirect appropriately.
Build Shared UI Component Library
As a frontend developer, I want a shared component library aligned to design mock pages so that all screens can import consistent navigation bars, modals, icon sets, and layout wrappers that are visually identical to the v2 design pages. Includes header, footer, bottom nav, and common overlay components.
Integrate AI Hint Engine Backend
As a player, I want contextual hints powered by GPT 5.2 to appear when I am stuck so that I can progress without frustration. Implement a FastAPI hint service that accepts current game state, calls GPT 5.2 via Langchain and Litellm, and returns a relevant hint string with caching to minimize latency and cost.
Configure API Rate Limiting and Security
As a DevOps engineer, I want rate limiting on all public FastAPI endpoints and security headers configured so that the backend is protected against abuse and common web vulnerabilities. Implement slowapi rate limiter, CORS policy, and HTTP security header middleware.
Build Analytics Query API
As an admin, I want REST API endpoints that return aggregated analytics data with date range and dimension filters so that the analytics UI can render accurate charts and export reports. Includes endpoints for active players, session counts, level completion rates, and revenue metrics.
Implement Home Page UI
As a player, I want a home screen that shows options to start a game, open settings, or join multiplayer so that I can navigate the app intuitively after launch. The page must match the Home (v2) design exactly, including hero section, quick-action buttons, and player status indicators.
Implement Launch Page UI
As a player, I want to see an interactive jade crystal universe on the launch page so that I am immersed in the game world from the first moment I open the app. The page must match the Launch (v2) design exactly, including crystal animation placeholder, branding, and entry CTA.
Implement Results Page UI
As a player, I want to see my score, stats, and progression summary after completing a level so that I can track my performance and decide my next action. Must match Results (v2) design including score breakdown, badges earned, replay and next-level CTAs.
Implement Admin Analytics Page UI
As an admin, I want an analytics page with charts and exportable reports so that I can analyze player behavior and game performance trends. Must match Analytics (v2) design including date range filters, multi-series charts, data tables, and export controls.
Implement Admin Players Page UI
As an admin, I want a players management screen so that I can monitor player accounts, view profiles, and take account actions. Must match Players (v2) design including searchable player table, status badges, account action menus, and detail drawer.
Implement Game Page UI
As a player, I want the game screen to render the active level with all interactive elements so that I can play without UI friction. Must match the Game (v2) design including level layout, score display, hint trigger button, pause control, and progress indicators.
Implement Player Settings Page UI
As a player, I want a settings screen where I can customize game preferences so that my experience matches my play style. Must match Settings (v2) design including audio toggles, visual theme options, notification preferences, and account management links.
Implement Login Page UI
As an admin or player, I want to see a polished login screen so that I can authenticate securely with a UI that matches the Login (v2) design page exactly. Includes email/password fields, branding, error states, and loading indicators.
Implement Multiplayer Page UI
As a player, I want a multiplayer lobby screen where I can browse and join active sessions so that I can compete or collaborate with others. Must match Multiplayer (v2) design including session list, join/create session buttons, player count indicators, and real-time status badges.
Implement Admin Dashboard Page UI
As an admin, I want a dashboard overview screen showing key metrics so that I can monitor the platform health at a glance. Must match Dashboard (v2) design including KPI cards, player activity chart, recent events feed, and navigation to sub-sections.
Implement Admin Settings Page UI
As an admin, I want a system settings screen so that I can configure platform-level options such as feature flags, game parameters, and notification rules. Must match Settings (v2) admin variant design including category tabs, toggle controls, and save/discard actions.
Integrate Player API with Players Page
As an admin, I want the Players page to reflect live account data so that I can take informed actions on player accounts. Connect Players (v2) UI to player management API including search, filter, pagination, and account action flows.
Integrate Preferences API with Player Settings Page
As a player, I want my customization choices on the Settings page to save instantly and reload on next visit so that I do not need to reconfigure each session. Wire Settings (v2) player UI to preferences API with optimistic toggle state and error rollback.
Integrate Analytics API with Analytics Page
As an admin, I want the analytics page to display live aggregated data with working filters and CSV export so that I can derive insights without manual data pulls. Wire Analytics (v2) UI to analytics query API including chart data binding, filter controls, and export trigger.
Integrate Multiplayer API with Lobby UI
As a player, I want the multiplayer lobby to show live session data and allow me to join instantly so that the experience feels real-time. Wire Multiplayer (v2) UI to session API including WebSocket connection management, session list polling, and join/leave actions.
Integrate Dashboard API with Dashboard Page
As an admin, I want the dashboard to auto-refresh with live KPI data so that I have an up-to-date operational view at all times. Wire Dashboard (v2) UI to the summary API with polling, skeleton loading states, and error fallbacks.
Integrate Game API with Game Page
As a player, I want my in-game actions to reflect real backend state so that the game is responsive and accurate. Wire the Game (v2) UI to the game logic API including move submission, state polling, and error handling.
Implement Launch Crystal Animation
As a player, I want the jade crystal on the launch page to animate interactively so that the experience feels dynamic and engaging before entering the game. Integrates Google Nano Banana dynamic visual API for crystal rendering and motion effects matching the v2 design.
Implement Admin Dashboard Navigation Shell
As an admin, I want a persistent side navigation on the admin section so that I can move between Dashboard, Analytics, Players, and Settings without losing context. Implement admin navigation shell in React Native with route highlighting matching Dashboard (v2) layout.
Implement Home Page Navigation Routing
As a player, I want all Home page CTAs (Start Game, Settings, Join Multiplayer) to navigate to the correct screens so that the core player flow works end to end. Implement React Navigation routing from Home (v2) to Game, Settings, and Multiplayer screens with correct parameter passing.
Integrate Launch Page to Home Navigation
As a player, I want tapping the CTA on the Launch page to navigate me to the Home screen so that the entry flow is seamless. Wire Launch (v2) entry button to Home screen route and handle transition animation consistent with the design.
Integrate Settings API with Admin Settings Page
As an admin, I want changes made in the Settings page to persist immediately so that configuration updates take effect without manual steps. Wire Settings (v2) admin UI to system settings API including optimistic updates, validation feedback, and save confirmation.
Integrate AI Hints into Game UI
As a player, I want to tap a hint button during gameplay and receive an AI-generated hint overlaid on screen so that I get help in context without leaving the game. Wire the hint trigger in Game (v2) UI to the hint API with loading state, hint display modal, and usage count tracking.
Integrate Dynamic Visuals into Game Page
As a player, I want the game environment visuals to update dynamically as I progress through levels so that each stage feels visually distinct. Wire Game (v2) UI to the dynamic visuals service, handle asset URL rendering, and implement graceful fallback to static assets on API failure.
Integrate Save Progress into Game Flow
As a player, I want progress saved seamlessly during and after gameplay so that my achievements persist across sessions. Connect save progress API calls to game completion events in the Game and Results screens.
End-to-End Admin Flow Validation
As a Tech Lead, I want a full walkthrough of the admin journey from Login through Dashboard to Settings validated against v2 designs so that all admin screens are connected with real data and role protection is enforced. Covers Login → Dashboard → Analytics → Players → Settings cycle.
Wire Results Page to Game Outcome Data
As a player, I want the results screen to display my actual score, time, hints used, and badges earned from the completed level so that I see accurate performance data. Connect Results (v2) UI to game completion API response and progress save confirmation.
End-to-End Player Flow Validation
As a Tech Lead, I want a full walkthrough of the player journey from Launch through Game to Results validated against the v2 designs so that we confirm all screens connect correctly with real data before release. Covers Launch → Home → Game → Save → Results → Home cycle.
No comments yet. Be the first!