pace

Pace is a registration and management application for running events and competitions.

Prerequisites

To run the application locally, you need to have colima installed and running, with

brew install colima
colima start

Also you need Rust and cargo, which you can install via:

brew install rustup
rustup-init

Even though the database runs from a container image, you still need an installation of postgres for the diesel_cli to work. It should not be running though!

brew install postgresql

Finally, the frontend uses node.js:

https://nodejs.org/en/

Running Pace

first install dependencies in frontend applications in /frontend/pace-ui

./run install

and then start both front and backend applications in corresponding folders (/frontend/pace-ui and /backend)

./run start

to restart the backend application after code change, exit with ctrl + c and start again with cargo run so existing docker can be reused

Accessing the database

docker exec -ti db psql pace3 -U pace3_user

Access the different endpoints using a browser or curl:

the frontend application runs on localhost:3000 but /admin doesn't work so now we use a proxy that routes to localhost:8089. the admin username is admin and password is xoh7Ongui4oo

Run script in backend

This script helps to run specific commands for your application. You can run the script as follows:

./run command

Commands:
  install           - Install application dependencies
  update            - Update application dependencies
  migrate           - Run database migration
  start             - Start the application
  fmt_check         - Run Formatting check by fmt
  test_unit         - Run all unit tests
  test_integration  - Run all integration tests
  lint_check        - Run linting check by clippy
  quality_check     - Static check (lint) and testing
  help              - Print cli usage message

Run script in frontend

Commands:
install - Install application dependencies
build - Build application to deploy
fmt - Run formatting
start - Start the application
lint - Run lint
tsc - Run Type check by tsc
quality_check - Static check (lint) and testing
help - Print cli usage message