Core aycode behaviour, business logic or general models
Go to file
Loretta 3671c70aa1 Fix SGen ref-handling asymmetry; add regression tests
Refactored AcBinarySourceGenerator to use RefAwareEmitPredicate for all ref-handling switch decisions, ensuring child property ref-marker logic is based solely on child compile-time flags. Fixed deserialization drift when parent disables ref-handling but child enables it. Added regression tests and new test models to verify correct round-trip behavior for duplicate child references in collections and dictionaries. Improved XML docs and updated conventions for summary tags. Added SGen string round-trip tests for medium UTF-8/ASCII cases.
2026-05-19 08:32:39 +02:00
.claude Fix SGen ref-handling asymmetry; add regression tests 2026-05-19 08:32:39 +02:00
.github [LOADED_DOCS: 3 files, no new loads] 2026-05-06 13:52:35 +02:00
.refactor-snapshot Refactor AcBinarySourceGenerator into partial classes 2026-05-15 18:54:22 +02:00
AyCode.Benchmark Stabilize BDN runs; improve benchmark output ordering 2026-05-15 23:05:06 +02:00
AyCode.Core Fix SGen ref-handling asymmetry; add regression tests 2026-05-19 08:32:39 +02:00
AyCode.Core.Serializers.Console Refactor: BDN runner, unified reporting, doc overhaul 2026-05-15 20:54:42 +02:00
AyCode.Core.Serializers.SourceGenerator Fix SGen ref-handling asymmetry; add regression tests 2026-05-19 08:32:39 +02:00
AyCode.Core.Server AcBinary: Hot/cold marker split for string deserialization 2026-05-18 15:20:56 +02:00
AyCode.Core.Tests Fix SGen ref-handling asymmetry; add regression tests 2026-05-19 08:32:39 +02:00
AyCode.Core.Tests.Internal Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Database [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
AyCode.Database.Tests Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Database.Tests.Internal Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Entities [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
AyCode.Entities.Server [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
AyCode.Interfaces Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00
AyCode.Interfaces.Server Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00
AyCode.Models Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00
AyCode.Models.Server [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
AyCode.Services [LOADED_DOCS: 3 files, no new loads] 2026-05-05 15:06:11 +02:00
AyCode.Services.Server [LOADED_DOCS: 3 files, no new loads] 2026-05-03 15:21:15 +02:00
AyCode.Services.Server.Tests Refactor MaxDepth handling: explicit Throw/Truncate/Disable 2026-05-14 14:13:48 +02:00
AyCode.Services.Tests Zero-copy SignalR: direct object response, no SignalData 2026-04-06 22:45:00 +02:00
AyCode.Utils Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00
AyCode.Utils.Server Add structured metadata blocks to all project/repo docs 2026-03-30 08:53:56 +02:00
docs Fix SGen ref-handling asymmetry; add regression tests 2026-05-19 08:32:39 +02:00
.gitattributes first commit 2023-11-08 09:35:34 +01:00
.gitignore Add /reports to .gitignore 2026-01-06 08:58:03 +01:00
.plan Refactor: move buffer/position to context for zero dispatch 2026-02-11 13:02:24 +01:00
AllBenchmarksDropdown.html Refactor serializer tests, fix deserializer bugs, add Gzip 2025-12-19 19:29:12 +01:00
AyCode.Core.sln Refactor: move benchmark engines to shared scenarios 2026-05-15 19:55:52 +02:00
AyCode.Core.targets CollectionExtensions UpdateCollectionById<TId> 2025-11-07 14:10:30 +01:00
CLAUDE.md SignalR: Add streaming & zero-copy binary protocol 2026-04-04 00:47:48 +02:00
CONSUMERS.md [LOADED_DOCS: 3 files, no new loads] 2026-04-26 19:29:21 +02:00
Directory.Build.props Centralize test/benchmark results; optimize deserializer 2025-12-13 09:59:18 +01:00
MergeBenchmarksHtmlDropdown.bat Refactor serializer tests, fix deserializer bugs, add Gzip 2025-12-19 19:29:12 +01:00
MergeBenchmarksHtmlDropdown.ps1 Refactor serializer tests, fix deserializer bugs, add Gzip 2025-12-19 19:29:12 +01:00
README.md [LOADED_DOCS: 3 files, no new loads] 2026-04-28 06:36:39 +02:00
RunFullBenchmark.bat Refactor serializer tests, fix deserializer bugs, add Gzip 2025-12-19 19:29:12 +01:00
RunQuickBenchmark.bat Expand QuickBenchmark suite & add CLI scripts 2025-12-15 12:00:03 +01:00
RunQuickBenchmark.ps1 Expand QuickBenchmark suite & add CLI scripts 2025-12-15 12:00:03 +01:00
TestChainApi.cs Add expression serialization & chain API for JSON deserialization 2025-12-29 15:28:46 +01:00
nuget.config AcBinary: Hot/cold marker split for string deserialization 2026-05-18 15:20:56 +02:00
test.runsettings Centralize test/benchmark results; optimize deserializer 2025-12-13 09:59:18 +01:00

README.md

AyCode.Core Solution

.NET 9 core framework providing serialization (Binary, JSON, Toon), entity abstractions, database access, services, and shared utilities. Used as the foundation layer for AyCode applications.

LLM Context

Domain rules and key pitfalls live in a single file: .github/copilot-instructions.md

Tool Auto-loaded Action needed
GitHub Copilot copilot-instructions.md None
Claude Code CLAUDE.md → references above None
Cursor / Windsurf README.md Read copilot-instructions.md via @file

Solution-level docs in docs/:

Document Topic
GLOSSARY.md Core terminology reference
ARCHITECTURE.md Solution layers, dependency rules
CONVENTIONS.md Coding conventions

Project-level docs — each project's docs/ folder documents the code it defines:

Project Documents
AyCode.Core/docs/ BINARY/ (README, FORMAT, FEATURES, OPTIONS, …), LOGGING/ (README, ISSUES, TODO)
AyCode.Core.Server/docs/ LOGGING/README.md (server-side variant)
AyCode.Services/docs/ SIGNALR/, SIGNALR_BINARY_PROTOCOL/, LOGGING/README.md (remote variant)
AyCode.Services.Server/docs/ SIGNALR/ (README), SIGNALR_DATASOURCE/ (README + ISSUES + TODO)

Solution Structure

Project Purpose README
AyCode.Core Core library: serializers, compression, logging, validation README
AyCode.Core.Server Server-side core extensions (GlobalLogger) README
AyCode.Core.Serializers.SourceGenerator Roslyn source generator for binary serializers README
AyCode.Core.Serializers.Console Serializer benchmark console app README
AyCode.Interfaces Entity interfaces: IId, IForeignKey, profiles, addresses README
AyCode.Interfaces.Server Server-side interfaces (login services) README
AyCode.Entities Abstract entity base classes (User, Profile, Address, Company) README
AyCode.Entities.Server Server-side entities (LogItem) README
AyCode.Models DTOs and view models README
AyCode.Models.Server Server-side models (Login, DynamicMethods) README
AyCode.Services Client-side services (SignalR, logging, login) README
AyCode.Services.Server Server-side services (SignalR hub, email, login) README
AyCode.Database EF Core data access layer with DAL pattern README
AyCode.Utils Zero-dependency utilities (string, datetime, lock wrappers) README
AyCode.Utils.Server Server-side utilities (placeholder) README

Test & Benchmark Projects

Project Purpose README
AyCode.Benchmark BenchmarkDotNet performance suite README
AyCode.Core.Tests Serialization, compression, and utility tests README
AyCode.Core.Tests.Internal Internal entity implementations for DB tests README
AyCode.Database.Tests Database layer test base classes README
AyCode.Database.Tests.Internal Concrete database integration tests README
AyCode.Services.Tests Service layer tests README
AyCode.Services.Server.Tests Server-side SignalR and service tests README