Origin

• Apply sayings from 《认知天性》读后感
• Credit to the original idea of the product Quizzio

Tech

• .NET 8
• Vue 3
• MySQL (in Docker)

Status

• Minimum viable product could be considered as completed

• Before running the prompt, you have to prepare this beforehand

  # Just search it at your will (and risk)
  # Once you got the first one, all the remaining ones could found on the website as well
  
  QUIZLY_LLM_API_URI="..."
  QUIZLY_LLM_API_TOKEN="..."
  QUIZLY_LLM_API_MODEL="..."

• Setup was basically

  cd backend/quizlyApi/
  dotnet run
  
  cd frontend
  npm run dev

Roadmap

• Better looking in the whole
• Better directory structure for the backend (unused code everywhere)
• 配置化 via Apollo .NET Client ^doc
• Get a VPS for real-world deployment
• Apply tons of high-concurrency solutions to this project for the sake of learning

Design

data

仅作参考，不反映实际设计与实现

• user

  • id (non-null, INT, pk)
  • name (non-null, VARCHAR(50))
  • email (null, VARCHAR(500))
  • password (non-null, VARCHAR(1000))

• quiz_config

  • id (non-null, INT, pk)
  • title (non-null, VARCHAR(500))
  • context (non-null)
  • difficulty (non-null, ENUM(most easy, easy, medium, hard, most hard))

• quiz_content

  • quizId (non-null, INT, fk)
  • userId (non-null, INT, fk)
  • lang (non-null, ENUM(zh, en))
  • rawContent (nullable)
  • postProcessedContent (nullable)

config

仅作参考，不反映实际设计与实现

• system prompt
• examples for prompt

backend

仅作参考，不反映实际设计与实现

• API

  • auth/register/
  • auth/login/
  • auth/logout/
  • quiz/new/
  • quiz/list/
  • quiz/detail/ (list of questions)

• Util

  • LLM helper
  • DB helper

frontend

仅作参考，不反映实际设计与实现

• page settings

  • user information
  • actions (logout)

• page quizzes

  • list of quizzes (quiz info)

• page dashboard

  • create new quiz
  • quiz statistics
  • recent quizzes

• interaction

  • answering the quiz
  • quiz statistics (n/m correct answers)
  • quiz AI feedback
  • quiz question/answer pair demonstration (wrong/right)