@stackonward/cli 0.0.1 → 1.0.1

package/dist/resources/templates/go-backend/internal/core/audit/vo_admin.go

@@ -0,0 +1,475 @@
+package audit
+
+import (
+	"time"
+
+	"gorm.io/datatypes"
+
+	"{{module}}/internal/common/types"
+)
+
+// AdminAccessLogResponse 管理端访问日志响应 VO
+type AdminAccessLogResponse struct {
+	// 主键 ID
+	ID int64 `json:"id"`
+	// 分布式追踪 ID
+	TraceID string `json:"trace_id"`
+	// HTTP 请求唯一 ID
+	RequestID string `json:"request_id"`
+	// 操作者类型
+	ActorType string `json:"actor_type"`
+	// 操作者业务用户 ID
+	ActorID types.UserID `json:"actor_id"`
+	// 认证主体类型
+	AuthSubjectType string `json:"auth_subject_type"`
+	// IAM 主体 ID
+	IAMPrincipalID int64 `json:"iam_principal_id"`
+	// IAM 主体显示名
+	PrincipalDisplayName string `json:"principal_display_name,omitempty"`
+	// IAM 主体邮箱
+	PrincipalEmail string `json:"principal_email,omitempty"`
+	// 凭证公开 ID
+	CredentialPublicID string `json:"credential_public_id"`
+	// Token 指纹
+	TokenFingerprint string `json:"token_fingerprint"`
+	// 认证机制
+	AuthMechanism string `json:"auth_mechanism"`
+	// 操作者名称（邮箱）
+	ActorName string `json:"actor_name,omitempty"`
+	// 客户端 IP（部分脱敏）
+	ActorIP string `json:"actor_ip"`
+	// User-Agent（仅详情接口包含）
+	ActorUserAgent string `json:"actor_user_agent,omitempty"`
+	// HTTP 方法
+	HTTPMethod string `json:"http_method"`
+	// 请求路径
+	HTTPPath string `json:"http_path"`
+	// HTTP 状态码
+	HTTPStatus int16 `json:"http_status"`
+	// 产品标识
+	ProductCode string `json:"product_code"`
+	// 资源类型
+	ResourceType string `json:"resource_type"`
+	// 资源 ID
+	ResourceID string `json:"resource_id"`
+	// 资源显示名
+	ResourceDisplayName string `json:"resource_display_name,omitempty"`
+	// 资源关联邮箱
+	ResourceEmail string `json:"resource_email,omitempty"`
+	// 是否成功
+	IsSuccess bool `json:"is_success"`
+	// 错误信息
+	ErrorMessage string `json:"error_message"`
+	// 耗时（毫秒）
+	DurationMS int32 `json:"duration_ms"`
+	// 请求时间
+	CreatedAt time.Time `json:"created_at"`
+}
+
+// ToAdminAccessLogResponse 将 AccessLog Model 转换为管理端响应 VO
+func ToAdminAccessLogResponse(log *AccessLog) *AdminAccessLogResponse {
+	return &AdminAccessLogResponse{
+		ID:                 log.ID,
+		TraceID:            log.TraceID,
+		RequestID:          log.RequestID,
+		ActorType:          string(log.ActorType),
+		ActorID:            log.ActorID,
+		AuthSubjectType:    log.AuthSubjectType,
+		IAMPrincipalID:     log.IAMPrincipalID,
+		CredentialPublicID: log.CredentialPublicID,
+		TokenFingerprint:   log.TokenFingerprint,
+		AuthMechanism:      log.AuthMechanism,
+		ActorIP:            maskIP(log.ActorIP),
+		HTTPMethod:         log.HTTPMethod,
+		HTTPPath:           log.HTTPPath,
+		HTTPStatus:         log.HTTPStatus,
+		ProductCode:        log.ProductCode,
+		ResourceType:       log.ResourceType,
+		ResourceID:         log.ResourceID,
+		IsSuccess:          log.IsSuccess,
+		ErrorMessage:       log.ErrorMessage,
+		DurationMS:         log.DurationMS,
+		CreatedAt:          log.CreatedAt,
+	}
+}
+
+// ToAdminAccessLogDetailResponse 将 AccessLog Model 转换为管理端详情响应 VO。
+func ToAdminAccessLogDetailResponse(log *AccessLog) *AdminAccessLogResponse {
+	resp := ToAdminAccessLogResponse(log)
+	resp.ActorUserAgent = log.ActorUserAgent
+	return resp
+}
+
+// AdminAuditLogResponse 管理端审计日志响应 VO
+type AdminAuditLogResponse struct {
+	// 主键 ID
+	ID int64 `json:"id"`
+	// 领域事件唯一标识
+	EventID *string `json:"event_id,omitempty"`
+	// 领域事件发生时间
+	OccurredAt *time.Time `json:"occurred_at,omitempty"`
+	// 分布式追踪 ID
+	TraceID string `json:"trace_id"`
+	// 关联的 HTTP 请求 ID
+	RequestID string `json:"request_id"`
+	// 操作者类型
+	ActorType string `json:"actor_type"`
+	// 操作者业务用户 ID
+	ActorID types.UserID `json:"actor_id"`
+	// 认证主体类型
+	AuthSubjectType string `json:"auth_subject_type"`
+	// IAM 主体 ID
+	IAMPrincipalID int64 `json:"iam_principal_id"`
+	// IAM 主体显示名
+	PrincipalDisplayName string `json:"principal_display_name,omitempty"`
+	// IAM 主体邮箱
+	PrincipalEmail string `json:"principal_email,omitempty"`
+	// 凭证公开 ID
+	CredentialPublicID string `json:"credential_public_id"`
+	// Token 指纹
+	TokenFingerprint string `json:"token_fingerprint"`
+	// 认证机制
+	AuthMechanism string `json:"auth_mechanism"`
+	// 操作者名称（邮箱）
+	ActorName string `json:"actor_name,omitempty"`
+	// 客户端 IP（部分脱敏）
+	ActorIP string `json:"actor_ip"`
+	// User-Agent（详情接口或 include_payload 列表包含）
+	ActorUserAgent string `json:"actor_user_agent,omitempty"`
+	// 操作动作
+	Action string `json:"action"`
+	// 业务分类
+	Category string `json:"category"`
+	// 风险级别
+	RiskLevel string `json:"risk_level"`
+	// 资源类型
+	ResourceType string `json:"resource_type"`
+	// 资源 ID
+	ResourceID string `json:"resource_id"`
+	// 资源显示名
+	ResourceDisplayName string `json:"resource_display_name,omitempty"`
+	// 资源关联邮箱
+	ResourceEmail string `json:"resource_email,omitempty"`
+	// 产品标识
+	ProductCode string `json:"product_code"`
+	// 租户 ID
+	TenantID string `json:"tenant_id"`
+	// 变更详情（详情接口或 include_payload 列表包含）
+	Changes datatypes.JSON `json:"changes,omitempty"`
+	// 扩展元数据（详情接口或 include_payload 列表包含）
+	Metadata datatypes.JSON `json:"metadata,omitempty"`
+	// 是否成功
+	IsSuccess bool `json:"is_success"`
+	// 错误信息
+	ErrorMessage string `json:"error_message"`
+	// 创建时间
+	CreatedAt time.Time `json:"created_at"`
+}
+
+// ToAdminAuditLogResponse 将 AuditLog Model 转换为管理端列表响应 VO
+func ToAdminAuditLogResponse(log *AuditLog) *AdminAuditLogResponse {
+	return &AdminAuditLogResponse{
+		ID:                 log.ID,
+		EventID:            log.EventID,
+		OccurredAt:         log.OccurredAt,
+		TraceID:            log.TraceID,
+		RequestID:          log.RequestID,
+		ActorType:          string(log.ActorType),
+		ActorID:            log.ActorID,
+		AuthSubjectType:    log.AuthSubjectType,
+		IAMPrincipalID:     log.IAMPrincipalID,
+		CredentialPublicID: log.CredentialPublicID,
+		TokenFingerprint:   log.TokenFingerprint,
+		AuthMechanism:      log.AuthMechanism,
+		ActorIP:            maskIP(log.ActorIP),
+		ActorUserAgent:     log.ActorUserAgent,
+		Action:             string(log.Action),
+		Category:           string(log.Category),
+		RiskLevel:          string(log.RiskLevel),
+		ResourceType:       log.ResourceType,
+		ResourceID:         log.ResourceID,
+		ProductCode:        log.ProductCode,
+		TenantID:           log.TenantID,
+		Changes:            log.Changes,
+		Metadata:           log.Metadata,
+		IsSuccess:          log.IsSuccess,
+		ErrorMessage:       log.ErrorMessage,
+		CreatedAt:          log.CreatedAt,
+	}
+}
+
+// ToAdminAuditLogDetailResponse 管理端审计日志详情响应（含 changes、metadata、user_agent）
+func ToAdminAuditLogDetailResponse(log *AuditLog) *AdminAuditLogResponse {
+	resp := ToAdminAuditLogResponse(log)
+	return resp
+}
+
+// AdminLoginLogResponse 管理端登录日志响应 VO
+type AdminLoginLogResponse struct {
+	// 主键 ID
+	ID int64 `json:"id"`
+	// 认证身份 ID
+	IdentityID types.IdentityID `json:"identity_id"`
+	// 关联用户邮箱
+	ActorName string `json:"actor_name,omitempty"`
+	// 身份邮箱
+	IdentityEmail string `json:"identity_email,omitempty"`
+	// 身份账号显示名
+	IdentityDisplayName string `json:"identity_display_name,omitempty"`
+	// 操作者类型
+	ActorType string `json:"actor_type"`
+	// 客户端 IP（部分脱敏）
+	ActorIP string `json:"actor_ip"`
+	// User-Agent（仅详情接口包含）
+	ActorUserAgent string `json:"actor_user_agent,omitempty"`
+	// 认证动作
+	LoginAction string `json:"login_action"`
+	// 登录方式
+	LoginMethod string `json:"login_method"`
+	// 是否成功
+	IsSuccess bool `json:"is_success"`
+	// 失败原因
+	FailureReason string `json:"failure_reason"`
+	// 产品标识
+	ProductCode string `json:"product_code"`
+	// 会话 ID
+	SessionID string `json:"session_id"`
+	// 请求 ID
+	RequestID string `json:"request_id"`
+	// 设备类型
+	DeviceType string `json:"device_type"`
+	// 设备指纹哈希
+	DeviceFingerprint string `json:"device_fingerprint"`
+	// 操作系统
+	OSName string `json:"os_name"`
+	// 浏览器
+	BrowserName string `json:"browser_name"`
+	// 国家代码
+	GeoCountry string `json:"geo_country"`
+	// 城市
+	GeoCity string `json:"geo_city"`
+	// 事件时间
+	CreatedAt time.Time `json:"created_at"`
+}
+
+// ToAdminLoginLogResponse 将 LoginLog Model 转换为管理端响应 VO
+func ToAdminLoginLogResponse(log *LoginLog) *AdminLoginLogResponse {
+	return &AdminLoginLogResponse{
+		ID:                log.ID,
+		IdentityID:        log.IdentityID,
+		ActorType:         string(log.ActorType),
+		ActorIP:           maskIP(log.ActorIP),
+		LoginAction:       string(log.LoginAction),
+		LoginMethod:       string(log.LoginMethod),
+		IsSuccess:         log.IsSuccess,
+		FailureReason:     log.FailureReason,
+		ProductCode:       log.ProductCode,
+		SessionID:         log.SessionID,
+		RequestID:         log.RequestID,
+		DeviceType:        log.DeviceType,
+		DeviceFingerprint: log.DeviceFingerprint,
+		OSName:            log.OSName,
+		BrowserName:       log.BrowserName,
+		GeoCountry:        log.GeoCountry,
+		GeoCity:           log.GeoCity,
+		CreatedAt:         log.CreatedAt,
+	}
+}
+
+// ToAdminLoginLogDetailResponse 将 LoginLog Model 转换为管理端详情响应 VO。
+func ToAdminLoginLogDetailResponse(log *LoginLog) *AdminLoginLogResponse {
+	resp := ToAdminLoginLogResponse(log)
+	resp.ActorUserAgent = log.ActorUserAgent
+	resp.DeviceFingerprint = log.DeviceFingerprint
+	return resp
+}
+
+// AdminOperationLogResponse 管理端操作日志响应 VO
+type AdminOperationLogResponse struct {
+	// 主键 ID
+	ID int64 `json:"id"`
+	// 分布式追踪 ID
+	TraceID string `json:"trace_id"`
+	// HTTP 请求唯一 ID
+	RequestID string `json:"request_id"`
+	// 操作者类型
+	ActorType string `json:"actor_type"`
+	// 操作者业务用户 ID
+	ActorID types.UserID `json:"actor_id"`
+	// 认证主体类型
+	AuthSubjectType string `json:"auth_subject_type"`
+	// IAM 主体 ID
+	IAMPrincipalID int64 `json:"iam_principal_id"`
+	// IAM 主体显示名
+	PrincipalDisplayName string `json:"principal_display_name,omitempty"`
+	// IAM 主体邮箱
+	PrincipalEmail string `json:"principal_email,omitempty"`
+	// 凭证公开 ID
+	CredentialPublicID string `json:"credential_public_id"`
+	// Token 指纹
+	TokenFingerprint string `json:"token_fingerprint"`
+	// 认证机制
+	AuthMechanism string `json:"auth_mechanism"`
+	// 操作者名称（邮箱）
+	ActorName string `json:"actor_name,omitempty"`
+	// 客户端 IP（部分脱敏）
+	ActorIP string `json:"actor_ip"`
+	// User-Agent（仅详情接口包含）
+	ActorUserAgent string `json:"actor_user_agent,omitempty"`
+	// 操作动作
+	OperationAction string `json:"operation_action"`
+	// 操作分类
+	OperationCategory string `json:"operation_category"`
+	// 风险级别
+	RiskLevel string `json:"risk_level"`
+	// 来源模块
+	SourceModule string `json:"source_module"`
+	// IAM 动作
+	IAMAction string `json:"iam_action"`
+	// IAM 资源
+	IAMResource string `json:"iam_resource"`
+	// 授权是否允许
+	DecisionAllowed bool `json:"decision_allowed"`
+	// 授权原因码
+	DecisionReasonCode string `json:"decision_reason_code"`
+	// 授权原因类别
+	DecisionReasonKind string `json:"decision_reason_kind"`
+	// HTTP 方法
+	HTTPMethod string `json:"http_method"`
+	// 请求路径
+	HTTPPath string `json:"http_path"`
+	// HTTP 状态码
+	HTTPStatus int16 `json:"http_status"`
+	// 耗时（毫秒）
+	DurationMS int32 `json:"duration_ms"`
+	// 产品标识
+	ProductCode string `json:"product_code"`
+	// 租户 ID
+	TenantID string `json:"tenant_id"`
+	// 资源类型
+	ResourceType string `json:"resource_type"`
+	// 资源 ID
+	ResourceID string `json:"resource_id"`
+	// 资源显示名
+	ResourceDisplayName string `json:"resource_display_name,omitempty"`
+	// 资源关联邮箱
+	ResourceEmail string `json:"resource_email,omitempty"`
+	// 是否成功
+	IsSuccess bool `json:"is_success"`
+	// 错误信息
+	ErrorMessage string `json:"error_message"`
+	// 记录状态
+	RecordStatus string `json:"record_status"`
+	// 请求证据上下文
+	RequestContext datatypes.JSON `json:"request_context,omitempty"`
+	// 响应证据上下文
+	ResponseContext datatypes.JSON `json:"response_context,omitempty"`
+	// 操作元数据
+	OperationMetadata datatypes.JSON `json:"operation_metadata,omitempty"`
+	// 策略裁决上下文
+	PolicyViolation datatypes.JSON `json:"policy_violation,omitempty"`
+	// 完成时间
+	CompletedAt *time.Time `json:"completed_at"`
+	// 创建时间
+	CreatedAt time.Time `json:"created_at"`
+}
+
+// ToAdminOperationLogResponse 将 OperationLog Model 转换为管理端列表响应 VO。
+func ToAdminOperationLogResponse(log *OperationLog) *AdminOperationLogResponse {
+	return &AdminOperationLogResponse{
+		ID:                 log.ID,
+		TraceID:            log.TraceID,
+		RequestID:          log.RequestID,
+		ActorType:          string(log.ActorType),
+		ActorID:            log.ActorID,
+		AuthSubjectType:    log.AuthSubjectType,
+		IAMPrincipalID:     log.IAMPrincipalID,
+		CredentialPublicID: log.CredentialPublicID,
+		TokenFingerprint:   log.TokenFingerprint,
+		AuthMechanism:      log.AuthMechanism,
+		ActorIP:            maskIP(log.ActorIP),
+		OperationAction:    string(log.OperationAction),
+		OperationCategory:  string(log.OperationCategory),
+		RiskLevel:          string(log.RiskLevel),
+		SourceModule:       log.SourceModule,
+		IAMAction:          log.IAMAction,
+		IAMResource:        log.IAMResource,
+		DecisionAllowed:    log.DecisionAllowed,
+		DecisionReasonCode: log.DecisionReasonCode,
+		DecisionReasonKind: log.DecisionReasonKind,
+		HTTPMethod:         log.HTTPMethod,
+		HTTPPath:           log.HTTPPath,
+		HTTPStatus:         log.HTTPStatus,
+		DurationMS:         log.DurationMS,
+		ProductCode:        log.ProductCode,
+		TenantID:           log.TenantID,
+		ResourceType:       log.ResourceType,
+		ResourceID:         log.ResourceID,
+		IsSuccess:          log.IsSuccess,
+		ErrorMessage:       log.ErrorMessage,
+		RecordStatus:       log.RecordStatus,
+		CompletedAt:        log.CompletedAt,
+		CreatedAt:          log.CreatedAt,
+	}
+}
+
+// ToAdminOperationLogDetailResponse 将 OperationLog Model 转换为管理端详情响应 VO。
+func ToAdminOperationLogDetailResponse(log *OperationLog) *AdminOperationLogResponse {
+	resp := ToAdminOperationLogResponse(log)
+	resp.ActorUserAgent = log.ActorUserAgent
+	resp.RequestContext = log.RequestContext
+	resp.ResponseContext = log.ResponseContext
+	resp.OperationMetadata = log.OperationMetadata
+	resp.PolicyViolation = log.PolicyViolation
+	return resp
+}
+
+// StatsResponse 统计响应
+type StatsResponse struct {
+	// 统计时间段
+	Period struct {
+		From time.Time `json:"from"`
+		To   time.Time `json:"to"`
+	} `json:"period"`
+	// 总计
+	Total int64 `json:"total"`
+	// 按分类统计
+	ByCategory []CategoryCount `json:"by_category"`
+	// 按风险级别统计
+	ByRiskLevel []RiskLevelCount `json:"by_risk_level"`
+}
+
+// ExportTaskResponse 导出任务响应
+type ExportTaskResponse struct {
+	// 任务 ID
+	TaskID string `json:"task_id"`
+	// 状态：pending/processing/completed/failed
+	Status string `json:"status"`
+	// 预估行数
+	EstimatedRows int64 `json:"estimated_rows,omitempty"`
+	// 实际行数
+	RowCount int64 `json:"row_count,omitempty"`
+	// 文件大小（字节）
+	FileSizeBytes int64 `json:"file_size_bytes,omitempty"`
+	// 下载地址
+	DownloadURL string `json:"download_url,omitempty"`
+	// 下载地址有效期
+	ExpiresAt *time.Time `json:"expires_at,omitempty"`
+	// 创建时间
+	CreatedAt time.Time `json:"created_at"`
+	// 完成时间
+	CompletedAt *time.Time `json:"completed_at,omitempty"`
+}
+
+// maskIP 对 IP 地址进行部分脱敏（保留前段，最后一段替换为 x）
+func maskIP(ip string) string {
+	if ip == "" {
+		return ""
+	}
+	for i := len(ip) - 1; i >= 0; i-- {
+		if ip[i] == '.' || ip[i] == ':' {
+			return ip[:i+1] + "x"
+		}
+	}
+	return ip
+}

package/dist/resources/templates/go-backend/internal/core/cache/config.go

@@ -0,0 +1,30 @@
+package cache
+
+import "time"
+
+// ManagerConfig CacheManager 全局配置
+type ManagerConfig struct {
+	// L1 本地缓存配置
+	L1 L1Config
+}
+
+// L1Config L1 本地缓存配置
+type L1Config struct {
+	// 最大条目数（默认 10000）
+	MaxItems int64
+	// 默认 TTL（默认 60s，L1 必须短于 L2）
+	DefaultTTL time.Duration
+	// 是否启用（默认 true）
+	Enabled bool
+}
+
+// DefaultManagerConfig 默认配置
+func DefaultManagerConfig() *ManagerConfig {
+	return &ManagerConfig{
+		L1: L1Config{
+			MaxItems:   10000,
+			DefaultTTL: 60 * time.Second,
+			Enabled:    true,
+		},
+	}
+}

package/dist/resources/templates/go-backend/internal/core/cache/key.go

@@ -0,0 +1,41 @@
+package cache
+
+import (
+	"strconv"
+	"strings"
+)
+
+// Key 缓存键构造器
+//
+// 统一缓存键格式：{module}:{entity}:{identifier}[:{qualifier}]
+//
+// 用法:
+//
+//	cache.NewKey("identity", "session").ID(42).Build()          // => "identity:session:42"
+//	cache.NewKey("apikey", "key").Str(hash).Build()             // => "apikey:key:abc123"
+//	cache.NewKey("appversion", "config").Str(p).Str(plat).Build() // => "appversion:config:ai_chat:ios"
+type Key struct {
+	parts []string
+}
+
+// NewKey 创建缓存键
+func NewKey(module, entity string) *Key {
+	return &Key{parts: []string{module, entity}}
+}
+
+// ID 追加 int64 标识符
+func (k *Key) ID(id int64) *Key {
+	k.parts = append(k.parts, strconv.FormatInt(id, 10))
+	return k
+}
+
+// Str 追加字符串标识符
+func (k *Key) Str(s string) *Key {
+	k.parts = append(k.parts, s)
+	return k
+}
+
+// Build 构建最终缓存键
+func (k *Key) Build() string {
+	return strings.Join(k.parts, ":")
+}

package/dist/resources/templates/go-backend/internal/core/cache/key_test.go

@@ -0,0 +1,62 @@
+package cache
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestNewKey_ModuleAndEntity(t *testing.T) {
+	key := NewKey("identity", "session").Build()
+	assert.Equal(t, "identity:session", key)
+}
+
+func TestKey_ID(t *testing.T) {
+	key := NewKey("identity", "session").ID(42).Build()
+	assert.Equal(t, "identity:session:42", key)
+}
+
+func TestKey_IDZero(t *testing.T) {
+	key := NewKey("order", "item").ID(0).Build()
+	assert.Equal(t, "order:item:0", key)
+}
+
+func TestKey_IDNegative(t *testing.T) {
+	key := NewKey("order", "item").ID(-1).Build()
+	assert.Equal(t, "order:item:-1", key)
+}
+
+func TestKey_Str(t *testing.T) {
+	key := NewKey("apikey", "key").Str("abc123").Build()
+	assert.Equal(t, "apikey:key:abc123", key)
+}
+
+func TestKey_MultipleStr(t *testing.T) {
+	key := NewKey("appversion", "config").Str("ai_chat").Str("ios").Build()
+	assert.Equal(t, "appversion:config:ai_chat:ios", key)
+}
+
+func TestKey_MixedIDAndStr(t *testing.T) {
+	key := NewKey("product", "user").ID(99).Str("profile").Build()
+	assert.Equal(t, "product:user:99:profile", key)
+}
+
+func TestKey_EmptyStrPart(t *testing.T) {
+	// 空字符串段仍应被加入（调用方负责传入有效值）
+	key := NewKey("mod", "ent").Str("").Build()
+	assert.Equal(t, "mod:ent:", key)
+}
+
+func TestKey_ChainReturnsSameInstance(t *testing.T) {
+	k := NewKey("a", "b")
+	k2 := k.ID(1)
+	// 链式调用返回同一指针
+	assert.Same(t, k, k2)
+}
+
+func TestKey_BuildIsIdempotent(t *testing.T) {
+	k := NewKey("x", "y").Str("z")
+	first := k.Build()
+	second := k.Build()
+	assert.Equal(t, first, second)
+}