How pratik-rahul-bamne/shoet works
ShoeT is a footwear inventory, point-of-sale, purchasing, and demand-forecasting application. Staff and administrators use its React interface to authenticate, manage size-and-colour variants and stock, receive purchases, process sales and returns, and review analytics and reorder recommendations. The frontend calls a FastAPI backend whose endpoint modules own business operations and persist data through SQLAlchemy. The README also advertises device and wearer views, but the supplied tree shows no corresponding backend integration; those are represented as frontend capabilities only. Relationships follow sampled source and the SOURCE INDEX; unsampled behavior is not inferred.
Main entry points: database.py SQL database · App.tsx Application shell · api.ts API client · analytics.py Demand analytics
Components 25
Retail interface
- Application shell
frontend/src/App.tsx - Session context
frontend/src/context/AuthContext.tsx - API client
frontend/src/services/api.ts - Product catalog
frontend/src/views/ProductsView.tsx - Stock management
frontend/src/views/InventoryView.tsx - Purchasing
frontend/src/views/PurchasesView.tsx - Sales and returns
frontend/src/views/SalesPOSView.tsx - Dashboard and forecasts
frontend/src/views/DashboardView.tsx - Devices and wearers
frontend/src/views/DevicesView.tsx
Access control
- Authentication endpoints
backend/app/api/v1/endpoints/auth.py - User administration
backend/app/api/v1/endpoints/users.py - JWT and passwords
backend/app/core/security.py - Request authorization
backend/app/api/deps.py
Retail operations
- Catalog endpoints
backend/app/api/v1/endpoints/products.py - Inventory endpoints
backend/app/api/v1/endpoints/inventory.py - Purchase receiving
backend/app/api/v1/endpoints/purchases.py - Sales and returns
backend/app/api/v1/endpoints/sales.py
Analytics
- Demand analytics
backend/app/api/v1/endpoints/analytics.py
Backend and data
- Product variants
backend/app/models/product.py - Stock and movements
backend/app/models/inventory.py - Sales and returns
backend/app/models/sale.py - Purchase orders
backend/app/models/purchase.py - User records
backend/app/models/user.py - SQL database
backend/app/core/database.py
Other components
- Retail staff
Connections 41
- Retail staff → Application shell: uses
frontend/src/App.tsx - Application shell → Session context: provides session
frontend/src/App.tsx - Application shell → Product catalog: renders
frontend/src/App.tsx - Application shell → Stock management: renders
frontend/src/App.tsx - Application shell → Purchasing: renders
frontend/src/App.tsx - Application shell → Sales and returns: renders
frontend/src/App.tsx - Application shell → Dashboard and forecasts: renders
frontend/src/App.tsx - Application shell → Devices and wearers: renders
frontend/src/App.tsx - Session context → API client: authenticates through
frontend/src/context/AuthContext.tsx - API client → Authentication endpoints: calls
frontend/src/services/api.ts - API client → Catalog endpoints: calls
frontend/src/services/api.ts - API client → Inventory endpoints: calls
frontend/src/services/api.ts - API client → Purchase receiving: calls
frontend/src/services/api.ts - API client → Sales and returns: calls
frontend/src/services/api.ts - API client → Demand analytics: calls
frontend/src/services/api.ts - Authentication endpoints → JWT and passwords: verifies credentials
backend/app/api/v1/endpoints/auth.py - Authentication endpoints → User records: reads and creates
backend/app/api/v1/endpoints/auth.py - Request authorization → User records: loads user
backend/app/api/deps.py - Request authorization → JWT and passwords: validates JWT
backend/app/api/deps.py - User administration → User records: manages
backend/app/api/v1/endpoints/users.py - Catalog endpoints → Product variants: reads and writes
backend/app/api/v1/endpoints/products.py - Inventory endpoints → Stock and movements: reads and writes
backend/app/api/v1/endpoints/inventory.py - Purchase receiving → Purchase orders: records orders
backend/app/api/v1/endpoints/purchases.py - Purchase receiving → Stock and movements: receives stock
backend/app/api/v1/endpoints/purchases.py - Sales and returns → Sales and returns: records sales
backend/app/api/v1/endpoints/sales.py - Sales and returns → Stock and movements: updates stock
backend/app/api/v1/endpoints/sales.py - Demand analytics → Stock and movements: reads stock
backend/app/api/v1/endpoints/analytics.py - Demand analytics → Product variants: reads variants
backend/app/api/v1/endpoints/analytics.py - Demand analytics → Sales and returns: analyzes sales
backend/app/api/v1/endpoints/analytics.py - Authentication endpoints → SQL database: uses session
backend/app/api/v1/endpoints/auth.py - Catalog endpoints → SQL database: uses session
backend/app/api/v1/endpoints/products.py - Inventory endpoints → SQL database: uses session
backend/app/api/v1/endpoints/inventory.py - Purchase receiving → SQL database: uses session
backend/app/api/v1/endpoints/purchases.py - Sales and returns → SQL database: uses session
backend/app/api/v1/endpoints/sales.py - Demand analytics → SQL database: uses session
backend/app/api/v1/endpoints/analytics.py - User administration → SQL database: uses session
backend/app/api/v1/endpoints/users.py - SQL database → Product variants: maps models
backend/app/models/product.py - SQL database → Stock and movements: maps models
backend/app/models/inventory.py - SQL database → Sales and returns: maps models
backend/app/models/sale.py - SQL database → Purchase orders: maps models
backend/app/models/purchase.py - SQL database → User records: maps models
backend/app/models/user.py