u

src/automats/sseAutomat.js

@@ -1,3 +1,26 @@
+/**
+ * @file sseAutomat.js
+ * @description Central Server-Sent Events hub managing the single persistent
+ * `GET /api/events` connection and fanning mutation signals into domain automats.
+ *
+ * Upstream Triggers:
+ * - `authAutomat`: Subscribes to auth state changes — reconnects stream when
+ *   `selectedCompanyId` changes/becomes available; disconnects on `'anon'` (logout).
+ *
+ * Downstream Triggers:
+ * Dispatches real-time SSE mutation events into specific automats:
+ * - `artikelAutomat`: Re-fetches article via `reloadArticle(sku)` on `article-<sku>` signals.
+ * - `articleDetailAutomat` (`articleHistoryAutomat`, `articleSupplierAutomat`):
+ *   Reloads SKU-keyed views on `article-<sku>` signals.
+ * - `categoryAutomat`: Triggers `actions.loadTree()` and `invalidateAllCategoryViews()`
+ *   on `'category'` SSE events.
+ * - `articleIndexAutomat`: Triggers `actions.reload()` on `'articles'` SSE events.
+ * - `warehouseAutomat`: Triggers `actions.reload()` on `'warehouse'` SSE events.
+ * - `supplierAutomat`: Triggers `actions.reload()` on `'supplier'` SSE events.
+ * - `attributeAutomat`: Triggers `actions.load()` on `'attributename'` SSE events.
+ * - `propertyAutomat`: Triggers `actions.load()` on `'propertyname'` SSE events.
+ */
+
 import { Automat } from 'react-automat';
 import authAutomat from './authAutomat';
 import artikelAutomat from './artikelAutomat';