Skip to main content

Module daily_brief

Module daily_brief 

Source
Expand description

Manager daily-briefing contracts for occupancy, staffing, risk, and action summaries. Canonical domain contracts for cross-service resort daily briefs.

Brief sections, occupancy, labor, revenue, watchlists, and recommended manager actions are owned here rather than hidden behind broader operations vocabulary. A daily brief is the manager-facing read model in the source-fact → validated-domain → workflow chain: it exposes labor-cost levers such as scheduled staff count, utilization, over/understaffing, follow-up queues, safety watchlists, and revenue opportunities without taking live customer or staffing action on its own.

use domain::{daily_brief, entities};

let brief = daily_brief::Resort {
    operating_day: daily_brief::ResortOperatingDay {
        location_id: entities::LocationId(uuid::Uuid::nil()),
        date: chrono::NaiveDate::from_ymd_opt(2026, 6, 18).unwrap(),
        snapshot_id: daily_brief::snapshot::Id::try_new("loc-1-2026-06-18").unwrap(),
    },
    sections: vec![daily_brief::Section::Labor(daily_brief::LaborSnapshot {
        scheduled_staff_count: daily_brief::ScheduledStaffCount::new(4),
        labor_risk: daily_brief::LaborRisk::Understaffed,
    })],
    recommended_actions: vec![daily_brief::Action::SuggestScheduleReview {
        risk: daily_brief::LaborRisk::Understaffed,
    }],
    risks: vec![daily_brief::Risk::LaborMismatch {
        risk: daily_brief::LaborRisk::Understaffed,
    }],
};

assert!(brief.has_manager_attention_required());
assert!(brief.recommended_actions[0].requires_manager_approval());

Re-exports§

pub use snapshot::Id as Snapshot;

Modules§

capacity
Capacity metrics used by daily briefs to expose utilization and labor-pressure signals.
snapshot
Snapshot boundary for daily brief contracts.

Structs§

ArrivalDepartureSnapshot
Check-in/check-out workload snapshot for front-desk and care-team planning.
CustomerFollowUp
Customer follow-up item generated from validated operational evidence.
LaborSnapshot
Labor summary comparing scheduled staff against expected demand and risk.
OccupancySnapshot
Occupancy/utilization snapshot used to compare booked demand with service capacity.
PetCareWatch
Pet care/safety watch item that protects staff handoff and manager review.
Resort
Manager-facing daily brief assembled from validated operational read models.
ResortOperatingDay
Source snapshot key for one resort’s manager brief on an operating day.
RevenueOpportunity
Revenue opportunity that may justify staff follow-up without bypassing approval gates.
ScheduledStaffCount
Count of scheduled staff used to reason about over/understaffing labor risk.

Enums§

Action
Proposed action that remains draft/recommendation until the workflow gate approves it.
FollowUpReason
Domain vocabulary for follow up reason decisions in daily brief workflows.
LaborRisk
Staffing posture surfaced as a labor-cost and service-quality lever.
PetCareWatchReason
Domain vocabulary for pet care watch reason decisions in daily brief workflows.
RevenueOpportunityKind
Domain vocabulary for revenue opportunity kind decisions in daily brief workflows.
Risk
Manager-visible risk derived from occupancy, labor, customer, care, or revenue evidence.
Section
Section of the daily brief that turns source/read-model evidence into manager focus.