TecPortal is a Ruby on Rails web application which hosts many smaller applications which interact with Attendance on Demand (AoD), and allows users to access different applications depending on their user permissions. It uses Devise to provide authentication, and a Postgres database to store the users, permissions, and plugin data. It incorporates several features:
- There is a landing (home) page for all visitors initially. Once logged in as a user, each user has their own dashboard, and during their session this becomes their home page.
Before creating the application, you will need:
- The Ruby language (version 1.9.3)
- Rails 3.2
First, clone the GitHub repo:
$ git clone https://github.com/timeequipment/tecportal.git
Then install the gems:
$ bundle install
Run the following to re-create your database:
$ rake db:migrate VERSION=0
$ rake db:migrate
Then run the following to create your initial users, including the admin user:
$ rake db:seed
Finally, test the application:
$ rails server
TecPortal uses RailsAdmin to manage the website. To access it, navigate to /admin and you will be prompted for an admin login. Admin users cannot be created online for security purposes. They must be created via command-line. See the db/seeds.rb file for the initial admin login (assuming you ran $ rake db:seed above).
TecPortal relies heavily on the Devise gem to perform user authentication. For more information, see the documentation for Devise or the GitHub repo.