Deep Wiki Knowledge Base
Welcome to the nogoo9 Deep Wiki Knowledge Base. This section provides deep architectural documentation, component interaction sequence diagrams, state machine specifications, security threat models, and subsystem designs for the nogoo9 platform.
🗺️ System Architecture & Subsystems
📚 Deep Wiki Directory
| Section | Description | Key Topics |
|---|---|---|
| Architecture Overview | End-to-end component topology and system boundaries | Gateway design, zero-operator philosophy, request pathways, modular UI |
| Zero-CRD Pod Lifecycle | Pod orchestration & upgrade state machines | Pod spec generation, annotations, PVC locking, concurrency limits (ADR-026), 1-by-1 vs bulk upgrades |
| Auth & Security Model | OIDC authentication & cookie crypto | RFC 9728 metadata, AES-256-GCM cookies, singleflight refresh deduplication, template role/scope authorization (ADR-027) |
| Routing Proxy & Tunneling | Dynamic reverse proxying & auth modes | Header rewriting (X-User-Sub), WS piping, token-api / inject-headers, HTTP fallback transport |
| Peer Discovery & HA | Multi-replica secret negotiation | Leaderless startup, shared session keys, zero-database HA |
| MCP Tool Engine & Schemas | MCP protocol implementation | Transport adapters, tool registration, spawner & pod handler contracts, metadata extensions |
| UI & MCP Client Integration | Frontend web dashboard & client bridge | Modular React architecture (src/ui/components/), OIDC PKCE flow, handshake rules |