# emms

**Repository Path**: wangzhankun/emms

## Basic Information

- **Project Name**: emms
- **Description**: 企业物资管理系统
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 88
- **Created**: 2020-10-05
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 企业物资管理系统
### 简介

企业单位通常需要管理大量的设备，建立物资管理系统可以有效地节约人力物力资源，并提高管理效率。一个企业物资管理系统应具有以下功能：

- 实现物资的购入、登记、报废等管理；
- 可将各类物资分配到企业各个科室以便使用；
- 可按照物资类别，名称，价格、科室等查询、统计；
- 可生成相应的统计报表；
- 个人申报功能；其他说明、限制：所管理的物资分两大类：固定资产（如家具、电器）、耗材（文具等）；每一件固定资产有唯一的资产编号；物资管理员可以完成以上1、2、3、4功能，而普通员工只可查询本人、本科室相关的情况；

### 技术结构
    主要框架 : PHP7 + laravel5.4 +　mysql5.5.36 + composer1.3.2(依赖管理)
    前端 : jquery + bootstrap + jstree（树形结构） + echart（图表） + layer（弹出层）
    其他：  阿里大于短信等


### 完成概况 
演示项目已不可用。 

 项目演示地址   http://39.108.228.215/

测试账号

    企业管理员 uchiyou@sina.com（希望不要删除太多数据）
    部门管理员 nash@sina.com
    普通员工 ali@sina.com
    密码都是 123456（希望手下留情不要改）



 **项目主页** 


![输入图片说明](https://git.oschina.net/uploads/images/2017/0430/150209_bee4f761_1030765.gif "在这里输入图片标题")

 **购买审批**  
- 待审批通知
- 历史记录
- 导出到 excel
- 打印当前表单

![输入图片说明](https://git.oschina.net/uploads/images/2017/0430/150249_bd6f2d02_1030765.png "在这里输入图片标题")


**搜索功能** 
- 根据名称，类别，价格和部门搜索物资信息

![](https://git.oschina.net/uploads/images/2017/0430/150346_721b67a7_1030765.png "搜索物资信息")


 **树形结构管理** 
- 以符合公司组织结构的树形结构管理物资。
- 可在树形目录上点击右键增删改查和拖拽移动节点，符合现实中的人事调动和物资分配。
- 每个部门可以有部门管理员管理所在分支，职责划分明确。
- 用 jquery 实现懒加载分支信息，减小服务器负载压力。

![输入图片说明](https://git.oschina.net/uploads/images/2017/0430/150546_a378f1f5_1030765.png "在这里输入图片标题")

 **统计** 
- 为系统记录提供图形化统计

![输入图片说明](https://git.oschina.net/uploads/images/2017/0430/150622_1f209bae_1030765.png "预约Top10统计")

其他：

- 公司树权限 ： 部门管理员，只能看到自己所在部门的物资记录。
            普通员工删除的记录，部门管理员可见；部门管理员删除的记录，公司树的顶级管理员可见。
- 系统权限 ：　软件即服务的理念（SaaS），系统管理员可以停止和恢复对一家公司的服务。（待完善）
- 提供站内消息和短信消息两种通知
- 为租借提供可选的外送服务
- 提供预约功能，当物资可用时，有消息通知
- 提供维修功能等

### 目录结构

- 典型的laravel项目
- 需要在 .env 中添加阿里大于的短信验证第三方秘钥，如果需要发送邮件功能，也需要自行配置。

### 项目部署
- 拉代码
        ```bash
        git clone http://git.oschina.net/uchiyou/emms
        ```
- 安装依赖
    安装```composer```。首先需要切换到当前目录。
    ```bash
    php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
    php -r "if (hash_file('sha384', 'composer-setup.php') === '795f976fe0ebd8b75f26a6dd68f78fd3453ce79f32ecb33e7fd087d39bfeb978342fb73ac986cd4f54edd0dc902601dc') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
    php composer-setup.php
    php -r "unlink('composer-setup.php');"
    mv composer.phar /usr/local/bin/composer
    ```
    安装composer依赖。在此之前确保```putenv```和```proc_open```函数不被禁用。可在```php.ini```文件中修改。
    ```bash
    composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
    composer update
    composer global require "laravel/installer"
    composer install --optimize-autoloader --no-dev
    composer dump-autoload --optimize
    ```
- 清理
    ```bash
    php artisan clear-compiled
    php artisan optimize
    ```
- 数据库迁移 
    需要先配置好数据库，参考 [laravel数据迁移](http://d.laravel-china.org/docs/5.4/migrations)
    ```bash
    sudo apt install php-mysql
    php artisan migrate
    ```
    后面的版本将上传sql文件，不熟悉migrate同学可以将sql文件导入数据库

- 新建文件夹
```bash
mkdir storage/app storage/framework storage/views
mkdir storage/framework/cache storage/framework/sessions storage/framework/views
chmod 777 -R storage bootstrap/cache
```

- 生成key
```bash
php artisan key:generate
```

- 其他设置 

    1. cp .env.example .env , 在 .env 中配置短信，邮箱等账号信息；
    2. 确保storage目录下有如app，framework，views三个目录。
        确保storage/framework目录下也有cache，sessions，views三个目录。缺少以上目录就手动创建，然后赋予写的权限。
        ```bash
        chmod 777 -R storage/logs
        chmod 777 -R bootstrap/cache
        ```



- 启动
    1. 启动php解析器自带的服务器 
        ```php -S localhost:8080(url)```

    2. 使用 nginx + php-fpm 时，nginx 配置如下

```
server {
    listen       [::]:80;
    server_name  39.108.228.215;
    root        /var/www/emms/public;

    #设置加载 css flash txt js 图片等资源
     location ~* ^.+\.(jpg|jpeg|gif|png|bmp|css|js|swf|txt)$ {
        access_log off;
        break;
    }
    location / {
        try_files \$uri \$uri/ /index.php?\$query_string;
        index index.php index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9002;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}
``` 


**注意：** 出于作者账号保护和费用等原因，本项目并没有提供 发送短信的秘钥以及作者的邮箱密码。需要开发者自行配置。

 **部署到linux上可能遇到的问题：**

- 步骤2 出现 out of memory 类似问题。

    系统内存不够，关闭一些程序。 composer install 很吃内存。

    composer的其他问题参考 https://getcomposer.org/doc/articles/troubleshooting.md


- 访问的时候如果出现 ```Please provide a valid cache path.``` 的异常提示。
    解决方法：

    1、确保storage目录下有如app，framework，views三个目录。

    2、确保storage/framework目录下也有cache，sessions，views三个目录。缺少以上目录就手动创建，然后赋予写的权限。

    ```bash
    chmod 777 -R storage/logs
    chmod 777 -R bootstrap/cache
    ```

    否则会发生```TokenMismatchException in VerifyCsrfToken.php line 68:```异常

其他异常通常可以通过nginx 和 php 的日志定位问题。 


### 关于作者
作者为能力有限,有需求改进或程序有不规范之处，欢迎指出。
如需深度定制或者二次开发技术支持，可以发送邮件至1373918920@qq.com 联系作者。