How mfahim14/auctionsales-frontend works
FairPy Sales is an automotive-auction discovery and wholesale lead-intelligence frontend. Buyers filter inventory, inspect lots, save favorites, and use presets or the FairScout.AI Copilot; account and activity views support ongoing use. Admins manage users, crawler recipes and schedules, scrape runs, and failures. The shown API routes proxy requests to the configured backend, while client API calls attach Cognito tokens. Some pages and feature implementations were not sampled, so their links are included only where the README or source index supports them.
Main entry points: InventoryListPage.tsx Inventory Search · client.ts API Client · session.ts Auth Session · copilot.ts Copilot API
Components 25
Identity and Shell
- Sign In
src/views/public/SignInPage.tsx - Auth Session
src/auth/session.ts - Cognito
- App Shell
src/layouts/AppShell.tsx
Inventory Discovery
- Inventory Search
src/views/app/InventoryListPage.tsx - Filter Query
src/features/inventory/query.ts - Lot Details
src/views/app/InventoryDetailPage.tsx
Buyer Workflows
- Favorites
src/features/inventory/useFavorites.ts - FairScout Copilot
src/components/copilot/CopilotDrawer.tsx - Chat State
src/components/copilot/useCopilotChat.ts - Presets and Watchlists
src/views/app/WatchlistListPage.tsx - Activity History
src/views/app/ActivityPage.tsx - Account
src/views/app/AccountPage.tsx
Administration
- User Management
src/views/admin/UserListPage.tsx - Recipe Management
src/views/admin/RecipePage.tsx - Scrape Runs
src/views/admin/ScrapeRunListPage.tsx - Failure Review
src/views/admin/FailuresPage.tsx
API Platform
- Inventory API
src/api/inventory.ts - Copilot API
src/api/copilot.ts - API Client
src/api/client.ts - Route Proxy
app/api/_proxy.ts
Other components
- Buyer
- Admin
- FairPy Backend
- DynamoDB Sessions
Connections 25
- Buyer → Sign In: signs in
README.md - Sign In → Auth Session: authenticates
src/views/public/SignInPage.tsx - Auth Session → Cognito: uses
src/auth/session.ts - Buyer → Inventory Search: searches lots
README.md - Inventory Search → Filter Query: filters query
src/views/app/InventoryListPage.tsx - Inventory Search → Inventory API: loads inventory
src/views/app/InventoryListPage.tsx - Inventory API → API Client: requests data
src/api/inventory.ts - Inventory Search → Lot Details: opens lot
- Inventory Search → Favorites: saves interest
src/views/app/InventoryListPage.tsx - Buyer → FairScout Copilot: discovers vehicles
README.md - FairScout Copilot → Chat State: manages chat
- Chat State → Copilot API: sends messages
src/components/copilot/useCopilotChat.ts - Copilot API → API Client: requests sessions
src/api/copilot.ts - Copilot API → DynamoDB Sessions: syncs threads
README.md - Buyer → Presets and Watchlists: manages searches
README.md - Buyer → Activity History: reviews history
- Buyer → Account: manages account
- Admin → User Management: manages users
src/views/admin/UserListPage.tsx - Admin → Recipe Management: manages recipes
- Admin → Scrape Runs: reviews runs
- Admin → Failure Review: reviews failures
- API Client → Auth Session: gets token
src/api/client.ts - API Client → Route Proxy: calls API
- Route Proxy → FairPy Backend: forwards requests
app/api/_proxy.ts - App Shell → Auth Session: gates access