How saijaku0/sneakers-shop-saas works
Sneakers Shop is an educational full-stack sneaker-store MVP. Its main journey is registration, browsing and filtering the catalog, viewing a product, managing a cart, checking out with inventory reservation, and viewing order details or history. The backend separates API, application use cases, domain rules, and persistence; the Next.js frontend presents the shopping and account flows. README statements support the main journey and checkout coordination; sampled source confirms query and authentication behavior. Several feature implementations were not sampled, so their internal links are documented at subsystem level.
Main entry points: Controllers HTTP controllers · api API client · IApplicationDbContext.cs Read context · app Next.js app
Components 21
Storefront
- Next.js app
web/src/app - Registration wizard
web/src/features/registration-wizard - Catalog browsing
web/src/widgets/catalog-route - Catalog filters
web/src/features/catalog-filters - Product details
web/src/features/product-detail - Cart
web/src/entities/cart - Checkout wizard
web/src/features/checkout-wizard - Order views
web/src/widgets/order-history - API client
web/src/shared/api
Backend API
- HTTP controllers
backend/src/SneakersShop.API/Controllers
Application use cases
- Authentication
backend/src/SneakersShop.Application/Auth - Catalog queries
backend/src/SneakersShop.Application/Catalog/Queries - Cart operations
backend/src/SneakersShop.Application/Carts - Checkout orchestration
backend/src/SneakersShop.Application/Orders/Command/CreateOrder - Order queries
backend/src/SneakersShop.Application/Orders/Queries - Profile operations
backend/src/SneakersShop.Application/Profiles - Read context
backend/src/SneakersShop.Application/Abstractions/ApplicatonDbContext/IApplicationDbContext.cs
Commerce domain
- Commerce aggregates
backend/src/SneakersShop.Domain
Persistence and identity
- PostgreSQL store
backend/src/SneakersShop.Infrastructure/Persistence/AppDbContext.cs - Identity and tokens
backend/src/SneakersShop.Infrastructure/Persistence/Auth/AuthenticationService.cs
Other components
- Shopper
Connections 30
- Shopper → Next.js app: uses
README.md - Next.js app → Registration wizard: registers through
README.md - Registration wizard → API client: submits registration
README.md - Next.js app → Catalog browsing: browses
README.md - Catalog browsing → Catalog filters: filters listings
README.md - Catalog browsing → API client: requests catalog
README.md - Next.js app → Product details: opens product
README.md - Product details → API client: requests details
README.md - Shopper → Cart: manages cart
README.md - Cart → API client: updates cart
README.md - Shopper → Checkout wizard: checks out
README.md - Checkout wizard → API client: places order
README.md - Shopper → Order views: views orders
README.md - Order views → API client: requests orders
README.md - API client → HTTP controllers: calls API
- HTTP controllers → Authentication: dispatches auth
backend/src/SneakersShop.API/Controllers/AuthController.cs - HTTP controllers → Catalog queries: dispatches catalog
- HTTP controllers → Cart operations: dispatches cart
- HTTP controllers → Checkout orchestration: dispatches checkout
- HTTP controllers → Order queries: dispatches order queries
- HTTP controllers → Profile operations: dispatches profile
- Catalog queries → Read context: queries data
backend/src/SneakersShop.Application/Catalog/Queries/GetProducts/GetProductsQueryHandler.cs - Cart operations → Read context: reads cart view
backend/src/SneakersShop.Application/Carts/Queries/GetCart/GetCartQueryHandler.cs - Order queries → Read context: reads order views
backend/src/SneakersShop.Application/Orders/Queries/GetOrderById/GetOrderByIdQueryHandler.cs - Profile operations → Read context: reads profile
backend/src/SneakersShop.Application/Profiles/Queries/GetDefaultAddress/GetDefaultAddressQueryHandler.cs - Authentication → Identity and tokens: authenticates users
backend/src/SneakersShop.Infrastructure/Persistence/Auth/AuthenticationService.cs - Checkout orchestration → Commerce aggregates: coordinates checkout
README.md - Checkout orchestration → PostgreSQL store: commits transaction
README.md - Read context → PostgreSQL store: reads entities
- Identity and tokens → PostgreSQL store: persists identity
backend/src/SneakersShop.Infrastructure/Persistence/Auth/AuthenticationService.cs