How varunda/honu works
Main Components (Top Level)
a) Frontend Layer:
• VueJS + TypeScript components (in /src directory)
• SignalR WebSocket clients for real-time updates
• Static assets (wwwroot)
b) Backend Layer:
• ASP.NET Core MVC application
• SignalR hubs for real-time communication
• Command processing system
• Event processing system
c) Data Layer:
• PostgreSQL database
• Census API integration (Daybreak Games)
• Caching system
Key Architectural Patterns to Highlight
a) Event-Driven Architecture:
• Event queues and processors
• Real-time event subscription system
• Background workers (Hosted Services)
b) Hub-and-Spoke Pattern for Real-time Updates:
• SignalR hubs as central communication points
• Multiple specialized hubs (AlertHub, MapHub, NetworkHub, etc.)
Detailed Component Breakdown
a) Services Layer:
• Census Services (API integration)
• Database Services
• Repository Services
• Hosted Background Services
b) Core Processing:
• Event Processing Pipeline
• Character Data Collection
• Statistics Aggregation
• Report Generation
a) External Data Flow:
• Census API → Event Processors
• Client Requests → API Controllers
• WebSocket Updates → Clients
b) Internal Data Flow:
• Event Processors → Database
• Database → Repositories → Services
• Services → Controllers/Hubs
Integration Points
• Census API integration
• Database connections
• WebSocket connections
• OpenTelemetry integration for tracing
The modularity of the different components
• All component types
• Special symbols used
Keep the abstraction level high enough to show the overall architecture while including enough detail to understand the system's key components and their interactions. Focus on showing how the real-time tracking and statistics generation work together with the background processing system.