How draganovik/matterway works
Matterway is a commerce platform spanning a customer storefront, an administration dashboard, and four service-owned APIs. The main customer journey is browsing catalog items, managing a customer cart/account, and placing orders; administrators manage catalog content, customers, and sales. The APIs persist to separate PostgreSQL databases, while Catalog also stores images in S3-compatible RustFS. README documentation establishes the cross-service and browser workflows; sampled source confirms API setup and image-storage behavior, but most feature handlers and Nuxt server routes were not sampled.
Main entry points: Matterway.Customers.Api/Program.cs Customers API · Matterway.AppHost/Program.cs Aspire AppHost · Matterway.Sales.Api/Program.cs Sales API · Matterway.Catalog.Api/Program.cs Catalog API
Components 20
Web applications
- Storefront
src/Matterway.Storefront.Web/app - Checkout routes
src/Matterway.Storefront.Web/server/modules/checkout - Admin dashboard
src/Matterway.Dashboard.Web/app - Catalog admin UI
src/Matterway.Dashboard.Web/app/components/features/catalog
Catalog domain
- Catalog API
src/Matterway.Catalog.Api/Program.cs - Catalog archives
src/Matterway.Catalog.Api/Infrastructure/ImportExport/CatalogArchiveService.cs - Image storage
src/Matterway.Catalog.Api/Infrastructure/Storage/S3/S3ImageStorageService.cs
Commerce services
- Customers API
src/Matterway.Customers.Api/Program.cs - Identity API
src/Matterway.Identity.Api/Program.cs - JWT tokens
src/Matterway.Identity.Api/Infrastructure/Services/AuthToken/JwtTokenService.cs - Sales API
src/Matterway.Sales.Api/Program.cs
Persistence and storage
- Catalog database
src/Matterway.Catalog.Api/Infrastructure/Persistence/CatalogDbComposer.cs - Customers database
src/Matterway.Customers.Api/Infrastructure/Persistence - Identity database
src/Matterway.Identity.Api/Infrastructure/Persistence - Sales database
src/Matterway.Sales.Api/Infrastructure/Persistence - RustFS
Runtime integration
- Aspire AppHost
src/Matterway.AppHost/Program.cs - API service defaults
src/Matterway.ServiceDefaults/AspireServiceDefaults.cs
Other components
- Browser
- Stripe
Connections 33
- Browser → Storefront: uses
README.md - Browser → Admin dashboard: uses
README.md - Storefront → Catalog API: requests
README.md - Storefront → Customers API: requests
README.md - Storefront → Identity API: requests
README.md - Storefront → Sales API: requests
README.md - Admin dashboard → Catalog API: requests
README.md - Admin dashboard → Customers API: requests
README.md - Admin dashboard → Identity API: requests
README.md - Admin dashboard → Sales API: requests
README.md - Catalog admin UI → Catalog API: administers
- Checkout routes → Sales API: coordinates
- Checkout routes → Stripe: charges
- Customers API → Catalog API: calls
README.md - Customers API → Identity API: calls
README.md - Sales API → Customers API: calls
README.md - Catalog API → Catalog database: persists
README.md - Customers API → Customers database: persists
README.md - Identity API → Identity database: persists
README.md - Sales API → Sales database: persists
README.md - Catalog API → Image storage: uses
- Image storage → RustFS: stores images
README.md - Catalog archives → Catalog database: imports exports
- Identity API → JWT tokens: issues tokens
src/Matterway.Identity.Api/Program.cs - Aspire AppHost → Catalog API: configures
src/Matterway.AppHost/Program.cs - Aspire AppHost → Customers API: configures
src/Matterway.AppHost/Program.cs - Aspire AppHost → Identity API: configures
src/Matterway.AppHost/Program.cs - Aspire AppHost → Sales API: configures
src/Matterway.AppHost/Program.cs - Aspire AppHost → RustFS: starts
src/Matterway.AppHost/Program.cs - Aspire AppHost → Storefront: configures
src/Matterway.AppHost/Program.cs - Aspire AppHost → Admin dashboard: configures
src/Matterway.AppHost/Program.cs - Customers API → API service defaults: configures
src/Matterway.Customers.Api/Program.cs - Sales API → API service defaults: configures
src/Matterway.Sales.Api/Program.cs