feat(app): 添加多模板关于我们页面及相关路由和404页面

- 新增404页面，优化未找到页面体验，避免被搜索引擎索引 - 增加文件代理接口，隐藏真实文件服务器地址，支持文件请求代理 - 实现/article、/case、/product及/page动态路由兼容列表与详情展示 - 添加动态CMS页面兼容入口处理旧式路径，统一路由与SEO设置 - 新增模板1、模板7、模板2、模板3关于我们页面，实现多模板支持 - 模板增强支持CMS单页内容加载及SEO信息动态设置 - 配置环境变量及Git忽略文件规则辅助开发和构建环境管理
2026-09-08 12:13:44 +08:00
commit 2b69686795
381 changed files with 59891 additions and 0 deletions
@@ -0,0 +1,81 @@
+import { $fetch } from 'ofetch'
+import { createError, defineEventHandler, getQuery } from 'h3'
+import { useRuntimeConfig } from '#imports'
+import { getTenantFromContext } from '../../utils/tenant'
+
+/**
+ * 文章详情
+ * GET /api/article/detail?id=123
+ * 代理到 CMS: /cms/cms-article/{id}
+ */
+export default defineEventHandler(async (event) => {
+  const config = useRuntimeConfig()
+  const ctx = getTenantFromContext(event, config)
+  const query = getQuery(event)
+  const modulesApiBase = config.public.modulesApiBase as string
+
+  if (!query.id) {
+    throw createError({ statusCode: 400, statusMessage: 'Missing id parameter' })
+  }
+
+  let res: any
+  try {
+    res = await $fetch(`/cms/cms-article/${query.id}`, {
+      baseURL: modulesApiBase,
+      headers: {
+        TenantId: ctx.tenantId
+      }
+    })
+  } catch (error: any) {
+    throw createError({
+      statusCode: error?.statusCode || error?.response?.status || 502,
+      statusMessage: error?.statusMessage || 'Failed to fetch article detail'
+    })
+  }
+
+  // C 端不展示草稿(1)/下架(2)/已删除文章：status 非 0(已发布) 或 deleted=1 视为不存在
+  // 上游真实枚举：0=已发布 1=草稿 2=下架（与早期假设相反，已于 2026-07-29 校正）
+  // 上游详情接口不校验状态，需在此拦截，否则可通过 /article/:id 直接访问未发布内容。
+  // 上游对不存在/未发布文章常返回 {code:1, message:"文章ID不存在"}（无 data），
+  // 此时 res.code !== 0，必须 404，否则扁平后的对象为 truthy，前端会误判为「文章存在」渲染空页。
+  const detail = res?.data ?? res
+  if (typeof res?.code === 'number' && res.code !== 0) {
+    throw createError({ statusCode: 404, statusMessage: 'Article not found or unpublished' })
+  }
+  if (!detail || detail.status === undefined || detail.status !== 0 || detail.deleted === 1) {
+    throw createError({ statusCode: 404, statusMessage: 'Article not found or unpublished' })
+  }
+
+  // 文章附件：上游 files 可能是 JSON 字符串或数组，容错解析为数组后随扁平数据返回
+  let files: any[] = []
+  if (typeof detail.files === 'string' && detail.files.trim()) {
+    try {
+      const arr = JSON.parse(detail.files)
+      if (Array.isArray(arr)) files = arr
+    } catch {
+      // 解析失败则忽略，不阻断详情返回
+    }
+  } else if (Array.isArray(detail.files)) {
+    files = detail.files
+  }
+
+  // 字段兼容归一化：上游 CMS 不同版本字段名不一致，统一补齐，
+  // 避免前端模板的 <RichText :content> / 副标题取不到值而渲染空白。
+  // - content（富文本正文）：部分版本放在 description，兜底回退（content 优先）
+  // - subtitle（副标题）：上游多数版本返回 summary，兜底回退
+  if (detail && typeof detail === 'object') {
+    if (detail.content == null || detail.content === '') {
+      detail.content = detail.description || ''
+    }
+    if (detail.subtitle == null || detail.subtitle === '') {
+      detail.subtitle = detail.summary || ''
+    }
+  }
+
+  // 返回扁平数据，去掉上游 {code, message, data} 包装层
+  // 前端 useFetch<Article> 直接访问 article.title / article.content 等字段
+  return {
+    ...detail,
+    files: files.length ? files : undefined,
+  }
+})
@@ -0,0 +1,58 @@
+import { $fetch } from 'ofetch'
+import { createError, defineEventHandler, getQuery } from 'h3'
+import { useRuntimeConfig } from '#imports'
+import { getTenantFromContext } from '../../utils/tenant'
+
+/**
+ * 文章列表
+ * GET /api/article/list?navigationId=4273&page=1&limit=10
+ * 代理到 CMS: /cms/cms-article/page
+ *
+ * 参数说明:
+ * - navigationId: 导航栏目ID（从 getSiteInfo 的 topNavs 获取）
+ * - page / limit: 分页
+ * - keywords: 搜索关键词
+ */
+export default defineEventHandler(async (event) => {
+  const config = useRuntimeConfig()
+  const ctx = getTenantFromContext(event, config)
+  const query = getQuery(event)
+  const modulesApiBase = config.public.modulesApiBase as string
+
+  try {
+    // 前端传 navigationId；上游 cms-article 实际按 categoryId 过滤（文章无 navigationId 字段，只有 categoryId）。
+    // 二者同值（文章分类 ID == 对应栏目 navigationId），透传 categoryId 以正确按栏目过滤；
+    // 保留 navigationId 兼容旧租户。
+    const categoryId = query.navigationId ?? query.categoryId
+    // 聚合场景：前端递归收集父栏目下所有子栏目的 navigationId，以逗号串传入。
+    // 上游 article 用 categoryIdsStr 字段接收（与现有 categoryIds Set 分支并存），有则走 IN 查询。
+    const categoryIds = query.categoryIds as string | undefined
+
+    const res = await $fetch('/cms/cms-article/page', {
+      baseURL: modulesApiBase,
+      headers: {
+        TenantId: ctx.tenantId
+      },
+      query: {
+        page: 1,
+        limit: 10,
+        ...query,
+        navigationId: categoryIds ? undefined : query.navigationId,
+        categoryId: categoryIds ? undefined : categoryId,
+        categoryIdsStr: categoryIds || undefined,
+        // C 端只展示已发布文章：status 0=已发布 1=草稿 2=下架（与早期假设相反，已于 2026-07-29 校正）
+        // 放在最后以覆盖前端可能传入的 status，避免泄露草稿/下架内容
+        status: 0,
+        // 同时排除软删除(deleted=1)的文章，兜底防止已删除内容出现在前台
+        deleted: 0
+      }
+    })
+
+    return res
+  } catch (error: any) {
+    throw createError({
+      statusCode: error?.statusCode || error?.response?.status || 502,
+      statusMessage: error?.statusMessage || 'Failed to fetch article list'
+    })
+  }
+})