# safeexambrowser/seb-win-refactoring architecture

> Architecture diagram of the GitHub repository safeexambrowser/seb-win-refactoring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/safeexambrowser/seb-win-refactoring
- Repository: https://github.com/safeexambrowser/seb-win-refactoring

## Overview

Safe Exam Browser is a Windows application for conducting exams in a restricted Chromium-based environment. The principal workflow is runtime startup and session selection, client setup of the configured exam environment, then use of the browser and enabled monitoring or proctoring features during the session. Runtime and client controller links reflect sampled source; other product capabilities are represented from the repository tree, so their internal wiring is not asserted. The README identifies the product and browser engine but does not describe detailed feature flows.

Main entry points: [`SafeExamBrowser.Runtime/RuntimeController.cs`](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Runtime/RuntimeController.cs) (Runtime controller), [`SafeExamBrowser.Client/Responsibilities`](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Client/Responsibilities) (Client responsibilities), [`SafeExamBrowser.Browser/BrowserApplication.cs`](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/BrowserApplication.cs) (Browser application), [`SafeExamBrowser.Client/ClientController.cs`](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/ClientController.cs) (Client controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime lifecycle"]
  node_runtime_controller["Runtime controller"]
  node_runtime_context["Runtime session"]
end

subgraph group_client["Exam client"]
  node_client_controller["Client controller"]
  node_client_context["Client session<br/>[ClientContext.cs]"]
  node_operations["Startup operations<br/>[Operations]"]
  node_responsibilities["Client responsibilities<br/>[Responsibilities]"]
  node_applications["Applications"]
end

subgraph group_browser["Secure browser"]
  node_browser_app["Browser application"]
  node_browser_window["Browser windows<br/>[BrowserWindow.cs]"]
  node_browser_handlers["Browser controls<br/>[Handlers]"]
  node_request_filter["Request filtering<br/>[RequestFilter.cs]"]
  node_integrations["Exam integrations<br/>[Integrations]"]
end

subgraph group_services["Session services"]
  node_proctoring["Proctoring"]
  node_server["Exam server"]
  node_monitoring["System monitoring"]
  node_service_controller["Service controller"]
end

subgraph group_foundation["Configuration and communication"]
  node_configuration["Configuration repository"]
  node_config_data["Configuration processing<br/>[DataProcessor.cs]"]
  node_communication["Communication hosts<br/>[BaseHost.cs]"]
  node_runtime_proxy["Runtime proxy<br/>[RuntimeProxy.cs]"]
end

node_examinee(("Examinee"))
node_examweb(("Exam website"))

node_runtime_controller -->|"checks session"| node_runtime_context
node_runtime_controller -->|"delegates tasks"| node_responsibilities
node_runtime_controller -->|"notifies ready"| node_runtime_proxy
node_client_controller -->|"performs startup"| node_operations
node_client_controller -->|"delegates tasks"| node_responsibilities
node_client_controller -->|"reports ready"| node_runtime_proxy
node_client_context -->|"holds browser"| node_browser_app
node_client_context -->|"holds applications"| node_applications
node_responsibilities -->|"sets up browser"| node_browser_app
node_responsibilities -->|"sets up proctoring"| node_proctoring
node_browser_app -->|"creates windows"| node_browser_window
node_browser_window -->|"handles browser events"| node_browser_handlers
node_browser_handlers -->|"filters requests"| node_request_filter
node_browser_app -.->|"enables integrations"| node_integrations
node_examinee -->|"starts session"| node_runtime_controller
node_examweb -->|"serves exam pages"| node_browser_window
node_configuration -->|"processes configuration"| node_config_data
node_service_controller -->|"registers session events"| node_communication
node_communication -->|"exchanges messages"| node_runtime_proxy
node_proctoring -->|"receives instructions"| node_server

click node_runtime_controller "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Runtime/RuntimeController.cs"
click node_runtime_context "https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Runtime"
click node_client_controller "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/ClientController.cs"
click node_client_context "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/ClientContext.cs"
click node_operations "https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Client/Operations"
click node_responsibilities "https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Client/Responsibilities"
click node_applications "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Applications/ApplicationFactory.cs"
click node_browser_app "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/BrowserApplication.cs"
click node_browser_window "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/BrowserWindow.cs"
click node_browser_handlers "https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Browser/Handlers"
click node_request_filter "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/Filters/RequestFilter.cs"
click node_integrations "https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Browser/Integrations"
click node_proctoring "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Proctoring/ProctoringController.cs"
click node_server "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/Responsibilities/ServerResponsibility.cs"
click node_monitoring "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/Responsibilities/MonitoringResponsibility.cs"
click node_service_controller "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Service/ServiceController.cs"
click node_configuration "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Configuration/ConfigurationRepository.cs"
click node_config_data "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Configuration/ConfigurationData/DataProcessor.cs"
click node_communication "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Communication/Hosts/BaseHost.cs"
click node_runtime_proxy "https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Communication/Proxies/RuntimeProxy.cs"

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_runtime_controller,node_runtime_context toneBlue
class node_client_controller,node_client_context,node_operations,node_responsibilities,node_applications toneAmber
class node_browser_app,node_browser_window,node_browser_handlers,node_request_filter,node_integrations toneMint
class node_proctoring,node_server,node_monitoring,node_service_controller toneRose
class node_configuration,node_config_data,node_communication,node_runtime_proxy,node_examinee,node_examweb toneIndigo
```

## Components

### Runtime lifecycle

- [Runtime controller](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Runtime/RuntimeController.cs): `SafeExamBrowser.Runtime/RuntimeController.cs`
- [Runtime session](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Runtime): `SafeExamBrowser.Runtime`

### Exam client

- [Client controller](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/ClientController.cs): `SafeExamBrowser.Client/ClientController.cs`
- [Client session](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/ClientContext.cs): `SafeExamBrowser.Client/ClientContext.cs`
- [Startup operations](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Client/Operations): `SafeExamBrowser.Client/Operations`
- [Client responsibilities](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Client/Responsibilities): `SafeExamBrowser.Client/Responsibilities`
- [Applications](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Applications/ApplicationFactory.cs): `SafeExamBrowser.Applications/ApplicationFactory.cs`

### Secure browser

- [Browser application](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/BrowserApplication.cs): `SafeExamBrowser.Browser/BrowserApplication.cs`
- [Browser windows](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/BrowserWindow.cs): `SafeExamBrowser.Browser/BrowserWindow.cs`
- [Browser controls](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Browser/Handlers): `SafeExamBrowser.Browser/Handlers`
- [Request filtering](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Browser/Filters/RequestFilter.cs): `SafeExamBrowser.Browser/Filters/RequestFilter.cs`
- [Exam integrations](https://github.com/safeexambrowser/seb-win-refactoring/tree/master/SafeExamBrowser.Browser/Integrations): `SafeExamBrowser.Browser/Integrations`

### Session services

- [Proctoring](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Proctoring/ProctoringController.cs): `SafeExamBrowser.Proctoring/ProctoringController.cs`
- [Exam server](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/Responsibilities/ServerResponsibility.cs): `SafeExamBrowser.Client/Responsibilities/ServerResponsibility.cs`
- [System monitoring](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Client/Responsibilities/MonitoringResponsibility.cs): `SafeExamBrowser.Client/Responsibilities/MonitoringResponsibility.cs`
- [Service controller](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Service/ServiceController.cs): `SafeExamBrowser.Service/ServiceController.cs`

### Configuration and communication

- [Configuration repository](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Configuration/ConfigurationRepository.cs): `SafeExamBrowser.Configuration/ConfigurationRepository.cs`
- [Configuration processing](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Configuration/ConfigurationData/DataProcessor.cs): `SafeExamBrowser.Configuration/ConfigurationData/DataProcessor.cs`
- [Communication hosts](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Communication/Hosts/BaseHost.cs): `SafeExamBrowser.Communication/Hosts/BaseHost.cs`
- [Runtime proxy](https://github.com/safeexambrowser/seb-win-refactoring/blob/master/SafeExamBrowser.Communication/Proxies/RuntimeProxy.cs): `SafeExamBrowser.Communication/Proxies/RuntimeProxy.cs`

### Other components

- **Examinee**
- **Exam website**

## Connections

- Runtime controller → Runtime session: checks session
- Runtime controller → Client responsibilities: delegates tasks
- Runtime controller → Runtime proxy: notifies ready
- Client controller → Startup operations: performs startup
- Client controller → Client responsibilities: delegates tasks
- Client controller → Runtime proxy: reports ready
- Client session → Browser application: holds browser
- Client session → Applications: holds applications
- Client responsibilities → Browser application: sets up browser
- Client responsibilities → Proctoring: sets up proctoring
- Browser application → Browser windows: creates windows
- Browser windows → Browser controls: handles browser events
- Browser controls → Request filtering: filters requests
- Browser application → Exam integrations: enables integrations
- Examinee → Runtime controller: starts session
- Exam website → Browser windows: serves exam pages
- Configuration repository → Configuration processing: processes configuration
- Service controller → Communication hosts: registers session events
- Communication hosts → Runtime proxy: exchanges messages
- Proctoring → Exam server: receives instructions
