aicodcms

aicodcms

为什么选择 aicodcms

aicodcms 是一套用 Go 语言从头构建的 CMS 系统。它不是一个 WordPress 的克隆，也不是某个 PHP CMS 的 Go 移植——它从架构层面重新审视了「内容管理系统」应该是什么样子。

核心设计理念只有一条：权限管理是骨架，内容管理是血肉，插件是器官。

1. 核心架构

┌──────────────────────────────────────────┐
│            Vue 3 管理后台                 │
├──────────────────────────────────────────┤
│    Casbin RBAC  ─── PMS 权限引擎         │
├──────────────────────────────────────────┤
│  Account │ CMS │ Order │ Product │ ...   │
├──────────────────────────────────────────┤
│  Pay │ Mail │ Upload │ Sitemap │ ...     │  插件
├──────────────────────────────────────────┤
│        GoFrame v2 框架                    │
├──────────────────────────────────────────┤
│        MySQL 8.x                         │
└──────────────────────────────────────────┘

PMS：不可动摇的核心

所有功能模块——无论是 CMS、Order、还是任何一个插件——都通过 PMS 的 Casbin 引擎获得权限。删除任何业务模块都不会影响系统运行，但 PMS 是整个系统的骨架。

这意味着 aicodcms 可以是一个博客、一个商城、一个游戏后台、或者三者同时——只需加载不同的插件。

插件注入机制

// 每个模块只需实现 Plugin 接口
type Plugin interface {
    Name() string
    Migrations() []string                // 数据库迁移
    InitRouter(group *ghttp.RouterGroup) // 路由注册
}

// init() 中注册，主路由零 import 感知
func init() { plugin.Register(&cmsPlugin{}) }

主路由通过名称查找插件，不硬编码任何 import。添加新模块不需要修改一行框架代码。

2. 多语言支持

不只是字符串翻译

aicodcms 的多语言不是简单的「字典查表」。它是站群级别的多语言体系：

• zh-CN / en-US 双语言激活：框架声明 34 种语言，通过激活机制按需启用
• 前端 + 后端统一 i18n：Vue 端用 $t()，Go 端用 g.I18n().Tf()，共用 TOML 翻译文件
• 文章级多语言：每篇文章可以有独立的翻译版本，存储在 article_translation 和 topic_translation 两表中
• URL 级别的多语言：/zh-CN/article/123 和 /en-US/article/123 各自独立
• Sitemap hreflang：自动生成多语言 SEO 标签

翻译联动机制

CMS 文章保存时，自动触发翻译服务：

Article Add/Edit → Translation.SaveArticleTranslation()
  ├── 百度翻译 API → 自动机翻
  ├── 缓存（下次编辑同一篇不重新翻译）
  └── 手动覆盖（人工翻译优先）

Translation 是共享服务层，不暴露独立 API——它被 Article、Channel、Tag、Page 等所有内容模块内部调用。这种设计让最终用户无需关心「翻译管理」这个独立概念——翻译就是内容编辑的一部分。

3. 模板函数体系

对标帝国 CMS 标签，但有类型安全

aicodcms 的模板引擎灵感来自帝国 CMS 的标签系统，但去掉了所有魔法字符串：

帝国 CMS:  [!--title--]  [!--classname--]  [!--pageurl--]
aicodcms:  .Title        .ChanName         .PageUrl

每一个字段都是 Go 的方法调用，有编译期类型检查。不存在拼错标签名导致的运行时空白。

CmsCtx：双引擎共用的上下文

// 一个 CmsCtx 实例同时服务 gview 和 templ
ctx := NewCmsCtx("zh-CN")

// 文章查询
ctx.ArticleList(channelID, 10)   // 栏目文章列表（自动分页）
ctx.BlockArticle("home_slider")  // 区块文章
ctx.SearchArticle("关键词", 10)  // 全文搜索

// 上一篇 / 下一篇（无需手动写 SQL）
ctx.PrevUrl    ctx.PrevTitle
ctx.NextUrl    ctx.NextTitle

// URL 生成
ctx.ArticleUrl(id)  // /zh-CN/article/123.html
ctx.ChanUrl(id)     // /zh-CN/channel/5
ctx.PageUrl(id)     // /zh-CN/page/about

// 当前文章
ctx.Article.Id     ctx.Article.Title     ctx.Article.Content
ctx.Article.Views  ctx.Article.Price     ctx.Article.Tags

// 分页
ctx.PageHtml       // 分页 HTML，直接输出
ctx.TotalPages     ctx.CurrentPage

// 国际化
ctx.T("menu_home")     // 翻译
ctx.FormatTime(ts)     // 时间格式化
ctx.SubStr(s, 200)     // 截取

关键设计：所有查询结果都带缓存。 ArticleList 在同一请求中被多次调用时，只执行一次 SQL。模板作者不需要关心性能——引擎帮你做了 L1（请求级）和 L2（进程级）两层缓存。

4. 双模板引擎

为什么需要两套引擎

gview 引擎

Go 标准模板语法，模板文件放在 resource/template/cms/theme/{主题名}/。

{{ $ctx := .Init . }}
<h1>{{ $ctx.SiteName }}</h1>
{{ range $ctx.ArticleList 2 10 }}
    <a href="{{ $ctx.ArticleUrl .Id }}">{{ .Title }}</a>
{{ end }}

• 支持 {主题名}/ 下的无限子目录
• 修改文件无需重启（开发模式）
• 完整的 gview 函数体系（条件、循环、管道、自定义函数）

templ 引擎

templ 是 Go 生态的新一代 HTML 模板引擎——模板在编译期被转译为 Go 代码。

templ ArticleDetail(ctx *tpl.CmsCtx) {
    <article>
        <h1>{ ctx.Article.Title }</h1>
        @tpl.Raw(ctx.Article.Content)
    </article>
}

• 编译期类型检查——永远不会出现「忘了传变量」的运行时错误
• 编译到二进制——生产环境零文件 IO，无路径遍历风险
• GoLand 原生支持——自动补全、语法高亮、跳转定义
• 和 gview 共享同一套 CmsCtx API——切换引擎不改模板逻辑

双引擎切换

在后台选择主题时，系统自动检测模板文件类型：

主题目录
├── layout.html     → gview 引擎
└── layout.templ    → templ 引擎

一套系统，两种渲染方式。用户根据需要选择，不需要改任何配置。

5. 其他技术亮点

静态页面生成

• MakeHtml：gcron 定时全站静态化 + 手动触发
• 文章详情、列表、栏目、标签、单页——全部 .html 输出
• 发布即刻生成，爬虫友好

灵活的内容模型

model_id = 1 → 文章（cms_article_topic 存正文）
model_id = 2 → 下载（cms_article_topic_down 存下载信息）
model_id = 3 → 电影（cms_article_topic_movie 存播放信息）

一个 article 表，三种扩展，用 model_id 区分。新增内容类型只需加一张扩展表，不动主表。

数据库设计

• 软删除：deleted_at 字段，GoFrame 自动处理
• Snowflake UID：分布式唯一，不依赖自增 ID
• 原子余额扣减：UPDATE SET balance = balance - ? WHERE balance >= ?，防超卖
• SQLite 支持：开发环境可用 SQLite 替代 MySQL

通用订单系统

order 表用 module 字段区分来源：

module = "game"     → 游戏 SDK 订单
module = "product"  → 商品订单
module = "article"  → 付费文章

一套订单模型，所有业务共享。新增业务类型不需要新建订单表。

API 响应规范

{ "code": 0, "msg": "ok", "data": { ... } }

所有接口统一响应格式，前端无需区分不同模块的返回结构。

快速开始

# 数据库
mysql -u root -p < sql/aicodcms.sql

# 编译
go build -o aicodcms .

# 运行
./aicodcms

后台：http://localhost:8201
账户：admin / 123456

文档

私有扩展

[game] 游戏管理 · [SDK Gateway] 认证 · [Ban] 封禁 · [Google/Apple Pay]

→ aicodcms-pro

协议

MIT License