Expanded and clarified solution/project documentation: - Added all top-level docs and docs/ folder as solution items in .sln files - Inserted maintenance notices in all project and subfolder READMEs: require .md sync with code - Main READMEs now include project tables with TFM, purpose, and README links - ARCHITECTURE.md now details dependency graph and TFM rationale - CONVENTIONS.md and copilot-instructions.md require code reuse, no redundancy - Glossary and conventions updated to require terminology/rule updates with code changes - Emphasized DLL-only AyCode.Core refs and nopCommerce .NET 9.0 requirement - Clarified domain terms and intentional typos - No code logic changes; documentation and guidance only |
||
|---|---|---|
| .. | ||
| GenericAttributeDto.cs | ||
| MeasuringProductDto.cs | ||
| OrderDto.cs | ||
| OrderItemDto.cs | ||
| ProductDto.cs | ||
| README.md | ||
| StockQuantityHistoryDto.cs | ||
README.md
Dtos
Binary-serializable DTOs for efficient SignalR communication. All marked with [AcBinarySerializable].
Key Files
OrderDto.cs— Order with items, measurement status, auditing, receipt date, GenericAttributes. Computed: IsMeasured, IsComplete, MeasuringStatus, RevisorId.OrderItemDto.cs— Order line item with OrderItemPallet collection. Computed: NetWeight, GrossWeight, AverageWeight, AverageWeightIsValid, IsMeasured, IsAudited.ProductDto.cs— Product with GenericAttribute-backed properties: IsMeasurable, Tare, AverageWeight, AverageWeightTreshold, IncomingQuantity, NetWeight.StockQuantityHistoryDto.cs— Stock history with net weight adjustments and inconsistency detection.GenericAttributeDto.cs— Key-value attribute wrapper. Polymorphic: KeyGroup = owner type, EntityId = owner ID.
Why DTOs Exist
nopCommerce entities (Order, OrderItem, Product) are extended with measurement logic via these DTOs. The DTOs add computed properties and GenericAttribute access that the raw nopCommerce entities don't have.