As an admin I want to be able to use a backend API for managing routes and loading instructions. Implement FastAPI endpoints: GET /routes (list routes), POST /routes (create route with stops in reverse loading order), GET /routes/{id} (route detail with stops and items), PUT /routes/{id} (update loading instructions). Use MySQL for route/stop/item structured data.
As a user I want to be able to use a frontend that matches the Venus-Loading design system exactly. Implement the global color palette (#F5F9FF background, #FFFFFF surface, #2C3E50 text, #FF6F61 accent, #B0BEC5 muted), typography (Inter font family), spacing tokens, button styles, card styles, and shared layout components. Remove any scaffold pages not needed by the project (signup, welcome). This task must be completed before all other frontend page tasks.
As an admin I want to be able to use the Dashboard page to view an overview of loading operations and monitor real-time loading progress. Implement the Dashboard overview section with route summary cards, a live loading progress monitor panel, key stats (stops assigned, items loaded, accuracy %), and navigation links to Routes and Reports pages. Apply Venus-Loading theme.
As a driver I want to be able to use the Home page featuring the 3D Interactive Vehicle Loading Simulator. Implement the designed Home page (v2) based on the existing JSX design including: NavBar, HeroSimulator with 3D vehicle model and color-coded zones (Front/Middle/Back), QuickStatsStrip (Total Stops, Items Scanned, Loading Accuracy, Estimated Load Time), TodaysRouteCard, LoadingProgressPanel, RecentActivityFeed, PlacementZoneLegend, QuickActionsBar (Scan Item, Tag Placement, View Stop Details, Report Issue), CTABanner, and Footer. Page links to Loading List and Stop Detail.
As a driver or admin I want to be able to use the Login page to sign in to Venus-Loading. Implement the Login page with email/password fields, submit button using coral accent (#FF6F61), error state handling, and navigation to Home (driver) or Dashboard (admin) on success. Apply Venus-Loading theme tokens.
As a driver I want to be able to use AI-generated visual loading instructions for each route. Integrate Google Nano Banana model via LangChain to generate visual loading instruction cards per stop (zone diagram overlays, placement guides). Expose a GET /ai/loading-instructions/{route_id} endpoint returning structured instruction data for the 3D simulator and Loading List page.
As a driver I want to be able to use a backend API for scanning items and tagging placement. Implement FastAPI endpoints: POST /stops/{id}/scan (record item scan with barcode, zone validation), POST /stops/{id}/tag (save placement tags Front/Middle/Back, Shelf/Floor, Left/Right), GET /stops/{id}/items (list items with scan and tag status). Store scan logs in MongoDB for unstructured event data.
As a driver I want to be able to use an AI-powered error explanation when an item is placed in the wrong zone during loading. Integrate GPT 5.2 via LangChain to generate user-friendly error messages and corrective guidance when a scan mismatch is detected. Expose a POST /ai/explain-error endpoint that accepts item ID and wrong zone, and returns a natural language explanation in English or Hindi.
As a driver I want to be able to use the Loading List page to view all stops in reverse delivery sequence on a single scrollable screen. Implement the Loading List page with stops listed in reverse order (last delivery first), expandable stop rows showing item count and placement summary, a progress indicator for overall loading completion, a 'Confirm Load Complete' action, and navigation to Stop Detail. Glove-friendly touch targets (min 56px).
As an admin I want to be able to use a backend API to monitor loading progress in real-time. Implement FastAPI endpoints: GET /routes/{id}/progress (overall loading %, per-zone breakdown, items loaded vs total), GET /routes/{id}/activity (recent scan/tag events feed). Support WebSocket or polling for real-time updates on the admin Dashboard.
As an admin I want to be able to use the Reports page to generate and view loading efficiency and error reports. Implement the Reports page with filters (date range, route, driver), summary stats cards (average loading time, error rate, scan accuracy), a data table of route reports, and export options. Navigates from Dashboard.
As an admin I want to be able to use the Routes page to assign routes and configure loading instructions. Implement the Routes page with a route list view, route assignment form, loading instruction configuration (reverse loading order setup, stop sequencing), and status badges. Navigates from Dashboard, links to stop detail configuration.
As a driver I want to be able to use the Stop Detail page to tag item placement and scan items during loading. Implement the Stop Detail page with item list for the stop, quick placement tag selectors (Front/Middle/Back, Shelf/Floor, Left/Right), barcode scan action with confirmation feedback, scan status indicators (Scanned ✓ / Pending), error alerts for wrong zone placement (visual cue + vibration), and navigation back to Loading List.
As an admin I want to be able to use a backend API to generate loading efficiency and error reports. Implement FastAPI endpoints: GET /reports/efficiency (loading time stats, accuracy %, error rates filtered by date/route/driver), GET /reports/errors (scan errors and misplacement log). Aggregate data from MySQL (structured) and MongoDB (scan logs).
As a driver I want to be able to use the Delivery View page to see per-stop loading details (item count, placement, scan status) during active delivery. Implement the Delivery View page displaying stop info summary cards showing item count, placement tags, and scan status (e.g., '2 items — Back, Floor — Scanned ✓'), navigation order, and a confirm delivery action. Navigates from Loading List after load confirmation.
As a user I want to be able to use a fully integrated frontend that fetches real data from backend APIs. Wire all frontend pages (Home, Loading List, Stop Detail, Delivery View, Dashboard, Routes, Reports) to their respective FastAPI endpoints. Implement API service layer, loading/error states, and real-time progress polling or WebSocket connection for Dashboard. Handle auth token passing on all requests.
No page designs yet.
The Design Agent will generate JSX pages automatically after user flows are created.
No comments yet. Be the first!