rileyshannon / skyOS

skyOS is a web-based virtual airline management system written in Rails

Home Page:https://lonestarcargo.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SkyOS

Verify Maintainability codecov

⚠️ skyOS has been retired and receives limited maintenance updates ⚠️

skyOS is a web-based virtual airline management system written in Rails and used by Lonestar Cargo.

It is an open-source project that may be used by anyone running a Virtual Airline. We encourage forks and pull-requests for new features and fixes!

Development Getting Started

Developed with Ruby: 2.7 / Rails: 6

To get the Rails server running locally:

  • Clone this repo
  • bundle install to install required dependencies
  • yarn install --check-files install front-end dependencies
  • configure .env file for development/test databases (see .env.template)
  • rake db:prepare to create and seed database
  • rake skyos:install (optional) create an administrative user and load helpful defaults
  • rake skyos:create_admin (optional) instead of install to create an administrative user only.
  • rails s to start the local server

External Dependencies

Getting Started with Docker

Container Images

From repository

This repository builds and releases a Docker image to our GitHub Docker repository. See docker-compose.yml.example for an example on how to pull the latest release and customize for your production environment.

Building your own image

This repository comes equipped to be run within Docker. The easiest way to build your own image is using docker-compose.

Build the Docker image using:

% docker-compose build

Configuration

On first boot, the image will connect to the database specified in your docker-compose.yml or to the PostgreSQL server specified via environment variables (see docker-compose.yml.example)

Load defaults and create an initial administrative user:

% docker-compose run --rm app rake skyos:install

Optionally populate the airports table (courtesy OurAirports)

% docker-compose run --rm app rake skyos:load_airports

After setting up, you can run the application and dependencies:

% docker-compose up -d

Configuration

Environment Variables

Syntax Description
DATABASE_URL required Database URL see docker-compose.yml.example
RAILS_HOSTNAME required External hostname for application
REDIS_URL required Redis URL see docker-compose.yml.example
SECRET_KEY_BASE required Key used to sign messages and encrypt cookies
SMTP_SERVER required Mail server, example: smtp.example.com
SMTP_PORT optional Mail server port, default: 25
SMTP_DOMAIN optional Defaults to RAILS_HOSTNAME
SMTP_USERNAME required Mail service username
SMTP_PASSWORD required Mail service password
SMTP_AUTH optional Defaults to plain

Rails Settings

The Setting model contains settings that can be changed while the application is running. Administration of these settings can be performed live by visiting the Admin -> Settings page while logged in with an appropriate user account.

See app\models\setting.rb for defaults.

Initial administrator

When users are registered, they automatically join the default Pilot user group. To create an initial administrative user run the following rake task:

rake skyos:create_admin

This will prompt you for the user attributes and assign the user administrative privileges.

Upgrading

Docker

docker-entrypoint.sh runs at container start and will automatically attempt to migrate and seed the database with changes as necessary.

Manual

If the app is using a different environment then it may be necessary to run the following steps after upgrade:

rake db:migrate
rake db:seed

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Ensure all test pass with appropriate coverage (COVERAGE=true rake spec)
  4. Lint your changes appropriately (rubocop)
  5. Check for any new security issues (brakeman)
  6. Commit your changes (git commit -am 'Add some feature')
  7. Push to the branch (git push origin my-new-feature)
  8. Create new Pull Request

About

skyOS is a web-based virtual airline management system written in Rails

https://lonestarcargo.org

License:MIT License


Languages

Language:Ruby 69.8%Language:Haml 22.5%Language:JavaScript 3.1%Language:SCSS 2.3%Language:HTML 1.9%Language:Dockerfile 0.4%Language:Shell 0.1%Language:Procfile 0.0%