Core Concepts

Understanding these concepts will help you navigate the admin dashboard and use the API effectively.

Workspace (Tenant)

Every organisation has an isolated workspace (also called a tenant). All data — locations, surveys, feedback, team members — is scoped to a workspace. Workspaces are provisioned by EnaCore (the platform layer); contact your account manager to create one.

Location hierarchy

Building
└── Floor
    └── Unit
        └── Location (virtual anchor point for a poster)

• Building — A physical building or campus site.
• Floor — A level within a building.
• Unit — A room, corridor section, or service zone on a floor.
• Location — A named anchor point within a unit. One unit can have multiple locations (e.g., Men's Restroom and Women's Restroom on the same floor).

Each location has a unique location code that is embedded in QR poster URLs.

Poster

A poster is a printable QR code card that a visitor scans to submit feedback. Posters have a type that determines which form is shown:

Posters are generated from templates. A template defines the visual design (logo, colours, layout). When you assign a template to a location and activate it, a unique QR code is generated for that poster.

Survey

A survey is a sequence of questions configured in the Survey Builder. Surveys support:

• Multiple question types (rating, choice, text, matrix, NPS, CSAT, scale)
• Multilingual content (you can add translations for each question)
• Conditional logic (show/hide questions based on previous answers)
• Versions (you can publish a new version without losing historical responses)

A survey can be deployed to one or more locations. Deploying links the survey to a poster at that location.

Session

When a visitor scans a survey poster, a session is created. The session tracks:

• Which survey version the visitor saw
• The answers they submitted
• Whether the session was completed or abandoned
• Timestamps and (optionally) device/browser metadata

Sessions are the raw data behind all survey analytics.

Feedback Ticket

The Feedback module collects open-ended feedback linked to a location. Unlike surveys, the feedback form is simple: a category, a description, and an optional photo. Submissions become tickets that admins can view, tag, and close.

Hygiene Assessment

The Hygiene module is specifically for facility and cleaning management. Visitors (or cleaning staff) submit a 1–5 star rating for each hygiene category (cleanliness, smell, supplies, etc.). Results feed the hygiene analytics and can trigger alerts.

AI Insight

An AI Insight is an automatically generated text summary of feedback for a given module (hygiene, surveys, feedback, cleaning) and time period. Insights are generated by Google Gemini and stored per-workspace. They anonymise PII before sending to the AI provider.

Team Member

A team member is a person with access to the admin dashboard. Members have roles that control what they can see and do:

Plan & Entitlements

Workspaces are on a plan that determines which features are available and usage limits (AI quota, notification quota, storage). Plans are managed via EnaCore; the current plan is visible in Global Settings → Subscription.