Files
opsx-licence/backend/internal/controller/entitlement/entitlement_controller.go
T
Logan.Li 4ae318335c feat: 完成 opsx-licence 许可证管理平台全栈实现
基于 opsx-web-lite 框架(Go+Gin+Vue3+Element Plus)构建许可证管理服务器,
业务域参考 Licence 服务器 Web 版。

【后端 - 4层架构】
- 认证:单 Admin 表 + JWT(HS256)
- 核心授权域:Product / Customer / License / Activation
  · License 生成/验证/激活/机器绑定/心跳/续期/吊销
  · 客户端契约接口:/api/v1/license/{verify,activate,deactivate,heartbeat}
- 定价订单:Plan / Order / 支付网关配置
- 防重复购买:CustomerEntitlement + 幂等支付 webhook + 手动发放
- 分析审计:Dashboard 统计 / Analytics / AuditLog / Setting 管理

【前端】
- Dashboard(ECharts 图表)、产品、客户、License、计划、订单、权益、日志、设置
- 9 个完整 CRUD 业务页面 + 登录/布局

【部署】
- SQLite + 单二进制(//go:embed 嵌入前端)
- 开发:./run.sh start(前端5181/后端9001)
- 生产:./run.sh build && ./run.sh binary start
- 默认账号:admin/admin

Author: Logan.Li
2026-08-07 15:02:00 +08:00

97 lines
3.2 KiB
Go

package entitlement
import (
entitlementservice "backend/internal/service/entitlement"
"backend/utils"
"net/http"
"strconv"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
)
// EntitlementController 客户权益控制器 // Logan.Li
type EntitlementController struct {
svc *entitlementservice.EntitlementService
db *gorm.DB
}
// NewEntitlementController 创建控制器实例 // Logan.Li
func NewEntitlementController(db *gorm.DB) *EntitlementController {
return &EntitlementController{svc: entitlementservice.NewEntitlementService(db), db: db}
}
// List 权益列表 // Logan.Li
func (ctrl *EntitlementController) List(c *gin.Context) {
page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10"))
customerID, _ := strconv.ParseUint(c.Query("customer_id"), 10, 32)
productID, _ := strconv.ParseUint(c.Query("product_id"), 10, 32)
entitlements, total, err := ctrl.svc.List(page, pageSize, uint(customerID), uint(productID))
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 500, "message": err.Error()})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "data": gin.H{
"list": entitlements, "total": total, "page": page, "page_size": pageSize,
"total_pages": (total + int64(pageSize) - 1) / int64(pageSize),
}})
}
// Get 权益详情 // Logan.Li
func (ctrl *EntitlementController) Get(c *gin.Context) {
id, _ := strconv.ParseUint(c.Param("id"), 10, 32)
ent, err := ctrl.svc.GetByID(uint(id))
if err != nil {
c.JSON(http.StatusOK, gin.H{"code": 404, "message": err.Error()})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "data": ent})
}
// Revoke 吊销权益 // Logan.Li
func (ctrl *EntitlementController) Revoke(c *gin.Context) {
id, _ := strconv.ParseUint(c.Param("id"), 10, 32)
if err := ctrl.svc.Revoke(uint(id)); err != nil {
c.JSON(http.StatusOK, gin.H{"code": 1, "message": err.Error()})
return
}
utils.LogAction(ctrl.db, c, "revoke", "entitlement", uint(id), "", "", "", "吊销客户权益")
c.JSON(http.StatusOK, gin.H{"code": 0, "message": "权益已吊销"})
}
// Renew 续费权益 // Logan.Li
func (ctrl *EntitlementController) Renew(c *gin.Context) {
id, _ := strconv.ParseUint(c.Param("id"), 10, 32)
var req struct {
PlanID uint `json:"plan_id" binding:"required"`
}
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "参数错误"})
return
}
ent, err := ctrl.svc.Renew(uint(id), req.PlanID)
if err != nil {
c.JSON(http.StatusOK, gin.H{"code": 1, "message": err.Error()})
return
}
utils.LogAction(ctrl.db, c, "renew", "entitlement", ent.ID, "", "", "", "续费客户权益")
c.JSON(http.StatusOK, gin.H{"code": 0, "message": "续费成功", "data": ent})
}
// GetByEmail 按邮箱查询客户权益(客户端接口) // Logan.Li
func (ctrl *EntitlementController) GetByEmail(c *gin.Context) {
email := c.Query("email")
if email == "" {
c.JSON(http.StatusBadRequest, gin.H{"code": 400, "message": "缺少 email 参数"})
return
}
entitlements, err := ctrl.svc.GetByEmail(email)
if err != nil {
c.JSON(http.StatusOK, gin.H{"code": 1, "message": err.Error()})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "data": entitlements})
}