How arquisoft/wiq_es05b works
Main Components
Frontend Layer:
• React Webapp (port 3000)
• Features: Authentication, Game Interface, Social Features
• Context providers (Auth, Config, Game, Locale)
API Gateway Layer:
• Gateway Service (port 8000)
• Routing and middleware functionality
• Authentication/Authorization handlers
• Request validation
Microservices Layer:
• User Service (user management)
• Auth Service (authentication/authorization)
• Jordi Service (question generation)
• User History Service (game history)
• Ranking Service (scoring system)
Infrastructure Layer:
• MongoDB Database (shared between services)
• Monitoring Stack:
• Prometheus
• Grafana
• Logging Stack:
• Elasticsearch
• Logstash
• Kibana
• Nginx Proxy
[Client Layer (Browser)]
• ↓
[Nginx Proxy]
• ↓
[API Gateway]
• ↓
[Microservices Layer]
• ↓
[Data Layer]
Additional Elements
• Docker container boundaries (show containerization)
• Load balancing indicators
• Security components (Auth middleware)
• External service connections (Wikidata for questions)
Specific Details
For each microservice, show:
• Main responsibilities
• Key endpoints
• Database interactions
• Inter-service communication patterns
For monitoring/logging:
• Metrics collection paths
• Log aggregation flow
• Dashboard connections
Important Architectural Patterns to Highlight
• API Gateway Pattern
• Microservices Architecture
• Event-Driven Communication (where applicable)
• Circuit Breaker Pattern
• Authentication/Authorization Flow
Deployment Information
• Production vs development environments
• Container orchestration
• Service discovery
• Load balancing
Cross-Cutting Concerns
• i18n support (shown in utils)
• Logging mechanisms
• Error handling
• Security measures