Core aycode behaviour, business logic or general models
Go to file
Loretta 17daf0fef2 Document AcBinary wire format, sync docs, update conventions
- Add BINARY_FORMAT.md: full AcBinary wire format spec (markers, encoding, options, protocol, interactions)
- Reference BINARY_FORMAT.md from GLOSSARY.md, Binaries/README.md, and Serializers/Binaries/README.md; add new glossary terms
- Clarify and expand config options tables to match new doc
- Add/clarify LLM maintenance rules: always sync .md files with code, auto-fix discrepancies
- Update root README.md: AyCode.Core targets .NET 9, not 10; stress doc/code sync
- Add code reuse and doc sync conventions to copilot-instructions.md and CONVENTIONS.md
- Add docs/ folder and BINARY_FORMAT.md to solution as Solution Items
- Minor clarifications and cross-links in ARCHITECTURE.md and other docs
2026-03-29 09:11:57 +02:00
.claude Polymorphic serialization: slot-based prefix system overhaul 2026-03-09 15:04:46 +01:00
.github Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Benchmark Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.Serializers.Console Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.Serializers.SourceGenerator Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.Tests Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.Tests.Internal Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Database Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +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 Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Entities.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Interfaces Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Interfaces.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Models Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Models.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Services Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Services.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Services.Server.Tests Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Services.Tests Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Utils Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Utils.Server Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
docs Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +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 Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +02:00
AyCode.Core.targets CollectionExtensions UpdateCollectionById<TId> 2025-11-07 14:10:30 +01:00
CLAUDE.md Add LLM onboarding docs and standardize project READMEs 2026-03-28 22:38:23 +01: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 Document AcBinary wire format, sync docs, update conventions 2026-03-29 09:11:57 +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
ToonExtendedInfo.txt Add Toon serializer: LLM-optimized format & rich metadata 2026-01-10 20:13:54 +01: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

Detailed docs: docs/ — GLOSSARY.md, ARCHITECTURE.md, CONVENTIONS.md

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