Deucalion Docs
ReferenceAn information-oriented lookup resource. Use it to find specific values and definitions.
allaccesscapabilitiesrolesavailabilityatlas

Capability and Access Atlas

Look up which customer-facing surfaces depend on role, workspace, or feature availability and how those gates affect page visibility.

Before you start

  • You need to understand why a route, tab, action, or screen is visible for one user and missing for another.

Expected outcome

Teams can distinguish feature gating, role gating, and workspace mismatch from genuine product failures.

Gate types you will encounter

Gate typeWhat it controlsTypical examples
Role gateVisibility based on workspace role.Activity Feed for admins or owners only.
Capability gateWorkspace feature availability.AI Assistant, Quotes, Work Orders, Finance subfeatures, Document Templates, and connected-system tooling.
Field-work eligibilityWhether a member can appear in field assignment flows.Scheduler assignee pickers, field deployments, work-order assignment.
Workspace contextWhich tenant and data boundary the user is currently in.Notifications, assignments, site lists, mobile day run.

Tables behind the gates

Gate typeMain tablesWhy these tables matter
Role gateorganization_members, organization_invitationsWorkspace role and membership are not inferred from the base users row; they are resolved per organization.
Capability gateorganization_role_feature_policies, organization_member_feature_overridesThese tables explain why the same role can still see different desk availability in different workspaces or for specific members.
Field-work eligibilityorganization_memberscan_be_scheduled, can_manage_schedule, and scheduler_profile explain assignment visibility and office-vs-field behavior.
Workspace contextorganizations plus nullable organization_id across operational tablesExplains why some records survive outside an org or remain visible after detachment, while CRM and org-admin records do not.

Customer-facing admin routes with availability considerations

Route or deskVisibility pattern
CustomersNormal admin desk; later actions may depend on quotes or service-policy availability.
Client HandoverAdmin-only route that requires CRM capability.
SchedulingNormal admin desk; scheduler-specific capability and field-work eligibility matter inside the workflow.
PPM ForecastScheduler-capability route for future workload and capacity.
Data QualityAdmin-only analytics route; CRM and Reports rules are capability-aware inside the dashboard.
Workforce ProductivityAdmin-only analytics route; Work Orders, Scheduler, and Reports badges show source coverage.
QuotesCapability-gated in some workspaces.
Work OrdersCapability-gated in some workspaces.
FinancePublic customer-facing finance covers receivables and workspace billing; platform-owned credit controls are not part of public docs.
ContractorsAdmin-only route that requires work-order capability; visible UI is submission review, while contractor and grant management are backed by admin APIs.
InsightsAnalytics-style surface that may be limited by workspace feature availability.
ReportsCore export surface; some related intelligence tooling is platform-only and out of scope here.
Document TemplatesCustomer-facing only where template administration is enabled.
AI AssistantCapability-gated AI workspace feature.
Connected Systems / Integrations / API Keys / WebhooksAvailability depends on whether the workspace exposes connected-system operations.
Activity FeedRole-gated to office-side admins or owners. Engineers do not get this feed.

Customer-facing mobile surfaces with availability considerations

Screen or familyVisibility pattern
Dashboard / Sites / Inspections / ProfileCore navigation expected for normal engineer access.
Quotes and Work OrdersMay be available only if the workspace exposes those commercial/remedial workflows.
External Job PacksAvailable to a signed-in app user when an active contractor grant is bound to that user, even if the user is not a member of the sending organization.
AI Chat and AI ConversationsCapability- or subscription-gated AI feature.
Analytics DashboardAvailable only where the related analytics feature is enabled.
SubscriptionVisible where upgrade or entitlement handling is relevant to the account.
Specialist fire-damper / PDS toolsDepend on the job type and system type, not just a static menu decision.

Assignment visibility rules

ConditionWhat it changes
Member has field work enabledThey can appear in scheduler and live assignment pickers.
Member is office-onlyThey can coordinate work but should not appear as a field assignee.
Work is still draftEngineers should not treat it as live field-ready work.
Work is deployed and assignedIt can surface in engineer-facing execution views.
Work has a valid contractor grantIt can surface in contractor portal or native External Job Packs without granting organization membership.
Engineer visibility window is setField visibility is limited to the configured visible-from and visible-until window.

At the data level, this usually means a membership row allows scheduling, a deployment row or deployment-state field marks the work as live, and the underlying inspection or work-order row still points at the same site/system context the engineer will open.

Common “missing feature” explanations

SymptomLikely explanation
A route is missing from the admin sidebarWorkspace capability or role gate, not necessarily a broken route.
An engineer cannot see an assignmentDraft state, wrong workspace, wrong assignee, or field-work gate.
A contractor cannot see an external job packMissing or expired grant, revoked grant, inactive contractor, wrong app user binding, or insufficient permission.
A customer appointment notification cannot be recordedThe job lacks exact date, customer email, or offered/confirmed booking status.
AI screens prompt for upgrade or subscriptionCapability entitlement is not active for that account or workspace.
Activity Feed is inaccessibleThe signed-in account is not an org admin or owner.
Quote or work-order shortcuts are absent in mobileThe commercial or remedial feature set is not enabled for that workspace.

Best diagnostic order

  1. Confirm the signed-in workspace.
  2. Confirm the user role.
  3. Confirm feature availability for that workspace.
  4. Confirm record state such as draft, deployed, completed, or synced.
  5. Only then treat the missing route or action as a possible defect.

On this page