Add leaderboard stats, periodic updates via fastapi-utils

[andreaskoepf]

Provide new leaderboard REST endpoints:
/api/v1/leaderboards/{day,week,month,total}

Example response:

{
  "time_frame": "day",
  "leaderboard": [
    {
      "user_rank": 0,
      "user_id": "38312e49-8cd6-4e7c-8bad-c626e452b1e7",
      "username": "__dummy_user__",
      "auth_method": "local",
      "display_name": "Dummy User",
      "leader_score": 2740,
      "base_date": "2023-01-14T00:42:14.937437",
      "modified_date": "2023-01-15T00:42:14.937534",
      "prompts": 74,
      "replies_assistant": 261,
      "replies_prompter": 109,
      "labels_simple": 0,
      "labels_full": 0,
      "rankings_total": 0,
      "rankings_good": 0,
      "accepted_prompts": 74,
      "accepted_replies_assistant": 261,
      "accepted_replies_prompter": 109,
      "reply_ranked_1": 22,
      "reply_ranked_2": 22,
      "reply_ranked_3": 22,
      "streak_last_day_date": null,
      "streak_days": null
    }
}

[yk]

awesome

[yk]

how about making these constants into settings?

[andreaskoepf]

We need to find a "stable" formula for the leader-score .. calculation is "magic" right now .. the exact way how to calculate it needs more discussion, e.g. could be based on acceptance rations or include negative values..

[yk]

just for prettiness, could use functools.wraps

[andreaskoepf]

I made it now a param + non-param decorator .. with optional logging of the kwargs. regarding functool.wraps ..that makes sure that docstring and function name are preserved .. right?

[yk]

yes, it's just for clarity

[yk]

the upgrade drops and recreates the user_stats table, while the downgrade just modifies the columns. it's probably fine though

[andreaskoepf]

Yes, intentionally. Somehow alembic didn't manage it to add a second column to the PK as a change, e.g. this table has a combined user_id + time_frame PK and before had only user_id. The table wasn't used before...