## 功能概述 在钱包旁边新增公告中心,用户可以查看平台通知、教程、规则和常见问题。 ## 主要变更 ### 后端 - 新增 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>
101 lines
2.1 KiB
Go
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)
|
|
}
|