# bardas-denis/electronic-election-management-system architecture

> Architecture diagram of the GitHub repository bardas-denis/electronic-election-management-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/bardas-denis/electronic-election-management-system
- Repository: https://github.com/bardas-denis/electronic-election-management-system

## Overview

EEMS is a web-based election management system. Its principal workflow is that election managers create and publish elections, voters access an open election and cast ballots, and users view results; first-run setup configures the instance before normal use. The backend also supports authentication, administration, audit, images, notifications, and pluggable scoring and database providers. The README documents the setup and launch flow; source excerpts and the index support only some internal connections, so other capability links are left unverified rather than inferred.

Main entry points: [`electronic-election-management-system/src/app/app.routes.ts`](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.routes.ts) (Route access), [`Electronic Election Management System/Electronic Election Management System/Data/Repositories`](https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Data/Repositories) (Repositories), [`electronic-election-management-system/src/app/app.ts`](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.ts) (Angular application), [`electronic-election-management-system/src/app/features/voting`](https://github.com/bardas-denis/electronic-election-management-system/tree/main/electronic-election-management-system/src/app/features/voting) (Election screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_angular["Angular application<br/>[app.ts]"]
  node_routes["Route access<br/>[app.routes.ts]"]
  node_setupui["Setup wizard<br/>[setup.component.ts]"]
  node_authui["Login and registration"]
  node_electionui["Election screens"]
  node_resultsui["Results dashboard"]
end

subgraph group_api["Backend services"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_authservice["Authentication service<br/>[AuthService.cs]"]
end

subgraph group_election["Election lifecycle"]
  node_electionapi["Election API"]
  node_voteapi["Voting API<br/>[VotesController.cs]"]
  node_resultsapi["Results API"]
  node_otherfeatures["Images, scoring, notifications"]
end

subgraph group_data["Persistence and plugins"]
  node_repositories["Repositories"]
  node_dbcontext[("Election data model")]
  node_providers["Database providers"]
  node_pluginhost["Plugin host<br/>[PluginHost.cs]"]
  node_contracts["Scoring plugin contracts<br/>[IScoringPlugin.cs]"]
end

subgraph group_admin["Administration"]
  node_adminfeatures["Users, labels, audit"]
  node_setupapi["Instance setup API<br/>[SetupController.cs]"]
end

node_visitor(("User"))

node_visitor -.->|"uses"| node_angular
node_angular -->|"opens setup"| node_setupui
node_angular -->|"resolves routes"| node_routes
node_routes -->|"loads"| node_setupui
node_routes -->|"loads"| node_authui
node_routes -->|"loads"| node_electionui
node_routes -->|"loads"| node_resultsui
node_setupui -.->|"configures"| node_setupapi
node_authui -.->|"authenticates"| node_authapi
node_electionui -.->|"manages elections"| node_electionapi
node_electionui -.->|"casts ballots"| node_voteapi
node_resultsui -.->|"requests results"| node_resultsapi
node_authapi -.->|"delegates"| node_authservice
node_authservice -->|"reads and writes users"| node_repositories
node_authservice -->|"writes audit logs"| node_repositories
node_repositories -.->|"uses context"| node_dbcontext
node_dbcontext -->|"uses provider"| node_providers
node_pluginhost -->|"loads provider"| node_providers
node_pluginhost -.->|"hosts extensions"| node_contracts
node_electionapi -.->|"supports election features"| node_otherfeatures
node_adminfeatures -.->|"uses persistence"| node_repositories
node_setupapi -->|"configures database"| node_dbcontext

click node_angular "https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.ts"
click node_routes "https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.routes.ts"
click node_setupui "https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/features/setup/setup.component.ts"
click node_authui "https://github.com/bardas-denis/electronic-election-management-system/tree/main/electronic-election-management-system/src/app/features/auth"
click node_electionui "https://github.com/bardas-denis/electronic-election-management-system/tree/main/electronic-election-management-system/src/app/features/voting"
click node_resultsui "https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/features/dashboard/results-dashboard.component.ts"
click node_authapi "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/AuthController.cs"
click node_authservice "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Services/implementations/AuthService.cs"
click node_electionapi "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/ElectionsController.cs"
click node_voteapi "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/VotesController.cs"
click node_resultsapi "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/ResultsController.cs"
click node_otherfeatures "https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers"
click node_adminfeatures "https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers"
click node_setupapi "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/SetupController.cs"
click node_repositories "https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Data/Repositories"
click node_dbcontext "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.Data/ElectionDbContext.cs"
click node_providers "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.Data/IDatabaseProvider.cs"
click node_pluginhost "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Plugins/PluginHost.cs"
click node_contracts "https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.PluginContracts/IScoringPlugin.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_angular,node_routes,node_setupui,node_authui,node_electionui,node_resultsui,node_visitor toneBlue
class node_authapi,node_authservice toneAmber
class node_electionapi,node_voteapi,node_resultsapi,node_otherfeatures toneMint
class node_repositories,node_dbcontext,node_providers,node_pluginhost,node_contracts toneRose
class node_adminfeatures,node_setupapi toneIndigo
```

## Components

### Web application

- [Angular application](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.ts): `electronic-election-management-system/src/app/app.ts`
- [Route access](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/app.routes.ts): `electronic-election-management-system/src/app/app.routes.ts`
- [Setup wizard](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/features/setup/setup.component.ts): `electronic-election-management-system/src/app/features/setup/setup.component.ts`
- [Login and registration](https://github.com/bardas-denis/electronic-election-management-system/tree/main/electronic-election-management-system/src/app/features/auth): `electronic-election-management-system/src/app/features/auth`
- [Election screens](https://github.com/bardas-denis/electronic-election-management-system/tree/main/electronic-election-management-system/src/app/features/voting): `electronic-election-management-system/src/app/features/voting`
- [Results dashboard](https://github.com/bardas-denis/electronic-election-management-system/blob/main/electronic-election-management-system/src/app/features/dashboard/results-dashboard.component.ts): `electronic-election-management-system/src/app/features/dashboard/results-dashboard.component.ts`

### Backend services

- [Authentication API](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/AuthController.cs): `Electronic Election Management System/Electronic Election Management System/Controllers/AuthController.cs`
- [Authentication service](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Services/implementations/AuthService.cs): `Electronic Election Management System/Electronic Election Management System/Services/implementations/AuthService.cs`

### Election lifecycle

- [Election API](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/ElectionsController.cs): `Electronic Election Management System/Electronic Election Management System/Controllers/ElectionsController.cs`
- [Voting API](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/VotesController.cs): `Electronic Election Management System/Electronic Election Management System/Controllers/VotesController.cs`
- [Results API](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/ResultsController.cs): `Electronic Election Management System/Electronic Election Management System/Controllers/ResultsController.cs`
- [Images, scoring, notifications](https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers): `Electronic Election Management System/Electronic Election Management System/Controllers`

### Persistence and plugins

- [Repositories](https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Data/Repositories): `Electronic Election Management System/Electronic Election Management System/Data/Repositories`
- [Election data model](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.Data/ElectionDbContext.cs): `Electronic Election Management System/Electronic Election Management System.Data/ElectionDbContext.cs`
- [Database providers](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.Data/IDatabaseProvider.cs): `Electronic Election Management System/Electronic Election Management System.Data/IDatabaseProvider.cs`
- [Plugin host](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Plugins/PluginHost.cs): `Electronic Election Management System/Electronic Election Management System/Plugins/PluginHost.cs`
- [Scoring plugin contracts](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System.PluginContracts/IScoringPlugin.cs): `Electronic Election Management System/Electronic Election Management System.PluginContracts/IScoringPlugin.cs`

### Administration

- [Users, labels, audit](https://github.com/bardas-denis/electronic-election-management-system/tree/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers): `Electronic Election Management System/Electronic Election Management System/Controllers`
- [Instance setup API](https://github.com/bardas-denis/electronic-election-management-system/blob/main/Electronic%20Election%20Management%20System/Electronic%20Election%20Management%20System/Controllers/SetupController.cs): `Electronic Election Management System/Electronic Election Management System/Controllers/SetupController.cs`

### Other components

- **User**

## Connections

- User → Angular application: uses
- Angular application → Setup wizard: opens setup
- Angular application → Route access: resolves routes (evidence: `electronic-election-management-system/src/app/app.routes.ts`)
- Route access → Setup wizard: loads (evidence: `electronic-election-management-system/src/app/app.routes.ts`)
- Route access → Login and registration: loads (evidence: `electronic-election-management-system/src/app/app.routes.ts`)
- Route access → Election screens: loads (evidence: `electronic-election-management-system/src/app/app.routes.ts`)
- Route access → Results dashboard: loads (evidence: `electronic-election-management-system/src/app/app.routes.ts`)
- Setup wizard → Instance setup API: configures
- Login and registration → Authentication API: authenticates
- Election screens → Election API: manages elections
- Election screens → Voting API: casts ballots
- Results dashboard → Results API: requests results
- Authentication API → Authentication service: delegates
- Authentication service → Repositories: reads and writes users (evidence: `Electronic Election Management System/Electronic Election Management System/Services/implementations/AuthService.cs`)
- Authentication service → Repositories: writes audit logs (evidence: `Electronic Election Management System/Electronic Election Management System/Services/implementations/AuthService.cs`)
- Repositories → Election data model: uses context (evidence: `Electronic Election Management System/Electronic Election Management System/Data/Repositories/implementations/ElectionRepository.cs`)
- Election data model → Database providers: uses provider (evidence: `Electronic Election Management System/Electronic Election Management System/Program.cs`)
- Plugin host → Database providers: loads provider
- Plugin host → Scoring plugin contracts: hosts extensions
- Election API → Images, scoring, notifications: supports election features
- Users, labels, audit → Repositories: uses persistence (evidence: `Electronic Election Management System/Electronic Election Management System/Controllers/SetupController.cs`)
- Instance setup API → Election data model: configures database (evidence: `Electronic Election Management System/Electronic Election Management System/Controllers/SetupController.cs`)
