feat: 官网 + 管理端 + Gin/GORM 后端首个完整版本

- web/: 产品官网（Hero 事件流终端、功能矩阵、架构、快速开始、下载、博客 + Markdown 详情页），青瓷绿双主题 - admin/: 内容管理（JWT 登录、文章分页/搜索/CRUD、草稿与发布），embed 挂 /admin - server/: Gin + GORM，MySQL（DSN 走 .env，SQLite 兜底）；规范落地：sundynix_ 表前缀、字符串雪花主键、snake_case 列名、统一响应信封、公共分页参数 - 双 SPA embed 单二进制部署，make build 一键出包 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-17 11:03:31 +08:00
parent d46267dde1
commit 5abc705eae
53 changed files with 5774 additions and 38 deletions
@@ -0,0 +1,52 @@
+// Package auth JWT 签发与校验。
+package auth
+
+import (
+	"errors"
+	"log"
+	"os"
+	"time"
+
+	"github.com/golang-jwt/jwt/v5"
+)
+
+var secret []byte
+
+// Init 读取 JWT 密钥；未配置时使用开发默认值并告警。
+func Init() {
+	s := os.Getenv("SUNDYNIX_JWT_SECRET")
+	if s == "" {
+		s = "sundynix-dev-secret-change-me"
+		log.Println("[WARN] SUNDYNIX_JWT_SECRET 未设置，使用开发默认密钥，生产环境务必配置")
+	}
+	secret = []byte(s)
+}
+
+// Sign 为用户名签发 24h 有效期的 token。
+func Sign(username string) (string, error) {
+	claims := jwt.RegisteredClaims{
+		Subject:   username,
+		IssuedAt:  jwt.NewNumericDate(time.Now()),
+		ExpiresAt: jwt.NewNumericDate(time.Now().Add(24 * time.Hour)),
+		Issuer:    "sundynix-site",
+	}
+	return jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(secret)
+}
+
+// Parse 校验 token 并返回用户名。
+func Parse(token string) (string, error) {
+	t, err := jwt.ParseWithClaims(token, &jwt.RegisteredClaims{}, func(t *jwt.Token) (any, error) {
+		if _, ok := t.Method.(*jwt.SigningMethodHMAC); !ok {
+			return nil, errors.New("非法签名算法")
+		}
+		return secret, nil
+	})
+	if err != nil || !t.Valid {
+		return "", errors.New("token 无效或已过期")
+	}
+	claims, ok := t.Claims.(*jwt.RegisteredClaims)
+	if !ok {
+		return "", errors.New("token 载荷异常")
+	}
+	return claims.Subject, nil
+}
@@ -0,0 +1,34 @@
+// Package idgen 全局雪花 ID 生成器，主键统一用字符串形式。
+package idgen
+
+import (
+	"os"
+	"strconv"
+
+	"github.com/bwmarrin/snowflake"
+)
+
+var node *snowflake.Node
+
+// Init 初始化雪花节点；nodeID 取 SUNDYNIX_NODE_ID，默认 1。
+func Init() error {
+	nodeID := int64(1)
+	if v := os.Getenv("SUNDYNIX_NODE_ID"); v != "" {
+		n, err := strconv.ParseInt(v, 10, 64)
+		if err != nil {
+			return err
+		}
+		nodeID = n
+	}
+	n, err := snowflake.NewNode(nodeID)
+	if err != nil {
+		return err
+	}
+	node = n
+	return nil
+}
+
+// Next 生成一个字符串雪花 ID。
+func Next() string {
+	return node.Generate().String()
+}
@@ -0,0 +1,27 @@
+// Package req 公共请求参数。
+package req
+
+// PageQuery 分页 + 关键词，所有列表接口通用。
+type PageQuery struct {
+	Page     int    `form:"page,default=1"`
+	PageSize int    `form:"page_size,default=10"`
+	Keyword  string `form:"keyword"`
+}
+
+// Normalize 约束分页边界。
+func (q *PageQuery) Normalize() {
+	if q.Page < 1 {
+		q.Page = 1
+	}
+	if q.PageSize < 1 {
+		q.PageSize = 10
+	}
+	if q.PageSize > 100 {
+		q.PageSize = 100
+	}
+}
+
+// Offset 计算偏移量。
+func (q *PageQuery) Offset() int {
+	return (q.Page - 1) * q.PageSize
+}
@@ -0,0 +1,55 @@
+// Package resp 统一结果响应：{code, message, data}。
+// code = 0 表示成功，非 0 为业务错误码。
+package resp
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+const (
+	CodeOK           = 0
+	CodeBadRequest   = 40000
+	CodeUnauthorized = 40100
+	CodeNotFound     = 40400
+	CodeServerError  = 50000
+)
+
+type Body struct {
+	Code    int    `json:"code"`
+	Message string `json:"message"`
+	Data    any    `json:"data,omitempty"`
+}
+
+// PageResult 分页数据统一结构。
+type PageResult struct {
+	List     any   `json:"list"`
+	Total    int64 `json:"total"`
+	Page     int   `json:"page"`
+	PageSize int   `json:"page_size"`
+}
+
+func OK(c *gin.Context, data any) {
+	c.JSON(http.StatusOK, Body{Code: CodeOK, Message: "ok", Data: data})
+}
+
+func Page(c *gin.Context, list any, total int64, page, pageSize int) {
+	OK(c, PageResult{List: list, Total: total, Page: page, PageSize: pageSize})
+}
+
+func BadRequest(c *gin.Context, message string) {
+	c.JSON(http.StatusBadRequest, Body{Code: CodeBadRequest, Message: message})
+}
+
+func Unauthorized(c *gin.Context, message string) {
+	c.AbortWithStatusJSON(http.StatusUnauthorized, Body{Code: CodeUnauthorized, Message: message})
+}
+
+func NotFound(c *gin.Context, message string) {
+	c.JSON(http.StatusNotFound, Body{Code: CodeNotFound, Message: message})
+}
+
+func ServerError(c *gin.Context, message string) {
+	c.JSON(http.StatusInternalServerError, Body{Code: CodeServerError, Message: message})
+}