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=6请假开始时间,module=7出发时间,module=1预计申购完成日期(日期),module=10收文日期(日期),module=11拟发文时间(日期)")
     * @Apidoc\Returned("end_time", type="string", desc="module=5出差结束时间,module=6请假结束时间,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') ?: 0;
        $module = input('module') ?: 0;
        $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\Param("group", type="string",require=true, desc="类别:approve=审批,approve_copy=审批抄送")
     * @Apidoc\Returned("approve_id", type="integer", desc="审批ID")
     * @Apidoc\Returned("approve_status", type="integer", desc="审批状态:1=待审批,2=审批中,3=审批同意,4=审批驳回")
     * @Apidoc\Returned("is_maintain", type="bool", desc="是否显示维修人员:false=不显示,true=显示 module=8 && approve_status=2判断此字段")
     * @Apidoc\Returned("is_feedback", type="bool", desc="是否显示上传反馈结果:false=不显示,true=显示 module=8 && approve_status=3判断此字段")
     */
    public function get_detail()
    {
        $id = input('approve_id') ?: 0;
        $group = input('group') ?: 'approve';
        $user = $this->user;
        $info = ApproveService::get_detail($id, $user, $group,'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') ?: 0;
        $user = $this->user;
        $info = ApproveService::get_detail($id, $user, 'approve','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("status", "remark", "maintain_user_id");
        $user = $this->user;
        ApproveService::make($id, $params, $user, 'audit');
        $this->success('确认成功');
    }

    /**
     * 上传反馈结果
     *
     * @Apidoc\Desc("维修模块")
     * @Apidoc\Method("POST")
     * @Apidoc\Param("approve_id", type="integer",require=true, desc="审批ID")
     * @Apidoc\Param("feedback", type="sting",require=true, desc="反馈结果")
     * @Apidoc\Param("feedback_images", type="sting",require=false, desc="反馈图片（多个用英文逗号隔开）")
     **/
    public function feedback()
    {
        $id = input('approve_id') ?: 0;
        $feedback = input('feedback') ?: '';
        $feedback_images = input('feedback_images') ?: '';
        $params = compact("feedback", "feedback_images");
        $user = $this->user;
        ApproveService::make($id, $params, $user, 'feedback');
        $this->success('提交成功');
    }

}