's'调试支付

2026-03-08 06:43:48 -05:00
parent b99fba1c5a
commit 1f4473cb04
35 changed files with 1794 additions and 178 deletions
--- a/docs/TEMPLATE.md
+++ b/docs/TEMPLATE.md
@@ -0,0 +1,154 @@
+# 站点模板使用指南
+
+本项目已配置化为可复用模板，可快速克隆并替换为不同主题（数字游民、一人公司、TikTok 运营、独立开发等）。
+
+## 目录结构
+
+```
+config/                    # 配置层
+  site.config.ts           # 主题配置（切换主题只需改 CURRENT_THEME）
+  index.ts
+
+content/themes/            # 内容层 - 按主题组织
+  digital-nomad/           # 数字游民主题
+    messages/
+      zh.json              # 中文文案
+      en.json              # 英文文案
+    data/
+      tools.json           # 工具数据
+
+app/                       # 应用层 - 组件与页面
+  components/              # 通用 UI 组件
+  [locale]/                # 多语言路由
+  lib/
+    theme-data.ts          # 主题数据加载器
+```
+
+## 切换主题
+
+### 方式一：环境变量
+
+```bash
+# .env.local
+NEXT_PUBLIC_THEME=solo-company
+```
+
+### 方式二：修改配置
+
+编辑 `config/site.config.ts`：
+
+```ts
+export const CURRENT_THEME: ThemeId =
+  (process.env.NEXT_PUBLIC_THEME as ThemeId) || "solo-company";  // 改默认值
+```
+
+## 新增主题步骤
+
+### 1. 添加主题配置
+
+在 `config/site.config.ts` 的 `THEME_CONFIGS` 中添加：
+
+```ts
+"your-theme-id": {
+  id: "your-theme-id",
+  name: "你的主题名",
+  nameEn: "Your Theme Name",
+  tagline: "一句话描述",
+  taglineEn: "Tagline in English",
+  meta: {
+    title: "站点标题 | Site Title",
+    description: "SEO 描述",
+  },
+  features: {
+    roadmap: true,
+    tools: true,
+    community: true,
+    join: false,
+    course: false,
+    ebook: true,
+  },
+  colors: { primary: "sky", accent: "amber" },
+},
+```
+
+在 `THEME_IDS` 数组中添加 `"your-theme-id"`。
+
+### 2. 创建主题内容
+
+复制 `content/themes/digital-nomad/` 为 `content/themes/your-theme-id/`：
+
+```
+content/themes/your-theme-id/
+  messages/
+    zh.json    # 修改为你的中文文案
+    en.json    # 修改为你的英文文案
+  data/
+    tools.json # 修改为你的工具数据
+```
+
+### 3. 注册数据加载
+
+在 `app/lib/theme-data.ts` 的 `getThemeMessages` 和 `getThemeToolsData` 的 switch 中添加：
+
+```ts
+case "your-theme-id": {
+  const mod = locale === "zh"
+    ? await import("@/content/themes/your-theme-id/messages/zh.json")
+    : await import("@/content/themes/your-theme-id/messages/en.json");
+  return mod.default;
+}
+```
+
+## 文案结构 (messages)
+
+参考 `content/themes/digital-nomad/messages/zh.json`：
+
+- `common` - 站点名、导航、按钮等
+- `hero` - 首页主视觉
+- `features` - 特性介绍
+- `roadmap` - 学习路径、天数、电子书、课程
+- `tools` - 工具区块
+- `community` - 社区区块
+- `footer` - 页脚
+- `auth` - 登录注册
+
+## 工具数据 (tools.json)
+
+```json
+{
+  "categories": [
+    {
+      "id": "category-id",
+      "icon": "🔧",
+      "title": "分类名",
+      "color": "from-sky-500 to-cyan-500",
+      "bg": "bg-sky-50",
+      "text": "text-sky-700",
+      "tools": [
+        { "name": "工具名", "desc": "描述", "href": "https://..." }
+      ]
+    }
+  ]
+}
+```
+
+## 7 天学习路径 (days)
+
+Day 内容当前在 `app/data/days.ts`，后续可迁移到 `content/themes/[theme]/data/days.json` 实现按主题切换。
+
+## 服务配置（支付、PocketBase）
+
+详见 [docs/SERVICES.md](./SERVICES.md)。支付和 PocketBase 已配置化，可通过环境变量和主题 `services` 覆盖。
+
+## 功能开关 (features)
+
+在主题配置中可关闭某些模块：
+
+- `roadmap` - 7 天学习路径
+- `tools` - 工具推荐
+- `community` - 社区区块
+- `join` - 加入社区页
+- `course` - 课程页
+- `ebook` - 电子书
+
+（功能开关的 UI 条件渲染待接入）