No description, website, or topics provided.
Java CSS HTML JavaScript Shell
Latest commit 4631afd Nov 12, 2016 @varahamihira varahamihira committed on GitHub Merge pull request #5 from danielhjames/master
Add installation documentation
Permalink
Failed to load latest commit information.
common Initialise repo Oct 31, 2016
paf-client Initialise repo Oct 31, 2016
paf-stub Initialise repo Oct 31, 2016
tools Initialise repo Oct 31, 2016
web-client Initialise repo Oct 31, 2016
web-server Initialise repo Oct 31, 2016
.gitignore Initialise repo Oct 31, 2016
INSTALL.md Make it pretty Nov 11, 2016
LICENSE Update LICENSE Nov 10, 2016
README.md Update README.md Nov 10, 2016
pom.xml Initialise repo Oct 31, 2016

README.md

[This project is no longer maintained]

vics

Voter Intention Collection System. An application to collect voting intentions

Stack

The UI is written in JS, HTML and CSS using AngularJS (v1.4) as a client side SPA.

The web app serving the client is written in Java. Spring Boot is the web framework. Data between the UI and server is REST over HTTP serialized as JSON. PDFs are generated on the server and returned to the client as byte arrays.

A security system is implemented using Spring security and Redis for session state persistence. The application should be deployed using TLS.

PostgreSQL is used for persistence.

Build & Test

The build depends on a running redis and postgres (in future we should switch to the embedded versions for easier testing...) Install redis and ensure the redis server is running locally. A simple approach is to run redis with docker.

Install postgres and create a database locally called canvassapp with username postgres and password postgres then run the database creation script vics/web-server/src/test/resources/sql/drop-create.sql

Install maven 3 and Java 8, then test and build the entire project from the root directory as follows

mvn clean install

This will generate a /dist folder that contains all artefacts for deployment - minified javascript/html/css, java server as a fat jar and the database installation scripts that contain reference data.

Project Modules

* paf-client - client library to call the upstream voter api
* paf-stub - mocks the upstream voter api. Can be executed from tests and run standalone
* web-server - the main web application that provides data to the UI and manages users (Java/Spring Boot)
* web-client - the user interface (AngularJS app)
* common - utilities and language extensions that can be reused across all modules
* tools - scripts and tools for managing data and deploying the application