Files
tamabox/internal/db/report.go
T
2026-10-18 22:18:21 +08:00

124 lines
4.1 KiB
Go

// Copyright 2026 tamakyi. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
package db
import (
"context"
"time"
"github.com/pkg/errors"
"gorm.io/gorm"
)
// ReportsStore 举报记录的读写。
//
// 举报只是「信号」,处置仍然由箱主(在 /user 面板删/设私密)或运维(CLI)完成 ——
// 本项目没有管理后台,所以这里不提供「审核队列」之类的方法,只做写入与计数。
type ReportsStore interface {
// Create 写入一条举报。返回 created=false 表示该 IP 已举报过同一内容(唯一索引冲突),
// 属于幂等成功:调用方不应据此提示用户「已举报过」,否则会成为内容存在性的探测接口。
Create(ctx context.Context, opts CreateReportOptions) (bool, error)
// QuestionIDsByUser 返回某箱主名下「被举报的提问 ID -> 待处理举报数」。
// 箱主列表用它打标;已删除的提问不计入。
QuestionIDsByUser(ctx context.Context, userID uint) (map[uint]int64, error)
// CountByUserSince 统计某箱主自 since 起收到的待处理举报总数(邮件告警的触发依据)。
CountByUserSince(ctx context.Context, userID uint, since time.Time) (int64, error)
}
// Reports 举报记录全局 store,由 db.Init 装配。
var Reports ReportsStore
var _ ReportsStore = (*reports)(nil)
// 举报理由白名单。做成固定枚举而不是自由文本:自由填写等于又开了一个可以写辱骂内容的输入框,
// 而举报本身并不需要精确描述。
const (
ReportReasonHarassment = "harassment" // 人身攻击 / 辱骂
ReportReasonDoxxing = "doxxing" // 曝光他人账号或作品
ReportReasonDivisive = "divisive" // 挑起群体对立
ReportReasonOther = "other" // 其他
)
// IsValidReportReason 校验举报理由。
func IsValidReportReason(reason string) bool {
switch reason {
case ReportReasonHarassment, ReportReasonDoxxing, ReportReasonDivisive, ReportReasonOther:
return true
default:
return false
}
}
// CreateReportOptions 写入举报的入参。
type CreateReportOptions struct {
QuestionID uint
ReporterIP string
Reason string
}
func NewReportsStore(db *gorm.DB) ReportsStore {
return &reports{db: db}
}
type reports struct {
db *gorm.DB
}
func (s *reports) Create(ctx context.Context, opts CreateReportOptions) (bool, error) {
report := &ContentReport{
QuestionID: opts.QuestionID,
ReporterIP: opts.ReporterIP,
Reason: opts.Reason,
Status: ReportStatusPending,
}
if err := s.db.WithContext(ctx).Create(report).Error; err != nil {
// (question_id, reporter_ip) 唯一索引:同一个人对同一条内容只能报一次。
// 静默视为成功,避免通过「已举报过」的提示反查内容是否存在。
if isDuplicateKeyError(err) {
return false, nil
}
return false, errors.Wrap(err, "create content report")
}
return true, nil
}
func (s *reports) QuestionIDsByUser(ctx context.Context, userID uint) (map[uint]int64, error) {
type row struct {
QuestionID uint
Count int64
}
var rows []*row
if err := s.db.WithContext(ctx).
Table("content_reports AS r").
Select("r.question_id AS question_id, COUNT(r.id) AS count").
Joins("JOIN questions q ON q.id = r.question_id").
Where("q.user_id = ? AND q.deleted_at IS NULL", userID).
Where("r.status = ?", ReportStatusPending).
Group("r.question_id").
Scan(&rows).Error; err != nil {
return nil, errors.Wrap(err, "count reports by user")
}
counts := make(map[uint]int64, len(rows))
for _, r := range rows {
counts[r.QuestionID] = r.Count
}
return counts, nil
}
func (s *reports) CountByUserSince(ctx context.Context, userID uint, since time.Time) (int64, error) {
var count int64
if err := s.db.WithContext(ctx).
Table("content_reports AS r").
Joins("JOIN questions q ON q.id = r.question_id").
Where("q.user_id = ? AND q.deleted_at IS NULL", userID).
Where("r.status = ?", ReportStatusPending).
Where("r.created_at >= ?", since).
Count(&count).Error; err != nil {
return 0, errors.Wrap(err, "count reports since")
}
return count, nil
}