How foxminchan/bookworm works
BookWorm is a cloud-native bookstore application with a customer storefront, administrative backoffice, and domain services for catalog, basket, ordering, ratings, chat, and scheduling. The main customer workflow is browsing and filtering books, selecting a book, managing a basket, and completing checkout; the README documents these product capabilities but the sampled sources do not show the complete API or service call chain. The architecture also includes Keycloak authentication, AI-agent capabilities, and shared service infrastructure. Dashed edges indicate relationships not verified by the supplied excerpts.
Main entry points: storefront Storefront · BookWorm.Catalog Catalog service · backoffice Admin backoffice · AppHost.cs Aspire application host
Components 21
Client applications
- Storefront
src/Clients/apps/storefront - Book browsing
src/Clients/apps/storefront/features/catalog/shop/shop-page-client.tsx - Book details
src/Clients/apps/storefront/features/catalog/product/book-detail-page-client.tsx - Basket and checkout
src/Clients/apps/storefront/app/(basket) - Customer orders
src/Clients/apps/storefront/app/(ordering) - Admin backoffice
src/Clients/apps/backoffice
Commerce services
- Catalog service
src/Services/Catalog/BookWorm.Catalog - Catalog ingestion
src/Services/Catalog/BookWorm.Catalog.Ingestion - Basket service
src/Services/Basket/BookWorm.Basket - Ordering service
src/Services/Ordering/BookWorm.Ordering - Rating service
src/Services/Rating/BookWorm.Rating - Catalog database
src/Services/Catalog/BookWorm.Catalog/Infrastructure/Repositories/AuthorRepository.cs
AI services
- Chat agents
src/Services/Chat/BookWorm.Chat/Agents/Routing/RouterAgentDefinition.cs - Storefront AI entry
src/Clients/apps/storefront/app/api/copilotkit/route.ts
Platform and identity
- Scheduler
src/Services/Scheduler/BookWorm.Scheduler/Program.cs - Keycloak identity
src/Aspire/BookWorm.AppHost/Container/keycloak - Aspire application host
src/Aspire/BookWorm.AppHost/AppHost.cs
Shared infrastructure
- Service chassis
src/BuildingBlocks/BookWorm.Chassis - Token exchange
src/BuildingBlocks/BookWorm.Chassis/Security/TokenExchange/TokenExchange.cs - Query specifications
src/BuildingBlocks/BookWorm.Chassis/Specification/Specification.cs
Other components
- Customer
Connections 24
- Customer → Storefront: shops books
README.md - Storefront → Book browsing: browses
src/Clients/apps/storefront/features/catalog/shop/shop-page-client.tsx - Book browsing → Book details: opens books
- Book details → Basket and checkout: adds to basket
- Basket and checkout → Customer orders: checks out
- Customer → Admin backoffice: administers
README.md - Admin backoffice → Catalog service: manages catalog
- Admin backoffice → Ordering service: manages orders
- Admin backoffice → Rating service: manages reviews
- Catalog ingestion → Catalog service: ingests catalog
- Catalog service → Catalog database: reads and writes
src/Services/Catalog/BookWorm.Catalog/Infrastructure/Repositories/AuthorRepository.cs - Storefront → Basket service: uses basket
- Storefront → Ordering service: places orders
- Storefront → Rating service: uses ratings
- Customer → Storefront AI entry: asks questions
- Storefront AI entry → Chat agents: routes requests
- Chat agents → Rating service: specialist agent
- Aspire application host → Catalog service: orchestrates services
- Aspire application host → Ordering service: orchestrates services
- Aspire application host → Keycloak identity: configures identity
- Storefront → Keycloak identity: authenticates
- Service chassis → Token exchange: provides security
src/BuildingBlocks/BookWorm.Chassis/Security/TokenExchange/TokenExchange.cs - Token exchange → Keycloak identity: exchanges tokens
src/BuildingBlocks/BookWorm.Chassis/Security/TokenExchange/TokenExchange.cs - Catalog service → Query specifications: queries with
src/Services/Catalog/BookWorm.Catalog/Infrastructure/Repositories/AuthorRepository.cs