System Requirements Document (SRD) for sonic-hi

1. Introduction

The sonic-hi project is a cutting-edge platform designed to support users in preparing for the EA CEI (Employment Agency Certificate of Employment Intermediaries) certification in Singapore. This document outlines the system requirements for the platform, ensuring it meets the needs of its users effectively. The platform will focus on delivering an intuitive and engaging experience, particularly for professionals and students preparing for the EA CEI certification.

This SRD has been updated to include support for Multiple Choice Questions (MCQs) tailored to the EA CEI certification requirements in Singapore.

2. System Overview

The sonic-hi platform will serve as an interactive learning tool, providing users with access to MCQs, study materials, and progress tracking features. The system will cater to individuals preparing for the EA CEI certification, offering a user-friendly interface and localized content specific to Singapore's regulatory and certification standards.

Key features include:

• A robust MCQ engine with support for EA CEI-specific questions.
• User personas tailored to different roles (e.g., learners, administrators).
• Progress tracking and analytics to help users identify strengths and weaknesses.
• A visually appealing and intuitive design optimized for both web and mobile platforms.

The platform will adhere to Singapore's timezone (SGT) and currency (SGD) conventions, ensuring a localized experience for users.

3. Functional Requirements

• As a User, I should be able to access a library of MCQs specific to EA CEI certification.
• As a User, I should be able to attempt timed MCQ quizzes to simulate the actual exam environment.
• As a User, I should be able to view detailed explanations for each MCQ answer.
• As a User, I should be able to track my progress and performance over time.
• As an Admin, I should be able to upload, edit, and categorize MCQs.
• As an Admin, I should be able to manage user accounts and permissions.
• As a Guest, I should be able to attempt a limited number of MCQs without creating an account.

4. User Personas

4.1 Learner

• Description: Individuals preparing for the EA CEI certification.
• Goals: Access MCQs, track progress, and improve exam readiness.
• Pain Points: Limited access to quality practice materials and difficulty tracking performance.

4.2 Admin

• Description: Platform administrators responsible for managing content and users.
• Goals: Ensure the platform is up-to-date with relevant MCQs and manage user access.
• Pain Points: Efficiently managing a large database of questions and user accounts.

4.3 Guest

• Description: Unregistered users exploring the platform.
• Goals: Try out the platform before committing to registration.
• Pain Points: Limited access to features without registration.

5. Visuals Colors and Theme

The sonic-hi platform will feature a modern and professional color palette that reflects trust, focus, and clarity, aligning with the educational and certification preparation theme.

• Background: #F5F9FF (soft sky blue)
• Surface: #FFFFFF (pure white)
• Text: #2C3E50 (deep navy blue)
• Accent: #1ABC9C (vibrant teal)
• Muted: #BDC3C7 (light gray)

This palette ensures a clean and professional look while maintaining user engagement and readability.

6. Signature Design Concept

The sonic-hi homepage will feature an interactive "exam dashboard" design. Upon landing, users will see a dynamic, animated dashboard that mimics a control panel. Key features include:

• Animated MCQ Progress Wheel: A circular progress indicator that visually represents the user's quiz completion percentage.
• Interactive Tabs: Tabs for "Start Quiz," "Review Answers," and "Track Progress" that expand with smooth animations when hovered over.
• EA CEI Certification Theme: Subtle animations of Singapore landmarks (e.g., Marina Bay Sands, Merlion) in the background, reinforcing the local context.
• Micro-Interactions: Buttons and icons that respond with subtle haptic-like animations when clicked or hovered over.
• Personalized Greeting: A dynamic welcome message that greets users by name (if logged in) and displays their current progress.

This design concept ensures the homepage is visually striking, engaging, and immediately communicates the platform's purpose.

7. Non-Functional Requirements

• The platform must load within 2 seconds on both web and mobile devices.
• The system must support at least 10,000 concurrent users.
• All user data must be stored securely and comply with Singapore's PDPA (Personal Data Protection Act).
• The platform must be accessible on devices with screen sizes ranging from 4 inches to 15 inches.
• The system must support both English and Mandarin languages.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work

AI Tools

• Langchain
• Litellm for LLM Routing

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

• The platform assumes users have basic internet connectivity.
• The system will primarily target users in Singapore, adhering to local regulations and standards.
• The MCQ content will be provided by subject matter experts familiar with the EA CEI certification.

10. Glossary

• EA CEI: Employment Agency Certificate of Employment Intermediaries.
• MCQ: Multiple Choice Questions.
• PDPA: Personal Data Protection Act, a Singaporean law governing data privacy.
• SGT: Singapore Timezone.
• SGD: Singapore Dollar.