Major documentation overhaul for binary serialization and SignalR: - Simplified and clarified AyCode.Core README, with direct links to new deep-dive docs (BINARY_IMPLEMENTATION.md, BINARY_WRITERS.md) - Added BINARY_WRITERS.md: detailed design and rationale for ArrayBinaryOutput and BufferWriterBinaryOutput, chunk sizing, and buffer management - Refined BINARY_IMPLEMENTATION.md: clearer buffer management, output strategies, and hot-path rules; references new writers doc - Added SIGNALR_BINARY_PROTOCOL.md: full wire format, zero-copy pipeline, dual BWO pattern, and read path for custom SignalR protocol - Updated SignalRs README and SIGNALR.md: clarified protocol, tag system, request/response flow, and technical debt - Improved cross-linking and discoverability throughout These changes make the technical documentation clearer, more maintainable, and easier to navigate for advanced contributors. |
||
|---|---|---|
| .. | ||
| Loggers | ||
| Logins | ||
| SignalRs | ||
| docs | ||
| AyCode.Services.csproj | ||
| README.md | ||
README.md
AyCode.Services
@project { type = "framework" }
Shared service implementations: SignalR communication (custom binary protocol), login services, and remote log writers.
Documentation
| Document | Topic |
|---|---|
SIGNALR.md |
Client-side SignalR transport (tags, wire protocol, req/resp flow) |
LOGGING_REMOTE.md |
Remote log writers (HTTP, browser console, SignalR) |
Folder Structure
| Folder | Purpose |
|---|---|
Loggers/ |
Remote log writers: HTTP, browser console (JS interop), SignalR |
Logins/ |
Base and client-side login service implementations |
SignalRs/ |
Custom binary SignalR protocol, client base, message tagging, serialization |
Dependencies
| Dependency | Purpose |
|---|---|
AyCode.Core |
Core types, serializers, compression |
AyCode.Entities |
Entity base classes |
AyCode.Interfaces |
Service contracts |
AyCode.Models |
DTOs |
Microsoft.AspNetCore.SignalR.Client |
SignalR client |
Microsoft.AspNetCore.SignalR.Common |
IHubProtocol for custom binary protocol |
Microsoft.AspNetCore.Authentication.JwtBearer |
JWT authentication |