dasomel
한국어
All documentation
OPERATING DOCUMENT / NARWHAL PORTAL

Portal Architecture

Next.js 16 App Router structure, gRPC communication, and OIDC session models.

01 / Context02 / Procedure03 / Operations04 / Verification

Portal Architecture

Narwhal Portal utilizes a modern web architecture ensuring tight integration with cluster control planes.

Technology Stack

  • Frontend Framework: Next.js 16 (App Router), React 19, TypeScript
  • Styling & Design System: Tailwind CSS, Radix UI Primitives, Lucide Icons
  • Authentication: NextAuth.js with Keycloak OpenID Connect federation
  • Backend Communication: Protocol Buffers (.proto), gRPC-web, and Envoy gRPC-JSON transcoding

In this design the Browser–Next.js boundary owns the user session, Next.js–Gateway carries web-friendly gRPC traffic, and Gateway–Control Plane uses native gRPC. Keycloak is modeled separately as the identity plane rather than as part of the primary data path.

DOCUMENT TRACE

Return to the project record to see architecture, development pulse, proof and related field notes in one context.