@stackonward/cli 0.0.1 → 1.0.0

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

@@ -0,0 +1,460 @@
+package audit
+
+// ActorType 操作者类型
+type ActorType string
+
+const (
+	// ActorTypeUser 普通用户（通过产品前端操作）
+	ActorTypeUser ActorType = "user"
+	// ActorTypeAdmin 管理员（通过 Admin Portal 操作）
+	ActorTypeAdmin ActorType = "admin"
+	// ActorTypeSystem 系统自动（定时任务、Webhook 处理）
+	ActorTypeSystem ActorType = "system"
+	// ActorTypeAPIKey API 密钥调用（第三方集成）
+	ActorTypeAPIKey ActorType = "api_key"
+	// ActorTypeWebhook 外部 Webhook 回调（Stripe、Apple 等）
+	ActorTypeWebhook ActorType = "webhook"
+)
+
+// String 返回操作者类型的字符串表示
+func (a ActorType) String() string { return string(a) }
+
+// AuditAction 审计操作动作
+type AuditAction string
+
+const (
+	// ---- 通用 CRUD ----
+
+	// ActionCreate 创建资源
+	ActionCreate AuditAction = "create"
+	// ActionUpdate 更新资源
+	ActionUpdate AuditAction = "update"
+	// ActionDelete 删除资源
+	ActionDelete AuditAction = "delete"
+	// ActionRead 读取资源
+	ActionRead AuditAction = "read"
+	// ActionList 列表查询
+	ActionList AuditAction = "list"
+	// ActionExport 数据导出
+	ActionExport AuditAction = "export"
+
+	// ---- 认证相关 ----
+
+	// ActionLogin 用户登录
+	ActionLogin AuditAction = "login"
+	// ActionLogout 用户登出
+	ActionLogout AuditAction = "logout"
+	// ActionLoginFailed 登录失败
+	ActionLoginFailed AuditAction = "login_failed"
+	// ActionTokenRefresh Token 刷新
+	ActionTokenRefresh AuditAction = "token_refresh"
+	// ActionPasswordChange 密码变更
+	ActionPasswordChange AuditAction = "password_change"
+	// ActionMFAEnable 启用多因素认证
+	ActionMFAEnable AuditAction = "mfa_enable"
+	// ActionMFADisable 禁用多因素认证
+	ActionMFADisable AuditAction = "mfa_disable"
+	// ActionSessionRevoke 会话撤销
+	ActionSessionRevoke AuditAction = "session_revoke"
+	// ActionAccountLink 关联第三方账号
+	ActionAccountLink AuditAction = "account_link"
+	// ActionAccountUnlink 解除第三方账号关联
+	ActionAccountUnlink AuditAction = "account_unlink"
+
+	// ---- 账号状态 ----
+
+	// ActionSuspend 停用账号
+	ActionSuspend AuditAction = "suspend"
+	// ActionReactivate 重新激活账号
+	ActionReactivate AuditAction = "reactivate"
+	// ActionLock 锁定账号
+	ActionLock AuditAction = "lock"
+	// ActionUnlock 解锁账号
+	ActionUnlock AuditAction = "unlock"
+
+	// ---- 商务/订阅 ----
+
+	// ActionRefund 退款
+	ActionRefund AuditAction = "refund"
+	// ActionCancel 取消
+	ActionCancel AuditAction = "cancel"
+	// ActionActivate 激活
+	ActionActivate AuditAction = "activate"
+	// ActionDeactivate 停用业务资源
+	ActionDeactivate AuditAction = "deactivate"
+	// ActionUpgrade 升级
+	ActionUpgrade AuditAction = "upgrade"
+	// ActionDowngrade 降级
+	ActionDowngrade AuditAction = "downgrade"
+	// ActionRenew 续订
+	ActionRenew AuditAction = "renew"
+	// ActionPause 暂停
+	ActionPause AuditAction = "pause"
+	// ActionResume 恢复
+	ActionResume AuditAction = "resume"
+	// ActionExpire 过期
+	ActionExpire AuditAction = "expire"
+	// ActionPay 支付
+	ActionPay AuditAction = "pay"
+	// ActionVoid 作废
+	ActionVoid AuditAction = "void"
+	// ActionAdjust 调账
+	ActionAdjust AuditAction = "adjust"
+	// ActionTopup 充值
+	ActionTopup AuditAction = "topup"
+	// ActionDebit 扣款
+	ActionDebit AuditAction = "debit"
+	// ActionFreeze 冻结余额
+	ActionFreeze AuditAction = "freeze"
+	// ActionUnfreeze 解冻余额
+	ActionUnfreeze AuditAction = "unfreeze"
+	// ActionVerify 验证
+	ActionVerify AuditAction = "verify"
+	// ActionDispute 争议
+	ActionDispute AuditAction = "dispute"
+	// ActionResolve 解决争议
+	ActionResolve AuditAction = "resolve"
+
+	// ---- 内容/通知 ----
+
+	// ActionPublish 发布内容
+	ActionPublish AuditAction = "publish"
+	// ActionArchive 归档
+	ActionArchive AuditAction = "archive"
+	// ActionUpload 上传文件
+	ActionUpload AuditAction = "upload"
+	// ActionDownload 下载文件
+	ActionDownload AuditAction = "download"
+	// ActionSend 发送（邮件/通知）
+	ActionSend AuditAction = "send"
+
+	// ---- 系统/杂项 ----
+
+	// ActionRegister 注册
+	ActionRegister AuditAction = "register"
+	// ActionRequest 发起请求（如数据删除请求）
+	ActionRequest AuditAction = "request"
+	// ActionExecute 执行操作（如 Webhook 处理）
+	ActionExecute AuditAction = "execute"
+	// ActionGenerate 生成（如报告、凭证）
+	ActionGenerate AuditAction = "generate"
+	// ActionGrantQuota 授予配额
+	ActionGrantQuota AuditAction = "grant_quota"
+	// ActionExhaustQuota 耗尽配额
+	ActionExhaustQuota AuditAction = "exhaust_quota"
+)
+
+// String 返回审计操作动作的字符串表示
+func (a AuditAction) String() string { return string(a) }
+
+// AuditCategory 审计业务分类
+type AuditCategory string
+
+const (
+	// CategoryAuth 认证授权
+	CategoryAuth AuditCategory = "auth"
+	// CategoryIdentity 身份管理
+	CategoryIdentity AuditCategory = "identity"
+	// CategoryUser 用户管理
+	CategoryUser AuditCategory = "user"
+	// CategoryCommerce 商务交易
+	CategoryCommerce AuditCategory = "commerce"
+	// CategoryConfig 配置管理
+	CategoryConfig AuditCategory = "config"
+	// CategoryContent 内容管理
+	CategoryContent AuditCategory = "content"
+	// CategoryStorage 存储管理
+	CategoryStorage AuditCategory = "storage"
+	// CategorySystem 系统操作
+	CategorySystem AuditCategory = "system"
+)
+
+// String 返回审计业务分类的字符串表示
+func (c AuditCategory) String() string { return string(c) }
+
+// RiskLevel 风险级别
+type RiskLevel string
+
+const (
+	// RiskLevelCritical 最高风险：数据删除/权限变更/资金操作/数据导出/账号封禁
+	RiskLevelCritical RiskLevel = "critical"
+	// RiskLevelHigh 高风险：创建/认证/配置变更/状态变更
+	RiskLevelHigh RiskLevel = "high"
+	// RiskLevelMedium 中风险：更新/非敏感配置
+	RiskLevelMedium RiskLevel = "medium"
+	// RiskLevelLow 低风险：读取/列表查询
+	RiskLevelLow RiskLevel = "low"
+)
+
+// String 返回风险级别的字符串表示
+func (r RiskLevel) String() string { return string(r) }
+
+// OperationRecordStatus 控制面操作日志记录状态
+type OperationRecordStatus string
+
+const (
+	// OperationRecordStatusStarted 操作已在业务处理前落库
+	OperationRecordStatusStarted OperationRecordStatus = "started"
+	// OperationRecordStatusCompleted 操作已完成并写入响应与授权裁决
+	OperationRecordStatusCompleted OperationRecordStatus = "completed"
+)
+
+// String 返回控制面操作日志记录状态的字符串表示
+func (s OperationRecordStatus) String() string { return string(s) }
+
+// LoginAction 认证动作枚举（用于 sys_login_logs）
+type LoginAction string
+
+const (
+	// LoginActionLogin 用户登录
+	LoginActionLogin LoginAction = "login"
+	// LoginActionLogout 用户登出
+	LoginActionLogout LoginAction = "logout"
+	// LoginActionLoginFailed 登录失败
+	LoginActionLoginFailed LoginAction = "login_failed"
+	// LoginActionPasswordChange 密码变更
+	LoginActionPasswordChange LoginAction = "password_change"
+	// LoginActionMFAEnable 启用多因素认证
+	LoginActionMFAEnable LoginAction = "mfa_enable"
+	// LoginActionMFADisable 禁用多因素认证
+	LoginActionMFADisable LoginAction = "mfa_disable"
+	// LoginActionMFAVerify 验证多因素认证挑战
+	LoginActionMFAVerify LoginAction = "mfa_verify"
+	// LoginActionSessionRevoke 会话撤销
+	LoginActionSessionRevoke LoginAction = "session_revoke"
+	// LoginActionTokenRefresh Token 刷新
+	LoginActionTokenRefresh LoginAction = "token_refresh"
+	// LoginActionRegister 用户注册
+	LoginActionRegister LoginAction = "register"
+	// LoginActionAccountLink 关联第三方账号
+	LoginActionAccountLink LoginAction = "account_link"
+	// LoginActionAccountUnlink 解除第三方账号关联
+	LoginActionAccountUnlink LoginAction = "account_unlink"
+)
+
+// String 返回认证动作的字符串表示
+func (a LoginAction) String() string { return string(a) }
+
+// AuditResource 审计资源类型
+//
+// 用于 sys_audit_logs.resource_type 字段与 AuditMetadataPayload.RelatedResourceType，
+// 供 listener 从 DomainEvent 推导资源归属时使用。所有取值必须 snake_case，与对应
+// 业务聚合的表名/事件命名空间保持一致，禁止散落字面量。
+type AuditResource string
+
+const (
+	// AuditResourceIdentity 身份聚合
+	AuditResourceIdentity AuditResource = "identity"
+	// AuditResourceIdentityGuestCapability 访客能力声明
+	AuditResourceIdentityGuestCapability AuditResource = "identity_guest_capability"
+	// AuditResourceIdentityGuestCapabilityKey 访客能力密钥
+	AuditResourceIdentityGuestCapabilityKey AuditResource = "identity_guest_capability_key"
+	// AuditResourceUser 用户聚合
+	AuditResourceUser AuditResource = "user"
+	// AuditResourceProductUser 产品用户聚合（特定产品下的用户投影）
+	AuditResourceProductUser AuditResource = "product_user"
+	// AuditResourceAdminExperienceSurface 后台体验 Surface 定义。
+	AuditResourceAdminExperienceSurface AuditResource = "admin_experience_surface"
+	// AuditResourceAdminExperienceComponentContract 后台体验组件契约。
+	AuditResourceAdminExperienceComponentContract AuditResource = "admin_experience_component_contract"
+	// AuditResourceMenuRequirement 菜单需求集合。
+	AuditResourceMenuRequirement AuditResource = "menu_requirement"
+	// AuditResourceProductAttributeCatalog 产品属性目录。
+	AuditResourceProductAttributeCatalog AuditResource = "product_attribute_catalog"
+	// AuditResourceProductAttributeValue 产品属性实例。
+	AuditResourceProductAttributeValue AuditResource = "product_attribute_value"
+	// AuditResourceProductCapabilityCatalog 产品能力目录。
+	AuditResourceProductCapabilityCatalog AuditResource = "product_capability_catalog"
+	// AuditResourceOrder 订单聚合
+	AuditResourceOrder AuditResource = "order"
+	// AuditResourceCheckoutSession 结账会话聚合
+	AuditResourceCheckoutSession AuditResource = "checkout_session"
+	// AuditResourcePayment 支付聚合
+	AuditResourcePayment AuditResource = "payment"
+	// AuditResourcePaymentAttempt 支付尝试
+	AuditResourcePaymentAttempt AuditResource = "payment_attempt"
+	// AuditResourcePaymentWebhookEvent 支付 Webhook 事件聚合
+	AuditResourcePaymentWebhookEvent AuditResource = "payment_webhook_event"
+	// AuditResourcePaymentDispute 支付争议
+	AuditResourcePaymentDispute AuditResource = "payment_dispute"
+	// AuditResourceSubscription 订阅聚合
+	AuditResourceSubscription AuditResource = "subscription"
+	// AuditResourceSubscriptionConfig 订阅配置
+	AuditResourceSubscriptionConfig AuditResource = "subscription_config"
+	// AuditResourceInvoice 发票聚合
+	AuditResourceInvoice AuditResource = "invoice"
+	// AuditResourceCreditNote 贷项通知单
+	AuditResourceCreditNote AuditResource = "credit_note"
+	// AuditResourceQuota 配额
+	AuditResourceQuota AuditResource = "quota"
+	// AuditResourceCredit 积分
+	AuditResourceCredit AuditResource = "credit"
+	// AuditResourceStorePurchase 商店购买归属与交易。
+	AuditResourceStorePurchase AuditResource = "store_purchase"
+	// AuditResourceCatalogProduct 商品目录产品
+	AuditResourceCatalogProduct AuditResource = "catalog_product"
+	// AuditResourceCatalogPlan 商品目录套餐
+	AuditResourceCatalogPlan AuditResource = "catalog_plan"
+	// AuditResourceCatalogAddon 商品目录附加包
+	AuditResourceCatalogAddon AuditResource = "catalog_addon"
+	// AuditResourceCatalogPrice 商品目录价格
+	AuditResourceCatalogPrice AuditResource = "catalog_price"
+	// AuditResourceCatalogPriceChangeSet 商品目录改价批次
+	AuditResourceCatalogPriceChangeSet AuditResource = "catalog_price_change_set"
+	// AuditResourceCatalogBundle 商品目录捆绑包
+	AuditResourceCatalogBundle AuditResource = "catalog_bundle"
+	// AuditResourceCommerceCommand 商务命令
+	AuditResourceCommerceCommand AuditResource = "commerce_command"
+	// AuditResourceCheckoutQuote 结算报价
+	AuditResourceCheckoutQuote AuditResource = "checkout_quote"
+	// AuditResourceInventoryReservation 库存预留
+	AuditResourceInventoryReservation AuditResource = "inventory_reservation"
+	// AuditResourceInventoryLedgerEntry 库存流水
+	AuditResourceInventoryLedgerEntry AuditResource = "inventory_ledger_entry"
+	// AuditResourceDeliveryReservation 配送预留
+	AuditResourceDeliveryReservation AuditResource = "delivery_reservation"
+	// AuditResourceDeliveryCapacitySlot 配送运力时段
+	AuditResourceDeliveryCapacitySlot AuditResource = "delivery_capacity_slot"
+	// AuditResourceDeliveryCapacityTemplate 配送运力模板
+	AuditResourceDeliveryCapacityTemplate AuditResource = "delivery_capacity_template"
+	// AuditResourceDeliveryBusinessStatus 配送营业状态
+	AuditResourceDeliveryBusinessStatus AuditResource = "delivery_business_status"
+	// AuditResourceDeliveryCapacityLedgerEntry 配送运力流水
+	AuditResourceDeliveryCapacityLedgerEntry AuditResource = "delivery_capacity_ledger_entry"
+	// AuditResourceFulfillmentOrder 履约单
+	AuditResourceFulfillmentOrder AuditResource = "fulfillment_order"
+	// AuditResourceFulfillmentException 履约异常
+	AuditResourceFulfillmentException AuditResource = "fulfillment_exception"
+	// AuditResourceDeliveryTask 配送任务
+	AuditResourceDeliveryTask AuditResource = "delivery_task"
+	// AuditResourceCampaign 营销触达活动。
+	AuditResourceCampaign AuditResource = "campaign"
+	// AuditResourceCampaignDispatchBatch 营销触达调度批次。
+	AuditResourceCampaignDispatchBatch AuditResource = "campaign_dispatch_batch"
+	// AuditResourceMerchandiseProduct 实物商品
+	AuditResourceMerchandiseProduct AuditResource = "merchandise_product"
+	// AuditResourceMerchandiseSKU 实物商品 SKU
+	AuditResourceMerchandiseSKU AuditResource = "merchandise_sku"
+	// AuditResourceNotification 通知
+	AuditResourceNotification AuditResource = "notification"
+	// AuditResourceNotificationDeadLetter 通知死信记录
+	AuditResourceNotificationDeadLetter AuditResource = "notification_dead_letter"
+	// AuditResourceInboxMessage 站内信
+	AuditResourceInboxMessage AuditResource = "inbox_message"
+	// AuditResourceCoupon 优惠券
+	AuditResourceCoupon AuditResource = "coupon"
+	// AuditResourceFileAsset 文件资产
+	AuditResourceFileAsset AuditResource = "file_asset"
+	// AuditResourceRBACRole 角色
+	AuditResourceRBACRole AuditResource = "rbac_role"
+	// AuditResourceRBACPermission 权限
+	AuditResourceRBACPermission AuditResource = "rbac_permission"
+	// AuditResourceAPIKey API 密钥
+	AuditResourceAPIKey AuditResource = "api_key"
+	// AuditResourceSetting 系统配置
+	AuditResourceSetting AuditResource = "setting"
+	// AuditResourceOAuthConfig OAuth 配置
+	AuditResourceOAuthConfig AuditResource = "oauth_config"
+	// AuditResourceIdentityProviderAppConfig 身份提供方应用配置
+	AuditResourceIdentityProviderAppConfig AuditResource = "identity_provider_app_config"
+	// AuditResourceStorageProvider 存储服务商配置
+	AuditResourceStorageProvider AuditResource = "storage_provider"
+	// AuditResourceProductConfig 产品配置
+	AuditResourceProductConfig AuditResource = "product_config"
+	// AuditResourceProductCapability 产品能力配置
+	AuditResourceProductCapability AuditResource = "product_capability"
+	// AuditResourceAppVersion 应用版本
+	AuditResourceAppVersion AuditResource = "app_version"
+	// AuditResourceArticle 文章
+	AuditResourceArticle AuditResource = "article"
+	// AuditResourceDocumentationSite 企业文档站点
+	AuditResourceDocumentationSite AuditResource = "documentation_site"
+	// AuditResourceDocumentationRelease 企业文档发布
+	AuditResourceDocumentationRelease AuditResource = "documentation_release"
+	// AuditResourceDocumentationProjection 企业文档投影
+	AuditResourceDocumentationProjection AuditResource = "documentation_projection"
+	// AuditResourceDocumentationDeployment 企业文档部署
+	AuditResourceDocumentationDeployment AuditResource = "documentation_deployment"
+	// AuditResourceDocumentationPromotion 企业文档上线与回滚
+	AuditResourceDocumentationPromotion AuditResource = "documentation_promotion"
+	// AuditResourceRedirect 重定向
+	AuditResourceRedirect AuditResource = "redirect"
+	// AuditResourceComment 评论
+	AuditResourceComment AuditResource = "comment"
+	// AuditResourceExport 数据导出
+	AuditResourceExport AuditResource = "export"
+	// AuditResourceMedia 媒体资源
+	AuditResourceMedia AuditResource = "media"
+	// AuditResourceAIModel AI 模型
+	AuditResourceAIModel AuditResource = "ai_model"
+	// AuditResourceAIProvider AI 厂商
+	AuditResourceAIProvider AuditResource = "ai_provider"
+	// AuditResourceAIRouting AI 路由策略
+	AuditResourceAIRouting AuditResource = "ai_routing"
+	// AuditResourcePromptVersion Prompt 版本
+	AuditResourcePromptVersion AuditResource = "prompt_version"
+	// AuditResourceInvestigation 调查单
+	AuditResourceInvestigation AuditResource = "investigation"
+	// AuditResourcePromotionProgram 活动方案
+	AuditResourcePromotionProgram AuditResource = "promotion_program"
+	// AuditResourcePromotionConversion 活动转化
+	AuditResourcePromotionConversion AuditResource = "promotion_conversion"
+	// AuditResourcePromotionReward 活动奖励
+	AuditResourcePromotionReward AuditResource = "promotion_reward"
+	// AuditResourcePromotionParticipant 活动参与者
+	AuditResourcePromotionParticipant AuditResource = "promotion_participant"
+	// AuditResourceIAMPolicy IAM 授权策略
+	AuditResourceIAMPolicy AuditResource = "iam_policy"
+	// AuditResourceIAMPrincipal IAM 授权主体
+	AuditResourceIAMPrincipal AuditResource = "iam_principal"
+	// AuditResourceIAMServiceAccount IAM 服务账号
+	AuditResourceIAMServiceAccount AuditResource = "iam_service_account"
+	// AuditResourceIAMCredential IAM 服务账号凭证
+	AuditResourceIAMCredential AuditResource = "iam_credential"
+	// AuditResourceIAMCredentialTrust IAM 凭证信任边界
+	AuditResourceIAMCredentialTrust AuditResource = "iam_credential_trust"
+	// AuditResourceIAMRole IAM 角色
+	AuditResourceIAMRole AuditResource = "iam_role"
+	// AuditResourceIAMGroup IAM 用户组
+	AuditResourceIAMGroup AuditResource = "iam_group"
+	// AuditResourceIAMBinding IAM 授权绑定（角色绑定 / 策略绑定 / 组成员）
+	AuditResourceIAMBinding AuditResource = "iam_binding"
+	// AuditResourceIAMPageAction IAM 页面动作契约
+	AuditResourceIAMPageAction AuditResource = "iam_page_action"
+	// AuditResourceOutboxEvent Outbox 运维事件
+	AuditResourceOutboxEvent AuditResource = "outbox_event"
+	// AuditResourceIdentitySsoConnection 企业单点登录连接
+	AuditResourceIdentitySsoConnection AuditResource = "identity_sso_connection"
+)
+
+// String 返回审计资源类型的字符串表示
+func (r AuditResource) String() string { return string(r) }
+
+// LoginMethod 登录方式枚举
+type LoginMethod string
+
+const (
+	// LoginMethodPassword 密码登录
+	LoginMethodPassword LoginMethod = "password"
+	// LoginMethodOAuthGoogle Google OAuth 登录
+	LoginMethodOAuthGoogle LoginMethod = "oauth_google"
+	// LoginMethodOAuthApple Apple OAuth 登录
+	LoginMethodOAuthApple LoginMethod = "oauth_apple"
+	// LoginMethodOAuthGitHub GitHub OAuth 登录
+	LoginMethodOAuthGitHub LoginMethod = "oauth_github"
+	// LoginMethodAPIKey API 密钥认证
+	LoginMethodAPIKey LoginMethod = "api_key"
+	// LoginMethodMFATOTP 多因素认证（TOTP）
+	LoginMethodMFATOTP LoginMethod = "mfa_totp"
+	// LoginMethodMFARecoveryCode 多因素认证（恢复码）
+	LoginMethodMFARecoveryCode LoginMethod = "mfa_recovery_code"
+	// LoginMethodMFAWebAuthn 多因素认证（WebAuthn）
+	LoginMethodMFAWebAuthn LoginMethod = "mfa_webauthn"
+	// LoginMethodMFASMS 多因素认证（短信验证码）
+	LoginMethodMFASMS LoginMethod = "mfa_sms"
+	// LoginMethodRefreshToken Refresh Token 刷新
+	LoginMethodRefreshToken LoginMethod = "refresh_token"
+)
+
+// String 返回登录方式的字符串表示
+func (m LoginMethod) String() string { return string(m) }