Alpha SOFIA

The source code belonging to Alpha SOFIA. It is a system built with Ruby on Rails with Turbolinks and a little VueJS, used to manage orders in our own bar "Flux". Users authenticate via OAuth API (currently "Alpha AMBER") or through the builtin login portal to see how much credit they got left, or to be able to register new orders and/or payments.

Use this repository to build upon, use as-is, learn from it, prove a point or whatever 😏

Prerequisites

On Linux-like systems

• Ruby (see .ruby-version)
• Bundler (gem install bundler)
• NodeJS (see .nvmrc)
• Yarn
• Postgresql 14.7+

Installation

1. Clone this repository
2. Run the following commands:
3. bundle install (might take a couple of minutes)
4. yarn install
5. bundle exec rails db:setup
6. bundle exec rails s -b 0.0.0.0 -p 5000
7. Go to http://localhost:5000 and you should see SOFIA running
8. Copy .env.example to .env with cp .env.example .env and edit the values where necessary
9. (When you want to use the invoice module) Follow https://github.com/zakird/wkhtmltopdf_binary_gem#installation-and-usage

Credentials

Before you can start the application you will need the master.key. Ask a fellow developer for it, or pull it from the server via ssh.

When the master.key is present, you can use bundle exec rails credentials:edit to open the default editor on your machine to read and edit the credentials. Be informed: these are production credentials so be careful.

Read more about Rails credentials on EngineYard.com.

$ EDITOR=nano bundle exec rails credentials:edit

Configuring roles

Users can have roles in SOFIA, namely Treasurer ("SB-penningmeester"), Renting manager("Verhuur")and/or Main Bartender ("Hoofdtapper"). A user can also log in without a role. These roles are derived from the groups the user is in. These groups are saved in the AMBER API.

Roles are created in the following way during the seeding:

Role.create(role_type: :treasurer, group_uid: 4)
Role.create(role_type: :renting_manager, group_uid: 5)
Role.create(role_type: :main_bartender, group_uid: 6)

Testing & Linting

To Run the test locally the following command can be used

bundle exec rspec

To run the linting locally you can use the following commands

yarn lint
yarn run sass-lint -v -q
bundle exec rubocop

Deploying

Deploying procedure is the same as for the AMBER project. See DEPLOY.md for that.

Contributing

When contributing, please consult with the repository owners in advance to ensure a high chance of PR-success. PR-success means you're PR is merged and you'll be mentioned in the contributors list 🎉.

When submitting a PR, it'll need to be approved, but once approved (and green) you're responsible yourself for clicking the merge button and enjoying the intense feeling of satisfaction!

Contributors

• @cmitz
• @Matthijsy
• @cpbscholten
• @wilco375
• @guidojw
• @ellen-wittingen
• @jorai