# dockersamples/example-voting-app architecture

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

- Interactive diagram: https://gitdiagram.com/dockersamples/example-voting-app
- Repository: https://github.com/dockersamples/example-voting-app

## Overview

Example Voting App collects browser votes, processes them asynchronously, stores one vote per voter, and streams aggregated results to a live results page. The principal flow is voter → Flask voting app → Redis queue → .NET worker → PostgreSQL → Node.js results server → browser. The README documents the Python, Redis, .NET, PostgreSQL, and Node.js roles; sampled source confirms the queue, database, and Socket.IO interactions. The tree also includes a seed-data utility, but it is not part of the runtime workflow. Deployment manifests are omitted; unsampled UI and deployment details are represented only where their paths are supported.

Main entry points: [`result/server.js`](https://github.com/dockersamples/example-voting-app/blob/main/result/server.js) (Results server), [`result/views/app.js`](https://github.com/dockersamples/example-voting-app/blob/main/result/views/app.js) (Results interface), [`vote/app.py`](https://github.com/dockersamples/example-voting-app/blob/main/vote/app.py) (Voting web app), [`worker/Program.cs`](https://github.com/dockersamples/example-voting-app/blob/main/worker/Program.cs) (Vote worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_voting["Vote collection"]
  node_vote_app["Voting web app<br/>[app.py]"]
end

subgraph group_processing["Vote processing"]
  node_worker["Vote worker<br/>[Program.cs]"]
end

subgraph group_results["Live results"]
  node_results_server["Results server<br/>[server.js]"]
  node_results_client["Results interface<br/>[app.js]"]
  node_socket_client["Socket.IO client<br/>[socket.io.js]"]
end

subgraph group_storage["Data services"]
  node_redis["Vote queue"]
  node_postgres[("Votes database")]
end

node_voter(("Voter"))
node_viewer(("Results viewer"))

node_voter -->|"submits vote"| node_vote_app
node_vote_app -->|"enqueues vote"| node_redis
node_redis -->|"pops vote"| node_worker
node_worker -->|"writes vote"| node_postgres
node_results_server -->|"queries totals"| node_postgres
node_results_server -->|"emits scores"| node_results_client
node_results_client -.->|"uses client library"| node_socket_client
node_socket_client -->|"connects socket"| node_results_server
node_viewer -->|"views results"| node_results_client

click node_vote_app "https://github.com/dockersamples/example-voting-app/blob/main/vote/app.py"
click node_worker "https://github.com/dockersamples/example-voting-app/blob/main/worker/Program.cs"
click node_results_server "https://github.com/dockersamples/example-voting-app/blob/main/result/server.js"
click node_results_client "https://github.com/dockersamples/example-voting-app/blob/main/result/views/app.js"
click node_socket_client "https://github.com/dockersamples/example-voting-app/blob/main/result/views/socket.io.js"

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_vote_app,node_viewer toneBlue
class node_worker toneAmber
class node_results_server,node_results_client,node_socket_client toneMint
class node_redis,node_postgres toneRose
class node_voter toneIndigo
```

## Components

### Vote collection

- [Voting web app](https://github.com/dockersamples/example-voting-app/blob/main/vote/app.py): `vote/app.py`

### Vote processing

- [Vote worker](https://github.com/dockersamples/example-voting-app/blob/main/worker/Program.cs): `worker/Program.cs`

### Live results

- [Results server](https://github.com/dockersamples/example-voting-app/blob/main/result/server.js): `result/server.js`
- [Results interface](https://github.com/dockersamples/example-voting-app/blob/main/result/views/app.js): `result/views/app.js`
- [Socket.IO client](https://github.com/dockersamples/example-voting-app/blob/main/result/views/socket.io.js): `result/views/socket.io.js`

### Data services

- **Vote queue**
- **Votes database**

### Other components

- **Voter**
- **Results viewer**

## Connections

- Voter → Voting web app: submits vote (evidence: `README.md`)
- Voting web app → Vote queue: enqueues vote (evidence: `vote/app.py`)
- Vote queue → Vote worker: pops vote (evidence: `worker/Program.cs`)
- Vote worker → Votes database: writes vote (evidence: `worker/Program.cs`)
- Results server → Votes database: queries totals (evidence: `result/server.js`)
- Results server → Results interface: emits scores (evidence: `result/server.js`)
- Results interface → Socket.IO client: uses client library
- Socket.IO client → Results server: connects socket
- Results viewer → Results interface: views results (evidence: `README.md`)
