service.xpcool.com/api/recruitment/v1/recruitment.go

// Package recruitment_v1 招聘考试聚合模块接口契约。
// 规范（2026-08-27）：全部 POST；URL 不含任何参数（查询/路径参数均禁止）；入参一律走 body。
package recruitment_v1

import "github.com/gogf/gf/v2/frame/g"

// ---------- 公告列表 ----------
type RecruitmentListReq struct {
	g.Meta   `path:"/recruitment/info/list" method:"post" tags:"Admin/Recruitment/Info" summary:"招聘公告列表(多维筛选)"`
	Page     int    `json:"page" d:"1" v:"min:1"`
	Size     int    `json:"size" d:"10" v:"min:1|max:100"`
	Region   string `json:"region"`      // 地区过滤(空=全部)
	Category int    `json:"category"`    // 分类(0=全部)
	Keyword  string `json:"keyword"`     // 标题/正文/单位关键字
	Status   int    `json:"status"`      // 状态(0=有效+已更正；传 2 只看已失效等)
	DateFrom string `json:"dateFrom"`    // 发布日期起点 YYYY-MM-DD
	DateTo   string `json:"dateTo"`      // 发布日期终点 YYYY-MM-DD
	OrgName  string `json:"orgName"`     // 发布主体名称模糊匹配
	SourceId uint64 `json:"sourceId"`    // 指定数据源
	OnlyNewToday bool `json:"onlyNewToday"` // 仅当日新增
}

type RecruitmentItem struct {
	Id           uint64 `json:"id"`
	Title        string `json:"title"`
	SourceId     uint64 `json:"sourceId"`
	SourceName   string `json:"sourceName"`
	OrgId        uint64 `json:"orgId"`
	OrgName      string `json:"orgName"`
	Category     int    `json:"category"`
	CategoryName string `json:"categoryName"`
	Region       string `json:"region"`
	PublishDate  string `json:"publishDate"`
	Deadline     string `json:"deadline"`
	ExamDate     string `json:"examDate"`
	Url          string `json:"url"`
	Content      string `json:"content"`
	Attachments  string `json:"attachments"`
	Status       int    `json:"status"`
	StatusName   string `json:"statusName"`
	GroupKey     string `json:"groupKey"`
	CreatedAt    string `json:"createdAt"`
}

type RecruitmentListRes struct {
	List  []*RecruitmentItem `json:"list"`
	Total int                `json:"total"`
}

// ---------- 公告详情 ----------
type RecruitmentDetailReq struct {
	g.Meta `path:"/recruitment/info/detail" method:"post" tags:"Admin/Recruitment/Info" summary:"招聘公告详情"`
	Id     uint64 `json:"id" v:"required"`
}

type RecruitmentDetailRes struct {
	Info *RecruitmentItem `json:"info"`
}

// ---------- 看板统计 ----------
type RecruitmentStatsReq struct {
	g.Meta `path:"/recruitment/stats" method:"post" tags:"Admin/Recruitment/Dashboard" summary:"招聘数据看板统计"`
	Region string `json:"region"` // 可选：按地区过滤统计
}

type RecruitmentStatsRes struct {
	Total       int                  `json:"total"`
	TodayNew    int                  `json:"todayNew"`
	WeekNew     int                  `json:"weekNew"`
	ByCategory  []CategoryAggItem    `json:"byCategory"`
	ByRegion    []RegionAggItem      `json:"byRegion"`
	RecentTrend []TrendPointItem     `json:"recentTrend"`
}

type CategoryAggItem struct {
	Category     int    `json:"category"`
	CategoryName string `json:"categoryName"`
	Count        int    `json:"count"`
}

type RegionAggItem struct {
	Region string `json:"region"`
	Count  int    `json:"count"`
}

type TrendPointItem struct {
	Date  string `json:"date"`
	Count int    `json:"count"`
}

// ---------- 趋势分析 ----------
type RecruitmentTrendReq struct {
	g.Meta  `path:"/recruitment/trend" method:"post" tags:"Admin/Recruitment/Dashboard" summary:"招聘公告趋势(按日)"`
	Region  string `json:"region"`
	Category int  `json:"category"`
	Days    int    `json:"days" d:"30" v:"min:1|max:365"`
}

type RecruitmentTrendRes struct {
	Trend []TrendPointItem `json:"trend"`
}

// ---------- 数据源状态 ----------
type RecruitmentSourcesReq struct {
	g.Meta `path:"/recruitment/source/list" method:"post" tags:"Admin/Recruitment/Crawler" summary:"数据源列表与运行状态"`
}

type SourceItem struct {
	Id            uint64 `json:"id"`
	Name          string `json:"name"`
	BaseUrl       string `json:"baseUrl"`
	SourceType    int    `json:"sourceType"`
	Category      int    `json:"category"`
	Region        string `json:"region"`
	Enabled       int    `json:"enabled"`
	LastSuccessAt string `json:"lastSuccessAt"`
	FailCount     int    `json:"failCount"`
	LastSummary   string `json:"lastSummary"`
}

type RecruitmentSourcesRes struct {
	List []*SourceItem `json:"list"`
}

// ---------- 手动触发抓取 ----------
type RecruitmentTriggerReq struct {
	g.Meta   `path:"/recruitment/crawl/trigger" method:"post" tags:"Admin/Recruitment/Crawler" summary:"手动触发抓取(单源或全量)"`
	SourceId uint64 `json:"sourceId"` // 0=全部启用源
	Force    bool   `json:"force"`    // 是否强制全量回溯
}

type RecruitmentTriggerRes struct {
	Triggered int    `json:"triggered"` // 触发的源数量
	Summary   string `json:"summary"`   // 运行摘要
}

// ---------- Bark 推送测试 ----------
type RecruitmentPushTestReq struct {
	g.Meta         `path:"/recruitment/push/test" method:"post" tags:"Admin/Recruitment/Push" summary:"Bark 推送测试"`
	SubscriptionId uint64 `json:"subscriptionId"` // 0=使用首个启用订阅
	Title          string `json:"title"`
	Body           string `json:"body"`
}

type RecruitmentPushTestRes struct {
	Result  bool   `json:"result"`
	Message string `json:"message"`
}

// ---------- 推送订阅管理 ----------
type RecruitmentSubscriptionListReq struct {
	g.Meta `path:"/recruitment/subscription/list" method:"post" tags:"Admin/Recruitment/Push" summary:"推送订阅列表"`
}

type SubscriptionItem struct {
	Id         uint64   `json:"id"`
	Name       string   `json:"name"`
	DeviceKey  string   `json:"deviceKey"`
	Regions    []string `json:"regions"`
	Categories []int    `json:"categories"`
	OnlyNew    int      `json:"onlyNew"`
	PushTime   string   `json:"pushTime"`
	Enabled    int      `json:"enabled"`
}

type RecruitmentSubscriptionListRes struct {
	List []*SubscriptionItem `json:"list"`
}

type RecruitmentSubscriptionSaveReq struct {
	g.Meta     `path:"/recruitment/subscription/save" method:"post" tags:"Admin/Recruitment/Push" summary:"保存推送订阅(新增/更新)"`
	Id         uint64   `json:"id"` // 0=新增
	Name       string   `json:"name" v:"required"`
	DeviceKey  string   `json:"deviceKey" v:"required"`
	Regions    []string `json:"regions"`
	Categories []int    `json:"categories"`
	OnlyNew    int      `json:"onlyNew" d:"1"`
	PushTime   string   `json:"pushTime" d:"08:00"`
	Enabled    int      `json:"enabled" d:"1"`
}

type RecruitmentSubscriptionSaveRes struct {
	Id uint64 `json:"id"`
}

type RecruitmentSubscriptionDeleteReq struct {
	g.Meta `path:"/recruitment/subscription/delete" method:"post" tags:"Admin/Recruitment/Push" summary:"删除推送订阅"`
	Id     uint64 `json:"id" v:"required"`
}

type RecruitmentSubscriptionDeleteRes struct{}