Corebound System Requirements Document

1. Introduction

Corebound is a story-driven educational game-based website designed to engage school and college students, beginner learners, young gamers, and self-learners. The platform combines interactive storytelling with challenges to enhance skills in coding, communication, and aptitude.

2. System Overview

Corebound aims to provide an immersive educational experience through a game-based approach. It leverages storytelling and interactive challenges to facilitate learning and skill development in a fun and engaging manner.

2a. Product Interpretation and Delivery Boundary

• Domain Descriptors:

  • Story-driven educational gameplay: Engages users through interactive storytelling and challenges.

• Product Intent: An educational and skill-building game-based website for students and learners.

• Excluded Assumptions:

  • Generic e-learning platform features
  • Traditional classroom management tools

• Custom Pages:

  • Login or enter the website: To authenticate users and provide personalized experiences.
  • In-game Assistance: Real-time guidance provided by Guardians of Code during challenge engagement.
  • Read or listen to the story: To immerse users in the narrative.
  • Skill weakness profile: To help users identify and improve their skills.
  • Explore challenges & play game: To engage users in gameplay and skill development.
  • Take rewards: To incentivize users and provide a sense of achievement.

• Access: Application-owned identity with authentication required.

• Behavior Contracts:

  • Login or enter the website:

    • Actor: Students and Learners
    • Trigger: User accesses the website
    • Inputs: User credentials
    • Outcomes: Access to personalized content
    • State Changes: User session initiated
    • State Lifetime: Interaction
    • Identity Continuity: Persistent
    • Audience Entry: Public
    • Failure Outcome: Access denied

  • Guidance and assistance:

    • Actor: Guardians of Code
    • Trigger: User engages with a challenge
    • Inputs: Challenge context
    • Outcomes: Guidance provided
    • State Changes: None
    • State Lifetime: None
    • Identity Continuity: None
    • Audience Entry: None
    • Failure Outcome: No guidance available

2c. Page Content and Component Coverage

• Login or Enter the Website:

  • User authentication and session management
  • Personalized content access

• In-game Assistance:

  • Real-time guidance by Guardians of Code
  • Interactive support during challenges

• Read or Listen to the Story:

  • Narrative immersion through text and audio
  • Story progression tracking

• Skill Weakness Profile:

  • Skill assessment and feedback
  • Personalized improvement suggestions

• Explore Challenges & Play Game:

  • Interactive challenges and missions
  • Gameplay mechanics and progression

• Take Rewards:

  • Reward system for achievements
  • Incentive tracking and management

3. Functional Requirements as Story Points

• As a student or learner, I should be able to log in or enter the website to access personalized content. explicit
• As a student or learner, I should be able to read or listen to the story to immerse myself in the narrative. explicit
• As a student or learner, I should be able to view my skill weakness profile to identify areas for improvement. explicit
• As a student or learner, I should be able to explore challenges and play games to develop my skills. explicit
• As a student or learner, I should be able to take rewards to feel a sense of achievement. explicit
• As a Guardian of Code, I should be able to provide guidance and assistance during challenges to help users. required_inference

4. User Personas

• Students and Learners: Primary users engaging with educational and skill-building content.
• Guardians of Code: Characters providing guidance and assistance within the game.

5. Core User Flows

1. Login or Enter the Website:

   • Access the website
   • Enter credentials
   • Gain access to personalized content

2. Read or Listen to the Story:

   • Select a story
   • Engage with the narrative through reading or listening

3. Skill Weakness Profile:

   • View skill assessment
   • Receive feedback and improvement suggestions

4. Explore Challenges & Play Game:

   • Select and engage with challenges
   • Progress through gameplay

5. Take Rewards:

   • Complete challenges
   • Receive and manage rewards

6. Visuals Colors and Theme

• Primary: #3498db
• Primary Light: #85c1e9
• Secondary: #2ecc71
• Accent: #e74c3c
• Highlight: #f1c40f
• Background: #ecf0f1
• Surface: #ffffff
• Text: #2c3e50
• Text Muted: #7f8c8d
• Border: #bdc3c7

7. Signature Design Concept

The "Read or Listen to the Story" page will feature a visually engaging layout with a focus on narrative immersion. The design will incorporate a clean, modern aesthetic with a focus on readability and user engagement. The page will include:

• A prominent story section with text and audio options
• Interactive elements for story progression
• A sidebar with navigation and user profile information
• Use of the primary color palette to highlight key elements

8. Interaction Model & Motion Direction

• Interaction Model: Animated

  • Moderate scroll-triggered reveals
  • Hover transitions and spring physics on interactive elements

• Motion Direction:

  • The "Read or Listen to the Story" page will feature subtle animations to enhance user engagement without overwhelming the narrative content.

9. Non-Functional Requirements

• Null Disturbances: Ensure a smooth and uninterrupted gaming experience. explicit

10. Tech Stack

• Frontend: HTML5 , CSS3 , JAVASCRIPT , GSAP , LENIS , THREE.JS , FRAMER MOTION.
• Backend: Python, FastAPI , UVICORN , PYDANTIC.
• Database: POSTGRESQL , SQL ALCHEMY .
• AI Models: GOOGLE GEMINI API, GOOGLE GEN AI SDK.
• **USED TOOLS ; VS CODE , GIT ,

11. Assumptions and Constraints

• The platform will not include generic e-learning platform features or traditional classroom management tools.
• Authentication is required for personalized content access.

12. Glossary

• Guardians of Code: Characters within the game providing guidance and assistance.
• Null Disturbances: A feature ensuring a smooth and uninterrupted gaming experience.
• Skill Weakness Profile: A feature that helps users identify and improve their skills.

This document outlines the system requirements for Corebound, ensuring a comprehensive understanding of the project's scope and objectives.