Compliance Administration

Compliance Administration

1. What it is

Compliance Administration is the admin sidebar section where you configure how the platform enforces labor and employment law during shift assignment. It contains the work-hour limits, rest-period rules, jurisdiction mappings, the employment-law rule library, a compliance explorer with gap analysis, and the audit trails that record every enforcement decision.

• Enablement: The section appears automatically for every admin under Admin → Compliance. No app license is required. The Compliance Audit Logs surface within it requires the Enterprise platform tier.
• What it is not: This is not the Compliance Hub app (SOX/SOC 2 framework compliance) or Content Governance (moderation of user-generated content). It governs work-hour, rest-period, and labor-law enforcement in scheduling.

2. Standing it up

1. Go to Admin → Compliance → Work Policy Settings. A default RestPeriodSetting record is created automatically when a business is first created — you start with working defaults, not a blank form.
2. Review the hour limits and rest-period minimums. The defaults are 12 hours daily, 40 hours weekly, and 8 hours minimum rest. All three enforcement toggles are on by default.
3. Go to Admin → Compliance → Jurisdictions and create the jurisdictions your business operates in (country, state, or city). You can import from the global MangoApps jurisdiction catalog or create custom ones.
4. Go to Admin → Compliance → Jurisdiction Mapping and assign jurisdictions to your locations. Until a location has at least one jurisdiction, no labor-law rules are enforced for shifts at that location — this pairing is the most common silent setup gap.
5. Go to Admin → Compliance → Labor Law Rules and create the rules for each jurisdiction — wage, overtime, break, scheduling-notice, or minor-work rules.
6. To confirm it is working, assign an employee to a shift that would violate a configured limit. The assignment should either be blocked or produce a warning, depending on whether the violation is configured as a hard disqualifier or a warning penalty.

3. How it fits together

The sidebar groups eight surfaces into one section, each handling a different part of the compliance lifecycle:

• Work Policy Settings — tenant-wide hour limits, rest periods, break enforcement mode, and match-calculation dials. This is the enforcement configuration.
• Labor Law Rules — per-business, per-jurisdiction scheduling rules (wage, overtime, break, schedule, minor).
• Employment Law Rules — the global MangoApps-maintained rule library, plus business-specific overrides.
• Jurisdictions — the business’s jurisdiction registry (country/state/city hierarchy).
• Jurisdiction Mapping — which jurisdictions apply to which locations.
• Compliance Explorer — a read-only browser over the global rule catalog, with gap analysis, what-if simulation, and semantic search.
• Compliance Audit Logs — shift-assignment compliance decisions (Enterprise tier only).
• Employment Law Audit History — the immutable employment-law event trail.

Enforcement vs. observation. Several controls operate on a spectrum rather than a simple on/off:

• Break enforcement mode has three settings: off (no evaluation), observe (evaluate and record, but do not block anything), and enforce (evaluate, record, prompt at clock-out, and block non-compliant assignments). New tenants start in observe so admins can review their break-compliance backlog before it starts blocking.
• Hard disqualifiers vs. warning penalties. Each compliance check — daily hours, weekly hours, rest period, overlapping shifts, approved leave, and availability conflicts — can be set as a hard disqualifier (blocks the assignment entirely, 0% match) or left as a soft check (reduces the match percentage by a configurable penalty but still allows the assignment).

Three-tier rule architecture. The platform resolves which rules apply to a shift by combining three layers:

1. System rules (SystemEmploymentLawRule) — global, maintained by MangoApps, covering 18 document types and 18 rule categories across federal, state, and city jurisdictions.
2. Business overrides (BusinessEmploymentLawOverride) — per-business additions or stricter versions of system rules. Cannot relax a system rule.
3. Labor law rules (LaborLawRule) — per-business, per-jurisdiction scheduling rules that the shift-assignment engine reads directly.

When rules at multiple jurisdiction levels apply, the more specific jurisdiction wins (city over state, state over country).

4. Running it

Reviewing the compliance posture

1. Go to Admin → Compliance → Compliance Explorer.
2. The overview shows counts of total rules, federal rules, state rules, and city/local rules from the global catalog.
3. Click Gap Analysis to run a gap analysis against your business’s locations. The service checks jurisdiction coverage, document completeness (employee handbook, anti-harassment policy, safety compliance), training requirements, and workplace posting requirements, and produces a compliance score with prioritized action items.

Running a what-if simulation

1. In the Compliance Explorer, click What-If.
2. Choose a scenario type: add a new location, add employees to a state, or change industry.
3. For a location scenario, select a state and optionally a city. The simulator compares your current rules against the rules that would apply in the new location and reports additional requirements, impact level, and recommended actions.

Searching the rule library

1. In the Compliance Explorer, click Search.
2. Enter a natural-language query. The search first tries semantic search (vector similarity against rule embeddings), then falls back to keyword search if no results match above the relevance threshold.

Adjusting enforcement dials

1. Go to Admin → Compliance → Work Policy Settings and click Edit Settings.
2. Adjust the hour limits, enforcement toggles, hard disqualifiers, or warning penalties.
3. Save. Changes take effect immediately for all future shift assignments.

Reviewing compliance decisions

1. Go to Admin → Compliance → Compliance Audit Logs (Enterprise tier required).
2. Filter by event type, decision, user, date range, or emergency overrides.
3. The analytics dashboard shows override usage, violation trends, weekly-hours risk, and work-context coverage.
4. Export the filtered log as CSV for external reporting.

5. Settings

All settings below are on the Work Policy Settings page (Admin → Compliance → Work Policy Settings).

Setting	Default	What it changes
Maximum Daily Hours	12.0 hours	Cap on hours an employee can be assigned in a single day
Maximum Weekly Hours	40.0 hours	Cap on hours an employee can be assigned in a week
Minimum Rest Period	8.0 hours	Minimum gap required between consecutive shifts
Enforce Daily Hour Limits	On	Whether the daily-hours cap blocks or just warns
Enforce Weekly Hour Limits	On	Whether the weekly-hours cap blocks or just warns
Enforce Minimum Rest Periods	On	Whether the rest-period minimum blocks or just warns
Daily Hours Warning Threshold	80%	Percentage of the daily cap at which a warning fires
Weekly Hours Warning Threshold	80%	Percentage of the weekly cap at which a warning fires
Allow Consecutive Shift Overlap	On	Whether shifts may overlap for handover time
Max Consecutive Shift Overlap	30 minutes	How much overlap is allowed when enabled
Break Enforcement Mode	Observe	Off / observe / enforce — controls break-compliance evaluation
Daily Hours Hard Disqualifier	On	Whether exceeding the daily cap blocks assignment (0% match)
Weekly Hours Hard Disqualifier	On	Whether exceeding the weekly cap blocks assignment
Rest Period Hard Disqualifier	On	Whether violating the rest minimum blocks assignment
Overlapping Shifts Hard Disqualifier	On	Whether overlapping shifts block assignment
Leave Requests Hard Disqualifier	On	Whether approved leave blocks assignment
Availability Conflicts Hard Disqualifier	On	Whether availability conflicts block assignment
Emergency Override Enabled	On	Whether managers/admins can override compliance blocks
Contracted Days Off Block Mode	Soft prompt	Whether assignments on contracted days off prompt or hard-block

6. More help

• Labor & Employment Law Rules — detailed article on jurisdictions, rule types, overrides, and legal updates
• Audit Logs & Activity History — detailed article covering all four audit log surfaces
• Ask AI — the assistant answers compliance configuration questions from these articles.