careermatch System Requirements Document

1. Introduction

The purpose of this document is to outline the system requirements for the "careermatch" project. This innovative application combines elements of a dating app with professional networking by utilizing resume data to match users based on their ATS (Applicant Tracking System) scores. The project is designed to help working individuals connect with others who have similar professional profiles.

2. System Overview

The careermatch application aims to create a unique platform where users can submit their resumes, which are then scanned to calculate an ATS score. This score is used to match users with others who have similar scores, with a tolerance of 10% higher or lower. Users have the option to display their resumes on their profiles, with personal details such as email and name blurred for privacy. The application targets working individuals seeking professional connections.

3. Functional Requirements

• As a User, I should be able to submit my resume to the platform.
• As a User, I should be able to view my ATS score on my profile.
• As a User, I should be able to choose whether to display my resume on my profile.
• As a User, I should see my resume with personal details like email and name blurred if I choose to display it.
• As a User, I should receive match recommendations based on my ATS score, with a 10% tolerance.
• As a User, I should be able to view profiles of recommended matches.
• As a User, I should be able to interact with my matches through the app.

4. User Personas

• Working Individual: A professional seeking to connect with others in similar fields or with similar professional experiences. They value privacy and professional growth.

5. Core User Flows

• User submits resume -> System calculates ATS score -> User profile is updated with ATS score -> User chooses to display resume (optional) -> System blurs personal details if displayed -> System recommends matches -> User views and interacts with matches.

6. Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Sky Blue)
• secondary: #F97316 (Vibrant Orange)
• accent: #10B981 (Emerald Green)
• highlight: #F59E0B (Amber)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.5) (Light Gray)

7. Signature Design Concept

The careermatch homepage will feature an interactive "Resume Galaxy" where each user's resume is represented as a star. Users can navigate through this galaxy by clicking and dragging, with stars clustering based on ATS score similarity. Hovering over a star reveals a brief profile summary, and clicking opens the full profile. This concept will be implemented using @react-three/fiber for 3D navigation and gsap for smooth transitions and animations.

8. Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the page. This will be complemented by animated transitions and hover effects to enhance user engagement. Internal pages will maintain a "static" interaction model for clarity and ease of use.

9. Non-Functional Requirements

• The system should ensure user data privacy and comply with relevant data protection regulations.
• The application should be responsive and accessible across various devices and screen sizes.
• The system should handle high volumes of user data efficiently.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• Users are expected to have a professional background and possess a resume.
• The system assumes users consent to data processing for ATS score calculation and matching.
• The application will operate within the Indian timezone and locale settings.

12. Glossary

• ATS (Applicant Tracking System): Software used by employers to manage the recruitment process.
• Resume Galaxy: A visual representation of user resumes as stars within the application.
• Parallax: A design technique where background images move slower than foreground images, creating a sense of depth.