How helpwave/services works
Main Components
a. Services Layer:
• user-svc (User management and organizations)
• tasks-svc (Task management, wards, rooms, beds, patients)
• property-svc (Property management)
• updates-svc (Real-time updates)
b. API Gateway:
• APISIX (Handles both gRPC-web and gRPC proxy)
• Ports: 9080 (HTTP), 9433 (HTTPS), 9090 (control API)
c. Infrastructure Components:
• PostgreSQL (Database)
• Redis (Caching/PubSub)
• EventStoreDB (Event sourcing)
• SpiceDB (Authorization)
• Jaeger (Distributed tracing)
d. Communication Layer:
• Dapr (Service mesh/sidecar)
• gRPC (Inter-service communication)
• gRPC-web (Client-facing API)
┌─────────────────────────────────────────────┐
• Client Layer (Web/Mobile) │
• ┤
• Gateway Layer (APISIX + Dapr) │
• ┤
• Services Layer (Microservices) │
• ┤
• Infrastructure Layer (Databases/Storage) │
• ┘
Key Relationships to Highlight
a. Service Communication:
• Dapr sidecars next to each service
• GRPC communication between services
• Event sourcing patterns with EventStoreDB
b. Data Flow:
• Client requests through APISIX
• Service-to-service communication via Dapr
• Database connections
• Event streams
Specific Implementation Details
┌──────────────────────────────────────────────────────────────┐
• Clients (Web/Mobile) │
• ┬────────────────────────────────────────┘
• ▼
┌──────────────────────────────────────────────────────────────┐
• APISIX Gateway (gRPC-web/gRPC) │
• ┬────────────────────────────────────────┘
• ▼
┌──────────────────────────────────────────────────────────────┐
• Dapr Service Mesh │
• ┬──────────┬───────────┬──────────────┬────────────┤
• user-svc │tasks-svc │updates-svc│ property-svc │ Other svcs │
• ┴──────────┴───────────┴──────────────┴────────────┘
• ▲
┌─────────────────────┴───────────────────────────────────────┐
• Infrastructure │
• ┬────────────┬────────────┬────────────┬────────┤
• PostgreSQL │ Redis │EventStoreDB│ SpiceDB │ Jaeger │
• ┴────────────┴────────────┴────────────┴────────┘
Additional Elements
• Port numbers for each service
• Authentication flow
• Event sourcing patterns
• Monitoring and tracing paths
• Development vs. production components