Documentation
¶
Index ¶
- Constants
- Variables
- func TokenHash(value string) string
- type Actor
- type App
- func (a *App) ActorForSession(id string) (*Actor, error)
- func (a *App) Authenticate(token string) (*Actor, error)
- func (a *App) CacheSetting(ctx context.Context, row models.Setting) error
- func (a *App) CheckRoles(current *Actor, ids []uint) error
- func (a *App) ClearUserCaches(ctx context.Context, ids ...uint) error
- func (a *App) Close() error
- func (a *App) DispatchChat(ctx context.Context)
- func (a *App) FileDisk(ctx context.Context, location *storage.Config) (fs.Filesystem, storage.Config, error)
- func (a *App) Handler() (http.Handler, error)
- func (a *App) Key(d constants.Definition, args ...any) string
- func (a *App) MenuList(locale string) []Menu
- func (a *App) Menus(actor *Actor, locale string) ([]Menu, error)
- func (a *App) PermissionList(locale string) map[string]Permission
- func (a *App) PublishChatEvents(ctx context.Context) error
- func (a *App) Setting(ctx context.Context, key string) (json.RawMessage, error)
- func (a *App) ValidateMenu(menu *models.Menu, editing bool) error
- func (a *App) WakeChat(ctx context.Context)
- type LinkSystem
- type Menu
- type Options
- type Permission
- type Runtime
- type SettingDefinition
- type SettingOption
Constants ¶
View Source
const DefaultAdminPassword = "123456"
Variables ¶
View Source
var StableKey = regexp.MustCompile(`^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$`)
Functions ¶
Types ¶
type Actor ¶
type Actor struct {
User models.User
Permissions map[string]bool
SessionID string
// contains filtered or unexported fields
}
func (*Actor) CanManageUser ¶ added in v0.1.1
CanManageUser 校验管理级别;调用方还需检查操作权限和数据范围。
func (*Actor) Departments ¶ added in v0.1.1
Departments 返回本部门、指定部门及其全部后代;全部范围不附加部门条件。
type App ¶
type App struct {
Options Options
DB *gorm.DB
Redis redis.UniversalClient
Runtime Runtime
Router *gin.Engine
Disk fs.Filesystem
Realtime *realtime.Hub
CacheKeys map[string]constants.Definition
PermissionDefinitions map[string]Permission
MenuDefinitions []Menu
SettingDefinitions map[string]SettingDefinition
}
App 持有后台定义和容器提供的共享资源。
func New ¶
func New(o Options, runtime Runtime, db *gorm.DB, client redis.UniversalClient, disk fs.Filesystem) (*App, error)
func (*App) ActorForSession ¶
ActorForSession reloads a durable session and its current roles for background work.
func (*App) Authenticate ¶
Authenticate 独立验证登录会话,资料和权限使用按用户隔离的缓存。
func (*App) CacheSetting ¶
CacheSetting 只接受较新的配置版本,避免多实例并发时旧值回写。
func (*App) CheckRoles ¶
CheckRoles 仅允许分配启用的下级角色,不要求操作者拥有其业务权限。
func (*App) ClearUserCaches ¶ added in v0.1.1
ClearUserCaches 清理指定用户的资料、授权和菜单;不传ID时清理所有用户。 自定义代码直接修改账号、角色或菜单后,在事务提交后调用。
func (*App) DispatchChat ¶ added in v0.1.1
func (*App) FileDisk ¶
func (a *App) FileDisk(ctx context.Context, location *storage.Config) (fs.Filesystem, storage.Config, error)
FileDisk使用文件原始存储位置;切换上传驱动不改变已上传附件的位置。
func (*App) Key ¶
func (a *App) Key(d constants.Definition, args ...any) string
Key adds the application/environment namespace to a registered key pattern.
func (*App) PermissionList ¶
func (a *App) PermissionList(locale string) map[string]Permission
func (*App) PublishChatEvents ¶ added in v0.1.1
PublishChatEvents leases pending events. Consumers deduplicate event_id.
type LinkSystem ¶
LinkSystem 显式注册受信任的外部系统, 不向后台开放任意系统密钥编辑.
type Menu ¶
type Menu struct {
Type int `json:"type"`
Key string `json:"key"`
ParentKey string `json:"parent_key"`
Title string `json:"title"`
Path string `json:"path"`
Component string `json:"component,omitempty"`
Permission string `json:"permission,omitempty"`
Icon string `json:"icon,omitempty"`
Sort int `json:"sort"`
URL string `json:"url,omitempty"`
Mode string `json:"mode,omitempty"`
SystemKey string `json:"system_key,omitempty"`
Hidden bool `json:"hidden,omitempty"`
Status int `json:"status"`
KeepAlive bool `json:"keep_alive"`
FixedTab bool `json:"fixed_tab"`
FullPage bool `json:"full_page"`
Children []Menu `json:"children,omitempty"`
}
type Options ¶
type Options struct {
Name string
Environment string
WSAddr string
WSPath string
AdminPrefix string
Storage string
Disk fs.Filesystem
AllowedOrigins []string
Menus []Menu
Permissions []Permission
CacheKeys []constants.Definition
Settings []SettingDefinition
LinkSystems []LinkSystem
Routes func(*App, *route.Registrar)
PublicRoutes func(*App, *route.Router)
WSValidate func(context.Context, realtime.Principal) error
WSAuthorize func(context.Context, realtime.Principal, string) error
Realtime func(*App, *realtime.Hub) error
AccessTTL time.Duration
RefreshTTL time.Duration
}
Options 仅声明应用实际需要配置的入口, 业务直接追加代码定义.
type Permission ¶
type Runtime ¶
type Runtime interface {
NewHTTPServer(context.Context, string) (*http.Server, error)
Close(...time.Duration) error
}
Runtime 提供应用已有的HTTP服务与退出能力。
type SettingDefinition ¶
type SettingDefinition struct {
Key string `json:"key"`
Title string `json:"title"`
Group string `json:"group"`
Kind string `json:"kind"`
Input string `json:"input"`
Options []SettingOption `json:"options,omitempty"`
Remark string `json:"remark,omitempty"`
Sort int `json:"sort"`
Default any `json:"default"`
Secret bool `json:"secret"`
When map[string]any `json:"when,omitempty"`
}
type SettingOption ¶
Source Files
¶
Click to show internal directories.
Click to hide internal directories.