CSOneCup client

CSOneCup

A gamified platform for learning computer science effectively and enjoyably.
Explore the docs »

View Repository · Report Bug · Request Feature · View Server

Introduction

CSOneCup is a gamified platform designed to make learning computer science (CS) knowledge both engaging and effective. By integrating CS quizzes into a fun and interactive card format, the platform aims to cater to different audiences:

• Job Seekers: Effortlessly prepare for technical interviews and coding tests while managing time effectively.
• CS Students: Build a deeper understanding of CS subjects without the stress of traditional study methods.
• Junior Developers: Continue professional growth while enjoying a gamified learning experience.

CSOneCup empowers users by providing them with the ability to:

• Test and validate their knowledge through quizzes.
• Focus on weak areas by targeting specific categories.
• Create custom decks to share and compete with others.

The platform turns learning into a rewarding and motivating experience through friendly competition and personalization.

Key Features

Main Features

• CS Quiz Cards
  Each problem is presented as a card with the question on the front and the answer (with explanations) on the back.

• Random Problem Solving
  Users can solve random questions or select specific categories to focus on their interests.

• Custom Deck Building
  Users can create personalized decks using owned cards, set categories and time limits, and share them with others to compete.

Additional Features

• Competitive Element
  A rating and ranking system to encourage users to compete and measure their progress against others.

• Card Design Customization
  Unlock and apply design elements to personalize cards and decks, such as colors, animations, and styles.

• Quiz Reminders
  Notifications to remind users of their scheduled learning times, with quick-access widgets for solving quizzes directly.
  
  

Design

Getting Started

Prerequisites

For Server (Spring Boot)

1. Java Development Kit (JDK) 17:
   • Install JDK 17 from Oracle or use your package manager:

     sudo apt install openjdk-17-jdk

2. Gradle:
   • Install Gradle if not bundled with the project:

     sudo apt install gradle

For Client (Flutter)

1. Flutter SDK:
   • Install Flutter SDK from Flutter Official Site.
   • Verify installation:

     flutter doctor

2. Dart SDK:
   • Included with Flutter, no separate installation required.
3. Android Studio or Xcode (For Device Emulation and Building Apps):
   • Install Android Studio for Android development or Xcode for iOS development.
   • Ensure required plugins (Flutter and Dart) are installed in your IDE.

Installation

Server Setup (Spring Boot)

1. Clone the repository:

    git clone https://github.com/CSOneCup/CSOneCup-server.git

2. Navigate to the project directory:

   cd CSOneCup-server

3. Build the project:

   ./gradlew build

4. Run the Spring Boot server:

   ./gradlew bootRun

Client Setup (Flutter)

1. Clone the repository:

   git clone https://github.com/CSOneCup/CSOneCup-client.git

2. Navigate to the Flutter project directory:

   cd CSOneCup-client

3. Install dependencies:

   flutter pub get

4. Run the Flutter application:

   flutter run

Team Members

김재훈 서버 개발 & 회원 인증 로직 개발

김선호 메인 메뉴 개발 & 챌린지 개발

김혁진 퀴즈 로직 개발

현재환 카드 관리 & 덱 생성 로직 개발

우리 팀은 컴퓨터과학 학습의 재미와 효과를 동시에 제공하는 플랫폼을 만들기 위해 모였습니다. 💪