You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+40-23Lines changed: 40 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,39 +1,41 @@
1
1
# vote [](https://ci.webkom.dev/webkom/vote)[](https://coveralls.io/github/webkom/vote?branch=master)[](https://libraries.io/github/webkom/vote#dependencies)
2
2
3
-
> vote optimizes the election
3
+
> Digital voting system for Abakus' generral assembly
4
4
5
-
Digital voting system for Abakus' general assembly, built using the MEAN-stack (mongoDB, Express, AngularJS, Node.js).
6
-
Relevant (Norwegian) blog post: http://webkom.abakus.no/vote/
vote assumes you have a MongoDB-server running on `mongodb://localhost:27017/vote` and a redis-server running as `localhost:6379`. To
13
-
change the URL, export `MONGO_URL` and `REDIS_URL` as an environment variable.
11
+
vote assumes you have a MongoDB-server running on `mongodb://localhost:27017/vote` and a redis-server running as `localhost:6379`. To change the URL, export `MONGO_URL` and `REDIS_URL` as an environment variable.
# Start MongoDB and Redis, both required for development and production
20
15
$ docker-compose up -d
21
-
22
16
# Install all dependencies
23
-
$ yarn
24
-
25
-
# Create a user via the CLI. You are promted to select usertype.
26
-
$ ./bin/users create-user <username><cardKey>
17
+
$ yarn && yarn start
27
18
```
28
19
29
20
## Usage
30
21
31
-
vote uses a RFID-reader to register and activate/deactivate users. This is done to make sure that only people that are at the location can vote. The RFID-reader needs to be connected to the computer that is logged in to the moderator panel.
22
+
#### Users
32
23
33
-
An example deployment can be found in the `./deployment` folder.
24
+
Initially you will need to create a moderator and or admin user in order to login
25
+
26
+
```bash
27
+
# Create a user via the CLI. You are prompted to select usertype.
28
+
$ ./bin/users create-user <username><cardKey>
29
+
```
30
+
31
+
#### Card-readers
32
+
33
+
vote uses a RFID-reader to register and activate/deactivate users. This is done to make sure that only people that are at the location can vote. The RFID-reader needs to be connected to the computer that is logged in to the moderator panel. See section about using the card reader further down this readme.
34
34
35
35
### Development
36
36
37
+
> Check docs for the environment variable `ETHEREAL` if you intend to develop email related features
38
+
37
39
```bash
38
40
$ yarn start
39
41
```
@@ -46,25 +48,40 @@ $ yarn start
46
48
-`REDIS_URL`
47
49
- Hostname of the redis server
48
50
-`default`: `localhost`
49
-
-`LOGO_SRC`_(optional)_
50
-
- Url to the main logo on all pages
51
+
-`ICON_SRC`_(optional)_
52
+
- Url to the main icon on all pages
51
53
-`default`: `/static/images/Abakule.jpg`
52
54
-`COOKIE_SECRET`
53
55
-**IMPORTANT** to change this to a secret value in production!!
54
56
-`default`: in dev: `localsecret`, otherwise empty
Make sure you have enabled Experimental Web Platform features and are using Google Chrome. Experimental features can be enabled by navigating to: chrome://flags/#enable-experimental-web-platform-features.
84
+
Make sure you have enabled Experimental Web Platform features and are using Google Chrome. Experimental features can be enabled by navigating to: **chrome://flags/#enable-experimental-web-platform-features**.
68
85
Please check that the USB card reader is connected. When prompted for permissions, please select the card reader (CP210x).
69
86
70
87
### Serial permissions (Linux)
@@ -105,7 +122,7 @@ $ yarn test
105
122
$ HEADLESS=true yarn test
106
123
```
107
124
108
-
## Vote occasion
125
+
## Vote Occasion
109
126
110
127
We have a list of every occasion vote has been used. If you or your organization use vote for your event we would love if you made a PR where you append your event to the list.
0 commit comments