Quick rule
Object = noun (place, lock, key, user)
Function = verb (share, send, schedule, block)
How the objects are connected
Organization (optional) → Place → Sub place (optional) → Lock ↔ Keys → Users
Interfaces and components
App
The app where users unlock and where certain roles can perform simple administration. Unlocking is done via Bluetooth when the user has a valid key and is near a lock.
Web portal
The administrative interface where places, users, locks, keys, and settings are managed. Primarily used by administrators and installers.
NFC sticker
An NFC tag placed near the lock. Used to “tap” the phone against to unlock. It can also be required for unlocking to take place.
Structure
A top-level structure that groups multiple sites in a hierarchy. Used when a company has many places and needs an overview.
Place
A collection of users and locks representing an area, such as an office or property. Used to organize access and administration.
A place under another place in the structure, used for delegated administration (e.g. allowing tenants to manage access for their staff in a commercial property). Locks can be shared to it from a higher-level place, and it can have its own administrators.
A way to group places for better overview, such as “Office” or “Region”. Used for sorting and filtering.
Access objects
Lock
A lock (door, gate, etc.) managed in Parakey via a Parakey device. It can be shared with other places and included in keys.
Shared lock
A lock shared from one place to another, allowing the receiving place to grant access via its keys. Settings are controlled by the place that owns the lock.
Lock ownership
The place that “owns” the lock (usually where it is installed) and is responsible for its settings. Ownership can be transferred between places if needed.
Key
A mobile key that grants access to one or more locks and can be seen as a “permission group”. Keys can have rules such as schedules, possibility to be sent from the Parakey app, and other restrictions.
Schedule
A time-based rule controlling when something applies or happens, such as when a key is valid or when a lock should remain unlocked.
A schedule linked to one or more keys, defining which days and times the key is valid. Used for recurring time-based access (e.g. weekdays 07:00–19:00).
A schedule that keeps a lock unlocked during specified times. Commonly used for entrances during office hours.
How long the lock stays unlocked after being opened via the app before locking again.
People and permissions
User
A person (linked to an email address) in the system. A user can have roles and keys across one or more places.
A user’s permission level at a place, determining what they can see and do in the web portal and/or app.
Guest
A user without administrative rights. Can use their access but cannot manage the place.
Guest manager
A role that can invite users and send keys. Intended for operational responsibility without full admin rights.
Guest manager via app
A role that can invite users and send keys via the app, but not via the web portal.
A role for installing and managing Parakey devices, with installation-related permissions only.
Administrator
A role with broad rights to manage users, keys, schedules, and settings at a place.
Owner
The highest role with full control over a place.
Logs
Event logs
Logs showing access events (who unlocked what and when). Used for traceability and troubleshooting.
Admin logs
Logs showing administrative changes and who made them.
Integration
API
Interface for integrating Parakey with other systems to automate user and key management and retrieve access logs.
SDK
Interface for enabling unlocking of Parakey devices (locks) via a third-party app without requiring the Parakey app.
