AndroThink.Data.Harmonizer.Core 1.1.1

AndroThink.Data.Harmonizer.Core

AndroThink.Data.Harmonizer.Core is the foundation of the Harmonizer suite.
It provides the domain models, abstractions, and migration infrastructure required to build modular synchronization and reporting systems across multiple database providers.

🚀 Features

• Provider-Agnostic Core: Contains shared entities, configurations, and migration logic without binding to a specific database provider.
• Dynamic Schema Support: Enables runtime adjustments to reporting structures via a custom IModelCacheKeyFactory.
• Clean Architecture: Designed following DDD principles, separating Core logic from provider-specific implementations.
• Migration Management: Centralized migrations that can be applied across SQLite, SQL Server, and PostgreSQL.
• Extensibility: Acts as the base package for provider-specific libraries (.SQLite, .SqlServer, .PostgreSQL).

🛠 Installation

Add the Core package to your project:

dotnet add package AndroThink.Data.Harmonizer.Core

⚙️ Usage

The Core library defines the domain entities and DbContext (HarmonizerDbContext) used by provider libraries. You typically reference Core in your application, then add a provider package to configure the actual database.

• Valid Providers
  • AndroThink.Data.Harmonizer.SQLite
  • AndroThink.Data.Harmonizer.SQLServer
  • AndroThink.Data.Harmonizer.PostgreSQL

Example:

using AndroThink.Data.Harmonizer.Core;

var builder = WebApplication.CreateBuilder(args);

// Register Core services
builder.Services.AddDataHarmonizer();

// Register specific provider 
builder.Services.AddDataHarmonizerPostgreSQL(..);

// At runtime, add a provider-specific package (e.g., AndroThink.Data.Harmonizer.SQLite, AndroThink.Data.Harmonizer.SQLServer, AndroThink.Data.Harmonizer.PostgreSQL)

🏛 Architecture

The Core library includes:

• Entities: Base domain models for synchronization systems and reports.

• DbContext: HarmonizerDbContext with provider-agnostic configuration.

• Engines: Sync engine that load data from the external apis, Report engine.

• Interfaces & Implementations: Contracts for services like ISyncSystemService and ISyncReportService.

• Utitities: General utils and helper methods.

📄 License

This project is licensed under the Apache License 2.0. You may freely use, modify, and distribute this library in both commercial and non-commercial projects, subject to the terms of the license.

🔗 Related Packages

AndroThink.Data.Harmonizer.SQLite (nuget.org)

AndroThink.Data.Harmonizer.SQLServer (nuget.org)

AndroThink.Data.Harmonizer.PostgreSQL (nuget.org)