How wildcatdownstairs/mini-store-api works
Mini Store API is an ASP.NET Core e-commerce backend for customer and admin clients, backed by PostgreSQL through a shared EF Core context. The main customer journey is authenticate, browse products, manage a cart, receive a checkout quote, and place an order; operations then cover payment, warehouse fulfillment, delivery, and post-delivery reviews. Admin capabilities include catalog, customer, inventory, coupon, payment/refund, shipping, review moderation, and dashboard operations. Feature endpoints and several service implementations are unsampled, so their internal call wiring is not expanded beyond documented responsibilities and visible dependencies.
Main entry points: Program.cs API composition · StoreDbContext.cs EF Core context · OrderService.cs Order service · CartService.cs Cart service
Components 32
API foundation
- API composition
Program.cs - Authentication
Features/Auth/AuthEndpoints.cs - Auth service
Features/Auth/AuthService.cs
Shopping and orders
- Customer accounts
Features/Customers/CustomerEndpoints.cs - Customer service
Features/Customers/CustomerService.cs - Product catalog
Features/Products/ProductEndpoints.cs - Product service
Features/Products/ProductService.cs - Shopping cart
Features/Carts/CartEndpoints.cs - Cart service
Features/Carts/CartService.cs - Price calculation
Features/Checkout/Pricing.cs - Checkout
Features/Checkout/CheckoutEndpoints.cs - Checkout service
Features/Checkout/CheckoutService.cs - Order management
Features/Orders/OrderEndpoints.cs - Order service
Features/Orders/OrderService.cs
Store operations
- Coupons
Features/Marketing/MarketingEndpoints.cs - Marketing service
Features/Marketing/MarketingService.cs - Inventory
Features/Inventory/InventoryEndpoints.cs - Inventory service
Features/Inventory/InventoryService.cs - Payments and refunds
Features/Payments/PaymentEndpoints.cs - Payment service
Features/Payments/PaymentService.cs - Shipping
Features/Shipping/ShippingEndpoints.cs - Shipping service
Features/Shipping/ShippingService.cs - Product reviews
Features/Reviews/ReviewEndpoints.cs - Review service
Features/Reviews/ReviewService.cs - Admin dashboard
Features/Dashboard/DashboardEndpoints.cs - Dashboard service
Features/Dashboard/DashboardService.cs
Persistence
- EF Core context
Data/StoreDbContext.cs - PostgreSQL
Other components
- Customer
- Admin operator
- Storefront
- Admin frontend
Connections 46
- Storefront → API composition: HTTP requests
- Admin frontend → API composition: HTTP requests
- API composition → Authentication: maps routes
- API composition → Customer accounts: maps routes
- API composition → Product catalog: maps routes
- API composition → Shopping cart: maps routes
- API composition → Checkout: maps routes
- API composition → Order management: maps routes
- API composition → Coupons: maps routes
- API composition → Inventory: maps routes
- API composition → Payments and refunds: maps routes
- API composition → Shipping: maps routes
- API composition → Product reviews: maps routes
- API composition → Admin dashboard: maps routes
- Customer → Storefront: uses
- Admin operator → Admin frontend: uses
- Authentication → Auth service: calls
- Customer accounts → Customer service: calls
- Product catalog → Product service: calls
- Shopping cart → Cart service: calls
- Checkout → Checkout service: calls
- Order management → Order service: calls
- Coupons → Marketing service: calls
- Inventory → Inventory service: calls
- Payments and refunds → Payment service: calls
- Shipping → Shipping service: calls
- Product reviews → Review service: calls
- Admin dashboard → Dashboard service: calls
- Cart service → Price calculation: calculates totals
- Checkout service → Price calculation: calculates quote
- Payment service → Order service: transitions order
- Shipping service → Order service: releases stock
- API composition → EF Core context: configures
- Auth service → EF Core context: reads and writes
- Customer service → EF Core context: reads and writes
- Product service → EF Core context: reads and writes
- Cart service → EF Core context: reads and writes
- Checkout service → EF Core context: reads and writes
- Order service → EF Core context: reads and writes
- Marketing service → EF Core context: reads and writes
- Inventory service → EF Core context: reads and writes
- Payment service → EF Core context: reads and writes
- Shipping service → EF Core context: reads and writes
- Review service → EF Core context: reads and writes
- Dashboard service → EF Core context: reads
- EF Core context → PostgreSQL: queries