English 最新说明以中文版为主，稳定分支为master.
此项目代号为 fafacms。花花拼音 fafa，名称来源于广东话发发，花花的谐音，听起来有诙谐，娱乐等感觉。
是一个使用 Golang 开发的前后端分离 --> 内容管理系统(CMS)，支持不同用户登录，并且可以发布文章，在首页可以看到不同用户的文章。本项目愿景是希望使用较简洁较规范的企业开发模式，可以给初学者一个示例。你可以把它当作弱化的博客园或简书。
后端主要返回JSON API，前端可用任意框架开发界面。 该项目架构可扩展为不同业务的Web项目。
依赖以下项目:
- Gin is a HTTP web framework written in Go (Golang)
- The open source embeddable online markdown editor (component).
- Session management for Go 1.7+
- Go Struct and Field validation, including Cross Field, Cross Struct, Map, Slice and Array diving ...
使用Gin是因为框架比较简洁， 主要使用到路由功能。使用 Markdown 编辑器是因为程序员朋友和很多媒体工作者也开始尝鲜...
代码结构:
├── config.json 配置文件
├── core 后端代码
│ ├── config 配置
│ ├── flog 日志
│ ├── controllers 控制器
│ ├── model 模型
│ ├── router 路由
│ ├── server 服务
│ └── util 工具
├── main.go 程序入口
└── web 前端代码(可用vue等开发)
后端API调试见: /doc/README.md, 使用insomnia
- 用户注册，填入相应信息如QQ，微博，邮箱，自我介绍，头像等，然后收到注册邮件，点击进行激活。未激活用户登陆后会显示未激活，无法使用平台。激活后用户可以登录后台编辑内容。用户注册后不提供注销功能。
- 用户根高级权限控制，需要由管理员为用户分配用户组，用户组下有若干路由资源，路由资源均为特殊路由，如激活用户，更改其他用户密码，查看所有用户文章，用户信息等路由，如果用户不进入特殊资源路由，正常使用后台，否则需要具备相应的组权限。该功能为用户无感知隐藏功能。
- 用户信息一般操作，用户登录后台，可以选择一周内免密登录，进入后台后可以随时退出登录以及补充注册时的用户信息，修改密码等。用户忘记密码可以通过邮件找回。
- 内容编辑，用户可以创建内容节点，节点下可以有子节点，但最多两层，节点间实现了拖曳排序的功能，智能无比，在节点下可以新建文章，可以更新内容，设置隐藏文章，文章置顶，设置文章密码等，文章设计了特殊的历史版本功能，可以从历史版本恢复，并且可以对文章进行拖曳排序，以及拖曳移动到另外的节点目录。文章被删除可以回到回收站，回收站可以恢复。
- 首页阅读和内容评论，其他用户可以浏览其他用户文章并进行评论，所有者可以设置自动审核，或者手动审核，通过的评论会被显示，评论有堆楼功能。评论可以由所有者删除，删除的评论及其子评论均会消失。其他用户也可以为内容或者内容的某条评论点赞或者反对，详细记录登陆用户点赞等情况，防止多次点赞。
- 图片存储：用户头像，节点背景图，文章背景图等内部图片均需要通过上传接口保存进数据库，禁止使用不安全图片链接，图片存储在本地或者云对象存储服务中。
- 内容编辑器使用markdown，插入图片时调用图片接口，抽取数据库已上传图片供编辑者选择，在此可以上传本地图片，并为图片打标签等。
- 可以关闭用户注册，将用户加入黑名单，将内容封禁等。
其他详细设计，以及约束请参考实际可用产品。
必须使用SQL层的外键关联来保证数据一致性，模拟外键，即使开启事务也无法避免出现幻读，谨记。
- 系统后端功能
- 内部用户及用户组，资源和授权管理（管理员）
- 创建用户组
- 删除用户组
- 获取组信息
- 更新组信息
- 创建用户
- 获取用户信息
- 更改用户密码
- 禁用用户
- 用户绑定组
- 资源绑定组
- 列出组下的用户
- 列出组下的资源
- 授权拦截
- 列出用户
- 列出用户组
- 列出资源
- 用户登录
- 用户登出
- 用户一周内登录
- 获取个人信息
- 更新个人信息（个人或管理员）
- 文件功能
- 上传文件
- 图片文件裁剪
- 阿里对象存储保存
- 列出文件（个人或管理员）
- 更改文件描述，标签，是否隐藏 （个人或管理员）
- 内容节点及内容功能
- 节点功能
- 创建节点
- 更新节点SEO
- 更新节点名字和描述
- 更新节点背景图
- 设置节点隐藏
- 设置节点的父节点
- 拖曳排序节点
- 删除节点
- 获取节点信息
- 列出节点（个人或管理员）
- 内容功能
- 创建内容
- 更新内容SEO
- 更新内容的标题和正文
- 更新内容背景图
- 设置内容隐藏
- 设置内容置顶
- 设置内容密码
- 更改内容的节点
- 拖曳排序内容
- 内容更新历史记录
- 发布内容
- 恢复历史版本中的内容
- 获取内容信息（个人或管理员）
- 获取历史版本内容（个人或管理员）
- 列出内容（个人或管理员）
- 列出历史版本内容（个人或管理员）
- 设置内容状态，违禁/正常（管理员）
- 内容丢到回收站
- 回收站内容恢复
- 删除回收站内容
-
删除历史版本内容
- 内容评论功能
- 设置内容是否可评论
- 新增评论
- 回复评论
- 列出评论
- 审核评论
- 删除评论
- 节点功能
- 关注和被关注功能
- 标签功能
- 点赞功能
- 内容点赞
- 评论点赞
- 站内信功能
- 管理员群发站内信
- 发布新文章站内信
- 评论以及评论回复站内信
- 关注站和被关注站内信
- 点赞站内信
- 内部用户及用户组，资源和授权管理（管理员）
- 系统中端功能
- 普通用户功能
- 用户注册
- 用户激活
- 重置激活码
- 找回密码
- 邮箱发送激活码和密码重置码
- 列出所有激活未封禁用户
- 获取某用户信息
- 列出某用户全部节点信息
- 获取某用户某节点以及其子节点信息
- 统计用户不同时期发布的正常内容数量
- 列出用户已发布的正常内容
- 获取文章内容
- 获取内容评论
- 获取内容点赞情况
- 获取评论点赞情况
- 普通用户功能
- 系统前端UI功能
- 普通用户后台界面
- 管理员后台界面
- 前端首页界面
- API文档
- 一期基本文档
站内信：
- https://www.cnblogs.com/hejiaquan/archive/2012/04/07/2435817.html
- http://www.cnblogs.com/x-xk/archive/2012/11/17/2770935.html
获取代码:
go get -v github.com/hunterhug/fafacms
代码就会保存在Golang GOPATH目录下.
运行:
fafacms -config=./config.json
其中config.json说明如下（具体参考实际配置）:
{
"DefaultConfig": {
"WebPort": ":8080", # 程序运行端口(可改)
"StoragePath": "./data/storage", # 本地文件保存地址(可改)
"LogPath": "./data/log/fafacms_log.log", # 日志保存地址(可改)
"LogDebug": true # 打开调试(默认保持)
},
"DbConfig": {
"DriverName": "mysql", # 关系型数据库驱动(默认保持)
"Name": "fafa", # 关系型数据库名字(可改)
"Host": "127.0.0.1", # 关系型数据库地址(可改)
"User": "root", # 关系型数据库用户(可改)
"Pass": "123456789", # 关系型数据库密码(可改)
"Port": "3306", # 关系型数据库端口(可改)
"MaxIdleConns": 20, # 关系型数据库池闲置连接数(默认保持)
"MaxOpenConns": 20, # 关系型数据库池打开连接数(默认保持)
"DebugToFile": true, # SQL调试是否输出到文件(默认保持)
"DebugToFileName": "./data/log/fafacms_db.log", # SQL调试输出文件路径(默认保持)
"Debug": true # SQL调试(默认保持)
},
"SessionConfig": {
"RedisHost": "127.0.0.1:6379", # Redis地址(可改)
"RedisMaxIdle": 64, # (默认保持)
"RedisMaxActive": 0, # (默认保持)
"RedisIdleTimeout": 120, # (默认保持)
"RedisDB": 0, # Redis默认连接数据库(默认保持)
"RedisPass": "123456789" # Redis密码(可为空,可改)
}
}
本项目依赖Mysql,Redis和本地存储, 快速部署数据库环境请参考: Docker easy use to run Mysql/Redis.
git clone https://github.com/hunterhug/GoSpider-docker
cd GoSpider-docker
chomd 777 build.sh
./build
sudo docker exec -it GoSpider-mysqldb mysql -uroot -p123456789
> create database fafa default character set utf8mb4 collate utf8mb4_unicode_ci;
sudo docker exec -it GoSpider-redis redis-cli -a 123456789
> KEYS *
你也可以使用docker进行部署, 构建镜像(Docker版本必须大于17.06):
sudo chmod 777 ./docker_build.sh
sudo ./docker_build.sh
先新建数据卷, 并且移动配置并修改:
mkdir /root/fafacms
cp docker_config.json /root/fafacms/config.json
启动容器:
sudo docker run -d --name fafacms -p 8080:8080 -v /root/fafacms:/root/fafacms --env RUN_OPTS="-config=/root/fafacms/config.json" hunterhug/fafacms
sudo docker logs -f --tail 10 fafacms
其中/root/fafacms是挂载的持久化卷, 配置config.json放置在该文件夹下.
Debug:
sudo docker run -d --name fafacms -p 8080:8080 -v /root/fafacms:/root/fafacms --env RUN_OPTS="-config=/root/fafacms/config.json -email_debug=true -auth_skip_debug=true -use_session_redis=true" hunterhug/fafacms
微信支持:
支付宝支持:
