How kubasamanek/pantrycloud works
PantryCloud is a household and pantry management platform: users interact with its web app, which sends API requests through a YARP gateway to microservices. Those services cover identity, household membership and preferences, pantry inventory, recipes, shopping lists, notifications, and audit history. Services follow Core, Application, Infrastructure, and Presentation layers; the graph highlights application handlers and selected service internals where source was sampled. README-level routing and layering are documented, but most service wiring and persistence details were not sampled, so uncertain connections are omitted or marked unverified.
Main entry points: ServiceCollectionExtensions.cs API gateway · IAuthApi.cs Auth client · PantryCloud.Web Web frontend · AuditController.cs Audit API
Components 23
Client and gateway
- Web frontend
src/Web/PantryCloud.Web - Auth client
src/Web/PantryCloud.Web/Services/Auth/IAuthApi.cs - Token storage
src/Web/PantryCloud.Web/Services/Auth/LocalStorageTokenStorage.cs - API gateway
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs
Household services
- Household API
src/Services/PantryCloud.Household/PantryCloud.Household.Presentation/Controllers/HouseholdController.cs - Household domain
src/Services/PantryCloud.Household/PantryCloud.Household.Core/Entities/Household.cs - Household queries
src/Services/PantryCloud.Household/PantryCloud.Household.Application/Queries/Handlers
Pantry services
- Pantry API
src/Services/PantryCloud.Pantry/PantryCloud.Pantry.Presentation/Controllers/PantryController.cs - Pantry queries
src/Services/PantryCloud.Pantry/PantryCloud.Pantry.Application/Queries/Handlers/ListPantryItemsQueryHandler.cs - Recipe API
src/Services/PantryCloud.Recipe/PantryCloud.Recipe.Presentation/Controllers/RecipeController.cs - Recipe queries
src/Services/PantryCloud.Recipe/PantryCloud.Recipe.Application/Queries/Handlers/GetRecipeQueryHandler.cs - Recipe search
src/Services/PantryCloud.Recipe/PantryCloud.Recipe.Infrastructure/Services/LocalMongoRecipeSearchService.cs - Shopping API
src/Services/PantryCloud.ShoppingList/PantryCloud.ShoppingList.Presentation/Controllers/ShoppingListController.cs - Shopping queries
src/Services/PantryCloud.ShoppingList/PantryCloud.ShoppingList.Application/Queries/Handlers/GetShoppingListQueryHandler.cs - Shopping list model
src/Services/PantryCloud.ShoppingList/PantryCloud.ShoppingList.Core/Entities/ShoppingList.cs
Identity services
- Identity API
src/Services/PantryCloud.Identity/PantryCloud.Identity.Presentation/Controllers/AuthController.cs
Supporting services
- Notification API
src/Services/PantryCloud.Notification/PantryCloud.Notification.Presentation/Controllers/NotificationsController.cs - Notification query
src/Services/PantryCloud.Notification/PantryCloud.Notification.Application/Queries/GetMyNotificationsQueryHandler.cs - Audit API
src/Services/PantryCloud.Audit/PantryCloud.Audit.Presentation/Controllers/AuditController.cs - Audit query handler
src/Services/PantryCloud.Audit/PantryCloud.Audit.Application/Queries/Handlers/ListHouseholdAuditEntriesQueryHandler.cs - Audit query service
src/Services/PantryCloud.Audit/PantryCloud.Audit.Infrastructure/Services/AuditQueryService.cs - Audit database context
src/Services/PantryCloud.Audit/PantryCloud.Audit.Infrastructure/Persistence/AuditDbContext.cs
Other components
- Household user
Connections 17
- Household user → Web frontend: uses
- Web frontend → API gateway: sends API requests
- API gateway → Identity API: routes identity
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - API gateway → Household API: routes household
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - API gateway → Recipe API: routes recipes
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - API gateway → Shopping API: routes lists
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - API gateway → Notification API: routes notifications
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - API gateway → Audit API: routes audit
src/Gateways/PantryCloud.ApiGateway/PantryCloud.ApiGateway.Infrastructure/ServiceCollectionExtensions.cs - Auth client → API gateway: calls auth API
- Auth client → Token storage: stores tokens
- Household queries → Household domain: queries domain
src/Services/PantryCloud.Household/PantryCloud.Household.Application/Queries/Handlers/GetHouseholdMembersPreferencesQueryHandler.cs - Recipe queries → Recipe search: uses search
- Shopping queries → Shopping list model: queries domain
src/Services/PantryCloud.ShoppingList/PantryCloud.ShoppingList.Application/Queries/Handlers/GetShoppingListQueryHandler.cs - Notification query → Notification API: serves query
- Audit API → Audit query handler: dispatches query
- Audit query handler → Audit query service: delegates query
src/Services/PantryCloud.Audit/PantryCloud.Audit.Application/Queries/Handlers/ListHouseholdAuditEntriesQueryHandler.cs - Audit query service → Audit database context: queries entries
src/Services/PantryCloud.Audit/PantryCloud.Audit.Infrastructure/Services/AuditQueryService.cs