Skip to content
LKCMS 文档

项目结构

LKCMS 项目目录组织与模块划分

项目结构

了解 LKCMS 的目录组织,便于二次开发和扩展。

顶层目录

lkcms/
├── src/                    # 主应用源码
│   ├── app/               # Next.js App Router
│   ├── db/                # 数据库 Schema 与迁移
│   ├── lib/               # 工具库与业务逻辑
│   └── ...
├── lk-themes/             # 前台主题
│   └── lkcms-default/     # 默认主题
├── content/               # 文档内容(MDX)
│   └── docs/
├── public/                # 静态资源
└── ...

核心目录说明

src/app

Next.js App Router 路由与页面:

  • [locale]/(lkcms)/ - 前台页面(首页、产品、新闻等)
  • admin/ - 管理后台
  • api/ - API 路由

src/db

数据库相关:

  • schema/ - Drizzle ORM 表定义
  • seeds/ - 种子数据
  • migrations/ - 迁移文件

lk-themes

前台主题,每个主题包含:

  • pages/ - 页面组件(HomePage, NewsListPage 等)
  • components/ - 公共组件(Header, Footer)
  • README.md - 主题说明

主题加载机制

LKCMS 通过 LKThemeLoader 动态加载主题,主题目录需符合约定:

  • 页面组件导出为默认导出
  • 使用 useTranslations 做多语言
  • 遵循 docs/development/theme-development.md 规范

下一步

On this page