Associate
An Associate represents an individual within an organization—functionally equivalent to a "staff profile" or "clinician record". This profile serves as the central repository for all professional data, including scheduling parameters and access privileges.
Key Implementation Details:
Centralized Data: Holds all scheduling logic and organizational information specific to the clinician.
Flexible Access: Associates do not require a registered user account to be managed. Profiles can remain unlinked, allowing administrators to maintain full schedules for staff members who do not personally log in to Mesh AI.
Block Schedule
In medical education, a Block Schedule maps out where trainees (residents or fellows) are rotating throughout the academic year (e.g., Surgery, ICU, or ER). It acts as the "master plan" that dictates which rotation an associate is assigned to during specific time blocks.
How it Functions:
Automation: When a block schedule is published, it automatically generates "Tours of Duty" in the corresponding clinical teams.
Precision: These tours carry specific characteristics, such as job qualifications or positions required for that specific rotation.
Scalability: Organizations can run multiple overlapping block schedules simultaneously to manage different cohorts (e.g., PGY-1s vs. PGY-3s).
Rotation
In medical education and residency planning, a Rotation is a designated clinical area (e.g., ICU, Pediatrics, or General Surgery) where an associate is assigned to work for a specific block of time.
Logic & Compliance: Each rotation carries predefined job qualifications and positions (e.g., Senior Resident or Trauma Qualified) for one or more teams.
Automation: When you publish a Block Schedule, the rotation automatically generates a Tour of Duty for the clinician. This tour matches the exact start and end dates of the block and applies the correct qualifications to the relevant teams.
Purpose: It ensures that as residents move between specialties, they are automatically granted the correct permissions and scheduling rules for their current clinical environment.
Cluster
A Cluster is a group of functionally linked shifts designed to streamline planning and ensure clinical continuity. Clusters are often used for multi-day assignments, such as a "7-on/7-off" hospitalist rotation or a weekend call block.
Key Planning Features:
Template Integration: Template rows can be clustered together during the initial setup.
Draft Efficiency: In a draft schedule, selecting one shift in a cluster automatically selects all linked shifts, saving time on manual adjustments.
Autoscheduler Logic: The system ensures the same associate is assigned to every shift within a single cluster to maintain provider consistency.
Visual Identifiers: Clustered shifts are marked with a 'chain link' icon in draft schedules. Matching colors across these icons indicate which shifts belong to the same group.
Note: Clusters are a planning tool and are only visible/functional within draft schedules. They do not display on the final published roster.
Deal
In Mesh AI, a Deal is a proposed transfer of clinical shifts between associates (or from an "empty" slot to an associate). To ensure accountability, a deal does not change shift ownership until it is fully completed and approved.
1. Legaly Deals
Note: Legacy deals are what used to be "Simple deals", which involves exactly one shift and are scheduled for future deprecation.
Direct: A one-to-one transfer from one clinician (or an unassigned slot) to a specific associate.
Open: A single shift offered to the entire team. Depending on settings, these are either first-come-first-served or allow for multiple applicants, with an administrator selecting the recipient.
2. Advanced Deals
Advanced deals allow for complex re-arrangements of one or more shifts within a single team.
Proposed: A specific swap or transfer involving one or more shifts between multiple associates.
Open: A clinician offers up their shifts, allowing others to propose "takes" or "trades." You can limit this to one offer or allow multiple bids depending on your team's configuration.
Completion & Approval Workflow
A deal is only finalized—meaning responsibility for the shift officially moves—when the following conditions are met:
Mutual Agreement: All participating associates must accept the deal.
Administrative Oversight: An administrator must approve the transaction (unless your team is configured for auto-approval).
Unlinked Associates: Profiles without a registered user are assumed to implicitly agree, as they have no active user to provide manual consent.
Group
A Group is a collection of clinical teams within an organization, used to organize units that share functional relationships or operational workflows.
Key Features:
Operational Unity: Groups allow administrators to plan and view multiple related teams (e.g., all Critical Care units) as a single cohesive unit.
Structural Flexibility: A team is not limited to one Group; it can belong to multiple groups simultaneously to accommodate complex organizational hierarchies.
Group-Level Planning: Each group can maintain its own specific block schedules.
Cascading Permissions: Administrative or associate permissions granted at the Group level cascade down to every team within that group, simplifying access management.
Job
A Job specifies the exact clinical responsibility an associate holds for the duration of a shift.
Definition: The specific task or role assigned (e.g., Consults, On-Call, Surgical First Assist, Ward Rounding, or Triage).
Eligibility: To ensure safety and proper scope of practice, associates must have matching job qualifications defined within their Tour of Duty to be assigned to these roles.
Qualifications
In Mesh AI, Qualifications are the specific competencies or permissions assigned to an associate within a Tour of Duty. They serve as the logical link between a clinician’s profile and the shifts they are eligible to work.
Definition: The set of verified skills (e.g., Intubation, ER Lead, or Senior Resident) attached to an associate’s profile.
Mesh AI Logic: These act as mandatory filters. The system—and the Autoscheduler—will only allow an associate to be assigned to a Job if they possess the matching qualification.
Usage: They prevent scheduling errors, such as assigning a junior trainee to a senior-only role or placing a clinician in a specialized unit (e.g., NICU) without the required certification.
Notification
A Notification is a brief automated message sent to a user to communicate important updates or changes within Mesh AI.
Delivery Channels: Alerts can be received via mobile push notifications, SMS (text messages), and/or email.
Trigger Events: These are sent for critical scheduling actions, such as a published schedule, a newly approved deal, or a last-minute shift change.
User Control: Individual users have full autonomy to customize which types of alerts they receive and through which methods by visiting their User Settings page.
Organization
An Organization is the top-level container in Mesh AI that encompasses all teams and associates under a single administrative umbrella.
Scale: This may represent a single hospital, an independent clinic, or an entire cross-hospital health network.
Function: It serves as the master environment where global settings, such as job titles and organizational-wide policies, are established and managed.
Permission
Permissions define the specific actions and visibility an associate has within a team, group, or organization.
Viewer: Grants the associate the ability to see the entity and its published schedules. Viewers cannot modify settings or manage schedules.
Admin: Provides full administrative control over the entity, including the ability to edit rosters and change configurations.
Position
A Position is a versatile label or tag assigned to an associate's Tour of Duty. It acts as a powerful metadata layer that informs scheduling logic, visual identification, and data filtering.
Job Qualifications: It can automatically convey specific qualifications to an associate for a set period, ensuring they are eligible for the correct shifts.
Visual Indicators: Positions display as badges on shifts and requests, making it easy to identify staff roles (e.g., "Chief Resident" or "Consultant") at a glance.
System Logic: These tags are used to filter calendars, generate specific report graphs, or apply targeted scheduling rules to a team (e.g., ensuring a specific number of "Seniors" are on a shift).
Report
A Report is a collection of graphs that analyze a team’s shifts and requests over a specific time period.
Live Data: On the Reports page, you see data for published shifts only.
Draft Data: In the Quick Analytics sidebar, you can see reports for unpublished draft schedules to check for errors before publishing.
Request
A Request is a clinician’s preference to work or not work during a specific time (e.g., Vacation or Prefer Off).
How They Apply
All Teams: The request automatically covers every team you belong to. If you are added to a new team, the request follows you.
Some Teams: You choose exactly which teams the request applies to. It won't affect any other teams you work on.
The Approval Process
Status: Requests usually only impact the schedule once an administrator approves them.
Separate Approvals: Each team manages its own approval. You might be approved for time off in "Emergency" but still be pending in "Internal Medicine".
Automatic Removal: If your contract or "Tour of Duty" ends for a specific team, any requests for that team are automatically canceled.
Rule
In Mesh AI, a Rule is a setting that tells the Autoscheduler how to fill shifts and which clinicians to recommend.
Function: Rules set goals or limits, such as fairness (giving everyone equal shifts), personal preferences, or workload limits (e.g., no more than 80 hours a week).
Enforcement Levels:
Hard Rules: Strict requirements. If broken, the shift shows a red flag error.
Medium/Soft Rules: Suggestions. They help the system make better choices but won't "break" the schedule if they can't be met
Schedule
A Schedule is a collection of shifts created for a specific team and time period, usually generated from one or more templates.
Draft State: Every schedule begins as an unpublished draft. In this state, shifts are invisible to regular members, cannot be traded, and any changes made do not trigger notifications or appear in reports.
Published State: Once published, the shifts become active on the team calendar, allowing associates to view their assignments and initiate deals.
Overlapping Schedules: Mesh AI allows for multiple schedules to exist for the same time period. This is useful for managing different groups of staff or distinct departmental needs simultaneously.
Shift
A Shift is a specific piece of work assigned to a single associate for a defined period.
Core Components: Every shift is assigned a Job that describes exactly what the associate is doing during that time (e.g., On-Call or Triage).
Detailed Information: Shifts can include additional context, such as specific notes about the work period or configurable extra data tailored to your team's needs.
Assignment: Only one associate can be assigned to a specific shift at a time, ensuring clear accountability.
Team
In Mesh AI, a Team is a group of associates and shifts that are managed together because their schedules are functionally linked or interdependent.
Interdependence: Unlike a department, which is based on hierarchy, a team is defined by scheduling inter-relation. These are people who work the same sets of shifts or whose coverage must be coordinated as a single unit.
Flexible Alignment: A team may not perfectly align with your organization’s structural units. You might create a team specifically for "Night Shift Coverage" or "Weekend Call," even if those members belong to different departments.
Organization Membership: Every team is housed within a specific Organization, where it shares global resources like Job types and Qualifications.
Template
A Template is a predefined collection of recurring shift definitions that acts as a master plan for generating schedules.
Automation: Templates govern how shifts are automatically populated when you create a new schedule period.
Consistency: They ensure that recurring roles, times, and requirements are applied identically across different weeks or months, reducing manual data entry.
Tour of Duty
A Tour of Duty is the specific period of time during which an associate is eligible to be scheduled within a team. It carries all the necessary logic and "rules" for that individual during that window.
Definition: It defines "when" an associate belongs to a team and "how" they can be scheduled.
Scheduling Characteristics: Each tour includes specific parameters for that associate, such as their job qualifications, positions, or preferred days of the week.
Flexibility & Duration:
Long-term: For staff physicians, a single Tour of Duty might span their entire employment.
Short-term: For residents, a Tour of Duty usually matches a specific rotation block, meaning they will have many different tours as they move between teams.
User
A User is a real-world individual who holds a registered account on the Mesh AI platform. While an "Associate" represents a slot on a schedule, the User is the actual human logging in to manage it.
Account Ownership: Users maintain full control over their own accounts. They are responsible for managing their personal User Settings, including contact details and how they interact with the platform.
Organizational Links: A single user can be connected to one or more Organizations through an Associate record. This allows a clinician to use one login even if they work across multiple independent hospitals or networks.
Preference Management: Users decide their own notification triggers and delivery methods (SMS, email, or push), ensuring they stay informed on their own terms.