АРХ - NODEDC PLATFORM: каркас платформенного репозитория

2026-05-04 10:02:18 +03:00
commit 0f89c4d126
12 changed files with 755 additions and 0 deletions
@@ -0,0 +1,31 @@
+# NODE.DC Auth SDK
+
+Будущий общий пакет для приложений, которые контролируются кодом NODE.DC.
+
+## Target responsibilities
+
+- загрузка JWKS;
+- валидация JWT;
+- проверка issuer/audience/exp;
+- нормализация claims;
+- helper `requireAppAccess(groupName)`;
+- helper `getCurrentUser()`;
+- typed `AuthUser`.
+
+## Type contract
+
+```ts
+export type AuthUser = {
+  sub: string;
+  email: string;
+  name?: string;
+  groups: string[];
+  entitlements?: string[];
+};
+```
+
+## Scope
+
+Первый SDK рассчитан на Launcher backend и будущие Node.js/Next.js сервисы.
+
+Для Plane fork на Python/Django нужна отдельная реализация middleware по тем же правилам, а этот пакет остается спецификацией для TypeScript приложений.