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, Composer, 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.
SchedulingNormal admin desk; scheduler-specific capability and field-work eligibility matter inside the workflow.
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.
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.
Deucalion ComposerCustomer-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.
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.

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.
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