FruitBankHybridApp/FruitBank.Common
Loretta 2fb1151e5d Add FruitBank EKÁER mapping layer and validation docs
- Introduced IFruitBankEkaerService and implementation for mapping and submitting Shipping as EKÁER tradeCards
- Added IShippingToEkaerMapper and ShippingToEkaerMapper for domain-to-NAV mapping with normalization logic
- Created EkaerMappingOptions for config-driven mapping inputs
- Added unit tests for mapping logic (ShippingToEkaerMapperTests)
- Expanded EKAER_VALIDATION.md with C# validation implementation details
- Updated README.md to clarify mapping/submission flow and project boundaries
- Improved OrderClientTests assertions for nullability and clarity
- Updated settings.local.json with new dev workflow commands
2026-06-02 15:45:46 +02:00
..
Databases Update docs: enforce .md sync, clarify structure & TFMs 2026-03-29 09:26:16 +02:00
Dtos ProductDto: add Gtin column as the EKÁER VTSZ source 2026-06-01 15:40:47 +02:00
Entities Deduplicate property overrides; Shipping carrier nullable 2026-05-31 14:52:40 +02:00
Enums Refactor PreOrder and CargoTruck models, add ICargoTruck 2026-05-30 16:26:59 +02:00
Helpers Update docs: enforce .md sync, clarify structure & TFMs 2026-03-29 09:26:16 +02:00
Interfaces Deduplicate property overrides; Shipping carrier nullable 2026-05-31 14:52:40 +02:00
Loggers Update docs: enforce .md sync, clarify structure & TFMs 2026-03-29 09:26:16 +02:00
Models Update docs: enforce .md sync, clarify structure & TFMs 2026-03-29 09:26:16 +02:00
Services Add FruitBank EKÁER mapping layer and validation docs 2026-06-02 15:45:46 +02:00
SignalRs Refactor PreOrder and CargoTruck models, add ICargoTruck 2026-05-30 16:26:59 +02:00
docs [LOADED_DOCS: 4 files, no new loads] 2026-04-24 21:54:04 +02:00
DocumentType.cs ShippingDocumentToFiles fix; 2025-10-19 15:08:02 +02:00
FruitBank.Common.csproj Add XML doc standards; enable compiler-generated files 2026-05-23 09:27:29 +02:00
FruitBankConstClient.cs Refactor PreOrder and CargoTruck models, add ICargoTruck 2026-05-30 16:26:59 +02:00
README.md Add structured metadata and update doc references 2026-03-30 08:54:33 +02:00

README.md

FruitBank.Common

@project { type = "product" own-dep-projects = [ "AyCode.Core, AyCode.Entities, AyCode.Interfaces, AyCode.Models, AyCode.Services, AyCode.Utils (in AyCode.Core repo)", "Mango.Nop.Core (in Mango.Nop Libraries repo)" ] }

Shared domain library for the FruitBank nopCommerce plugin. Contains entities, DTOs, interfaces, measurement helpers, SignalR tags, and constants for fruit & vegetable wholesale operations.

Folder Structure

Folder Purpose
Databases/ Local in-memory database abstraction for offline/cached data
Dtos/ Binary-serializable DTOs for Order, OrderItem, Product, StockQuantityHistory
Entities/ Domain entities: Shipping, Partner, measurement pallets, inventory
Enums/ MeasuringStatus and DocumentType enums
Helpers/ Measurement aggregation utilities
Interfaces/ SignalR endpoint contracts, measurement traits, entity interfaces
Loggers/ SignalR client log writer
Models/ Authentication state, measurement view models
Services/ Measurement service base, credential persistence
SignalRs/ SignalR method tags (numeric constants)

Key Files (Root)

  • FruitBankConstClient.cs — Global constants: BaseUrl, SignalR hubs, database table names, email templates, system settings.
  • DocumentType.cs — Enum: ShippingDocument, OrderConfirmation, Invoice.

Key Domain Concepts

  • Shipping = INBOUND (supplier → warehouse), Order = OUTBOUND (warehouse → customer)
  • "Pallet" = measurement record, always created even for non-measurable products
  • NetWeight = GrossWeight PalletWeight (TrayQuantity × TareWeight)
  • See docs/GLOSSARY.md for full terminology