Community & Quiz Marketplace

class Quiz(ormar.Model):
    public: bool = ormar.Boolean(default=False)  # Private by default

<div class="grid lg:grid-cols-3 grid-cols-1">
  {#each quizzes.hits as quiz}
    <SearchCard {quiz} />
  {/each}
</div>

GET /api/v1/quiz/get/public/{quiz_id}

@router.get("/get/public/{quiz_id}")
async def get_public_quiz(quiz_id: uuid.UUID):
    quiz = await Quiz.objects.select_related("user_id").get_or_none(id=quiz_id)
    if quiz is None:
        return JSONResponse(status_code=404, content={"detail": "quiz not found"})
    
    # Increment view count
    quiz.views += 1
    await quiz.update()
    
    return PublicQuizResponse(**quiz.model_dump())

class Quiz(ormar.Model):
    likes: int = ormar.Integer(nullable=False, default=0, server_default="0")
    dislikes: int = ormar.Integer(nullable=False, default=0, server_default="0")
    plays: int = ormar.Integer(nullable=False, default=0, server_default="0")
    views: int = ormar.Integer(nullable=False, default=0, server_default="0")

POST /api/v1/community/rate/{quiz_id}

{
  "type": "LIKE"  // or "DISLIKE"
}

class Rating(ormar.Model):
    id: uuid.UUID
    user: uuid.UUID | User  # Who rated
    positive: bool  # True = like, False = dislike
    created_at: datetime
    quiz: uuid.UUID | Quiz  # What was rated

@router.post("/rate/{quiz_id}")
async def rate_quiz(
    data: RateQuizInput, 
    quiz_id: uuid.UUID, 
    user: User = Depends(get_current_user)
):
    quiz = await Quiz.objects.get_or_none(id=quiz_id, public=True)
    if quiz is None:
        raise HTTPException(status_code=404, detail="Quiz not found")
    
    rating = await Rating.objects.get_or_none(quiz=quiz, user=user)
    positive = True if data.type == RateQuizInputType.LIKE else False
    
    # Same rating already exists
    if rating is not None and rating.positive == positive:
        raise HTTPException(status_code=409, detail="Rating already submitted")
    
    # Changing rating (like -> dislike or vice versa)
    elif rating is not None and rating.positive != positive:
        await rating.delete()
        if rating.positive:
            quiz.likes -= 1
        else:
            quiz.dislikes -= 1
    
    # New rating
    rating = Rating(
        id=uuid.uuid4(),
        user=user,
        positive=positive,
        quiz=quiz,
        created_at=datetime.now(),
    )
    await rating.save()
    
    if positive:
        quiz.likes += 1
    else:
        quiz.dislikes += 1
    
    await quiz.update()

GET /api/v1/community/user/{user_id}

{
  "username": "teacher123",
  "created_at": "2023-05-15T10:30:00Z",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

GET /api/v1/community/quizzes/{user_id}

@router.get(
    "/quizzes/{user_id}",
    response_model_exclude={"questions", "user_id"},
    response_model=list[Quiz],
)
async def get_quizzes_from_user(user_id: UUID, imported: bool | None = None):
    if imported is None:
        quizzes = await Quiz.objects.all(user_id=user_id, public=True)
    else:
        quizzes = await Quiz.objects.filter(
            (Quiz.imported_from_kahoot == False) | (Quiz.imported_from_kahoot == None)
        ).all(user_id=user_id, public=True)
    
    if len(quizzes) == 0:
        raise HTTPException(status_code=404, detail="no quizzes found")
    
    return quizzes

mod_rating: int | None = ormar.SmallInteger(nullable=True)

quiz.mod_rating = None  # Reset moderation rating on edit

imported_from_kahoot: Optional[bool] = ormar.Boolean(default=False, nullable=True)
kahoot_id: uuid.UUID | None = ormar.UUID(nullable=True, default=None)

await meilisearch.index(settings.meilisearch_index).add_documents(
    [await get_meili_data(quiz)]
)

if not quiz_input.public:
    # Quiz made private - remove from index
    meilisearch.index(settings.meilisearch_index).delete_document(str(quiz.id))
else:
    # Quiz still public - update index
    meilisearch.index(settings.meilisearch_index).add_documents(
        [await get_meili_data(quiz)]
    )

meilisearch.index(settings.meilisearch_index).delete_document(str(quiz.id))

# Get user profile
GET /api/v1/community/user/{user_id}

# Get user's public quizzes
GET /api/v1/community/quizzes/{user_id}?imported=false

# Rate a quiz
POST /api/v1/community/rate/{quiz_id}
Body: {"type": "LIKE" | "DISLIKE"}

# Get public quiz details
GET /api/v1/quiz/get/public/{quiz_id}