app/utils/helpers.py

from flask import jsonify


def success_response(data, message="OK", status=200):
    return jsonify({"success": True, "message": message, "data": data}), status


def error_response(message="An error occurred", status=400):
    return jsonify({"success": False, "message": message, "data": None}), status


def hsk_meta(level: int) -> dict:
    meta = {
        1: {"label": "HSK 1", "color": "#4CAF50", "words": 150, "desc": "Beginner – everyday basics"},
        2: {"label": "HSK 2", "color": "#8BC34A", "words": 300, "desc": "Elementary – simple conversations"},
        3: {"label": "HSK 3", "color": "#FFC107", "words": 600, "desc": "Pre-Intermediate – daily life"},
        4: {"label": "HSK 4", "color": "#FF9800", "words": 1200, "desc": "Intermediate – broad topics"},
        5: {"label": "HSK 5", "color": "#F44336", "words": 2500, "desc": "Upper-Intermediate – fluent reading"},
        6: {"label": "HSK 6", "color": "#9C27B0", "words": 5000, "desc": "Advanced – academic & professional"},
    }
    return meta.get(level, {})