428 lines
16 KiB
Go
428 lines
16 KiB
Go
package v1
|
||
|
||
import "github.com/gogf/gf/v2/frame/g"
|
||
|
||
// ============================================================================
|
||
// 管理端「年会座次」域（企业 / 员工 / 活动 / 桌 / 座）
|
||
// 依据：架构-2026-09-18 §5.2 A1–A17、§5.3 骨架。
|
||
// 导入两段式（A6–A8）与小程序码（A18）、查座审计（A19）由 T09/T10 实现。
|
||
// ============================================================================
|
||
|
||
// ===== 企业 =====
|
||
|
||
type EnterpriseItem struct {
|
||
Id int64 `json:"id"`
|
||
Name string `json:"name"`
|
||
Contact string `json:"contact"`
|
||
Remark string `json:"remark"`
|
||
Status int `json:"status"`
|
||
EmpCount int64 `json:"emp_count"` // 员工数
|
||
}
|
||
|
||
type EnterpriseListReq struct {
|
||
g.Meta `path:"/event/enterprise/list" method:"get" tags:"event" summary:"企业列表"`
|
||
Keyword string `json:"keyword"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type EnterpriseListRes struct {
|
||
List []EnterpriseItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|
||
|
||
type EnterpriseSaveReq struct {
|
||
g.Meta `path:"/event/enterprise/save" method:"post" tags:"event" summary:"保存企业"`
|
||
Id int64 `json:"id"`
|
||
Name string `v:"required|length:1,128#企业名称不能为空" json:"name"`
|
||
Contact string `json:"contact"`
|
||
Remark string `json:"remark"`
|
||
Status int `json:"status"`
|
||
}
|
||
type EnterpriseSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// ===== 员工 =====
|
||
|
||
type EmployeeItem struct {
|
||
Id int64 `json:"id"`
|
||
Name string `json:"name"`
|
||
Phone string `json:"phone"`
|
||
Dept string `json:"dept"`
|
||
Remark string `json:"remark"`
|
||
Status int `json:"status"`
|
||
InEvent bool `json:"in_event"` // 是否已在当前活动候场名单
|
||
ExcludeAssign int `json:"exclude_assign"` // 1=不参与排座（仅 in_event 时有意义）
|
||
}
|
||
|
||
type EmployeeListReq struct {
|
||
g.Meta `path:"/event/employee/list" method:"get" tags:"event" summary:"员工库列表"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
EventId int64 `json:"event_id"`
|
||
Keyword string `json:"keyword"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type EmployeeListRes struct {
|
||
List []EmployeeItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|
||
|
||
// EmployeeSaveReq 手工加人（临时人员）。EventId > 0 时同时纳入该活动候场名单。
|
||
type EmployeeSaveReq struct {
|
||
g.Meta `path:"/event/employee/save" method:"post" tags:"event" summary:"新增/修改员工"`
|
||
Id int64 `json:"id"`
|
||
EnterpriseId int64 `v:"required#请选择企业" json:"enterprise_id"`
|
||
EventId int64 `json:"event_id"`
|
||
Name string `v:"required|length:1,64#姓名不能为空" json:"name"`
|
||
Phone string `v:"required|length:6,20#手机号格式不正确" json:"phone"`
|
||
Dept string `json:"dept"`
|
||
Remark string `json:"remark"`
|
||
}
|
||
type EmployeeSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
type EmployeeStatusReq struct {
|
||
g.Meta `path:"/event/employee/status" method:"post" tags:"event" summary:"员工启停"`
|
||
Id int64 `v:"required" json:"id"`
|
||
Status int `v:"in:0,1#状态取值非法" json:"status"`
|
||
}
|
||
type EmployeeStatusRes struct{}
|
||
|
||
// EmployeeBatchReq 批量操作员工（T15）：action=status（启停）/ delete（软删除，可恢复）。
|
||
// 部分成功语义见 BatchFailure。
|
||
type EmployeeBatchReq struct {
|
||
g.Meta `path:"/event/employee/batch" method:"post" tags:"event" summary:"批量操作员工"`
|
||
Ids []int64 `v:"required|min-length:1#请选择要操作的员工" json:"ids"`
|
||
Action string `v:"required|in:status,delete#动作非法" json:"action"`
|
||
Status int `v:"in:0,1#状态取值非法" json:"status"`
|
||
}
|
||
type EmployeeBatchRes struct {
|
||
Success int `json:"success"`
|
||
Failed int `json:"failed"`
|
||
Failures []BatchFailure `json:"failures"`
|
||
}
|
||
|
||
// ParticipantExcludeReq 批量设置「不参与排座」（N4）。仅对已在候场名单（in_event）的员工生效。
|
||
type ParticipantExcludeReq struct {
|
||
g.Meta `path:"/event/participant/exclude" method:"post" tags:"event" summary:"批量设置员工不参与排座"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
EmployeeIds []int64 `v:"required|min-length:1#请选择员工" json:"employee_ids"`
|
||
ExcludeAssign int `v:"in:0,1#取值非法" json:"exclude_assign"`
|
||
}
|
||
type ParticipantExcludeRes struct {
|
||
Success int `json:"success"` // 实际更新的候场记录数
|
||
}
|
||
|
||
// ===== 活动 =====
|
||
|
||
type EventItem struct {
|
||
Id int64 `json:"id"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
EnterpriseName string `json:"enterprise_name"`
|
||
Title string `json:"title"`
|
||
Venue string `json:"venue"`
|
||
EventTime string `json:"event_time"`
|
||
Status string `json:"status"`
|
||
LayoutVersion int `json:"layout_version"`
|
||
CodeUrl string `json:"code_url"`
|
||
TableCount int64 `json:"table_count"`
|
||
}
|
||
|
||
type EventListReq struct {
|
||
g.Meta `path:"/event/admin/list" method:"get" tags:"event" summary:"活动列表"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type EventListRes struct {
|
||
List []EventItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|
||
|
||
type EventSaveReq struct {
|
||
g.Meta `path:"/event/admin/save" method:"post" tags:"event" summary:"保存活动"`
|
||
Id int64 `json:"id"`
|
||
EnterpriseId int64 `v:"required#请选择企业" json:"enterprise_id"`
|
||
Title string `v:"required|length:1,128#活动主题不能为空" json:"title"`
|
||
Venue string `json:"venue"`
|
||
EventTime string `json:"event_time"`
|
||
}
|
||
type EventSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
type EventStatusReq struct {
|
||
g.Meta `path:"/event/admin/status" method:"post" tags:"event" summary:"发布/结束活动"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
Status string `v:"required|in:draft,published,ended#状态取值非法" json:"status"`
|
||
}
|
||
type EventStatusRes struct{}
|
||
|
||
// ===== 设计器全量（活动详情）=====
|
||
|
||
type SeatOut struct {
|
||
Id int64 `json:"id"`
|
||
SeatNo int `json:"seat_no"`
|
||
IsManual bool `json:"is_manual"`
|
||
EmployeeId int64 `json:"employee_id"`
|
||
EmployeeName string `json:"employee_name"`
|
||
}
|
||
|
||
type TableOut struct {
|
||
Id int64 `json:"id"`
|
||
TableNo string `json:"table_no"`
|
||
Name string `json:"name"`
|
||
X int `json:"x"`
|
||
Y int `json:"y"`
|
||
Capacity int `json:"capacity"`
|
||
Rotation int `json:"rotation"`
|
||
TableType int `json:"table_type"` // 桌型：0普通 1主桌 2签到台 3媒体席 4备用桌 9其他
|
||
Remark string `json:"remark"` // 桌备注
|
||
ExcludeAuto int `json:"exclude_auto"` // 1=不参与自动排序
|
||
Seats []SeatOut `json:"seats"`
|
||
}
|
||
|
||
// UnassignedItem 未分配池成员（在候场名单但未绑定座位）
|
||
type UnassignedItem struct {
|
||
EmployeeId int64 `json:"employee_id"`
|
||
Name string `json:"name"`
|
||
Phone string `json:"phone"`
|
||
Dept string `json:"dept"`
|
||
}
|
||
|
||
type EventDetailReq struct {
|
||
g.Meta `path:"/event/admin/detail" method:"get" tags:"event" summary:"活动设计器全量"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
}
|
||
type EventDetailRes struct {
|
||
Id int64 `json:"id"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
Title string `json:"title"`
|
||
Venue string `json:"venue"`
|
||
EventTime string `json:"event_time"`
|
||
Status string `json:"status"`
|
||
LayoutVersion int `json:"layout_version"`
|
||
HallLayout string `json:"hall_layout"`
|
||
Tables []TableOut `json:"tables"`
|
||
ParticipantCount int `json:"participant_count"`
|
||
SeatCount int `json:"seat_count"`
|
||
Unassigned []UnassignedItem `json:"unassigned"`
|
||
}
|
||
|
||
// ===== 布局保存（CAS）=====
|
||
|
||
// TableIn 布局内的一张桌（capacity 变更会联动座位）
|
||
type TableIn struct {
|
||
Id int64 `json:"id"`
|
||
TableNo string `json:"table_no"`
|
||
Name string `json:"name"`
|
||
X int `json:"x"`
|
||
Y int `json:"y"`
|
||
Capacity int `json:"capacity"`
|
||
Rotation int `json:"rotation"`
|
||
TableType int `json:"table_type"`
|
||
Remark string `json:"remark"`
|
||
ExcludeAuto int `json:"exclude_auto"`
|
||
}
|
||
|
||
// EventLayoutSaveReq 带 layout_version 提交 → 服务端 CAS 更新，冲突返回 4009。
|
||
// 说明：LayoutVersion 允许为 0（首次保存版本即 0），故不用 required 校验，逻辑内校验 < 0。
|
||
type EventLayoutSaveReq struct {
|
||
g.Meta `path:"/event/admin/layout/save" method:"post" tags:"event" summary:"保存大厅布局"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
LayoutVersion int `v:"min:0#缺少布局版本号" json:"layout_version"`
|
||
HallLayout string `json:"hall_layout"`
|
||
Tables []TableIn `json:"tables"`
|
||
}
|
||
type EventLayoutSaveRes struct {
|
||
LayoutVersion int `json:"layout_version"`
|
||
}
|
||
|
||
// ===== 桌 =====
|
||
|
||
// TableSaveReq 建/改桌（改人数联动补/删座）。
|
||
// 特殊桌（签到台/媒体席/备用桌）允许 0 座，故 capacity 下限为 0。
|
||
type TableSaveReq struct {
|
||
g.Meta `path:"/event/admin/table/save" method:"post" tags:"event" summary:"保存桌（含人数联动座位）"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
Id int64 `json:"id"`
|
||
TableNo string `json:"table_no"`
|
||
Name string `json:"name"`
|
||
X int `json:"x"`
|
||
Y int `json:"y"`
|
||
Capacity int `v:"min:0|max:50#每桌人数需在 0~50 之间" json:"capacity"` // 特殊桌允许 0 座
|
||
Rotation int `json:"rotation"`
|
||
TableType int `v:"min:0|max:9#桌型取值非法" json:"table_type"`
|
||
Remark string `v:"length:0,50#备注最多 50 字" json:"remark"`
|
||
ExcludeAuto int `v:"in:0,1#取值非法" json:"exclude_auto"`
|
||
}
|
||
type TableSaveRes struct {
|
||
TableId int64 `json:"table_id"`
|
||
AddedSeats int `json:"added_seats"` // 补出的座位数
|
||
RemovedSeats int `json:"removed_seats"` // 移除的座位数
|
||
MovedToUnassigned int `json:"moved_to_unassigned"` // 因减座而移入未分配池的人数
|
||
}
|
||
|
||
type TableDeleteReq struct {
|
||
g.Meta `path:"/event/admin/table/delete" method:"post" tags:"event" summary:"删除桌"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
TableId int64 `v:"required" json:"table_id"`
|
||
}
|
||
type TableDeleteRes struct {
|
||
MovedToUnassigned int `json:"moved_to_unassigned"` // 该桌原有员工数（删桌后全部进入未分配池）
|
||
}
|
||
|
||
// ===== 座位 =====
|
||
|
||
// SeatSaveReq 改号 / 绑定 / 解绑。
|
||
//
|
||
// SeatNo > 0 时改号（置 is_manual=1）；
|
||
// EmployeeId 非 nil 时改绑定：指向 0 表示解绑，>0 表示绑定该员工。
|
||
type SeatSaveReq struct {
|
||
g.Meta `path:"/event/admin/seat/save" method:"post" tags:"event" summary:"改座位号/绑定/解绑"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
SeatId int64 `v:"required" json:"seat_id"`
|
||
SeatNo int `json:"seat_no"`
|
||
EmployeeId *int64 `json:"employee_id"`
|
||
}
|
||
type SeatSaveRes struct{}
|
||
|
||
// SeatAutoReq mode: fill=增量补位(保留手工)；reorder=全部重排(覆盖手工,需二次确认)
|
||
type SeatAutoReq struct {
|
||
g.Meta `path:"/event/admin/seat/auto" method:"post" tags:"event" summary:"自动排座"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
Mode string `v:"required|in:fill,reorder#模式取值非法" json:"mode"`
|
||
}
|
||
type SeatAutoRes struct {
|
||
Assigned int `json:"assigned"` // 本次新分配人数
|
||
Unassigned int `json:"unassigned"` // 仍未分配人数
|
||
ManualOverridden int `json:"manual_overridden"` // 被覆盖/清空的手工座位数（reorder 才有意义）
|
||
Excluded int `json:"excluded"` // 本次「不参与排座」的员工人数
|
||
}
|
||
|
||
// ===== 员工导入（两段式：预览不落库 → 冲突裁决 → 确认入库）=====
|
||
|
||
// ImportRow 一行解析后的员工数据（由管理端 SheetJS 解析后提交；后端不解析文件）
|
||
type ImportRow struct {
|
||
Name string `json:"name"`
|
||
Phone string `json:"phone"`
|
||
Dept string `json:"dept"`
|
||
Remark string `json:"remark"`
|
||
}
|
||
|
||
type ImportPreviewRowOut struct {
|
||
Idx int `json:"idx"`
|
||
Type string `json:"type"` // new / update / conflict / error
|
||
Name string `json:"name"`
|
||
Phone string `json:"phone"` // 原样回显，前端展示可自行脱敏
|
||
Dept string `json:"dept"`
|
||
Message string `json:"message"` // 分类原因（如"手机号缺失""同名不同号"）
|
||
}
|
||
|
||
// ImportPreviewReq 预览入参：已解析好的结构化行数组（非 multipart 文件）
|
||
type ImportPreviewReq struct {
|
||
g.Meta `path:"/event/employee/import-preview" method:"post" tags:"event" summary:"导入预览（不落库）"`
|
||
EnterpriseId int64 `v:"required#请选择企业" json:"enterprise_id"`
|
||
EventId int64 `json:"event_id"`
|
||
FileName string `json:"file_name"`
|
||
Rows []ImportRow `v:"required|min-length:1#文件没有有效数据" json:"rows"`
|
||
}
|
||
|
||
type ImportPreviewRes struct {
|
||
ImportLogId int64 `json:"import_log_id"` // 确认时回传；服务端据此从库读回快照
|
||
Total int `json:"total"`
|
||
Inserted int `json:"inserted"`
|
||
Updated int `json:"updated"`
|
||
Skipped int `json:"skipped"`
|
||
Conflict int `json:"conflict"`
|
||
Rows []ImportPreviewRowOut `json:"rows"`
|
||
}
|
||
|
||
// ImportDecision action: merge(视为同一人·更新手机号) / create(视为另一个人新增) / ignore
|
||
type ImportDecision struct {
|
||
Idx int `json:"idx"`
|
||
Action string `v:"required|in:merge,create,ignore#裁决动作非法" json:"action"`
|
||
}
|
||
|
||
type ImportConfirmReq struct {
|
||
g.Meta `path:"/event/employee/import-confirm" method:"post" tags:"event" summary:"确认导入"`
|
||
ImportLogId int64 `v:"required#导入标识缺失" json:"import_log_id"`
|
||
Decisions []ImportDecision `json:"decisions"`
|
||
}
|
||
type ImportConfirmRes struct {
|
||
Inserted int `json:"inserted"`
|
||
Updated int `json:"updated"`
|
||
Skipped int `json:"skipped"`
|
||
}
|
||
|
||
type ImportLogItem struct {
|
||
Id int64 `json:"id"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
EventId int64 `json:"event_id"`
|
||
FileName string `json:"file_name"`
|
||
Status string `json:"status"`
|
||
Total int `json:"total"`
|
||
Inserted int `json:"inserted"`
|
||
Updated int `json:"updated"`
|
||
Skipped int `json:"skipped"`
|
||
Conflict int `json:"conflict"`
|
||
Operator string `json:"operator"`
|
||
CreatedAt string `json:"created_at"`
|
||
}
|
||
|
||
type ImportLogListReq struct {
|
||
g.Meta `path:"/event/import/log/list" method:"get" tags:"event" summary:"导入历史"`
|
||
EnterpriseId int64 `json:"enterprise_id"`
|
||
EventId int64 `json:"event_id"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type ImportLogListRes struct {
|
||
List []ImportLogItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|
||
|
||
// ===== 活动小程序码（A18）=====
|
||
|
||
// EventQrcodeReq 生成活动小程序码（scene 只承载 event_id）
|
||
type EventQrcodeReq struct {
|
||
g.Meta `path:"/event/admin/qrcode" method:"post" tags:"event" summary:"生成活动小程序码"`
|
||
EventId int64 `v:"required" json:"event_id"`
|
||
}
|
||
type EventQrcodeRes struct {
|
||
CodeUrl string `json:"code_url"`
|
||
}
|
||
|
||
// ===== 查座审计（A19，架构 §5.2 遗漏项补录）=====
|
||
|
||
// QueryLogItem 查座审计列表项。
|
||
//
|
||
// PhoneMasked 落库时已脱敏（138****0000），原样返回，不再二次脱敏；
|
||
// OpenidMasked 由服务端输出时脱敏（前 6 位 + ***），openid 为空时为空串；
|
||
// Result 0 失败 / 1 成功。
|
||
type QueryLogItem struct {
|
||
Id int64 `json:"id"`
|
||
EventId int64 `json:"event_id"`
|
||
EventTitle string `json:"event_title"`
|
||
Ip string `json:"ip"`
|
||
PhoneMasked string `json:"phone_masked"`
|
||
OpenidMasked string `json:"openid_masked"`
|
||
Result int `json:"result"`
|
||
CreatedAt string `json:"created_at"`
|
||
}
|
||
|
||
// EventQueryLogReq 查座审计查询条件：EventId=0 表示全部活动；Result=-1 表示全部结果。
|
||
type EventQueryLogReq struct {
|
||
g.Meta `path:"/event/query/log/list" method:"get" tags:"event" summary:"查座审计列表"`
|
||
EventId int64 `json:"event_id"` // 0 = 全部
|
||
Result int `json:"result"` // -1 全部 / 0 失败 / 1 成功
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type EventQueryLogRes struct {
|
||
List []QueryLogItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|