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/
- User Stories
- Features
- Installation
- Usage
- API Documentation
- Contributing
- The Dream Team
- License
- Entity Relationship Diagram (ERD) Design
- Wireframes
- Performance
- Technologies Used
- Frameworks
- Supporting Libraries and Packages
- Code Validation
- CSS Validation
- Acknowledgements
-
As a job seeker, I want to enter my job title so that I can generate relevant interview questions tailored to my role.
-
As a job seeker, I want to view a list of generated interview questions after submitting my job title.
-
As a job seeker, I want to provide my answers to the generated questions and submit them for evaluation.
-
As a user, I want to see AI-generated feedback on my answers.
-
As a user, I want to revisit previously generated questions and answers.
-
As an administrator, I want to manage user submissions and feedback.
-
As a new user, I want an intuitive interface that guides me through the process.
-
As a user, I want to receive success messages after successfully generating questions or submitting answers.
- 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?
- Clone the repo:
git clone https://github.com/your-username/git-hired.git
- Navigate to the project directory:
cd git-hired
- Install dependencies:
pip install -r requirements.txt
- Set up the database:
python manage.py migrate
- Start the server:
python manage.py runserver
- Create an account (we promise we won't sell your data to job recruiters... or will we? π)
- Log in and start adding your job applications
- Use the dashboard to track your progress
- Update application statuses as you go
- Celebrate when you finally Git Hired! π
For those who like to peek under the hood, check out our API documentation.
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).
Meet the caffeinated coders behind Git Hired:
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! π
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.
- We used Balsamiq to design the wireframes for us website.
The Git Hired website was assessed with Google Lighthouse via Google Chrome Developer Tools. Performance scores were evaluated for both desktop and mobile devices.
- 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 | β | |
about | 85 / 100 | β | |
Job Application | 99 / 100 | β | |
Practice | 74 / 100 | β |
- 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 | β | |
about | 85 / 100 | β | |
Job Application | 99 / 100 | β | |
Practice | 74 / 100 | β |
-
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.
- 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.
- 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.
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 | β | |
index | No errors | β | |
about | No errors | β | |
Job Application | No errors | β | |
Practice | No errors | β | |
Add Note | No errors | β | |
Challenge Detail | No errors | β | |
Challenge List | No errors | β | |
Code Submission | No errors | β | |
Job Dashboard | No errors | β | |
Job Form | No errors | β | |
Note | No errors | β | |
Update Job Application | No errors | β |
Tested | Result | View Result | Pass |
---|---|---|---|
styles.css | No errors | β | |
interview.css | No errors | β | |
job_application.css | No errors | β |
Ciaran Griffin
David Cotter
Erin Doyle
Kim Halon
Marlon Mandaya
Vasilis Tsimourdagkas