## 功能概述 在钱包旁边新增公告中心,用户可以查看平台通知、教程、规则和常见问题。 ## 主要变更 ### 后端 - 新增 announcement 模块(handler/service/repository) - 新增 announcements 数据库表 - 添加公告相关 API 端点(用户端和管理端) - 扩展 response 包,新增 NotFound 和 InternalServerError 方法 ### 前端 - 新增公告功能模块(/features/announcement) - 实现公告列表页和详情页 - 在顶部导航添加公告入口(钱包旁边) - 支持按分类筛选(通知、教程、规则、FAQ) - 支持置顶和重要标记显示 ### 数据库 - 迁移文件:000005_add_announcements.sql - 示例数据:000006_insert_sample_announcements.sql - 包含6条示例公告 ## 技术特点 - 遵循项目现有架构模式 - 响应式设计,支持移动端 - 自动统计浏览次数 - 支持富文本内容展示 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
226 lines
4.5 KiB
Go
226 lines
4.5 KiB
Go
package announcement
|
|
|
|
import (
|
|
"errors"
|
|
"strconv"
|
|
|
|
"hfb_sys/backend/internal/middleware"
|
|
"hfb_sys/backend/pkg/response"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
type Handler struct {
|
|
service *Service
|
|
}
|
|
|
|
func NewHandler(service *Service) *Handler {
|
|
return &Handler{service: service}
|
|
}
|
|
|
|
// List 获取公告列表(前台用户)
|
|
func (h *Handler) List(c *gin.Context) {
|
|
query := AnnouncementListQuery{
|
|
Category: c.Query("category"),
|
|
Status: "published",
|
|
}
|
|
query.Page, query.PageSize = parsePagination(c)
|
|
|
|
result, err := h.service.List(query)
|
|
if err != nil {
|
|
response.InternalServerError(c, "获取公告列表失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, result)
|
|
}
|
|
|
|
// GetByID 获取公告详情
|
|
func (h *Handler) GetByID(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
announcement, err := h.service.GetByID(id)
|
|
if err != nil {
|
|
if errors.Is(err, ErrNotFound) {
|
|
response.NotFound(c, "公告不存在")
|
|
return
|
|
}
|
|
response.InternalServerError(c, "获取公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, announcement)
|
|
}
|
|
|
|
// AdminList 管理员获取公告列表
|
|
func (h *Handler) AdminList(c *gin.Context) {
|
|
query := AnnouncementListQuery{
|
|
Category: c.Query("category"),
|
|
Status: c.Query("status"),
|
|
}
|
|
query.Page, query.PageSize = parsePagination(c)
|
|
|
|
result, err := h.service.AdminList(query)
|
|
if err != nil {
|
|
response.InternalServerError(c, "获取公告列表失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, result)
|
|
}
|
|
|
|
// AdminGetByID 管理员获取公告详情
|
|
func (h *Handler) AdminGetByID(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
announcement, err := h.service.AdminGetByID(id)
|
|
if err != nil {
|
|
if errors.Is(err, gorm.ErrRecordNotFound) {
|
|
response.NotFound(c, "公告不存在")
|
|
return
|
|
}
|
|
response.InternalServerError(c, "获取公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, announcement)
|
|
}
|
|
|
|
// Create 创建公告
|
|
func (h *Handler) Create(c *gin.Context) {
|
|
adminID, ok := currentAdminID(c)
|
|
if !ok {
|
|
response.Unauthorized(c, "未授权")
|
|
return
|
|
}
|
|
|
|
var req CreateAnnouncementRequest
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
response.BadRequest(c, "请求参数不正确")
|
|
return
|
|
}
|
|
|
|
announcement, err := h.service.Create(req, adminID)
|
|
if err != nil {
|
|
response.InternalServerError(c, "创建公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, announcement)
|
|
}
|
|
|
|
// Update 更新公告
|
|
func (h *Handler) Update(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
var req UpdateAnnouncementRequest
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
response.BadRequest(c, "请求参数不正确")
|
|
return
|
|
}
|
|
|
|
announcement, err := h.service.Update(id, req)
|
|
if err != nil {
|
|
response.InternalServerError(c, "更新公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, announcement)
|
|
}
|
|
|
|
// Publish 发布公告
|
|
func (h *Handler) Publish(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
if err := h.service.Publish(id); err != nil {
|
|
response.InternalServerError(c, "发布公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, gin.H{"message": "发布成功"})
|
|
}
|
|
|
|
// Archive 归档公告
|
|
func (h *Handler) Archive(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
if err := h.service.Archive(id); err != nil {
|
|
response.InternalServerError(c, "归档公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, gin.H{"message": "归档成功"})
|
|
}
|
|
|
|
// Delete 删除公告
|
|
func (h *Handler) Delete(c *gin.Context) {
|
|
id, err := parseID(c)
|
|
if err != nil {
|
|
response.BadRequest(c, "公告ID不正确")
|
|
return
|
|
}
|
|
|
|
if err := h.service.Delete(id); err != nil {
|
|
response.InternalServerError(c, "删除公告失败")
|
|
return
|
|
}
|
|
|
|
response.OK(c, gin.H{"message": "删除成功"})
|
|
}
|
|
|
|
// 工具函数
|
|
|
|
func parseID(c *gin.Context) (uint64, error) {
|
|
idStr := c.Param("id")
|
|
id, err := strconv.ParseUint(idStr, 10, 64)
|
|
if err != nil || id == 0 {
|
|
return 0, errors.New("无效的ID")
|
|
}
|
|
return id, nil
|
|
}
|
|
|
|
func parsePagination(c *gin.Context) (int, int) {
|
|
page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
|
|
pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20"))
|
|
if page < 1 {
|
|
page = 1
|
|
}
|
|
if pageSize < 1 {
|
|
pageSize = 20
|
|
}
|
|
if pageSize > 100 {
|
|
pageSize = 100
|
|
}
|
|
return page, pageSize
|
|
}
|
|
|
|
func currentAdminID(c *gin.Context) (uint64, bool) {
|
|
value, ok := c.Get(middleware.ContextAdminID)
|
|
if !ok {
|
|
return 0, false
|
|
}
|
|
adminID, ok := value.(uint64)
|
|
return adminID, ok
|
|
}
|