How sanjeevandev/hepna_mart works
HEPNA MART is a construction-materials storefront and procurement platform, with a React client and FastAPI backend. Customers browse a catalog, manage shopping and orders, and can use project planning, estimates/BOQs, or wholesale RFQs and quotes; staff have administrative workflows for catalog, stock, orders, and payments. The sampled client shows route ownership and catalog API calls, while backend excerpts show API mounting and wholesale/order service behavior. Most endpoint-to-service wiring and other feature internals were not sampled, so those links are omitted.
Main entry points: App.tsx Client routes · api.ts API client · ShopPage.tsx Catalog browsing · ProjectsDashboardPage.tsx Projects and BOQs
Components 23
Customer storefront
- Client routes
src/App.tsx - Catalog browsing
src/pages/ShopPage.tsx - Cart and checkout
src/pages/CartPage.tsx - Order tracking
src/pages/OrdersPage.tsx - Account and wishlist
src/pages/AccountPage.tsx
Project planning
- Projects and BOQs
src/pages/ProjectsDashboardPage.tsx - Cost estimates
src/pages/CostCalculatorPage.tsx - Construction calculator
src/utils/constructionCalculator.ts
Wholesale procurement
- Wholesale RFQs
src/pages/RFQListPage.tsx - Quotes and approval
src/pages/QuoteDetailPage.tsx
Staff operations
- Admin console
src/pages/admin/AdminOverviewPage.tsx - Order and payment admin
src/pages/admin/AdminOrdersPage.tsx - Catalog and stock admin
src/pages/admin/AdminProductsPage.tsx
Backend platform
- API client
src/lib/api.ts - Catalog adapter
src/services/catalogService.ts - FastAPI application
backend/app/main.py - API v1 router
backend/app/api/v1/router.py - API endpoints
backend/app/api/v1/endpoints - RFQ and quote service
backend/app/services/wholesale_service.py - Order service
backend/app/services/order_service.py - Relational database
backend/app/core/database.py
Other components
- Customer
- Staff user
Connections 22
- Customer → Client routes: uses
- Staff user → Client routes: uses
- Client routes → Catalog browsing: routes to
- Client routes → Cart and checkout: routes to
- Client routes → Order tracking: routes to
- Client routes → Account and wishlist: routes to
- Client routes → Projects and BOQs: routes to
- Client routes → Cost estimates: routes to
- Client routes → Wholesale RFQs: routes to
- Client routes → Quotes and approval: routes to
- Client routes → Admin console: routes to
- Client routes → Order and payment admin: routes to
- Client routes → Catalog and stock admin: routes to
- Catalog browsing → Catalog adapter: loads catalog
- Catalog adapter → API client: requests data
- Projects and BOQs → Construction calculator: calculates materials
- FastAPI application → API v1 router: mounts router
- API v1 router → API endpoints: dispatches routes
- API client → FastAPI application: HTTP requests
- Quotes and approval → API client: quote requests
- RFQ and quote service → Order service: creates accepted-quote order
- API endpoints → RFQ and quote service: handles RFQ routes