User Guide

HR & compliance

Document tracking, expiry alerts, vendor compliance matrix. Module-gated under HR Compliance.

Toggle on the Compliance module
Enable the compliance module for document tracking, expiry alerts, and onboarding workflows. Available on every tier.
Compliance dashboard — per-employee and per-vendor document compliance.  Search, filter by status, click to fix.  CSV + PDF export.
Compliance dashboard — per-employee and per-vendor document compliance. Search, filter by status, click to fix. CSV + PDF export.

Document catalog

12 built-in document types ship with TTP:

W-4I-9W-9NDAMSASOWAgreementInsurance (COI)CertificationIDResumeOther

Add custom types under Settings → HR → Document Types.

Employment types → required docs

6 built-in employment types map to required-document baselines:

🧑‍💼

W2 Full

Requires: W-4 + I-9 + ID
🧑‍💻

1099 Contractor

Requires: W-9 + agreement
🏛️

Solo LLC

Requires: W-9 + MSA + COI

Per-user overrides via Settings → HR → Compliance Baselines for edge cases (exemptions, additional requirements).

Expiry tracking

  • ✓Triggered lazily from status reads — no cron daemon
  • ✓In-process throttle: max 5min per tenant scan
  • ✓Bulk-stamps expiry_reminder_sent_at post-send
  • ✓Optional vendor-admin Cc per tenant
  • ✓Configurable expiry window (default 30 days)
  • ✓Email digest with all expiring docs per recipient

Vendor compliance matrix

5 built-in vendor types carry their own required-document AND required-contract baselines:

🏢

Staffing Agency

Docs: W-9 + COI. Contracts: signed MSA + NDA. Most common vendor shape.
🧑‍💼

Independent Consultant

Docs: W-9 + agreement. Lighter compliance for individual contractors.

Vendor detail page's Compliance tab shows live status per requirement (missing present under review). Upload + Send buttons fill gaps inline.

Proof of work — cadence per user

For users required to attach proof-of-work to billable time, the tenant picks a default cadence and individual users can override:

📅

Weekly summary

One image per employee per week — best for consultants, lawyers, agencies, salaried knowledge workers. Matches billing cadence.
📸

Per session

Proof captured at each work session — kiosk clock-out job photos for field techs, or a screenshot attached per web entry. Best for HVAC / plumbing / security / home services.
🚫

None

Trust-based; no proof check on submit. Kiosk identity selfies (if enabled) run independently.

Mixed firms: tenant sets a default (say weekly) and the Edit User dialog lets admin override per person (a field tech gets per_session). Master ON/OFF stays per-user separate from the cadence — turning "Require proof of work" off short-circuits the check regardless of cadence.

Outbound PO gate (optional)

Super_admin can flip a tenant-wide toggle: block outbound PO activation on vendor gap. When enabled, activating an outbound PO for a vendor with any missing compliance gap throws ValidationError listing the gaps. Super_admin can bypass per-PO via ?force=true on the activate route — audit row captures the override.

Tip
Module-gating is orthogonal to role-gating. Disabling the compliance module hides the dashboard, blocks the API routes, and skips the expiry pipeline — without touching role permissions. Re-enable later and history snaps back.