Skip to main content

Advanced System Features

Overview of additional infrastructure capabilities in the server.

Webhooks​

The Webhook module enables integration with third-party systems by sending HTTP requests when events occur in the system.

Configuration​

An administrator can configure a URL (Endpoint) that will receive messages for:

  • Device Status Change: Device disconnected/connected.
  • Alert Triggered: New alert was triggered.
  • User Created/Deleted: User changes.

The system sends a POST Request with a Payload in JSON format containing the event details.

File Management (Uploads)​

The Upload module centralizes file handling in the system.

Storage​

The system supports multiple storage providers (configurable in ENV):

  1. Local: Saving to local disk (/uploads directory). Suitable for development or closed networks.
  2. Cloudinary: Cloud service for media management (recommended for production). Supports automatic compression and image resizing.
  3. S3: (Optional) Storage in Amazon S3.

Supported File Types​

  • Images (JPG, PNG) for memorials and logos.
  • APK files for software updates.
  • PDF documents (occasionally).

Maintenance Mode​

The Maintenance module allows super administrators to put the system in restricted mode.

Behavior​

When the mode is active (SYSTEM_MAINTENANCE=true):

  • All API requests (except Admins) are blocked with 503 Service Unavailable error.
  • End screens (GabaiSmart) will display a message that the server is under maintenance, but will continue to work with their locally stored information (Cache) in Offline mode.
  • This allows safe DB migrations or server upgrades.