garnet-farmers

As a user, I want to be able to use the frontend with consistent color and theme alignment across all pages. Set up global CSS custom properties and design tokens based on the SRD color palette (#F5F5DC background, #FFFFFF surface, #2F4F4F text, #FFA500 accent, #A9A9A9 muted). Configure Inter font family, border-radius conventions, shadow scales, and reusable component styles (buttons, chips, cards). Ensure all scaffold pages inherit the theme before new pages are built.

As a user, I want to be able to use the frontend Signup page to create a new account. Implement the Signup/Create Account page with role selection (Farmer / Buyer), name, phone, regional language preference, and password fields. On successful registration, navigate to the respective Dashboard or Home. Apply garnet-farmers theme with flat illustrated style and regional language selector.

As a farmer or buyer, I want to be able to use the frontend in my regional language. Implement i18n/localization across all pages supporting at least 10 Indian languages: Hindi, Tamil, Telugu, Bengali, Marathi, Kannada, Gujarati, Punjabi, Odia, Malayalam. Add a language selector (globe icon dropdown) in NavBar and Footer. Persist language preference per user session.

As a user, I want to be able to use the frontend Login page to sign in to the platform. Implement the Login page with email/password fields, a sign-in CTA button (solid #FFA500), a link to Signup, and a forgot-password option. The page navigates to Dashboard (Farmer/Buyer) after successful authentication. Apply the garnet-farmers theme and flat illustrated design style. Wire up to existing auth backend.

As a farmer, I want to be able to use the frontend Dashboard page to view an overview of my activity. Implement the Farmer Dashboard with sections: welcome banner, quick stats (active listings, pending bids, eligible schemes count), navigation shortcuts to Schemes, Marketplace (Sell), and Bulk Buy pages. Apply garnet-farmers theme. This page is reached after farmer login and links to Schemes, Marketplace, and Bulk Buy.

As an admin, I want to be able to use the frontend Admin Dashboard page to view platform reports and manage operations. Implement the Admin Dashboard with key metrics (total users, active schemes, transaction volume, bidding activity), navigation to Users, Schemes, and Transactions pages, and report generation CTA. Reached after admin login.

As a farmer, I want to be able to use the frontend Schemes page to browse government schemes I am eligible for. Implement the Schemes page with illustrated scheme cards (flat icon, scheme name, eligibility snippet, 'Explore' CTA), eligibility-based filtering, an illustrated modal/drawer for scheme details, and an 'Add Scheme' flow for Admin users. Regional language support on all scheme content. Linked from Farmer Dashboard and Admin Dashboard.

As an admin, I want to be able to use the frontend Users page to manage farmer and buyer accounts. Implement the Users page with a searchable/filterable user list table (name, role, region, status), user detail view, account activation/deactivation actions, and role assignment. Linked from Admin Dashboard.

As a farmer, I want to be able to use the frontend Bulk Buy page to purchase agricultural products in bulk. Implement the Bulk Buy page with bulk product listings, quantity selectors, bulk pricing tiers, filtering by category and region, and a 'Place Bulk Order' CTA. Also shows a link to Auction for bulk auction items. Reached from Farmer Dashboard.

As an admin, I want to be able to use the frontend Transactions page to monitor all platform transactions and bidding activities. Implement the Transactions page with a filterable transaction log (date, buyer, farmer, product, amount, type), bidding activity feed, export to CSV/PDF, and summary statistics. Linked from Admin Dashboard.

As a buyer or farmer, I want to be able to use the frontend Marketplace page to browse and sell produce. Implement the Marketplace page with a 4-column produce grid (2 on tablet, 1 on mobile), category filter chips (Vegetables, Grains, Fruits, Dairy, Bulk Orders), price and location filters, produce cards with farmer name, price, and auction badge, and a 'Sell Produce' flow for farmers. Links to Product detail page and Auction page.

As an admin, I want to be able to use the backend API for user account management. Build FastAPI endpoints for: list users (with filters), get user detail, update user role/status, deactivate/activate account. Secure endpoints with admin role guard. Backed by MySQL/MariaDB user table.

As a farmer, I want to be able to use the backend API for bulk purchasing of agricultural products. Build FastAPI endpoints for: list bulk products (with pricing tiers), create bulk order, get bulk order status, manage bulk inventory. Integrate with Marketplace and Auction APIs for bulk auction items.

As a buyer, I want to be able to use the frontend Product page to view details of a produce listing. Implement the Product page showing produce image, name, farmer profile, price per unit, location, description, and CTAs: 'Add to Cart' / 'Place Bid' / 'Buy Now'. Links from Marketplace and navigates to Auction or Checkout. Apply garnet-farmers theme with illustrations.

As a farmer or admin, I want to be able to use the backend API for government schemes. Build FastAPI endpoints for: list eligible schemes by farmer profile, get scheme detail, create/update/delete scheme (admin only). Store scheme metadata and illustration references in MongoDB. Include eligibility logic filtering.

As a farmer or buyer, I want to be able to use the backend API for the marketplace. Build FastAPI endpoints for: list produce (with category, price, location filters), get produce detail, create/update/delete listing (farmer), search produce. Store product data and descriptions in MongoDB. Link farmer profile via MySQL.

As a farmer or buyer, I want to be able to use the backend API for real-time auctions and bidding. Build FastAPI endpoints and WebSocket support for: create auction, get active auctions, place bid (with validation), get bid history, auction countdown management. Store bidding history in MongoDB. Integrate with Marketplace listing.

As a farmer or buyer, I want to be able to use the frontend Auction page to place bids on produce. Implement the Auction page with a live auction card widget: product image, current highest bid (large bold ₹ value), animated countdown timer, active bidder count, real-time bid updates, pulsing 'LIVE' indicator, and a 'Place Bid' CTA button. Links from Product detail and Bulk Buy pages.

As a buyer, I want to be able to use the frontend Checkout page to complete a purchase. Implement the Checkout page with order summary, delivery address form, payment method selection (UPI, card, net banking), and order confirmation flow. Secure transaction messaging visible to user. Navigated to from Product detail page after 'Buy Now' action.

As a farmer, I want to be able to use the AI API to generate easy-to-understand scheme illustrations. Integrate Google Nano Banana (image generation model) via LiteLLM to auto-generate flat-design scheme illustrations and produce images. Expose a FastAPI endpoint that returns illustration URLs for scheme cards and marketplace listings.

As a farmer, I want to be able to use the AI API to get help in my regional language. Integrate LiteLLM router with GPT 5.2 and Claude 4.5 Opas via Langchain workflow to power a voice/text assistant that guides farmers through scheme eligibility, marketplace actions, and bidding in their regional language. Expose as a FastAPI endpoint consumed by the frontend assistant widget.

As a buyer, I want to be able to use the backend API for checkout and payment processing. Build FastAPI endpoints for: create order, process payment (UPI/card/net banking integration stub), get transaction history (buyer and admin views), generate transaction reports. Store transaction records in MySQL with encryption for sensitive data.