新增公告中心功能

## 功能概述
在钱包旁边新增公告中心，用户可以查看平台通知、教程、规则和常见问题。

## 主要变更

### 后端
- 新增 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>

backend/internal/modules/announcement/handler.go

@@ -0,0 +1,225 @@
+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
+}