Platform Cache

​

Purpose

​

Public API

​

Key format

• Full key: org-{organizationId}:{namespace}:{key}.
• Organization ID is required; omit only when using helpers that inject it (e.g. useCachedQuery uses current org from context).
• Missing org throws: “Cache requires organization context”.

​

Usage

import { cacheService, createCacheKey, useCachedQuery } from '@/platform/cache';

// With explicit org (e.g. in queryFn)
const key = createCacheKey(orgId, 'my-namespace', 'item-1');
await cacheService.set(key, data, { ttl: 300 });
const value = await cacheService.get(key);

// React: useCachedQuery injects org from useOrganization()
const { data } = useCachedQuery(['my-query'], () => fetchData(), { staleTime: 300000 });

​

Security

• No PHI/PII in cache keys or values per policy.
• Tenant isolation enforced by key format and org validation.
• Cache is cleared on sign-out (wired in ResponsiveNav).
• User cache is invalidated on role assignment changes (wired in PermissionService).