EngineerCMS
————工程师知识管理系统
Demo ——基于engineercms的设代资料管理平台(真实应用环境)
# go mod使用
# https://www.jianshu.com/p/760c97ff644c
# 克隆源码
# git clone https://github.com/3xxx/engineercms.git
# go run main.go
# go包自动安装
# 设置go代理
# go env -w GO111MODULE=on
# go env -w GOPROXY=https://goproxy.cn,direct
# 初始化mod:
# go mod init
# 代码中有新的库加入,需要更新mod:
# go mod tidy——下载新增的依赖包
# go mod vendor——更新
# linux系统上编译:拷贝go.mod go.sum 其他文件,然后执行go mod vendor,再执行bee generate docs,再执行bee run -gendoc=true -downdoc=true
# 将新增的依赖包自动写入当前项目的 vendor 目录:
# go mod vendor
# 如果 go.mod 发生变化,应当重新执行 go mod vendor!
# 执行go mod vendor将删除项目中已存在的vendor目录;
# 永远不要对vendor中的依赖库进行二次修改、更改!
# go命令不检查vendor中的依赖库是否被修改
# 关闭——这个看情况,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
# 编译(sqlite需要CGO支持)
# go build -ldflags "-w"
# 数据库初始化(此步骤执行之前,需配置`conf/app.conf`)
# ./engineercms install
# linux上执行,先杀死进程,再拷贝新的执行文件和路由文件
# killall engineercms
# 拷贝engineercms和swagger里的swagger.yml和swagger.json到对应文件夹里
# $ chmod
# $ nohup ./engineercms &
# beego 2.0.0 升级指南
# 获取最新版本的 bee 工具 go install github.com/beego/bee/v2@latest
# 更新 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下的。
手动执行 bee generate docs以及bee generate routers重新生成commentsRouter_controllers.go,新版本删除了自动生成功能
bee run -gendoc=true -downdoc=true
go get 是拉取远程包的命令,还是继续使用的
go install 是对项目进行编译并自动拉取所需包并生成 可执行文件的。
还好,你说的编译一下,生成可执行命令了,感谢!
解决步骤:
1、go get -u github.com/beego/bee/v2
2、cd 到这个bee/v2版本中
3、go mod tidy 整理一下
4、go install
此时在 GOPATH目录bin文件夹下生成了bee.exe 。
测试 ./bee.exe new hello 已正常创建项目,自己将bin目录加入到全局即可。
# 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 --tags
# $ 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同样有效。
一 特性:
- 本系统采用go语言(基于beego框架)开发,运行文件为编译后的二进制可执行文件,所以无需像其他语言(php、nodejs、java等语言)编写的web应用那样,需要配置运行服务环境。
- 数据库采用sqlite嵌入式数据库,所以也无需配置数据库服务环境。
- 开箱即用,无需网络开发知识。
- 对onlyoffice document server的二次开发,实现企业的实时文档协作,非常方便,避免了文档的汇总等繁琐事物,效率大大提高,协作更加优雅有趣。除了支持office的docx,xlsx及pptx格式外,还支持国产wps,et和dps格式。
- 在线直接预览dwg文件,避免了图纸转换成pdf的麻烦,也避免了先下载附件然后用本机电脑打开图纸的麻烦,方便设计人员查阅图纸。
- 采用最新的froala富文本编辑器,支持word图文直接粘贴发布,word中的图片自动上传,发布文章轻松快捷,文章支持视频和文件附件。
- 微信小程序客户端访问和添加图文,打开微信,搜索“水务设计”即可看到小程序了,小程序端也开源。
- web端和微信小程序多项目切换。
- swagger API自动化文档。
- 可在conf里定制9个导航条菜单。
- 后台查看日志。
- 通用的文档流程设置。文档审批,文档校审,合同评审流程,图纸校审流程,……
- 整合了mindoc,实现了在线创作、查阅、分享、导入、导出电子书籍。
- 文件分享提取码。
- 全文检索:上传office文档、pdf等,调用tika解析后存入elasticsearch(中文分词ik),实现全文检索。
- 新增supa-mapus地图协作,部分代替91地图功能,方便工程师查看现场定位建筑物。
- 支持minio分布式文件存储,可集群部署文件存储服务。
- 后台预定义工程目录类型和分层级别,支持无限级;目录采用懒加载模式;
- 建立项目时选择已有项目作为模板,继承已有项目权限,或选择后台预定义的项目类型和目录层级,瞬间自动建立成百上千的树形目录,支持无限级目录;目录采用懒加载显示;项目支持公开和私有;
- 任意层级目录下可以添加任意成果;可对任意目录进行权限设置;
- 成果包含文章、pdf附件和非pdf附件,并将它们分别列出;一个成果如果包含一个pdf文件则直接打开,如果多于一个则打开列表,非pdf附件也是一样;文章采用富文本编辑器froala,支持图文word直接黏贴,自动上传图片;
- 成果间的关联:比如先出的施工图,然后一段时间后再出了对这个图纸的修改通知单,那么修改单关联上这个图纸后,每次看这个图纸,就知道这个图纸有修改了,需要引起注意;
- 每个项目提供一个项目日程和大事记时间轴;
- 成果统计,避免领导询问进度和周报月报;
- 海量文件用minio分布式存储服务,集群部署。
二 应用案例:
我们做工程设计的,经常要做设代提供现场服务,工程资料很多参建方需要查阅,有一个资料平台会方便很多,并且支持多端:
√参建单位各自自由建立自己的目录,共享资料,避免大家重复存储项目资料,比如会议纪要,法律法规。
√图纸易得,能更好地控制工程质量——pdf设计文件参建单位都可以阅读,提高效率,减少障碍。
√基于“用户——角色——权限”的权限设置。独创的根据文件扩展名来进行权限管理。
√会议室和车辆的预定,用餐人数计划统计等常用功能。
√wiki技术讨论;websocket聊天室;。
√独创的pdf连续查阅;
√硬盘中的资料存储与页面的目录保持一致;设代日志等文章中照片按月度存储;
√ONLYOFFICE中文档的历史版本对照功能。
√ONLYOFFICE中文档的格式转换功能,如word转pdf。
√ONLYOFFICE中文档协作的权限设置,采用casbin。
√出差登记和打卡,考勤登记,值班安排;
√小程序多人写同一天的设代日志;
√工程图片相册服务;
√工程视频服务;
√mapus地图协作,现场定位工程建筑物;
二 todo:
× 规范标准库编辑;
× 读取文件属性——完成时间,作为月度统计依据,或提供选择,以上传时间为统计口径,生成某个目录下月度成果报表,与上个月对比柱状图;
× 项目目录编辑完善:ztree目录拖动;
× 多关键字检索;
× 项目合并和拆分:将2个项目目录合并起来,其中一个项目合并到另一个项目的子目录中,手动合并文件夹,自动修改数据库;
× 流媒体服务;
下载和安装
去百度网盘下载,直接运行。链接: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文档
免费开源和问题反馈
更新用到的pkg第三方模块
git submodule update --init
第三方包
- beego框架
- casbin权限管理
- simplejson
- excelize
- xlsx
- goquery
- go-sqlite
- mahonia
- flow文档流程我改造的flow文档流程
- xorm
- gorm
- unioffice
- pdfcpu
前端
- onlyoffice document server文档协作
- pdf.js阅览pdf
- html2canvas
- jQueryGantt甘特图
- multyselect
- bootstrap treeview树状目录
- fullcalendar日历
- daterangerpicker
- datetimepicker
- datepicker
- select2
- x-editable表格在线编辑
- ztree树状目录
- request
- froala富文本编辑器
- ueditor百度富文本编辑器
- webupload百度文件上传
- jqfileupload
- bootstrap-table表格
- jquery.form.js表单上传文件
- vue.js
- axios
- element组件
- vxe-table表格在线编辑
- mapus地图协作
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图片自动上传,视频和附件
mapus地图协作,部分替代91地图 mapus document