348 lines
16 KiB
Go
348 lines
16 KiB
Go
package router
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
"net/http"
|
||
"os"
|
||
"path/filepath"
|
||
|
||
"git.iioio.com/freefire/jiang13-forum/config"
|
||
"git.iioio.com/freefire/jiang13-forum/embed_static"
|
||
"git.iioio.com/freefire/jiang13-forum/handler"
|
||
"git.iioio.com/freefire/jiang13-forum/middleware"
|
||
"git.iioio.com/freefire/jiang13-forum/service"
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
func Setup(cfg *config.Config) (*gin.Engine, error) {
|
||
gin.SetMode(gin.ReleaseMode)
|
||
r := gin.New()
|
||
r.Use(gin.Recovery())
|
||
r.Use(gin.Logger())
|
||
|
||
filter := service.NewSensitiveFilter()
|
||
_ = service.WriteDefaultFilterWords(cfg.FilterWordsPath())
|
||
filter.LoadFromFile(cfg.FilterWordsPath())
|
||
|
||
settingsSvc := service.NewForumSettingsService()
|
||
settingsSvc.SetCommunityHubEnabled(cfg.CommunityHub)
|
||
monitorSvc := service.NewMonitorService(settingsSvc, cfg.DataDir, cfg.JWTSecret)
|
||
monitorSvc.StartBackground()
|
||
r.Use(middleware.AccessLogMiddleware(monitorSvc))
|
||
|
||
// dev 模式：跳过内嵌静态资源，前端由 Vite 开发服务器(:5173)提供
|
||
// 用户应访问 5173 端口，Vite 通过 proxy 将 /api 等请求转发到本服务(:3000)
|
||
if !cfg.DevMode {
|
||
if err := embed_static.SetupEmbed(r); err != nil {
|
||
return nil, err
|
||
}
|
||
} else {
|
||
fmt.Fprintf(os.Stderr, "[dev] 后端仅提供 API，前端请访问 http://localhost:5173\n")
|
||
}
|
||
|
||
communitySvc := service.NewCommunityService(settingsSvc)
|
||
communitySvc.StartBackground()
|
||
if cfg.CommunityHub {
|
||
fmt.Fprintf(os.Stderr, "[community] 社区枢纽已开启（运维配置），可接收自愿上报\n")
|
||
}
|
||
// SPA 入口 HTML 注入标题与品牌 JSON，避免刷新时先闪默认文案
|
||
embed_static.SetSPADocumentTitle(func() string {
|
||
return settingsSvc.SiteBranding().DocumentTitle()
|
||
})
|
||
embed_static.SetSPABrandingJSON(func() []byte {
|
||
b, err := json.Marshal(settingsSvc.SiteBranding())
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
return b
|
||
})
|
||
embed_static.SetSPAFaviconURL(func() string {
|
||
return settingsSvc.SiteBranding().Favicon
|
||
})
|
||
authSvc := service.NewAuthService(cfg.JWTSecret, filter, settingsSvc)
|
||
userSvc := service.NewUserService(filter, settingsSvc)
|
||
boardSvc := service.NewBoardService()
|
||
boardSvc.EnsureDefaultBoard()
|
||
postSvc := service.NewPostService(filter, settingsSvc)
|
||
commentSvc := service.NewCommentService(filter, settingsSvc)
|
||
messageSvc := service.NewMessageService(filter, settingsSvc)
|
||
reportSvc := service.NewReportService(filter, settingsSvc, messageSvc, postSvc, commentSvc)
|
||
backupSvc := service.NewBackupService(cfg.DBPath(), cfg.DataDir)
|
||
limiter := service.NewRateLimiter(settingsSvc)
|
||
captchaSvc := service.NewCaptchaService()
|
||
mailSvc := service.NewMailService(settingsSvc)
|
||
emailCodeSvc := service.NewEmailCodeService(mailSvc)
|
||
notifySvc := service.NewNotifyService(messageSvc, mailSvc, settingsSvc)
|
||
friendLinkApplySvc := service.NewFriendLinkApplyService(settingsSvc, messageSvc)
|
||
oidcSvc, err := service.NewOIDCService(cfg, settingsSvc)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
giteaSvc := service.NewGiteaService(settingsSvc)
|
||
giteaSvc.StartBackgroundSync()
|
||
|
||
uploadStore := service.NewUploadStore(cfg.DataDir, settingsSvc)
|
||
if err := uploadStore.ReloadFromSettings(settingsSvc); err != nil {
|
||
// 配置不完整时保持本地磁盘，避免进程无法启动；管理员可在后台修正后热切换
|
||
fmt.Fprintf(os.Stderr, "警告: 对象存储初始化失败，暂用本地磁盘: %v\n", err)
|
||
_ = uploadStore.Apply(service.StorageConfig{Type: "local"})
|
||
}
|
||
// 后台同步存量文件到媒体索引，避免列表依赖实时扫盘
|
||
go func() {
|
||
if n, err := uploadStore.SyncMediaIndex(); err != nil {
|
||
fmt.Fprintf(os.Stderr, "警告: 媒体索引同步失败: %v\n", err)
|
||
} else if n > 0 {
|
||
fmt.Fprintf(os.Stderr, "媒体索引已同步 %d 条\n", n)
|
||
}
|
||
}()
|
||
|
||
h := &handler.Handlers{
|
||
Cfg: cfg, Store: uploadStore, Auth: authSvc, User: userSvc, Board: boardSvc,
|
||
Post: postSvc, Comment: commentSvc, Message: messageSvc, Notify: notifySvc, Report: reportSvc,
|
||
Backup: backupSvc, Community: communitySvc, Monitor: monitorSvc,
|
||
Filter: filter, Limiter: limiter, Settings: settingsSvc,
|
||
Captcha: captchaSvc, Mail: mailSvc, EmailCode: emailCodeSvc,
|
||
OIDC: oidcSvc, Gitea: giteaSvc,
|
||
Points: service.NewPointsService(), Badge: service.NewBadgeService(),
|
||
SitePage: service.NewSitePageService(filter),
|
||
FriendLinkApply: friendLinkApplySvc,
|
||
}
|
||
authMW := middleware.NewAuthMiddleware(authSvc)
|
||
|
||
// 缩略图使用独立前缀，避免与 Static("/uploads/*filepath") 路由冲突
|
||
r.GET("/media/thumb/*filepath", h.ServeImageThumb)
|
||
r.Static("/uploads", filepath.Join(cfg.DataDir, "uploads"))
|
||
|
||
// 健康检查（容器 / 负载均衡探活）
|
||
r.GET("/health", h.APIHealth)
|
||
|
||
// SEO：抓取规则、站点地图、约定 favicon
|
||
r.GET("/robots.txt", h.RobotsTxt)
|
||
r.GET("/sitemap.xml", h.SitemapXML)
|
||
r.GET("/favicon.ico", h.FaviconICO)
|
||
|
||
// OIDC Provider（Gitea 等外部站点 SSO）
|
||
r.GET("/.well-known/openid-configuration", h.OIDCDiscovery)
|
||
r.GET("/oauth/jwks", h.OIDCJWKS)
|
||
r.GET("/oauth/authorize", authMW.OptionalAuth(), h.OIDCAuthorize)
|
||
r.POST("/oauth/token", h.OIDCToken)
|
||
r.GET("/oauth/userinfo", h.OIDCUserInfo)
|
||
r.POST("/oauth/userinfo", h.OIDCUserInfo)
|
||
r.GET("/oauth/logout", h.OIDCLogout)
|
||
r.POST("/oauth/logout", h.OIDCLogout)
|
||
|
||
// 公开 JSON API（可选登录）
|
||
pubAPI := r.Group("/api", authMW.OptionalAuth())
|
||
{
|
||
pubAPI.GET("/me", h.APIMe)
|
||
pubAPI.GET("/boards", h.APIBoards)
|
||
pubAPI.GET("/stats", h.APIStats)
|
||
pubAPI.POST("/community/heartbeat", middleware.RateLimitMiddleware(limiter, "community_heartbeat"), h.APICommunityHeartbeat)
|
||
pubAPI.GET("/community/showcase", h.APICommunityShowcase)
|
||
pubAPI.POST("/monitor/pageview", middleware.RateLimitMiddleware(limiter, "monitor_pageview"), h.APIMonitorPageview)
|
||
pubAPI.GET("/forum-limits", h.APIForumLimits)
|
||
pubAPI.GET("/site-branding", h.APISiteBranding)
|
||
pubAPI.GET("/pages", h.APIPages)
|
||
pubAPI.GET("/pages/:slug", h.APIPageDetail)
|
||
pubAPI.GET("/captcha", h.APICaptcha)
|
||
pubAPI.GET("/register/config", h.APIRegisterConfig)
|
||
pubAPI.POST("/register/email-code", middleware.RateLimitMiddleware(limiter, "register"), h.APISendRegisterEmailCode)
|
||
pubAPI.POST("/password-reset/email-code", middleware.RateLimitMiddleware(limiter, "register"), h.APISendResetEmailCode)
|
||
pubAPI.POST("/password-reset", middleware.RateLimitMiddleware(limiter, "login"), h.APIResetPassword)
|
||
pubAPI.GET("/posts", h.APIPosts)
|
||
pubAPI.GET("/posts/hot", h.APIHotPosts)
|
||
pubAPI.GET("/tags", h.APITags)
|
||
pubAPI.GET("/comments/recent", h.APIRecentComments)
|
||
// search / recent 须在 :id 之前
|
||
pubAPI.GET("/users/search", h.APISearchUsers)
|
||
pubAPI.GET("/users/recent", h.APIRecentUsers)
|
||
pubAPI.GET("/users/:id", h.APIUserPublic)
|
||
pubAPI.GET("/posts/:id", h.APIPostDetail)
|
||
pubAPI.GET("/posts/:id/comments", h.APIPostComments)
|
||
pubAPI.POST("/posts/:id/comments", middleware.RateLimitMiddleware(limiter, "comment"), h.APICreateComment)
|
||
pubAPI.GET("/projects", h.APIProjects)
|
||
pubAPI.POST("/register", middleware.RateLimitMiddleware(limiter, "register"), h.APIRegister)
|
||
pubAPI.POST("/login", middleware.RateLimitMiddleware(limiter, "login"), h.APILogin)
|
||
}
|
||
|
||
// 需登录 API
|
||
api := r.Group("/api", authMW.RequireAuth())
|
||
{
|
||
api.POST("/logout", h.APILogout)
|
||
api.GET("/favorites", h.APIFavorites)
|
||
api.GET("/profile/stats", h.APIProfileStats)
|
||
api.POST("/profile/nickname", h.APIUpdateProfile)
|
||
api.POST("/profile/signature", h.APIUpdateSignature)
|
||
api.POST("/profile/password", h.APIUpdatePassword)
|
||
api.POST("/profile/avatar", h.APIUploadAvatar)
|
||
api.POST("/uploads/image", h.APIUploadPostImage)
|
||
api.GET("/uploads/images", h.APIMyPostImages)
|
||
api.POST("/posts", middleware.RateLimitMiddleware(limiter, "post"), h.APICreatePost)
|
||
api.PUT("/posts/:id", h.APIUpdatePost)
|
||
api.DELETE("/posts/:id", h.APIDeletePost)
|
||
api.GET("/posts/:id/revisions", h.APIPostRevisions)
|
||
api.GET("/posts/:id/revisions/:revId", h.APIPostRevisionDetail)
|
||
api.POST("/posts/:id/like", h.APIToggleLike)
|
||
api.POST("/posts/:id/favorite", h.APIToggleFavorite)
|
||
api.POST("/posts/:id/resolve", h.APISetQuestionResolved)
|
||
api.POST("/posts/:id/poll/vote", h.APIPollVote)
|
||
api.POST("/posts/:id/poll/close", h.APIPollClose)
|
||
api.POST("/posts/:id/bounty/award", h.APIBountyAward)
|
||
api.POST("/posts/:id/bounty/refund", h.APIBountyRefund)
|
||
api.POST("/posts/:id/lottery/draw", h.APILotteryDraw)
|
||
api.POST("/posts/:id/report", middleware.RateLimitMiddleware(limiter, "report"), h.APICreatePostReport)
|
||
api.GET("/messages/unread-count", h.APIMessageUnreadCount)
|
||
api.GET("/messages/notifications", h.APIMessageNotifications)
|
||
api.POST("/messages/notifications/read", h.APIMarkNotificationsRead)
|
||
api.POST("/messages/:id/read", h.APIMarkMessageRead)
|
||
api.GET("/messages/conversations", h.APIMessageConversations)
|
||
api.GET("/messages/conversations/:peerId", h.APIConversationMessages)
|
||
api.POST("/messages/conversations/:peerId/read", h.APIMarkConversationRead)
|
||
api.POST("/messages", middleware.RateLimitMiddleware(limiter, "message"), h.APISendMessage)
|
||
api.POST("/messages/read-all", h.APIMarkAllMessagesRead)
|
||
api.POST("/comments/:id/like", h.APIToggleCommentLike)
|
||
api.POST("/comments/:id/report", middleware.RateLimitMiddleware(limiter, "report"), h.APICreateCommentReport)
|
||
api.DELETE("/comments/:id", h.APIDeleteComment)
|
||
api.PUT("/comments/:id", h.APIUpdateComment)
|
||
api.GET("/me/points", h.APIMePoints)
|
||
api.GET("/me/check-in", h.APIMeCheckInGet)
|
||
api.POST("/me/check-in", h.APIMeCheckIn)
|
||
api.GET("/me/lottery", h.APIMeLotteryGet)
|
||
api.POST("/me/lottery", h.APIMeLotteryDraw)
|
||
api.POST("/posts/:id/unlock", middleware.RateLimitMiddleware(limiter, "post"), h.APIUnlockPostBlock)
|
||
api.POST("/friend-links/apply", middleware.RateLimitMiddleware(limiter, "friend_link"), h.APIApplyFriendLink)
|
||
api.POST("/friend-links/logo", middleware.RateLimitMiddleware(limiter, "post"), h.APIUploadFriendLinkLogo)
|
||
api.GET("/friend-links/my-applies", h.APIMyFriendLinkApplies)
|
||
api.PUT("/friend-links/applies/:id", middleware.RateLimitMiddleware(limiter, "friend_link"), h.APIUpdateFriendLinkApply)
|
||
api.DELETE("/friend-links/applies/:id", h.APICancelFriendLinkApply)
|
||
}
|
||
|
||
// 管理员 API（React SPA 后台统一使用 JSON）
|
||
adminAPI := r.Group("/api/admin", authMW.RequireAuth(), authMW.RequireAdmin())
|
||
{
|
||
adminAPI.GET("/dashboard", h.APIAdminDashboard)
|
||
adminAPI.GET("/settings", h.APIAdminSettings)
|
||
adminAPI.PUT("/settings/forum", h.APIAdminUpdateForumSettings)
|
||
adminAPI.PUT("/settings/community", h.APIAdminUpdateCommunitySettings)
|
||
adminAPI.GET("/settings/monitor", h.APIAdminGetMonitorSettings)
|
||
adminAPI.PUT("/settings/monitor", h.APIAdminUpdateMonitorSettings)
|
||
adminAPI.GET("/monitor/overview", h.APIAdminMonitorOverview)
|
||
adminAPI.GET("/monitor/geo", h.APIAdminMonitorGeo)
|
||
adminAPI.GET("/monitor/stats", h.APIAdminMonitorStats)
|
||
adminAPI.GET("/monitor/logs", h.APIAdminMonitorLogs)
|
||
adminAPI.GET("/monitor/realtime", h.APIAdminMonitorRealtime)
|
||
adminAPI.GET("/community/instances", h.APIAdminCommunityInstances)
|
||
adminAPI.PUT("/community/instances/:id/feature", h.APIAdminFeatureCommunityInstance)
|
||
adminAPI.PUT("/community/showcase-entry", h.APIAdminUpdateShowcaseEntry)
|
||
adminAPI.PUT("/settings/mail", h.APIAdminUpdateMailSettings)
|
||
adminAPI.POST("/settings/mail/test", h.APIAdminTestMail)
|
||
adminAPI.PUT("/settings/oidc", h.APIAdminUpdateOIDCSettings)
|
||
adminAPI.PUT("/settings/gitea", h.APIAdminUpdateGiteaSettings)
|
||
adminAPI.POST("/settings/gitea/sync", h.APIAdminSyncGitea)
|
||
adminAPI.PUT("/settings/storage", h.APIAdminUpdateStorageSettings)
|
||
adminAPI.PUT("/settings/branding", h.APIAdminUpdateBranding)
|
||
adminAPI.POST("/settings/branding/upload", h.APIAdminUploadBrandingAsset)
|
||
adminAPI.POST("/settings/branding/clear", h.APIAdminClearBrandingAsset)
|
||
adminAPI.GET("/oauth/clients", h.APIAdminListOAuthClients)
|
||
adminAPI.POST("/oauth/clients", h.APIAdminCreateOAuthClient)
|
||
adminAPI.PUT("/oauth/clients/:id", h.APIAdminUpdateOAuthClient)
|
||
adminAPI.DELETE("/oauth/clients/:id", h.APIAdminDeleteOAuthClient)
|
||
adminAPI.GET("/settings/filter-words", h.APIAdminFilterWords)
|
||
adminAPI.PUT("/settings/filter-words", h.APIAdminUpdateFilterWords)
|
||
adminAPI.POST("/boards", h.APIAdminCreateBoard)
|
||
adminAPI.PUT("/boards/:id", h.APIAdminUpdateBoard)
|
||
adminAPI.DELETE("/boards/:id", h.APIAdminDeleteBoard)
|
||
adminAPI.GET("/pages", h.APIAdminPages)
|
||
adminAPI.GET("/pages/:id", h.APIAdminGetPage)
|
||
adminAPI.POST("/pages", h.APIAdminCreatePage)
|
||
adminAPI.PUT("/pages/:id", h.APIAdminUpdatePage)
|
||
adminAPI.PUT("/pages/:id/published", h.APIAdminSetPagePublished)
|
||
adminAPI.DELETE("/pages/:id", h.APIAdminDeletePage)
|
||
adminAPI.GET("/friend-link-applies", h.APIAdminFriendLinkApplies)
|
||
adminAPI.PUT("/friend-link-settings", h.APIAdminUpdateFriendLinkSettings)
|
||
adminAPI.POST("/friend-link-applies/:id/approve", h.APIAdminApproveFriendLinkApply)
|
||
adminAPI.POST("/friend-link-applies/:id/reject", h.APIAdminRejectFriendLinkApply)
|
||
adminAPI.POST("/friend-link-applies/:id/recheck", h.APIAdminRecheckFriendLinkApply)
|
||
adminAPI.GET("/posts", h.APIAdminPosts)
|
||
adminAPI.GET("/posts/trash", h.APIAdminTrashPosts)
|
||
adminAPI.POST("/posts/:id/pin", h.APIAdminPinPost)
|
||
adminAPI.POST("/posts/:id/board-pin", h.APIAdminBoardPinPost)
|
||
adminAPI.POST("/posts/:id/feature", h.APIAdminFeaturePost)
|
||
adminAPI.POST("/posts/:id/lock", h.APIAdminLockPost)
|
||
adminAPI.POST("/posts/:id/comments-lock", h.APIAdminCommentsLockPost)
|
||
adminAPI.POST("/posts/:id/approve", h.APIAdminApprovePost)
|
||
adminAPI.POST("/posts/:id/reject", h.APIAdminRejectPost)
|
||
adminAPI.POST("/posts/:id/restore", h.APIAdminRestorePost)
|
||
adminAPI.DELETE("/posts/:id/purge", h.APIAdminPurgePost)
|
||
adminAPI.DELETE("/posts/:id", h.APIAdminDeletePost)
|
||
adminAPI.GET("/reports", h.APIAdminReports)
|
||
adminAPI.POST("/reports/:id/handle", h.APIAdminHandleReport)
|
||
adminAPI.GET("/comments", h.APIAdminComments)
|
||
adminAPI.GET("/comments/trash", h.APIAdminTrashComments)
|
||
adminAPI.GET("/comments/:id/revisions", h.APIAdminCommentRevisions)
|
||
adminAPI.POST("/comments/:id/approve", h.APIAdminApproveComment)
|
||
adminAPI.POST("/comments/:id/reject", h.APIAdminRejectComment)
|
||
adminAPI.POST("/comments/:id/restore", h.APIAdminRestoreComment)
|
||
adminAPI.DELETE("/comments/:id/purge", h.APIAdminPurgeComment)
|
||
adminAPI.DELETE("/comments/:id", h.APIAdminDeleteComment)
|
||
adminAPI.GET("/users", h.APIAdminUsers)
|
||
adminAPI.POST("/users/:id/ban", h.APIAdminBanUser)
|
||
adminAPI.POST("/users/:id/verify", h.APIAdminVerifyUser)
|
||
adminAPI.POST("/users/:id/level", h.APIAdminSetUserLevel)
|
||
adminAPI.POST("/users/:id/points", h.APIAdminAdjustPoints)
|
||
adminAPI.POST("/users/:id/badges", h.APIAdminAwardBadge)
|
||
adminAPI.GET("/badges", h.APIAdminListBadges)
|
||
adminAPI.POST("/badges", h.APIAdminUpsertBadge)
|
||
adminAPI.GET("/media", h.APIAdminMedia)
|
||
adminAPI.POST("/media/delete", h.APIAdminDeleteMedia)
|
||
adminAPI.POST("/backup", h.APIAdminBackup)
|
||
adminAPI.GET("/backup/download/:name", h.APIAdminDownloadBackup)
|
||
}
|
||
|
||
// 后台管理页面由 React SPA 渲染（JSON API 见上方 /api/admin）
|
||
// dev 模式下前端由 Vite 提供，后台页面路由不在此注册
|
||
if !cfg.DevMode {
|
||
admin := r.Group("/admin")
|
||
{
|
||
admin.GET("/login", func(c *gin.Context) {
|
||
c.Redirect(http.StatusFound, "/login")
|
||
})
|
||
|
||
adminAuth := admin.Group("/", authMW.RequireAuth(), authMW.RequireAdmin())
|
||
{
|
||
adminAuth.GET("/", func(c *gin.Context) { c.Redirect(http.StatusFound, "/admin/dashboard") })
|
||
for _, page := range []string{
|
||
"dashboard", "boards", "pages", "links", "community", "posts",
|
||
"comments", "reports", "users", "badges", "media", "monitor", "settings",
|
||
} {
|
||
adminAuth.GET("/"+page, embed_static.ServeSPANoIndex)
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// React SPA 入口
|
||
// dev 模式：前端由 Vite(:5173) 提供，非 API 请求返回开发提示
|
||
// 生产模式：注入 SEO meta / JSON-LD / 预渲染摘要
|
||
if cfg.DevMode {
|
||
r.NoRoute(func(c *gin.Context) {
|
||
c.JSON(http.StatusNotFound, gin.H{
|
||
"error": "dev 模式下前端由 Vite 提供，请访问 http://localhost:5173",
|
||
})
|
||
})
|
||
} else {
|
||
// 文档请求也解析登录 cookie，首页 SSR 才能输出头像/签到/收藏等完整壳
|
||
r.GET("/", authMW.OptionalAuth(), h.ServePublicSPA)
|
||
r.NoRoute(authMW.OptionalAuth(), func(c *gin.Context) {
|
||
if embed_static.IsSPARoute(c.Request.URL.Path) {
|
||
h.ServePublicSPA(c)
|
||
return
|
||
}
|
||
c.JSON(http.StatusNotFound, gin.H{"error": "not found"})
|
||
})
|
||
}
|
||
|
||
return r, nil
|
||
}
|