Files
yml2213 4a9e5f9d66 feat(announcement): 新增首页弹窗公告功能并完成弹窗UI视觉重构
- 数据库与后端:announcements 表增加 is_popup 字段及迁移脚本,提供前台弹窗接口与多公告优先级选取,补全选优单测
- 管理后台:总后台与分销后台公告编辑新增「弹窗公告」开关与列表标签展示
- 前台交互:前台 PC/移动端首页引入 AnnouncementPopup,支持同一用户同一天同一公告仅弹一次的关闭记录
- 视觉优化:重构弹窗结构,顶栏镶嵌品牌橙流光细条与浅暖橙通知徽标,中间内嵌浅灰舒适阅读卡片,底部搭配大锤橙实心主操作按钮
- 验证方式:后端 announcement 单测通过,前端 npm run build 编译无报错,浏览器实机截图验证
2026-10-12 18:33:44 +08:00

63 lines
2.4 KiB
Go

package announcement
import "time"
type AnnouncementDTO struct {
ID uint64 `json:"id"`
DistributionSiteID uint64 `json:"distribution_site_id"`
DistributionSiteName string `json:"distribution_site_name,omitempty"`
Title string `json:"title"`
Content string `json:"content"`
Category string `json:"category"`
Priority int `json:"priority"`
IsPinned bool `json:"is_pinned"`
IsImportant bool `json:"is_important"`
IsPopup bool `json:"is_popup"`
ViewCount int `json:"view_count"`
Status string `json:"status"`
PublishedAt *time.Time `json:"published_at"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
type AnnouncementListQuery struct {
Category string
Status string
Page int
PageSize int
// AllowedSiteIDs 前台可见范围:主站=[0];分站 inherit=[0, siteID];分站 own_only=[siteID]。
AllowedSiteIDs []uint64
// AdminSiteID 管理端按站点筛选:nil=全部,0=仅主站,>0=指定分站。
AdminSiteID *uint64
}
type PaginatedResult struct {
Items interface{} `json:"items"`
Total int64 `json:"total"`
Page int `json:"page"`
PageSize int `json:"page_size"`
}
type CreateAnnouncementRequest struct {
// DistributionSiteID 归属站点,0=主站(平台后台可指定分站代发)。
DistributionSiteID uint64 `json:"distribution_site_id"`
Title string `json:"title" binding:"required,max=255"`
Content string `json:"content" binding:"required"`
Category string `json:"category" binding:"required,oneof=notice tutorial rule faq"`
Priority int `json:"priority"`
IsPinned bool `json:"is_pinned"`
IsImportant bool `json:"is_important"`
// IsPopup 弹窗公告:前台首页弹出且需用户手动关闭,同一天只弹一次。
IsPopup bool `json:"is_popup"`
}
type UpdateAnnouncementRequest struct {
Title string `json:"title" binding:"max=255"`
Content string `json:"content"`
Category string `json:"category" binding:"omitempty,oneof=notice tutorial rule faq"`
Priority int `json:"priority"`
IsPinned bool `json:"is_pinned"`
IsImportant bool `json:"is_important"`
IsPopup bool `json:"is_popup"`
}