Skip to content

Vasileios20/JobAppTracker

Repository files navigation

ELEVATE 2024

This project was made as an entry to Elevate Hackathon, October 2024, organized by Code Institute logo

elevate

Django Python JavaScript Bootstrap Heroku

Git Hired πŸš€

Because your job hunt shouldn't feel like searching for a needle in a digital haystack!

Welcome to Git Hired, your new best friend in the job application jungle. Born in the crucible of the Elevate Hackathon, Git Hired is here to turn your job search from a chaotic mess into a well-oiled machine. (We can't guarantee you'll get hired, but at least you'll know where you applied!)

The project is deployed and can be accessed at: https://jobtracker-team4-b6fdc54fc148.herokuapp.com/

Table of Contents

User Stories

  1. As a job seeker, I want to enter my job title so that I can generate relevant interview questions tailored to my role.

  2. As a job seeker, I want to view a list of generated interview questions after submitting my job title.

  3. As a job seeker, I want to provide my answers to the generated questions and submit them for evaluation.

  4. As a user, I want to see AI-generated feedback on my answers.

  5. As a user, I want to revisit previously generated questions and answers.

  6. As an administrator, I want to manage user submissions and feedback.

  7. As a new user, I want an intuitive interface that guides me through the process.

  8. As a user, I want to receive success messages after successfully generating questions or submitting answers.

Return to Table of Contents

Features

  • Application Tracking: Keep tabs on your job applications like a pro stalker (but legal and for your own stuff).
  • Dashboard View: Get a bird's eye view of your job hunt. It's like Google Maps, but for your career!
  • Search and Filter: Find that one application faster than you can say "I'm perfect for this job!"
  • Status Updates: From "Applied" to "Hired" (or "They ghosted me"), track it all.
  • Notes and Comments: For when you need to remember that the interviewer had a cat named "Mr. Whiskers" (it might be important, you never know).
  • Analytics: Impress your friends with fancy graphs about your job search. Who said unemployment can't be fun?

Homepage

alt text alt text alt text

Return to Table of Contents

Installation

  1. Clone the repo:
    git clone https://github.com/your-username/git-hired.git
    
  2. Navigate to the project directory:
    cd git-hired
    
  3. Install dependencies:
    pip install -r requirements.txt
    
  4. Set up the database:
    python manage.py migrate
    
  5. Start the server:
    python manage.py runserver
    

Return to Table of Contents

Usage

  1. Create an account (we promise we won't sell your data to job recruiters... or will we? πŸ‘€)
  2. Log in and start adding your job applications
  3. Use the dashboard to track your progress
  4. Update application statuses as you go
  5. Celebrate when you finally Git Hired! πŸŽ‰

Return to Table of Contents

API Documentation

For those who like to peek under the hood, check out our API documentation.

Return to Table of Contents

Contributing

We welcome contributions! Please check out our Contributing Guide for details on how to get started. Don't worry, we don't bite (unless you write bugs, then we might nibble a little).

Return to Table of Contents

The Dream Team

Meet the caffeinated coders behind Git Hired:

Vasi "The Visionary" πŸ‘οΈ

  • Frontend Maestro
  • Turns caffeine into pixel-perfect UIs
  • GitHub | LinkedIn

Erin "The Energizer" ⚑

  • Full Stack Dynamo
  • Codes faster than the speed of light (almost)
  • GitHub | LinkedIn

David "The Debugger" πŸ›

Ciaran "The Connector" πŸ”—

  • API Alchemist
  • Connects dots and databases with equal ease
  • GitHub | LinkedIn

Marlon "The Mastermind" 🧠

  • Architecture Aficionado
  • Builds systems that even Skynet would envy
  • GitHub | LinkedIn

Kim "The Kode Whisperer" 🀫

  • UX/UI Enchanter
  • Makes our app look prettier than your Instagram feed
  • GitHub | LinkedIn

Return to Table of Contents

License

This project is licensed under the MIT License - see the LICENSE.md file for details. (It's MIT because we're too busy job hunting to write our own license.)


Remember, in the world of job hunting, it's not about the destination, it's about the journey. And with Git Hired, at least that journey will be well-documented! Happy job hunting! πŸŽ‰

Return to Table of Contents

Entity-Relationship Diagram (ERD) Design

This ERD outlines the database schema for the Git Hired application. It includes three main models: Job, Goal, and Note, each associated with the User model.

Job: Represents job applications, including details such as the category, company, title, location, application status, and the date applied. Goal: Tracks user-defined career goals. Note: Allows users to add notes related to specific job applications, with timestamps for creation and updates.

The relationships between the models are defined as follows:

A User can have multiple Jobs and Goals. Each Job can have multiple associated Notes.

alt text

Return to Table of Contents

Wireframes

  • We used Balsamiq to design the wireframes for us website.

Desktop:

Desktop Home page

Desktop Hoome page

Desktop Home page

Desktop Home page

Desktop Team page

Desktop About page

Desktop Job Form page

Desktop Job page

Desktop Statistics page

Desktop Statistics page

Return to Table of Contents

Performance

The Git Hired website was assessed with Google Lighthouse via Google Chrome Developer Tools. Performance scores were evaluated for both desktop and mobile devices.

Desktop Performance

  • The average score for the pages was 90/100 and the majority of the pages getting an excellent performance of over 90/100
Tested Performance Score View Result Pass
homepage 100 / 100
Screenshot of resultResult
βœ…
about 85 / 100
Screenshot of resultResult
βœ…
Job Application 99 / 100
Screenshot of resultResult
βœ…
Practice 74 / 100
Screenshot of resultResult
βœ…

Mobile Performance

  • The average score for the pages was 80/100 and the majority of the pages getting an good performance of 70/100
Tested Performance Score View Result Pass
homepage 95 / 100
Screenshot of resultResult
βœ…
about 85 / 100
Screenshot of resultResult
βœ…
Job Application 99 / 100
Screenshot of resultResult
βœ…
Practice 74 / 100
Screenshot of resultResult
βœ…

Return to Table of Contents

Technologies Used

Languages

  • HTML: Used for structuring the content on the web pages. It forms the backbone of the project, ensuring that all elements are correctly placed and accessible.

  • CSS: Used for styling the HTML elements, providing the visual appearance and layout of the web pages. CSS ensures the platform is visually appealing and user-friendly.

  • JavaScript: Adds interactivity and dynamic behavior to the web pages. It enhances the user experience by allowing for real-time updates, form validations, and interactive elements.

  • Python: a primary programming language for the backend of the project. It is used in conjunction with the Django framework to handle server-side logic, data processing, and integration with the database.

Return to Table of Contents

Frameworks

  • Django: A high-level Python web framework that encourages rapid development and clean, pragmatic design. It provides robust features for building the backend, including user authentication, URL routing, and database management, ensuring a scalable and secure web application.

Return to Table of Contents

Supporting Libraries and Packages

  • Bootstrap: As a popular CSS framework that helps in designing responsive and mobile-first web pages, we used it to ensure the directory is accessible and visually consistent across different devices and screen sizes.

Return to Table of Contents

Code Validation

HTML Validation

ll pages were validated, and the code was pasted in. A filter was applied to remove issues related to the Django templating system.

Tested Result View Result Pass
base No errors
Screenshot of resultResult
βœ…
index No errors
Screenshot of resultResult
βœ…
about No errors
Screenshot of resultResult
βœ…
Job Application No errors
Screenshot of resultResult
βœ…
Practice No errors
Screenshot of resultResult
βœ…
Add Note No errors
Screenshot of resultResult
βœ…
Challenge Detail No errors
Screenshot of resultResult
βœ…
Challenge List No errors
Screenshot of resultResult
βœ…
Code Submission No errors
Screenshot of resultResult
βœ…
Job Dashboard No errors
Screenshot of resultResult
βœ…
Job Form No errors
Screenshot of resultResult
βœ…
Note No errors
Screenshot of resultResult
βœ…
Update Job Application No errors
Screenshot of resultResult
βœ…

Return to Table of Contents

CSS Validation

Tested Result View Result Pass
styles.css No errors
Screenshot of resultResult
βœ…
interview.css No errors
Screenshot of resultResult
βœ…
job_application.css No errors
Screenshot of resultResult
βœ…

Return to Table of Contents

Acknowledgements

Ciaran Griffin
David Cotter
Erin Doyle
Kim Halon
Marlon Mandaya
Vasilis Tsimourdagkas

Return to Table of Contents

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published