feat(user): implement user restrictions
## APIs Restricted for Restricted Users
A restricted user is blocked from performing the following actions, and will typically receive a `403 Forbidden` error:
* **Chat & Notifications:**
* Sending any chat messages (public or private).
* Joining or leaving chat channels.
* Creating new PM channels.
* **User Profile & Content:**
* Uploading a new avatar.
* Uploading a new profile cover image.
* Changing their username.
* Updating their userpage content.
* **Scores & Gameplay:**
* Submitting scores in multiplayer rooms.
* Deleting their own scores (to prevent hiding evidence of cheating).
* **Beatmaps:**
* Rating beatmaps.
* Taging beatmaps.
* **Relationship:**
* Adding friends or blocking users.
* Removing friends or unblocking users.
* **Teams:**
* Creating, updating, or deleting a team.
* Requesting to join a team.
* Handling join requests for a team they manage.
* Kicking a member from a team they manage.
* **Multiplayer:**
* Creating or deleting multiplayer rooms.
* Joining or leaving multiplayer rooms.
## What is Invisible to Normal Users
* **Leaderboards:**
* Beatmap leaderboards.
* Multiplayer (playlist) room leaderboards.
* **User Search/Lists:**
* Restricted users will not appear in the results of the `/api/v2/users` endpoint.
* They will not appear in the list of a team's members.
* **Relationship:**
* They will not appear in a user's friend list (`/friends`).
* **Profile & History:**
* Attempting to view a restricted user's profile, events, kudosu history, or score history will result in a `404 Not Found` error, effectively making their profile invisible (unless the user viewing the profile is the restricted user themselves).
* **Chat:**
* Normal users cannot start a new PM with a restricted user (they will get a `404 Not Found` error).
* **Ranking:**
* Restricted users are excluded from any rankings.
### How to Restrict a User
Insert into `user_account_history` with `type=restriction`.
```sql
-- length is in seconds
INSERT INTO user_account_history (`description`, `length`, `permanent`, `timestamp`, `type`, `user_id`) VALUE ('some description', 86400, 0, '2025-10-05 01:00:00', 'RESTRICTION', 1);
```
---
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -19,7 +19,7 @@ from .router import router
|
||||
|
||||
from fastapi import File, Form, HTTPException, Path, Request
|
||||
from pydantic import BaseModel
|
||||
from sqlmodel import exists, select
|
||||
from sqlmodel import col, exists, select
|
||||
|
||||
|
||||
@router.post("/team", name="创建战队", response_model=Team, tags=["战队", "g0v0 API"])
|
||||
@@ -38,6 +38,9 @@ async def create_team(
|
||||
flag 限制 240x120, 2MB; cover 限制 3000x2000, 10MB
|
||||
支持的图片格式: PNG、JPEG、GIF
|
||||
"""
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
user_id = current_user.id
|
||||
if (await current_user.awaitable_attrs.team_membership) is not None:
|
||||
raise HTTPException(status_code=403, detail="You are already in a team")
|
||||
@@ -98,6 +101,9 @@ async def update_team(
|
||||
flag 限制 240x120, 2MB; cover 限制 3000x2000, 10MB
|
||||
支持的图片格式: PNG、JPEG、GIF
|
||||
"""
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
team = await session.get(Team, team_id)
|
||||
user_id = current_user.id
|
||||
if not team:
|
||||
@@ -162,6 +168,9 @@ async def delete_team(
|
||||
current_user: ClientUser,
|
||||
redis: Redis,
|
||||
):
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
team = await session.get(Team, team_id)
|
||||
if not team:
|
||||
raise HTTPException(status_code=404, detail="Team not found")
|
||||
@@ -190,7 +199,14 @@ async def get_team(
|
||||
session: Database,
|
||||
team_id: Annotated[int, Path(..., description="战队 ID")],
|
||||
):
|
||||
members = (await session.exec(select(TeamMember).where(TeamMember.team_id == team_id))).all()
|
||||
members = (
|
||||
await session.exec(
|
||||
select(TeamMember).where(
|
||||
TeamMember.team_id == team_id,
|
||||
~User.is_restricted_query(col(TeamMember.user_id)),
|
||||
)
|
||||
)
|
||||
).all()
|
||||
return TeamQueryResp(
|
||||
team=members[0].team,
|
||||
members=[await UserResp.from_db(m.user, session, include=BASE_INCLUDES) for m in members],
|
||||
@@ -203,6 +219,9 @@ async def request_join_team(
|
||||
team_id: Annotated[int, Path(..., description="战队 ID")],
|
||||
current_user: ClientUser,
|
||||
):
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
team = await session.get(Team, team_id)
|
||||
if not team:
|
||||
raise HTTPException(status_code=404, detail="Team not found")
|
||||
@@ -233,6 +252,9 @@ async def handle_request(
|
||||
current_user: ClientUser,
|
||||
redis: Redis,
|
||||
):
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
team = await session.get(Team, team_id)
|
||||
if not team:
|
||||
raise HTTPException(status_code=404, detail="Team not found")
|
||||
@@ -274,6 +296,9 @@ async def kick_member(
|
||||
current_user: ClientUser,
|
||||
redis: Redis,
|
||||
):
|
||||
if await current_user.is_restricted(session):
|
||||
raise HTTPException(status_code=403, detail="Your account is restricted and cannot perform this action.")
|
||||
|
||||
team = await session.get(Team, team_id)
|
||||
if not team:
|
||||
raise HTTPException(status_code=404, detail="Team not found")
|
||||
|
||||
Reference in New Issue
Block a user