glacial-jobs System Requirements Document

Introduction

The "glacial-jobs" project aims to create a job listing website similar to the "Job Hai" app, with enhanced features such as AI-driven resume building, resume analysis, and job matching. The platform will also integrate ad services and offer a one-time payment model for visitors, incorporating popular Indian payment options like Paytm, PhonePe, and Google Pay.

System Overview

The glacial-jobs platform is designed to connect job seekers with potential employers efficiently. By leveraging AI technologies, the platform will provide personalized job recommendations and tools to enhance user resumes. The integration of ad services will generate additional revenue, while the one-time payment model ensures a straightforward user experience. The system will support Indian payment gateways to cater to the local market.

Functional Requirements

• As a User, I should be able to build and analyze my resume using AI tools.
• As a User, I should receive personalized job recommendations based on my skills and experience.
• As a User, I should be able to make a one-time payment using Paytm, PhonePe, or Google Pay.
• As an Admin, I should be able to manage job listings and advertisements on the platform.
• As an Admin, I should be able to view and manage user subscriptions and payments.

User Personas

• Job Seeker: Individuals looking for employment opportunities and utilizing the platform's AI tools for resume building and job matching.
• Admin: Personnel responsible for managing the platform's content, advertisements, and user transactions.

Visuals Colors and Theme

• primary: #1A73E8 (a vibrant blue to convey trust and professionalism)
• primary_light: #E8F0FE (a light blue for hover states and secondary UI elements)
• secondary: #FF7043 (a warm coral for headlines and emphasis)
• accent: #FFCA28 (a bright amber for call-to-action buttons and active states)
• highlight: #FFB300 (a golden hue for hover states and notifications)
• bg: #F5F5F5 (a soft grey for the page background)
• surface: rgba(255, 255, 255, 0.9) (a subtle white for card/panel backgrounds)
• text: #212121 (a deep charcoal for primary text)
• text_muted: #757575 (a muted grey for secondary text and labels)
• border: rgba(0, 0, 0, 0.1) (a light grey for borders)

Signature Design Concept

The homepage of glacial-jobs will feature an interactive "Career Pathway" map. Users can navigate through a dynamic, 3D landscape representing different career paths. Each path will be a series of floating islands, each representing a job category. Users can click on an island to explore job listings, resources, and AI tools related to that category. The map will be built using @react-three/fiber and @react-three/drei for 3D rendering, with gsap for smooth transitions and animations. This engaging experience will make the job search process both intuitive and visually captivating.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, providing a layered depth effect as users scroll through the page. Decorative elements like floating islands and atmospheric particles will move at different speeds, creating a sense of immersion. Key sections will feature interactive 3D scenes, ensuring each part of the page offers a unique and engaging experience.

Non-Functional Requirements

• The system should support high concurrency to handle a large number of simultaneous users.
• The platform must ensure data security and privacy, particularly for user resumes and payment information.
• The website should be optimized for fast load times and responsive design across devices.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB with alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses, Claude 4.6 Opas for resume analysis
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The platform will primarily target the Indian market, hence the integration of local payment gateways.
• AI features will require ongoing updates and training to remain effective and relevant.
• The system must comply with local data protection regulations.

Glossary

• AI: Artificial Intelligence
• UI: User Interface
• UX: User Experience
• LLM: Large Language Model
• RDBMS: Relational Database Management System
• NoSQL: Non-relational Database Management System

This document outlines the comprehensive requirements and design concepts for the glacial-jobs project, ensuring a robust and engaging platform for job seekers and employers alike.