Skip to content

Administration

Functions for administrators.

Admins Only

These functions are only available to users with admin role.

Open Admin Area

  1. Click on Your profile picture in the sidebar
  2. Select "Admin Area"

User Management

View Users

The user list shows:

ColumnMeaning
NameUsername
Display NameFull name
EmailContact address
Roleadmin / user / viewer
CreatedRegistration date
Last LoginLast activity

Create New User

  1. Click on "Add User"
  2. Fill out the form:
    • Username - For login (unique)
    • Display Name - Full name
    • Email - Optional, for password reset
    • Password - Initial password
    • Role - admin / user / viewer
  3. "Create"

Edit User

  1. Click on a user
  2. Change the desired fields
  3. "Save"

Password Reset

Admins can reset a user's password. The user receives a temporary password and must change it at next login.

Delete User

  1. Click on Delete icon
  2. Confirm the deletion

Warning

Deleting a user is permanent. The user's projects remain but are no longer assigned to any user.

Roles

Admin

  • Full access to all functions
  • User management
  • Manage master templates
  • Delete system annotations

User

  • Create and manage projects
  • Upload models
  • Perform cost calculations
  • Use master templates (not create)

Viewer

  • Read-only access
  • Can only access projects via share links
  • No access to dashboard

Share Tokens

Overview of all active share links:

  • Project - Associated project
  • Token - Share URL
  • Created by - User
  • Expires - Validity period
  • Accesses - Number of views

Revoke Token

  1. Click on Close icon
  2. Confirm

The share link will no longer work.

Annotations

Overview of all annotations in the system:

  • Filtered by project
  • With creator and date
  • With delete option

Bulk Actions

  • Delete all in project - Removes all annotations from a project
  • Delete by date - Removes old annotations

System Statistics

Overview of system usage:

  • Users - Count, thereof active
  • Projects - Total, per user
  • Models - Total, storage usage
  • Storage - Used vs. available

Maintenance

Clear Cache

  1. Click on "Clear Cache"
  2. The Redis cache is cleared
  3. The application reloads data from the database

When to Clear Cache?

Only when having issues with stale data. Not needed in normal operation.

Database Cleanup

Removes orphaned entries:

  • Deleted models without project
  • Expired share tokens
  • Old session data

Message Broker

Overview of the Redis Pub/Sub system for real-time updates.

Broker Statistics

StatisticDescription
ConnectionsActive WebSocket connections
Messages/secThroughput of real-time updates
ChannelsActive Pub/Sub channels
Stream SizeMessage count per stream

Dead Letters

Failed messages are stored as Dead Letters:

  1. Click on "Message Broker"
  2. The list shows failed messages with error descriptions
  3. Two actions are available per message:
ActionDescription
ReprocessResend the message
DeletePermanently remove the message

Stream Management

For each channel you can:

  • View stream info (message count, first/last entry)
  • Trim stream - Remove old messages to free memory

Backup & Restore

Create and manage database backups directly in the admin panel.

Create Backup

  1. Click on "Create Backup"
  2. The system creates a full database dump
  3. Progress is displayed

Existing Backups

The list shows all stored backups:

ColumnMeaning
FilenameName of the backup file
TimestampCreation date and time
SizeFile size

Restore Backup

  1. Select a backup from the list
  2. Click on "Restore"
  3. Confirm the restoration

Warning

Restoring a backup overwrites the current database. Create a backup of the current state first.

Spatial Indexing

Manage spatial indexes for faster collision detection and queries.

Check Status

The overview shows for each model:

ColumnMeaning
ModelModel name
StatusIndexed / Not indexed / In progress
ElementsNumber of indexed elements
Last UpdatedTimestamp of last indexing

Build Index

  1. Select a model that is not indexed
  2. Click on "Start Indexing"
  3. Indexing runs in the background

When to Index?

Spatial indexes significantly speed up collision detection and spatial queries. Recommended for all models that are regularly checked.

System Logs

View recent application logs.

  1. Click on "System Logs"
  2. The most recent log entries are displayed
  3. Filter by severity (Info, Warning, Error)

Troubleshooting

System logs are useful for diagnosing issues with conversions, imports, or API errors.

BIM AVA Documentation