mint-dating

As a user, I want to use the Home (Explore) frontend page so that I can navigate to swiping, view my profile rewards, and access the app's core features. Implement based on the existing Home (v3) JSX design. The page should feature a dynamic swipe interface entry point, smooth animations, and navigation to Discovery, Profile/Rewards sections. No community or group features. Follows user flow: Onboarding → Login → Home → Discovery / Profile.

As a user, I want to use the Onboarding (Create Profile) frontend page so that I can set up my profile with photos, bio, interests, and a short voice introduction. Implement based on the existing Onboarding (v1) JSX design. The page should include multi-step form flows, photo upload, interest selection, and voice intro recording UI. No community or group features. Follows user flow: Onboarding → Login.

As a user, I want to use the Login frontend page so that I can sign in to my account and access the app. Implement based on the existing Login (v2) JSX design. The page should include email/phone input, password field, social login options, and navigation to Onboarding for new users. Follows user flow: Onboarding → Login → Discovery. Also used in Admin flow: Login → Dashboard.

As a user, I want to use the backend API for profile creation so that I can save my photos, bio, interests, and voice introduction to the server. Implement FastAPI endpoints for profile creation, photo upload (S3/storage), interest tagging, and voice intro storage.

As a user, I want to use the backend API for swipe-based matching so that my swipe actions are recorded, mutual matches are detected, and daily swipe limits are enforced. Implement FastAPI endpoints for swipe left/right, match detection, daily swipe quota management, and match listing.

As a user, I want to use the backend API for XP points and rewards so that my activity streaks, badge unlocks, and XP accumulation are tracked and served to the frontend. Implement FastAPI endpoints for XP accrual rules, streak tracking, badge assignment, and rewards history.

As a user and admin, I want to use the backend API for safety reporting and content moderation so that users can report/block others and admins can review flags and enforce bans. Implement FastAPI endpoints for report submission, block lists, admin review queue, and enforcement actions (warn, ban, dismiss).

As a user, I want to use the Profile (Edit Profile & Rewards) frontend page so that I can edit my profile details and view my earned XP points, badges, activity streaks, and access premium boost options. Implement based on the existing Profile (v1) JSX design. The page should display profile edit fields, gamification elements like streak counters, badge showcase, XP progress bar, and a call-to-action to upgrade to premium. No community features. Follows user flow: Discovery → Profile → Premium.

As a user, I want to use the AI-driven compatibility suggestions API so that I am shown profiles most compatible with my behavior and preferences. Build an AI matching engine using GPT/Claude via LiteLLM and LangChain to score compatibility based on user profiles, interests, and swipe history.

As a user, I want to use the backend real-time messaging API so that I can send and receive messages, see typing indicators, and react to messages in real time. Implement WebSocket-based chat with FastAPI, message persistence in MongoDB, typing indicator events, and emoji reaction support.

As a user, I want to use the backend API for icebreaker prompts so that I can fetch, send, and receive dynamic icebreaker prompts when starting a new match conversation. Implement FastAPI endpoints to manage prompt templates, serve rotating prompts per profile, and attach prompts to initial match messages.

As a user, I want to use the backend API for premium subscriptions and profile boosts so that I can purchase and activate premium features that increase my profile visibility. Implement FastAPI endpoints for subscription management, payment integration hooks, and boost activation logic.

As an admin, I want to use the backend API for user account management so that I can view all users, ban/unban accounts, and access moderation dashboards. Implement FastAPI admin-only endpoints for user listing, account status management, activity monitoring, and report enforcement.

As a user, I want to use the Discovery (Swipe Profiles) frontend page so that I can swipe left or right on other users based on compatibility. Implement based on the existing Discovery (v1) JSX design. The page should include swipe card UI with smooth bounce animations, color shift on swipe (green for match, red for skip), icebreaker prompt carousel on each profile card, limited daily swipe counter, and micro-interactions on profile elements. No community features. Follows user flow: Login → Discovery → Match / Profile.

As a user, I want to use the Match (View Match) frontend page so that I can view a new match and send an icebreaker prompt to start a conversation. Implement based on the existing Match (v1) JSX design. The page should display the matched profile, present selectable icebreaker prompts, and allow the user to send a custom or preset opening message. No community features. Follows user flow: Discovery → Match → Chat.

As a user, I want to use the Chat (Send Message) frontend page so that I can send and receive real-time messages with typing indicators and reactions. Implement based on the existing Chat (v2) JSX design. The page should include a full chat UI with message bubbles, emoji reactions, typing indicator animation, and message timestamps. No group chat features. Follows user flow: Match → Chat.

As a user, I want to use the Premium (Upgrade Plan) frontend page so that I can subscribe to premium features and boost my profile visibility. Implement based on the existing Premium (v1) JSX design. The page should show subscription tiers, feature comparison, and payment CTA. No community features. Follows user flow: Profile → Premium.

As an admin, I want to use the Dashboard (View Stats) frontend page so that I can see a high-level overview of user activity, reports, and moderation metrics. Implement based on the existing Dashboard (v1) JSX design. The page should include summary cards, recent activity feed, and quick navigation to Users and Reports sections. No community features. Follows admin flow: Login → Dashboard → Users / Reports.

As an admin, I want to use the Users (Manage Accounts) frontend page so that I can view, search, and manage user accounts including suspending users. Implement based on the existing Users (v2) JSX design. The page should include a user list table with search/filter, user detail modal, and suspend/unsuspend actions. No community features. Follows admin flow: Dashboard → Users → Suspend User.

As an admin, I want to use the Reports (Review Flags) frontend page so that I can review flagged content and enforce appropriate actions on reported users or content. Implement based on the existing Reports (v1) JSX design. The page should include a reports queue, flag details panel, and action buttons (warn, ban, dismiss). No community features. Follows admin flow: Dashboard → Reports → Enforce Action.