Files
hfb_sys/backend/internal/modules/announcement/service.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

101 lines
2.1 KiB
Go

package announcement
import (
"errors"
"gorm.io/gorm"
)
type Service struct {
repo *Repository
}
func NewService(repo *Repository) *Service {
return &Service{repo: repo}
}
var (
ErrNotFound = errors.New("公告不存在")
ErrInvalidRequest = errors.New("请求参数不正确")
ErrUnauthorized = errors.New("未授权")
)
// List 获取公告列表(前台用户)
func (s *Service) List(query AnnouncementListQuery) (*PaginatedResult, error) {
if query.Page < 1 {
query.Page = 1
}
if query.PageSize < 1 {
query.PageSize = 20
}
if query.PageSize > 100 {
query.PageSize = 100
}
return s.repo.List(query)
}
// GetByID 获取公告详情
func (s *Service) GetByID(id uint64) (*AnnouncementDTO, error) {
dto, err := s.repo.GetByID(id)
if err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, ErrNotFound
}
return nil, err
}
return dto, nil
}
// AdminList 管理员获取公告列表
func (s *Service) AdminList(query AnnouncementListQuery) (*PaginatedResult, error) {
if query.Page < 1 {
query.Page = 1
}
if query.PageSize < 1 {
query.PageSize = 20
}
if query.PageSize > 100 {
query.PageSize = 100
}
return s.repo.AdminList(query)
}
// AdminGetByID 管理员获取公告详情
func (s *Service) AdminGetByID(id uint64) (*AnnouncementDTO, error) {
dto, err := s.repo.AdminGetByID(id)
if err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, ErrNotFound
}
return nil, err
}
return dto, nil
}
// Create 创建公告
func (s *Service) Create(req CreateAnnouncementRequest, createdBy uint64) (*AnnouncementDTO, error) {
return s.repo.Create(req, createdBy)
}
// Update 更新公告
func (s *Service) Update(id uint64, req UpdateAnnouncementRequest) (*AnnouncementDTO, error) {
return s.repo.Update(id, req)
}
// Publish 发布公告
func (s *Service) Publish(id uint64) error {
return s.repo.Publish(id)
}
// Archive 归档公告
func (s *Service) Archive(id uint64) error {
return s.repo.Archive(id)
}
// Delete 删除公告
func (s *Service) Delete(id uint64) error {
return s.repo.Delete(id)
}