syntax = "v1"

info (
	title:   "聚玩认证审核服务"
	desc:    "处理用户角色认证申请（打手/店长）及管理员审核流程"
	author:  "Asadz"
	version: "1.0"
)

// =================================================================================
// 数据结构定义 (Data Structures)
// =================================================================================

// =================================================================================
// 用户端接口 (User Side)
// 路径前缀: /api/v1/users
// =================================================================================
@server (
	group:  verification_user
	prefix: /api/v1/users
)
service verification-api {
	@doc "提交或修改角色认证申请 (支持幂等更新)"
	@handler ApplyVerification
	post /me/verification (ApplyVerificationReq) returns (VerificationEmptyResp)

	@doc "获取我的所有认证状态"
	@handler GetMyVerifications
	get /me/verification returns (GetMyVerificationsResp)
}

// =================================================================================
// 管理端接口 (Admin Side)
// 路径前缀: /api/v1/admin
// =================================================================================
@server (
	group:  verification_admin
	prefix: /api/v1/admin
)
service verification-api {
	@doc "管理员获取认证申请列表 (分页)"
	@handler GetVerifications
	get /verifications (GetPendingListReq) returns (GetPendingListResp)

	@doc "管理员通过申请"
	@handler ApproveVerification
	post /verifications/:id/approve (VerificationIdReq) returns (VerificationEmptyResp)

	@doc "管理员驳回申请"
	@handler RejectVerification
	post /verifications/:id/reject (RejectVerificationReq) returns (VerificationEmptyResp)
}