FlyCms

FlyCms

一套前后端分离的开源内容建站系统：后台是 Vue 3 单页控制台，前台是 Freemarker 模板站。 核心技术 = 自定义模型引擎：文章、图片、下载、问答、链接……系统的一切内容模块都由后台在线建模生成（建模 → 自动建表 → 字段配置 → 模板渲染），不做第二套硬编码实现。目标是万能系统——用户只靠后台设置，就能生成任何想要的程序模块。历史上硬编码的内容模块正在按规划逐个退役并迁入模型引擎（见 docs/01-规划/主流CMS对标与全项目优化开发方案.md §9.4 阶段 U）。

后端 346 个 Java 文件 / 25 个业务模块 / 21 个 REST 控制器
前端 Vue 3 + TypeScript + Ant Design Vue，73 个页面组件
内容生产：fly_model（模型注册）→ fly_model_field（字段元数据）→ fly_cmodel_{code}（动态数据表）→ 通用管理页 + cmodel 模板通道

一、它现在是什么

FlyCms 最早是一个仿知乎的问答社区程序。经过持续重构，现在的内核是一套五面分离的 CMS 底座：

二、技术栈

后端

前端

后台是 SPA（apps/web-antd），通过 /api/** 与后端通信；前台仍是服务端渲染的 Freemarker 模板站，两者互不干扰。

三、功能清单

前台

• 栏目：列表 / 单页 / 外链 / 聚合四种形态，目录名即 URL，支持无限层级与移动改挂
• 内容模型：后台建模后自动生成数据表，前台按模型 code 路由，列表自带分页条
• 问答：发布问题、悬赏积分邀请回答、答案列表与统计
• 文章：分类无限级、话题聚合、评论、顶踩、收藏
• 分享：分享资源地址赚取积分，支持积分兑换
• 表单：<@fly_form code="..."> 输出表单，提交走 POST /api/form/submit/{code}
• 用户：注册（手机 / 邮箱）、登录验证码与失败次数限制、密码找回、手机 / 邮箱绑定、邀请注册奖励、积分充值
• 互动：关注、粉丝、Feed 动态、收藏、站内信、WebSocket 实时推送
• SEO：/sitemap.xml、/robots.txt 由配置键 fly_sitemap_status / fly_sitemap_limit / fly_robots 控制

后台（Vue 控制台）

平台能力

• 动态菜单与权限：菜单、角色、权限点全部数据驱动，actionKey 同时用于前端按钮显隐（accessCodes）和后端 403 兜底
• 模板版本化：每次保存自动快照，改坏模板可一键回滚
• 定时发布：TimingPublishJob + publish_time 字段，status=4 为待定时发布
• 审计日志：AdminLogInterceptor 记录后台操作，含敏感字段脱敏
• 定时任务：后台启停、Cron 配置、执行日志

四、安全设计

五、目录结构

FlyCms/
├── backend/                       # Java 后端
│   ├── src/main/java/com/flycms/
│   │   ├── config/                # MVC、CORS、WebSocket、Freemarker 沙箱、Druid
│   │   ├── core/                  # 实体、工具类、全局标签、上传安全
│   │   ├── interceptor/           # 登录拦截、审计日志
│   │   ├── module/                # 26 个业务模块（model / channel / template / form ...）
│   │   └── web/
│   │       ├── api/               # /api/** REST（后台 SPA 用）
│   │       ├── front/             # 前台页面控制器
│   │       └── tags/              # Freemarker 自定义标签
│   ├── src/main/resources/
│   │   ├── application.yml
│   │   └── i18n/                  # 国际化
├── frontend/                      # pnpm workspace
│   ├── apps/web-antd/             # 后台控制台（Vue 3）
│   ├── packages/@core/            # 基础能力包
│   └── internal/                  # 构建配置
├── sql/                           # 数据库全量备份快照（最新一份，含结构+数据）
└── docs/                          # 开发规划、模型手册、改造方案、审查报告、运维配置

六、快速开始

环境要求

• JDK 24、Maven 3.6+
• MySQL 8（字符集 utf8mb4）
• Node ^22.18 || ^24.12、pnpm ≥ 11

1. 数据库

sql/ 目录只保留一份全量备份快照（表结构 + 全部数据一体，含所有已上线功能与权限节点），无需再按阶段执行增量脚本：

mysql -u root -p -e "CREATE DATABASE flycms DEFAULT CHARACTER SET utf8mb4;"
mysql -u root -p --default-character-set=utf8mb4 flycms < sql/flycms_20260928_093335.sql

⚠️ 必须加 --default-character-set=utf8mb4：mysql 客户端在某些终端环境默认 latin1 连接，中文数据会真实乱码（写入即损坏，不是显示问题）。

备份快照由 MySQL 5.7.44 导出，兼容 MySQL 8 导入。导入后默认管理员：flycms / admin123（请登录后立即改密）。

备份与更新快照：系统内置纯 Java 全库备份（不依赖 mysqldump），后台「系统工具 → 数据库备份」或直接调用：

curl -X POST http://localhost/api/system/tools/db/backup   # 需管理员会话

备份文件生成于 backend/backup/flycms_*.sql；需要刷新 sql/ 快照时，将最新一份复制过去替换即可。

2. 后端

修改 backend/src/main/resources/application.yml 的数据库连接，然后：

cd backend
mvn clean compile        # 编译
mvn spring-boot:run      # 运行

默认监听 http://localhost:80，前台 http://localhost/；管理控制台是前端 Vue SPA（见下一步）。

3. 前端控制台

cd frontend
pnpm install
pnpm dev:antd            # 开发端口 5666

vite.config.ts 已配置代理：/api/** → 后端 80 端口，/captcha 直连（验证码接口无 /api 前缀）。

4. 常用命令

七、打包部署

cd backend
mvn clean package                     # 产出 target/FlyCms.jar
java -jar target/FlyCms.jar --spring.profiles.active=prod > FlyCms.log 2>&1 &

• 配置外置：复制 application.yml 为 application-prod.yml 后修改（务必改掉默认数据库口令）
• 静态资源与上传目录在 application.yml 的 spring.web.resources.static-locations：./views/static/、./uploadfiles/
• 模板目录：./views/templates/
• 停止：ps -ef | grep FlyCms.jar | grep -v grep | cut -c 9-15 | xargs kill -s 9；看日志：tail -200f FlyCms.log

短信 SDK 使用官方坐标 com.aliyun，Maven 可直接解析，无需手动安装 jar。 Solr 不再需要——检索模块已改为技术中立接缝，不接 ES 也能正常跑（搜索返回空结果）。

八、前台模板与标签

模板放在 views/templates/{主题}/，后台「模板中心」可在线编辑、保存即生成版本快照。

<!-- 模型分页列表，自带分页条 -->
<@fly_page_model model="loupan" rows="10">
  <#list dataList as row>
    <a href="/loupan/${row.shortUrl}.html">${row.title}</a>
  </#list>
  ${pageHtml!''}
</@fly_page_model>

<!-- 碎片位 / 推荐位 -->
<@fly_block key="home_focus">
  <#list block.items as it><img src="${it.image}"></#list>
</@fly_block>

<!-- 表单 -->
<@fly_form code="feedback">
  <form action="/api/form/submit/${form.formCode}" method="post">
    <#list form.fields as f>
      <input name="${f.fieldCode}" placeholder="${f.placeholder!''}">
    </#list>
    <#if form.needCaptcha == 1><img src="/captcha"><input name="captcha"></#if>
  </form>
</@fly_form>

<!-- 按角色显隐 -->
<@fly_userpower groupName="技术专家组">
  <a href="/ucenter/article/add">发布文章</a>
</@fly_userpower>

完整标签清单见后台「模板中心 → 标签手册」，或 TagManualService.java。

九、开发文档

十、已知边界

• 检索：SearchService 目前是空实现（方法签名保留），站内搜索返回空结果；接入 Elasticsearch 时替换实现类即可，调用方无需改动
• 数据库：SQL 仅适配 MySQL，切库需自行改写 Mapper
• 配置文件：application.yml 内含明文数据库口令与 devtools.enabled: true，生产环境务必外置并关闭
• 上传目录：Const.UPLOAD_PATH 是相对路径 ./uploadfiles，部署换工作目录会导致上传丢失，建议配合 docs/nginx-upload-security.conf 做目录约束

十一、贡献

欢迎提 issue 与 PR。提问题时请附上复现步骤、环境版本与日志片段。

License

MIT