How jainish1510/thread works
THREAD is a fictional direct-to-consumer fashion storefront and commerce API. A shopper browses products, checks stock and transparency details, adds items to a bag, then checks out; the API prices the order, reserves inventory, processes payment, and exposes order tracking. Customers can also manage accounts and use a size finder and plain-language search; staff manage orders, stock, and analytics. The map includes those documented capabilities, but unsampled web components and API routes are connected only where README or indexed source references support the relationship.
Main entry points: orders.py Order services · main.py Commerce API · db.py Commerce database · CheckoutFlow.tsx Checkout flow
Components 26
Storefront
- Storefront routes
apps/web/src/app - Shop browser
apps/web/src/components/shop/ShopBrowser.tsx - Product view
apps/web/src/components/product/ProductView.tsx - Plain-language search
apps/web/src/components/search/SearchPage.tsx - Size finder
apps/web/src/components/fit/FitFinder.tsx - Shopping bag
apps/web/src/store/cart.ts - Checkout flow
apps/web/src/components/checkout/CheckoutFlow.tsx
Commerce API
- Commerce API
services/api/app/main.py - Catalog routes
services/api/app/routers/catalog.py - Authentication
services/api/app/routers/auth.py - Account routes
services/api/app/routers/me.py - Commerce database
services/api/app/db.py - Commerce records
services/api/app/models.py
Orders and inventory
- Order services
services/api/app/services/orders.py - Inventory service
services/api/app/services/inventory.py - Payment service
services/api/app/services/payments.py - Payment webhooks
services/api/app/routers/webhooks.py - Live event broker
services/api/app/events.py - Order tracking
apps/web/src/components/orders/OrderTracking.tsx
Customer and transparency
- Supply chain explorer
apps/web/src/components/transparency/SupplyChainExplorer.tsx - Digital passport
apps/web/src/components/passport/PassportBody.tsx
Admin operations
- Admin routes
services/api/app/routers/admin.py - Admin console
apps/web/src/components/admin/AdminConsole.tsx
Other components
- Shopper
- Stripe
- Redis fan-out
Connections 38
- Shopper → Storefront routes: browses
README.md - Storefront routes → Shop browser: renders
- Shop browser → Catalog routes: loads catalog
- Shopper → Product view: opens product
README.md - Shopper → Plain-language search: searches
README.md - Shopper → Size finder: finds size
README.md - Product view → Catalog routes: loads product
- Product view → Inventory service: checks live stock
- Shopper → Shopping bag: adds items
README.md - Shopping bag → Checkout flow: starts checkout
README.md - Shopper → Checkout flow: submits order
README.md - Checkout flow → Commerce API: requests checkout
README.md - Commerce API → Catalog routes: routes requests
services/api/app/main.py - Commerce API → Authentication: routes requests
services/api/app/main.py - Commerce API → Account routes: routes requests
services/api/app/main.py - Commerce API → Order services: expires reservations
services/api/app/main.py - Commerce API → Commerce database: creates schema
services/api/app/main.py - Catalog routes → Commerce database: queries
services/api/app/routers/catalog.py - Account routes → Commerce database: reads and writes
services/api/app/routers/me.py - Authentication → Commerce database: reads and writes
services/api/app/routers/auth.py - Checkout flow → Order services: creates order
- Order services → Inventory service: reserves stock
services/api/app/services/orders.py - Order services → Payment service: starts payment
- Checkout flow → Stripe: pays
README.md - Payment webhooks → Payment service: verifies event
services/api/app/routers/webhooks.py - Payment webhooks → Order services: transitions order
services/api/app/routers/webhooks.py - Order services → Live event broker: publishes updates
services/api/app/services/orders.py - Inventory service → Live event broker: publishes stock
services/api/app/services/inventory.py - Live event broker → Redis fan-out: fans out
services/api/app/events.py - Shopper → Order tracking: tracks order
README.md - Order tracking → Live event broker: receives updates
- Shopper → Supply chain explorer: explores provenance
README.md - Shopper → Digital passport: opens passport
README.md - Admin console → Admin routes: manages commerce
- Admin routes → Inventory service: updates stock
services/api/app/routers/admin.py - Admin routes → Order services: advances orders
services/api/app/routers/admin.py - Admin routes → Commerce database: queries metrics
services/api/app/routers/admin.py - Commerce records → Commerce database: maps records
services/api/app/models.py