Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/domai-tb/campus_vote
⚠️ WIP ⚠️
https://github.com/domai-tb/campus_vote
Last synced: 9 days ago
JSON representation
⚠️ WIP ⚠️
- Host: GitHub
- URL: https://github.com/domai-tb/campus_vote
- Owner: domai-tb
- License: agpl-3.0
- Created: 2024-04-28T17:37:55.000Z (7 months ago)
- Default Branch: dev
- Last Pushed: 2024-11-03T13:52:31.000Z (14 days ago)
- Last Synced: 2024-11-03T14:31:42.733Z (14 days ago)
- Language: Dart
- Homepage:
- Size: 91 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Campus Vote
This project aims to develop a digital electoral directory for the student elections conducted at Ruhr-University Bochum. It is important to note that the scope of this initiative does not encompass the creation of a standalone digital voting system. Rather, Campus Vote serves as a centralized voter registry system.
#### Preview (Work in Progress!!)
This shows the terminal gRPC client Evans that connects by authenticating with TLS certificates. CockRoachDB and Campus Vote running in the background.
The video demonstrate the essential functions of campus vote:
1. Creating Students / Voters: At setup time of the election the registry is filled with a list of students. Each entry (student) is stored AES256 GCM encrypted.
2. Viewing Voters data and allow checking the student ID on real-world ballotbox.
3. Register Votes and avoid double voting. The API will return a status code 3 (in the end, the GUI will show way more handy status messages / indicators).¹
4. Counting statistics: In the end of the video, there is a giant JSON object that holds the number of counts for each ballotbox.²
---
¹ The status code 0 with message "no error" is shown when the student is listed in the registry, but doesn't had voted already
² For efficiency, gRPC represents zeros with no bytes. The GUI will show it in a more human-readable way. The number of total votes is three because I recored the video multiple times.
## Requirements
Drawing from the parliamentary procedures governing the organization of student elections at Ruhr-University Bochum and official documentation, several requirements must be met to achieve this goal.
1. It must be ensured that every vote is recorded and that multiple voting is excluded.
2. It must not be possible to draw any conclusions about the order in which eligible voters cast their votes from the registration of votes without knowing further information.
3. The time at which votes are recorded should be generalized to at least the morning or afternoon of a day.
4. The data must be consistent at all times when it can be accessed, and errors must be reliably identifiable. Data loss due to system crashes must be prevented.
## System Architecture & Design
The election is designed in a peer-to-peer design. Each ballotbox and the central election committee has a local database (based on [CockRoachDB](https://github.com/cockroachdb/cockroach)) that sync with each other node. The privilidges of ballotboxes and the election committee nodes differ in the way how they insert data.
```mermaid
flowchart LR
BB1(["BallotBox 1"])
BB2(["BallotBox 2"])
BB3(["BallotBox 3"])
BBN(["BallotBox N"])
EC{{"Election Committee"}}
BB1 <-.sync.-> BB2
BB1 <-.sync.-> EC
BB1 <-.sync.-> BB3
BB2 <-.sync.-> BBN
EC <-.sync.-> BBN
BB3 <-.sync.-> BBN
BB2 <-.sync.-> EC
EC <-.sync.-> BB3
```
### BallotBox
Ballotboxes are the decentral points the voters insert there choice.
```mermaid
flowchart LR
subgraph BB["BallotBox"]
subgraph CR1["CockRoachDB"]
R{{"Voter Registry Table"}}
V{{"Voted Table"}}
end
API(["BallotBox API"])
GUI(["GUI"])
end
R -.read voter data.-> API
V -.check allready voted.-> API
API -.set voted status.-> V
API <--> GUI
```
### Election Committee
```mermaid
flowchart LR
subgraph BB["Election Committee"]
subgraph CR1["CockRoachDB"]
R{{"Voter Registry Table"}}
V{{"Voted Table"}}
end
API(["Committee API"])
GUI(["GUI"])
end
R -.read voter data.-> API
API -.initially set.-> R
V -.check allready voted.-> API
API <--> GUI
```