46 lines
2.5 KiB
Markdown
46 lines
2.5 KiB
Markdown
# AyCode.Core
|
|
|
|
@project {
|
|
type = "framework"
|
|
}
|
|
|
|
Core library for the AyCode platform. Targets .NET 9 (set in `AyCode.Core.targets`). Provides serialization (Binary, JSON, Toon), compression, logging, validation, and shared utilities.
|
|
|
|
## Documentation
|
|
|
|
| Document | Topic |
|
|
|---|---|
|
|
| `BINARY_FORMAT.md` | Binary wire format spec (stream layout, type markers) |
|
|
| `BINARY_FEATURES.md` | Binary features (interning, ref tracking, property ordering) |
|
|
| `BINARY_OPTIONS.md` | Binary configuration options & presets |
|
|
| `LOGGING.md` | Logging framework (hierarchy, config, ILogger bridge) |
|
|
|
|
## Folder Structure
|
|
|
|
| Folder | Purpose | README |
|
|
|---|---|---|
|
|
| [`Compression/`](Compression/README.md) | Brotli, GZip, LZ4 compression (pure managed, WASM-compatible) | [README](Compression/README.md) |
|
|
| [`Consts/`](Consts/README.md) | Project-wide constants, error codes, regex validation, environment config | [README](Consts/README.md) |
|
|
| [`Enums/`](Enums/README.md) | Shared enums: AppType, MessageContextType, TrackingState | [README](Enums/README.md) |
|
|
| [`Extensions/`](Extensions/README.md) | Collection merge/sync, serialization extensions, utility extensions | [README](Extensions/README.md) |
|
|
| [`Helpers/`](Helpers/README.md) | Token generation, observable collections, JSON utilities, password hashing, task helpers | [README](Helpers/README.md) |
|
|
| [`Interfaces/`](Interfaces/README.md) | Core interfaces: IId<T>, IForeignKey, IAcSerializableToJson | [README](Interfaces/README.md) |
|
|
| [`Loggers/`](Loggers/README.md) | Custom logging framework with MS.Extensions.Logging integration | [README](Loggers/README.md) |
|
|
| [`Serializers/`](Serializers/README.md) | Serialization framework: Binary, JSON, Toon formats on shared infrastructure | [README](Serializers/README.md) |
|
|
|
|
## 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 |
|