数据源:百度百科开放接口 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 全部填充,维基数据不受影响
202 lines
5.6 KiB
Go
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": "节气同步任务已启动"})
|
|
}
|