AyCode.Core/AyCode.Services
Loretta 9150df6982 Improve binary/SignalR docs, add protocol and writer deep-dives
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.
2026-04-04 09:27:36 +02:00
..
Loggers Update README links to use code-style paths for docs 2026-03-30 08:01:05 +02:00
Logins Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
SignalRs Improve binary/SignalR docs, add protocol and writer deep-dives 2026-04-04 09:27:36 +02:00
docs Improve binary/SignalR docs, add protocol and writer deep-dives 2026-04-04 09:27:36 +02:00
AyCode.Services.csproj Refactor: Split and expand project-level documentation 2026-03-29 22:16:28 +02:00
README.md Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00

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