Files
hfb_sys/backend/internal/modules/announcement/handler.go
T
ymlandClaude Opus 4.6 28b6e326e8 新增公告中心功能
## 功能概述
在钱包旁边新增公告中心,用户可以查看平台通知、教程、规则和常见问题。

## 主要变更

### 后端
- 新增 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>
2026-06-05 20:40:20 +08:00

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
}