u

src/automats/authAutomat.js

@@ -1,3 +1,26 @@
+/**
+ * @file authAutomat.js
+ * @description Central authentication and multi-tenant session manager.
+ * Tracks current user, Google OAuth client ID, and active company selection.
+ *
+ * Upstream Triggers:
+ * - `AuthBootstrap.jsx`: Calls `bootstrapSession(session)` on initial app load.
+ * - `LoginPage.jsx`: Calls `loginWithGoogle(credential)` or `loginWithCredentials(body)`.
+ * - `UserMenu.jsx`: Calls `switchCompany(companyId)` or `logout()`.
+ *
+ * Downstream Triggers:
+ * Subscribed to by almost all company-scoped automats, orchestrating their loading
+ * when authenticated (`authed` + `selectedCompanyId`) and reset on logout (`anon`):
+ * - `companyAutomat`, `categoryAutomat`, `brandAutomat`, `unitAutomat`, `posterminalAutomat`
+ * - `attributeAutomat`, `propertyAutomat`, `supplierAutomat`, `warehouseAutomat`
+ * - `sseAutomat`: Disconnects/reconnects SSE stream to `/api/events` per company
+ * - `chatAutomat`: Reconnects AI chat SSE stream and reloads conversations
+ * - `createListAutomat` instances (`articleIndexAutomat`, `deliveryAutomat`,
+ *   `quoteAutomat`, `orderAutomat`, `entityAutomat`, `customergroupAutomat`, `numberAutomat`)
+ * - Grid history automats (`articleHistoryGridAutomat`, `globalHistoryGridAutomat`)
+ * - `artikelAutomat`: Clears cached articles on logout
+ */
+
 import { Automat } from 'react-automat';
 import { auth, company } from '../api';