Files
lunar-mini/server/internal/handler/wiki.go
T
gouki fec383f257
Publish Mini Program Dev Version / publish (push) Successful in 1m12s
Build and Publish Server / build (push) Successful in 8m24s
feat(wiki): 二十四节气详情抓取百度百科并图文展示
数据源:百度百科开放接口 BaikeLemmaCardApi(无反爬,返回结构化 JSON)
与「历史上的今天」(维基)完全解耦,维基代码原样保留可随时恢复:

服务端:
- WikiEntry 增加 image(配图)和 extra(结构化字段 JSON)字段
- 新建 BaikeTermSyncLog 独立日志表(不污染维基 WikiSyncLog)
- 新建 BaikeTermSyncService 独立同步服务(24 节气,间隔 1.2s)
- 启动时缺详情自动补齐,之后按配置间隔定时增量刷新
- 管理 API:GET/POST /admin/api/wiki/term-sync*

管理后台:
- 百科条目 Tab 顶部加节气同步卡片(X/24 + 状态 + 同步按钮)
- 条目编辑器加配图 URL(含预览)和节气扩展字段编辑

小程序:
- 百科页展开详情图文展示:配图 + 简介 + 物候/习俗/养生等分块

本地验证:24/24 节气抓取成功,image/extra 全部填充,维基数据不受影响
2026-08-13 00:31:43 +00:00

202 lines
5.6 KiB
Go

package handler
import (
"net/http"
"strconv"
"github.com/gin-gonic/gin"
"github.com/gouki/lunar-server/internal/config"
"github.com/gouki/lunar-server/internal/model"
"github.com/gouki/lunar-server/internal/service"
)
// WikiSync 维基百科同步服务实例(main 中注入)
var WikiSync *service.WikiSyncService
// BaikeTermSync 节气详情同步服务实例(main 中注入,独立于维基同步)
var BaikeTermSync *service.BaikeTermSyncService
// ===== 公开接口(小程序) =====
// GetWikiEntries 百科条目列表(小程序百科页)
func GetWikiEntries(c *gin.Context) {
wikiService := service.NewWikiService()
entries, err := wikiService.ListEntries(c.Query("category"), c.Query("keyword"), 1)
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{
"code": 500,
"msg": "获取百科条目失败",
})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": gin.H{
"list": entries,
},
})
}
// GetOnThisDay 历史上的今天(含大事记/出生/逝世/节假日)
func GetOnThisDay(c *gin.Context) {
month, _ := strconv.Atoi(c.Query("month"))
day, _ := strconv.Atoi(c.Query("day"))
wikiService := service.NewWikiService()
result, err := wikiService.GetOnThisDay(month, day)
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{
"code": 400,
"msg": err.Error(),
})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": result,
})
}
// ===== 管理后台接口 =====
// AdminWikiEntries 百科条目列表(含隐藏条目)
func AdminWikiEntries(c *gin.Context) {
wikiService := service.NewWikiService()
entries, err := wikiService.ListEntries(c.Query("category"), c.Query("keyword"), -1)
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 500, "msg": "获取百科条目失败"})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": gin.H{"list": entries},
})
}
// AdminWikiEntryCreate 新增百科条目
func AdminWikiEntryCreate(c *gin.Context) {
var entry model.WikiEntry
if err := c.ShouldBindJSON(&entry); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "msg": "参数错误"})
return
}
wikiService := service.NewWikiService()
if err := wikiService.CreateEntry(&entry); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "msg": err.Error()})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": entry,
})
}
// AdminWikiEntryUpdate 更新百科条目
func AdminWikiEntryUpdate(c *gin.Context) {
id, err := strconv.ParseUint(c.Param("id"), 10, 64)
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "msg": "无效的ID"})
return
}
var entry model.WikiEntry
if err := c.ShouldBindJSON(&entry); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "msg": "参数错误"})
return
}
wikiService := service.NewWikiService()
if err := wikiService.UpdateEntry(uint(id), &entry); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 500, "msg": "更新失败"})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "success"})
}
// AdminWikiEntryDelete 删除百科条目
func AdminWikiEntryDelete(c *gin.Context) {
id, err := strconv.ParseUint(c.Param("id"), 10, 64)
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "msg": "无效的ID"})
return
}
wikiService := service.NewWikiService()
if err := wikiService.DeleteEntry(uint(id)); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 500, "msg": "删除失败"})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "success"})
}
// AdminWikiSyncStatus 维基百科同步状态
func AdminWikiSyncStatus(c *gin.Context) {
wikiService := service.NewWikiService()
status, err := wikiService.GetSyncStatus(WikiSync != nil && WikiSync.IsRunning())
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 500, "msg": "获取同步状态失败"})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": status,
})
}
// AdminWikiSyncTrigger 手动触发全量同步(异步执行)
func AdminWikiSyncTrigger(c *gin.Context) {
if WikiSync == nil {
c.JSON(http.StatusServiceUnavailable, gin.H{"code": 503, "msg": "同步服务未初始化"})
return
}
if !WikiSync.TriggerSync("admin", true) {
c.JSON(http.StatusConflict, gin.H{"code": 409, "msg": "已有同步任务正在执行,请稍后再试"})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "同步任务已启动"})
}
// ===== 节气详情同步(百度百科,独立于维基) =====
// AdminTermSyncStatus 节气详情同步状态(X/24 已含详情 + 最近一次同步日志)
func AdminTermSyncStatus(c *gin.Context) {
db := config.GetDB()
var detailed int64
db.Model(&model.WikiEntry{}).Where("category = ? AND image != ''", "term").Count(&detailed)
var lastLog model.BaikeTermSyncLog
db.Order("started_at DESC").First(&lastLog)
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": gin.H{
"running": BaikeTermSync != nil && BaikeTermSync.IsRunning(),
"detailedTerms": detailed,
"totalTerms": 24,
"lastSync": lastLog,
},
})
}
// AdminTermSyncTrigger 手动触发节气详情同步(异步执行)
func AdminTermSyncTrigger(c *gin.Context) {
if BaikeTermSync == nil {
c.JSON(http.StatusServiceUnavailable, gin.H{"code": 503, "msg": "节气同步服务未初始化"})
return
}
if !BaikeTermSync.TriggerSync("admin", true) {
c.JSON(http.StatusConflict, gin.H{"code": 409, "msg": "已有节气同步任务正在执行,请稍后再试"})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "节气同步任务已启动"})
}