FlowerShop IoT Platform
Multi-tenant SaaS platform connecting flower vendors with customers through IoT-enabled smart vases. Use the left panel to navigate all documentation sections.
Architecture
Overview
Tech stack, Clean Architecture layers, key patterns
C4 Context
System-level view: users and external systems
C4 Containers
All runtime containers and their communication
C4 Components
API layer internals: controllers → handlers → domain
Domain Model
ER diagram of all 14 aggregates
Cross-cutting
Middleware, caching, multi-tenancy, idempotency
Flows
Authentication
Keycloak OIDC, dev-token, tenant resolution, token blacklist
Customer
Browse, QR scan, cart, order, payment, delivery
Vendor
Onboarding, bouquet lifecycle, order fulfillment
Admin
Vendor approval, suspension, analytics
IoT
Vase registration, MQTT, heartbeat, sensor data
Payments
Stripe checkout, webhook, outbox, confirmation
Real-time
SignalR hub groups, outbox dispatch, view counter
API & Contracts
Mobile API Contracts
Full REST + SignalR contract for the mobile app
Outbound Contracts
Domain events and integration event schemas