出海产品定价策略：订阅、一次性买断与用量计费

// ❌ 问题：每次新增国家都要改代码，价格系数散落各处，难以维护
function getPrice(country: string): number {
  if (country === 'IN') return 5.99
  if (country === 'BR') return 6.60
  if (country === 'JP') return 11.70
  if (country === 'NG') return 4.49
  if (country === 'DE') return 12.30
  // 每加一个国家，这里就多一行
  // 价格系数和代码耦合，改价格要改代码重新部署
  return 15.00 // 默认美元价
}

// ✅ 价格系数与代码分离，修改定价不需要改代码
// 数据源：世界银行 PPP 指数，存为 JSON 或数据库配置
const pppFactors: Record<string, number> = {
  US: 1.00, DE: 0.82, JP: 0.78, BR: 0.44,
  IN: 0.40, NG: 0.30, // ...其他国家
}
 
// 价格档位：确保定价符合当地心理价位
// 比如印度用户更习惯 ₹499、₹999 这样的整数
const priceTiers = [15, 12, 9, 7, 5, 4]
 
function getRegionalPrice(countryCode: string): number {
  const factor = pppFactors[countryCode] ?? 1.0
  const rawPrice = 15 * factor
  // 找到最接近的价格档位，避免 $6.37 这种奇怪的数字
  return priceTiers.reduce((prev, curr) =>
    Math.abs(curr - rawPrice) < Math.abs(prev - rawPrice) ? curr : prev
  )
}

// ❌ 问题：只限制生成次数，用户每天重置后又可以免费使用
// 而且没有区分功能，免费版体验太完整
interface FreePlanLimits {
  dailyGenerations: 10  // 大多数用户一天用不完
  models: 'all'         // 所有模型都能用，没有差异化
  export: 'all'         // 所有格式都能导出
  history: 'unlimited'  // 历史记录无限，永远不需要升级
}
 
function canGenerate(user: User): boolean {
  return user.todayCount < 10  // 简单粗暴的计数
}

// ✅ 每个维度都有明确的免费/付费边界
// 免费版能体验核心价值，但关键功能被门控
const planFeatures = {
  free: {
    dailyGenerations: 3,
    models: ['gpt-3.5-turbo'] as const,     // 只有基础模型
    exportFormats: ['markdown'] as const,    // 只有基础格式
    historyDays: 7,                          // 7 天历史
    customTemplates: 2,                      // 2 个自定义模板
    watermark: true,                         // 导出带水印
  },
  pro: {
    dailyGenerations: Infinity,
    models: ['gpt-3.5-turbo', 'gpt-4', 'claude-3'] as const,
    exportFormats: ['markdown', 'pdf', 'docx'] as const,
    historyDays: Infinity,
    customTemplates: Infinity,
    watermark: false,
  },
} as const
 
function canAccessFeature(user: User, feature: keyof typeof planFeatures.pro): boolean {
  const limits = planFeatures[user.plan]
  const value = limits[feature]
  if (typeof value === 'boolean') return value
  if (value === Infinity) return true
  // 对于数字型限制（次数、天数），检查是否已用完
  return getCurrentUsage(user, feature) < (value as number)
}

// ❌ 问题：所有用户只能订阅，低频用户觉得不值，高频用户没有更便宜的入口
// 一次性工具强推订阅，用户有抵触心理
const plans = [
  { name: 'Monthly', price: 9, billing: 'monthly' },
  { name: 'Yearly', price: 90, billing: 'yearly' },  // 本质上还是订阅
  // 没有任何买断选项
  // 没有按团队规模分级
]
 
// 付费页面的描述也没有差异化
function renderPlanDescription(plan: Plan) {
  return `每月 $${plan.price}，随时取消`
  // 所有方案描述一样，用户看不出区别
}

// ✅ 买断版满足低频用户，订阅版服务高频用户
// 两种模式覆盖不同支付意愿
const pricingTiers = [
  {
    id: 'basic',
    type: 'lifetime' as const,  // 一次性买断
    price: { amount: 2900, currency: 'USD' },  // 单位用分，避免浮点精度问题
    features: ['manual-annotation', 'basic-export', 'single-project'],
    targetAudience: '偶尔使用的设计师',
    // 买断版明确标注「一次付费，永久使用」
    headline: '一次购买，永久可用',
  },
  {
    id: 'pro',
    type: 'subscription' as const,
    price: { amount: 900, currency: 'USD', interval: 'month' },
    features: ['ai-layer-detection', 'batch-annotation', 'team-collab', 'unlimited-projects'],
    targetAudience: '每周至少使用 3 次的设计团队',
    headline: 'AI 驱动的高效标注',
  },
  {
    id: 'team',
    type: 'subscription' as const,
    price: { amount: 2900, currency: 'USD', interval: 'month', perSeat: true },
    features: ['all-pro-features', 'shared-library', 'permissions', 'priority-support'],
    targetAudience: '5 人以上的设计团队',
    headline: '为团队协作而生',
  },
] as const
 
function formatPrice(tier: typeof pricingTiers[number], pppFactor: number): string {
  const adjusted = Math.round(tier.price.amount * pppFactor / 100) * 100
  const formatter = new Intl.NumberFormat('en-US', {
    style: 'currency',
    currency: tier.price.currency,
    minimumFractionDigits: 0,
  })
  const base = formatter.format(adjusted / 100)
  if (tier.type === 'lifetime') return `${base} 一次买断`
  return `${base}/${tier.price.interval === 'month' ? '月' : '年'}`
}

// ❌ 问题：没有年付选项，丢失了偏好一次性付款的用户
// 这些用户往往付费意愿更强，只是不想每月被扣款
const pricing = {
  monthly: 19,
  // 没有年付，用户只能按月订阅
  // 每月扣款容易产生「订阅疲劳」，增加流失
}

// ✅ 年付 8 折是行业标准
// 同时展示月均价格，降低年付的心理门槛
const pricing = {
  monthly: 19,
  yearly: {
    total: 182,            // 19 * 12 * 0.8
    perMonth: 15.20,       // 182 / 12，展示月均价格
    discount: '20%',       // 明确标注折扣比例
    savings: '$45.60',     // 明确标注省了多少钱
  },
}
 
function renderPricingToggle(selected: 'monthly' | 'yearly') {
  return `
    <div class="billing-toggle">
      <button class="${selected === 'monthly' ? 'active' : ''}">
        月付 $19
      </button>
      <button class="${selected === 'yearly' ? 'active' : ''}">
        年付 $15.20/月 <span class="badge">省 20%</span>
      </button>
    </div>
  `
  // 年付按钮上标注「省 20%」，用绿色徽章突出
  // 月均价格 $15.20 比月付 $19 低，形成价格锚定
}

// ❌ 问题：直接修改生产环境价格
// 老用户刷新页面看到价格变了，会质疑产品诚信
// 无法回滚，实验失败也只能硬着头皮继续
async function updatePricing() {
  const newPrice = 29  // 从 19 改成 29
  await db.pricing.update({ price: newPrice })
  // 全站立即生效，无法控制影响范围
  // 没有任何实验分组逻辑
}

// ✅ 实验组和对照组通过用户 ID 哈希分组
// 老用户保持原价，新流量进入实验
// 实验结果有明确的统计指标
interface PricingExperiment {
  id: string
  name: string
  variants: Array<{
    id: string
    price: number
    weight: number  // 流量权重
  }>
  metrics: {
    primary: 'conversion_rate'  // 主要指标：转化率
    secondary: Array<'arpu' | 'churn_rate' | 'revenue_per_visitor'>
  }
  startDate: string
  endDate: string
  minSampleSize: number  // 最小样本量，避免过早下结论
}
 
// 根据用户 ID 稳定分组，同一个用户始终看到同一个价格
function getExperimentVariant(
  userId: string,
  experiment: PricingExperiment
): string {
  // 用用户 ID 的哈希值取模，保证分组稳定
  const hash = simpleHash(userId + experiment.id)
  const bucket = hash % 100
 
  let cumulative = 0
  for (const variant of experiment.variants) {
    cumulative += variant.weight
    if (bucket < cumulative) return variant.id
  }
  return experiment.variants[experiment.variants.length - 1].id
}
 
// 实验配置示例
const priceTest: PricingExperiment = {
  id: 'price-test-2026-q2',
  name: 'Pro 版价格敏感度测试',
  variants: [
    { id: 'control', price: 19, weight: 50 },   // 对照组 50%
    { id: 'test_a', price: 24, weight: 25 },     // 测试组 A 25%
    { id: 'test_b', price: 29, weight: 25 },     // 测试组 B 25%
  ],
  metrics: {
    primary: 'conversion_rate',
    secondary: ['arpu', 'churn_rate', 'revenue_per_visitor'],
  },
  startDate: '2026-06-01',
  endDate: '2026-07-01',
  minSampleSize: 2000,  // 每组至少 2000 个样本
}

// ❌ 问题：自己硬编码汇率，每天手动更新
// 不考虑增值税（VAT），欧盟用户被多收税会投诉
// 不处理货币精度问题，日元和韩元没有小数
const exchangeRates = {
  EUR: 0.92,  // 手动查的汇率，三天后就过时了
  JPY: 149.5,
  BRL: 4.97,
}
 
function convertPrice(usdPrice: number, currency: string): number {
  return usdPrice * exchangeRates[currency]
  // 没处理精度问题：JPY 应该是整数
  // 没处理 VAT：欧盟需要额外加税
  // 汇率不更新，一个月后就不准了
}

// ✅ 使用 Stripe SDK 创建多货币价格
// Stripe 自动处理汇率更新、税务计算、本地支付方式
import Stripe from 'stripe'
 
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!)
 
async function createRegionalPrices(basePriceId: string) {
  // 为不同市场创建本地货币价格
  const regionalPrices = [
    { currency: 'usd', amount: 1500, countries: ['US', 'CA', 'AU'] },
    { currency: 'eur', amount: 1400, countries: ['DE', 'FR', 'ES', 'IT'] },
    { currency: 'gbp', amount: 1200, countries: ['GB'] },
    { currency: 'jpy', amount: 2200, countries: ['JP'] },  // 日元无小数
    { currency: 'inr', amount: 599, countries: ['IN'] },
    { currency: 'brl', amount: 490, countries: ['BR'] },
  ]
 
  for (const region of regionalPrices) {
    const price = await stripe.prices.create({
      product: basePriceId,
      currency: region.currency,
      unit_amount: region.amount,  // 单位是分，避免浮点问题
      tax_behavior: 'inclusive',   // 价格含税，Stripe Tax 自动计算
    })
 
    // 将价格 ID 和国家映射存入数据库
    for (const country of region.countries) {
      await db.regionalPrices.create({
        data: { country, priceId: price.id, currency: region.currency },
      })
    }
  }
}
 
// 结账时，根据用户所在国家查找对应的价格 ID
async function getCheckoutPrice(countryCode: string, productId: string) {
  const regional = await db.regionalPrices.findUnique({
    where: { country: countryCode },
  })
  // 如果没有区域价格，回退到默认美元价格
  return regional?.priceId ?? `price_default_${productId}`
}