feat: 优化代码结构

This commit is contained in:
DengDai
2025-11-24 13:40:58 +08:00
parent aa516a8d71
commit 148fc78014
8 changed files with 69 additions and 261 deletions

View File

@@ -2,12 +2,16 @@ from datetime import datetime
from flask_login import UserMixin
from werkzeug.security import generate_password_hash, check_password_hash
from app import db, login_manager
class PartnerSite(db.Model):
__tablename__ = 'partner_sites'
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(100), unique=True, nullable=False, index=True)
name = db.Column(db.String(100), unique=True, nullable=False, index=True)
url = db.Column(db.String(255), nullable=True)
is_active = db.Column(db.Boolean, default=True, nullable=False, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __repr__(self):
return f'<PartnerSite {self.name}>'
class User(UserMixin, db.Model):
@@ -16,13 +20,13 @@ class User(UserMixin, db.Model):
username = db.Column(db.String(64), unique=True, index=True, nullable=False)
email = db.Column(db.String(120), unique=True, index=True, nullable=False)
password_hash = db.Column(db.String(256))
role = db.Column(db.String(20), default='user', index=True) # 'user', 'admin', 'trusted_user'
status = db.Column(db.String(20), default='pending', index=True) # 'pending', 'active'
role = db.Column(db.String(16), default='user', index=True) # 'user', 'admin', 'trust_user'
status = db.Column(db.String(16), default='pending', index=True) # 'pending', 'active', 'disabled'
created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
pt_site = db.Column(db.String(100)) # 注册时填写的站点
uid = db.Column(db.String(50)) # 注册时填写的 UID
reports = db.relationship('Report', backref='reporter', lazy='dynamic')
# comments = db.relationship('Comment', backref='author', lazy='dynamic')
comments = db.relationship('Comment', back_populates='author', lazy='dynamic')
def set_password(self, password):
self.password_hash = generate_password_hash(password)
@@ -39,19 +43,23 @@ def load_user(user_id):
class Report(db.Model):
__tablename__ = 'reports'
__table_args__ = (
db.Index('idx_report_status_created', 'status', 'created_at'),
)
id = db.Column(db.Integer, primary_key=True)
reporter_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
reporter_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE'), nullable=False)
reported_pt_site = db.Column(db.String(100), nullable=False)
reported_uid = db.Column(db.String(50))
reported_username = db.Column(db.String(50))
reported_email = db.Column(db.String(120), index=True, nullable=False)
reason_category = db.Column(db.String(50), nullable=False) # e.g., 'cheating', 'trading', 'spam'
reason_category = db.Column(db.String(16), nullable=False) # 'cheating', 'trading', 'spam', 'abusive', 'radio', 'other'
description = db.Column(db.Text, nullable=False)
status = db.Column(db.String(20), index=True, default='pending') # 'pending', 'in_review', 'approved', 'rejected'
status = db.Column(db.String(16), index=True, default='pending') # 'pending', 'approved', 'rejected', 'revoked', 'overturned'
created_at = db.Column(db.DateTime, index=True, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
comments = db.relationship('Comment', backref='report', lazy='dynamic', cascade='all, delete-orphan')
evidences = db.relationship('Evidence', backref='report', lazy='dynamic', cascade="all, delete-orphan")
blacklist_entry = db.relationship('Blacklist', backref='report', uselist=False) # one-to-one
evidences = db.relationship('Evidence', backref='report', lazy='dynamic', cascade='all, delete-orphan')
blacklist_entry = db.relationship('Blacklist', backref='report', uselist=False)
def __repr__(self):
return f'<Report {self.id}>'
@@ -59,16 +67,22 @@ class Report(db.Model):
class Evidence(db.Model):
__tablename__ = 'evidences'
id = db.Column(db.Integer, primary_key=True)
report_id = db.Column(db.Integer, db.ForeignKey('reports.id'), nullable=False)
file_url = db.Column(db.String(512), nullable=False) # 存储OSS或本地路径
file_type = db.Column(db.String(20)) # 'image', 'zip', 'text'
report_id = db.Column(db.Integer, db.ForeignKey('reports.id', ondelete='CASCADE'), nullable=False)
file_url = db.Column(db.String(1024), nullable=False) # 存储OSS或本地路径
file_type = db.Column(db.String(16)) # 'image', 'zip', 'text', 'image_url'
created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __repr__(self):
return f'<Evidence {self.id} for Report {self.report_id}>'
class Blacklist(db.Model):
__tablename__ = 'blacklist'
__table_args__ = (
db.Index('idx_blacklist_email_status', 'normalized_email', 'status'),
db.Index('idx_blacklist_username_status', 'username', 'status'),
)
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(64), index=True)
email = db.Column(db.String(120), index=True)
@@ -76,42 +90,43 @@ class Blacklist(db.Model):
pt_site = db.Column(db.String(100), index=True)
uid = db.Column(db.String(50))
report_id = db.Column(db.Integer, db.ForeignKey('reports.id'), unique=True) # 确保一个举报只对应一个黑名单条目
status = db.Column(db.String(20), default='active', index=True) # 'active', 'appealed_ok', 'expired'
status = db.Column(db.String(16), default='active', index=True) # 'active', 'revoked', 'expired'
created_at = db.Column(db.DateTime, index=True, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
appeals = db.relationship('Appeal', backref='blacklist_entry', lazy='dynamic')
def __repr__(self):
return f'<Blacklist {self.normalized_email} on {self.pt_site}>'
class Comment(db.Model):
__tablename__ = 'comments'
id = db.Column(db.Integer, primary_key=True)
body = db.Column(db.Text)
timestamp = db.Column(db.DateTime, index=True, default=datetime.utcnow)
author_id = db.Column(db.Integer, db.ForeignKey('users.id'))
report_id = db.Column(db.Integer, db.ForeignKey('reports.id'))
# author = db.relationship('User') # 方便地通过 comment.author 访问用户
created_at = db.Column(db.DateTime, index=True, default=datetime.utcnow)
author_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE'))
report_id = db.Column(db.Integer, db.ForeignKey('reports.id', ondelete='CASCADE'))
author = db.relationship('User', back_populates='comments')
class Appeal(db.Model):
__tablename__ = 'appeals'
id = db.Column(db.Integer, primary_key=True)
reason = db.Column(db.Text, nullable=False) # 用户最初的申诉理由
status = db.Column(db.String(64), nullable=False, default='awaiting_admin_reply') # 状态: awaiting_admin_reply, awaiting_user_reply, closed_approved, closed_rejected
status = db.Column(db.String(32), nullable=False, default='awaiting_admin_reply', index=True) # 'awaiting_admin_reply', 'awaiting_user_reply', 'approved', 'rejected'
created_at = db.Column(db.DateTime, index=True, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
# 关系
appealer_id = db.Column(db.Integer, db.ForeignKey('users.id')) # 申诉人
blacklist_entry_id = db.Column(db.Integer, db.ForeignKey('blacklist.id')) # 关联的黑名单条目
appealer_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE')) # 申诉人
blacklist_entry_id = db.Column(db.Integer, db.ForeignKey('blacklist.id', ondelete='SET NULL')) # 关联的黑名单条目
messages = db.relationship('AppealMessage', backref='appeal', lazy='dynamic', cascade='all, delete-orphan')
appealer = db.relationship('User', backref='appeals')
def __repr__(self):
return f'<Appeal {self.id}>'
class AppealMessage(db.Model):
__tablename__ = 'appeal_messages'
id = db.Column(db.Integer, primary_key=True)
body = db.Column(db.Text, nullable=False)
timestamp = db.Column(db.DateTime, index=True, default=datetime.utcnow)
# 关系
author_id = db.Column(db.Integer, db.ForeignKey('users.id')) # 消息发送者
appeal_id = db.Column(db.Integer, db.ForeignKey('appeals.id'))
created_at = db.Column(db.DateTime, index=True, default=datetime.utcnow)
author_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE')) # 消息发送者
appeal_id = db.Column(db.Integer, db.ForeignKey('appeals.id', ondelete='CASCADE'))
author = db.relationship('User', backref='appeal_messages')
def __repr__(self):
return f'<AppealMessage {self.id}>'