create-nextdevtpl 2.6.0

package/template/src/config/nav.ts

@@ -0,0 +1,238 @@
+import {
+  Activity,
+  Bot,
+  Coins,
+  CreditCard,
+  Globe,
+  HardDrive,
+  Headset,
+  LayoutDashboard,
+  type LucideIcon,
+  Settings,
+  Shield,
+  Ticket,
+  UserCog,
+  Users,
+  Zap,
+} from "lucide-react";
+
+import type {
+  ModuleNavigationArea,
+  ModuleNavigationIcon,
+} from "@/core/modules";
+import { moduleRegistry } from "@/modules";
+
+/**
+ * 导航链接类型
+ */
+export interface NavItem {
+  title: string;
+  href: string;
+  translationKey?: string;
+  disabled?: boolean;
+  external?: boolean;
+  icon?: LucideIcon;
+  description?: string;
+}
+
+/**
+ * 导航分组类型
+ */
+export interface NavGroup {
+  title: string;
+  translationKey?: string;
+  items: NavItem[];
+}
+
+/**
+ * Products 下拉菜单项类型
+ */
+export interface ProductNavItem {
+  title: string;
+  href: string;
+  description: string;
+  icon: LucideIcon;
+}
+
+/**
+ * Products 下拉菜单分组类型
+ */
+export interface ProductNavGroup {
+  title: string;
+  items: ProductNavItem[];
+}
+
+// ============================================
+// Marketing 导航配置
+// ============================================
+
+/**
+ * Products 下拉菜单内容
+ */
+export const productsNav: ProductNavGroup[] = [
+  {
+    title: "Core",
+    items: [
+      {
+        title: "Authentication",
+        href: "/#features",
+        description: "Multi-provider auth with session management",
+        icon: Shield,
+      },
+      {
+        title: "Payments",
+        href: "/#features",
+        description: "Subscriptions and one-time purchases",
+        icon: CreditCard,
+      },
+      {
+        title: "Credits",
+        href: "/#features",
+        description: "Double-entry bookkeeping with FIFO expiration",
+        icon: Coins,
+      },
+    ],
+  },
+  {
+    title: "DX Platform",
+    items: [
+      {
+        title: "Background Jobs",
+        href: "/#features",
+        description: "Async processing with Inngest",
+        icon: Zap,
+      },
+      {
+        title: "Internationalization",
+        href: "/#features",
+        description: "Multi-language with next-intl",
+        icon: Globe,
+      },
+      {
+        title: "AI Integration",
+        href: "/#features",
+        description: "Multi-model LLM abstraction",
+        icon: Bot,
+      },
+    ],
+  },
+  {
+    title: "Infrastructure",
+    items: [
+      {
+        title: "Admin Panel",
+        href: "/#features",
+        description: "User and ticket management",
+        icon: UserCog,
+      },
+      {
+        title: "File Storage",
+        href: "/#features",
+        description: "S3/R2 cloud storage",
+        icon: HardDrive,
+      },
+      {
+        title: "Monitoring",
+        href: "/#features",
+        description: "Logging and error tracking",
+        icon: Activity,
+      },
+    ],
+  },
+];
+
+/**
+ * 主导航链接 (Header)
+ */
+export const mainNav: NavItem[] = [
+  { title: "Docs", href: "/docs" },
+  { title: "PSEO", href: "/pseo" },
+  { title: "Pricing", href: "/#pricing" },
+  { title: "Blog", href: "/blog" },
+];
+
+/**
+ * Footer 导航配置
+ */
+export const footerNav = {
+  /** 产品 (Product) */
+  product: [
+    { title: "Pricing", href: "/#pricing" },
+    { title: "Changelog", href: "/blog" },
+    {
+      title: "Contact Us",
+      href: `mailto:${process.env.NEXT_PUBLIC_SUPPORT_EMAIL || "hello@example.com"}`,
+    },
+  ] as NavItem[],
+
+  /** 法律 (Legal) */
+  legal: [
+    { title: "Terms of Service", href: "/legal/terms" },
+    { title: "Privacy Policy", href: "/legal/privacy" },
+    { title: "Cookie Policy", href: "/legal/cookie-policy" },
+  ] as NavItem[],
+};
+
+const moduleNavigationIcons: Record<ModuleNavigationIcon, LucideIcon> = {
+  coins: Coins,
+  dashboard: LayoutDashboard,
+  headset: Headset,
+  settings: Settings,
+  ticket: Ticket,
+  users: Users,
+};
+
+function createModuleNavigation(area: ModuleNavigationArea): NavGroup[] {
+  const contributions = moduleRegistry.manifests
+    .flatMap((manifest) => manifest.navigation)
+    .filter((item) => item.area === area)
+    .sort((left, right) => left.order - right.order);
+  const groups = new Map<string, NavGroup>();
+
+  for (const contribution of contributions) {
+    const group = groups.get(contribution.group) ?? {
+      title: contribution.group,
+      translationKey: contribution.groupTranslationKey,
+      items: [],
+    };
+
+    group.items.push({
+      title: contribution.translationKey,
+      translationKey: contribution.translationKey,
+      href: contribution.href,
+      icon: moduleNavigationIcons[contribution.icon],
+    });
+    groups.set(contribution.group, group);
+  }
+
+  return [...groups.values()];
+}
+
+export const dashboardNav = createModuleNavigation("dashboard");
+export const adminNav = createModuleNavigation("admin");
+
+// ============================================
+// 导出配置对象
+// ============================================
+
+/**
+ * Marketing 页面配置
+ */
+export const marketingConfig = {
+  mainNav,
+  footerNav,
+};
+
+/**
+ * Dashboard 页面配置
+ */
+export const dashboardConfig = {
+  sidebarNav: dashboardNav,
+};
+
+/**
+ * Admin 页面配置
+ */
+export const adminConfig = {
+  sidebarNav: adminNav,
+};

package/template/src/config/payment.ts

@@ -0,0 +1,282 @@
+/**
+ * 支付配置
+ *
+ * 定义支付系统的全局配置和计划信息
+ */
+
+import {
+  type PaymentConfig,
+  PaymentType,
+  type Plan,
+  PlanInterval,
+  type PriceConfig,
+  type PricingConfig,
+} from "@/features/payment/types";
+
+// ============================================
+// 环境变量中的价格 ID
+// ============================================
+
+/**
+ * 支付供应商产品/价格 ID（从环境变量读取）
+ */
+export const PRICE_IDS = {
+  STARTER_MONTHLY: process.env.NEXT_PUBLIC_PRICE_STARTER_MONTHLY ?? "",
+  STARTER_YEARLY: process.env.NEXT_PUBLIC_PRICE_STARTER_YEARLY ?? "",
+  PRO_MONTHLY: process.env.NEXT_PUBLIC_PRICE_PRO_MONTHLY ?? "",
+  PRO_YEARLY: process.env.NEXT_PUBLIC_PRICE_PRO_YEARLY ?? "",
+  ULTRA_MONTHLY: process.env.NEXT_PUBLIC_PRICE_ULTRA_MONTHLY ?? "",
+  ULTRA_YEARLY: process.env.NEXT_PUBLIC_PRICE_ULTRA_YEARLY ?? "",
+} as const;
+
+// ============================================
+// 订阅积分配额（每月）
+// ============================================
+
+export const SUBSCRIPTION_MONTHLY_CREDITS = {
+  starter: 3000,
+  pro: 8000,
+  ultra: 16000,
+} as const;
+
+// ============================================
+// 支付系统配置
+// ============================================
+
+/**
+ * 支付系统全局配置
+ */
+export const paymentConfig: PaymentConfig = {
+  /** 支付提供商 */
+  provider: "creem",
+
+  /** 货币 */
+  currency: "USD",
+
+  /** 年付折扣百分比（约等于送 5 个月） */
+  yearlyDiscount: 40,
+
+  /** 支付完成后重定向 */
+  redirectAfterCheckout: "/dashboard",
+
+  /** 取消支付后重定向 */
+  redirectAfterCancel: "/pricing",
+
+  /** 计划配置 */
+  plans: {
+    free: {
+      id: "free",
+      isFree: true,
+    },
+
+    starter: {
+      id: "starter",
+      prices: [
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.STARTER_MONTHLY,
+          amount: 5,
+          interval: PlanInterval.MONTH,
+        },
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.STARTER_YEARLY,
+          amount: 35,
+          interval: PlanInterval.YEAR,
+        },
+      ],
+    },
+
+    pro: {
+      id: "pro",
+      popular: true,
+      prices: [
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.PRO_MONTHLY,
+          amount: 9,
+          interval: PlanInterval.MONTH,
+        },
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.PRO_YEARLY,
+          amount: 65,
+          interval: PlanInterval.YEAR,
+        },
+      ],
+    },
+
+    ultra: {
+      id: "ultra",
+      prices: [
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.ULTRA_MONTHLY,
+          amount: 15,
+          interval: PlanInterval.MONTH,
+        },
+        {
+          type: PaymentType.SUBSCRIPTION,
+          priceId: PRICE_IDS.ULTRA_YEARLY,
+          amount: 109,
+          interval: PlanInterval.YEAR,
+        },
+      ],
+    },
+  },
+};
+
+// ============================================
+// 计划显示信息
+// ============================================
+
+/**
+ * 获取计划显示信息
+ *
+ * 返回用于定价页面展示的完整计划信息
+ */
+export function getPricingPlans(_t?: (key: string) => string): Plan[] {
+  const plans: Plan[] = [];
+  const config = paymentConfig;
+
+  // 免费计划
+  if (config.plans.free) {
+    plans.push({
+      ...config.plans.free,
+      name: "Free",
+      description: "Try NextDevTpl with no commitment",
+      features: [
+        "200 credits (one-time)",
+        "Text & file input",
+        "Up to 10K characters per task",
+        "Max 5MB file size",
+        "Export to Anki & Markdown",
+        "Deck history saved forever",
+      ],
+      cta: "Get Started",
+    });
+  }
+
+  // Starter 计划
+  if (config.plans.starter) {
+    plans.push({
+      ...config.plans.starter,
+      name: "Starter",
+      description: "For casual learners",
+      features: [
+        "3,000 credits / month",
+        "Text & file input",
+        "Up to 100K characters per task",
+        "Max 20MB file size",
+        "Export to Anki & Markdown",
+        "Deck history saved forever",
+        "Email support",
+      ],
+      cta: "Subscribe",
+    });
+  }
+
+  // Pro 计划
+  if (config.plans.pro) {
+    plans.push({
+      ...config.plans.pro,
+      name: "Pro",
+      description: "For serious learners",
+      features: [
+        "8,000 credits / month",
+        "All input sources (URL, video, etc.)",
+        "Up to 300K characters per task",
+        "Max 50MB file size",
+        "Priority generation queue",
+        "Export to Anki & Markdown",
+        "Deck history saved forever",
+        "🚧 Custom card styles (coming soon)",
+        "Priority support",
+      ],
+      cta: "Subscribe",
+    });
+  }
+
+  // Ultra 计划
+  if (config.plans.ultra) {
+    plans.push({
+      ...config.plans.ultra,
+      name: "Ultra",
+      description: "For power users & educators",
+      features: [
+        "16,000 credits / month",
+        "All input sources (URL, video, etc.)",
+        "Up to 1M characters per task",
+        "Max 100MB file size",
+        "Highest priority queue",
+        "Export to Anki & Markdown",
+        "Deck history saved forever",
+        "🚧 Custom card styles (coming soon)",
+        "🚧 AI-assisted card making (coming soon)",
+        "Dedicated support",
+      ],
+      cta: "Subscribe",
+    });
+  }
+
+  return plans;
+}
+
+/**
+ * 获取定价页面完整配置
+ */
+export function getPricingConfig(): PricingConfig {
+  return {
+    title: "Simple, transparent pricing",
+    subtitle:
+      "Start free, upgrade when you need more. Save 40% with yearly billing.",
+    frequencies: ["Monthly", "Yearly"],
+    yearlyDiscount: paymentConfig.yearlyDiscount,
+    plans: getPricingPlans(),
+  };
+}
+
+/**
+ * 根据价格 ID 查找计划和价格信息
+ */
+export function findPlanByPriceId(priceId: string): {
+  plan: Plan | null;
+  price: PriceConfig | null;
+} {
+  const plans = getPricingPlans();
+
+  for (const plan of plans) {
+    if (plan.prices) {
+      const price = plan.prices.find((p) => p.priceId === priceId);
+      if (price) {
+        return { plan, price };
+      }
+    }
+  }
+
+  return { plan: null, price: null };
+}
+
+/**
+ * 获取计划的价格（根据周期）
+ */
+export function getPlanPrice(
+  plan: Plan,
+  interval: PlanInterval
+): PriceConfig | null {
+  if (!plan.prices) return null;
+  return plan.prices.find((p) => p.interval === interval) ?? null;
+}
+
+/**
+ * 获取应用的基础 URL
+ */
+export function getBaseUrl(): string {
+  if (process.env.NEXT_PUBLIC_APP_URL) {
+    return process.env.NEXT_PUBLIC_APP_URL;
+  }
+  if (process.env.VERCEL_URL) {
+    return `https://${process.env.VERCEL_URL}`;
+  }
+  return "http://localhost:3000";
+}

package/template/src/config/site.ts

@@ -0,0 +1,53 @@
+/**
+ * 站点配置
+ *
+ * 集中管理站点的基本信息，用于 SEO、元数据、页脚等
+ */
+export const siteConfig = {
+  /** 站点名称 */
+  name: "NextDevTpl",
+
+  /** 站点描述 */
+  description:
+    "Production-ready Next.js SaaS template with auth, payments, credits, i18n, and more.",
+
+  /** 站点 URL (生产环境) */
+  url: process.env.NEXT_PUBLIC_APP_URL || "https://example.com",
+
+  /** OG 图片 URL */
+  ogImage: "/og-image.png",
+
+  /** 作者信息 */
+  author: {
+    name: "NextDevTpl Team",
+    url: process.env.NEXT_PUBLIC_APP_URL || "https://example.com",
+    email: process.env.NEXT_PUBLIC_SUPPORT_EMAIL || "hello@example.com",
+  },
+
+  /** 社交链接 */
+  links: {
+    twitter:
+      process.env.NEXT_PUBLIC_TWITTER_URL || "https://twitter.com/example",
+    github:
+      process.env.NEXT_PUBLIC_GITHUB_URL ||
+      "https://github.com/example/nextdevtpl",
+    discord:
+      process.env.NEXT_PUBLIC_DISCORD_URL || "https://discord.gg/example",
+  },
+
+  /** 关键词 (SEO) */
+  keywords: [
+    "SaaS",
+    "Next.js",
+    "Template",
+    "Boilerplate",
+    "Starter Kit",
+    "Auth",
+    "Payments",
+  ],
+} as const;
+
+/**
+ * 站点配置类型
+ */
+export type SiteConfig = typeof siteConfig;