new
This commit is contained in:
434
internal/domains/statistics/entities/statistics_dashboard.go
Normal file
434
internal/domains/statistics/entities/statistics_dashboard.go
Normal file
@@ -0,0 +1,434 @@
|
||||
package entities
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"time"
|
||||
|
||||
"github.com/google/uuid"
|
||||
"gorm.io/gorm"
|
||||
)
|
||||
|
||||
// StatisticsDashboard 仪表板配置实体
|
||||
// 用于存储仪表板的配置信息
|
||||
type StatisticsDashboard struct {
|
||||
// 基础标识
|
||||
ID string `gorm:"primaryKey;type:varchar(36)" json:"id" comment:"仪表板唯一标识"`
|
||||
Name string `gorm:"type:varchar(100);not null" json:"name" comment:"仪表板名称"`
|
||||
Description string `gorm:"type:text" json:"description" comment:"仪表板描述"`
|
||||
UserRole string `gorm:"type:varchar(20);not null;index" json:"user_role" comment:"用户角色"`
|
||||
IsDefault bool `gorm:"default:false" json:"is_default" comment:"是否为默认仪表板"`
|
||||
IsActive bool `gorm:"default:true" json:"is_active" comment:"是否激活"`
|
||||
|
||||
// 仪表板配置
|
||||
Layout string `gorm:"type:json" json:"layout" comment:"布局配置"`
|
||||
Widgets string `gorm:"type:json" json:"widgets" comment:"组件配置"`
|
||||
Settings string `gorm:"type:json" json:"settings" comment:"设置配置"`
|
||||
RefreshInterval int `gorm:"default:300" json:"refresh_interval" comment:"刷新间隔(秒)"`
|
||||
|
||||
// 权限和访问控制
|
||||
CreatedBy string `gorm:"type:varchar(36);not null" json:"created_by" comment:"创建者ID"`
|
||||
AccessLevel string `gorm:"type:varchar(20);default:'private'" json:"access_level" comment:"访问级别"`
|
||||
|
||||
// 时间戳字段
|
||||
CreatedAt time.Time `gorm:"autoCreateTime" json:"created_at" comment:"创建时间"`
|
||||
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at" comment:"更新时间"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-" comment:"软删除时间"`
|
||||
|
||||
// 领域事件 (不持久化)
|
||||
domainEvents []interface{} `gorm:"-" json:"-"`
|
||||
}
|
||||
|
||||
// TableName 指定数据库表名
|
||||
func (StatisticsDashboard) TableName() string {
|
||||
return "statistics_dashboards"
|
||||
}
|
||||
|
||||
// BeforeCreate GORM钩子：创建前自动生成UUID
|
||||
func (s *StatisticsDashboard) BeforeCreate(tx *gorm.DB) error {
|
||||
if s.ID == "" {
|
||||
s.ID = uuid.New().String()
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// 实现 Entity 接口 - 提供统一的实体管理接口
|
||||
// GetID 获取实体唯一标识
|
||||
func (s *StatisticsDashboard) GetID() string {
|
||||
return s.ID
|
||||
}
|
||||
|
||||
// GetCreatedAt 获取创建时间
|
||||
func (s *StatisticsDashboard) GetCreatedAt() time.Time {
|
||||
return s.CreatedAt
|
||||
}
|
||||
|
||||
// GetUpdatedAt 获取更新时间
|
||||
func (s *StatisticsDashboard) GetUpdatedAt() time.Time {
|
||||
return s.UpdatedAt
|
||||
}
|
||||
|
||||
// Validate 验证仪表板配置信息
|
||||
// 检查仪表板必填字段是否完整，确保数据的有效性
|
||||
func (s *StatisticsDashboard) Validate() error {
|
||||
if s.Name == "" {
|
||||
return NewValidationError("仪表板名称不能为空")
|
||||
}
|
||||
if s.UserRole == "" {
|
||||
return NewValidationError("用户角色不能为空")
|
||||
}
|
||||
if s.CreatedBy == "" {
|
||||
return NewValidationError("创建者ID不能为空")
|
||||
}
|
||||
|
||||
// 验证用户角色
|
||||
if !s.IsValidUserRole() {
|
||||
return NewValidationError("无效的用户角色")
|
||||
}
|
||||
|
||||
// 验证访问级别
|
||||
if !s.IsValidAccessLevel() {
|
||||
return NewValidationError("无效的访问级别")
|
||||
}
|
||||
|
||||
// 验证刷新间隔
|
||||
if s.RefreshInterval < 30 {
|
||||
return NewValidationError("刷新间隔不能少于30秒")
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// IsValidUserRole 检查用户角色是否有效
|
||||
func (s *StatisticsDashboard) IsValidUserRole() bool {
|
||||
validRoles := []string{
|
||||
"admin", // 管理员
|
||||
"user", // 普通用户
|
||||
"manager", // 经理
|
||||
"analyst", // 分析师
|
||||
}
|
||||
|
||||
for _, validRole := range validRoles {
|
||||
if s.UserRole == validRole {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
// IsValidAccessLevel 检查访问级别是否有效
|
||||
func (s *StatisticsDashboard) IsValidAccessLevel() bool {
|
||||
validLevels := []string{
|
||||
"private", // 私有
|
||||
"public", // 公开
|
||||
"shared", // 共享
|
||||
}
|
||||
|
||||
for _, validLevel := range validLevels {
|
||||
if s.AccessLevel == validLevel {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
// GetUserRoleName 获取用户角色的中文名称
|
||||
func (s *StatisticsDashboard) GetUserRoleName() string {
|
||||
roleNames := map[string]string{
|
||||
"admin": "管理员",
|
||||
"user": "普通用户",
|
||||
"manager": "经理",
|
||||
"analyst": "分析师",
|
||||
}
|
||||
|
||||
if name, exists := roleNames[s.UserRole]; exists {
|
||||
return name
|
||||
}
|
||||
return s.UserRole
|
||||
}
|
||||
|
||||
// GetAccessLevelName 获取访问级别的中文名称
|
||||
func (s *StatisticsDashboard) GetAccessLevelName() string {
|
||||
levelNames := map[string]string{
|
||||
"private": "私有",
|
||||
"public": "公开",
|
||||
"shared": "共享",
|
||||
}
|
||||
|
||||
if name, exists := levelNames[s.AccessLevel]; exists {
|
||||
return name
|
||||
}
|
||||
return s.AccessLevel
|
||||
}
|
||||
|
||||
// NewStatisticsDashboard 工厂方法 - 创建仪表板配置
|
||||
func NewStatisticsDashboard(name, description, userRole, createdBy string) (*StatisticsDashboard, error) {
|
||||
if name == "" {
|
||||
return nil, errors.New("仪表板名称不能为空")
|
||||
}
|
||||
if userRole == "" {
|
||||
return nil, errors.New("用户角色不能为空")
|
||||
}
|
||||
if createdBy == "" {
|
||||
return nil, errors.New("创建者ID不能为空")
|
||||
}
|
||||
|
||||
dashboard := &StatisticsDashboard{
|
||||
Name: name,
|
||||
Description: description,
|
||||
UserRole: userRole,
|
||||
CreatedBy: createdBy,
|
||||
IsDefault: false,
|
||||
IsActive: true,
|
||||
AccessLevel: "private",
|
||||
RefreshInterval: 300, // 默认5分钟
|
||||
domainEvents: make([]interface{}, 0),
|
||||
}
|
||||
|
||||
// 验证仪表板
|
||||
if err := dashboard.Validate(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
// 添加领域事件
|
||||
dashboard.addDomainEvent(&StatisticsDashboardCreatedEvent{
|
||||
DashboardID: dashboard.ID,
|
||||
Name: name,
|
||||
UserRole: userRole,
|
||||
CreatedBy: createdBy,
|
||||
CreatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return dashboard, nil
|
||||
}
|
||||
|
||||
// SetAsDefault 设置为默认仪表板
|
||||
func (s *StatisticsDashboard) SetAsDefault() error {
|
||||
if !s.IsActive {
|
||||
return NewValidationError("只有激活状态的仪表板才能设置为默认")
|
||||
}
|
||||
|
||||
s.IsDefault = true
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardSetAsDefaultEvent{
|
||||
DashboardID: s.ID,
|
||||
SetAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// RemoveAsDefault 取消默认状态
|
||||
func (s *StatisticsDashboard) RemoveAsDefault() error {
|
||||
if !s.IsDefault {
|
||||
return NewValidationError("当前仪表板不是默认仪表板")
|
||||
}
|
||||
|
||||
s.IsDefault = false
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardRemovedAsDefaultEvent{
|
||||
DashboardID: s.ID,
|
||||
RemovedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// Activate 激活仪表板
|
||||
func (s *StatisticsDashboard) Activate() error {
|
||||
if s.IsActive {
|
||||
return NewValidationError("仪表板已经是激活状态")
|
||||
}
|
||||
|
||||
s.IsActive = true
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardActivatedEvent{
|
||||
DashboardID: s.ID,
|
||||
ActivatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// Deactivate 停用仪表板
|
||||
func (s *StatisticsDashboard) Deactivate() error {
|
||||
if !s.IsActive {
|
||||
return NewValidationError("仪表板已经是停用状态")
|
||||
}
|
||||
|
||||
s.IsActive = false
|
||||
|
||||
// 如果是默认仪表板，需要先取消默认状态
|
||||
if s.IsDefault {
|
||||
s.IsDefault = false
|
||||
}
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardDeactivatedEvent{
|
||||
DashboardID: s.ID,
|
||||
DeactivatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// UpdateLayout 更新布局配置
|
||||
func (s *StatisticsDashboard) UpdateLayout(layout string) error {
|
||||
if layout == "" {
|
||||
return NewValidationError("布局配置不能为空")
|
||||
}
|
||||
|
||||
s.Layout = layout
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardLayoutUpdatedEvent{
|
||||
DashboardID: s.ID,
|
||||
UpdatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// UpdateWidgets 更新组件配置
|
||||
func (s *StatisticsDashboard) UpdateWidgets(widgets string) error {
|
||||
if widgets == "" {
|
||||
return NewValidationError("组件配置不能为空")
|
||||
}
|
||||
|
||||
s.Widgets = widgets
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardWidgetsUpdatedEvent{
|
||||
DashboardID: s.ID,
|
||||
UpdatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// UpdateSettings 更新设置配置
|
||||
func (s *StatisticsDashboard) UpdateSettings(settings string) error {
|
||||
s.Settings = settings
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardSettingsUpdatedEvent{
|
||||
DashboardID: s.ID,
|
||||
UpdatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// UpdateRefreshInterval 更新刷新间隔
|
||||
func (s *StatisticsDashboard) UpdateRefreshInterval(interval int) error {
|
||||
if interval < 30 {
|
||||
return NewValidationError("刷新间隔不能少于30秒")
|
||||
}
|
||||
|
||||
oldInterval := s.RefreshInterval
|
||||
s.RefreshInterval = interval
|
||||
|
||||
// 添加领域事件
|
||||
s.addDomainEvent(&StatisticsDashboardRefreshIntervalUpdatedEvent{
|
||||
DashboardID: s.ID,
|
||||
OldInterval: oldInterval,
|
||||
NewInterval: interval,
|
||||
UpdatedAt: time.Now(),
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// CanBeModified 检查仪表板是否可以被修改
|
||||
func (s *StatisticsDashboard) CanBeModified() bool {
|
||||
return s.IsActive
|
||||
}
|
||||
|
||||
// CanBeDeleted 检查仪表板是否可以被删除
|
||||
func (s *StatisticsDashboard) CanBeDeleted() bool {
|
||||
return !s.IsDefault && s.IsActive
|
||||
}
|
||||
|
||||
// ================ 领域事件管理 ================
|
||||
|
||||
// addDomainEvent 添加领域事件
|
||||
func (s *StatisticsDashboard) addDomainEvent(event interface{}) {
|
||||
if s.domainEvents == nil {
|
||||
s.domainEvents = make([]interface{}, 0)
|
||||
}
|
||||
s.domainEvents = append(s.domainEvents, event)
|
||||
}
|
||||
|
||||
// GetDomainEvents 获取领域事件
|
||||
func (s *StatisticsDashboard) GetDomainEvents() []interface{} {
|
||||
return s.domainEvents
|
||||
}
|
||||
|
||||
// ClearDomainEvents 清除领域事件
|
||||
func (s *StatisticsDashboard) ClearDomainEvents() {
|
||||
s.domainEvents = make([]interface{}, 0)
|
||||
}
|
||||
|
||||
// ================ 领域事件定义 ================
|
||||
|
||||
// StatisticsDashboardCreatedEvent 仪表板创建事件
|
||||
type StatisticsDashboardCreatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
Name string `json:"name"`
|
||||
UserRole string `json:"user_role"`
|
||||
CreatedBy string `json:"created_by"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardSetAsDefaultEvent 仪表板设置为默认事件
|
||||
type StatisticsDashboardSetAsDefaultEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
SetAt time.Time `json:"set_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardRemovedAsDefaultEvent 仪表板取消默认事件
|
||||
type StatisticsDashboardRemovedAsDefaultEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
RemovedAt time.Time `json:"removed_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardActivatedEvent 仪表板激活事件
|
||||
type StatisticsDashboardActivatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
ActivatedAt time.Time `json:"activated_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardDeactivatedEvent 仪表板停用事件
|
||||
type StatisticsDashboardDeactivatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
DeactivatedAt time.Time `json:"deactivated_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardLayoutUpdatedEvent 仪表板布局更新事件
|
||||
type StatisticsDashboardLayoutUpdatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardWidgetsUpdatedEvent 仪表板组件更新事件
|
||||
type StatisticsDashboardWidgetsUpdatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardSettingsUpdatedEvent 仪表板设置更新事件
|
||||
type StatisticsDashboardSettingsUpdatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
// StatisticsDashboardRefreshIntervalUpdatedEvent 仪表板刷新间隔更新事件
|
||||
type StatisticsDashboardRefreshIntervalUpdatedEvent struct {
|
||||
DashboardID string `json:"dashboard_id"`
|
||||
OldInterval int `json:"old_interval"`
|
||||
NewInterval int `json:"new_interval"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user