# kimyuuum/simultaneous-viewing-limit-system architecture

> Architecture diagram of the GitHub repository kimyuuum/simultaneous-viewing-limit-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kimyuuum/simultaneous-viewing-limit-system
- Repository: https://github.com/kimyuuum/simultaneous-viewing-limit-system

## Overview

This is a Spring Boot microservice system for enforcing simultaneous VOD-viewing limits. A client submits start, force-start, or stop requests to Push Service; new connections are checked by Check Service, which consults Redis and publishes a conflict result through Kafka. Push Service then notifies subscribed users over WebSocket and can dispatch forced-connect or stop updates asynchronously. The source excerpts establish the HTTP and service calls; Kafka topic delivery between services is documented only generally, so that cross-service dispatch is shown as unverified.

Main entry points: [`push-service/src/main/java/com/skb/pushservice/service/ConnectService.java`](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/ConnectService.java) (Connection flow), [`check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java`](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java) (Limit decision), [`push-service/src/main/java/com/skb/pushservice/service/NotificationService.java`](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/NotificationService.java) (User notifications), [`push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java`](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java) (Request API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_push["Push service"]
  node_push_api["Request API"]
  node_connect["Connection flow"]
  node_push_notify["User notifications"]
  node_push_listener["Event listener"]
end

subgraph group_check["Viewing checks"]
  node_check_api["Connection endpoint"]
  node_check_flow["Limit decision"]
end

subgraph group_events["Messaging"]
  node_check_sender["Check event sender<br/>[MessageSender.java]"]
  node_push_sender["Push event sender<br/>[MessageSender.java]"]
  node_kafka["Kafka cluster"]
end

subgraph group_state["Viewing state"]
  node_redis_access["Watch-log access"]
  node_redis[("Redis cluster")]
end

node_client(("OTT client"))
node_websocket(("WebSocket clients"))

node_client -->|"submits request"| node_push_api
node_push_api -->|"routes requests"| node_connect
node_connect -->|"checks via HTTP"| node_check_api
node_check_api -->|"delegates check"| node_check_flow
node_check_flow -->|"checks and updates"| node_redis_access
node_redis_access -->|"reads and writes"| node_redis
node_check_flow -->|"publishes conflict"| node_check_sender
node_check_sender -->|"sends event"| node_kafka
node_kafka -.->|"delivers event"| node_push_listener
node_push_listener -->|"dispatches notification"| node_push_notify
node_connect -->|"notifies users"| node_push_notify
node_push_notify -->|"sends messages"| node_websocket
node_connect -->|"sends force or stop"| node_push_sender
node_push_sender -.->|"sends event"| node_kafka

click node_push_api "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java"
click node_connect "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/ConnectService.java"
click node_push_notify "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/NotificationService.java"
click node_push_listener "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/message/MessageListener.java"
click node_check_api "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/controller/ConnectController.java"
click node_check_flow "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java"
click node_redis_access "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/service/RedisClusterService.java"
click node_check_sender "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/message/MessageSender.java"
click node_push_sender "https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/message/MessageSender.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_push_api,node_connect,node_push_notify,node_push_listener,node_client,node_websocket toneBlue
class node_check_api,node_check_flow toneAmber
class node_check_sender,node_push_sender,node_kafka toneMint
class node_redis_access,node_redis toneRose
```

## Components

### Push service

- [Request API](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java): `push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java`
- [Connection flow](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/ConnectService.java): `push-service/src/main/java/com/skb/pushservice/service/ConnectService.java`
- [User notifications](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/service/NotificationService.java): `push-service/src/main/java/com/skb/pushservice/service/NotificationService.java`
- [Event listener](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/message/MessageListener.java): `push-service/src/main/java/com/skb/pushservice/message/MessageListener.java`

### Viewing checks

- [Connection endpoint](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/controller/ConnectController.java): `check-service/src/main/java/com/skb/checkservice/controller/ConnectController.java`
- [Limit decision](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java): `check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java`

### Messaging

- [Check event sender](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/message/MessageSender.java): `check-service/src/main/java/com/skb/checkservice/message/MessageSender.java`
- [Push event sender](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/push-service/src/main/java/com/skb/pushservice/message/MessageSender.java): `push-service/src/main/java/com/skb/pushservice/message/MessageSender.java`
- **Kafka cluster**

### Viewing state

- [Watch-log access](https://github.com/kimyuuum/simultaneous-viewing-limit-system/blob/master/check-service/src/main/java/com/skb/checkservice/service/RedisClusterService.java): `check-service/src/main/java/com/skb/checkservice/service/RedisClusterService.java`
- **Redis cluster**

### Other components

- **OTT client**
- **WebSocket clients**

## Connections

- OTT client → Request API: submits request (evidence: `README.md`)
- Request API → Connection flow: routes requests (evidence: `push-service/src/main/java/com/skb/pushservice/controller/NotificationController.java`)
- Connection flow → Connection endpoint: checks via HTTP (evidence: `push-service/src/main/java/com/skb/pushservice/service/ConnectService.java`)
- Connection endpoint → Limit decision: delegates check (evidence: `check-service/src/main/java/com/skb/checkservice/controller/ConnectController.java`)
- Limit decision → Watch-log access: checks and updates (evidence: `check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java`)
- Watch-log access → Redis cluster: reads and writes (evidence: `check-service/src/main/java/com/skb/checkservice/service/RedisClusterService.java`)
- Limit decision → Check event sender: publishes conflict (evidence: `check-service/src/main/java/com/skb/checkservice/service/CheckViewingService.java`)
- Check event sender → Kafka cluster: sends event (evidence: `check-service/src/main/java/com/skb/checkservice/message/MessageSender.java`)
- Kafka cluster → Event listener: delivers event
- Event listener → User notifications: dispatches notification (evidence: `push-service/src/main/java/com/skb/pushservice/message/MessageListener.java`)
- Connection flow → User notifications: notifies users (evidence: `push-service/src/main/java/com/skb/pushservice/service/ConnectService.java`)
- User notifications → WebSocket clients: sends messages (evidence: `push-service/src/main/java/com/skb/pushservice/service/NotificationService.java`)
- Connection flow → Push event sender: sends force or stop (evidence: `push-service/src/main/java/com/skb/pushservice/service/ConnectService.java`)
- Push event sender → Kafka cluster: sends event
