History

Loretta e606cd171b Add comprehensive README docs for all core subfolders Added detailed README files for the root AyCode.Core library and each major subfolder (Compression, Consts, Enums, Extensions, Helpers, Interfaces, Loggers). Each README outlines folder purpose, key files, APIs, and critical notes, with tables and architecture diagrams where relevant. Included explicit instructions for LLM-based maintenance. This greatly improves project documentation and developer onboarding.		2026-03-28 16:24:03 +01:00
..
Compression	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Consts	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Enums	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Extensions	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Helpers	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Interfaces	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Loggers	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00
Properties	Improve property ordering, null handling, and string interning	2026-03-07 13:37:49 +01:00
Serializers	Update dependencies and expand README documentation	2026-03-20 16:42:51 +01:00
AcDomain.cs	IAcSoftRemoveEntity	2024-11-13 10:58:39 +01:00
AyCode.Core.csproj	Refactor SGen: property/object marker bridges, FixObj support	2026-03-10 17:32:00 +01:00
README.md	Add comprehensive README docs for all core subfolders	2026-03-28 16:24:03 +01:00

README.md

AyCode.Core

Core library for the AyCode platform. Targets .NET 10. Provides serialization (Binary, JSON, Toon), compression, logging, validation, and shared utilities.

Folder Structure

Folder	Purpose	README
`Compression/`	Brotli, GZip, LZ4 compression (pure managed, WASM-compatible)	README
`Consts/`	Project-wide constants, error codes, regex validation, environment config	README
`Enums/`	Shared enums: AppType, MessageContextType, TrackingState	README
`Extensions/`	Collection merge/sync, serialization extensions, utility extensions	README
`Helpers/`	Token generation, observable collections, JSON utilities, password hashing, task helpers	README
`Interfaces/`	Core interfaces: IId<T>, IForeignKey, IAcSerializableToJson	README
`Loggers/`	Custom logging framework with MS.Extensions.Logging integration	README
`Serializers/`	Serialization framework: Binary, JSON, Toon formats on shared infrastructure	README

Root Files

AcDomain.cs — Singleton for process-level state: process name, build type detection (IsDeveloperVersion/IsProductVersion), processor count, thread-safe unique ID generators (NextUniqueInt32, NextUniqueInt64).

Dependencies

Dependency	Purpose
`AyCode.Utils`	Shared utilities (project reference)
`AyCode.Core.Serializers.SourceGenerator`	Binary serializer source generation (analyzer)
`AutoMapper`	Object mapping
`MessagePack`	MessagePack serialization
`Newtonsoft.Json`	JSON serialization (legacy, alongside System.Text.Json)
`Microsoft.Extensions.Configuration.*`	appsettings.json + environment variable support
`Microsoft.Extensions.Logging.Abstractions`	Logging abstractions

LLM Maintenance: If you modify code in this folder, update this README to reflect the changes. If you notice the README content does not match the current code, automatically update the README to match the code.