feat: add super comment governance and finance oversight

backend/app/http/super/v1/dto/super_comment.go

@@ -0,0 +1,74 @@
+package dto
+
+import "quyun/v2/app/requests"
+
+// SuperCommentListFilter 超管评论列表过滤条件。
+type SuperCommentListFilter struct {
+	requests.Pagination
+	// ID 评论ID，精确匹配。
+	ID *int64 `query:"id"`
+	// TenantID 租户ID，精确匹配。
+	TenantID *int64 `query:"tenant_id"`
+	// TenantCode 租户编码，模糊匹配。
+	TenantCode *string `query:"tenant_code"`
+	// TenantName 租户名称，模糊匹配。
+	TenantName *string `query:"tenant_name"`
+	// ContentID 内容ID，精确匹配。
+	ContentID *int64 `query:"content_id"`
+	// ContentTitle 内容标题关键字，模糊匹配。
+	ContentTitle *string `query:"content_title"`
+	// UserID 评论用户ID，精确匹配。
+	UserID *int64 `query:"user_id"`
+	// Username 评论用户用户名/昵称，模糊匹配。
+	Username *string `query:"username"`
+	// Keyword 评论内容关键字，模糊匹配。
+	Keyword *string `query:"keyword"`
+	// Status 评论状态过滤（active/deleted/all）。
+	Status *string `query:"status"`
+	// CreatedAtFrom 创建时间起始（RFC3339）。
+	CreatedAtFrom *string `query:"created_at_from"`
+	// CreatedAtTo 创建时间结束（RFC3339）。
+	CreatedAtTo *string `query:"created_at_to"`
+	// Asc 升序字段（id/created_at/likes）。
+	Asc *string `query:"asc"`
+	// Desc 降序字段（id/created_at/likes）。
+	Desc *string `query:"desc"`
+}
+
+// SuperCommentItem 超管评论列表项。
+type SuperCommentItem struct {
+	// ID 评论ID。
+	ID int64 `json:"id"`
+	// TenantID 租户ID。
+	TenantID int64 `json:"tenant_id"`
+	// TenantCode 租户编码。
+	TenantCode string `json:"tenant_code"`
+	// TenantName 租户名称。
+	TenantName string `json:"tenant_name"`
+	// ContentID 内容ID。
+	ContentID int64 `json:"content_id"`
+	// ContentTitle 内容标题。
+	ContentTitle string `json:"content_title"`
+	// UserID 评论用户ID。
+	UserID int64 `json:"user_id"`
+	// Username 评论用户名称。
+	Username string `json:"username"`
+	// ReplyTo 回复评论ID（0 表示一级评论）。
+	ReplyTo int64 `json:"reply_to"`
+	// Content 评论内容。
+	Content string `json:"content"`
+	// Likes 评论点赞数。
+	Likes int32 `json:"likes"`
+	// IsDeleted 是否已删除。
+	IsDeleted bool `json:"is_deleted"`
+	// CreatedAt 创建时间（RFC3339）。
+	CreatedAt string `json:"created_at"`
+	// DeletedAt 删除时间（RFC3339，未删除为空）。
+	DeletedAt string `json:"deleted_at"`
+}
+
+// SuperCommentDeleteForm 超管删除评论表单。
+type SuperCommentDeleteForm struct {
+	// Reason 删除原因（可选，用于审计记录）。
+	Reason string `json:"reason"`
+}

backend/app/http/super/v1/dto/super_finance.go

@@ -0,0 +1,177 @@
+package dto
+
+import (
+	"quyun/v2/app/requests"
+	"quyun/v2/pkg/consts"
+)
+
+// SuperLedgerListFilter 超管资金流水过滤条件。
+type SuperLedgerListFilter struct {
+	requests.Pagination
+	// ID 流水ID，精确匹配。
+	ID *int64 `query:"id"`
+	// TenantID 租户ID，精确匹配。
+	TenantID *int64 `query:"tenant_id"`
+	// TenantCode 租户编码，模糊匹配。
+	TenantCode *string `query:"tenant_code"`
+	// TenantName 租户名称，模糊匹配。
+	TenantName *string `query:"tenant_name"`
+	// UserID 用户ID，精确匹配。
+	UserID *int64 `query:"user_id"`
+	// Username 用户名/昵称，模糊匹配。
+	Username *string `query:"username"`
+	// OrderID 关联订单ID，精确匹配。
+	OrderID *int64 `query:"order_id"`
+	// Type 流水类型过滤。
+	Type *consts.TenantLedgerType `query:"type"`
+	// AmountMin 金额下限（分）。
+	AmountMin *int64 `query:"amount_min"`
+	// AmountMax 金额上限（分）。
+	AmountMax *int64 `query:"amount_max"`
+	// CreatedAtFrom 创建时间起始（RFC3339）。
+	CreatedAtFrom *string `query:"created_at_from"`
+	// CreatedAtTo 创建时间结束（RFC3339）。
+	CreatedAtTo *string `query:"created_at_to"`
+	// Asc 升序字段（id/created_at/amount）。
+	Asc *string `query:"asc"`
+	// Desc 降序字段（id/created_at/amount）。
+	Desc *string `query:"desc"`
+}
+
+// SuperLedgerItem 超管资金流水项。
+type SuperLedgerItem struct {
+	// ID 流水ID。
+	ID int64 `json:"id"`
+	// TenantID 租户ID。
+	TenantID int64 `json:"tenant_id"`
+	// TenantCode 租户编码。
+	TenantCode string `json:"tenant_code"`
+	// TenantName 租户名称。
+	TenantName string `json:"tenant_name"`
+	// UserID 关联用户ID。
+	UserID int64 `json:"user_id"`
+	// Username 关联用户名。
+	Username string `json:"username"`
+	// OrderID 关联订单ID。
+	OrderID int64 `json:"order_id"`
+	// Type 流水类型。
+	Type consts.TenantLedgerType `json:"type"`
+	// TypeDescription 流水类型描述（用于展示）。
+	TypeDescription string `json:"type_description"`
+	// Amount 变动金额（分）。
+	Amount int64 `json:"amount"`
+	// BalanceBefore 变更前可用余额（分）。
+	BalanceBefore int64 `json:"balance_before"`
+	// BalanceAfter 变更后可用余额（分）。
+	BalanceAfter int64 `json:"balance_after"`
+	// FrozenBefore 变更前冻结余额（分）。
+	FrozenBefore int64 `json:"frozen_before"`
+	// FrozenAfter 变更后冻结余额（分）。
+	FrozenAfter int64 `json:"frozen_after"`
+	// Remark 流水备注说明。
+	Remark string `json:"remark"`
+	// OperatorUserID 操作者用户ID（0 表示系统）。
+	OperatorUserID int64 `json:"operator_user_id"`
+	// BizRefType 业务引用类型（可选）。
+	BizRefType string `json:"biz_ref_type"`
+	// BizRefID 业务引用ID（可选）。
+	BizRefID int64 `json:"biz_ref_id"`
+	// CreatedAt 创建时间（RFC3339）。
+	CreatedAt string `json:"created_at"`
+	// UpdatedAt 更新时间（RFC3339）。
+	UpdatedAt string `json:"updated_at"`
+}
+
+// SuperBalanceAnomalyFilter 余额异常筛选条件。
+type SuperBalanceAnomalyFilter struct {
+	requests.Pagination
+	// UserID 用户ID，精确匹配。
+	UserID *int64 `query:"user_id"`
+	// Username 用户名/昵称，模糊匹配。
+	Username *string `query:"username"`
+	// Issue 异常类型（negative_balance/negative_frozen）。
+	Issue *string `query:"issue"`
+	// Asc 升序字段（id/balance/balance_frozen）。
+	Asc *string `query:"asc"`
+	// Desc 降序字段（id/balance/balance_frozen）。
+	Desc *string `query:"desc"`
+}
+
+// SuperBalanceAnomalyItem 余额异常项。
+type SuperBalanceAnomalyItem struct {
+	// UserID 用户ID。
+	UserID int64 `json:"user_id"`
+	// Username 用户名。
+	Username string `json:"username"`
+	// Balance 可用余额（分）。
+	Balance int64 `json:"balance"`
+	// BalanceFrozen 冻结余额（分）。
+	BalanceFrozen int64 `json:"balance_frozen"`
+	// Issue 异常类型标识。
+	Issue string `json:"issue"`
+	// IssueDescription 异常描述说明。
+	IssueDescription string `json:"issue_description"`
+	// CreatedAt 用户创建时间（RFC3339）。
+	CreatedAt string `json:"created_at"`
+}
+
+// SuperOrderAnomalyFilter 订单异常筛选条件。
+type SuperOrderAnomalyFilter struct {
+	requests.Pagination
+	// ID 订单ID，精确匹配。
+	ID *int64 `query:"id"`
+	// TenantID 租户ID，精确匹配。
+	TenantID *int64 `query:"tenant_id"`
+	// TenantCode 租户编码，模糊匹配。
+	TenantCode *string `query:"tenant_code"`
+	// TenantName 租户名称，模糊匹配。
+	TenantName *string `query:"tenant_name"`
+	// UserID 用户ID，精确匹配。
+	UserID *int64 `query:"user_id"`
+	// Username 用户名/昵称，模糊匹配。
+	Username *string `query:"username"`
+	// Type 订单类型过滤。
+	Type *consts.OrderType `query:"type"`
+	// Issue 异常类型（missing_paid_at/missing_refunded_at）。
+	Issue *string `query:"issue"`
+	// CreatedAtFrom 创建时间起始（RFC3339）。
+	CreatedAtFrom *string `query:"created_at_from"`
+	// CreatedAtTo 创建时间结束（RFC3339）。
+	CreatedAtTo *string `query:"created_at_to"`
+	// Asc 升序字段（id/created_at/amount_paid）。
+	Asc *string `query:"asc"`
+	// Desc 降序字段（id/created_at/amount_paid）。
+	Desc *string `query:"desc"`
+}
+
+// SuperOrderAnomalyItem 订单异常项。
+type SuperOrderAnomalyItem struct {
+	// OrderID 订单ID。
+	OrderID int64 `json:"order_id"`
+	// TenantID 租户ID。
+	TenantID int64 `json:"tenant_id"`
+	// TenantCode 租户编码。
+	TenantCode string `json:"tenant_code"`
+	// TenantName 租户名称。
+	TenantName string `json:"tenant_name"`
+	// UserID 用户ID。
+	UserID int64 `json:"user_id"`
+	// Username 用户名。
+	Username string `json:"username"`
+	// Type 订单类型。
+	Type consts.OrderType `json:"type"`
+	// Status 订单状态。
+	Status consts.OrderStatus `json:"status"`
+	// AmountPaid 实付金额（分）。
+	AmountPaid int64 `json:"amount_paid"`
+	// Issue 异常类型标识。
+	Issue string `json:"issue"`
+	// IssueDescription 异常描述说明。
+	IssueDescription string `json:"issue_description"`
+	// CreatedAt 创建时间（RFC3339）。
+	CreatedAt string `json:"created_at"`
+	// PaidAt 支付时间（RFC3339）。
+	PaidAt string `json:"paid_at"`
+	// RefundedAt 退款时间（RFC3339）。
+	RefundedAt string `json:"refunded_at"`
+}