// ==========================================================================
// GFast自动生成api操作代码。
// 生成日期：2023-12-04 18:09:50
// 生成路径: api/v1/system/bus_complaint_box.go
// 生成人：gfast
// desc:意见箱相关参数
// company:云南奇讯科技有限公司
// ==========================================================================

package system

import (
	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/os/gtime"
	commonApi "github.com/tiger1103/gfast/v3/api/v1/common"
	"github.com/tiger1103/gfast/v3/internal/app/system/model"
)

// BusComplaintBoxSearchReq 分页请求参数
type BusComplaintBoxSearchReq struct {
	g.Meta    `path:"/list" tags:"意见箱" method:"get" summary:"意见箱列表"`
	ProjectId string `p:"projectId" v:"projectId@integer#项目id需为整数"`                     // 项目id
	Openid    string `p:"openid"`                                                       // openid
	Status    string `p:"status"`                                                       // 状态（0未读，1已读）
	Dispose   string `p:"dispose" v:"dispose@datetime#处理时间需为YYYY-MM-DD hh:mm:ss格式"`     // 处理时间
	CreatedAt string `p:"createdAt" v:"createdAt@datetime#创建时间需为YYYY-MM-DD hh:mm:ss格式"` // 创建时间
	Phone     string `p:"phone"`                                                        // 手机号
	commonApi.PageReq
	commonApi.Author
}

// BusComplaintBoxSearchRes 列表返回结果
type BusComplaintBoxSearchRes struct {
	g.Meta `mime:"application/json"`
	commonApi.ListRes
	List []*model.BusComplaintBoxListRes `json:"list"`
}

//// BusComplaintBoxAddReq 添加操作请求参数
//type BusComplaintBoxAddReq struct {
//	g.Meta `path:"/add" tags:"意见箱" method:"post" summary:"意见箱添加"`
//	commonApi.Author
//	ProjectId int64  `p:"projectId" `
//	Openid    string `p:"openid" `
//	Opinion   string `p:"opinion" `
//}
//
//// BusComplaintBoxAddRes 添加操作返回结果
//type BusComplaintBoxAddRes struct {
//	commonApi.EmptyRes
//}

// BusComplaintBoxEditReq 修改操作请求参数
type BusComplaintBoxEditReq struct {
	g.Meta `path:"/edit" tags:"意见箱" method:"put" summary:"意见箱修改"`
	commonApi.Author
	Id        int64       `p:"id" v:"required#主键ID不能为空"`
	ProjectId int64       `p:"projectId" `
	Openid    string      `p:"openid" `
	Opinion   string      `p:"opinion" v:"max-length:512#最大输入字数为512"`
	Status    string      `p:"status" v:"required#状态（0未读，1已读）不能为空"`
	Dispose   *gtime.Time `p:"dispose" `
	Remark    string      `p:"remark" v:"max-length:512#最大输入字数为512"`
}

// BusComplaintBoxEditRes 修改操作返回结果
type BusComplaintBoxEditRes struct {
	commonApi.EmptyRes
}

// BusComplaintBoxGetReq 获取一条数据请求
type BusComplaintBoxGetReq struct {
	g.Meta `path:"/get" tags:"意见箱" method:"get" summary:"获取意见箱信息"`
	commonApi.Author
	Id int64 `p:"id" v:"required#主键必须"` // 通过主键获取
}

// BusComplaintBoxGetRes 获取一条数据结果
type BusComplaintBoxGetRes struct {
	g.Meta `mime:"application/json"`
	*model.BusComplaintBoxInfoRes
}

// BusComplaintBoxDeleteReq 删除数据请求
type BusComplaintBoxDeleteReq struct {
	g.Meta `path:"/delete" tags:"意见箱" method:"delete" summary:"删除意见箱"`
	commonApi.Author
	Ids []int64 `p:"ids" v:"required#主键必须"` // 通过主键删除
}

// BusComplaintBoxDeleteRes 删除数据返回
type BusComplaintBoxDeleteRes struct {
	commonApi.EmptyRes
}