zhengchiliu
0863234bc5
仪表盘待办与穿搭概况改为公开/私密/已封禁口径，移除恒为零的待审核统计；补齐额度凭证来源 source=4 与流水 change_type=7 枚举及订单商品类型、额度有效期快照字段；管理员发放与回收额度凭证在同一事务内写入人工调整流水，回收流水使用独立 order_no 避免撞唯一索引，并增加凭证归属校验；对齐 Quota 配置免费额度值，同步更新 README 与配置说明。
341 lines
19 KiB
Go
341 lines
19 KiB
Go
package mysqlmodel
|
||
|
||
// 本文件为业务服务（zt-closet-backend）数据表模型的镜像定义。
|
||
// 管理后台与业务服务共用同一 MySQL 库，直接读写业务表；
|
||
// 字段与表名必须与业务服务 internal/mysqlmodel 保持一致。
|
||
|
||
// ===== 用户 =====
|
||
|
||
type User struct {
|
||
Model
|
||
UserUUID string `gorm:"column:user_uuid"` // 用户UUID
|
||
WxOpenID string `gorm:"column:wx_open_id;uniqueIndex:uk_user_wx_open_id"` // 微信openid
|
||
Username string `gorm:"column:username"` // 用户名
|
||
Avatar string `gorm:"column:avatar"` // 头像存储位置
|
||
Sex int8 `gorm:"column:sex"` // 性别 1=男 2=女
|
||
BirthDay int64 `gorm:"column:birth_day"` // 生日
|
||
Phone string `gorm:"column:phone"` // 手机号
|
||
IsNewUser bool `gorm:"column:is_new_user"` // 是否新用户
|
||
Status int8 `gorm:"column:status"` // 状态 1=正常 2=临时禁用 3=永久禁用 4=已注销
|
||
BanReason string `gorm:"column:ban_reason"` // 封禁原因
|
||
BanStart int64 `gorm:"column:ban_start"` // 封禁开始时间
|
||
BanExpire int64 `gorm:"column:ban_expire"` // 封禁到期时间
|
||
VIPType int8 `gorm:"column:vip_type"` // VIP类型 1=非会员 2=月度会员 3=年度会员 4=体验会员
|
||
VIPStart int64 `gorm:"column:vip_start"` // VIP开始时间
|
||
VIPExpire int64 `gorm:"column:vip_expire"` // VIP到期时间
|
||
LastLoginTime int64 `gorm:"column:last_login_time"` // 最近登录时间
|
||
}
|
||
|
||
func (User) TableName() string {
|
||
return "users"
|
||
}
|
||
|
||
// ===== 商品 =====
|
||
|
||
type Goods struct {
|
||
Model
|
||
GoodsCode string `gorm:"column:goods_code"` // 商品编码（唯一）
|
||
GoodsName string `gorm:"column:goods_name"` // 商品名称
|
||
GoodsType int8 `gorm:"column:goods_type"` // 商品类型 1=会员包 2=上传包 3=AI推荐包 4=衣柜分享包 5=搭配分享包
|
||
Price int64 `gorm:"column:price"` // 商品原价（分）
|
||
DiscountPrice int64 `gorm:"column:discount_price"` // 商品售价（分）
|
||
MemberDays int64 `gorm:"column:member_days"` // 赠送会员天数
|
||
CosQuota int64 `gorm:"column:cos_quota"` // 赠送总上传额度
|
||
AIRecommendQuota int64 `gorm:"column:ai_recommend_quota"` // 赠送AI推荐额度
|
||
ClosetShareQuota int64 `gorm:"column:closet_share_quota"` // 赠送衣柜分享额度
|
||
OutfitShareQuota int64 `gorm:"column:outfit_share_quota"` // 赠送搭配分享额度
|
||
ValidDays int64 `gorm:"column:valid_days"` // 赠送额度有效期天数（加量包用；会员包为 0 表示跟随 VIP）
|
||
Description string `gorm:"column:description"` // 商品描述
|
||
Status int8 `gorm:"column:status"` // 状态 1=上架 2=下架
|
||
ProductID string `gorm:"column:product_id"` // 虚拟支付道具ID（空表示未发布）
|
||
ProductStatus int8 `gorm:"column:product_status"` // 虚拟支付道具发布状态 0=未发布 1=发布中 2=已发布 3=发布失败
|
||
}
|
||
|
||
func (Goods) TableName() string {
|
||
return "goods"
|
||
}
|
||
|
||
// ===== 订单 =====
|
||
|
||
type Order struct {
|
||
Model
|
||
// OrderNo 商户订单号；唯一索引保证订单号全局唯一。
|
||
OrderNo string `gorm:"column:order_no;uniqueIndex:uk_order_no"`
|
||
UserID int64 `gorm:"column:user_id"` // 下单用户ID
|
||
GoodsID int64 `gorm:"column:goods_id"` // 关联商品ID
|
||
GoodsName string `gorm:"column:goods_name"` // 商品名称快照
|
||
UnitPrice int64 `gorm:"column:unit_price"` // 商品单价（分）
|
||
TotalAmount int64 `gorm:"column:total_amount"` // 订单总金额（分）
|
||
PayAmount int64 `gorm:"column:pay_amount"` // 实付金额（分）
|
||
PayChannel int8 `gorm:"column:pay_channel"` // 支付渠道 1=微信支付 2=微信虚拟支付（XPay）
|
||
OrderStatus int8 `gorm:"column:order_status"` // 订单状态 1=待支付 2=已支付 3=已取消 4=已过期 5=已退款
|
||
TransactionID string `gorm:"column:transaction_id"` // 微信支付流水号
|
||
MemberDays int64 `gorm:"column:member_days"` // 购买的会员天数（快照）
|
||
GoodsType int8 `gorm:"column:goods_type"` // 商品类型（快照）
|
||
QuotaValidDays int64 `gorm:"column:quota_valid_days"` // 额度有效期天数（快照）
|
||
CosQuota int64 `gorm:"column:cos_quota"` // 赠送上传额度（快照）
|
||
AIRecommendQuota int64 `gorm:"column:ai_recommend_quota"` // 赠送AI推荐额度（快照）
|
||
ClosetShareQuota int64 `gorm:"column:closet_share_quota"` // 赠送衣柜分享额度（快照）
|
||
OutfitShareQuota int64 `gorm:"column:outfit_share_quota"` // 赠送搭配分享额度（快照）
|
||
ExpireTime int64 `gorm:"column:expire_time"` // 支付过期时间
|
||
PayTime int64 `gorm:"column:pay_time"` // 支付完成时间
|
||
RefundTime int64 `gorm:"column:refund_time"` // 退款时间
|
||
RefundAmount int64 `gorm:"column:refund_amount"` // 退款金额（分）
|
||
Remark string `gorm:"column:remark"` // 订单备注
|
||
CallbackRaw string `gorm:"column:callback_raw"` // 支付回调原始报文
|
||
XPayProductID string `gorm:"column:xpay_product_id"` // 虚拟支付道具ID（快照，pay_channel=2 时使用）
|
||
XPayPlatform string `gorm:"column:xpay_platform"` // 虚拟支付平台 android/ios/harmony/windows
|
||
XPayEnv int8 `gorm:"column:xpay_env"` // 虚拟支付环境 0=现网 1=沙箱
|
||
}
|
||
|
||
func (Order) TableName() string {
|
||
return "orders"
|
||
}
|
||
|
||
// ===== 退款 =====
|
||
|
||
type RefundFlowLog struct {
|
||
Model
|
||
OrderID int64 `gorm:"column:order_id"` // 关联订单ID
|
||
OrderNo string `gorm:"column:order_no"` // 商户订单号（冗余，方便查询）
|
||
UserID int64 `gorm:"column:user_id"` // 用户ID（冗余，方便按用户查）
|
||
// RefundNo 商户退款单号；唯一索引为退款申请防重/重试幂等依据。
|
||
RefundNo string `gorm:"column:refund_no;uniqueIndex:uk_refund_flow_no"`
|
||
WechatRefundNo string `gorm:"column:wechat_refund_no"` // 微信退款单号
|
||
RefundAmount int64 `gorm:"column:refund_amount"` // 本次退款金额（分）
|
||
RefundReason string `gorm:"column:refund_reason"` // 退款原因
|
||
Status int8 `gorm:"column:status"` // 退款状态 0=待处理 1=退款中 2=退款成功 3=退款失败
|
||
ApplyTime int64 `gorm:"column:apply_time"` // 申请时间
|
||
SuccessTime int64 `gorm:"column:success_time"` // 退款成功时间
|
||
FailReason string `gorm:"column:fail_reason"` // 失败原因
|
||
CallbackRaw string `gorm:"column:callback_raw"` // 微信退款回调原始报文
|
||
}
|
||
|
||
func (RefundFlowLog) TableName() string {
|
||
return "refund_flow_logs"
|
||
}
|
||
|
||
// ===== 穿搭 =====
|
||
|
||
type Outfit struct {
|
||
Model
|
||
OutfitUUID string `gorm:"column:outfit_uuid"` // 穿搭UUID
|
||
UserID int64 `gorm:"column:user_id"` // 所属用户ID
|
||
OutfitName string `gorm:"column:outfit_name"` // 穿搭名称
|
||
OutfitDesc string `gorm:"column:outfit_desc"` // 穿搭描述
|
||
Scene string `gorm:"column:scene"` // 适合场景
|
||
Source int8 `gorm:"column:source"` // 来源 1=用户创建 2=AI推荐
|
||
IsPublic int8 `gorm:"column:is_public"` // 是否公开 1=不公开 2=公开
|
||
AuditStatus int8 `gorm:"column:audit_status"` // 审核状态 1=待审核 2=审核通过 3=审核不通过
|
||
Status int8 `gorm:"column:status"` // 状态 1=正常 2=封禁 3=待用户保存
|
||
}
|
||
|
||
func (Outfit) TableName() string {
|
||
return "outfits"
|
||
}
|
||
|
||
type OutfitItem struct {
|
||
Model
|
||
OutfitID int64 `gorm:"column:outfit_id"` // 穿搭ID
|
||
ClothesID int64 `gorm:"column:clothes_id"` // 衣物ID
|
||
}
|
||
|
||
func (OutfitItem) TableName() string {
|
||
return "outfit_items"
|
||
}
|
||
|
||
type OutfitAuditLog struct {
|
||
Model
|
||
TargetID int64 `gorm:"column:target_id"` // 穿搭ID
|
||
AuditResult int8 `gorm:"column:audit_result"` // 审核结果 1=通过 2=驳回
|
||
RejectReason string `gorm:"column:reject_reason"` // 审核原因
|
||
AuditTime int64 `gorm:"column:audit_time"` // 审核时间
|
||
}
|
||
|
||
func (OutfitAuditLog) TableName() string {
|
||
return "outfit_audit_logs"
|
||
}
|
||
|
||
// ===== 衣物 =====
|
||
|
||
type Clothes struct {
|
||
Model
|
||
ClothesUUID string `gorm:"column:clothes_uuid"` // 衣物UUID
|
||
UserID int64 `gorm:"column:user_id"` // 所属用户ID
|
||
CategoryMain string `gorm:"column:category_main"` // 衣物大类 上装/下装/连衣裙/外套/鞋/配饰
|
||
CategorySub string `gorm:"column:category_sub"` // 衣物小类 T恤/牛仔裤/运动鞋/发带/戒指等
|
||
Style string `gorm:"column:style"` // 风格
|
||
ColorMain string `gorm:"column:color"` // 主颜色
|
||
ColorSub string `gorm:"column:color_sub"` // 副颜色
|
||
Thickness string `gorm:"column:thickness"` // 厚度
|
||
Version string `gorm:"column:version"` // 版型 宽松/修身/阔腿/紧身/常规合身
|
||
Material string `gorm:"column:material"` // 材质 牛仔布/针织/皮质/纯棉/羊毛等
|
||
Pattern string `gorm:"column:pattern"` // 花纹
|
||
SleeveType string `gorm:"column:sleeve_type"` // 袖型
|
||
ClothesType string `gorm:"column:clothes_type"` // 衣长类型 短款/常规/中长/长款
|
||
NecklineType string `gorm:"column:neckline_type"` // 领型
|
||
Formality string `gorm:"column:formality"` // 正式程度 1-5
|
||
Occasions string `gorm:"column:occasions"` // 适用场合
|
||
VisualImpact string `gorm:"column:visual_impact"` // 视觉冲击力 1-5
|
||
Name string `gorm:"column:name"` // 名称
|
||
Remark string `gorm:"column:remark"` // 备注
|
||
ProcessedImage string `gorm:"column:processed_image"` // 处理后图片存储位置 相对路径
|
||
ImageSize int64 `gorm:"column:image_size"` // 图片大小 单位：kb
|
||
ImageProcessStatus int8 `gorm:"column:image_process_status"` // 处理状态 1=抠图中 2=分类中 3=排队中 4=成功 5=失败
|
||
FailReason string `gorm:"column:fail_reason"` // 失败原因
|
||
}
|
||
|
||
func (Clothes) TableName() string {
|
||
return "clothes"
|
||
}
|
||
|
||
// ===== 衣柜分享 =====
|
||
|
||
type ClosetShare struct {
|
||
Model
|
||
ShareUUID string `gorm:"column:share_uuid"` // 分享UUID
|
||
UserID int64 `gorm:"column:user_id"` // 所属用户ID
|
||
ShareType int8 `gorm:"column:share_type"` // 分享类型 1=部分衣物分享 2=全量快照分享
|
||
ExpireTime int64 `gorm:"column:expire_time"` // 过期时间
|
||
Status int8 `gorm:"column:status"` // 分享状态 1=正常 2=用户取消 3=已过期 4=管理员封禁
|
||
}
|
||
|
||
func (ClosetShare) TableName() string {
|
||
return "closet_shares"
|
||
}
|
||
|
||
// ===== 额度 =====
|
||
|
||
type Quota struct {
|
||
Model
|
||
UserID int64 `gorm:"column:user_id;uniqueIndex:uk_user_quota,priority:1"` // 用户ID
|
||
QuotaType int8 `gorm:"column:quota_type;uniqueIndex:uk_user_quota,priority:2"` // 1=cos 2=AI 3=社区分享 4=衣柜分享
|
||
Total int64 `gorm:"column:total"` // 免费额度底值（仅 Cos 永久额度使用；AI/社区/衣柜 每日额度不再落库）
|
||
Used int64 `gorm:"column:used"` // 免费额度已用（仅 Cos 使用，永久累计）
|
||
}
|
||
|
||
func (Quota) TableName() string {
|
||
return "user_quotas"
|
||
}
|
||
|
||
// QuotaGrant 有有效期额度凭证（会员包/加量包/广告激励）。
|
||
// AI/社区/衣柜 每日额度场景 Amount 表示「有效期内每天额外赠送次数」，Used 恒为 0；
|
||
// Cos 永久额度场景 Amount/Used 表示「一次性赠送库存及其已用」。
|
||
type QuotaGrant struct {
|
||
Model
|
||
UserID int64 `gorm:"column:user_id;index:idx_grant_user_type_expire,priority:1"` // 用户ID
|
||
QuotaType int8 `gorm:"column:quota_type;index:idx_grant_user_type_expire,priority:2;uniqueIndex:uk_grant_ref_type,priority:2"` // 额度类型 1=cos 2=AI 3=社区分享 4=衣柜分享
|
||
Amount int64 `gorm:"column:amount"` // 赠送总量
|
||
Used int64 `gorm:"column:used"` // 已用量（仅 Cos 扣减）
|
||
Source int8 `gorm:"column:source"` // 来源 1=会员包 2=加量包 3=广告激励 4=体验会员赠送
|
||
ExpireTime int64 `gorm:"column:expire_time;index:idx_grant_user_type_expire,priority:3"` // 到期时间（秒，0 表示跟随 VIP）
|
||
RefID string `gorm:"column:ref_id;type:varchar(64);uniqueIndex:uk_grant_ref_type,priority:1"` // 关联ID（订单号/广告记录ID）
|
||
}
|
||
|
||
func (QuotaGrant) TableName() string {
|
||
return "quota_grants"
|
||
}
|
||
|
||
// UserDailyUsage 用户每日使用计数。
|
||
type UserDailyUsage struct {
|
||
Model
|
||
// UserID 用户ID；与 StatDate 组成联合唯一索引，保证每日每用户仅一行。
|
||
UserID int64 `gorm:"column:user_id;uniqueIndex:uk_daily_usage_user_date,priority:1"`
|
||
StatDate int64 `gorm:"column:stat_date;uniqueIndex:uk_daily_usage_user_date,priority:2"` // 统计日期（YYYYMMDD）
|
||
AIRecommendCount int64 `gorm:"column:ai_recommend_count"` // 当日AI推荐次数
|
||
OutfitShareCount int64 `gorm:"column:outfit_share_count"` // 当日社区分享次数
|
||
ClosetShareCount int64 `gorm:"column:closet_share_count"` // 当日衣柜分享次数
|
||
}
|
||
|
||
func (UserDailyUsage) TableName() string {
|
||
return "user_daily_usages"
|
||
}
|
||
|
||
type QuotaFlowLog struct {
|
||
Model
|
||
QuotaFlowUUID string `gorm:"column:quota_flow_uuid"` // 配额流水UUID
|
||
UserID int64 `gorm:"column:user_id"` // 用户ID
|
||
ChangeTarget int8 `gorm:"column:change_target"` // 调整额度类型 1=配额调整 2=使用
|
||
// ChangeType 变更类型 1=购买获赠 2=活动赠送 3=上传消耗 4=删除回退 5=人工调整 6=退款回收 7=到期失效
|
||
ChangeType int8 `gorm:"column:change_type;uniqueIndex:uk_quota_flow_idem,priority:3"`
|
||
ChangeNum int64 `gorm:"column:change_num"` // 变更数量（正数增加，负数减少）
|
||
OldValue int64 `gorm:"column:old_value"` // 变更前数值
|
||
NewValue int64 `gorm:"column:new_value"` // 变更后数值
|
||
// OrderNo 关联订单号（购买/退款类）；人工调整类由 DAO 写入流水 UUID 保证联合唯一索引不冲突。
|
||
OrderNo string `gorm:"column:order_no;uniqueIndex:uk_quota_flow_idem,priority:1"`
|
||
QuotaType int8 `gorm:"column:quota_type;uniqueIndex:uk_quota_flow_idem,priority:2"` // 关联业务类型 1=cos 2=AI 3=社区分享 4=衣柜分享
|
||
RelatedID int64 `gorm:"column:related_id"` // 关联业务ID
|
||
Reason string `gorm:"column:reason"` // 变更原因/备注
|
||
}
|
||
|
||
func (QuotaFlowLog) TableName() string {
|
||
return "quota_flow_logs"
|
||
}
|
||
|
||
// ===== VIP 流水 =====
|
||
|
||
type VIPFlowLog struct {
|
||
Model
|
||
UserID int64 `gorm:"column:user_id"` // 用户ID
|
||
// ChangeType 变更类型 1=开通 2=续费 3=活动赠送 4=到期失效 5=人工调整 6=退款回收
|
||
ChangeType int8 `gorm:"column:change_type;uniqueIndex:uk_vip_flow_idem,priority:2"`
|
||
OldVIPType int8 `gorm:"column:old_vip_type"` // 变更前VIP类型 1=非会员 2=月度会员 3=年度会员 4=体验会员
|
||
NewVIPType int8 `gorm:"column:new_vip_type"` // 变更后VIP类型 1=非会员 2=月度会员 3=年度会员 4=体验会员
|
||
OldVIPExpire int64 `gorm:"column:old_vip_expire"` // 变更前到期时间（秒）
|
||
NewVIPExpire int64 `gorm:"column:new_vip_expire"` // 变更后到期时间（秒）
|
||
// OrderNo 关联订单号（购买类变更）；人工调整类由 DAO 写入流水 UUID 满足联合唯一索引。
|
||
OrderNo string `gorm:"column:order_no;uniqueIndex:uk_vip_flow_idem,priority:1"`
|
||
Source int8 `gorm:"column:source"` // 变更来源 1=个人支付 2=活动赠送 3=系统 4=人工调整
|
||
Reason string `gorm:"column:reason"` // 变更原因/备注
|
||
}
|
||
|
||
func (VIPFlowLog) TableName() string {
|
||
return "vip_flow_logs"
|
||
}
|
||
|
||
// ===== 通知 =====
|
||
|
||
type UserNotification struct {
|
||
Model
|
||
NotificationUUID string `gorm:"column:notification_uuid"` // 消息UUID
|
||
UserID int64 `gorm:"column:user_id"` // 接收用户ID
|
||
MsgType int8 `gorm:"column:msg_type"` // 消息类型 1=点赞通知 2=订单通知 3=系统通知
|
||
SenderID int64 `gorm:"column:sender_id"` // 发送者ID 系统消息为0
|
||
Title string `gorm:"column:title"` // 消息标题
|
||
Content string `gorm:"column:content"` // 消息内容
|
||
IsRead int8 `gorm:"column:is_read"` // 是否已读 1=未读 2=已读
|
||
ReadTime int64 `gorm:"column:read_time"` // 阅读时间
|
||
}
|
||
|
||
func (UserNotification) TableName() string {
|
||
return "user_notifications"
|
||
}
|
||
|
||
// ===== 点赞/收藏 =====
|
||
|
||
type Like struct {
|
||
Model
|
||
// LikeType 业务类型 1=社区穿搭；与 TargetID、UserID 组成联合唯一索引，支撑点赞/取消点赞 upsert。
|
||
LikeType int8 `gorm:"column:like_type;uniqueIndex:uk_like_user_target,priority:1"`
|
||
TargetID int64 `gorm:"column:target_id;uniqueIndex:uk_like_user_target,priority:2"` // 穿搭ID
|
||
UserID int64 `gorm:"column:user_id;uniqueIndex:uk_like_user_target,priority:3"` // 点赞用户ID
|
||
Status int8 `gorm:"column:status"` // 状态 1=已点赞 0=已取消
|
||
}
|
||
|
||
func (Like) TableName() string {
|
||
return "likes"
|
||
}
|
||
|
||
type Collect struct {
|
||
Model
|
||
// CollectType 业务类型 1=社区穿搭；与 TargetID、UserID 组成联合唯一索引，支撑收藏/取消收藏 upsert。
|
||
CollectType int8 `gorm:"column:collect_type;uniqueIndex:uk_collect_user_target,priority:1"`
|
||
TargetID int64 `gorm:"column:target_id;uniqueIndex:uk_collect_user_target,priority:2"` // 业务目标ID
|
||
UserID int64 `gorm:"column:user_id;uniqueIndex:uk_collect_user_target,priority:3"` // 收藏用户ID
|
||
Status int8 `gorm:"column:status"` // 状态 1=已收藏 0=已取消
|
||
}
|
||
|
||
func (Collect) TableName() string {
|
||
return "collects"
|
||
}
|