- bodyClassName?: string
- Provider?: ComponentType<{ children: ReactNode }>
-}
-
-export interface CmsExtension {
- name: string
- providers?: ComponentType<{ children: ReactNode }>[]
- Layout?: ComponentType<{ children: ReactNode }>
-}
diff --git a/dashboard/src/lib/marketingContent.ts b/dashboard/src/lib/marketingContent.ts
new file mode 100644
index 0000000..03e48d7
--- /dev/null
+++ b/dashboard/src/lib/marketingContent.ts
@@ -0,0 +1,269 @@
+import path from 'path'
+
+import { readMarkdownDirectory } from './markdown'
+
+export interface HeroContent {
+ eyebrow?: string
+ title: string
+ subtitle?: string
+ primaryCtaLabel?: string
+ primaryCtaHref?: string
+ secondaryCtaLabel?: string
+ secondaryCtaHref?: string
+ highlights: string[]
+ bodyHtml: string
+}
+
+export interface HeroSolution {
+ slug: string
+ title: string
+ tagline?: string
+ description?: string
+ features: string[]
+ bodyHtml: string
+ primaryCtaLabel?: string
+ primaryCtaHref?: string
+ secondaryCtaLabel?: string
+ secondaryCtaHref?: string
+ tertiaryCtaLabel?: string
+ tertiaryCtaHref?: string
+}
+
+export interface HomepagePost {
+ slug: string
+ title: string
+ author?: string
+ date?: string
+ readingTime?: string
+ tags: string[]
+ excerpt: string
+ contentHtml: string
+}
+
+export interface SidebarSection {
+ slug: string
+ title: string
+ layout?: string
+ tags: string[]
+ bodyHtml: string
+ ctaLabel?: string
+ ctaHref?: string
+ order?: number
+}
+
+export interface ContactItemContent {
+ slug: string
+ title: string
+ type?: string
+ description?: string
+ bodyHtml: string
+ qrValue?: string
+ qrImage?: string
+ icon?: string
+ ctaLabel?: string
+ ctaHref?: string
+}
+
+export interface ContactPanelContent {
+ title: string
+ subtitle?: string
+ bodyHtml?: string
+ items: ContactItemContent[]
+}
+
+const HERO_CONTENT: HeroContent = {
+ eyebrow: '云原生套件',
+ title: '构建一体化的云原生工具集',
+ subtitle:
+ '将资产管理、访问控制、可观测与自动化工作流整合到一个响应迅速的体验里，帮助团队高效落地治理策略。',
+ primaryCtaLabel: '立即体验',
+ primaryCtaHref: '/register',
+ secondaryCtaLabel: '产品文档',
+ secondaryCtaHref: '/docs',
+ highlights: [
+ '跨集群纳管与多云环境统一治理',
+ '以策略为核心的安全与合规编排',
+ '数据驱动的可观测与成本分析',
+ '场景化模板快速对接业务流程',
+ ],
+ bodyHtml:
+ 'XControl 采用模块化架构设计，可在保持核心稳定的前提下按需引入观测、身份、编排等能力包。通过开放 API 与事件流，您可以轻松连接现有的 DevOps 工具链，让业务交付与平台治理协同运转。
',
+}
+
+const HERO_SOLUTIONS: HeroSolution[] = [
+ {
+ slug: 'xcloudflow',
+ title: 'XCloudFlow',
+ tagline: '多云 IaC',
+ description: '通过声明式模型统一编排多云基础设施，自动化落地资源策略与合规标准。',
+ features: ['跨云资源蓝图与参数化交付', 'GitOps 工作流驱动基础设施变更', '内置审批、审计保障合规'],
+ bodyHtml:
+ 'XCloudFlow 将 Terraform、Pulumi 等主流 IaC 模型统一到一个工作台，为多云环境提供自助式交付与集中治理。
',
+ primaryCtaLabel: '立刻体验',
+ primaryCtaHref: '/demo?product=xcloudflow',
+ secondaryCtaLabel: '下载链接',
+ secondaryCtaHref: '/download?product=xcloudflow',
+ tertiaryCtaLabel: '文档链接',
+ tertiaryCtaHref: '/docs/xcloudflow',
+ },
+ {
+ slug: 'xscopehub',
+ title: 'XScopeHub',
+ tagline: 'AI & 可观察性',
+ description: '利用 AI 驱动的分析工作台，统一日志、指标与追踪，快速定位异常并推荐修复路径。',
+ features: ['全栈可观察性数据联邦检索', '智能告警关联与根因分析', '预置 AI 助手生成运维建议'],
+ bodyHtml:
+ 'XScopeHub 通过语义化检索与时序分析，实现跨环境的可观察性汇聚与智能洞察。
',
+ primaryCtaLabel: '立刻体验',
+ primaryCtaHref: '/demo?product=xscopehub',
+ secondaryCtaLabel: '下载链接',
+ secondaryCtaHref: '/download?product=xscopehub',
+ tertiaryCtaLabel: '文档链接',
+ tertiaryCtaHref: '/docs/xscopehub',
+ },
+ {
+ slug: 'xstream',
+ title: 'XStream',
+ tagline: '网络加速器',
+ description: '按需构建全球传输网络，保障跨地域应用与数据同步的稳定低时延体验。',
+ features: ['动态最优路径与带宽调度', '内置零信任安全与访问控制', '对接主流 CDN 与边缘节点'],
+ bodyHtml:
+ 'XStream 通过软件定义的网络加速技术，为实时互动、音视频与数据分发提供稳定的全球链路。
',
+ primaryCtaLabel: '立刻体验',
+ primaryCtaHref: '/demo?product=xstream',
+ secondaryCtaLabel: '下载链接',
+ secondaryCtaHref: '/download?product=xstream',
+ tertiaryCtaLabel: '文档链接',
+ tertiaryCtaHref: '/docs/xstream',
+ },
+]
+
+const CONTACT_PANEL: ContactPanelContent = {
+ title: '保持联系',
+ subtitle: '扫码关注或加入社区，获取最新产品动态与支持。',
+ items: [
+ {
+ slug: 'wechat-official',
+ title: '微信公众号',
+ type: 'qr',
+ description: '了解商业产品和专业支持服务',
+ bodyHtml: '关注 XControl 官方公众号，解锁上云实践案例与专家分享。',
+ qrValue: 'https://xcontrol.cloud/contact/wechat-official',
+ qrImage: 'https://dl.svc.plus/images/contact/wechat-official.jpg',
+ },
+ {
+ slug: 'wechat-group',
+ title: '加入微信群',
+ type: 'qr',
+ description: '与产品团队和同行实时交流',
+ bodyHtml: '添加 XControl 社区小助手，获取最新活动信息并加入兴趣小组。',
+ qrValue: 'https://xcontrol.cloud/contact/wechat-community',
+ qrImage: 'https://dl.svc.plus/images/contact/wechat-group.jpg',
+ },
+ {
+ slug: 'support',
+ title: '获取支持',
+ type: 'info',
+ description: '了解使用反馈与社区支持',
+ bodyHtml:
+ '欢迎提交您的使用反馈或功能建议，我们会尽快回复。
如需寻求技术帮助，可联系：manbuzhe2008@gmail.com
',
+ icon: 'life-buoy',
+ ctaLabel: '联系我们',
+ ctaHref: 'https://github.com/svc-design/XControl/issues',
+ },
+ {
+ slug: 'github-star',
+ title: '欢迎支持',
+ type: 'info',
+ description: '欢迎支持关注 Star',
+ bodyHtml: '点击链接访问 CloudNativeSuite GitHub，欢迎支持关注 Star，获取更多项目动态。',
+ icon: 'star',
+ ctaLabel: '访问 GitHub',
+ ctaHref: 'https://github.com/CloudNativeSuite',
+ },
+ ],
+}
+
+const BLOG_CONTENT_ROOT = path.join(process.cwd(), 'src', 'content', 'blog')
+
+function extractExcerpt(markdown: string): string {
+ const blocks = markdown.split(/\r?\n\s*\r?\n/)
+ for (const block of blocks) {
+ const trimmed = block.trim()
+ if (!trimmed) continue
+ const withoutFormatting = trimmed
+ .replace(/^#+\s*/g, '')
+ .replace(/[`*_>\[\]]/g, '')
+ .replace(/\[(.*?)\]\((.*?)\)/g, '$1')
+ if (withoutFormatting.trim()) {
+ return withoutFormatting.trim()
+ }
+ }
+ return ''
+}
+
+export async function getHomepageHero(): Promise {
+ return HERO_CONTENT
+}
+
+export async function getHeroSolutions(): Promise {
+ return HERO_SOLUTIONS
+}
+
+export async function getHomepagePosts(): Promise {
+ let posts: HomepagePost[] = []
+ try {
+ const files = await readMarkdownDirectory('', { baseDir: BLOG_CONTENT_ROOT })
+
+ posts = files.map((file) => {
+ const title = typeof file.metadata.title === 'string' ? file.metadata.title : file.slug
+ const author = typeof file.metadata.author === 'string' ? file.metadata.author : undefined
+ const date = typeof file.metadata.date === 'string' ? file.metadata.date : undefined
+ const readingTime =
+ typeof file.metadata.readingTime === 'string' ? file.metadata.readingTime : undefined
+ const tags = Array.isArray(file.metadata.tags)
+ ? file.metadata.tags.filter((tag): tag is string => typeof tag === 'string')
+ : []
+ const excerptMetadata = typeof file.metadata.excerpt === 'string' ? file.metadata.excerpt : undefined
+ const excerpt = excerptMetadata ?? extractExcerpt(file.content)
+
+ return {
+ slug: file.slug,
+ title,
+ author,
+ date,
+ readingTime,
+ tags,
+ excerpt,
+ contentHtml: file.html,
+ }
+ })
+ } catch (error) {
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {
+ throw error
+ }
+ }
+
+ const withParsedDates = posts.map((post) => ({
+ ...post,
+ dateValue: post.date ? new Date(post.date) : undefined,
+ }))
+
+ withParsedDates.sort((a, b) => {
+ if (a.dateValue && b.dateValue) {
+ return b.dateValue.getTime() - a.dateValue.getTime()
+ }
+ if (a.dateValue) return -1
+ if (b.dateValue) return 1
+ return a.title.localeCompare(b.title)
+ })
+
+ return withParsedDates.map(({ dateValue: _dateValue, ...post }) => post)
+}
+
+export async function getContactPanelContent(): Promise {
+ if (!CONTACT_PANEL.items.length) {
+ return undefined
+ }
+ return CONTACT_PANEL
+}
diff --git a/dashboard/src/modules/templateRegistry.ts b/dashboard/src/modules/templateRegistry.ts
index ff0c60c..3264555 100644
--- a/dashboard/src/modules/templateRegistry.ts
+++ b/dashboard/src/modules/templateRegistry.ts
@@ -1,12 +1,11 @@
import fs from 'node:fs'
import path from 'node:path'
-import { cmsConfig } from '@cms/config'
-import type { CmsTemplate } from '@cms/types'
-
import defaultTemplate from './templates/default'
import type { TemplateDefinition } from './templates/types'
+type CmsTemplate = TemplateDefinition
+
const BUILTIN_TEMPLATES: Record = {
default: defaultTemplate,
}
@@ -64,8 +63,7 @@ export function resolveTemplateName(explicitName?: string, options?: TemplateSel
}
const envOverride =
- typeof process !== 'undefined' &&
- (process.env.NEXT_PUBLIC_TEMPLATE || process.env.CMS_TEMPLATE)
+ typeof process !== 'undefined' && (process.env.NEXT_PUBLIC_TEMPLATE || process.env.CMS_TEMPLATE)
if (envOverride) {
return envOverride
@@ -75,7 +73,7 @@ export function resolveTemplateName(explicitName?: string, options?: TemplateSel
throw new Error('Template name not provided and config fallback disabled.')
}
- return cmsConfig.template
+ return 'default'
}
export function getActiveTemplate(options?: TemplateSelectionOptions): CmsTemplate {
diff --git a/dashboard/src/lib/cms/templates/default/config.ts b/dashboard/src/modules/templates/default/config.ts
similarity index 86%
rename from dashboard/src/lib/cms/templates/default/config.ts
rename to dashboard/src/modules/templates/default/config.ts
index 802e4be..03a451e 100644
--- a/dashboard/src/lib/cms/templates/default/config.ts
+++ b/dashboard/src/modules/templates/default/config.ts
@@ -1,4 +1,4 @@
-import type { CommonHomeLayoutConfig } from '@templates/layouts/commonHome'
+import type { CommonHomeLayoutConfig } from '../layouts/commonHome'
export const defaultHomeLayoutConfig: CommonHomeLayoutConfig = {
rootClassName: 'relative min-h-screen bg-brand-surface text-brand-navy antialiased',
@@ -17,8 +17,6 @@ export const defaultHomeLayoutConfig: CommonHomeLayoutConfig = {
containerClassName: 'relative px-8',
contentClassName: 'mx-auto w-full max-w-6xl',
gridClassName: 'grid gap-8 lg:grid-cols-[minmax(0,1fr)_360px] lg:items-start lg:gap-12',
- slots: [
- { key: 'CommunityFeed' },
- ],
+ slots: [{ key: 'CommunityFeed' }],
},
}
diff --git a/dashboard/src/modules/templates/default/index.tsx b/dashboard/src/modules/templates/default/index.tsx
index eed8715..ae5d3d7 100644
--- a/dashboard/src/modules/templates/default/index.tsx
+++ b/dashboard/src/modules/templates/default/index.tsx
@@ -1,7 +1,7 @@
import ProductMatrix from '@components/home/ProductMatrix'
import Sidebar from '@components/home/Sidebar'
-import { defaultHomeLayoutConfig } from '@cms/templates/default/config'
+import { defaultHomeLayoutConfig } from './config'
import { createCommonHomeTemplate } from '../layouts/commonHome'
import type { TemplateDefinition } from '../types'
diff --git a/dashboard/tests/unit/templateRegistry.test.ts b/dashboard/tests/unit/templateRegistry.test.ts
deleted file mode 100644
index 22b1338..0000000
--- a/dashboard/tests/unit/templateRegistry.test.ts
+++ /dev/null
@@ -1,128 +0,0 @@
-import fs from 'node:fs'
-import path from 'node:path'
-
-import { describe, expect, it, beforeEach, afterEach, vi } from 'vitest'
-
-import { cmsConfig } from '@cms/config'
-
-vi.mock('@cms/content/source', () => ({
- resolveContentSource: () => ({
- absolutePath: 'src/lib/cms/content',
- }),
-}))
-
-import {
- __resetTemplateRegistryForTests,
- getActiveTemplate,
- listRegisteredTemplateNames,
- registerTemplate,
- registerTemplateLoader,
- resolveTemplateName,
- type TemplateDefinition,
-} from '@modules/templateRegistry'
-
-const originalTemplateName = cmsConfig.template
-const templateFixturesPath = path.join(process.cwd(), 'src', 'modules', 'templates', 'fs-template')
-
-const runtimeTemplate: TemplateDefinition = {
- name: 'runtime',
- pages: {
- home: () => null,
- },
-}
-
-beforeEach(() => {
- __resetTemplateRegistryForTests()
- cmsConfig.template = 'default'
- delete process.env.NEXT_PUBLIC_TEMPLATE
- delete process.env.CMS_TEMPLATE
- fs.rmSync(templateFixturesPath, { recursive: true, force: true })
-})
-
-afterEach(() => {
- cmsConfig.template = originalTemplateName
- delete process.env.NEXT_PUBLIC_TEMPLATE
- delete process.env.CMS_TEMPLATE
- __resetTemplateRegistryForTests()
- const modulePath = path.join(templateFixturesPath, 'index.js')
- delete require.cache[modulePath]
- fs.rmSync(templateFixturesPath, { recursive: true, force: true })
-})
-
-describe('templateRegistry', () => {
- it('returns the default template from configuration', () => {
- const template = getActiveTemplate()
- expect(template.name).toBe('default')
- })
-
- it('prefers an explicit template name over configuration', () => {
- registerTemplate('runtime', runtimeTemplate)
- const template = getActiveTemplate({ name: 'runtime' })
- expect(template).toBe(runtimeTemplate)
- })
-
- it('allows environment variables to override the template', () => {
- registerTemplate('runtime', runtimeTemplate)
- process.env.NEXT_PUBLIC_TEMPLATE = 'runtime'
- const template = getActiveTemplate()
- expect(template).toBe(runtimeTemplate)
- })
-
- it('throws when config fallback is disabled and name is missing', () => {
- expect(() => resolveTemplateName(undefined, { fallbackToConfig: false })).toThrowError()
- })
-
- it('supports registering custom loaders', () => {
- const loaderTemplate: TemplateDefinition = {
- name: 'loader',
- pages: {
- home: () => null,
- },
- }
-
- registerTemplateLoader((name) => {
- return name === 'loader-template' ? loaderTemplate : null
- })
-
- const template = getActiveTemplate({ name: 'loader-template', fallbackToConfig: false })
- expect(template).toBe(loaderTemplate)
- })
-
- it('discovers templates from the filesystem', () => {
- fs.mkdirSync(templateFixturesPath, { recursive: true })
- const templateModulePath = path.join(templateFixturesPath, 'index.js')
- fs.writeFileSync(
- templateModulePath,
- "module.exports = { name: 'fs-template', pages: { home: () => null } };\n",
- 'utf8',
- )
-
- delete require.cache[templateModulePath]
- expect(fs.existsSync(templateModulePath)).toBe(true)
- expect(
- path.join(process.cwd(), 'src', 'modules', 'templates', 'fs-template', 'index.js')
- ).toBe(templateModulePath)
-
- cmsConfig.template = 'fs-template'
- const template = getActiveTemplate()
- expect(template.name).toBe('fs-template')
- })
-
- it('keeps the @cms facade compatible', async () => {
- const direct = getActiveTemplate()
-
- vi.stubGlobal('window', undefined)
- const { getActiveTemplate: legacyGetActiveTemplate } = await import('@cms')
- vi.unstubAllGlobals()
-
- const facade = legacyGetActiveTemplate()
- expect(facade).toEqual(direct)
- })
-
- it('lists registered template names including runtime additions', () => {
- registerTemplate('runtime', runtimeTemplate)
- const names = listRegisteredTemplateNames()
- expect(names).toContain('default')
- expect(names).toContain('runtime')
- })
-})
diff --git a/dashboard/tests/unit/vitest.config.ts b/dashboard/tests/unit/vitest.config.ts
index 5a7eb9c..3c1db85 100644
--- a/dashboard/tests/unit/vitest.config.ts
+++ b/dashboard/tests/unit/vitest.config.ts
@@ -21,7 +21,6 @@ export default defineConfig({
resolve: {
alias: {
'@components': path.resolve(__dirname, '..', '..', 'src', 'components'),
- '@cms': path.resolve(__dirname, '..', '..', 'src', 'lib', 'cms'),
'@i18n': path.resolve(__dirname, '..', '..', 'src', 'i18n'),
'@lib': path.resolve(__dirname, '..', '..', 'src', 'lib'),
'@types': path.resolve(__dirname, '..', '..', 'types'),
diff --git a/dashboard/tsconfig.json b/dashboard/tsconfig.json
index 35f6602..7eec30b 100644
--- a/dashboard/tsconfig.json
+++ b/dashboard/tsconfig.json
@@ -17,9 +17,6 @@
"jsx": "react-jsx",
"baseUrl": ".", // 👈 根路径基准
"paths": {
- "@cms": ["src/lib/cms/index.ts"], // 👈 增加这行以兼容 import "@cms"
- "@cms/*": ["src/lib/cms/*"],
-
"@components/*": ["src/components/*"],
"@i18n/*": ["src/i18n/*"],
"@lib/*": ["src/lib/*"],