@stackonward/cli 0.0.1 → 1.0.0

package/dist/resources/templates/go-backend/internal/common/tradeno/prefix.go

@@ -0,0 +1,247 @@
+package tradeno
+
+// Prefix 业务编号前缀（小写 + 下划线分隔）
+type Prefix string
+
+const (
+	// PrefixOrder 订单
+	PrefixOrder Prefix = "ord"
+	// PrefixCart 购物车
+	PrefixCart Prefix = "crt"
+	// PrefixCartItem 购物车项
+	PrefixCartItem Prefix = "cti"
+	// PrefixCartItemAttribute 购物车项属性
+	PrefixCartItemAttribute Prefix = "cia"
+	// PrefixCartMutationEvent 购物车命令证据
+	PrefixCartMutationEvent Prefix = "cme"
+	// PrefixCheckoutQuote 结账报价
+	PrefixCheckoutQuote Prefix = "cqt"
+	// PrefixCheckoutQuoteItem 结账报价项
+	PrefixCheckoutQuoteItem Prefix = "cqi"
+	// PrefixCheckoutQuoteAdjustment 结账报价调整
+	PrefixCheckoutQuoteAdjustment Prefix = "cqa"
+	// PrefixCheckoutQuoteReservation 结账报价预留
+	PrefixCheckoutQuoteReservation Prefix = "cqr"
+	// PrefixCheckoutQuoteEvent 结账报价事件
+	PrefixCheckoutQuoteEvent Prefix = "cqe"
+	// PrefixCheckoutQuoteDeliveryLine 结账报价配送费用行
+	PrefixCheckoutQuoteDeliveryLine Prefix = "cdl"
+	// PrefixCheckoutQuoteTaxLine 结账报价税费行
+	PrefixCheckoutQuoteTaxLine Prefix = "ctx"
+	// PrefixCatalogPurchaseOption 目录购买选项
+	PrefixCatalogPurchaseOption Prefix = "pto"
+	// PrefixMarketingPromotion 营销促销活动
+	PrefixMarketingPromotion Prefix = "prm"
+	// PrefixMarketingCoupon 营销优惠券
+	PrefixMarketingCoupon Prefix = "cpn"
+	// PrefixPayment 支付
+	PrefixPayment Prefix = "pay"
+	// PrefixBillingAccount 付款账户
+	PrefixBillingAccount Prefix = "bac"
+	// PrefixCheckoutSession 结账会话
+	PrefixCheckoutSession Prefix = "chs"
+	// PrefixCheckoutExecution 结账执行
+	PrefixCheckoutExecution Prefix = "chex"
+	// PrefixCheckoutFulfillment 结账履约
+	PrefixCheckoutFulfillment Prefix = "chf"
+	// PrefixCheckoutCompensation 结账补偿
+	PrefixCheckoutCompensation Prefix = "chc"
+	// PrefixPaymentProviderCommand 支付渠道命令
+	PrefixPaymentProviderCommand Prefix = "pcmd"
+	// PrefixPaymentProviderResource 支付渠道资源
+	PrefixPaymentProviderResource Prefix = "pres"
+	// PrefixPaymentCredential 支付凭据
+	PrefixPaymentCredential Prefix = "pcred"
+	// PrefixPaymentAuthorizationGrant 合同支付授权
+	PrefixPaymentAuthorizationGrant Prefix = "pag"
+	// PrefixPaymentDispute 支付争议
+	PrefixPaymentDispute Prefix = "dsp"
+	// PrefixPaymentDisputeEvidence 支付争议证据
+	PrefixPaymentDisputeEvidence Prefix = "dse"
+	// PrefixPaymentDisputeAction 支付争议动作
+	PrefixPaymentDisputeAction Prefix = "dsa"
+	// PrefixPaymentRiskBlock 支付风控封禁
+	PrefixPaymentRiskBlock Prefix = "prb"
+	// PrefixPaymentRiskSignal 支付风控信号
+	PrefixPaymentRiskSignal Prefix = "prs"
+	// PrefixPaymentRiskProfile 支付风控画像
+	PrefixPaymentRiskProfile Prefix = "prp"
+	// PrefixPaymentProviderHealth 支付渠道健康快照
+	PrefixPaymentProviderHealth Prefix = "pph"
+	// PrefixPaymentRoutingDecision 支付路由决策
+	PrefixPaymentRoutingDecision Prefix = "prd"
+	// PrefixRefund 退款
+	PrefixRefund Prefix = "ref"
+	// PrefixRefundAdjustment 退款追加调整
+	PrefixRefundAdjustment Prefix = "rad"
+	// PrefixTransaction 交易流水
+	PrefixTransaction Prefix = "txn"
+	// PrefixSubscription 订阅
+	PrefixSubscription Prefix = "sub"
+	// PrefixSubscriptionContractOwnership 订阅合同资格占用
+	PrefixSubscriptionContractOwnership Prefix = "pcown"
+	// PrefixBenefitUpgradeQuote 升级权益报价
+	PrefixBenefitUpgradeQuote Prefix = "buq"
+	// PrefixCreditTopUpOfferWindow 积分充值活动窗口
+	PrefixCreditTopUpOfferWindow Prefix = "ctw"
+	// PrefixCreditTopUpOfferQuote 积分充值活动报价
+	PrefixCreditTopUpOfferQuote Prefix = "ctq"
+	// PrefixInventoryStockItem 库存项
+	PrefixInventoryStockItem Prefix = "isi"
+	// PrefixInventoryStockLevel 库存水位
+	PrefixInventoryStockLevel Prefix = "isl"
+	// PrefixInventoryReservation 库存预留
+	PrefixInventoryReservation Prefix = "irs"
+	// PrefixInventoryLedger 库存流水
+	PrefixInventoryLedger Prefix = "ilg"
+	// PrefixInventoryAdjustment 库存调整单
+	PrefixInventoryAdjustment Prefix = "iadj"
+	// PrefixInventoryStocktake 库存盘点单
+	PrefixInventoryStocktake Prefix = "ist"
+	// PrefixInventoryTransfer 库存调拨单
+	PrefixInventoryTransfer Prefix = "itf"
+	// PrefixInventoryAlertHit 库存预警命中
+	PrefixInventoryAlertHit Prefix = "iah"
+	// PrefixFulfillmentOrder 履约单
+	PrefixFulfillmentOrder Prefix = "ful"
+	// PrefixFulfillmentOrderItem 履约单项
+	PrefixFulfillmentOrderItem Prefix = "foi"
+	// PrefixFulfillmentEvent 履约事件
+	PrefixFulfillmentEvent Prefix = "fev"
+	// PrefixFulfillmentException 履约异常
+	PrefixFulfillmentException Prefix = "fex"
+	// PrefixPickupCode 自提核销码内部记录号（内部公开号 SH-I1，区别于客户面 4 位取货码）
+	PrefixPickupCode Prefix = "pkc"
+	// PrefixDeliveryCapacitySlot 配送容量槽
+	PrefixDeliveryCapacitySlot Prefix = "dcs"
+	// PrefixDeliveryCapacityRule 配送容量规则
+	PrefixDeliveryCapacityRule Prefix = "dcr"
+	// PrefixDeliveryCapacityLedger 配送容量流水
+	PrefixDeliveryCapacityLedger Prefix = "dcl"
+	// PrefixDeliveryCapacityTemplate 配送容量模板
+	PrefixDeliveryCapacityTemplate Prefix = "dct"
+	// PrefixDeliveryCapacityTemplateRevision 配送容量模板版本
+	PrefixDeliveryCapacityTemplateRevision Prefix = "dcv"
+	// PrefixDeliveryCalendarAnnotation 配送日历标注
+	PrefixDeliveryCalendarAnnotation Prefix = "dca"
+	// PrefixDeliveryBusinessStatusOverride 配送营业状态覆盖
+	PrefixDeliveryBusinessStatusOverride Prefix = "dbs"
+	// PrefixDeliveryBusinessStatusEvent 配送营业状态事件
+	PrefixDeliveryBusinessStatusEvent Prefix = "dbe"
+	// PrefixDeliveryReservation 配送预留
+	PrefixDeliveryReservation Prefix = "drv"
+	// PrefixDeliveryTask 配送任务
+	PrefixDeliveryTask Prefix = "dtk"
+	// PrefixDeliveryTaskEvent 配送任务事件
+	PrefixDeliveryTaskEvent Prefix = "dte"
+	// PrefixDeliveryFeePolicy 配送费策略
+	PrefixDeliveryFeePolicy Prefix = "dfp"
+	// PrefixShipment 快递物流单内部公开号
+	PrefixShipment Prefix = "shp"
+	// PrefixTrackingEvent 快递物流轨迹事件
+	PrefixTrackingEvent Prefix = "tre"
+	// PrefixOrderNote 订单内部备注
+	PrefixOrderNote Prefix = "ont"
+	// PrefixDiscoveryDisplayRelease 发现陈列展示面发布版本
+	PrefixDiscoveryDisplayRelease Prefix = "ddr"
+	// PrefixDiscoveryDisplayDraft 发现陈列展示面草稿工作区
+	PrefixDiscoveryDisplayDraft Prefix = "ddd"
+	// PrefixDiscoveryPublicationChannel 发现陈列发布渠道
+	PrefixDiscoveryPublicationChannel Prefix = "dpc"
+	// PrefixDiscoveryPublicationSchedule 发现陈列发布计划
+	PrefixDiscoveryPublicationSchedule Prefix = "dps"
+	// PrefixDocumentationRelease 文档发布候选
+	PrefixDocumentationRelease Prefix = "drl"
+	// PrefixDocumentationApprovalPolicy 文档审批策略谱系
+	PrefixDocumentationApprovalPolicy Prefix = "dap"
+	// PrefixDocumentationApprovalDecision 文档审批决定
+	PrefixDocumentationApprovalDecision Prefix = "dad"
+	// PrefixDocumentationProjectionGeneration 文档投影任务
+	PrefixDocumentationProjectionGeneration Prefix = "dpg"
+	// PrefixDocumentationSiteRevision 文档站修订
+	PrefixDocumentationSiteRevision Prefix = "dsr"
+	// PrefixDocumentationDeployment 文档区域部署
+	PrefixDocumentationDeployment Prefix = "ddp"
+	// PrefixDocumentationPromotion 文档流量切换
+	PrefixDocumentationPromotion Prefix = "dpm"
+	// PrefixDocumentationAnswerRun 文档 AI 回答运行
+	PrefixDocumentationAnswerRun Prefix = "dar"
+	// PrefixDocumentationRuntimeEvent 文档搜索与反馈事件
+	PrefixDocumentationRuntimeEvent Prefix = "dre"
+	// PrefixAPIContractCommitment API 契约支持承诺
+	PrefixAPIContractCommitment Prefix = "acm"
+	// PrefixAPIContractEvent API 契约生命周期事件
+	PrefixAPIContractEvent Prefix = "ace"
+	// PrefixAPIContractPublication API 契约发布许可
+	PrefixAPIContractPublication Prefix = "acp"
+	// PrefixProductClientApplication 产品第一方客户端应用
+	PrefixProductClientApplication Prefix = "pca"
+	// PrefixClientApplicationIdentifier 客户端平台稳定标识
+	PrefixClientApplicationIdentifier Prefix = "cai"
+	// PrefixAppVersionRelease 客户端 Release
+	PrefixAppVersionRelease Prefix = "avr"
+	// PrefixAppVersionDistributionChannel 客户端分发渠道
+	PrefixAppVersionDistributionChannel Prefix = "avc"
+	// PrefixAppVersionReleaseAvailability Release 渠道可获得事实
+	PrefixAppVersionReleaseAvailability Prefix = "ava"
+	// PrefixAppVersionSupportPolicy 客户端支持政策
+	PrefixAppVersionSupportPolicy Prefix = "asp"
+	// PrefixFeatureFlag Feature Flag 定义
+	PrefixFeatureFlag Prefix = "ffl"
+	// PrefixFeatureFlagPublication Feature Flag 发布事实
+	PrefixFeatureFlagPublication Prefix = "ffp"
+	// PrefixUser 用户外部可见 ID
+	PrefixUser Prefix = "usr"
+	// PrefixStorageAsset 存储资产公共引用
+	PrefixStorageAsset Prefix = "ast"
+	// PrefixStorageUploadSession 存储上传会话公共引用
+	PrefixStorageUploadSession Prefix = "upl"
+	// PrefixStorageAssetReference 存储资产引用公共引用
+	PrefixStorageAssetReference Prefix = "aref"
+	// PrefixExportTask 导出任务公共引用
+	PrefixExportTask Prefix = "ext"
+	// PrefixIAMAuthorizationDecision IAM 授权决策审计引用
+	PrefixIAMAuthorizationDecision Prefix = "iad"
+	// PrefixOrganization 组织公共引用
+	PrefixOrganization Prefix = "org"
+	// PrefixOrganizationProductEnrollment 组织产品准入公共引用
+	PrefixOrganizationProductEnrollment Prefix = "ope"
+	// PrefixOrganizationMembership 组织成员关系公共引用
+	PrefixOrganizationMembership Prefix = "omb"
+	// PrefixOrganizationInvitation 组织邀请公共引用
+	PrefixOrganizationInvitation Prefix = "oinv"
+	// PrefixOrganizationTeam 组织团队公共引用
+	PrefixOrganizationTeam Prefix = "otm"
+	// PrefixOrganizationVerifiedDomain 组织验证域名公共引用
+	PrefixOrganizationVerifiedDomain Prefix = "odm"
+	// PrefixOrganizationDomainChallenge 组织域名验证挑战公共引用
+	PrefixOrganizationDomainChallenge Prefix = "odc"
+	// PrefixIdentitySSOConnection 企业单点登录连接公共引用
+	PrefixIdentitySSOConnection Prefix = "isc"
+	// PrefixIdentitySCIMUser 企业身份供应用户资源公共引用
+	PrefixIdentitySCIMUser Prefix = "isu"
+	// PrefixIdentitySCIMGroup 企业身份供应团队资源公共引用
+	PrefixIdentitySCIMGroup Prefix = "isg"
+	// PrefixIAMPrincipal IAM 主体公共引用
+	PrefixIAMPrincipal Prefix = "ipr"
+	// PrefixIAMRoleBinding IAM 角色绑定公共引用
+	PrefixIAMRoleBinding Prefix = "irb"
+	// PrefixIAMPolicyBinding IAM 策略绑定公共引用
+	PrefixIAMPolicyBinding Prefix = "ipb"
+	// PrefixAccessPolicyDecision 内容访问策略决策
+	PrefixAccessPolicyDecision Prefix = "apd"
+	// PrefixIdentityConsentReceipt 身份同意凭证
+	PrefixIdentityConsentReceipt Prefix = "cnr"
+	// PrefixIAMGroup IAM 用户组编码
+	PrefixIAMGroup Prefix = "grp"
+	// PrefixKOLContract KOL 合同引用号
+	PrefixKOLContract Prefix = "kct"
+	// PrefixKOLAsset KOL 资产引用号
+	PrefixKOLAsset Prefix = "kat"
+	// PrefixKOLDeliverable KOL 交付物引用号
+	PrefixKOLDeliverable Prefix = "kdl"
+	// PrefixKOLContentItem KOL 内容跟踪引用号
+	PrefixKOLContentItem Prefix = "kci"
+	// PrefixKOLAlert KOL 告警引用号
+	PrefixKOLAlert Prefix = "kal"
+)

package/dist/resources/templates/go-backend/internal/common/types/asset_url.go

@@ -0,0 +1,11 @@
+package types
+
+import "context"
+
+// PublicAssetURLResolver 仅解析可匿名交付的已确认公开资产。
+type PublicAssetURLResolver interface {
+	// ResolvePublicAssetURL 返回公开资产 URL；不可公开交付时返回空字符串。
+	ResolvePublicAssetURL(ctx context.Context, assetID int64) string
+	// ResolvePublicAssetURLs 批量返回公开资产 URL；不可公开交付的资产不会出现在结果中。
+	ResolvePublicAssetURLs(ctx context.Context, assetIDs []int64) map[int64]string
+}

package/dist/resources/templates/go-backend/internal/common/types/billing.go

@@ -0,0 +1,89 @@
+package types
+
+// ═══════════════════════════════════════════════════════════════
+// BillingPeriod — 计费周期（平台级单一真相源）
+// ═══════════════════════════════════════════════════════════════
+//
+// 计费周期是跨域的业务概念：catalog 声明定价、order 快照订单行、subscription
+// 计算续费间隔、payment 创建 Stripe Price、trade.fulfillment 分流 lifetime 路径
+// 都会读到同一份字符串枚举。历史上只有 catalog.domain 声明了类型，其它模块对
+// `"lifetime"` / `"one_time"` 等直接写字符串字面量，一旦 catalog 侧改名就会
+// 静默失配。
+//
+// 使用方式：
+//   - catalog 存储 / 查询：Price.BillingPeriod / PlanItem.BillingPeriod 仍为
+//     string（GORM 列），值必须来自本常量集合
+//   - 业务比较：`period == string(types.BillingPeriodLifetime)` 而非字面量
+//   - DTO binding validator 用常量字面值数组，禁止硬编码
+
+// BillingPeriod 计费周期枚举
+type BillingPeriod string
+
+const (
+	// BillingPeriodWeekly 周付
+	BillingPeriodWeekly BillingPeriod = "weekly"
+	// BillingPeriodMonthly 月付
+	BillingPeriodMonthly BillingPeriod = "monthly"
+	// BillingPeriodQuarterly 季付
+	BillingPeriodQuarterly BillingPeriod = "quarterly"
+	// BillingPeriodSemiAnnual 半年付
+	BillingPeriodSemiAnnual BillingPeriod = "semi_annual"
+	// BillingPeriodAnnual 年付
+	BillingPeriodAnnual BillingPeriod = "annual"
+	// BillingPeriodLifetime 终身
+	BillingPeriodLifetime BillingPeriod = "lifetime"
+	// BillingPeriodOneTime 一次性购买
+	BillingPeriodOneTime BillingPeriod = "one_time"
+)
+
+// IsValid 报告计费周期是否属于平台规范枚举。
+func (p BillingPeriod) IsValid() bool {
+	switch p {
+	case BillingPeriodWeekly,
+		BillingPeriodMonthly,
+		BillingPeriodQuarterly,
+		BillingPeriodSemiAnnual,
+		BillingPeriodAnnual,
+		BillingPeriodLifetime,
+		BillingPeriodOneTime:
+		return true
+	default:
+		return false
+	}
+}
+
+// MonthlyEquivalentMonthCount 返回可精确按月折算的计费周期月数。
+// weekly 没有固定月数，lifetime / one_time 不属于按月折算范围。
+func (p BillingPeriod) MonthlyEquivalentMonthCount() (int64, bool) {
+	switch p {
+	case BillingPeriodMonthly:
+		return 1, true
+	case BillingPeriodQuarterly:
+		return 3, true
+	case BillingPeriodSemiAnnual:
+		return 6, true
+	case BillingPeriodAnnual:
+		return 12, true
+	default:
+		return 0, false
+	}
+}
+
+// RecurringIntervalCount 返回 recurring 计费周期在订单/订阅快照中的标准间隔数。
+//
+// 语义约定：
+//   - monthly / weekly / annual 的"间隔数"都是 1；
+//   - quarterly / semi_annual 以 Stripe 风格展开为 month×3 / month×6；
+//   - lifetime / one_time 不属于 recurring，返回 false 让调用方显式分流。
+func (p BillingPeriod) RecurringIntervalCount() (int, bool) {
+	switch p {
+	case BillingPeriodWeekly, BillingPeriodMonthly, BillingPeriodAnnual:
+		return 1, true
+	case BillingPeriodQuarterly:
+		return 3, true
+	case BillingPeriodSemiAnnual:
+		return 6, true
+	default:
+		return 0, false
+	}
+}

package/dist/resources/templates/go-backend/internal/common/types/billing_test.go

@@ -0,0 +1,77 @@
+package types
+
+import "testing"
+
+func TestBillingPeriodMonthlyEquivalentMonthCount(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		period BillingPeriod
+		months int64
+		ok     bool
+	}{
+		{period: BillingPeriodMonthly, months: 1, ok: true},
+		{period: BillingPeriodQuarterly, months: 3, ok: true},
+		{period: BillingPeriodSemiAnnual, months: 6, ok: true},
+		{period: BillingPeriodAnnual, months: 12, ok: true},
+		{period: BillingPeriodWeekly},
+		{period: BillingPeriodLifetime},
+		{period: BillingPeriodOneTime},
+		{period: BillingPeriod("unknown")},
+	}
+
+	for _, test := range tests {
+		months, ok := test.period.MonthlyEquivalentMonthCount()
+		if months != test.months || ok != test.ok {
+			t.Fatalf("MonthlyEquivalentMonthCount(%q) = (%d, %t), want (%d, %t)", test.period, months, ok, test.months, test.ok)
+		}
+	}
+}
+
+func TestBillingPeriodIsValid(t *testing.T) {
+	t.Parallel()
+
+	valid := []BillingPeriod{
+		BillingPeriodWeekly,
+		BillingPeriodMonthly,
+		BillingPeriodQuarterly,
+		BillingPeriodSemiAnnual,
+		BillingPeriodAnnual,
+		BillingPeriodLifetime,
+		BillingPeriodOneTime,
+	}
+	for _, period := range valid {
+		if !period.IsValid() {
+			t.Fatalf("IsValid(%q) = false, want true", period)
+		}
+	}
+	if BillingPeriod("unknown").IsValid() {
+		t.Fatal("IsValid(unknown) = true, want false")
+	}
+}
+
+func TestBillingPeriodRecurringIntervalCount(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		period BillingPeriod
+		count  int
+		ok     bool
+	}{
+		{period: BillingPeriodWeekly, count: 1, ok: true},
+		{period: BillingPeriodMonthly, count: 1, ok: true},
+		{period: BillingPeriodQuarterly, count: 3, ok: true},
+		{period: BillingPeriodSemiAnnual, count: 6, ok: true},
+		{period: BillingPeriodAnnual, count: 1, ok: true},
+		{period: BillingPeriodLifetime},
+		{period: BillingPeriodOneTime},
+		{period: BillingPeriod("unknown")},
+	}
+
+	for _, test := range tests {
+		count, ok := test.period.RecurringIntervalCount()
+		if count != test.count || ok != test.ok {
+			t.Fatalf("RecurringIntervalCount(%q) = (%d, %t), want (%d, %t)", test.period, count, ok, test.count, test.ok)
+		}
+	}
+}

package/dist/resources/templates/go-backend/internal/common/types/country.go

@@ -0,0 +1,74 @@
+package types
+
+import (
+	"slices"
+	"strings"
+
+	"golang.org/x/text/language"
+	"golang.org/x/text/language/display"
+)
+
+// 平台展示国家/地区名时使用的语言。简体中文与 admin 默认展示语一致，
+// CLDR 区域名作为 country_code 枚举 label 的单一真相源。
+var countryDisplayLanguage = language.SimplifiedChinese
+
+// regionNamer 为简体中文区域名查询器（display.Regions 返回的 namer 可并发只读复用）。
+var regionNamer = display.Regions(countryDisplayLanguage)
+
+// standardCountryCodes 保存 ISO 3166-1 当前正式分配的 alpha-2 国家代码。
+var standardCountryCodes = []string{
+	"AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT",
+	"AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI",
+	"BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY",
+	"BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN",
+	"CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM",
+	"DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK",
+	"FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL",
+	"GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM",
+	"HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR",
+	"IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN",
+	"KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS",
+	"LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK",
+	"ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW",
+	"MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP",
+	"NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM",
+	"PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW",
+	"SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM",
+	"SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF",
+	"TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW",
+	"TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI",
+	"VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW",
+}
+
+// StandardCountryCodes 返回 ISO 3166-1 当前正式分配的 alpha-2 国家代码（升序）。
+func StandardCountryCodes() []string {
+	return slices.Clone(standardCountryCodes)
+}
+
+// LookupCountryName 按 CLDR 返回 ISO 3166-1 alpha-2 代码的简体中文国家/地区名。
+//
+// 返回 ok=false 时调用方应回退到原始代码展示，与 LookupCurrencyMeta 的回退语义一致。
+func LookupCountryName(code string) (string, bool) {
+	normalized := strings.ToUpper(strings.TrimSpace(code))
+	if normalized == "" {
+		return "", false
+	}
+	if _, ok := slices.BinarySearch(standardCountryCodes, normalized); !ok {
+		return "", false
+	}
+	region, err := language.ParseRegion(normalized)
+	if err != nil {
+		return "", false
+	}
+	name := regionNamer.Name(region)
+	if name == "" || name == normalized {
+		return "", false
+	}
+	return name, true
+}
+
+// IsSupportedCountry 判断代码是否为标准注册表中可命名的合法 ISO 3166-1 alpha-2 国家/地区。
+func IsSupportedCountry(code string) bool {
+	_, ok := LookupCountryName(code)
+	return ok
+}

package/dist/resources/templates/go-backend/internal/common/types/country_test.go

@@ -0,0 +1,28 @@
+package types
+
+import "testing"
+
+func TestStandardCountryCodesUsesCurrentISOAssignments(t *testing.T) {
+	codes := StandardCountryCodes()
+	if len(codes) != 249 {
+		t.Fatalf("country code count = %d, want 249", len(codes))
+	}
+	if codes[0] != "AD" || codes[len(codes)-1] != "ZW" {
+		t.Fatalf("country code ordering is invalid: first=%s last=%s", codes[0], codes[len(codes)-1])
+	}
+	codes[0] = "ZZ"
+	if StandardCountryCodes()[0] != "AD" {
+		t.Fatal("StandardCountryCodes must return an isolated copy")
+	}
+
+	for _, code := range []string{"US", "CN", "HK", "DE"} {
+		if !IsSupportedCountry(code) {
+			t.Errorf("expected assigned ISO country %s to be supported", code)
+		}
+	}
+	for _, code := range []string{"AC", "UK", "XK", "ZZ"} {
+		if IsSupportedCountry(code) {
+			t.Errorf("non-ISO country %s must not be supported", code)
+		}
+	}
+}

package/dist/resources/templates/go-backend/internal/common/types/currency.go

@@ -0,0 +1,60 @@
+package types
+
+import (
+	"slices"
+	"strings"
+
+	curr "github.com/bojanz/currency"
+)
+
+// CurrencyMeta 受平台支持的货币元数据
+type CurrencyMeta struct {
+	// Code 货币代码
+	Code string
+	// Symbol 货币显示符号
+	Symbol string
+	// DecimalPlaces 最小货币单位精度
+	DecimalPlaces int
+}
+
+var defaultCurrencyLocale = curr.Locale{Language: "en", Territory: "US"}
+
+// DefaultCurrencyCode 是平台配置未显式声明时使用的默认结算货币。
+const DefaultCurrencyCode = "USD"
+
+// StandardCurrencyCodes 返回货币库内置的全部标准货币代码。
+func StandardCurrencyCodes() []string {
+	codes := slices.Clone(curr.GetCurrencyCodes())
+	slices.Sort(codes)
+	return codes
+}
+
+// LookupCurrencyMeta 按标准货币注册表查询货币元数据
+func LookupCurrencyMeta(code string) (CurrencyMeta, bool) {
+	normalized := strings.ToUpper(strings.TrimSpace(code))
+	if normalized == "" || !curr.IsValid(normalized) {
+		return CurrencyMeta{}, false
+	}
+
+	digits, ok := curr.GetDigits(normalized)
+	if !ok {
+		return CurrencyMeta{}, false
+	}
+
+	symbol, ok := curr.GetSymbol(normalized, defaultCurrencyLocale)
+	if !ok || strings.TrimSpace(symbol) == "" {
+		symbol = normalized
+	}
+
+	return CurrencyMeta{
+		Code:          normalized,
+		Symbol:        symbol,
+		DecimalPlaces: int(digits),
+	}, true
+}
+
+// IsSupportedCurrency 判断货币是否为标准注册表中的合法货币
+func IsSupportedCurrency(code string) bool {
+	_, ok := LookupCurrencyMeta(code)
+	return ok
+}

package/dist/resources/templates/go-backend/internal/common/types/identifiers.go

@@ -0,0 +1,41 @@
+// Package types provides shared business identifier types.
+//
+// 命名空间设计原则：identity（认证源 / OAuth provider 关联）与 user（业务实体 / 订阅、订单、积分归属）
+// 严格分离。
+//
+// 行业对齐：
+//   - Auth0：JWT.sub 使用稳定主体标识，identity 是 user 的 child 关联
+//   - AWS Cognito：JWT.sub = cognito user.id，IdP federated identity 是 attribute
+//   - Stripe：customer_id（business），账号 / API 凭据归属 account_id
+//
+// OneX 运行时契约：JWT.sub 只承载外部可见 public_id；内部 user_id 由 session
+// 真相源解析，类型层强制隔离 user_id 与 identity_id。
+package types
+
+// UserID 是内部业务用户 ID（p_user_users.id）。所有业务对象（订阅、订单、积分、权益、
+// 生成）一律关联此 ID。前端与媒体元数据使用 p_user_users.public_id；JWT.sub claim
+// 携带 public_id，内部 user_id 由 session 真相源解析。
+type UserID int64
+
+// Int64 用于 SQL 参数 / json 编码 / 第三方接口对接时显式转换。
+func (u UserID) Int64() int64 { return int64(u) }
+
+// IsZero 判断是否未设置（匿名 / 占位）。
+func (u UserID) IsZero() bool { return u == 0 }
+
+// Valid 判断是否为合法已分配 ID。
+func (u UserID) Valid() bool { return u > 0 }
+
+// IdentityID 是认证身份 ID（p_identity_identities.id）。仅在 auth domain 内部使用：
+// token 签发 / refresh / revoke、MFA 设置、登录审计、多 provider account linking。
+// 业务侧（订阅、订单、权益、生成）禁止使用此 ID。
+type IdentityID int64
+
+// Int64 用于 SQL 参数 / json 编码 / 第三方接口对接时显式转换。
+func (i IdentityID) Int64() int64 { return int64(i) }
+
+// IsZero 判断是否未设置（匿名 / 占位）。
+func (i IdentityID) IsZero() bool { return i == 0 }
+
+// Valid 判断是否为合法已分配 ID。
+func (i IdentityID) Valid() bool { return i > 0 }

package/dist/resources/templates/go-backend/internal/common/types/operator.go

@@ -0,0 +1,28 @@
+package types
+
+// ═══════════════════════════════════════════════════════════════
+// OperatorType — 操作者类型（平台级单一真相源）
+// ═══════════════════════════════════════════════════════════════
+//
+// 所有需要记录"状态变更 / 审计日志操作人"的模块（user / order / payment /
+// subscription / product_user 等）共享此定义。历史上各模块在自己的 domain/
+// 下重复声明同名 type + 3 个常量，造成：
+//
+//   - 跨模块调用时需要在 string / 不同 OperatorType 之间反复转换
+//   - 新增第 4 种操作人类型（如 api_key / service_account）时需改动 N 处
+//   - 审计日志语义基于字符串值（"system"/"user"/"admin"），不应因声明位置不同
+//     而产生逻辑差异
+//
+// 与 types.Tier 相同的 DRY 原则：只有一个真相源，其他模块全部引用之。
+
+// OperatorType 状态变更 / 审计日志的操作人类型
+type OperatorType string
+
+const (
+	// OperatorTypeSystem 系统自动触发（定时任务、webhook、事件监听器等）
+	OperatorTypeSystem OperatorType = "system"
+	// OperatorTypeUser 终端用户自主操作
+	OperatorTypeUser OperatorType = "user"
+	// OperatorTypeAdmin 管理员操作（管理后台）
+	OperatorTypeAdmin OperatorType = "admin"
+)