Factorizer/Cluster ERP WikiCluster ERP Türkçe
Home / Business modules

Reference

Intranet engagement

Reference for the engagement sub-module of intranet, with recognition between employees, quick links, and emergency alerts.

This page describes the engagement sub-module in src/cluster_erp/modules/intranet/engagement/. It holds recognition (kudos) between employees, quick links to tools, and emergency alerts shown as a banner. The service docstring calls the alert banner best-effort: delivery is never guaranteed (src/cluster_erp/modules/intranet/engagement/services.py:1-6). Company events moved to their own sub-module; see events.

Scope and source

  • Defined in: src/cluster_erp/modules/intranet/models.py (IntranetEmergencyAlert, IntranetKudos, IntranetQuickLink), engagement/services.py (KudosService, QuickLinkService, AlertService), engagement/routes.py, engagement/schemas.py, and engagement/metadata.py.
  • Count: 3 tables, 15 routes in engagement/routes.py, no ActionMeta.

Fields

Entity Key fields Source
IntranetKudos from_party_id, to_party_id, message, badge, is_public src/cluster_erp/modules/intranet/models.py:1073-1090
IntranetQuickLink label, url, icon, category, audience_segment_id, is_external, sort_order, is_active src/cluster_erp/modules/intranet/models.py:1092-1109
IntranetEmergencyAlert title, body, severity (info, warning, critical), active_from, active_to, is_active, dismissible, audience_segment_id, published_by src/cluster_erp/modules/intranet/models.py:144, src/cluster_erp/modules/intranet/models.py:1047-1071

Rules

  • Recognition is given as the caller's own party. Naming another sender needs intranet_kudos.read_all, and both sender and receiver must be active employees (src/cluster_erp/modules/intranet/engagement/routes.py:57-82).
  • Public recognition appears in the feed (src/cluster_erp/modules/intranet/feed/services.py:222-248).
  • GET /alerts/active returns the alerts that are active now, most severe first (src/cluster_erp/modules/intranet/engagement/routes.py:174-183, src/cluster_erp/modules/intranet/engagement/services.py:247-265). The service filter reads is_active, active_from, and active_to; it does not read audience_segment_id (src/cluster_erp/modules/intranet/engagement/services.py:251-262).
  • Deleting recognition, a quick link, or an alert sets deleted_at (src/cluster_erp/modules/intranet/engagement/services.py:86-94).

Routes

Router Paths Permission Source
kudos_router /kudos list, create, read, delete intranet_kudos.read, .create, .delete src/cluster_erp/modules/intranet/engagement/routes.py:27, src/cluster_erp/modules/intranet/engagement/routes.py:35-106
quicklink_router /quick-links list, create, read, update, delete intranet_quick_link.* src/cluster_erp/modules/intranet/engagement/routes.py:28, src/cluster_erp/modules/intranet/engagement/routes.py:110-170
alert_router /alerts/active, list, create, read, update, delete intranet_alert.* src/cluster_erp/modules/intranet/engagement/routes.py:29, src/cluster_erp/modules/intranet/engagement/routes.py:174-246

Terms introduced

Term Code identifier Definition Turkish term Source
kudos IntranetKudos Recognition one employee gives another, public or private. Takdir src/cluster_erp/modules/intranet/models.py:1073
emergency alert IntranetEmergencyAlert A time-boxed banner with a severity, shown above other content. Acil uyarı src/cluster_erp/modules/intranet/models.py:1047

Verified against commit 92f8051 on 2026-11-13.

Verified against commit 92f8051 · 2026-11-13