yiqiu/BlackFruit-UI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修改插件
All checks were successful
continuous-integration/drone/push Build is passing
Details

Browse Source
This commit is contained in:
yiqiu
2025-11-21 00:01:45 +08:00
parent 7bc68457e9
commit cbd6250967
224 changed files with 61713 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

471
plugins/addon/example/controller/clientarea/TicketController.php Normal file
View File

@@ -0,0 +1,471 @@
<?php
namespace addon\idcsmart_ticket\controller\clientarea;
use addon\idcsmart_ticket\logic\IdcsmartTicketLogic;
use addon\idcsmart_ticket\model\IdcsmartTicketModel;
use addon\idcsmart_ticket\model\IdcsmartTicketStatusModel;
use addon\idcsmart_ticket\model\IdcsmartTicketTypeModel;
use addon\idcsmart_ticket\validate\TicketValidate;
use app\event\controller\PluginBaseController;
/**
* @title 工单(会员中心)
* @desc 工单(会员中心)
* @use addon\idcsmart_ticket\controller\clientarea\TicketController
*/
class TicketController extends PluginBaseController
{
private $validate=null;
public function initialize()
{
parent::initialize();
$this->validate = new TicketValidate();
}
/**
* 时间 2022-10-21
* @title 工单状态列表
* @desc 工单状态列表
* @author wyh
* @version v1
* @url /console/v1/ticket/status
* @method GET
* @return array list - 工单状态列表
* @return int list[].id - ID
* @return string list[].name - 工单状态
* @return string list[].color - 状态颜色
* @return int list[].status - 完结状态:1完结,0未完结
* @return int list[].default - 是否默认状态:0否,1是,默认状态无法修改删除
*/
public function ticketStatusList()
{
$IdcsmartTicketStatusModel = new IdcsmartTicketStatusModel();
$result = $IdcsmartTicketStatusModel->ticketStatusList();
return json($result);
}
/**
* 时间 2022-06-20
* @title 工单列表
* @desc 工单列表
* @author wyh
* @version v1
* @url /console/v1/ticket
* @method GET
* @param string keywords - 关键字
* @param int status - 状态搜索(/console/v1/ticket/status get获取状态列表)
* @param int ticket_type_id - 工单类型搜索(/console/v1/ticket/type get获取类型列表)
* @param int client_id - 客户ID
* @param int admin_id - 管理员ID
* @param int host_id - 产品ID
* @param int page - 页数
* @param int limit - 每页条数
* @return array list - 工单列表
* @return int list[].id - ID
* @return string list[].ticket_num - 工单号
* @return string list[].title - 标题
* @return string list[].name - 类型
* @return int list[].post_time - 提交时间
* @return int list[].last_reply_time - 最近回复时间
* @return string list[].status - 状态
* @return string list[].color - 状态颜色
* @return string list[].last_urge_time - 上次催单时间戳(0代表未催单)
* @return int count - 工单总数
*/
public function ticketList()
{
$param = array_merge($this->request->param(),['page'=>$this->request->page,'limit'=>$this->request->limit,'sort'=>$this->request->sort]);
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->ticketList($param);
return json($result);
}
/**
* 时间 2022-06-21
* @title 工单统计
* @desc 工单统计
* @author wyh
* @version v1
* @url /console/v1/ticket/statistic
* @method GET
* @return int 1 - 待接单数量
* @return int 2 - 待回复数量
* @return int 3 - 已回复数量
* @return int 5 - 处理中数量
*/
public function statistic()
{
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->statisticTicket();
return json($result);
}
/**
* 时间 2022-06-20
* @title 查看工单
* @desc 查看工单
* @author wyh
* @version v1
* @url /console/v1/ticket/:id
* @method GET
* @param int id - 工单ID required
* @return object ticket - 工单详情
* @return int ticket.client_id - 用户ID
* @return int ticket.id - 工单ID
* @return string ticket.title - 工单标题
* @return string ticket.content - 内容
* @return int ticket.ticket_type_id - 类型ID
* @return string ticket.status - 状态,直接显示,结合color
* @return string ticket.color - 状态颜色
* @return int ticket.create_time - 创建时间
* @return array ticket.attachment - 工单附件,数组,返回所有附件(附件以^符号分割,取最后一个值获取文件原名)
* @return int ticket.last_reply_time - 工单最后回复时间
* @return string ticket.username - 用户名
* @return array ticket.host_ids - 关联产品ID,数组
* @return int ticket.can_operate - 是否可操作
* @return array ticket.replies - 沟通记录,数组
* @return string ticket.replies[].content - 内容
* @return array ticket.replies[].attachment - 附件访问地址,数组
* @return int ticket.replies[].create_time - 时间
* @return string ticket.replies[].type - 类型:Client用户回复,Admin管理员回复
* @return string ticket.replies[].client_name - 用户名,type==Client时用此值
* @return string ticket.replies[].admin_name - 管理员名,type==Admin时用此值
*/
public function index()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->indexTicket(intval($param['id']));
return json($result);
}
/**
* 时间 2022-06-20
* @title 创建工单
* @desc 创建工单
* @author wyh
* @version v1
* @url /console/v1/ticket
* @method POST
* @param string title - 工单标题 required
* @param int ticket_type_id - 工单类型ID,/console/v1/ticket/type接口获取 required
* @param array host_ids - 关联产品ID,数组(id从产品列表接口获取)
* @param string content - 问题描述
* @param array attachment - 附件,数组(后台调admin/v1/upload(前台调console/v1/upload)上传文件,取返回值save_name)
*/
public function create()
{
$param = $this->request->param();
//参数验证
if (!$this->validate->scene('create')->check($param)){
return json(['status' => 400 , 'msg' => lang_plugins($this->validate->getError())]);
}
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->createTicket($param);
return json($result);
}
/**
* 时间 2022-06-21
* @title 回复工单
* @desc 回复工单
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/reply
* @method POST
* @param int id - 工单ID required
* @param string content - 回复内容,不超过3000个字符 required
* @param array attachment - 附件,数组(后台调admin/v1/upload(前台调console/v1/upload)上传文件,取返回值save_name)
* @return int ticket_reply_id - 回复ID
*/
public function reply()
{
$param = $this->request->param();
//参数验证
if (!$this->validate->scene('reply')->check($param)){
return json(['status' => 400 , 'msg' => lang_plugins($this->validate->getError())]);
}
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->replyTicket($param);
return json($result);
}
/**
* 时间 2022-06-21
* @title 催单
* @desc 催单
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/urge
* @method PUT
* @param int id - 工单ID required
*/
public function urge()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->urgeTicket($param);
return json($result);
}
/**
* 时间 2022-06-21
* @title 关闭工单
* @desc 关闭工单
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/close
* @method PUT
* @param int id - 工单ID required
*/
public function close()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->closeTicket($param);
return json($result);
}
/**
* 时间 2022-10-24
* @title 工单部门
* @desc 工单部门
* @author wyh
* @version v1
* @url /console/v1/ticket/department
* @method GET
* @return array list - 工单部门列表
* @return int list[].id - 工单部门ID
* @return string list[].name - 工单部门名称
*/
public function department()
{
$IdcsmartTicketTypeModel = new IdcsmartTicketTypeModel();
$result = $IdcsmartTicketTypeModel->typeDepartment();
return json($result);
}
/**
* 时间 2022-06-21
* @title 工单部门
* @desc 工单部门
* @author wyh
* @version v1
* @url /console/v1/ticket/type
* @method GET
* @return array list - 工单类型列表
* @return int list[].id - 工单部门ID
* @return string list[].name - 工单部门名称
*/
public function type()
{
$param = $this->request->param();
$IdcsmartTicketTypeModel = new IdcsmartTicketTypeModel();
$result = $IdcsmartTicketTypeModel->typeTicket($param);
return json($result);
}
/**
* 时间 2022-07-22
* @title 工单附件下载
* @desc 工单附件下载
* @author wyh
* @version v1
* @url /console/v1/ticket/download
* @method POST
* @param string name - 附件名称 required
*/
public function download()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
return $IdcsmartTicketModel->download($param);
}
/**
* 时间 2024-01-22
* @title 工单通知设置
* @desc 工单通知设置
* @author wyh
* @version v1
* @url /console/v1/ticket/config
* @method GET
* @return int ticket_notice_open - 是否开启工单通知，1是默认，0否
* @return string ticket_notice_description - 工单通知描述
*/
public function ticketConfig()
{
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->ticketConfig();
return json($result);
}
/* 以下接口为API调用 */
/**
* 时间 2024-06-18
* @title 工单处理中
* @desc 工单处理中
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/processing
* @method PUT
* @param int id - 工单ID required
*/
public function processing()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->processing($param);
return json($result);
}
/**
* 时间 2024-06-18
* @title 工单终止传递
* @desc 工单终止传递
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/terminate
* @method PUT
* @param int id - 工单ID required
*/
public function terminate()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->terminateTicket($param);
return json($result);
}
/**
* 时间 2024-06-18
* @title 更新工单状态
* @desc 更新工单状态
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/status
* @method PUT
* @param int id - 工单ID required
* @param int status - 工单状态 required
*/
public function updateStatus()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->updateStatus($param);
return json($result);
}
/**
* 时间 2024-06-18
* @title 更新工单回复
* @desc 更新工单回复
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/reply
* @method PUT
* @param int id - 工单ID required
* @param int ticket_reply_id - 工单回复ID required
* @param int content - 工单回复内容 required
*/
public function updateReply()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->updateReply($param);
return json($result);
}
/**
* 时间 2024-06-18
* @title 删除工单回复
* @desc 删除工单回复
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/reply
* @method DELETE
* @param int id - 工单ID required
* @param int ticket_reply_id - 工单回复ID required
*/
public function deleteReply()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->deleteReply($param);
return json($result);
}
/**
* 时间 2024-06-18
* @title 创建工单回复
* @desc 创建工单回复
* @author wyh
* @version v1
* @url /console/v1/ticket/:id/reply
* @method POST
* @param int id - 工单ID required
* @param int upstream_ticket_reply_id - 上游工单回复ID required
* @param string content - 工单回复内容 required
* @param array attachment - 附件
*/
public function createReply()
{
$param = $this->request->param();
$IdcsmartTicketModel = new IdcsmartTicketModel();
$result = $IdcsmartTicketModel->createReply($param);
return json($result);
}
}