Skip to content

Commit 644cd89

Browse files
Replace ASCII art with Mermaid diagrams in docs
Updated documentation across multiple files to replace outdated ASCII art with modern Mermaid diagrams for improved visualization. - Enhanced **README.md** with diagrams for architecture, authentication flows, token lifecycle, and platform-specific configuration. - Updated **architecture-diagrams.md** with high-level architecture and detailed sequence diagrams for Blazor and native apps. - Improved **microsoft-external-id.md** with diagrams for token flow, Gateway integration, and backend service configuration. - Added flowcharts in **quick-start.md** for setup steps and common configuration patterns. - Introduced a comparison between Azure AD B2C and Microsoft Entra External ID. These changes improve clarity, readability, and developer experience.
1 parent c977ebf commit 644cd89

4 files changed

Lines changed: 505 additions & 446 deletions

File tree

docs/authentication/README.md

Lines changed: 31 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -57,16 +57,37 @@ The Codebreaker platform uses **Microsoft Entra External ID** for identity and a
5757

5858
### Architecture
5959

60-
```
61-
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
62-
│ Clients │ │ Gateway │ │ Backend │
63-
│ (Various) │────────▶│ (YARP) │────────▶│ Services │
64-
└──────────────┘ └──────────────┘ └──────────────┘
65-
• Blazor • JWT Validation • Game APIs
66-
• WPF • Token Forwarding • Ranking
67-
• MAUI • Authorization • Live
68-
• Uno Platform • API Routing • User Service
69-
• WinUI
60+
```mermaid
61+
graph LR
62+
subgraph "Client Applications"
63+
Blazor[Blazor]
64+
WPF[WPF]
65+
MAUI[MAUI]
66+
Uno[Uno Platform]
67+
WinUI[WinUI]
68+
end
69+
70+
subgraph "Gateway Layer"
71+
Gateway[Gateway YARP<br/>• JWT Validation<br/>• Token Forwarding<br/>• Authorization<br/>• API Routing]
72+
end
73+
74+
subgraph "Backend Services"
75+
GameAPIs[Game APIs]
76+
Ranking[Ranking]
77+
Live[Live]
78+
UserService[User Service]
79+
end
80+
81+
Blazor -->|JWT Tokens| Gateway
82+
WPF -->|JWT Tokens| Gateway
83+
MAUI -->|JWT Tokens| Gateway
84+
Uno -->|JWT Tokens| Gateway
85+
WinUI -->|JWT Tokens| Gateway
86+
87+
Gateway -->|Authenticated Requests| GameAPIs
88+
Gateway -->|Authenticated Requests| Ranking
89+
Gateway -->|Authenticated Requests| Live
90+
Gateway -->|Authenticated Requests| UserService
7091
```
7192

7293
### Key Components

0 commit comments

Comments
 (0)