Skip to content

CustomerProfile

按人返回顾客档案,原始数据、不做任何聚合/阈值判定,秒数与口径由调用方自行计算。

字段 类型 说明
peopleId String! 顾客 ID(uuid)
gender Gender! 性别:MALE / FEMALE / UNKNOWN
height Int! 身高(厘米);-1 表示未识别到
age Int! 年龄
received Boolean! 是否被接待
steps [CustomerStep!]! 游逛步骤(按时间升序)

age 取值说明:0 未知、18 未成年、28 青年、45 中年、60 老年。

字段 类型 说明
poi Poi! POI 信息(类型固定为 COUNTER,含 serviceThresholdSeconds 供阈值判定参考)
enterTime String! 进入该柜台集时间(ISO8601,+08:00)
leaveTime String! 离开该柜台集时间(ISO8601,+08:00)
staffSegments [StaffSegment!]! 店员介入时段(与游逛步时间相交;不裁剪不合并)
字段 类型 说明
staffId String! 介入的店员 ID
startTime String! 介入开始时间(ISO8601,+08:00)
endTime String! 介入结束时间(ISO8601,+08:00)
  • 返回 role IN (0, 101) 的所有人,不做进店过滤(与服务人数口径一致);
  • staffSegments 来自 counter_set_service_info.service_time_list(店员×顾客×柜台集的重叠窗口,≥3 秒),与 legacy 服务检测同源;
  • 同一游逛步可能含多个 staffSegments(多位店员先后/同时介入、或同一店员分多段);
  • 服务秒数 = endTime - startTime;同一柜台集累计秒数 ≥ poi.serviceThresholdSeconds 即达到“服务人数”判定(与 poiMetrics.servedPeople 口径一致);
  • 跨柜台集(如柜台类/试妆区)口径可自行合并步骤计算。
query {
customerProfiles(
storeId: 1
startAt: "2026-08-31T10:00:00+08:00"
endAt: "2026-08-31T12:00:00+08:00"
) {
peopleId
role
gender
height
age
steps {
poi {
id
name
serviceThresholdSeconds
}
enterTime
leaveTime
staffSegments {
staffId
startTime
endTime
}
}
}
}