vets-who-code / recruit_tracker

An administrative app used by https://vetswhocode.io/ volunteers to manage its students.

Vets Who Code Recruit Tracker App

The Vets Who Code Recruit Tracker App is a Ruby on Rails Applicaton designed for use my VWC Admins and new recruits. New recruits can apply to the program

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You will need the following properly installed on your computer.

• Ruby on Rails
• PostGreSQL technically this is optional; you can remove the pg from your Gemfile and use SQLite if you like.
• Ruby
• Node

Installing

In a terminal window run these commands.

$ git clone https://github.com/Vets-Who-Code/recruit_tracker.git
$ cd recruit_tracker
$ bundle
$ yarn
$ rails db:migrate
$ rails db:seed

You should be able to view the website locally at http://localhost:3000/. See db/seed.rb for users and passwords.

Testing:

• run "rails test test/models/user_test.rb" to run an indivigual test
• capybara test with "rspec spec/hello_world_spec.rb"

Features:

• Admin users have admin flag and can view all cohorts and change recruits profile status
• Recruits have the ability to edit their profile and change their status to submitted
• Recurits and admins receive an email when any status change to their profile happens

See requirements & features here: https://docs.google.com/document/d/12xfq87nB4wL5cHRbpgwGNQEEaqPjTltBfpE6n7HeLXE/edit?usp=sharing

recruit_tracker's Issues

General UI/Nav issues for non-admin users

• "List of Recruits" link should not appear in nav bar
• When a user is viewing their profile "Back to list of Recruits" link at the bottom should not be their
• /welcome should have more appropriate text
• How does the user edit their profile to add/update info

Email Notifications

Email notifications

• when user signs up
• when either admin or recruit changes a profile status; content of email include what the status change was; ie. submitted to needs more work; submitted to accepted...ect

Change user/cohort association

We need the ability (in the UI) to change the cohort a user (recruit)is associated with.

Do we need a roles join table?

Its possible our users could have multiple roles (admin and mentor) so we may want a roles join table with a HABTM relationship b/t role and users.

Create Cohort

We need to be able to add cohorts to the system.

An applicant should be associated with a cohort.

Possible set a current cohort in the system so all applicants have their co hort currently set.

Investigate if we should be using enums for roles and profile_status

I'm feeling like we need to standize things like user rols and profile status. enums might be a good solution for this https://api.rubyonrails.org/v5.2.5/classes/ActiveRecord/Enum.html

Users show view is using current_user rather than @user

app/views/users/show.html.erb is using current_user so when logged in as an admin and you click the "show" links you see the logged in users info regardless of what users you select. I think using the @user instance variable set in the controller should fix this.

Admin Dashboard

What will the admin landing page (dashboard) contain?

• List of current applicants (current cohort)
• Filter applicants by cohort (view past cohorts)

Add a "Ready for Review" button for recruits

Once a recruit is read for their profile to be reviewed they should have a "Submit for Review" button. When the user clicks the button the following should happen:

-users profile status should go from "applied" to "under review"
-an email should be sent to both the recruit and to one or more admin users notifying them of the status change

Clean Up ReadMe

As an open-source contributer,
I would like these things to be on the readMe:

VWC Branding?
What It Is?
Why Do We Need It?
Who Is It For?
The Open Source License.