How gurungsh/shopshop works
ShopShop is a .NET e-commerce backend: customers authenticate, browse the catalog, place orders, and receive asynchronous payment outcomes. Ordering checks catalog data, stores orders and outbox events, and publishes events through RabbitMQ; Payment charges through Stripe and publishes results for Ordering to apply. Notification consumes order updates. The README documents these cross-service flows and the Gateway’s proxy role; source excerpts and the index support selected internal links, but unsampled endpoint and consumer wiring is not independently verified.
Main entry points: OrderingService.cs Order management · Program.cs Gateway proxy · AuthService.cs Authentication · PaymentProcessingService.cs Payment processing
Components 24
API Gateway
- Gateway proxy
src/Gateway/Gateway.Api/Program.cs
Identity
- Identity API
src/Services/Identity/Identity.Api/Endpoints/AuthEndpoints.cs - Authentication
src/Services/Identity/Identity.Api/Services/AuthService.cs - Identity database
src/Services/Identity/Identity.Infrastructure/Data/IdentityDbContext.cs - JWT keys
src/Services/Identity/Identity.Api/Security/JwtKeyProvider.cs
Catalog
- Catalog API
src/Services/Catalog/Catalog.Api/Endpoints/ProductEndpoints.cs - Product and category services
src/Services/Catalog/Catalog.Api/Services/ProductService.cs - Catalog database
src/Services/Catalog/Catalog.Infrastructure/Data/CatalogDbContext.cs
Ordering
- Ordering API
src/Services/Ordering/Ordering.Api/Endpoints/OrderEndpoints.cs - Order management
src/Services/Ordering/Ordering.Api/Services/OrderingService.cs - Catalog client
src/Services/Ordering/Ordering.Api/Services/CatalogServiceClient.cs - Ordering database and outbox
src/Services/Ordering/Ordering.Infrastructure/Data/OrderingDbContext.cs - Order event publisher
src/Services/Ordering/Ordering.Api/Messaging/OutboxPublisher.cs - Payment result consumer
src/Services/Ordering/Ordering.Api/Messaging/PaymentEventsConsumer.cs
Events and Payments
- Order event consumer
src/Services/Payment/Payment.Api/Messaging/OrderEventsConsumer.cs - Payment processing
src/Services/Payment/Payment.Api/Services/PaymentProcessingService.cs - Stripe charging
src/Services/Payment/Payment.Api/Services/StripePaymentService.cs - Payment database and outbox
src/Services/Payment/Payment.Infrastructure/Data/PaymentDbContext.cs - Payment result publisher
src/Services/Payment/Payment.Api/Messaging/OutboxPublisher.cs - Order update consumer
src/Services/Notification/Notification.Api/Messaging/OrderEventsConsumer.cs - Notification logger
src/Services/Notification/Notification.Api/Services/NotificationService.cs
Other components
- Customer
- Stripe
- RabbitMQ
Connections 25
- Customer → Gateway proxy: sends requests
README.md - Gateway proxy → Identity API: proxies requests
README.md - Gateway proxy → Catalog API: proxies requests
README.md - Gateway proxy → Ordering API: proxies requests
README.md - Identity API → Authentication: routes auth
- Authentication → Identity database: reads and writes
src/Services/Identity/Identity.Api/Services/AuthService.cs - Authentication → JWT keys: signs tokens
- Catalog API → Product and category services: dispatches requests
- Product and category services → Catalog database: reads and writes
src/Services/Catalog/Catalog.Api/Services/ProductService.cs - Ordering API → Order management: dispatches requests
- Order management → Catalog client: checks products
src/Services/Ordering/Ordering.Api/Services/OrderingService.cs - Order management → Ordering database and outbox: reads and writes
src/Services/Ordering/Ordering.Api/Services/OrderingService.cs - Order management → Order event publisher: records order events
- Order event publisher → RabbitMQ: publishes events
README.md - RabbitMQ → Order event consumer: delivers order events
README.md - Order event consumer → Payment processing: dispatches charges
- Payment processing → Stripe charging: requests charge
- Stripe charging → Stripe: creates payment intents
src/Services/Payment/Payment.Api/Services/StripePaymentService.cs - Payment processing → Payment database and outbox: stores transactions
- Payment database and outbox → Payment result publisher: supplies result events
- Payment result publisher → RabbitMQ: publishes results
README.md - RabbitMQ → Payment result consumer: delivers payment results
README.md - Payment result consumer → Order management: applies outcomes
README.md - RabbitMQ → Order update consumer: delivers order updates
README.md - Order update consumer → Notification logger: logs updates
README.md