# sulte4/course-registration-platform architecture

> Architecture diagram of the GitHub repository sulte4/course-registration-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sulte4/course-registration-platform
- Repository: https://github.com/sulte4/course-registration-platform

## Overview

This is a course-registration HTTP service with course and class management, user registration, class enrollment, and WebSocket class updates. The main workflow routes requests to handlers, which validate and delegate domain rules to the service layer; the repository persists records in PostgreSQL, and enrollment updates can be broadcast to connected clients. The graph also includes startup migrations and request identity handling. Source excerpts establish the main calls, but README documentation is absent and some repository code is only partially shown.

Main entry points: [`main.go`](https://github.com/sulte4/course-registration-platform/blob/main/main.go) (Server startup), [`service.go`](https://github.com/sulte4/course-registration-platform/blob/main/service.go) (Registration service), [`handlers.go`](https://github.com/sulte4/course-registration-platform/blob/main/handlers.go) (HTTP handlers), [`db.go`](https://github.com/sulte4/course-registration-platform/blob/main/db.go) (SQL repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_startup["Server startup<br/>[main.go]"]
  node_handlers["HTTP handlers<br/>[handlers.go]"]
  node_identity["Request identity<br/>[middleware.go]"]
end

subgraph group_domain["Domain Services"]
  node_service["Registration service<br/>[service.go]"]
  node_models["Domain models<br/>[models.go]"]
end

subgraph group_storage["Persistence"]
  node_repository["SQL repository<br/>[db.go]"]
  node_postgres[("PostgreSQL")]
  node_migrations["Schema migrations"]
end

subgraph group_realtime["Realtime Updates"]
  node_realtime["Realtime service"]
  node_hub["WebSocket hub<br/>[ws_hub.go]"]
end

node_user(("API client"))

node_user -->|"sends requests"| node_startup
node_startup -->|"routes requests"| node_handlers
node_startup -->|"wraps stream"| node_identity
node_handlers -->|"calls"| node_service
node_service -->|"reads and writes"| node_repository
node_repository -->|"queries"| node_postgres
node_startup -->|"runs migrations"| node_migrations
node_service -->|"creates models"| node_models
node_repository -->|"scans records"| node_models
node_handlers -->|"wires connections"| node_realtime
node_handlers -->|"streams classes"| node_service
node_service -->|"publishes updates"| node_realtime
node_realtime -->|"registers and broadcasts"| node_hub
node_startup -->|"starts hub"| node_hub
node_hub -->|"sends WebSocket messages"| node_user

click node_startup "https://github.com/sulte4/course-registration-platform/blob/main/main.go"
click node_handlers "https://github.com/sulte4/course-registration-platform/blob/main/handlers.go"
click node_identity "https://github.com/sulte4/course-registration-platform/blob/main/middleware.go"
click node_service "https://github.com/sulte4/course-registration-platform/blob/main/service.go"
click node_models "https://github.com/sulte4/course-registration-platform/blob/main/models.go"
click node_repository "https://github.com/sulte4/course-registration-platform/blob/main/db.go"
click node_migrations "https://github.com/sulte4/course-registration-platform/tree/main/migrations"
click node_realtime "https://github.com/sulte4/course-registration-platform/blob/main/realtime_service.go"
click node_hub "https://github.com/sulte4/course-registration-platform/blob/main/ws_hub.go"

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_startup,node_handlers,node_identity,node_user toneBlue
class node_service,node_models toneAmber
class node_repository,node_postgres,node_migrations toneMint
class node_realtime,node_hub toneRose
```

## Components

### HTTP API

- [Server startup](https://github.com/sulte4/course-registration-platform/blob/main/main.go): `main.go`
- [HTTP handlers](https://github.com/sulte4/course-registration-platform/blob/main/handlers.go): `handlers.go`
- [Request identity](https://github.com/sulte4/course-registration-platform/blob/main/middleware.go): `middleware.go`

### Domain Services

- [Registration service](https://github.com/sulte4/course-registration-platform/blob/main/service.go): `service.go`
- [Domain models](https://github.com/sulte4/course-registration-platform/blob/main/models.go): `models.go`

### Persistence

- [SQL repository](https://github.com/sulte4/course-registration-platform/blob/main/db.go): `db.go`
- **PostgreSQL**
- [Schema migrations](https://github.com/sulte4/course-registration-platform/tree/main/migrations): `migrations`

### Realtime Updates

- [Realtime service](https://github.com/sulte4/course-registration-platform/blob/main/realtime_service.go): `realtime_service.go`
- [WebSocket hub](https://github.com/sulte4/course-registration-platform/blob/main/ws_hub.go): `ws_hub.go`

### Other components

- **API client**

## Connections

- API client → Server startup: sends requests (evidence: `main.go`)
- Server startup → HTTP handlers: routes requests (evidence: `main.go`)
- Server startup → Request identity: wraps stream (evidence: `main.go`)
- HTTP handlers → Registration service: calls (evidence: `handlers.go`)
- Registration service → SQL repository: reads and writes (evidence: `service.go`)
- SQL repository → PostgreSQL: queries (evidence: `db.go`)
- Server startup → Schema migrations: runs migrations (evidence: `main.go`)
- Registration service → Domain models: creates models (evidence: `service.go`)
- SQL repository → Domain models: scans records (evidence: `db.go`)
- HTTP handlers → Realtime service: wires connections (evidence: `handlers.go`)
- HTTP handlers → Registration service: streams classes (evidence: `handlers.go`)
- Registration service → Realtime service: publishes updates (evidence: `service.go`)
- Realtime service → WebSocket hub: registers and broadcasts (evidence: `realtime_service.go`)
- Server startup → WebSocket hub: starts hub (evidence: `main.go`)
- WebSocket hub → API client: sends WebSocket messages (evidence: `ws_hub.go`)
