System Requirements Document (SRD)

Project Name: zinc-jobid

1. Introduction

The zinc-jobid project is a mobile application designed to provide users with comprehensive job insights and a personalized dashboard for tracking applied jobs. The app integrates with LinkedIn and Gmail for seamless login and leverages location-based search to display relevant job opportunities. Users can view detailed job information, including key skills required, number of applications, growth opportunities, Glassdoor ratings, interview processes, selection criteria, and more. This document outlines the system requirements for the development of the zinc-jobid application.

2. System Overview

The zinc-jobid app is tailored for job seekers in India, providing a user-friendly interface to explore job opportunities and track their applications. Key features include:

• LinkedIn and Gmail login for quick and secure access.
• Location-based job search with the option to manually input a city if location access is denied.
• Filters to refine job search results based on the number of applicants, posting date, and other criteria.
• A detailed dashboard view for applied jobs, offering insights into success criteria, required skills, and more.

The app aims to empower users with actionable job insights, helping them make informed career decisions.

3. Functional Requirements

The following are the functional requirements for zinc-jobid, expressed as user stories:

• As a User, I should be able to log in using my LinkedIn or Gmail account.
• As a User, I should be able to search for jobs by entering a job title.
• As a User, I should be prompted to grant location access for location-based job searches.
• As a User, if I deny location access, I should see a text box to manually enter the city where I want to search for jobs.
• As a User, I should see a list of jobs in the specified location based on my search query.
• As a User, I should be able to filter jobs by:
  • Number of applications (e.g., under 30, under 100).
  • Date posted (e.g., within the last 24 hours).
• As a User, when I click on a job link, I should see detailed information, including:
  • Key skills required.
  • Number of applications.
  • Growth opportunities in the company.
  • Glassdoor ratings.
  • Interview process.
  • Selection criteria.
  • Required resources.
• As a User, I should have a dashboard view to track jobs I have applied for.

4. User Personas

The zinc-jobid app will cater to the following user personas:

1. Job Seeker

   • Primary user of the app.
   • Logs in using LinkedIn or Gmail.
   • Searches for jobs, applies filters, and views detailed job insights.
   • Tracks applied jobs in the dashboard.

2. Admin

   • Manages backend operations, including API integrations and user data.
   • Monitors app performance and resolves technical issues.

5. Visuals Colors and Theme

The visual identity of zinc-jobid will reflect professionalism and trustworthiness while maintaining a modern and engaging aesthetic. Below is the unique color palette for the app:

• Background: #F7F9FC (soft off-white for a clean look)
• Surface: #FFFFFF (pure white for cards and containers)
• Text: #2C3E50 (deep navy for readability)
• Accent: #3498DB (vibrant blue for interactive elements)
• Muted: #95A5A6 (subtle gray for secondary text and icons)

6. Signature Design Concept

The zinc-jobid app will feature a "Dynamic Job Globe" as its signature design concept.

Concept Details:

• Homepage Design:
  The landing page will showcase an interactive 3D globe that rotates slowly. Users can interact with the globe by dragging it to explore different regions.
• Job Pins:
  Each city with job listings will be marked with glowing pins. Clicking on a pin will zoom into that region and display job opportunities in a sleek sidebar.
• Animations:
  Smooth transitions will occur when users interact with the globe or select a job pin. The globe will subtly pulse with light to indicate activity.
• Color Shifts:
  The globe's background will transition between shades of blue and purple, creating a calming yet professional atmosphere.
• Micro-interactions:
  Hovering over job pins will display a tooltip with the city name and the number of jobs available.

This design will make the app visually striking and provide an engaging user experience from the moment they open it.

7. Non-Functional Requirements

• The app should load job search results within 2 seconds.
• The system should handle up to 10,000 concurrent users.
• Data privacy and security must comply with GDPR and Indian IT laws.
• The app should be compatible with Android and iOS platforms.
• The app should support both light and dark modes.

8. Tech Stack

The following technologies will be used to develop the zinc-jobid app:

• Frontend:

  • React Native (for mobile app development)

• Backend:

  • Python
  • FastAPI

• Database:

  • MySQL (for structured data storage)
  • Alembic (for database migrations)

• AI Models:

  • GPT 5.2 (for user-friendly responses)
  • Claude 4.5 Opas (for coding-related insights)

• AI Tools:

  • Langchain
  • Litellm (for LLM routing)

• Orchestration:

  • Docker (for local development)
  • Kubernetes (for server-side orchestration)

9. Assumptions and Constraints

• Users will have active LinkedIn or Gmail accounts for login.
• LinkedIn APIs will provide reliable access to job data.
• Location-based search will depend on the user's device permissions.
• The app will primarily target users in India, but it should be scalable for global use.
• Internet connectivity is required for all app functionalities.

10. Glossary

• Job ID: A unique identifier for a job listing.
• LinkedIn API: An interface provided by LinkedIn to access job data and user profiles.
• Dashboard: A personalized view displaying applied jobs and related insights.
• Filters: Criteria used to refine job search results.
• Glassdoor Ratings: Company ratings and reviews sourced from Glassdoor.
• GDPR: General Data Protection Regulation, a data privacy law in the European Union.

This document serves as the foundation for the development of the zinc-jobid app. It captures the core requirements, design vision, and technical specifications to ensure a successful implementation.