docs: update architecture documentation and manifests

Refine technical documentation to reflect current architecture, component structure, and routing conventions for the vcon console.
This commit is contained in:
Team Dark Devil committed 2026-11-17 21:22:55 +06:00
1 parent bb938c33c0
commit 367dd819f8
64 files changed
+910 -2661

No files matched your search

+6 -9
View File
@@ -1,12 +1,9 @@
# Core Auth Manifest
# Authentication Engine Manifest
## Purpose
JWT-based authentication engine for Client SDK connections during Socket.IO handshakes.
Provides authentication and session security for both Administrator Console users and Client SDK connections (`core/auth/*`).
## Key Logic
- Signs JWT with `clientId`, `rateLimit`, and timestamp.
- Verifies bearer tokens during Socket.IO connection handshake.
- Disconnects invalid or expired tokens immediately.
## Dependencies
- `jsonwebtoken`
## Modules
- `jwt.ts`: Signs and verifies Client SDK JWT tokens (`clientId`, `name`, `rateLimit`) using `DATASTACK_JWT_SECRET` or the active `admin_settings.jwt_secret`.
- `adminSession.ts`: WebCrypto HMAC-SHA256 administrator session token signer/verifier (`datastack_admin_session` HTTP-only cookie) compatible with both Next.js Edge Middleware and Node.js route handlers.
- `adminUsers.ts`: PostgreSQL-backed administrator account store (`admin_users`) using `crypto.scrypt` password hashing, timing-safe verification, and brute-force login lockout tracking (`admin_login_attempts`).