e1bd0e3ef7
改了什么:新增新版大盘日期窗口聚合、广告收益拆分、比价耗时字段、美团 CPS 拉单入库与大盘展示,并同步反馈审核和邀请奖励下线口径。 验证:python -m pytest tests/test_admin_read.py tests/test_admin_write.py tests/test_compare_record.py tests/test_invite.py tests/test_feedback.py -q。
117 lines
4.0 KiB
Python
117 lines
4.0 KiB
Python
"""帮助与反馈 endpoint。
|
|
|
|
路由前缀 `/api/v1/feedback`,需 Bearer 鉴权(反馈绑到登录用户,便于回访)。
|
|
POST / 提交反馈(multipart:content,images 可选 ≤4 张)
|
|
GET /records 我的反馈历史(pending/adopted/rejected)
|
|
|
|
截图复用 [app.core.media] 落盘到 /media/feedback/。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
|
|
from fastapi import APIRouter, File, Form, HTTPException, Query, UploadFile
|
|
|
|
from app.api.deps import CurrentUser, DbSession
|
|
from app.core import media
|
|
from app.repositories import feedback as feedback_repo
|
|
from app.schemas.feedback import (
|
|
FeedbackConfigOut,
|
|
FeedbackOut,
|
|
FeedbackRecordCountsOut,
|
|
FeedbackRecordOut,
|
|
FeedbackRecordsOut,
|
|
)
|
|
|
|
logger = logging.getLogger("shagua.feedback")
|
|
|
|
router = APIRouter(prefix="/api/v1/feedback", tags=["feedback"])
|
|
|
|
_MAX_IMAGES = 4
|
|
_CONTENT_MAX = 2000
|
|
_CONTACT_MAX = 128
|
|
_VALID_RECORD_STATUS = {"pending", "adopted", "rejected"}
|
|
|
|
|
|
def _app_status(db_status: str) -> str:
|
|
return {
|
|
"new": "pending",
|
|
"handled": "adopted",
|
|
"approved": "adopted",
|
|
}.get(db_status, db_status)
|
|
|
|
|
|
def _record_out(fb) -> FeedbackRecordOut:
|
|
return FeedbackRecordOut(
|
|
id=fb.id,
|
|
content=fb.content,
|
|
images=fb.images or [],
|
|
status=_app_status(fb.status),
|
|
reject_reason=getattr(fb, "reject_reason", None),
|
|
reward_coins=getattr(fb, "reward_coins", None),
|
|
created_at=fb.created_at,
|
|
)
|
|
|
|
|
|
@router.get("/config", response_model=FeedbackConfigOut, summary="反馈页配置")
|
|
def feedback_config(_: CurrentUser) -> FeedbackConfigOut:
|
|
return FeedbackConfigOut()
|
|
|
|
|
|
@router.get("/records", response_model=FeedbackRecordsOut, summary="我的反馈历史")
|
|
def feedback_records(
|
|
user: CurrentUser,
|
|
db: DbSession,
|
|
status: str | None = Query(default=None),
|
|
) -> FeedbackRecordsOut:
|
|
if status is not None and status not in _VALID_RECORD_STATUS:
|
|
raise HTTPException(status_code=400, detail="invalid status")
|
|
|
|
all_records = [_record_out(fb) for fb in feedback_repo.list_feedback(db, user_id=user.id)]
|
|
counts = FeedbackRecordCountsOut(
|
|
all=len(all_records),
|
|
pending=sum(1 for r in all_records if r.status == "pending"),
|
|
adopted=sum(1 for r in all_records if r.status == "adopted"),
|
|
rejected=sum(1 for r in all_records if r.status == "rejected"),
|
|
)
|
|
records = [r for r in all_records if r.status == status] if status else all_records
|
|
return FeedbackRecordsOut(records=records, counts=counts)
|
|
|
|
|
|
@router.post("", response_model=FeedbackOut, summary="提交反馈")
|
|
async def submit_feedback(
|
|
user: CurrentUser,
|
|
db: DbSession,
|
|
content: str = Form(...),
|
|
# 原型改版后 App 已去掉"联系方式"字段,故 contact 改为可选(默认空串);
|
|
# 仍兼容旧端/后台带 contact 的提交。DB 列为 NOT NULL,空串即可满足。
|
|
contact: str = Form(default=""),
|
|
images: list[UploadFile] = File(default=[]),
|
|
) -> FeedbackOut:
|
|
content = content.strip()
|
|
contact = contact.strip()
|
|
if not content:
|
|
raise HTTPException(status_code=400, detail="反馈内容不能为空")
|
|
if len(content) > _CONTENT_MAX:
|
|
raise HTTPException(status_code=400, detail="反馈内容过长")
|
|
if len(contact) > _CONTACT_MAX:
|
|
raise HTTPException(status_code=400, detail="联系方式过长")
|
|
|
|
files = [f for f in (images or []) if f is not None and f.filename]
|
|
if len(files) > _MAX_IMAGES:
|
|
raise HTTPException(status_code=400, detail=f"最多上传 {_MAX_IMAGES} 张图片")
|
|
|
|
urls: list[str] = []
|
|
for f in files:
|
|
data = await f.read()
|
|
try:
|
|
urls.append(media.save_feedback_image(user.id, data))
|
|
except media.MediaError as e:
|
|
raise HTTPException(status_code=400, detail=str(e)) from e
|
|
|
|
fb = feedback_repo.create_feedback(
|
|
db, user_id=user.id, content=content, contact=contact, images=urls,
|
|
)
|
|
logger.info("feedback id=%d user_id=%d images=%d", fb.id, user.id, len(urls))
|
|
return FeedbackOut.model_validate(fb)
|