campass is a system that simplifies the process of inviting and admitting guests to various events.
Users can easily invite their guests to an event by adding them to the system, invited guests can then log in to the system to get their entry pass as a QR code which can be scanned at the event entrance to let them in.
The system enables easy and convenient guest entry via a smartphone.
Media
The system is deployed using docker compose.
It has the following services:
- ngnix (For combining the frontend and backend)
- backend
- dozzle (for viewing logs)
- shynet (for analytics)
- Node.js
- TypeScript
- Fastify
- knex.js
- Sqlite as the database
- React
- TypeScript
- Axios
- NextUI as the UI library
- Zustand for state management
- Sass
- Typed scss modules for scss typing
For local development you will need to install Node.js.
Run npm install in both the backend and frontend directories.
For both the frontend and the backend copy the .env.example file to .env and fill in the required variables.
Run npm run migrate and npm run seed in the backend directory.
Simply run npm run dev in both the backend and frontend directories.
Edit the compose file and fill in all the environment variables.
Create a nginx/.htpasswd file to protect the service.
(This tool can be used to generate the file.)
Start the services using docker compose:
docker compose up -dCreate an admin user:
docker exec shynet ./manage.py registeradmin <email>On the first run, it's necessary to run migrations to create the tables.
Execute the following command inside the container:
docker exec backend sh -c "npm run migrate"Alternatively, you can pass in environment variable to the container to run the migrations on start:
RUN_MIGRATIONS=true
Tests are written using Jest, and run automatically on every push using GitHub Actions.
To run the tests locally, simply run npm run test in the backend directory.