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,56 @@
+import { $fetch } from 'ofetch'
+import { createError, defineEventHandler, getQuery } from 'h3'
+import { useRuntimeConfig } from '#imports'
+import { getTenantFromContext } from '../../utils/tenant'
+import { normalizeCaseItem } from '../../utils/case'
+
+/**
+ * 案例详情
+ * GET /api/case/detail?id=1
+ * 代理到 SaaS 后端 CMS 案例详情接口
+ */
+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 {
+    // 上游 cms-website 服务没有 caseDetail 这类路由（会被 /cms/cms-website/{id} 兜底捕获并因 id 非整数报错），
+    // 正确的案例详情端点属于 cms-case 控制器，且 id 走路径参数：/cms/cms-case/{id}
+    res = await $fetch(`/cms/cms-case/${query.id}`, {
+      baseURL: modulesApiBase,
+      headers: {
+        TenantId: ctx.tenantId
+      },
+      // TenantId 同时放入 query 兜底（详情端点实测认 query 的 TenantId）
+      query: { ...query, TenantId: ctx.tenantId }
+    })
+  } catch (error: any) {
+    throw createError({
+      statusCode: error?.statusCode || error?.response?.status || 502,
+      statusMessage: error?.statusMessage || 'Failed to fetch case detail'
+    })
+  }
+
+  // C 端不展示草稿(1)/下架(2)/已删除案例：status 非 0(已发布) 或 deleted=1 视为不存在
+  // 上游真实枚举：0=已发布 1=草稿 2=下架（与早期假设相反，已于 2026-07-29 校正）
+  // 上游对不存在/未发布案例常返回 {code:1, message:"...不存在"}（无 data），
+  // 此时 res.code !== 0，必须 404，否则扁平后的对象为 truthy，前端会误判为「存在」渲染空页。
+  const detail = res?.data ?? res
+  if (typeof res?.code === 'number' && res.code !== 0) {
+    throw createError({ statusCode: 404, statusMessage: 'Case not found or unpublished' })
+  }
+  if (!detail || detail.status === undefined || detail.status !== 0 || detail.deleted === 1) {
+    throw createError({ statusCode: 404, statusMessage: 'Case not found or unpublished' })
+  }
+
+  // 返回扁平数据，去掉上游 {code, message, data} 包装层，
+  // 并归一化为前端模板约定的字段（id / title / clientName …）。
+  return normalizeCaseItem(detail)
+})
@@ -0,0 +1,65 @@
+import { $fetch } from 'ofetch'
+import { createError, defineEventHandler, getQuery } from 'h3'
+import { useRuntimeConfig } from '#imports'
+import { getTenantFromContext } from '../../utils/tenant'
+import { normalizeCaseItem } from '../../utils/case'
+
+/**
+ * 案例列表
+ * GET /api/case/list?categoryId=1&page=1&limit=10
+ * 代理到 SaaS 后端 CMS 案例列表接口
+ * 注意：上游 cms-website 服务没有 caseList 这类路由（会被 /cms/cms-website/{id} 兜底捕获并因 id 非整数报错），
+ * 正确的案例列表端点属于 cms-case 控制器：/cms/cms-case/page
+ */
+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-case 实际按 categoryId 过滤，
+    // 二者在 CMS 中同值（案例分类 ID == 对应栏目 navigationId），故透传 categoryId。
+    // 同时保留 navigationId 以兼容少数按 navigationId 过滤的租户。
+    const categoryId = query.navigationId ?? query.categoryId
+    // 聚合场景：前端递归收集父栏目下所有子栏目的 navigationId，以逗号串传入。
+    // 有 categoryIds 时优先走 IN 查询，忽略单值 categoryId，避免 AND 冲突。
+    const categoryIds = query.categoryIds as string | undefined
+
+    const res = await $fetch('/cms/cms-case/page', {
+      baseURL: modulesApiBase,
+      headers: {
+        TenantId: ctx.tenantId
+      },
+      // TenantId 同时放入 query 兜底（page 端点实测认 query 的 TenantId）
+      // status 0=已发布 1=草稿 2=下架（与早期假设相反，已于 2026-07-29 校正），C 端只展示已发布，放最后覆盖前端传入
+      query: {
+        ...query,
+        navigationId: categoryIds ? undefined : query.navigationId,
+        categoryId: categoryIds ? undefined : categoryId,
+        categoryIds: categoryIds || undefined,
+        TenantId: ctx.tenantId,
+        status: 0,
+        // 同时排除软删除(deleted=1)的案例，兜底防止已删除内容出现在前台
+        deleted: 0
+      }
+    })
+
+    // 上游返回 {code, message, data: {list, count}} 包装层，
+    // 前端 CaseList 直接读 data.value?.list，故在此去掉包装并把每条记录
+    // 归一化为前端模板约定的字段（id / title / clientName …）。
+    const envelopeData = (res && res.data !== undefined ? res.data : res) || {}
+    const rawList = Array.isArray(envelopeData.list) ? envelopeData.list : []
+    const count = envelopeData.count ?? envelopeData.total ?? rawList.length
+
+    return {
+      list: rawList.map(normalizeCaseItem),
+      count
+    }
+  } catch (error: any) {
+    throw createError({
+      statusCode: error?.statusCode || error?.response?.status || 502,
+      statusMessage: error?.statusMessage || 'Failed to fetch case list'
+    })
+  }
+})