pub struct PossibleEventPerson {Show 14 fields
pub absences: Vec<Absence>,
pub connected_groups: Vec<DomainObjectGroup>,
pub last_service: Option<ServiceCandidateAssignment>,
pub monthly_utilization: BTreeMap<String, i64>,
pub next_service: Option<ServiceCandidateAssignment>,
pub partner_services: bool,
pub person: DomainObjectPerson,
pub score: i64,
pub score_hints: Vec<ServiceCandidateScoreHint>,
pub service_group_preferences: Option<ServiceGroupPersonPreference>,
pub service_on_same_day: bool,
pub services_on_same_day: Vec<ServiceCandidateAssignment>,
pub services_previously_declined: Vec<ServiceCandidateAssignment>,
pub extra: Map<String, Value>,
}Expand description
One visible candidate for assigning a service role at an event. Scores are advisory: even unavailable persons remain in the list. Higher scores indicate fewer penalties or stronger preferences. The endpoint does not sort by score.
Fields§
§absences: Vec<Absence>Absences overlapping the event interval. Candidates with an absence are retained and receive a score penalty.
connected_groups: Vec<DomainObjectGroup>Connected groups through whose active, visible-role memberships this person was found. A group can occur more than once.
last_service: Option<ServiceCandidateAssignment>Latest valid assignment in the same service group starting strictly before this event, within the loaded history window. Null if none was found.
monthly_utilization: BTreeMap<String, i64>Counts of valid assignments in the same service group, including outstanding and confirmed assignments. Keys are YYYY-MM, initialized from four months before the event and advanced six times by calendar months; values include zero. Counts are per assignment, not per distinct event.
next_service: Option<ServiceCandidateAssignment>Next valid assignment in the same service group starting strictly after this event, within the loaded history window. Null if none was found.
partner_services: boolWhether a person linked as a partner (relationship type 2) has an assignment in this event. The lookup includes historical and unconfirmed records.
person: DomainObjectPersonPerson as Domain Object
score: i64Advisory suitability score. Zero when there are no hints. This is not a probability or a guarantee that assignment will succeed.
score_hints: Vec<ServiceCandidateScoreHint>Reasons contributing to the score. An empty array is allowed.
service_group_preferences: Option<ServiceGroupPersonPreference>§service_on_same_day: boolWhether servicesOnSameDay is nonempty.
services_on_same_day: Vec<ServiceCandidateAssignment>Selected valid assignment on the same day for another service role. The repository retains at most one other-service assignment per person; this is not an exhaustive conflict list.
services_previously_declined: Vec<ServiceCandidateAssignment>Declined records for this event and service, plus the selected invalid assignment for another service on the same day, if any. The latter can be a superseded record rather than a decline.
extra: Map<String, Value>Fields not described by the spec, e.g. instance-specific DB fields.