README.md

Conplement Voting Tool

This is the repository of the conplement voting tool used in employee meetings

## Web Frontend (built with svelte) ⚡️

• Svelte
• Vite

Web Frontend (built with go, templ, htmx, alpinejs) ⚡️

• Go
• Templ
• htmx
• Alpine.js

Api Backend (built with go) ⚡️

Web api framework

• Go
• Gin-Gonic

Testing

• Testify
• Testcontainers

Live updates

• Centrifuge

Data storage

Redis

• Redis-Cloud
• Go-ReJSON

PostgreSQL

• Neon PostgreSQL

Hosting

• Azure App Service
• AWS Elastic Beanstalk

Get Started

Create an environment variables file

You can create a env.yaml file in the ./api directory by creating it manually from the env.template.yaml. This file contains no secrets. This application can use different storage types

• In Memory
• Redis
• PostgreSQL

You can configure the type in the env.yaml file, yet You have to fill in the PostgreSql connection string or redis endpoint

If you want to start the api with a redis or postgreSQL cloud storage you have to decrypt the env.enc.yaml using Mozilla sops. Please contact the developer team for further information.

Run the local application stack

If a env.yaml file is located in the ./api directory you can run the applications via the commands in the makefile

cd ./api
make up

You now can access the application on http://localhost:3333

Metrics (Grafana)

You can access a Grafana dashboard with RED (Rate Error Duration) Metrics on http://localhost:3050

Traces (Grafana)

You can also access Grafana dashboard for Traces via Grafana on http://localhost:3050

Logs (Grafana)

You can view application Grafana dashboard for Logs via Grafana on http://localhost:3050

Teardown application

cd ./api
make down

Local application stack architecture