Skip to content
This repository was archived by the owner on Jun 7, 2024. It is now read-only.

codeday-labs-2021/event_lottery

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lottery Event

Event Lottery is a service & web application for weighted lottery based event registration that utilizes SMS notifications.

Description

Event Lottery is a website anyone can use create events and invite friends, but the service holds a lottery in order to determine who receives a formal invitation. Useful for cases where you have reoccurring IRL events with limited capacity, and where you want people who haven't had the chance to attend to have a higher chance of being chosen than those who've attended before.

Technologies

Frontend:

  • React
  • React Bootstrap
  • React Router
  • Axios (HTTP client)

Backend:

  • Golang
  • Fiber (Web framework)
  • GORM (PostgreSQL ORM)
  • JSON Web Token (Authentication)
  • AWS EC2 & RDS (Deployment)
  • Twilio API

Setup

Prerequisites

Frontend

In the project directory,

$ cd frontend
$ npm install
$ npm start

Backend

$ cd backend
$ go run main.go

Environment Variables

Frontend

Create a .env file in the frontend directory,

NODE_ENV='development'
REACT_APP_BACKEND_API=http://localhost:4000

Backend

Create a .env file in the backend directory,

PORT=":4000"
HOST=
DBPORT=
NAME=
DB=
PASSWORD=
TWILIO_SID=
TWILIO_TOKEN=
TWILIO_PHONE_NUMBER=

Features

  • SMS-based notifications and confirmations (two-way SMS)
  • Event creation and registration
  • Rescheduling and cancelling occurrences
  • Tracks registered users' created events and upcoming occurrences
  • Weighted lottery raffle with penalities for absent attendees
  • Signup, login, logout

Contributors

Feel free to connect with us on LinkedIn!

About

Event Lottery System with SMS notifications

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •