feat: 实现内容系统 MVC（Post CRUD + 审核流转）
按 content-system.md 设计文档，实现帖子内容系统的最小可行 MVC。 新增： - Model: Post 模型，含 5 种状态（draft/pending/approved/rejected/locked） - Repository: post_repo.go，分页查询（前台 approved 列表 + 后台全状态筛选） - Service: post_service.go，核心业务逻辑（状态流转、Markdown 渲染 Goldmark） - Controller: post_controller + admin_post_controller，SSR 页面 6 个 + API 13 个 - Template: 列表/详情/编辑器/404 + 管理员列表，各配 CSS/JS - 路由: /posts, /posts/:id, /posts/new, /posts/:id/edit, REST API, Admin API - gomod: + github.com/yuin/goldmark v1.8.2 修改： - Main: AutoMigrate Post 表 - Router: deps 注册 PostService/Controller，路由注册 - Nav: 新增“帖子”导航链接 - Admin Sidebar: 新增“内容管理”入口 设计： - 审核开关复用 audit.enabled，开启时帖子为 draft，关闭后直接 approved - 仅 approved 公开可见，作者/admin 可预览非公开状态帖子 - 严格分层 ISP 接口: Controller → postUseCase, Service → postStore, Repo → *PostRepo - 状态保护: pending/locked 禁止编辑，rejected 编辑后自动重置为 draft
This commit is contained in:
212
internal/service/post_service.go
Normal file
212
internal/service/post_service.go
Normal file
@ -0,0 +1,212 @@
|
||||
package service
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"fmt"
|
||||
|
||||
"metazone.cc/metalab/internal/common"
|
||||
"metazone.cc/metalab/internal/config"
|
||||
"metazone.cc/metalab/internal/model"
|
||||
|
||||
"github.com/yuin/goldmark"
|
||||
)
|
||||
|
||||
// postStore 帖子服务所需的最小仓储接口（ISP）
|
||||
type postStore interface {
|
||||
Create(post *model.Post) error
|
||||
FindByID(id uint) (*model.Post, error)
|
||||
FindByIDWithAuthor(id uint) (*model.Post, error)
|
||||
FindPageable(keyword string, offset, limit int) ([]model.Post, int64, error)
|
||||
FindAdminPageable(keyword, status string, offset, limit int) ([]model.Post, int64, error)
|
||||
Update(post *model.Post) error
|
||||
SoftDelete(id uint) error
|
||||
Restore(id uint) error
|
||||
}
|
||||
|
||||
// PostService 帖子业务逻辑
|
||||
type PostService struct {
|
||||
repo postStore
|
||||
ss *config.SiteSettings
|
||||
md goldmark.Markdown
|
||||
}
|
||||
|
||||
// NewPostService 构造函数
|
||||
func NewPostService(repo postStore, ss *config.SiteSettings) *PostService {
|
||||
return &PostService{
|
||||
repo: repo,
|
||||
ss: ss,
|
||||
md: goldmark.New(),
|
||||
}
|
||||
}
|
||||
|
||||
// auditEnabled 审核是否开启（文案审核与全局审核开关一致）
|
||||
func (s *PostService) auditEnabled() bool {
|
||||
return s.ss.IsAuditEnabled()
|
||||
}
|
||||
|
||||
// renderMarkdown 将 Markdown 渲染为 HTML
|
||||
func (s *PostService) renderMarkdown(body string) (string, error) {
|
||||
var buf bytes.Buffer
|
||||
if err := s.md.Convert([]byte(body), &buf); err != nil {
|
||||
return "", err
|
||||
}
|
||||
return buf.String(), nil
|
||||
}
|
||||
|
||||
// Create 创建帖子
|
||||
func (s *PostService) Create(userID uint, title, body string) (*model.Post, error) {
|
||||
bodyHTML, err := s.renderMarkdown(body)
|
||||
if err != nil {
|
||||
bodyHTML = body // 渲染失败降级使用纯文本
|
||||
}
|
||||
|
||||
status := model.PostStatusApproved
|
||||
if s.auditEnabled() {
|
||||
status = model.PostStatusDraft
|
||||
}
|
||||
|
||||
post := &model.Post{
|
||||
Title: title,
|
||||
Body: body,
|
||||
BodyHTML: bodyHTML,
|
||||
UserID: userID,
|
||||
Status: status,
|
||||
AllowComment: true,
|
||||
}
|
||||
if err := s.repo.Create(post); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return post, nil
|
||||
}
|
||||
|
||||
// GetByID 按 ID 获取帖子（含作者名，仅 approved 公开可见）
|
||||
func (s *PostService) GetByID(id uint) (*model.Post, error) {
|
||||
post, err := s.repo.FindByIDWithAuthor(id)
|
||||
if err != nil {
|
||||
return nil, common.ErrUserNotFound // 复用哨兵表示资源不存在
|
||||
}
|
||||
return post, nil
|
||||
}
|
||||
|
||||
// List 公开帖子列表（仅 approved）
|
||||
func (s *PostService) List(keyword string, page, pageSize int) ([]model.Post, int64, error) {
|
||||
p := common.Pagination{Page: page, PageSize: pageSize}
|
||||
p.DefaultPagination()
|
||||
return s.repo.FindPageable(keyword, p.Offset(), p.PageSize)
|
||||
}
|
||||
|
||||
// ListAdmin 管理后台帖子列表（全状态）
|
||||
func (s *PostService) ListAdmin(keyword, status string, page, pageSize int) ([]model.Post, int64, error) {
|
||||
p := common.Pagination{Page: page, PageSize: pageSize}
|
||||
p.DefaultPagination()
|
||||
return s.repo.FindAdminPageable(keyword, status, p.Offset(), p.PageSize)
|
||||
}
|
||||
|
||||
// Update 编辑帖子（权限在 controller 层检查）
|
||||
func (s *PostService) Update(postID uint, title, body string) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
|
||||
// pending / locked 禁止编辑
|
||||
if post.Status == model.PostStatusPending || post.Status == model.PostStatusLocked {
|
||||
return fmt.Errorf("当前状态不允许编辑")
|
||||
}
|
||||
|
||||
post.Title = title
|
||||
post.Body = body
|
||||
|
||||
bodyHTML, err := s.renderMarkdown(body)
|
||||
if err != nil {
|
||||
bodyHTML = body
|
||||
}
|
||||
post.BodyHTML = bodyHTML
|
||||
|
||||
// rejected 状态编辑后自动重置为 draft
|
||||
if post.Status == model.PostStatusRejected {
|
||||
post.Status = model.PostStatusDraft
|
||||
post.RejectReason = ""
|
||||
}
|
||||
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Delete 软删除（权限在 controller 层检查）
|
||||
func (s *PostService) Delete(postID uint) error {
|
||||
return s.repo.SoftDelete(postID)
|
||||
}
|
||||
|
||||
// SubmitForAudit 提交审核：draft → pending
|
||||
func (s *PostService) SubmitForAudit(postID uint) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
if post.Status != model.PostStatusDraft && post.Status != model.PostStatusRejected {
|
||||
return fmt.Errorf("仅草稿和已退回帖子可提交审核")
|
||||
}
|
||||
post.Status = model.PostStatusPending
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Approve 审核通过：pending → approved
|
||||
func (s *PostService) Approve(postID uint) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
if post.Status != model.PostStatusPending {
|
||||
return fmt.Errorf("仅待审核帖子可通过")
|
||||
}
|
||||
post.Status = model.PostStatusApproved
|
||||
post.RejectReason = ""
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Reject 退回：pending/approved → rejected
|
||||
func (s *PostService) Reject(postID uint, reason string) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
if post.Status != model.PostStatusPending && post.Status != model.PostStatusApproved {
|
||||
return fmt.Errorf("仅待审核和已发布帖子可退回")
|
||||
}
|
||||
post.Status = model.PostStatusRejected
|
||||
post.RejectReason = reason
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Lock 锁定：任意状态 → locked
|
||||
func (s *PostService) Lock(postID uint) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
post.Status = model.PostStatusLocked
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Unlock 解锁：locked → 草稿
|
||||
func (s *PostService) Unlock(postID uint) error {
|
||||
post, err := s.repo.FindByID(postID)
|
||||
if err != nil {
|
||||
return common.ErrUserNotFound
|
||||
}
|
||||
if post.Status != model.PostStatusLocked {
|
||||
return fmt.Errorf("仅锁定状态可解锁")
|
||||
}
|
||||
post.Status = model.PostStatusDraft
|
||||
return s.repo.Update(post)
|
||||
}
|
||||
|
||||
// Restore 恢复软删除
|
||||
func (s *PostService) Restore(postID uint) error {
|
||||
return s.repo.Restore(postID)
|
||||
}
|
||||
|
||||
// RenderMarkdown 公开的 Markdown 渲染（供预览 API 使用，不写 DB）
|
||||
func (s *PostService) RenderMarkdown(body string) (string, error) {
|
||||
return s.renderMarkdown(body)
|
||||
}
|
||||
Reference in New Issue
Block a user