Add structured metadata blocks to all project/repo docs
Added standardized metadata blocks to the top of each project and repo documentation file. These blocks define project type, and for repos, include layer and dependencies, improving clarity and enabling better tooling support.
This commit is contained in:
parent
541cebbed8
commit
fdff39c44b
|
|
@ -1,5 +1,11 @@
|
||||||
# AyCode.Core — Domain Rules
|
# AyCode.Core — Domain Rules
|
||||||
|
|
||||||
|
@repo {
|
||||||
|
type = "framework"
|
||||||
|
layer = 0
|
||||||
|
own-dep-repos = []
|
||||||
|
}
|
||||||
|
|
||||||
> This is the **single source of truth** for domain rules. Do not duplicate these elsewhere.
|
> This is the **single source of truth** for domain rules. Do not duplicate these elsewhere.
|
||||||
> For detailed docs see: `README.md` → `docs/`
|
> For detailed docs see: `README.md` → `docs/`
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Core.Server
|
# AyCode.Core.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side extension of AyCode.Core. Provides server-specific implementations that build on the shared core library.
|
Server-side extension of AyCode.Core. Provides server-specific implementations that build on the shared core library.
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Core
|
# 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.
|
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
|
## Documentation
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Entities.Server
|
# AyCode.Entities.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side entity implementations extending `AyCode.Entities`. Currently contains the database-persistable log item entity.
|
Server-side entity implementations extending `AyCode.Entities`. Currently contains the database-persistable log item entity.
|
||||||
|
|
||||||
## Key Files
|
## Key Files
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Entities
|
# AyCode.Entities
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Abstract base entity implementations for the AyCode domain model. All entities are abstract and generic — concrete implementations live in application-specific projects. Implements the interfaces defined in `AyCode.Interfaces`.
|
Abstract base entity implementations for the AyCode domain model. All entities are abstract and generic — concrete implementations live in application-specific projects. Implements the interfaces defined in `AyCode.Interfaces`.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Interfaces.Server
|
# AyCode.Interfaces.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side interface contracts extending `AyCode.Interfaces`. Defines authentication and login service contracts that are only relevant on the server.
|
Server-side interface contracts extending `AyCode.Interfaces`. Defines authentication and login service contracts that are only relevant on the server.
|
||||||
|
|
||||||
## Key Files
|
## Key Files
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Interfaces
|
# AyCode.Interfaces
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Domain interface contracts for the AyCode platform. Defines the shape of entities, DTOs, relationships, and service contracts. All interfaces are composable — small, single-responsibility interfaces are combined via inheritance to build up complex types.
|
Domain interface contracts for the AyCode platform. Defines the shape of entities, DTOs, relationships, and service contracts. All interfaces are composable — small, single-responsibility interfaces are combined via inheritance to build up complex types.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Models.Server
|
# AyCode.Models.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side models: authentication state and dynamic method dispatch for SignalR message routing.
|
Server-side models: authentication state and dynamic method dispatch for SignalR message routing.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Models
|
# AyCode.Models
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Shared DTOs (Data Transfer Objects) and view models for the AyCode platform. Bridges entities and interfaces into client/server-transferable models.
|
Shared DTOs (Data Transfer Objects) and view models for the AyCode platform. Bridges entities and interfaces into client/server-transferable models.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Services.Server.Tests
|
# AyCode.Services.Server.Tests
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "test"
|
||||||
|
}
|
||||||
|
|
||||||
Comprehensive server-side tests for SignalR communication, DataSource operations, login services, and reflection-based method invocation.
|
Comprehensive server-side tests for SignalR communication, DataSource operations, login services, and reflection-based method invocation.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Services.Server
|
# AyCode.Services.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side service implementations: JWT authentication, SendGrid email delivery, SignalR hub infrastructure with binary protocol, session management, and change-tracked data sources.
|
Server-side service implementations: JWT authentication, SendGrid email delivery, SignalR hub infrastructure with binary protocol, session management, and change-tracked data sources.
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Services.Tests
|
# AyCode.Services.Tests
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "test"
|
||||||
|
}
|
||||||
|
|
||||||
MSTest project for service layer testing. Focuses on SignalR message serialization round-trips.
|
MSTest project for service layer testing. Focuses on SignalR message serialization round-trips.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Services
|
# AyCode.Services
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Shared service implementations: SignalR communication (custom binary protocol), login services, and remote log writers.
|
Shared service implementations: SignalR communication (custom binary protocol), login services, and remote log writers.
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Utils.Server
|
# AyCode.Utils.Server
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Server-side utility library placeholder. Currently empty — reserved for future server-specific utilities.
|
Server-side utility library placeholder. Currently empty — reserved for future server-specific utilities.
|
||||||
|
|
||||||
## Dependencies
|
## Dependencies
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,9 @@
|
||||||
# AyCode.Utils
|
# AyCode.Utils
|
||||||
|
|
||||||
|
@project {
|
||||||
|
type = "framework"
|
||||||
|
}
|
||||||
|
|
||||||
Low-level utility library with zero project dependencies. Provides string/datetime extensions, and disposable lock wrappers for `using` pattern with `Mutex`/`SemaphoreSlim`.
|
Low-level utility library with zero project dependencies. Provides string/datetime extensions, and disposable lock wrappers for `using` pattern with `Mutex`/`SemaphoreSlim`.
|
||||||
|
|
||||||
## Folder Structure
|
## Folder Structure
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue