storm-game

As a backend developer, I want to implement FastAPI endpoints to start a gameplay session, submit a final score with metadata (distance, coins, power-ups used), and retrieve a player's personal score history so that the game can record and surface run results. Include Alembic migrations for sessions and scores tables and server-side score validation.

As a backend developer, I want to implement FastAPI endpoints for listing all characters (with metadata: name, rarity, cost, unlock status per player), unlocking a character on purchase, and admin CRUD for adding or updating characters so that the store and character select screens are fully data-driven. Include Alembic migrations for the characters and player_characters tables.

As a player or admin, I want to log in with my credentials on a styled login screen so that I can access my account securely. Wire up the existing v1 JSX design to the theme, connect form submission to the auth API, handle error states and loading indicators, and redirect to Home (player) or Dashboard (admin) on success.

As a player, I want to see an animated storm-themed intro splash screen when I launch the app so that I feel immersed in the game world from the start. Wire up the existing v2 JSX design to the theme constants, add animated logo entrance and transition to Home screen after a timed delay or tap.

As a backend developer, I want to implement FastAPI admin-only endpoints for retrieving platform KPI summaries (DAU, new signups, revenue), listing/searching/filtering players, updating player roles and ban status, and exporting user data so that admins can monitor and manage the platform. Protect all routes with an admin role guard middleware.

As a frontend developer, I want to build a performant game loop using React Native's Animated API or react-native-reanimated (requestAnimationFrame-based tick) that drives character position, speed scaling, and frame-by-frame state updates so that the gameplay runs smoothly at 60fps on mobile. Expose a clean game state context consumed by the Gameplay screen HUD.

As a player, I want to browse the main menu on the Home screen so that I can navigate to Character Select, Store, Leaderboard, or start a run. Wire up the v2 JSX design to the theme constants, implement navigation actions for each menu item, and display the player's current coin balance fetched from the profile API.

As an admin, I want to manage characters, deploy game content updates, and toggle feature flags on the Content screen so that I can control the in-game catalog and rollout. Wire up the v1 JSX design to the theme, connect to the admin content API for CRUD on characters and update deployments.

As a frontend developer, I want to implement a procedural tile/segment generation system that spawns and recycles environment chunks (track sections, background layers, foreground obstacles) ahead of the player so that the world feels endless and varied. Implement difficulty scaling based on distance traveled and randomized chunk selection.

As a player, I want to browse and select my character before a run so that I can choose my preferred skin or unlocked character. Wire up the v1 JSX design to the theme, fetch available characters from the characters API, display locked/unlocked states, and persist the selected character to player profile.

As a backend developer, I want to implement FastAPI endpoints for listing the store catalog, processing a character or item purchase (with atomic coin deduction and unlock), and retrieving a player's purchase history so that the in-game economy is enforced server-side. Include Alembic migrations for the store_items and purchases tables and idempotency guards.

As a backend developer, I want to implement FastAPI endpoints to retrieve a paginated global leaderboard, fetch a player's rank, and support weekly/all-time filters so that players can compare scores. Use MySQL window functions or a cached ranking strategy for performance, and include Alembic migrations for leaderboard indexes.

As an admin, I want to view, search, filter, and manage player accounts on the Users screen so that I can handle account issues and monitor user activity. Wire up the v2 JSX design to the theme, connect to the admin users API for listing and updating accounts, support ban/unban and role assignment actions.

As a player, I want to see a real-time HUD during gameplay showing my score, distance, active power-ups, and lives so that I can track my run status. Wire up the v2 JSX design to the theme, integrate with the game loop state, and render dynamic score increments, power-up icons, and pause/resume controls.

As an admin, I want to view a dashboard with key platform statistics (DAU, revenue, active sessions) so that I can monitor the health of the game. Wire up the v2 JSX design to the theme, fetch summary metrics from the admin stats API, render charts and KPI cards, and provide navigation to Users, Content, and Analytics.

As a frontend developer, I want to connect the Leaderboard screen to the live leaderboard API so that players see real ranked scores. Implement API client calls, loading/error states, and auto-highlight of the current player's entry.

As a player, I want to receive contextual tips and tutorial guidance from an AI assistant during onboarding and when I struggle so that I can learn the game faster. Implement a FastAPI endpoint that accepts player context (level, recent deaths, last obstacle type) and queries a GPT model for a short actionable tip, then surface the response in a dismissible overlay on the Gameplay screen.

As a data engineer, I want to build event ingestion endpoints (session start, session end, purchase, level milestone) and aggregation jobs (daily retention, funnel analysis, revenue by date) exposed via FastAPI reporting endpoints so that the Analytics admin screen displays accurate, timely metrics. Include Alembic migrations for events and aggregated_metrics tables.

As a player, I want to see dynamically generated background art and character skin variations that keep the visual experience fresh so that repeat runs feel visually novel. Implement a FastAPI endpoint that calls an image generation API with storm-theme prompts and caches results in object storage, then integrate asset loading into the environment generation system.

As a player, I want to see my final score, distance, and coins earned on the Game Over screen so that I can review my performance and decide to replay or visit the leaderboard. Wire up the v2 JSX design to the theme, call the score submission API, display personal best comparison, and provide navigation to Leaderboard or Character Select.

As a player, I want to browse and purchase characters or power-up bundles in the Store so that I can expand my gameplay options. Wire up the v1 JSX design to the theme, fetch store catalog from the store API, display coin costs and locked/owned states, and handle purchase confirmation with coin balance updates.

As a frontend developer, I want to implement an obstacle spawning system with hitbox-based collision detection so that players can dodge, jump, and slide to avoid objects. Support multiple lane positions, obstacle types (barriers, low beams, moving trains), and collision outcomes (life loss, game over trigger). Integrate with the game loop tick.

As a player, I want to see a ranked leaderboard of top scores so that I can compare my performance with other players globally. Wire up the v1 JSX design to the theme, fetch paginated leaderboard data from the leaderboard API, highlight the current player's rank, and support pull-to-refresh.

As a player, I want to collect power-ups during a run (magnet, shield, score multiplier, hoverboard) that appear in the environment and apply timed effects so that gameplay feels rewarding and dynamic. Implement power-up entity spawning, pickup collision detection, timed effect state management, and HUD indicator updates.

As an admin, I want to view detailed analytics reports (retention, revenue, session length, funnel drop-off) on the Analytics screen so that I can make data-driven decisions. Wire up the v1 JSX design to the theme, fetch aggregated metrics from the analytics API, and render interactive charts with date range filters.

As a DevOps engineer, I want to extend the existing k8s deployment manifests with production-grade configurations (HPA, resource limits, liveness/readiness probes, secrets management) and set up a CI/CD pipeline (GitHub Actions or GitLab CI) for automated build, test, and deploy to the k8s cluster so that releases are safe and automated.

As a QA engineer, I want to write and execute end-to-end tests covering the full player flow (Launch → Login → Home → Character Select → Gameplay → Game Over → Leaderboard → Store) so that regressions are caught before release. Use Detox or Maestro for React Native E2E tests and validate API contracts with pytest integration tests.

As a QA engineer, I want to write and execute end-to-end tests covering the full admin flow (Login → Dashboard → Users → Content → Analytics) so that admin tooling is reliable. Validate role-based access control, data accuracy in charts, and CRUD operations for users and content.

As a tech lead, I want to conduct an architecture review covering API design consistency, React Native game loop performance benchmarks, database query plans, and security posture (JWT expiry, rate limiting, input validation) so that the system is production-ready and scalable before the first public release.