System Requirements Document for score-5-0

1. Introduction

Score 5.0 is a mobile-first Nigerian university CBT (Computer-Based Testing) and study platform designed to facilitate learning and examination preparation for students at UNIOSUN. The platform is optimized for Android devices, tablets, and desktops, providing a comprehensive suite of features including course management, CBT practice, payment and activation processes, and administrative controls. The platform aims to create a calm, supportive environment for students, aligning with the principles of humane technology.

2. System Overview

Score 5.0 delivers a complete CBT and study platform with a focus on mobile-first design. It supports authentication, course management, a CBT system with a free trial, payment and activation processes, and an admin dashboard. The platform ensures security through Supabase authentication and Row Level Security (RLS), and it is designed for future scalability with modular payment systems. The platform is accessible to students and administrators, with distinct roles and responsibilities.

2a. Product Interpretation and Delivery Boundary

The platform is designed to be fully functional, not a mockup, and supports mobile-first responsive design for Android, tablets, and desktops. It uses Supabase for authentication and data management, ensuring that students only see their own data. The platform includes a payment system using PalmPay, with future scalability for additional payment methods. It maintains a modern, responsive, and educational design with light/dark mode options.

2b. Source Content Inventory

Not applicable as no content_source directive was provided.

2c. Page Content and Component Coverage

HOME PAGE

• Logo and Tagline: Score 5.0 | "Study smarter. Practice harder. Score higher."
• Buttons: Get Started, Login, Sign Up
• Sections: Featured Courses, CBT Practice, CGPA Calculator, Past Questions

Login

• Fields: Email, Password
• Actions: Login, Forgot Password

Sign Up

• Fields: Name, Email, Password, Confirm Password
• Actions: Sign Up

Forgot Password

• Fields: Email
• Actions: Submit for password recovery

User Profile

• Information: Personal details, linked data (CBT results, payments, course activation, progress)
• Actions: Edit Profile, Logout

Student Dashboard

• Information: Welcome message, Course list with status (Free, Locked, Pending, Activated, Rejected), Recent CBT results, Average Score, CGPA, Progress
• Actions: View Course Details, Access CGPA Calculator

Courses

• List of Courses: MTH 101, STA 101, PHY 101, GEE 101, BIO 101, COS 101, PHY 103, GST 101, MTH 103, CHM 101
• Actions: View Course Details

Course Details

• Information: Title, Code, Description, Topics, Study Materials, CBT Practice, Past Questions, Progress
• Actions: Start CBT Practice, View Study Materials

CBT Practice

• Features: MCQ with A-D options, Next, Previous, Question Navigation, Timer, Submit, Auto-marking, Score %, Correct/Wrong/Unanswered, Review, Save History
• Actions: Start Test, Submit Test

Activation

• Information: Activation Fee, Payment Instructions (PalmPay details)
• Actions: Submit Payment Evidence

CGPA Calculator

• Fields: Course Code, Title, Credit Unit, Grade
• Actions: Calculate CGPA

Admin Dashboard

• Sections: Manage Courses, Topics, Questions, Students, Payments
• Actions: Add/Edit/Delete Courses and Questions, Approve/Reject Payments

Content Management

• Actions: Manage Courses, Topics, Questions, Free Questions, Students

Payment Review

• Information: Payment Evidence, Status (Pending, Approved, Rejected)
• Actions: Approve/Reject Payments with Reason

3. Functional Requirements

• As a Student, I should be able to sign up, log in, and recover my password using Supabase authentication. (explicit)
• As a Student, I should be able to view and interact with the home page, accessing featured courses, CBT practice, CGPA calculator, and past questions. (explicit)
• As a Student, I should be able to access and manage my profile, linking all relevant data to my account. (explicit)
• As a Student, I should be able to view a list of courses and access detailed information for each course. (explicit)
• As a Student, I should be able to practice CBT with shuffled questions, submit answers, and review results. (explicit)
• As a Student, I should be able to attempt six free questions per course and submit payment evidence for course activation. (explicit)
• As a Student, I should be able to calculate my CGPA using the provided calculator. (explicit)
• As an Admin, I should be able to manage courses, topics, questions, students, and payments through a protected dashboard. (explicit)
• As an Admin, I should be able to approve or reject payments and unlock courses for students. (explicit)

4. User Personas

• Student: Engages with the platform for study and examination preparation, manages personal data and progress, and interacts with the CBT and payment systems.
• Admin: Oversees platform management, including course content, student data, and payment approvals.

5. Core User Flows

Student Sign Up and Login

1. Access the Sign Up page.
2. Enter Name, Email, Password, and Confirm Password.
3. Submit the form to create an account.
4. Access the Login page.
5. Enter Email and Password.
6. Submit to log in and access the Student Dashboard.

Course Interaction and CBT Practice

1. Navigate to the Courses page.
2. Select a course to view details.
3. Access CBT Practice from the Course Details page.
4. Attempt six free questions.
5. Submit answers and view results.
6. After six questions, access the Activation page for payment.

Payment and Activation

1. On the Activation page, view payment instructions.
2. Submit payment evidence via the provided form.
3. Await admin approval for course activation.
4. Upon approval, access the full question bank.

Admin Management

1. Log in to the Admin Dashboard.
2. Manage courses, topics, questions, and students.
3. Review payment submissions.
4. Approve or reject payments, providing reasons for decisions.

6. Visuals Colors and Theme

• Muse: Yves Béhar
• Palette (light mode):
  • Background: #FAF9F6
  • Surface: #FFFFFF
  • Text: #333333
  • Primary: #FF7043
  • Accent: #607D8B
  • Muted: #B0BEC5
• Typography:
  • Headings: Karla, Bold, large sizes, mixed case
  • Body: Work Sans
  • Scale: 1.250 modular, 48/32/24/16/14
• Shape Language: Rounded, soft forms
• Layout: Modular panels with clear hierarchy
• Motion: Breathing, slow easing transitions

7. Signature Design Concept

The public entry (Home Page) will feature a hero section with oversized type in a welcoming orange block, contrasting with a soft-focus background. Rounded card components with subtle shadowing will provide depth and focus. The navigation bar will have soft transitions and a highlight on hover using the primary orange. Illustrative icons and infographics will enhance the education theme, with a progress tracker UI element conveying progress through soft animation and color change.

8. Interaction Model & Motion Direction

• Interaction Model: Static
• Motion Tempo: Restrained
• Hero Dimensionality: Layered_2d
• Landing Hero Motion Brief: A balanced editorial hero with a large, inviting headline in Karla over a warm white background, featuring a soft-focus image of students using the platform in a relaxed environment.

9. Non-Functional Requirements

• Mobile-first responsive support for Android, tablets, and desktop. (explicit)
• Use of Supabase/PostgreSQL for data management with Row Level Security. (explicit)
• No secrets in the frontend; use RLS, server validation, and protected admin routes. (explicit)
• Payment architecture should remain extensible for Paystack and Flutterwave later. (explicit)

10. Tech Stack

• Frontend: React (for web), React Native (for mobile)
• Backend: Supabase, FastAPI
• Database: PostgreSQL with Supabase
• Authentication: Supabase
• Payment Integration: PalmPay (initial), extensible for Paystack/Flutterwave
• Deployment: Docker, Kubernetes (if required)

11. Assumptions and Constraints

• The platform must be fully functional, not a mockup. (explicit)
• Activation fee is ₦1,000 per course everywhere. (explicit)
• Students cannot approve their own payments or modify activation status. (explicit)
• Students must only see their own protected data. (explicit)

12. Glossary

• CBT: Computer-Based Testing
• Supabase: A backend-as-a-service providing authentication and database management
• RLS: Row Level Security
• PalmPay: A mobile payment platform used for course activation payments
• CGPA: Cumulative Grade Point Average

This document outlines the requirements and design for the Score 5.0 platform, ensuring a comprehensive and secure environment for students and administrators.