dingding/application/api/controller/Approve.php

<?php

namespace app\api\controller;

use app\common\service\ApproveService;
use hg\apidoc\annotation as Apidoc;

/**
 * @Apidoc\Title("审批")
 * @Apidoc\Group("api")
 * @Apidoc\Sort("12")
 */
class Approve extends Base
{
    public function initialize()
    {
        parent::initialize();
        parent::checkLogin();
    }

    /**
     * 审批待处理统计
     *
     * @Apidoc\Method("POST")
     * @Apidoc\Returned("module", type="integer", desc="模块类型:1=申购申请,2=呈批申请,3=入库申请,4=领用申请,5=出差申请,6=请假申请,7=用车申请,8=维修申请,9=合同呈批,10=收文批阅,11=学校文件")
     * @Apidoc\Returned("module_text", type="string", desc="模块类型描述")
     * @Apidoc\Returned("number", type="integer", desc="待处理数量")
     **/
    public function get_count()
    {
        $user = $this->user;
        $data = ApproveService::get_count($user);
        $this->success('审批待处理统计', $data);
    }

    /**
     * 审批列表
     *
     * @Apidoc\Method("POST")
     * @Apidoc\Param("page", type="integer",require=true, desc="页数")
     * @Apidoc\Param("page_num", type="integer", require=true, desc="每页数量")
     * @Apidoc\Param("status", type="integer", require=true, desc="处理状态:1=待处理,2=已处理,3=我收到的")
     * @Apidoc\Param("module", type="integer", require=false, desc="模块类型:1=申购申请,2=呈批申请,3=入库申请,4=领用申请,5=出差申请,6=请假申请,7=用车申请,8=维修申请,9=合同呈批,10=收文批阅,11=学校文件 不传默认全部")
     * @Apidoc\Param("start_time", type="string", require=false, desc="申请开始时间")
     * @Apidoc\Param("end_time", type="string", require=false, desc="申请结束时间")
     * @Apidoc\Param("search", type="string", require=false, desc="搜索 姓名 事由 编号")
     * @Apidoc\Returned("approve_id", type="integer", desc="审批ID")
     * @Apidoc\Returned("status", type="integer", desc="审批状态:1=待审批,2=审批中,3=审批同意,4=审批驳回")
     * @Apidoc\Returned("create_at", type="string", desc="创建时间")
     * @Apidoc\Returned("module", type="integer", desc="模块类型")
     * @Apidoc\Returned("order_no", type="string", desc="审批编号")
     * @Apidoc\Returned("apply_date", type="string", desc="申请日期")
     * @Apidoc\Returned("reason", type="string", desc="module=1申购事由,module=2申请标题,module=4物品用途,module=5出差事由,module=6请假原因,module=7出发地点,module=8维修地点,module=9合同编号,module=10文件名称,module=11文件名称")
     * @Apidoc\Returned("type", type="string", desc="module=1采购类型,module=2呈批类型,module=5出差类型,module=6请假类型,module=8维修类型,module=9合同类型")
     * @Apidoc\Returned("desc", type="string", desc="module=2缓急程度,module=8具体内容,module=9缓急程度,module=10来文单位名称,module=11缓急程度")
     * @Apidoc\Returned("start_time", type="string", desc="module=5出差开始时间,module=7出发时间")
     * @Apidoc\Returned("end_time", type="string", desc="module=5出差结束时间,module=7返回时间")
     * @Apidoc\Returned("approve_one", type="object", desc="审批人信息 status=1",
     *     @Apidoc\Returned("id", type="integer", desc="审批ID"),
     *     @Apidoc\Returned("info_id", type="integer", desc="申请ID"),
     *     @Apidoc\Returned("approve_user", type="string", desc="审批人userid"),
     *     @Apidoc\Returned("user", type="object", desc="审批人信息",
     *          @Apidoc\Returned("userid", type="string", desc="用户userid"),
     *          @Apidoc\Returned("name", type="string", desc="用户姓名"),
     *      ),
     * )
     * @Apidoc\Returned("approve_info_user", type="object", desc="创建人信息",
     *     @Apidoc\Returned("userid", type="string", desc="用户userid"),
     *     @Apidoc\Returned("name", type="string", desc="用户姓名"),
     * )
     * @Apidoc\Returned("apply_goods", type="array", desc="申购商品列表 module=1 && type=1",
     *     @Apidoc\Returned("id", type="integer", desc="申购商品ID"),
     *     @Apidoc\Returned("info_id", type="integer", desc="申请ID"),
     *     @Apidoc\Returned("goods_name", type="string", desc="商品名称"),
     * )
     * @Apidoc\Returned("stock_goods", type="array", desc="入库商品列表 module=3",
     *     @Apidoc\Returned("id", type="integer", desc="入库商品ID"),
     *     @Apidoc\Returned("info_id", type="integer", desc="申请ID"),
     *     @Apidoc\Returned("goods_name", type="string", desc="商品名称"),
     * )
     * @Apidoc\Returned("use_goods", type="array", desc="领用商品列表 module=4",
     *     @Apidoc\Returned("id", type="integer", desc="领用商品ID"),
     *     @Apidoc\Returned("info_id", type="integer", desc="申请ID"),
     *     @Apidoc\Returned("goods_name", type="string", desc="商品名称"),
     * )
     * @Apidoc\Returned("peer_user", type="array", desc="同行人员列表 module=5",
     *     @Apidoc\Returned("id", type="integer", desc="同行人员ID"),
     *     @Apidoc\Returned("info_id", type="integer", desc="申请ID"),
     *     @Apidoc\Returned("name", type="string", desc="姓名"),
     * )
     */
    public function get_list()
    {
        $status = input('status');
        $module = input('module');
        $start_time = input('start_time');
        $end_time = input('end_time');
        $search = input('search');
        $offset = $this->off_set;
        $length = $this->page_num;
        $user = $this->user;
        $data = ApproveService::get_list($status, $module, $start_time, $end_time, $search, $offset, $length, $user);
        $this->success('审批列表', $data);
    }

    /**
     * 详情
     *
     * @Apidoc\Method("POST")
     * @Apidoc\Param("approve_id", type="integer",require=true, desc="审批ID")
     * @Apidoc\Returned("approve_id", type="integer", desc="审批ID")
     * @Apidoc\Returned("approve_status", type="integer", desc="审批状态:1=待审批,2=审批中,3=审批同意,4=审批驳回")
     */
    public function get_detail()
    {
        $id = input('approve_id');
        $user = $this->user;
        $info = ApproveService::get_detail($id, $user, 'detail');
        $this->success('详情', $info);
    }

    /**
     * 信息
     *
     * @Apidoc\Desc("修改信息")
     * @Apidoc\Method("POST")
     * @Apidoc\Param("approve_id", type="integer",require=true, desc="审批ID")
     * @Apidoc\Returned("approve_id", type="integer", desc="审批ID")
     * @Apidoc\Returned("approve_status", type="integer", desc="审批状态:1=待审批,2=审批中,3=审批同意,4=审批驳回")
     */
    public function get_info()
    {
        $id = input('approve_id');
        $user = $this->user;
        $info = ApproveService::get_detail($id, $user, 'info');
        $this->success('信息', $info);
    }

    /**
     * 审批
     *
     * @Apidoc\Method("POST")
     * @Apidoc\Param("approve_id", type="integer",require=true, desc="审批ID")
     * @Apidoc\Param("status", type="integer",require=true, desc="审批状态:3=审批同意,4=审批驳回")
     * @Apidoc\Param("remark", type="sting",require=false, desc="审批意见")
     * @Apidoc\Param("maintain_user_id", type="sting",require=false, desc="维修人员ID status=3必传")
     **/
    public function audit()
    {
        $id = input('approve_id',0);
        $status = input('status', 0);
        $remark = input('remark', '');
        $maintain_user_id = input('maintain_user_id', 0);
        $params = compact("id", "status", "remark","maintain_user_id");
        $user = $this->user;
        ApproveService::make($id, $params, $user, 'audit');
        $this->success('确认成功');
    }

}