amandeepsingh5 / gams_springboot

Graduate Attribute Management System: Developed it using Java Spring framework such as Spring MVC, Spring Security, Spring Data Repositories, JavaScript, HTML,CSS and Thymeleaf.

Heroku

Graduate Admissions Management System

SYSC4806 - Group 3

#Deployment - (https://group3-gams.herokuapp.com/login)

Hasan @hasanissa25

Amandeep Singh@amandeepsingh5

Zoha Mehdi

Tahereh Ghadiri Modarres

Tashfiq Akhand @tashfiqakhand

Project Description

Applicants submit their file containing their personal info, their desired field of research, a list of profs they want to work with, and various documents such as their CV, a copy of their diploma, grade audit, by a certain deadline. Profs submit a profile specifying their fields of research. The applicant files can be filtered/selected by an administrator. Those that are considered good enough are routed to profs for evaluation by a deadline. Profs receive an email notification to go check the list of new applicants assigned to them. They evaluate the student by studying their application info, and enter their assessment: “don’t recommend for admission”, “recommend but not interested in supervision”, “recommend but no funding”, “recommend and yes to funding”. The admin can then view the recommendation of the profs and make a decision.

Overall Workflow

1. An Applicant creates an account
2. Applicant submits their file with their corresponding information
3. A Professor submits their profile specifying their fields of research
4. Administrator filters applications and chooses certain applications to route to the professor
5. Professor receives an email notification to go check the list of new applicants assigned to them
6. Professor opens the list of applicants
7. Professor reviews the applications of each applicant, and make an evaluation decision for them.
8. Administrator views the recommendation of the professor and makes a decision.

List of project Use Cases

List of actors:

• Applicant
• Professor
• Administrator

Use Case 1: User Creates Account

Primary Actor: Applicant , Professor , Administrator

Use Case 2: User Logs in

Primary Actor: Applicant or Professor or Administrator

Use Case 3: Applicant Submits Application

Primary Actor: Applicant

Use Case 4: Professor Manages Profile

Primary Actor: Professor

Use Case 5: Administrator Screens Applicants

Primary Actor: Administrator

Use Case 6: Administrator Evaluates Applicants

Primary Actor: Professor

Use Case 7: Administrator Makes Final Decision on Applications

Primary Actor: Administrator

Project Milestone 1: (March 6,2020)

• Set up project; Travis CI, Heroku, and GitHub.
• Functionality: Applicant Login, Professor Login, Professor Creates a Field Of Research, Applicant can view field of research.
• the Kanban
• Unit and Integration tests
• the Issues and Code reviews

Project Milestone 2: (March 20,2020)

• Applicant Functionality:

  • Create a profile
  • Join a Professors Field Of Research.

• Administrator Functionality:

  • Register an account
  • Login to the system
  • Administrator can view the data (email,cv, diploma and grade audit) submitted by the student
  • Administrator can select a student profile and send to the professor(to whose field of research the student applied to).

• Unit and Integration Tests for all the functionalities

• The Kanban

• Issues and Code Reviews

• UML, ER diagram and Database Schema

Database Schema for Milestone 2:

FieldOfResearch

• id
• description
• emailAddress

EndUser

• id
• confPassword
• password
• role
• username

Student

• id
• email
• cv
• diploma
• grade audit

Steps To Verify Functionality (For the marking TA)

• Run the application: https://group3-gams.herokuapp.com/login

• Professor Functionality: Create a Field of Research.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Professor Role, and any username and password combination. (Case Sensitive)
  • Login using the Professor account created in the previous step.
  • Click Create Field Of Research, to be redirected to the creation page of field of research.
  • Enter the desired Title and Description for your field of research and click Add Field Of Research to submit it.
  • Click logout at the top right of the page to prepare for the next step.

• Student Functionality: Create a student profile, and request to join an existing field of research.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Student Role, and any username and password combination. (Case Sensitive)
  • Login using the Student account created in the previous step.
  • Click Create Student profile, to be redirected to the student profile creation page.
  • Enter an Email, CV, Diploma, and your Grade Audit. (Currently set to text fields but will be made into documents in the upcoming milestones), and click Save to submit.
  • Click Available Fields Of Research, click the Actions button on the field of research you are interested in, and click Select, to request to join.
  • Click Home at the top left of the screen, and click Current Application. You can now see your student profile, including the fields of research you applied to.

• Administrator Functionality: View current Student Applications.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Administrator Role, and any username and password combination. (Case Sensitive)
  • Login using the Administrator account created in the previous step.
  • Click Current Student Applications
  • Here you can view all the current applications students have made.
  • You can click the Send Email button, to generate an email notification to the professor responsible for the Field Of Research that specific student applied to.

Project Milestone 3: (April 3,2020)

• Security Functionality:

  • Added authorization and authentication to the endpoints.
  • Only the specific role can view their given functionality, and a 403 error page is given to any other role trying to access that functionality.

• Professor Functionality:

  • Professor can view the students who applied to their field of research.
  • Professors can choose the students who they thinks are best, and they can submit a recommendation to the administrator.

• Administrator Functionality:

  • By clicking the Decision Release you can view all the emails of the student along with the recommendation that the professor have made for each Student which includes:
    • Don't recommend for admission.
    • Recommended but not interested in supervision.
    • Recommend but no funding.
    • Recommend and yes to funding
  • Administrator can view the professors recommendation, and accept the ones they choose.
  • You can click the send Email button, to generate an email notification to the student about what have been recommended for them.

• Unit and Integration Tests for all the functionalities

• The Kanban

• Issues and Code Reviews

• UML, ER diagram and Database Schema

Database Schema for Milestone 3:

FieldOfResearch

• id
• description
• emailAddress

EndUser

• id
• confPassword
• password
• role
• username

Student

• email
• cv
• diploma
• grade audit
• hasFOR
• hasProfile

Professor

• fieldOfResearches
• emailAddress

Candidate

• id
• decision
• email

Email

• id
• toField
• fromField
• readFlag

Steps To Verify Functionality (For the marking TA)

• Run the application: https://group3-gams.herokuapp.com/login

• Professor Functionality: Create a Field of Research.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Professor Role, and any username and password combination. (Case Sensitive)
  • Login using the Professor account created in the previous step.
  • Click Create Field Of Research, to be redirected to the creation page of field of research.
  • Enter the desired Title and Description for your field of research and click Add Field Of Research to submit it.
  • Click logout at the top right of the page to prepare for the next step.

• Student Functionality: Create a student profile, and request to join an existing field of research.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Student Role, and any username and password combination. (Case Sensitive)
  • Login using the Student account created in the previous step.
  • Click Create Student profile, to be redirected to the student profile creation page.
  • Enter an Email, CV, Diploma, and your Grade Audit. (Currently set to text fields but will be made into documents in the upcoming milestones), and click Save to submit.
  • Click Available Fields Of Research, click the Actions button on the field of research you are interested in, and click Select, to request to join.
  • Click Home at the top left of the screen, and click Current Application. You can now see your student profile, including the fields of research you applied to.

• Administrator Functionality: View current Student Applications and send email to the professor.

  • Click Register Now, to go to the registration page.
  • For Role, choose the Administrator Role, and any username and password combination. (Case Sensitive)
  • Login using the Administrator account created in the previous step.
  • Click Current Student Applications
  • Here you can view all the current applications students have made.
  • You can click the Send Email button, to generate an email notification to the professor responsible for the Field Of Research that specific student applied to.

• Professor Functionality: View the students profile selected by the administrator and make a decision.

  • Login using the Professor account created in the previous step.
  • Click Field of Research Candidates
  • Here you can view all the students profiles that the administrator recommended.
  • Now the professor can post their decision along with the email of particular student.

• Administrator Functionality: Can view the professor decision and then send the decision to the student as a email.

  • Login using the Administrator account created in the previous step.
  • Click Decision Release
  • Here you can view all the student recommendations made by the professor.
  • You can click the Send Email button, to generate an email notification to the student containing the decision made by the professor.

• Note: All the functionalities mentioned in the Project description were completed