Hugging Face's logo

Spaces:
Kraft102
/
widgettdc-api
Paused

App Files Community
widgettdc-api
File size: 4,713 Bytes
5a81b95
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# WidgetBoard Architecture

## Overview

WidgetBoard is an enterprise-grade, widget-based dashboard platform built with React, TypeScript, and modern web technologies. The architecture is designed for security, scalability, and maintainability.

## Architecture Diagram

```
┌─────────────────────────────────────────────────────────────────┐
│                         Browser Client                           │
├─────────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Widgets    │  │  Components  │  │   Contexts   │          │
│  └──────────────┘  └──────────────┘  └──────────────┘          │
│         │                  │                  │                  │
│         └──────────────────┴──────────────────┘                 │
│                           │                                      │
│         ┌─────────────────┴─────────────────┐                  │
│         │                                     │                  │
│  ┌──────▼──────┐                    ┌────────▼─────┐           │
│  │ MCP Client  │◄───────────────────┤    Logger    │           │
│  └─────────────┘                    └──────────────┘           │
│         │                                                        │
│         │ WSS (Secure WebSocket)                               │
├─────────┼────────────────────────────────────────────────────┤
│         │                                                        │
│         ▼                                                        │
│  ┌─────────────┐                                               │
│  │ MCP Server  │ (External Service)                           │
│  └─────────────┘                                               │
│         │                                                        │
│         ├──────► Microsoft Graph API (Outlook Integration)     │
│         ├──────► Gemini AI API (AI Features)                   │
│         └──────► Other Data Sources                            │
└─────────────────────────────────────────────────────────────────┘
```

## Core Components

### 1. Application Layer
- Root application with context providers
- Shell with header, sidebar, and dashboard
- Widget initialization and management

### 2. Widget System
- Central registry for widget definitions
- Dynamic widget loading and lifecycle
- 10+ specialized widgets (Chat, Email RAG, Performance Monitor, etc.)

### 3. Security Layer
- Input sanitization and validation
- Rate limiting and circuit breaker
- JWT authentication
- Sensitive data redaction

### 4. Communication Layer
- MCP Client with WebSocket
- Automatic reconnection
- Request/response handling
- Event subscription

### 5. Logging System
- Structured logging with context
- Multiple transports
- Performance monitoring
- Sensitive data protection

## Data Flow

```
User Action → Widget → Context → MCP Client → WebSocket → Server → Response → Update UI
```

## Security Architecture

### Defense in Depth
1. Input sanitization (XSS, SQLi prevention)
2. WSS with JWT authentication
3. RBAC and feature flags
4. Data encryption and redaction

### Circuit Breaker Pattern
- CLOSED: Normal operation
- OPEN: Reject requests after failures
- HALF_OPEN: Test recovery

## Performance Targets
- FCP: < 1.5s
- LCP: < 2.5s
- TTI: < 3.5s
- Test Coverage: 70%+

See full documentation in [docs/](../docs/) directory.