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="事由,文件名称")
     * @Apidoc\Returned("type", type="integer", desc="类型:采购类型,呈批类型,出差类型,请假类型,维修类型,合同类型")
     * @Apidoc\Returned("desc", type="string", desc="缓急程度,具体内容,来文单位")
     * @Apidoc\Returned("start_time", type="string", desc="开始时间")
     * @Apidoc\Returned("end_time", type="string", desc="结束时间")
     * @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="审批意见")
     **/
    public function audit()
    {
        $id = input('approve_id');
        $status = input('status', 0);
        $remark = input('remark', '');
        $params = compact("id", "status", "remark");
        $user = $this->user;
        ApproveService::make($id, $params, $user, 'audit');
        $this->success('确认成功');
    }

}