Adam
/
AyCode.Core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
AyCode.Core/AyCode.Services.Server/SignalRs
History
Loretta affa85e5c5 [LOADED_DOCS: 4 files, no new loads] 
Refactor docs: topic folders, TOON, XCUT, protocol sync

- Migrated all topic documentation into dedicated folders with canonical `README.md`, `ISSUES.md`, and `TODO.md` per topic (e.g., `LOGGING/`, `SIGNALR/`, `BINARY/`, `TOON/`).
- Added comprehensive TOON serializer documentation: design, format, options, attributes, inference, issues, and TODOs.
- Introduced `XCUT` folder for cross-cutting issues and TODOs, with canonical entries and topic cross-references.
- Updated all references and navigation to use new folder-based doc paths; fixed links and clarified doc structure.
- Enhanced AI agent protocol: enforce session skill preloading, `[LOADED_DOCS: ...]` short-name prefix, and mandatory `docs-check` skill for doc/code sync.
- Updated `.csproj` to include all `README.md` files for IDE visibility.
- Improved and clarified SignalR, grid, and project-level documentation.
- Minor code/test tweaks and doc content corrections for consistency.
 		2026-04-24 21:54:04 +02:00
..
AcLoggerSignalRHub.cs Implement SignalRLoggerClient 2025-09-02 11:48:05 +02:00
AcSessionService.cs Add SignalR common services and dependencies 2025-08-31 12:39:47 +02:00
AcSignalRDataSource.cs SignalR: Add raw byte[] fast-path for DataSource GetAll 2026-04-07 00:20:52 +02:00
AcSignalRSendToClientService.cs [LOADED_DOCS: .github\copilot-instructions.md] 2026-04-19 12:58:31 +02:00
AcSignalRServerProtocolExtensions.cs [LOADED_DOCS: .github\copilot-instructions.md] 2026-04-22 22:44:37 +02:00
AcWebSignalRHubBase.cs [LOADED_DOCS: .github\copilot-instructions.md] 2026-04-19 12:58:31 +02:00
ExtensionMethods.cs Refactor JSON/SignalR infra; add full test & benchmark suite 2025-12-11 21:25:50 +01:00
IAcSessionItem.cs Add SignalR common services and dependencies 2025-08-31 12:39:47 +02:00
IAcSignalRHubItemServer.cs improvements, fixes, etc 2024-05-25 22:16:22 +02:00
README.md [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
TrackingItemHelpers.cs Add SignalR common services and dependencies 2025-08-31 12:39:47 +02:00

README.md

SignalRs

Server-side SignalR hub infrastructure: hub base class, session management, data source with change tracking, and client broadcast service.

Architecture: For full dispatch flow, tag system, and tech debt documentation see AyCode.Services/docs/SIGNALR/README.md.

Key Files

Hub

  • AcWebSignalRHubBase.cs — Abstract hub extending Hub<IAcSignalRHubItemServer>. Manages connection lifecycle, message dispatch via DynamicMethodRegistry, binary/JSON parameter deserialization. Response methods: ResponseToCaller(), SendMessageToOthers(), SendMessageToUserIdInternal().
  • IAcSignalRHubItemServer.cs — Server hub interfaces: IAcSignalRHubItemServer, IAcSignalRHubServer.
  • AcLoggerSignalRHub.cs — Specialized hub for receiving log items via SignalR (AddLogItem()).

Session & Broadcast

  • AcSessionService.cs — Generic session manager with ConcurrentDictionary<TSessionItemId, TSessionItem>.
  • IAcSessionItem.cs — Session item interface with SessionId property.
  • AcSignalRSendToClientService.cs — Abstract broadcast service: SendMessageToClient(), SendMessageToAllClients(), SendMessageToConnection(), SendMessageToUser().

Data Source

Full specification: AyCode.Services.Server/docs/SIGNALR/SIGNALR_DATASOURCE.md

  • AcSignalRDataSource.cs — Generic real-time collection (AcSignalRDataSource<TDataItem, TId, TIList>) implementing IList<T> with full CRUD and change tracking.
    • Change tracking: TrackingItem<T, TId> wraps each modified item with TrackingState + OriginalValue for rollback. ChangeTracking<T, TId> manages the tracking list.
    • Loading: LoadDataSource() (sync), LoadDataSourceAsync() (async callback), LoadItem(id) (single). Binary path uses BinaryToMerge() for AcObservableCollection (batch UI update via BeginUpdate/EndUpdate).
    • Saving: SaveChanges() iterates tracked items, posts each via CRUD tag, rollbacks on failure. SaveItem() for individual saves.
    • Sync state: IsSyncing (Interlocked counter) + OnSyncingStateChanged event for UI loading indicators.
    • Locking: object _syncRoot (sync ops) + SemaphoreSlim _asyncLock (async ops). GetEnumerator() returns safe copy.
    • Working reference list: SetWorkingReferenceList() allows external list to become inner storage (zero-copy).
    • Context: ContextIds (object[]) + FilterText (string) sent with GetAll requests for server-side filtering.

Utilities

  • ExtensionMethods.cs — InvokeMethod() — invokes methods and unwraps Task/Task<T>/ValueTask results.
  • TrackingItemHelpers.cs — Deep clone helpers: JsonClone<T>(), ReflectionClone<T>().