How trunghieu104/sneaker-square works
Sneaker Square is a Laravel sneaker-commerce application with a customer storefront and an administrative CMS. The principal customer journey is browsing and filtering products, managing a cart and coupon, placing an order, paying through MoMo or VNPay, and following delivery. Separate capabilities include account and social login, editorial content, admin inventory and order operations, and business reporting. The map reflects README capabilities and the supplied source excerpts; unsampled subsystem wiring is shown only where the product workflow is documented.
Main entry points: Models Commerce Data · PlaceOrderAction.php Order Placement · CartService.php Cart and Pricing · CheckoutRequest.php Checkout
Components 22
Storefront Shopping
- Catalog and Search
app/Http/Controllers/Frontend/ProductController.php - Cart and Pricing
app/Services/CartService.php - Checkout
app/Http/Requests/Frontend/CheckoutRequest.php - Coupon Validation
app/Http/Controllers/Frontend/ProductController.php
Order Fulfillment
- Order Placement
app/Actions/PlaceOrderAction.php - Payment Callback
app/Http/Controllers/Frontend/PaymentCallbackController.php - Gateway Selection
app/Services/Payment/PaymentGatewayManager.php - Shipping Service
app/Services/ShippingService.php - Shipment Updates
app/Http/Controllers/Frontend/ShippingWebhookController.php - Commerce Data
app/Models
Accounts and Content
- Customer Accounts
app/Http/Controllers/Frontend/AuthUserController.php - Social Login
app/Http/Controllers/Frontend/LoginGoogle.php - Blog and CMS
app/Http/Controllers/Frontend/BlogController.php
Administration and Reporting
- Store Management
app/Http/Controllers/Backend/ProductAdminController.php - Order Management
app/Http/Controllers/Backend/OrderAdminController.php - Statistics and Export
app/Services/DashboardStatisticsService.php
External Integrations
- MoMo and VNPay
app/Services/Payment - GHN Carrier
app/Services/Shipping/GhnCarrier.php - Queued Email
app/Services/OrderMailer.php - Mail Service
Other components
- Customer
- Administrator
Connections 23
- Customer → Catalog and Search: browses
- Customer → Cart and Pricing: manages cart
- Cart and Pricing → Coupon Validation: validates coupon
- Customer → Checkout: submits checkout
- Checkout → Order Placement: places order
- Order Placement → Commerce Data: writes order
- Customer → Payment Callback: returns from payment
- Payment Callback → Gateway Selection: verifies callback
- Gateway Selection → MoMo and VNPay: dispatches verification
- MoMo and VNPay → Commerce Data: updates payment
- Administrator → Store Management: manages catalog
- Administrator → Order Management: manages orders
- Order Management → Commerce Data: reads and updates
- Administrator → Statistics and Export: views reports
- Administrator → Blog and CMS: manages content
- Customer → Customer Accounts: registers and signs in
- Customer → Social Login: uses social login
- Customer → Blog and CMS: reads content
- Shipping Service → GHN Carrier: books shipment
- GHN Carrier → Shipment Updates: sends status
- Shipment Updates → Commerce Data: records events
- Order Placement → Queued Email: requests confirmation
- Queued Email → Mail Service: queues email