What's LetsHire?
LetsHire is a hero application for Tempest project. It provides a fancy web management console for recruiting, more specific, user can track job openings' lifecycle and candidates' interview progress easily through this web application.
Based on a fine-grained role-based access control, LetsHire demonstrates a easy-to-use web UI to users. Each user, with one or multiple roles, after successful login, can see his/her own action items on the dashboard web page at first glance, furthermore, he/she can navigate to the action page directly, without the need to click lots of buttons or links.
Introduction
LetsHire is written with Rails3 framework. It can run either on Platform such as VMware Tempest or Cloud Foundry, or in your local box. It uses PostgreSql preferably to store persistent data, such as candidate's resume. Since service binding logic is well-designed so you can easily bind it to other kind of database service, such as MySQL.
Rails3 is a web application development framework written in the Ruby language. It is designed to make programming web applications easier by making assumptions about what every developer needs to get started. It allows you to write less code while accomplishing more than many other languages and frameworks. LetsHire is constructed on top of the Rails3, relies heavily on Rails3 MVC model to implement the data access layer and the backend business logic. Besides these things, LetsHire also exposes some RESTful APIs, mobile applications can call these interfaces to update interview status.
PostgreSql is used to act as RDMS to store persistent data, such as job opening information, candidate's resume.
The web visual part of LetsHire is built by HTML/CSS/Javascript, the following major 3rd party libraries are introduced in LetsHire.
Bootstrap is a front-end framework for faster and easier web development.
jqplot-rails is a plotting and charting plugin for the jQuery Javascript framework, jqPlot produces beautiful line, bar and pie charts.
jquery-rails is a gem to automate using jQuery with Rails 3.
Architecture overview
Installation
- Download source code from github
- git clone git@github.com:vmw-tmpst/heroapp-LetsHire.git
Prerequisites
- ruby-1.9.3
Run in your local box
-
Create the gem set for the project:
- rvm use 1.9.3-p327@lets-hire --create
-
Run bundler:
- bundle install
-
Start the server:
- rails server
-
Run unit tests:
- rake db:migrate
- rake
Run on Tempest or CloudFoundry
-
Install cf which is a CloudFoundry management client provided by VMware
- gem install cf
-
Login cloudfoundry environment
- cf target api.run.pivotal.io
- cf login [EMAIL]
-
Run bundler:
- bundle package
- bundle install
- bundle exec rake assets:precompile
-
Push app to cloudfoundry
- cf push
User initialization
access http://[host]:[port]/init through http POST request, then web browser will redirect a page to setup admin account.
The story between you and LetsHire web application starts from now on ...
Usage
Login http://[host]:[port]/ with the admin account, after successful login web browser will redirect you to the dashboard page.
User roles definition
There are 4 kinds of user roles, by default, each user has a 'interviewer' role. Let's category all kinds of operations which LetsHire allows us to do.
Operations
A. create/update/delete users
B. create/update/delete job openings
C. create/update/delete candidates
D. arrange interviews
E. update interview feedback
Roles
-
admin
- operation types: A, B, C, D
-
hiring manager
- operation types: B, C, D
-
recruiter
- operation types: C, D
-
interviewer
- operation types: E
Departments management
Currently LetsHire provides separate web pages to manage jop openings/candidates/interviews, but does not provide any visual interface to manage departments. The departments value are fixed, see the DEFAULT_SET definition of app/model/department.rb .