// ==========================================================================
// GFast自动生成api操作代码。
// 生成日期：2025-08-11 17:00:45
// 生成路径: api/v1/businesses/species_survey.go
// 生成人：gfast
// desc:物种调查相关参数
// company:云南奇讯科技有限公司
// ==========================================================================

package businesses

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

// SpeciesSurveySearchReq 分页请求参数
type SpeciesSurveySearchReq struct {
	g.Meta `path:"/list" tags:"物种调查" method:"get" summary:"物种调查列表"`
	commonApi.Author
	model.SpeciesSurveySearchReq
}

// SpeciesSurveySearchRes 列表返回结果
type SpeciesSurveySearchRes struct {
	g.Meta `mime:"application/json"`
	*model.SpeciesSurveySearchRes
}

// SpeciesSurveyAddReq 添加操作请求参数
type SpeciesSurveyAddReq struct {
	g.Meta `path:"/add" tags:"物种调查" method:"post" summary:"物种调查添加"`
	commonApi.Author
	*model.SpeciesSurveyAddReq
}

// SpeciesSurveyAddRes 添加操作返回结果
type SpeciesSurveyAddRes struct {
	commonApi.EmptyRes
}

// SpeciesSurveyEditReq 修改操作请求参数
type SpeciesSurveyEditReq struct {
	g.Meta `path:"/edit" tags:"物种调查" method:"put" summary:"物种调查修改"`
	commonApi.Author
	*model.SpeciesSurveyEditReq
}

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

// SpeciesSurveyGetReq 获取一条数据请求
type SpeciesSurveyGetReq struct {
	g.Meta `path:"/get" tags:"物种调查" method:"get" summary:"获取物种调查信息"`
	commonApi.Author
	Id int `p:"id" v:"required#主键必须"` //通过主键获取
}

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

// SpeciesSurveyDeleteReq 删除数据请求
type SpeciesSurveyDeleteReq struct {
	g.Meta `path:"/delete" tags:"物种调查" method:"delete" summary:"删除物种调查"`
	commonApi.Author
	Ids     []int `p:"ids" v:"required#主键必须"` //通过主键删除
	Version []int `p:"version"`
}

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