How graduation-work-2025-26-hasslspaceapp/hasslspace-backend works
HasslSpace is a multi-service chat and community backend: users register and authenticate, form friendships, create and administer servers/channels, then exchange messages or obtain voice-room tokens. The graph captures those domain services plus notification delivery and object storage. Relationships are limited to explicit calls in the excerpts or indexed references; several service-to-service links and unsampled controller routing are therefore omitted rather than inferred.
Main entry points: AuthService.kt Authentication · EmailSenderService.kt Email sender · ServerRepository.kt Server data · ChatService.kt Chat & messages
Components 23
Identity & friends
- User API
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/controller/AuthController.kt - Authentication
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/service/AuthService.kt - Friendships
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/service/FriendshipService.kt - User records
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/repository/UserRepository.kt
Servers & channels
- Server APIs
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/controller/ServerController.kt - Server management
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ServerService.kt - Membership & invites
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ServerMemberService.kt - Channel permissions
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ChannelService.kt - Server data
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/repository/ServerRepository.kt
Chat & media
- Chat API
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/controller/ChatController.kt - Chat & messages
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/ChatService.kt - Chat records
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/repository/MessageRepository.kt - Realtime publish
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/CentrifugoService.kt - Chat file storage
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/S3Service.kt
Notifications & voice
- Voice API
voice-service/src/main/kotlin/ru/hse/hasslspace/voiceservice/controller/VoiceChatController.kt - Voice tokens
voice-service/src/main/kotlin/ru/hse/hasslspace/voiceservice/service/VoiceChatService.kt - Notification API
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/controller/MailController.kt - Email event listener
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/service/KafkaListenerService.kt - Email sender
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/service/EmailSenderService.kt
Other components
- S3 storage
- LiveKit
- Mail transport
- Client
Connections 19
- Client → User API: requests
- Client → Server APIs: requests
- Client → Chat API: requests
- Client → Voice API: requests
- Client → Notification API: requests
- Authentication → User records: reads/writes
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/service/AuthService.kt - Authentication → User API: issues tokens
- Friendships → User records: loads users
user-service/src/main/kotlin/ru/hse/hasslspace/userservice/service/FriendshipService.kt - Server management → Server data: reads/writes
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ServerService.kt - Membership & invites → Server data: manages membership
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ServerMemberService.kt - Channel permissions → Server data: checks permissions
server-service/src/main/kotlin/ru/hse/hasslspace/serverservice/service/ChannelService.kt - Chat & messages → Chat records: saves messages
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/ChatService.kt - Chat & messages → Realtime publish: publishes message
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/ChatService.kt - Chat file storage → S3 storage: uploads/downloads
chat-service/src/main/kotlin/ru/hse/hasslspace/chatservice/service/S3Service.kt - Voice tokens → LiveKit: creates token
voice-service/src/main/kotlin/ru/hse/hasslspace/voiceservice/service/VoiceChatService.kt - Email event listener → Email sender: delegates email
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/service/KafkaListenerService.kt - Notification API → Email sender: sends request
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/controller/MailController.kt - Email sender → Mail transport: sends mail
notification-service/src/main/kotlin/ru/hse/hasslspace/notificationservice/service/EmailSenderService.kt - Authentication → Email event listener: verification event