engineercms

engineercms copied to clipboard

EngineerCMS

————工程师知识管理系统

Demo ——基于engineercms的设代资料管理平台（真实应用环境）

# 克隆源码
# git clone https://github.com/3xxx/engineercms.git
# go mod vendor

# go mod init
# go包自动安装
# 设置go代理
# go env -w GO111MODULE=on
# go env -w GOPROXY=https://goproxy.cn,direct
# 关闭——这个看情况，go mod vendor时，提示Get https://sum.golang.org/lookup/xxxxxx: dial tcp 216.58.200.49:443: i/o timeout
# go env -w GOSUMDB=off
# go mod tidy
go run main.go
# 编译(sqlite需要CGO支持)
go build -ldflags "-w"
# 数据库初始化(此步骤执行之前，需配置`conf/app.conf`)
# ./engineercms install
# 执行
# $ nohup ./engineercms &

# beego 2.0.0 升级指南
# 获取最新版本的 bee 工具 go get -u github.com/beego/bee/v2
# 更新 beego 框架 go get -u github.com/beego/beego/v2
# 然后进入项目，执行: bee fix -t 2
# 需要注意的是，如果你是 windows 用户，那么你需要在 WSL 内部运行该命令。
# 在项目文件夹下鼠标右键——Git Bash Here
这里需要导入的包是
github.com/beego/beego/v2/server/web/context
而不是
~ github.com/beego/beego/v2/adapter/context ~

目前来说因为你所有的包都切换过去了beego/beego/v2，所以你对应的context要使用beego/beego/v2/server/web/context下的这个。

我教你一个小技巧。当你发现依赖找不到的时候，你把import里面对应的东西删掉，IDE会帮你补全，或者给你提示。如果你用的GOLANG IDE，那么会自动帮你把对应依赖引入。

记住一个核心原则：如果你用的是adapter的包，那么所有的包都应该是adapter的；如果你用的是beego/beego/v2（非adapter)，那么所有的都应该是beego/beego/v2下的。

https://www.cnblogs.com/cqlb/p/13396107.html
一、创建标签
在Git中打标签非常简单，首先，切换到需要打标签的分支上：

1 $ git branch
# 2 * dev
# 3   master
4 $ git checkout master
5 Switched to branch 'master'
git add .
git commit -m "update"
然后，敲命令git tag <tagname>就可以打一个新标签：

$ git tag v2.0.5
因为创建的标签都只存储在本地，不会自动推送到远程。所以，打错的标签可以在本地安全删除。
如果要推送某个标签到远程，使用命令
$ git push origin <tagname>

Administrator@DESK-20210217SN MINGW64 /d/engineercms (master|REBASE-i)
$ git push --delete origin v2.0.0
To https://github.com/3xxx/engineercms
 - [deleted]         v2.0.0

Administrator@DESK-20210217SN MINGW64 /d/engineercms (master|REBASE-i)
$ git push --delete origin v2.0.2
To https://github.com/3xxx/engineercms
 - [deleted]         v2.0.2
如果有人想知道如何一次删除多个标签，你可以用空格简单地列出它们，例如git push --delete origin tag1 tag2。本地标签删除git tag -d tag1 tag2同样有效。

1. 本系统采用go语言（基于beego框架）开发，运行文件为编译后的二进制可执行文件，所以无需像其他语言（php、nodejs、java等语言）编写的web应用那样，需要配置运行服务环境。 本系统既可以运行于工程师个人电脑，也可以放到局域网、公网服务器上运行，仅运行可执行文件即可实现网络化管理项目知识资料，免维护，轻量，开源，功能齐全，采用大量开源的先进插件，是工程师不可或缺的工具。
2. 数据库采用sqlite嵌入式数据库，所以也无需配置数据库服务环境。
3. 开箱即用，无需网络开发知识。
4. 新增加对onlyoffice document server的二次开发，实现企业的实时文档协作，非常方便，避免了文档的汇总等繁琐事物，效率大大提高，协作更加优雅有趣。除了支持office的docx，xlsx及pptx格式外，还支持国产wps，et和dps格式。
5. 在线直接预览dwg文件，避免了图纸转换成pdf的麻烦，也避免了先下载附件然后用本机电脑打开图纸的麻烦，方便设计人员查阅图纸。
6. 采用最新的froala富文本编辑器，支持word图文直接粘贴发布，word中的图片自动上传，发布文章轻松快捷，文章支持视频和文件附件。
7. 微信小程序客户端访问和添加图文，打开微信，搜索“珠三角设代”或“青少儿书画”即可看到小程序了，小程序端也开源。
8. 微信小程序多项目切换。
9. swagger API自动化文档，方便前后端分离。
10. 可在conf里定制9个导航条菜单。
11. 后台查看日志。
12. 通用的文档流程设置。文档审批，文档校审，合同评审流程，图纸校审流程，……
13. 整合了mindoc，实现了在线创作、查阅、分享、导入、导出电子书籍。
14. 文件分享提取码。
15. 全文检索：上传office文档、pdf等，调用tika解析后存入elasticsearch（中文分词ik），实现全文检索。

一 特性：

1. 后台预定义工程目录类型和分层级别，支持无限级；目录采用懒加载模式，支持百万级目录数据快速显示；
2. 建立项目时选择已有项目作为模板，继承已有项目权限，或选择后台预定义的项目类型和目录层级，瞬间自动建立成百上千的树形目录，支持无限级目录；目录采用懒加载显示，百万级数据快速显示；项目支持公开和私有；
3. 任意层级目录下可以添加任意成果；可对任意目录进行权限设置；
4. 成果包含文章、pdf附件和非pdf附件，并将它们分别列出；一个成果如果包含一个pdf文件则直接打开，如果多于一个则打开列表，非pdf附件也是一样；文章采用富文本编辑器froala，支持图文word直接黏贴，自动上传图片；成果数据采用后端分页，百万级成果数据快速显示；
5. 成果间的关联：比如先出的施工图，然后一段时间后再出了对这个图纸的修改通知单，那么修改单关联上这个图纸后，每次看这个图纸，就知道这个图纸有修改了，需要引起注意；
6. 多人建立相同项目和目录，可以实现目录中的成果同步显示，方便团队协作；
7. 深度检索到成果、附件和文章全文；全局检索到局域网内其他cms上的成果、附件和文章；
8. 根据资料编号的规则，批量上传附件时，自动截取编号和名称，并归入对应的目录中；
9. 3种权限方式：IP地址段权限，适用于局域网内相互之间的无障碍访问；注册用户的权限适用于远程访问；用户组（角色）权限适用于项目团队协作；还特别为pdf扩展名添加了权限，即，这种角色只能访问pdf文件。
10. 公开和私有的个人日历日程。每个项目提供一个项目日程和大事记时间轴；
11. 上传成果后，自动生成提供给MeritMS的成果清单，可提交给MeritMS系统进行成果统计；
12. 成果提交给MeritMS后进行校审流程；详见MeritMS；
13. 目的是标准化管理自己的（项目团队的、公司的）知识体系，同时方便其他人根据权限查阅；退休后可将自己个人的cms系统导入cms服务器版，实现知识继承。

二 应用案例：

我们做工程设计的，经常要做设代，现场服务，而且人员会更换比较频繁。拥有这样一个资料管理平台，是很多人的愿望，那么有没有简单免费开源的web应用呢？基于engineercms核心的系统，具有：

√参建单位各自自由建立自己的目录，共享资料，避免大家重复存储项目资料，比如会议纪要，法律法规。

√关键字检索和全文检索。

√图纸易得，能更好地控制工程质量——pdf设计文件参建单位都可以阅读，提高效率，减少障碍。

√基于“用户——角色——权限”的权限设置。独创的根据文件扩展名来进行权限管理。

√会议室和车辆的预定，用餐人数计划统计等常用功能。

√wiki技术讨论。

√工程大事记，工程进展时间轴等潮玩意儿。

√独创的pdf连续查阅；

√IPAD、手机移动端无障碍；

√设代日记图文并茂记录现场进度，支持视频格式；

√项目甘特图展示工作进度；

√硬盘中的资料存储与页面的目录保持一致；设代日志等文章中照片按月度存储；

√分享文章到微信。

√√√ONLYOFFICE实时文档协作支持。除了支持office的docx，xlsx及pptx格式外，还支持wps，et和dps格式。

√ONLYOFFICE中文档的历史版本对照功能。

√ONLYOFFICE中文档的格式转换功能，如word转pdf。

√ONLYOFFICE中文档协作的权限设置，采用casbin。

√在线预览dwg文件。

√手机端添加图片、视频发布文档；——已开发小程序“珠三角设代”应用中并开源。

√考勤登记，值班安排；

√小程序图纸查阅权限，用户注册设计；

√小程序打卡；

√小程序多人写同一天的设代日志；

√小程序公告，展示车辆、会议室的调度、占用；

√文档关联完善：编辑关联，关联打开链接；

√自定义业务流程：单线传递，并行传递；

√资料“购物车”，管理员批准后可下载资料；

√ websocket聊天室；

√全文检索，快速定位文档；

二 todo:

× 规范标准库编辑，爬虫；

× 读取文件属性——完成时间，作为月度统计依据，或提供选择，以上传时间为统计口径，生成某个目录下月度成果报表，与上个月对比柱状图；

× 项目目录编辑完善：ztree目录拖动；

× 多关键字检索；

× 项目合并和拆分：将2个项目目录合并起来，其中一个项目合并到另一个项目的子目录中，手动合并文件夹，自动修改数据库；

× 流媒体服务； × 图片服务；

下载和安装

在release标签中下载二进制文件和源码压缩包(不再提供最新编译文件，请到网盘下载)。https://github.com/3xxx/EngineerCMS/releases

将二进制文件放到源码文件夹下直接运行即可。

或者去百度网盘下载，直接运行。链接：https://pan.baidu.com/s/1f4zuhoymaHMN_QAEgZLwOg 提取码：upvm

Linux系统下请将执行文件engineercms(linux)放入engineercms文件夹内（即win系统下运行的整个解压包）；swagger文件夹下的swagger.json和swagger.yml两个文件拷贝到engineercms目录里的swagger文件夹里 进入执行文件所在文件夹，运行engineercms如下： [root@localhost engineercms]# nohup ./engineercms & 如果出现： -bash: ./ engineercms: Permission denied 则说明需要修改权限，用下列命令： [root@……5 ~]# chmod +x engineercms —如果出现端口被占用，需要去conf文件夹内修改app.conf里的端口号，保存后重新运行。 [root@……5 ~]# systemctl stop firewalld.service关闭防火墙，否则其他电脑访问不了。 停止engineercms进程的命令 killall engineercms 查看进程的命令： ps aux

不清楚的，可以加我QQ504284或者微信hotqin999聊，也可参考quickstart。

wiki。包括linux系统下的编译。linux系统下的部署参见网盘中的文档。

技术开发过程详见CSDN我的博客 系统简单使用见mindoc文档

Quick Start

• 参见quickstart快速开始。包括后台导入Excel用户，设置用户角色和权限。

• linux系统上的部署参见网盘中的文档。

Documentation

• [中文文档]——请查阅document文件夹
• 系统简单使用见mindoc文档

免费开源和问题反馈

• 开源地址https://github.com/3xxx/engineercms/
• 问题反馈: https://github.com/3xxx/engineercms/issues

更新用到的pkg第三方模块

git submodule update --init

第三方包

1. beego框架
2. casbin权限管理
3. simplejson
4. excelize
5. xlsx
6. goquery
7. go-sqlite
8. mahonia
9. flow文档流程我改造的flow文档流程
10. xorm
11. gorm
12. unioffice
13. pdfcpu

前端

1. onlyoffice document server文档协作
2. pdf.js阅览pdf
3. html2canvas
4. jQueryGantt甘特图
5. multyselect
6. bootstrap treeview树状目录
7. fullcalendar日历
8. daterangerpicker
9. datetimepicker
10. datepicker
11. select2
12. x-editable表格在线编辑
13. ztree树状目录
14. request
15. froala富文本编辑器
16. ueditor百度富文本编辑器
17. webupload百度文件上传
18. jqfileupload
19. bootstrap-table表格
20. jquery.form.js表单上传文件
21. vue.js
22. axios
23. element组件
24. vxe-table表格在线编辑

LICENSE

EngineerCMS source code is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

ONLYOFFICE实时文档协作效果——除了支持office的docx，xlsx及pptx格式外，还支持国产wps，et和dps格式。

在线直接预览dwg图纸文件：

手机端访问文章效果

微信小程序富文本编辑器添加文章：

IPAD移动端效果

项目进度展示 用户——角色——权限设置，树状目录权限，区分附件扩展名，基于casbin

froala富文本编辑器支持word图片自动上传，视频和附件