wangrui/portal-mini-go
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
wangrui
2026-10-26 22:42:29 +08:00
parent 6f13816bcf
commit 554f6737cf
9 changed files with 331 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files
internal/handler/admin/miniapp/miniapp_handler.go
+20
View File
@@ -97,6 +97,25 @@ func (h *Handler) Delete(c *gin.Context) {
response.OK(c, nil)
}
// UpdateStatus 更新小程序状态（0 禁用、1 启用）。
func (h *Handler) UpdateStatus(c *gin.Context) {
id, ok := parseID(c)
if !ok {
return
}
var req miniappsvc.StatusReq
if err := c.ShouldBindJSON(&req); err != nil {
c.Error(errors.ErrBadRequest)
return
}
m, err := h.svc.UpdateStatus(c.Request.Context(), id, req.Status)
if err != nil {
c.Error(err)
return
}
response.OK(c, m)
}
// parseID 从路径参数解析并校验 uint64 主键。
func parseID(c *gin.Context) (uint64, bool) {
id, err := strconv.ParseUint(c.Param("id"), 10, 64)
@@ -117,5 +136,6 @@ func Register(g *gin.RouterGroup, h *Handler) {
rg.GET("/:id", middleware.RequirePerm(middleware.PermMiniView), h.Get)
rg.GET("", middleware.RequirePerm(middleware.PermMiniView), h.List)
rg.DELETE("/:id", middleware.RequirePerm(middleware.PermMiniManage), h.Delete)
rg.PUT("/:id/status", middleware.RequirePerm(middleware.PermMiniManage), h.UpdateStatus)
}
}
internal/handler/miniapp/app1/user_handler.go
+8 -7
View File
@@ -10,6 +10,7 @@ import (
"portal-mini-go/internal/model"
"portal-mini-go/internal/pkg/errors"
"portal-mini-go/internal/pkg/response"
"portal-mini-go/internal/pkg/types"
app1svc "portal-mini-go/internal/service/miniapp/app1"
)
@@ -110,12 +111,12 @@ func (h *Handler) ListUsers(c *gin.Context) {
// ProfileView 当前用户自身的资料视图（含自身 openid/unionid）。
type ProfileView struct {
ID uint64 `json:"id"`
OpenID string `json:"openid"`
UnionID string `json:"union_id"`
Nickname string `json:"nickname"`
Avatar string `json:"avatar"`
CreatedAt int64 `json:"created_at"`
ID uint64 `json:"id"`
OpenID string `json:"openid"`
UnionID string `json:"union_id"`
Nickname string `json:"nickname"`
Avatar string `json:"avatar"`
CreatedAt types.Time `json:"created_at"`
}
// PublicUserView 对外的用户公开视图，剔除 openid/unionid 等敏感字段。
@@ -132,7 +133,7 @@ func toProfileView(u *model.User) ProfileView {
UnionID: u.UnionID,
Nickname: u.Nickname,
Avatar: u.Avatar,
CreatedAt: u.CreatedAt.Unix(),
CreatedAt: u.CreatedAt,
}
}
internal/model/admin/admin.go
+24 -24
View File
@@ -3,17 +3,17 @@
// 因此本包模型不进小程序数据隔离逻辑。
package admin
import "time"
import "portal-mini-go/internal/pkg/types"
// User 是后台管理员账号。用户名全局唯一，密码以 bcrypt 哈希存储。
type User struct {
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Username string `gorm:"column:username;type:varchar(64);uniqueIndex;not null" json:"username"`
PasswordHash string `gorm:"column:password_hash;type:varchar(255);not null" json:"-"`
Nickname string `gorm:"column:nickname;type:varchar(128)" json:"nickname"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Username string `gorm:"column:username;type:varchar(64);uniqueIndex;not null" json:"username"`
PasswordHash string `gorm:"column:password_hash;type:varchar(255);not null" json:"-"`
Nickname string `gorm:"column:nickname;type:varchar(128)" json:"nickname"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt types.Time `json:"created_at"`
UpdatedAt types.Time `json:"updated_at"`
}
func (User) TableName() string { return "admin_users" }
@@ -26,13 +26,13 @@ const (
// Role 是后台角色，与权限多对多关联，再与管理员多对多关联。
type Role struct {
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Code string `gorm:"column:code;type:varchar(64);uniqueIndex;not null" json:"code"`
Name string `gorm:"column:name;type:varchar(128);not null" json:"name"`
Description string `gorm:"column:description;type:varchar(512)" json:"description"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Code string `gorm:"column:code;type:varchar(64);uniqueIndex;not null" json:"code"`
Name string `gorm:"column:name;type:varchar(128);not null" json:"name"`
Description string `gorm:"column:description;type:varchar(512)" json:"description"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt types.Time `json:"created_at"`
UpdatedAt types.Time `json:"updated_at"`
}
func (Role) TableName() string { return "admin_roles" }
@@ -40,15 +40,15 @@ func (Role) TableName() string { return "admin_roles" }
// Permission 是后台权限，分接口（api）与菜单（menu）两类。
// 接口权限 code 对应后端 API 守卫；菜单权限 code 用于前端动态渲染菜单树。
type Permission struct {
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Code string `gorm:"column:code;type:varchar(128);uniqueIndex;not null" json:"code"`
Name string `gorm:"column:name;type:varchar(128);not null" json:"name"`
Type string `gorm:"column:type;type:varchar(16);not null;default:'api'" json:"type"`
Method string `gorm:"column:method;type:varchar(16)" json:"method"`
Path string `gorm:"column:path;type:varchar(255)" json:"path"`
ParentID uint64 `gorm:"column:parent_id;index" json:"parent_id"`
Sort int `gorm:"column:sort;not null;default:0" json:"sort"`
CreatedAt time.Time `json:"created_at"`
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
Code string `gorm:"column:code;type:varchar(128);uniqueIndex;not null" json:"code"`
Name string `gorm:"column:name;type:varchar(128);not null" json:"name"`
Type string `gorm:"column:type;type:varchar(16);not null;default:'api'" json:"type"`
Method string `gorm:"column:method;type:varchar(16)" json:"method"`
Path string `gorm:"column:path;type:varchar(255)" json:"path"`
ParentID uint64 `gorm:"column:parent_id;index" json:"parent_id"`
Sort int `gorm:"column:sort;not null;default:0" json:"sort"`
CreatedAt types.Time `json:"created_at"`
}
func (Permission) TableName() string { return "admin_permissions" }
internal/model/miniapp.go
+4 -4
View File
@@ -2,9 +2,9 @@
package model
import (
"time"
"gorm.io/gorm"
"portal-mini-go/internal/pkg/types"
)
// MiniProgram 是被后台纳管的微信小程序配置。
@@ -17,8 +17,8 @@ type MiniProgram struct {
AppSecret string `gorm:"column:app_secret;type:varchar(128);not null" json:"-"`
Status int8 `gorm:"type:tinyint;not null;default:1" json:"status"`
Ext string `gorm:"type:text" json:"ext"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
CreatedAt types.Time `json:"created_at"`
UpdatedAt types.Time `json:"updated_at"`
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
}
internal/model/user.go
+10 -10
View File
@@ -3,20 +3,20 @@
// 各小程序用户互不关联（open_id 在不同 appid 下天然互不冲突，故无需额外隔离键）。
package model
import "time"
import "portal-mini-go/internal/pkg/types"
// User 是小程序端用户。MiniID 关联被纳管的小程序（mini_programs.id），
// 与 open_id 共同唯一标识一个用户：(mini_id, open_id)。
type User struct {
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
MiniID uint64 `gorm:"column:mini_id;index:idx_mini_openid" json:"mini_id"`
OpenID string `gorm:"type:varchar(64);index:idx_mini_openid" json:"openid"`
UnionID string `gorm:"type:varchar(64);index" json:"union_id"`
Nickname string `gorm:"type:varchar(128)" json:"nickname"`
Avatar string `gorm:"type:varchar(512)" json:"avatar"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
MiniID uint64 `gorm:"column:mini_id;index:idx_mini_openid" json:"mini_id"`
OpenID string `gorm:"type:varchar(64);index:idx_mini_openid" json:"openid"`
UnionID string `gorm:"type:varchar(64);index" json:"union_id"`
Nickname string `gorm:"type:varchar(128)" json:"nickname"`
Avatar string `gorm:"type:varchar(512)" json:"avatar"`
Status int8 `gorm:"column:status;type:tinyint;not null;default:1" json:"status"`
CreatedAt types.Time `json:"created_at"`
UpdatedAt types.Time `json:"updated_at"`
}
func (User) TableName() string { return "users" }
internal/pkg/types/time.go
+104
View File
@@ -0,0 +1,104 @@
// Package types 提供可复用的基础类型。
package types
import (
"database/sql/driver"
"fmt"
"strings"
"time"
"gorm.io/gorm/schema"
)
// TimeFormat 是时间字段返回给前端的标准格式（Y-m-d H:i:s）。
const TimeFormat = "2006-01-02 15:04:05"
// Time 是对 time.Time 的封装：JSON 序列化输出 TimeFormat 格式，
// 同时实现 driver.Valuer / sql.Scanner 以及与 GORM 的 GormDataTypeInterface，
// 使其既能作为模型字段被 GORM 自动维护（CreatedAt/UpdatedAt），又能以
// "2006-01-02 15:04:05" 字符串形式返回给前端。
type Time struct {
time.Time
}
// NewTime 基于 time.Time 构造 Time。
func NewTime(t time.Time) Time { return Time{Time: t} }
// Now 返回当前时间的 Time 封装。
func Now() Time { return Time{Time: time.Now()} }
// GormDataType 让 GORM 将该字段识别为时间类型，从而启用自动时间戳。
func (Time) GormDataType() schema.DataType { return schema.Time }
func (t Time) MarshalJSON() ([]byte, error) {
if t.Time.IsZero() {
return []byte(`""`), nil
}
return []byte(`"` + t.Time.Format(TimeFormat) + `"`), nil
}
// UnmarshalJSON 解析前端传入的时间字符串，兼容 TimeFormat 与 RFC3339。
func (t *Time) UnmarshalJSON(b []byte) error {
s := strings.Trim(string(b), `"`)
if s == "" || s == "null" {
t.Time = time.Time{}
return nil
}
parsed, err := time.ParseInLocation(TimeFormat, s, time.Local)
if err != nil {
if parsed, err = time.Parse(time.RFC3339, s); err != nil {
return fmt.Errorf("types.Time: 解析 %q 失败: %w", s, err)
}
}
t.Time = parsed
return nil
}
// Value 实现 driver.Valuer，写入数据库时返回底层 time.Time。
func (t Time) Value() (driver.Value, error) {
if t.Time.IsZero() {
return nil, nil
}
return t.Time, nil
}
// Scan 实现 sql.Scanner，从数据库读取时还原为 time.Time。
func (t *Time) Scan(src interface{}) error {
if src == nil {
t.Time = time.Time{}
return nil
}
switch v := src.(type) {
case time.Time:
t.Time = v
case *time.Time:
if v == nil {
t.Time = time.Time{}
} else {
t.Time = *v
}
case []byte:
parsed, err := time.ParseInLocation(TimeFormat, string(v), time.Local)
if err != nil {
return fmt.Errorf("types.Time: 扫描 []byte %q 失败: %w", string(v), err)
}
t.Time = parsed
case string:
parsed, err := time.ParseInLocation(TimeFormat, v, time.Local)
if err != nil {
return fmt.Errorf("types.Time: 扫描 string %q 失败: %w", v, err)
}
t.Time = parsed
default:
return fmt.Errorf("types.Time: 不支持的扫描类型 %T", src)
}
return nil
}
// String 返回 TimeFormat 格式的字符串表示。
func (t Time) String() string {
if t.Time.IsZero() {
return ""
}
return t.Time.Format(TimeFormat)
}
internal/pkg/types/time_test.go
+113
View File
@@ -0,0 +1,113 @@
package types
import (
"database/sql/driver"
"encoding/json"
"testing"
"time"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"gorm.io/gorm/schema"
)
func TestTime_MarshalJSON(t *testing.T) {
t.Run("正常时间输出 Y-m-d H:i:s", func(t *testing.T) {
tm := NewTime(time.Date(2026, 10, 26, 15, 4, 5, 0, time.UTC))
b, err := json.Marshal(tm)
require.NoError(t, err)
assert.JSONEq(t, `"2026-10-26 15:04:05"`, string(b))
})
t.Run("零值输出空字符串", func(t *testing.T) {
b, err := json.Marshal(Time{})
require.NoError(t, err)
assert.JSONEq(t, `""`, string(b))
})
}
func TestTime_UnmarshalJSON(t *testing.T) {
t.Run("Y-m-d H:i:s", func(t *testing.T) {
var tm Time
require.NoError(t, json.Unmarshal([]byte(`"2026-10-26 15:04:05"`), &tm))
assert.Equal(t, time.Date(2026, 10, 26, 15, 4, 5, 0, time.Local), tm.Time)
})
t.Run("RFC3339 兼容", func(t *testing.T) {
var tm Time
require.NoError(t, json.Unmarshal([]byte(`"2026-10-26T15:04:05Z"`), &tm))
assert.Equal(t, 2026, tm.Year())
assert.Equal(t, time.October, tm.Month())
})
t.Run("空字符串与 null", func(t *testing.T) {
for _, in := range []string{`""`, `null`} {
var tm Time
require.NoError(t, json.Unmarshal([]byte(in), &tm))
assert.True(t, tm.IsZero())
}
})
t.Run("非法格式报错", func(t *testing.T) {
var tm Time
assert.Error(t, json.Unmarshal([]byte(`"not-a-time"`), &tm))
})
}
func TestTime_Scan(t *testing.T) {
src := time.Date(2026, 10, 26, 15, 4, 5, 0, time.UTC)
cases := []struct {
name string
in interface{}
want time.Time
}{
{"time.Time", src, src},
{"*time.Time", &src, src},
{"[]byte", []byte("2026-10-26 15:04:05"), time.Date(2026, 10, 26, 15, 4, 5, 0, time.Local)},
{"string", "2026-10-26 15:04:05", time.Date(2026, 10, 26, 15, 4, 5, 0, time.Local)},
{"nil", nil, time.Time{}},
}
for _, c := range cases {
t.Run(c.name, func(t *testing.T) {
var tm Time
require.NoError(t, tm.Scan(c.in))
if c.want.IsZero() {
assert.True(t, tm.IsZero())
return
}
assert.True(t, c.want.Equal(tm.Time), "got %v want %v", tm.Time, c.want)
})
}
t.Run("不支持的类型报错", func(t *testing.T) {
var tm Time
assert.Error(t, tm.Scan(123))
})
}
func TestTime_Value(t *testing.T) {
src := time.Date(2026, 10, 26, 15, 4, 5, 0, time.UTC)
v, err := NewTime(src).Value()
require.NoError(t, err)
got, ok := v.(time.Time)
require.True(t, ok)
assert.True(t, src.Equal(got))
// 零值返回 nil。
v, err = Time{}.Value()
require.NoError(t, err)
assert.Nil(t, v)
}
func TestTime_GormDataType(t *testing.T) {
assert.Equal(t, schema.Time, Time{}.GormDataType())
}
// 确保 Time 满足相关接口，编译期校验。
var (
_ driver.Valuer = Time{}
_ interface{ Scan(interface{}) error } = (*Time)(nil)
_ json.Marshaler = Time{}
_ json.Unmarshaler = (*Time)(nil)
)
internal/service/admin/miniapp/miniapp_service.go
+13
View File
@@ -117,6 +117,19 @@ func (s *Service) Delete(ctx context.Context, id uint64) error {
return s.repo.Delete(ctx, id)
}
// StatusReq 更新小程序状态请求。状态仅允许 0（禁用）或 1（启用）。
type StatusReq struct {
Status int8 `json:"status" binding:"required,oneof=0 1"`
}
// UpdateStatus 按 ID 更新小程序状态（0 禁用、1 启用），返回更新后的小程序。
func (s *Service) UpdateStatus(ctx context.Context, id uint64, status int8) (*model.MiniProgram, error) {
if err := s.repo.Update(ctx, id, map[string]interface{}{"status": status}); err != nil {
return nil, err
}
return s.repo.GetByID(ctx, id)
}
// validateExt 校验扩展字段为合法 JSON（允许为空字符串）。
func validateExt(s string) error {
if s == "" {