Walkinhub System Requirements Document

Introduction

Walkinhub is a SaaS platform designed to bridge the gap between companies and students by facilitating the publication and discovery of walk-in interview opportunities. This platform aims to streamline the process for companies to post job openings and for students to find and apply for these opportunities quickly and efficiently.

System Overview

Walkinhub provides a user-friendly interface where companies can easily publish details about walk-in interviews, and students can browse and apply for these opportunities. The platform is designed to enhance the job search experience for students and simplify the recruitment process for companies.

Functional Requirements

• As a Company, I should be able to publish walk-in interview job postings on the platform.
• As a Company, I should be able to manage and update my job postings.
• As a Student, I should be able to browse available walk-in interview opportunities.
• As a Student, I should be able to apply for walk-in interview jobs directly through the platform.
• As a Student, I should be able to filter job postings based on location, company, and job type.
• As an Admin, I should be able to manage user accounts and ensure the platform's smooth operation.

User Personas

• Company Representative: A user representing a company looking to publish walk-in interview opportunities.
• Student: A user seeking walk-in interview opportunities to apply for.
• Admin: A user responsible for managing the platform and ensuring its smooth operation.

Core User Flows

• Company Representative: Logs in -> Navigates to job posting section -> Publishes a new walk-in interview job -> Manages existing job postings.
• Student: Logs in -> Browses available walk-in interviews -> Filters opportunities based on preferences -> Applies for selected jobs.
• Admin: Logs in -> Manages user accounts -> Monitors platform activity -> Resolves any issues.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F59E0B (Amber)
• accent: #EF4444 (Red)
• highlight: #FBBF24 (Gold)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.2)

Signature Design Concept

The Walkinhub landing page will feature an interactive "Job Map" concept. This map will visually represent various companies as nodes, with lines connecting them to available walk-in interview opportunities. Students can click on a company node to expand and view detailed job postings. The map will be dynamic, with nodes and connections subtly animating to indicate activity and engagement. This concept will use motion/react for smooth animations and interactions.

LANDING HERO MOTION BRIEF

The landing hero will depict a student journeying through a vibrant cityscape, representing the job market. As the student moves, company logos and job postings appear in the skyline, symbolizing opportunities. The animation will loop every 10 seconds, showing the student reaching a company and successfully applying for a job. This will be built using motion/react for seamless transitions and interactions.

Interaction Model & Motion Direction

The intended interaction model for the Walkinhub landing page is "animated." This will include moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements to create an engaging and polished user experience.

Non-Functional Requirements

• The platform should be accessible and responsive across all devices.
• The system must ensure data security and privacy for all users.
• The platform should support high traffic without performance degradation.

Tech Stack

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

Assumptions and Constraints

• The platform will primarily serve users in India, considering local timezone and currency.
• The system will require internet connectivity to function.
• User data must be stored securely and comply with local data protection regulations.

Glossary

• SaaS: Software as a Service
• Walk-in Interview: A job interview where candidates can attend without a prior appointment.
• Company Representative: A user from a company responsible for posting job opportunities.
• Student: A user seeking job opportunities through the platform.