lihai-oa/README.md

192 lines
9.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 📐 勾股OA4.0
![勾股OA](https://oa.gougucms.com/storage/image/slogo.jpg)
### ✅ 相关链接
- 系统地址https://www.gougucms.com/home/pages/detail/s/gouguoa.html
- 文档地址:[https://blog.gougucms.com/home/book/detail/bid/3.html](https://blog.gougucms.com/home/book/detail/bid/3.html)
- 项目会不定时进行更新建议⭐star⭐和👁watch👁一份。
### ⭕ 同系列开源项目
1. [开源项目系列勾股OA —— OA协同办公系统](https://gitee.com/gougucms/office)
2. [开源项目系列勾股DEV —— 项目研发管理系统](https://gitee.com/gougucms/dev)
3. [开源项目系列勾股CMS —— CMS内容管理系统框架](https://gitee.com/gougucms/gougucms)
4. [开源项目系列勾股BLOG —— 个人&工作室博客系统](https://gitee.com/gougucms/blog)
5. [开源项目系列勾股Admin —— 基于Layui的Web UI解决方案](https://gitee.com/gouguopen/guoguadmin)
### 📋 系统介绍
**我们的愿景是:助力企业数智化。**
勾股OA是一款基于ThinkPHP6 + Layui + MySql打造的实用的开源的企业办公系统开箱即用使用勾股OA可以简单快速地建立企业级的办公自动化系统。
办公自动化系统是员工及管理者使用频率最高的应用系统,可以极大提高公司的办公效率,我们立志为中小企业提供开源好用的办公自动化系统,帮助企业节省数字化、信息化办公的成本。
### ✳️ 演示地址
勾股OA演示地址[https://oa.gougucms.com](https://oa.gougucms.com)
沟通咨询请加微信号hdm588
PS为了给后面的人提供良好的演示体验体验以查看为主如果确实需要填写数据大家最好填些看似正常的数据请不要乱填数据比如`1111``aaa`这些数据就不要乱填入了。
体验账号及密码:
~~~
BOSS角色suhaizhen 123456
总 经 理yiyeshu 123456
人事总监fengcailing 123456
财务总监yucixin 1234566
市场总监qinjiaxian 1234566
技术总监yexiaochai 1234566
销售组长fujianfenshuo 123456
销售组长jianzixianji 123456
销售组长shuloulongsu 123456
客服经理hongchenxue 123456
客服人员guxinglei 123456
~~~
### ✴️ 系统特点
- 系统各功能模块,一目了然,操作简单;通用型的后台权限管理框架,员工的操作记录全覆盖跟踪,紧随潮流、极低门槛、开箱即用。
- 系统集成了系统设置、人事管理、行政管理、消息管理、企业公告、知识库、审批流程设置、办公审批、日常办公、财务管理、客户管理、合同管理、项目管理、任务管理等基础模块。
- 系统方便二次开发,易于功能扩展,代码维护,满足专注业务深度开发的需求。
- 开发人员可以快速基于此系统进行二次开发免去写一次系统架构的痛苦帮助开发者高效降低开发的成本通过二次开发之后可以用来做CRMERP项目管理等企业办公系统。
**功能矩阵**
系统后台集成了主流的通用功能,如:登录验证、系统配置、操作日志管理、角色权限、职位职称、数据权限、功能菜单、模块管理、关键字管理、文件上传、数据备份/还原、基础数据、审批流程、员工管理、消息通知、企业公告、知识文章、办公审批、日常办公、财务管理、客户管理、合同管理、项目管理、任务管理等。更多的个性化功能可以基于当前系统便捷做二次开发。
![输入图片说明](https://oa.gougucms.com/storage/image/gouguoa2.0.png)
### 📚 安装教程
**一、服务器。**
服务器最低配置:
~~~
1核CPU (建议2核+)
2G内存 (建议4G+)
1M带宽 (建议3M+)
~~~
服务器运行环境要求:
~~~
PHP >= 7.4
Mysql >= 5.6.0 (需支持innodb引擎)
Apache 或 Nginx
PDO PHP Extension
MBstring PHP Extension
CURL PHP Extension
FileInfo PHP Extension
Composer (用于管理第三方扩展包)
~~~
**二、系统安装**
**命令行安装(推荐)**
推荐使用命令行安装因为采用命令行安装的方式可以和勾股OA随时保持更新同步。使用命令行安装请提前准备好`Git`、`Composer`。
**勾股OA的安装步骤以下加粗的内容需要特别留意**
第一步:克隆(下载)勾股OA到你本地 **如果不用git的可以在代码仓库上角打包下载代码然后解压上传到服务器**
git clone https://gitee.com/gougucms/office.git
第二步:进入目录
cd gouguoa文件所在根目录
第三步下载PHP依赖包
composer install
第四步:添加虚拟主机并绑定到项目的`public`目录 ,实际部署中,确保绑定域名访问到的是`public`目录。**(这一步很重要,很多人出错)**
第五步:伪静态配置 **(这一步也很重要,很多人出错)**使用的是ThinkPHP的伪静态规则**具体看下面的伪静态配置内容**。
**Nginx**
修改nginx.conf 配置文件 加入下面的语句。
~~~
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}
~~~
**Apache**
把下面的内容保存为.htaccess文件放到应用入 public 文件的同级目录下。
~~~
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</IfModule>
~~~
第六步:访问 http://www.你的域名.com/install/index 进行安装**(访问主域名,系统会自动跳转到安装连接的)**
⚠️⚠️ **注意:安装过程中,系统会自动创建数据库,请确保填写的数据库用户的权限可创建数据库,如果权限不足,请先手动创建空的数据库,然后填写刚创建的数据库名称和用户名也可完成安装。**
🔺🔺 **提醒安装过程中如果进度条卡住一般都是数据库写入权限或者安装环境配置问题请注意检查。遇到问题请到QQ群反馈24641076群一满46924914群二名额不多**
✅✅ **PS如需要重新安装请删除目录里面 config/install.lock 的文件,即可重新安装。**
### ❓ 常见问题
1. 安装失败可能存在php配置文件禁止了`putenv`和`proc_open`函数。解决方法,查找`php.ini`文件位置,打开`php.ini`,搜索`disable_functions`项,看是否禁用了`putenv`和`proc_open`函数。如果在禁用列表里,移除`putenv`、`proc_open`然后退出,重启`php`即可。
2. 如果安装后打开页面提示 `404`错误请检查服务器伪静态配置如果是宝塔面板网站伪静态请配置使用thinkphp规则。
3. 如果提示当前权限不足,无法写入配置文件`config/database.php`,请检查`config`目录是否可写还有可能是当前安装程序无法访问父目录请检查PHP的`open_basedir`配置。
4. 如果`composer install`失败,请尝试在命令行进行切换配置到国内源,命令如下:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
5. 访问 http://www.你的域名.com/install/index 前,请注意查看伪静态请配置是否设置了`thinkphp`伪静态规则。
6. 出现访问报错一般是服务器环境配置问题
比如:伪静态配置,网站的访问入口是否绑定`public`目录,放配置文件的目录是否有可写权限,放缓存的目录是否有可写权限,数据库连接确认无误等。
开启`debug`的方式请查看链接https://blog.gougucms.com/home/book/detail/bid/3/id/77.html
开启`debug`后看具体的报错信息然后沿着这些思路去一个个排查基本解决90%的问题。
7. 如果是`composer`的安装,`composer install`报错,这不是勾股系列系统的问题,可以百度得到具体解决方案的。
8. 安装过程中,如果 **进度条卡住(99%)**,一般都是数据库写入权限或者安装环境配置`config`目录无法写入问题,请注意检查权限。
9. 如果安装成功后无法显示图形验证码的请看是否已安装开启了PHP的`GD`库。
10. 如果安装成功后无法上传文件的请看是否已安装开启了PHP的`fileinfo`扩展。
11. 遇到解决不了的问题请到QQ群反馈24641076群一满46924914群二名额不多
12. **最后如果实在安装不成功确实需要提供安装服务的请搜索微信号hdm588或者QQ号327725426添加好友注意备注[安装勾股系统]。开源不易该服务需友情赞赏💰99元。**
### 🖼️ 截图预览
|页面截图 | 部分截图|
| :--------: | :--------:|
| ![功能导图](https://oa.gougucms.com/storage/image/oa4.png "功能导图")|![功能导图](https://oa.gougucms.com/storage/image/oa1.png "功能导图")|
|![功能导图](https://oa.gougucms.com/storage/image/oa2.png "功能导图")|![功能导图](https://oa.gougucms.com/storage/image/oa3.png "功能导图")|
### ⭐ 开源助力
- 勾股OA遵循GPL-3.0开源协议发布。
- 开源的系统少不了大家的参与如果大家在体验的过程中发现有问题或者BUG请到Issue里面反馈谢谢
- 如果觉得勾股OA不错不要吝啬您的赞许和鼓励请给我们⭐ STAR ⭐吧!
### 👍 支持我们
- If the project is very helpful to you, you can buy the author a cup of coffee☕.
- 如果这个项目对您有帮助,可以请作者喝杯咖啡哟☕
|支付宝 | 微信|
| :--------: | :--------:|
| <img src="https://www.gougucms.com/static/home/images/zfb.png" width="300" align=center />|<img src="https://www.gougucms.com/static/home/images/wx.png" width="300" align=center />|