系统简介
命名含义
cf_Ghbf = cf(晨风)+ Go + high-performance + basic + framework,即 Go High-performance Basic Framework(高性能基础框架)。
项目定位
cf_Ghbf 是一套前后端分离的插件化后台管理基础框架:后端基于 Go(Gin + GORM + MySQL + Redis + JWT),管理端基于 Vue 3(TypeScript + Vite + Element Plus + Pinia)。管理端 API 与用户端 API 拥有独立的服务入口与路由,可按业务规模分别部署。
框架的目标不是“快速拼一个后台”,而是让基础能力保持稳定、让业务模块可以独立开发、独立发行、按需安装,并逐步形成可持续的插件生态。
核心能力
| 能力 | 说明 |
|---|---|
| 双端服务 | service admin(管理端,默认 :8001)与 service api(用户端,默认 :8002)独立启动、独立路由 |
| 登录鉴权 | JWT + Redis 登录态,支持主动退出、改密失效、管理员踢下线、账号禁用即失效 |
| RBAC 权限 | 菜单、页面、按钮绑定接口(METHOD:/route),后端权限中间件为最终安全边界 |
| 动态路由 | 后端菜单驱动前端路由,页面路径与 src/views 目录一一对应 |
| 操作审计 | 管理端写操作自动记录日志,敏感参数脱敏,日志查询不产生新日志 |
| 文件存储 | 本地 / 阿里云 OSS / 腾讯云 COS / 七牛 Kodo / MinIO,业务表只存相对路径 |
| 渠道配置 | 短信、微信、支付、平台品牌配置模块开箱即用 |
| 会员体系 | C 端会员:验证码注册登录、单会话令牌、用户编号 sn、管理端启停与脱敏展示 |
| 插件体系 | 源码级插件 + 编译期注册,安装器负责校验、迁移、菜单与注册文件生成 |
技术栈
服务端:Go、Gin、GORM、MySQL、Redis、JWT、Cobra(CLI)、bcrypt(密码加密)
管理端:Vue 3 Composition API、TypeScript、Vite、Element Plus、Pinia、Vue Router、Axios、ECharts
适用场景
- 企业管理后台与内部运营平台
- SaaS 管理端与多业务控制台
- 内容、资讯、知识库与门户系统
- 商城、会员、营销和支付类业务
- 需要沉淀自有插件库的开发团队
快速开始
- 初始化数据库:执行
server_api/sql/v0.0.1/cf_backend_frame.sql及各版本增量脚本。 - 创建配置:
cp config.example.yaml config.yaml,修改 MySQL / Redis / JWT 配置(version必填)。 - 启动服务:
bash
go run . service admin -c config.yaml # 管理端 API
go run . service api -c config.yaml # 用户端 API- 启动管理端:
bash
pnpm install
pnpm dev默认演示账号:admin / 123456(正式环境务必修改)。