- Go 工程:cmd/usernode CLI(serve/migrate/admin create/reset-password/user otp)
+ internal/{config,model,service,system,auth,cron,api,router,server,pkg,webui}
- 配置:TOML + 环境变量覆盖(USERNODE_<SEC>_<FIELD>),config.example.toml
- 数据:GORM 双驱动(SQLite/MySQL)8 表模型,migrate 子命令可跑通
- 系统层:system.Manager 接口(useradd/userdel/passwd 白名单,dev dry-run)
- HTTP:Gin 路由骨架(/api/v1 + 501 占位),healthz,slog 结构化日志,优雅启停
- 前端:Vite + Vue3 + TS + Element Plus 最小可运行(web/),go:embed 打通
- 构建:deploy/Containerfile 多阶段单二进制镜像,web/Containerfile.dev 前端 dev
镜像,Makefile(build/test/dev/web-build/image);go.mod 锁定 go 1.22
- 验证:go build/vet/test 通过;podman 镜像构建运行 healthz+embed 通过
54 lines
1.5 KiB
Go
54 lines
1.5 KiB
Go
package api
|
||
|
||
import (
|
||
"net/http"
|
||
"strings"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"ws_usernode/internal/service"
|
||
)
|
||
|
||
// AdminHandler 管理员账号相关接口(M1 完成登录;create/reset 走 CLI)。
|
||
type AdminHandler struct {
|
||
svc *service.AdminService
|
||
}
|
||
|
||
// AdminCreateRequest 管理员创建请求。
|
||
type AdminCreateRequest struct {
|
||
Username string `json:"username" binding:"required"`
|
||
Password string `json:"password" binding:"required"`
|
||
Email string `json:"email" binding:"required"`
|
||
}
|
||
|
||
// Create 创建管理员(仅初始引导用,M1 前可经此接口快速建号)。
|
||
func (h *AdminHandler) Create(c *gin.Context) {
|
||
if h.svc == nil {
|
||
fail(c, http.StatusNotImplemented, "管理员服务未初始化")
|
||
return
|
||
}
|
||
var req AdminCreateRequest
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
fail(c, http.StatusBadRequest, "请求参数不合法: "+err.Error())
|
||
return
|
||
}
|
||
adm, err := h.svc.Create(c.Request.Context(), req.Username, req.Password, req.Email)
|
||
if err != nil {
|
||
switch {
|
||
case strings.Contains(err.Error(), "已存在"):
|
||
fail(c, http.StatusConflict, err.Error())
|
||
case strings.Contains(err.Error(), "过弱"):
|
||
fail(c, http.StatusBadRequest, err.Error())
|
||
default:
|
||
fail(c, http.StatusInternalServerError, err.Error())
|
||
}
|
||
return
|
||
}
|
||
ok(c, gin.H{"id": adm.ID, "username": adm.Username})
|
||
}
|
||
|
||
// Me 返回当前管理员(M1 接入会话后启用)。
|
||
func (h *AdminHandler) Me(c *gin.Context) {
|
||
fail(c, http.StatusNotImplemented, "会话尚未接入(M1)")
|
||
}
|