mirror of
https://github.com/RedWizardsLab/EchoHub.git
synced 2026-09-04 08:36:11 +02:00
119 lines
4.0 KiB
Markdown
119 lines
4.0 KiB
Markdown
# Media & Services
|
|
|
|
## File Upload
|
|
|
|
Files are uploaded via REST, validated by magic bytes, stored with GUID filenames,
|
|
and broadcast as a message with a download link.
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
participant Client as Client
|
|
participant CC as ChannelsController
|
|
participant FV as FileValidationHelper
|
|
participant FS as FileStorageService
|
|
participant CS as ChatService
|
|
participant DB as SQLite
|
|
|
|
Client->>CC: POST /api/channels/{channel}/upload (multipart)
|
|
CC->>CC: Check file size limits
|
|
CC->>FV: IsValidImage(stream) — magic byte check
|
|
FV->>FV: Read header: JPEG(FFD8FF) / PNG(89504E47) / GIF / WebP(RIFF+WEBP)
|
|
FV-->>CC: true/false
|
|
CC->>FS: SaveFileAsync(stream, extension)
|
|
FS->>FS: Generate GUID filename, write to uploads/
|
|
FS-->>CC: fileId (GUID)
|
|
CC->>CC: Determine MessageType (Image/Audio/File)
|
|
CC->>CS: SendMessageAsync (with file URL + optional ASCII art)
|
|
CS->>DB: INSERT Message
|
|
CS->>CS: BroadcastToAllAsync → fan out to clients
|
|
```
|
|
|
|
**Code references:**
|
|
|
|
| Step | File | Location |
|
|
|------|------|----------|
|
|
| Upload endpoint | `src/EchoHub.Server/Controllers/ChannelsController.cs` | Lines 108-200 |
|
|
| File validation | `src/EchoHub.Server/Services/FileValidationHelper.cs` | Lines 15-82 |
|
|
| File storage | `src/EchoHub.Server/Services/FileStorageService.cs` | Lines 1-47 |
|
|
| File download | `src/EchoHub.Server/Controllers/FilesController.cs` | Lines 22-53 |
|
|
|
|
---
|
|
|
|
## Link Embed Resolution
|
|
|
|
When a message contains URLs, the server fetches OpenGraph metadata for preview
|
|
embeds.
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
participant CS as ChatService
|
|
participant LE as LinkEmbedService
|
|
participant Web as External Website
|
|
|
|
CS->>LE: TryGetEmbedsAsync(messageContent)
|
|
LE->>LE: Extract URLs via regex
|
|
LE->>LE: Filter: max URLs per message, skip duplicates
|
|
|
|
loop For each URL
|
|
LE->>LE: Validate: http(s) only, block private IPs
|
|
LE->>Web: GET URL (timeout + size limit)
|
|
Web-->>LE: HTML response
|
|
LE->>LE: Parse og:title, og:description, og:site_name
|
|
LE->>LE: Parse theme-color meta tag
|
|
LE->>LE: Fallback to <title> if no og:title
|
|
end
|
|
|
|
LE-->>CS: List<EmbedDto> (or null)
|
|
Note over CS: Attached to MessageDto before broadcast
|
|
```
|
|
|
|
**Code references:**
|
|
|
|
| Step | File | Location |
|
|
|------|------|----------|
|
|
| Entry point | `src/EchoHub.Server/Services/LinkEmbedService.cs` | Lines 28-51 (`TryGetEmbedsAsync`) |
|
|
| URL extraction | `src/EchoHub.Server/Services/LinkEmbedService.cs` | Lines 145-160 |
|
|
| Private IP blocking | `src/EchoHub.Server/Services/LinkEmbedService.cs` | Lines 162-181 |
|
|
| OG tag parsing | `src/EchoHub.Server/Services/LinkEmbedService.cs` | Lines 187-210 |
|
|
| Theme color parsing | `src/EchoHub.Server/Services/LinkEmbedService.cs` | Lines 117-143 |
|
|
| ChatService integration | `src/EchoHub.Server/Services/ChatService.cs` | Lines 194-201 |
|
|
|
|
---
|
|
|
|
## Server Directory Registration
|
|
|
|
Public servers register with the EchoHubSpace directory for discoverability.
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
participant SDS as ServerDirectoryService
|
|
participant Dir as EchoHubSpace Directory
|
|
participant PT as PresenceTracker
|
|
|
|
SDS->>SDS: Check Server:PublicServer config
|
|
SDS->>Dir: SignalR connect (echohub.voidcube.cloud/hubs/servers)
|
|
SDS->>Dir: RegisterServer(name, description, host, userCount)
|
|
Dir-->>SDS: Registered
|
|
|
|
loop Every 30 seconds
|
|
SDS->>PT: Get online user count
|
|
alt Count changed
|
|
SDS->>Dir: UpdateUserCount(count)
|
|
end
|
|
end
|
|
|
|
Dir->>SDS: Ping
|
|
SDS->>Dir: Heartbeat
|
|
|
|
Note over SDS,Dir: Exponential backoff on disconnect (2s → 30s max)
|
|
```
|
|
|
|
**Code references:**
|
|
|
|
| Step | File | Location |
|
|
|------|------|----------|
|
|
| Service lifecycle | `src/EchoHub.Server/Services/ServerDirectoryService.cs` | Lines 29-122 |
|
|
| Registration | `src/EchoHub.Server/Services/ServerDirectoryService.cs` | Lines 195-212 |
|
|
| User count polling | `src/EchoHub.Server/Services/ServerDirectoryService.cs` | Lines 154-187 |
|
|
| Reconnection backoff | `src/EchoHub.Server/Services/ServerDirectoryService.cs` | Lines 77-82, 191 |
|