## 📐 勾股OA5.0

![勾股OA](https://admin.gougucms.com/oss/slogo.jpg)

### ✅ 相关链接
- 系统地址：https://www.gougucms.com/home/pages/detail/s/gouguoa.html
- 文档地址：https://blog.gouguoa.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是一款基于ThinkPHP8 + Layui + MySql打造的实用的开源的企业办公系统，开箱即用，使用勾股OA可以简单快速地建立企业级的办公自动化系统。
办公自动化系统是员工及管理者使用频率最高的应用系统，可以极大提高公司的办公效率，我们立志为中小企业提供开源好用的办公自动化系统，帮助企业节省数字化、信息化办公的成本。

### ✳️ 演示地址

勾股OA演示地址：[https://www.gouguoa.com](https://www.gouguoa.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
~~~

### ✴️ 系统特点
- 系统各功能模块，一目了然，操作简单；通用型的后台权限管理框架，员工的操作记录全覆盖跟踪，紧随潮流、极低门槛、开箱即用。
- 系统集成了系统设置、人事管理、行政管理、消息管理、企业公告、知识网盘、审批流程设置、办公审批、日常办公、财务管理、客户管理、合同管理、项目管理、任务管理等基础模块。
- 系统方便二次开发，易于功能扩展，代码维护，满足专注业务深度开发的需求。
- 开发人员可以快速基于此系统进行二次开发，免去写一次系统架构的痛苦，帮助开发者高效降低开发的成本，通过二次开发之后可以用来做CRM，ERP，项目管理等企业办公系统。

**功能矩阵**

系统后台集成了主流的通用功能，如：登录验证、系统配置、操作日志管理、角色权限、职位职称、数据权限、功能菜单、模块管理、关键字管理、文件上传、数据备份/还原、基础数据、审批流程、员工管理、消息通知、企业公告、知识文章、办公审批、日常办公、财务管理、客户管理、合同管理、项目管理、任务管理等。更多的个性化功能可以基于当前系统便捷做二次开发。

![输入图片说明](https://admin.gougucms.com/oss/gouguoa2.0.png)


### 📚 安装教程

**一、服务器。**

服务器最低配置：
~~~
    2核CPU (建议4核+)
    4G内存 (建议8G+)
    3M带宽 (建议5M+)
~~~
服务器运行环境要求：
~~~
    PHP >= 8.2
    Mysql >= 5.7.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 进行安装**（访问主域名，系统会自动跳转到安装连接的）**

⚠️⚠️ **注意：安装过程中，系统会自动创建数据表，请确保填写的数据库用户的权限可创建数据表，请先手动创建空的数据库（比如:gouguoa），然后填写刚刚创建的数据库名称、用户名、密码完成安装。** 

🔺🔺  **提醒：安装过程中，如果进度条卡住，一般都是数据库写入权限或者config无法写入，一般是安装环境配置问题，请注意检查。遇到问题请到QQ群反馈：24641076（群一满），46924914（群二名额紧张），295256660（群三额不多）** 

✅✅ **PS：如需要重新安装，请删除目录里面 config/install.lock 的文件，即可重新安装。**


### ❓ 常见问题

1.  如果是 Composer 安装失败，可能存在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`配置，还有可能是服务器Nginx、Apache的执行者无权限的问题。

4、如果`composer install`失败，可能是国际网络问题，请尝试在命令行进行切换配置到国内源镜像，命令如下：

腾讯云镜像：
```shell
composer config -g repos.packagist composer https://mirrors.tencent.com/composer/
```

阿里云镜像：
```shell
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
```

5.  访问 http://www.你的域名.com/install/index 前，请注意查看伪静态请配置是否设置了伪静态规则。

6.  出现访问报错一般是服务器环境配置问题

    比如：伪静态配置，网站的访问入口是否绑定`public`目录，放配置文件的目录是否有可写权限，放缓存的目录是否有可写权限，数据库连接确认无误等。

    开启`debug`的方式请查看链接：https://blog.gouguoa.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（群二），295256660（群三） 。

12. 更多问题请查看链接解决：https://blog.gougucms.com/home/book/detail/bid/3/id/100.html

**最后，如果实在安装不成功，确实需要提供安装服务的，请搜索微信号：hdm588，或者QQ号：327725426，添加好友，注意备注[安装勾股系统]。开源不易，该服务需友情赞赏💰99元。**

### 🖼️ 截图预览

|页面截图      |    部分截图|
| :--------: | :--------:|
| ![功能导图](https://admin.gougucms.com/oss/oa4.png "功能导图")|![功能导图](https://admin.gougucms.com/oss/oa1.png "功能导图")|
|![功能导图](https://admin.gougucms.com/oss/oa2.png "功能导图")|![功能导图](https://admin.gougucms.com/oss/oa3.png "功能导图")|

### ⭐ 开源助力

- 开源协议：勾股OA遵循Apache License 2.0开源协议发布。
- 版权声明：要求在软件和相关文档中保留包含原始版权声明等信息。
- 免责声明：该软件是按现状提供的，没有任何明示或暗示的担保或保证，作者不承担任何赔偿责任。
- 贡献参与：开源的系统少不了大家的参与，如果大家在体验的过程中发现有问题或者BUG，请到Issue里面反馈，谢谢！
- 鼓励支持：如果觉得勾股OA不错，不要吝啬您的赞许和鼓励，请给我们⭐ STAR ⭐吧！

### 👍 支持我们
- 商务合作、定制服务，请搜索微信号：hdm588，添加微信咨询了解🤝。
- If the project is very helpful to you, you can buy the author a cup of coffee☕.
- 如果这个项目对您有帮助，可以请作者喝杯咖啡哟☕（👇👇👇点击下面的捐赠支持我们👇👇👇）
