misty-system System Requirements Document

Introduction

The misty-system is an AI Interview Preparation Platform designed to assist users in preparing for job interviews by providing role-based mock interviews, AI-generated feedback, and progress tracking. This document outlines the system requirements for the misty-system, ensuring a comprehensive understanding of the platform's functionalities and design.

System Overview

The misty-system is tailored to support various user personas, including college students, fresh graduates, working professionals, and individuals returning to work after a career break. The platform offers a modern, professional design with an intuitive user experience, featuring role-based mock interviews, real-time answer evaluation, and personalized preparation roadmaps. An Admin Panel with role-based access control is included to manage platform operations and user engagement.

Functional Requirements

• As a College Student, I should be able to select a job role and participate in mock interviews.
• As a Fresh Graduate, I should be able to receive AI-generated interview questions tailored to my selected role.
• As a Working Professional, I should be able to receive real-time evaluation of my interview answers.
• As a Professional Returning to Work, I should be able to receive communication and confidence scores.
• As a User, I should be able to receive detailed feedback and improvement suggestions.
• As a User, I should be able to track my progress through a dashboard.
• As a User, I should be able to view my interview history and performance analytics.
• As a User, I should be able to follow a personalized preparation roadmap.
• As an Admin, I should be able to view a dashboard showing total users, active users, and interview sessions completed.
• As an Admin, I should be able to manage interview question banks for different job roles and experience levels.
• As an Admin, I should be able to create and update interview categories.
• As an Admin, I should be able to monitor user activity and platform usage.
• As an Admin, I should be able to view performance analytics and overall platform statistics.
• As an Admin, I should be able to manage subscriptions and premium features.
• As an Admin, I should be able to send announcements, interview tips, and notifications to users.
• As an Admin, I should be able to manage feedback reports and AI-generated content settings.

User Personas

• Candidate/User: Individuals preparing for interviews, including college students, fresh graduates, working professionals, and those returning to work.
• Admin: Platform administrators responsible for managing content, user engagement, and platform analytics.

Core User Flows

• Candidate selects job role -> participates in mock interview -> receives AI feedback -> views progress on dashboard.
• Admin logs into panel -> views user analytics -> updates interview questions -> sends notifications to users.

Visuals Colors and Theme

• primary: #2C3E50 (Deep Blue)
• primary_light: #34495E (Light Blue)
• secondary: #E74C3C (Crimson)
• accent: #F1C40F (Vibrant Yellow)
• highlight: #F39C12 (Amber)
• bg: #ECF0F1 (Light Grey)
• surface: rgba(236, 240, 241, 0.8)
• text: #2C3E50 (Dark Blue)
• text_muted: #95A5A6 (Muted Grey)
• border: rgba(44, 62, 80, 0.2)

Signature Design Concept

The misty-system's homepage will feature an interactive 3D floating island where each section of the platform is represented as a building. Users can navigate between buildings by "flying" over the island, with each building offering a unique interaction related to the platform's features. This concept will be brought to life using @react-three/fiber and @react-three/drei for 3D rendering, creating an immersive and engaging first impression.

Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, with layered depth effects as users scroll. This will create a visually rich storytelling experience, perfect for engaging users from the moment they arrive. Internal pages will maintain a "static" interaction model to ensure clarity and ease of use for data-heavy sections.

Non-Functional Requirements

• The platform must ensure secure authentication and role-based access control.
• The design must be responsive, supporting both desktop and mobile devices.
• The system should handle concurrent users efficiently, maintaining performance standards.

Tech Stack

• Frontend: React for Web
• Backend: Python, 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 target users in India, considering locale-specific defaults.
• The system will be designed to scale with future enhancements, such as premium features.
• The platform must comply with data protection regulations applicable in India.

Glossary

• ATS: Applicant Tracking System
• AI: Artificial Intelligence
• LLM: Large Language Model
• RDBMS: Relational Database Management System
• UI: User Interface

This document provides a comprehensive overview of the misty-system's requirements, ensuring that all functionalities and design elements are clearly defined for successful implementation.