Job Tracker User Guide
http://rubyforge.org/projects/jobtracker/
Licensed under the GNU GENERAL PUBLIC LICENSE, Version 2, June 1991
(full text included in the software distribution).
Table of Contents
Overview 4
Problem 4
Solution - Application Domain 4
Job Tracker Application Project Page 4
Navigation 8
Login 8
Add a Task 14
Searching 16
Tasks Due 19
Claims 20
Reports 21
Illustration Index
Illustration 2: Login Screen 8
Illustration 3: Position States 9
Illustration 4: Position - Add 10
Illustration 5: Position - Added Successfully 12
Illustration 6: Comment - Add 13
Illustration 8: Position - Details with Tasks, Comments 15
Illustration 9: Search - Input Form 16
Illustration 10: Search Results 17
Illustration 11: Search Results showing Details 18
Illustration 13: Claim - Add 20
Job Tracker provides an improved way to track your job prospects and increase your job hunting efficiency.
Many web sites provide job listings, but do not provide an easy means to track the status of the position, or ability to enter comments, or capability to task yourself to do the follow-up calls, emails, and 'Thank Yous'. Also, most job seekers use several web sites or other means to search for jobs. Some innovative job seekers attempt to track their job hunting via emails, documents, or even elaborate spreadsheets. Other issues? You receive a call from a recruiter, but where are the notes from the previous meeting? You need to call them back, what is their phone number? Searching through disparate systems is difficult, to say the least!
Job Tracker provides the means to track your prospects (called positions), and set the status of the positions. To support the content of a Position, many Comments (date stamped) may be attached to each Position. Also, many Tasks (suspense date - due date) may be attached to each Position. Job Tracker is a tool to collect and organize your job seeking efforts, regardless of how many different resources used in your job search. This is one area you really want, and need, the power of a database! You can search for all key information and see highlighted results instantly! The system is not over-engineered, not entirely 'normalized', but as a work in progress has been tuned to work well for the average job seeker and tracker.
The Job Tracker Application can be downloaded from the project web site at http://rubyforge.org/projects/jobtracker/
Requirements:
RAILS > 1.1 or greater
MySQL > 4.1 or greater
Ruby > 1.8.2 or greater
Unzip into any directory.
Starting:
- Server
> cd $job_tracker directory
> ruby script/server
- Client (Web browser)
Enter URL "http://localhost:3000/"
The following use cases document what Job Tracker does.
Legend for Use Case actions:
Green = Creation
Dark green = Base level object (parent), i.e. Position
Light Green = 2nd level (child), i.e. Comment attached to a Position
Yellow = Edit
Red = Delete
Red = Base level object
Light Red (Pink) = cascaded delete when parent is deleted
Blue = Associations
* Companies (base level object) and associations are not yet supported as of this release.
Start by entering URL http://localhost:3000/
To support some degree of security, this can be turned on/off. See development notes.
Enter user name and password.
To set initial account info, navigate to http://localhost:3000/user/signup
The state diagram displays the various states a 'Position' may be in. The user normally manually changes the states by editing the Status. The 'flow' (state transitions) are not enforced or tracked, but provide a general usage guidance of how most states would change.
Definitions:
Active - Position that you are interested in.
Inactive - Position that you are no longer interested in, or hve not received any feedback in for quite some time.
Negotiation - Position that is being interviewed for, received an offer letter on, etc.
Accept - Position you have taken
Rejected - Position you have turned down.
Closed - Someone else was hired.
Archive - An Inactive or Rejected Position that is 'stale' and can be archived.
* Note - The Menu option 'Administration' provides a means to 'bulk' move Position states from Active to Inactive, and from Inactive and Rejected to Archive.
Enter a Title, etc.
Note that the 'text' fields (description, skills, and salary) can store up to 65536 characters. 'Created on' and 'Updated on' are automatically set by the application.
Sent On = Date applied for the job, date you sent in your resume.
Scroll down to the bottom to Save the record.
The Main Menu will update the total 'count' of Positions and by State.
|
Field |
Type |
Null |
|---|---|---|
|
title |
varchar(255) |
|
|
description |
text |
YES |
|
skills |
text |
YES |
|
status |
varchar(16) |
|
|
company |
varchar(255) |
YES |
|
address |
varchar(255) |
YES |
|
contact |
varchar(255) |
YES |
|
phone |
varchar(255) |
YES |
|
|
varchar(255) |
YES |
|
sent_on |
date |
YES |
|
created_on |
date |
|
|
updated_on |
date |
|
|
salary |
text |
Table 1: Position Fields
After adding Tasks and Comments, the details for a Position.
The Tasks and Comments are hyperlinked for direct Detail and optional Edit views.
Click on Search for the input form. The results will dispaly what was searched for as well as the number of records and the text will be highlighted.
Each record is linked for a detail view of the record.
Note: Leaving the input form empty (Blank) will return ALL records
The results are presented in summary form ...
Clicking on the linked element (highlighted green here, as the mouse is hovering over it at this point in time) will present the detailed screen.
All instances of the matching text are highlighted.
Note: Although the Comments and Tasks are NOT part of the Search for Positions, the 'displayed' text WILL be highlighted if it also contains the same phrase as was searched for.
Please also note, the Comments and Tasks have individual Search functions for complete searching on those records.
* Comments and Tasks are truncated to 255 characters on the Position Details screen, although they can hold up to 64K characters EACH!
The Tasks Due link provides a quick view of what is due or overdue.
Red is overdue by MORE than 1 day.
Pink is overdue by 1 day (Yesterday)
Yellow is due Today
Light Green is due Tomorrow
Dark Green is due in more than 1 day form today (in the future starting from day after Tomorrow)
Editing a Task and marking its completion date removes it from the Tasks Due queue
This link provides facility to create Unemployment Claims
The Report Menu is for common reports.
NOTES: