create-nextdevtpl 2.6.0

package/template/src/app/[locale]/(marketing)/pseo/[slug]/page.tsx

@@ -0,0 +1,68 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+
+import {
+  PseoCta,
+  PseoFaq,
+  PseoFeatureGrid,
+  PseoHero,
+  PseoRelated,
+  PseoUseCases,
+} from "@/features/pseo";
+import {
+  getAllPseoParams,
+  getPseoPage,
+  getRelatedPseoPages,
+} from "@/features/pseo";
+
+export function generateStaticParams() {
+  return getAllPseoParams();
+}
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ locale: string; slug: string }>;
+}): Promise<Metadata> {
+  const { locale, slug } = await params;
+  const page = getPseoPage(locale, slug);
+
+  if (!page) {
+    return { title: "PSEO Template Not Found" };
+  }
+
+  return {
+    title: page.data.seo.title,
+    description: page.data.seo.description,
+  };
+}
+
+export default async function PseoPage({
+  params,
+}: {
+  params: Promise<{ locale: string; slug: string }>;
+}) {
+  const { locale, slug } = await params;
+  const page = getPseoPage(locale, slug);
+
+  if (!page) {
+    notFound();
+  }
+
+  const related = getRelatedPseoPages(page.locale, page.slug);
+
+  return (
+    <>
+      <PseoHero page={page} />
+      <PseoFeatureGrid page={page} />
+      <PseoUseCases page={page} />
+      <PseoFaq page={page} />
+      <PseoRelated
+        pages={related}
+        title={page.data.sections.related.title}
+        subtitle={page.data.sections.related.subtitle}
+      />
+      <PseoCta page={page} />
+    </>
+  );
+}

package/template/src/app/[locale]/(marketing)/pseo/page.tsx

@@ -0,0 +1,137 @@
+import { ArrowUpRight, Database, LayoutTemplate, Route } from "lucide-react";
+
+import { Badge } from "@/components/ui/badge";
+import { Card, CardContent } from "@/components/ui/card";
+import { getPseoPages } from "@/features/pseo";
+import { Link } from "@/i18n/routing";
+
+export default async function PseoIndexPage({
+  params,
+}: {
+  params: Promise<{ locale: string }>;
+}) {
+  const { locale } = await params;
+  const pages = getPseoPages(locale);
+  const isZh = locale === "zh";
+
+  const overviewCards = isZh
+    ? [
+        {
+          title: "JSON 数据驱动",
+          description: "每个 PSEO 页面都来自结构化 JSON 配置。",
+          icon: Database,
+        },
+        {
+          title: "复用页面模块",
+          description: "Hero、特性、场景、FAQ、CTA 可复用组合。",
+          icon: LayoutTemplate,
+        },
+        {
+          title: "多语言输出",
+          description: "自动匹配当前语言版本内容。",
+          icon: Route,
+        },
+      ]
+    : [
+        {
+          title: "JSON-first data",
+          description:
+            "Every PSEO page is generated from structured JSON fields.",
+          icon: Database,
+        },
+        {
+          title: "Reusable sections",
+          description:
+            "Hero, features, use cases, FAQ, and CTA reuse the same UI blocks.",
+          icon: LayoutTemplate,
+        },
+        {
+          title: "Locale-aware",
+          description:
+            "Switch locales to render the matching content automatically.",
+          icon: Route,
+        },
+      ];
+
+  return (
+    <section className="container py-20">
+      <div className="mx-auto mb-16 flex max-w-4xl flex-col items-center text-center">
+        <Badge variant="outline" className="mb-4 rounded-full px-4 py-1">
+          PSEO Framework
+        </Badge>
+        <h1 className="text-balance text-4xl font-bold tracking-tight md:text-5xl">
+          {isZh ? "PSEO 框架演示库" : "Programmatic SEO Demo Library"}
+        </h1>
+        <p className="mt-4 max-w-2xl text-lg text-muted-foreground">
+          {isZh
+            ? "所有模板均由 JSON 数据驱动，可快速扩展到成百上千个落地页。"
+            : "Templates are generated from JSON data and reusable UI blocks. Add entries to scale to thousands of landing pages."}
+        </p>
+      </div>
+
+      <div className="mx-auto mb-16 grid max-w-5xl gap-6 md:grid-cols-3">
+        {overviewCards.map((card) => {
+          const Icon = card.icon;
+          return (
+            <Card key={card.title} className="border-0 bg-muted/50">
+              <CardContent className="p-6">
+                <div className="mb-4 flex h-10 w-10 items-center justify-center rounded-lg bg-primary/10 text-primary">
+                  <Icon className="h-5 w-5" />
+                </div>
+                <h3 className="mb-2 text-base font-semibold">{card.title}</h3>
+                <p className="text-sm text-muted-foreground">
+                  {card.description}
+                </p>
+              </CardContent>
+            </Card>
+          );
+        })}
+      </div>
+
+      <div className="mx-auto max-w-6xl">
+        <div className="mb-8 flex items-center justify-between">
+          <div>
+            <h2 className="text-2xl font-bold tracking-tight md:text-3xl">
+              {isZh ? "可用模板" : "Available templates"}
+            </h2>
+            <p className="mt-2 text-muted-foreground">
+              {isZh
+                ? "选择任意模板查看完整的 PSEO 落地页。"
+                : "Pick any template to view the full PSEO landing page."}
+            </p>
+          </div>
+        </div>
+
+        <div className="grid gap-6 md:grid-cols-2">
+          {pages.map((page) => (
+            <Card
+              key={page.slug}
+              className="group rounded-2xl border-0 bg-muted/50 transition-colors hover:bg-muted"
+            >
+              <CardContent className="flex h-full flex-col p-6">
+                <div className="mb-4 flex items-center justify-between">
+                  <Badge variant="secondary">{page.category}</Badge>
+                  <ArrowUpRight className="h-4 w-4 text-muted-foreground transition-colors group-hover:text-foreground" />
+                </div>
+                <h3 className="mb-2 text-lg font-semibold">
+                  {page.data.hero.title} {page.data.hero.highlight}
+                </h3>
+                <p className="mb-6 text-sm text-muted-foreground">
+                  {page.data.seo.description}
+                </p>
+                <div className="mt-auto">
+                  <Link
+                    href={`/pseo/${page.slug}`}
+                    className="text-sm font-semibold text-primary hover:underline"
+                  >
+                    {isZh ? "查看模板" : "View template"}
+                  </Link>
+                </div>
+              </CardContent>
+            </Card>
+          ))}
+        </div>
+      </div>
+    </section>
+  );
+}

package/template/src/app/[locale]/docs/[[...slug]]/page.tsx

@@ -0,0 +1,63 @@
+import { DocsBody, DocsPage, DocsTitle } from "fumadocs-ui/page";
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+
+import { routing } from "@/i18n/routing";
+import { docsSource } from "@/lib/source";
+
+export function generateStaticParams() {
+  return docsSource.generateParams().map(({ lang, slug }) => ({
+    locale: lang,
+    slug,
+  }));
+}
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ locale: string; slug?: string[] }>;
+}): Promise<Metadata> {
+  const { locale, slug } = await params;
+  const docsLocale = routing.locales.includes(locale as "en" | "zh")
+    ? locale
+    : routing.defaultLocale;
+  const page = docsSource.getPage(slug, docsLocale);
+
+  if (!page) {
+    return {
+      title: "Not Found",
+    };
+  }
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}
+
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ locale: string; slug?: string[] }>;
+}) {
+  const { locale, slug } = await params;
+  const docsLocale = routing.locales.includes(locale as "en" | "zh")
+    ? locale
+    : routing.defaultLocale;
+  const page = docsSource.getPage(slug, docsLocale);
+
+  if (!page) {
+    notFound();
+  }
+
+  const MDXContent = page.data.body;
+
+  return (
+    <DocsPage toc={page.data.toc}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsBody>
+        <MDXContent />
+      </DocsBody>
+    </DocsPage>
+  );
+}

package/template/src/app/[locale]/docs/layout.tsx

@@ -0,0 +1,39 @@
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
+import type { ReactNode } from "react";
+
+import { Header } from "@/features/marketing";
+import { routing } from "@/i18n/routing";
+import { docsI18n, docsSource } from "@/lib/source";
+
+export default async function Layout({
+  children,
+  params,
+}: {
+  children: ReactNode;
+  params: Promise<{ locale: string }>;
+}) {
+  const { locale } = await params;
+  const docsLocale = routing.locales.includes(locale as "en" | "zh")
+    ? locale
+    : routing.defaultLocale;
+  const tree = docsSource.getPageTree(docsLocale);
+
+  return (
+    <>
+      <Header />
+
+      <DocsLayout
+        tree={tree}
+        i18n={docsI18n}
+        nav={{
+          enabled: false,
+        }}
+        sidebar={{
+          defaultOpenLevel: 1,
+        }}
+      >
+        {children}
+      </DocsLayout>
+    </>
+  );
+}

package/template/src/app/[locale]/layout.tsx

@@ -0,0 +1,80 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { NextIntlClientProvider } from "next-intl";
+import { getMessages } from "next-intl/server";
+import { Toaster } from "sonner";
+import { siteConfig } from "@/config";
+import { Analytics } from "@/features/analytics";
+import { CookieConsent } from "@/features/marketing";
+import { Providers } from "@/features/shared";
+import { routing } from "@/i18n/routing";
+
+/**
+ * 生成静态参数
+ * 为每个支持的语言生成静态页面
+ */
+export function generateStaticParams() {
+  return routing.locales.map((locale) => ({ locale }));
+}
+
+/**
+ * 生成 hreflang metadata
+ */
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ locale: string }>;
+}): Promise<Metadata> {
+  const { locale } = await params;
+  const baseUrl = siteConfig.url;
+
+  return {
+    alternates: {
+      canonical: `${baseUrl}/${locale}`,
+      languages: {
+        en: `${baseUrl}/en`,
+        zh: `${baseUrl}/zh`,
+        "x-default": `${baseUrl}/en`,
+      },
+    },
+  };
+}
+
+/**
+ * Locale 布局
+ *
+ * 功能:
+ * - 验证语言参数有效性
+ * - 提供国际化上下文 (NextIntlClientProvider)
+ * - 包装 Providers (主题等)
+ * - 全局组件 (CookieConsent, Toaster)
+ */
+export default async function LocaleLayout({
+  children,
+  params,
+}: {
+  children: React.ReactNode;
+  params: Promise<{ locale: string }>;
+}) {
+  // 获取语言参数
+  const { locale } = await params;
+
+  // 验证语言是否有效
+  if (!routing.locales.includes(locale as "en" | "zh")) {
+    notFound();
+  }
+
+  // 获取翻译消息
+  const messages = await getMessages();
+
+  return (
+    <NextIntlClientProvider messages={messages}>
+      <Providers locale={locale}>
+        {children}
+        <CookieConsent />
+        <Toaster richColors position="top-right" />
+        <Analytics />
+      </Providers>
+    </NextIntlClientProvider>
+  );
+}

package/template/src/app/[locale]/opengraph-image.tsx

@@ -0,0 +1,20 @@
+import { siteConfig } from "@/config";
+import {
+  createOgImageResponse,
+  OG_IMAGE_SIZE,
+} from "@/components/seo/og-image-template";
+
+/**
+ * Open Graph 图片配置
+ */
+export const runtime = "nodejs";
+export const alt = siteConfig.name;
+export const size = OG_IMAGE_SIZE;
+export const contentType = "image/png";
+
+/**
+ * 动态生成 Open Graph 图片
+ */
+export default async function Image() {
+  return createOgImageResponse();
+}

package/template/src/app/[locale]/twitter-image.tsx

@@ -0,0 +1,20 @@
+import { siteConfig } from "@/config";
+import {
+  createOgImageResponse,
+  OG_IMAGE_SIZE,
+} from "@/components/seo/og-image-template";
+
+/**
+ * Twitter 图片配置
+ */
+export const runtime = "nodejs";
+export const alt = siteConfig.name;
+export const size = OG_IMAGE_SIZE;
+export const contentType = "image/png";
+
+/**
+ * 动态生成 Twitter 图片
+ */
+export default async function Image() {
+  return createOgImageResponse();
+}

package/template/src/app/api/auth/[...all]/route.ts

@@ -0,0 +1,20 @@
+import { toNextJsHandler } from "better-auth/next-js";
+import { withApiLogging } from "@/lib/api-logger";
+import { auth } from "@/lib/auth/index";
+
+/**
+ * Better Auth API 路由处理器
+ *
+ * 此文件处理所有 /api/auth/* 请求
+ * Better Auth 自动处理:
+ * - /api/auth/sign-in - 登录
+ * - /api/auth/sign-up - 注册
+ * - /api/auth/sign-out - 登出
+ * - /api/auth/session - 获取会话
+ * - /api/auth/callback/* - OAuth 回调
+ * - 等等...
+ */
+const authHandlers = toNextJsHandler(auth);
+
+export const GET = withApiLogging(authHandlers.GET);
+export const POST = withApiLogging(authHandlers.POST);

package/template/src/app/api/health/route.ts

@@ -0,0 +1,45 @@
+import { withApiLogging } from "@/lib/api-logger";
+import type { HealthCheckResult } from "@/lib/health";
+import {
+  createHealthReport,
+  probeDatabase,
+  runHealthProbe,
+  validateDeploymentEnvironment,
+} from "@/lib/health";
+
+export const dynamic = "force-dynamic";
+export const runtime = "nodejs";
+
+const DATABASE_TIMEOUT_MS = 5_000;
+const PASS: HealthCheckResult = { status: "pass", durationMs: 0 };
+const FAIL: HealthCheckResult = { status: "fail", durationMs: 0 };
+
+function getVersion(): string {
+  return (
+    process.env.APP_VERSION?.trim() ||
+    process.env.VERCEL_GIT_COMMIT_SHA?.slice(0, 12) ||
+    "unknown"
+  );
+}
+
+export const GET = withApiLogging(async (request: Request) => {
+  const mode = new URL(request.url).searchParams.get("mode");
+  const checks: Record<string, HealthCheckResult> = { application: PASS };
+
+  if (mode !== "live") {
+    const configurationValid =
+      validateDeploymentEnvironment(process.env).length === 0;
+    checks.configuration = configurationValid ? PASS : FAIL;
+    checks.database = configurationValid
+      ? await runHealthProbe(probeDatabase, {
+          timeoutMs: DATABASE_TIMEOUT_MS,
+        })
+      : FAIL;
+  }
+
+  const report = createHealthReport({ checks, version: getVersion() });
+  return Response.json(report, {
+    status: report.status === "healthy" ? 200 : 503,
+    headers: { "Cache-Control": "no-store" },
+  });
+});

package/template/src/app/api/inngest/route.ts

@@ -0,0 +1,12 @@
+import { inngestHandlers } from "@/adapters/jobs/inngest";
+import { withApiLogging } from "@/lib/api-logger";
+
+/**
+ * Inngest API 路由
+ *
+ * 处理 Inngest 的 webhook 请求
+ * 支持开发模式和生产模式
+ */
+export const GET = withApiLogging(inngestHandlers.GET);
+export const POST = withApiLogging(inngestHandlers.POST);
+export const PUT = withApiLogging(inngestHandlers.PUT);

package/template/src/app/api/jobs/credits/expire/route.ts

@@ -0,0 +1,102 @@
+import { headers } from "next/headers";
+import { NextResponse } from "next/server";
+
+import { processExpiredBatches } from "@/features/credits";
+import { withApiLogging } from "@/lib/api-logger";
+import { logError, logWarn } from "@/lib/logger";
+
+/**
+ * 积分过期处理 Cron Job API
+ *
+ * 定期调用此 API 来处理过期的积分批次
+ * 需要通过 Bearer Token 进行身份验证
+ *
+ * 配置 Vercel Cron:
+ * 在 vercel.json 中添加:
+ * {
+ *   "crons": [{
+ *     "path": "/api/jobs/credits/expire",
+ *     "schedule": "0 0 * * *"
+ *   }]
+ * }
+ *
+ * 或使用外部 Cron 服务调用
+ */
+
+/**
+ * 验证 Cron Job 请求的 Bearer Token
+ */
+function validateCronSecret(authHeader: string | null): boolean {
+  if (!authHeader) return false;
+
+  const cronSecret = process.env.CRON_SECRET;
+  if (!cronSecret) {
+    logWarn("CRON_SECRET environment variable is not set");
+    return false;
+  }
+
+  // 支持 Bearer Token 格式
+  const token = authHeader.startsWith("Bearer ")
+    ? authHeader.slice(7)
+    : authHeader;
+
+  return token === cronSecret;
+}
+
+/**
+ * POST /api/jobs/credits/expire
+ *
+ * 处理所有过期的积分批次
+ */
+export const POST = withApiLogging(async () => {
+  const headersList = await headers();
+  const authHeader = headersList.get("authorization");
+
+  // 验证身份
+  if (!validateCronSecret(authHeader)) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  try {
+    // 执行过期处理
+    const results = await processExpiredBatches();
+
+    // 返回处理结果
+    return NextResponse.json({
+      success: true,
+      processed: results.length,
+      details: results.map((r) => ({
+        batchId: r.batchId,
+        userId: r.userId,
+        expiredAmount: r.expiredAmount,
+      })),
+      timestamp: new Date().toISOString(),
+    });
+  } catch (error) {
+    logError("Failed to process expired batches", { error: String(error) });
+
+    return NextResponse.json(
+      {
+        success: false,
+        error: "Failed to process expired batches",
+        message: error instanceof Error ? error.message : "Unknown error",
+      },
+      { status: 500 }
+    );
+  }
+});
+
+/**
+ * GET /api/jobs/credits/expire
+ *
+ * 健康检查端点，用于验证 Cron Job 配置是否正确
+ */
+export const GET = withApiLogging(async () => {
+  return NextResponse.json({
+    status: "ok",
+    endpoint: "/api/jobs/credits/expire",
+    method: "POST",
+    description: "Process expired credit batches",
+    authentication: "Bearer token required (CRON_SECRET)",
+  });
+});

package/template/src/app/api/search/route.ts

@@ -0,0 +1,17 @@
+import { createFromSource } from "fumadocs-core/search/server";
+import { withApiLogging } from "@/lib/api-logger";
+import { docsSource } from "@/lib/source";
+
+/**
+ * Orama 搜索 API
+ *
+ * 基于 fumadocs-core 的 Orama 搜索实现
+ * 自动索引文档内容，支持全文搜索
+ */
+const searchHandlers = createFromSource(docsSource, {
+  localeMap: {
+    zh: "english",
+  },
+});
+
+export const GET = withApiLogging(searchHandlers.GET);