initial commit

README.md

@@ -0,0 +1,49 @@
+# DigitalData.Core Bibliothek
+
+Die `DigitalData.Core` Bibliothek bietet eine Reihe von Diensten, Repositories und Hilfsklassen zur Unterstützung der Entwicklung sauberer Architektur in .NET-Anwendungen. Diese Bibliothek umfasst Implementierungen für CRUD-Operationen, Active Directory-Dienste und Ausnahmebehandlung.
+
+## Komponenten
+
+### CRUD-Operationen
+
+- `ICRUDRepository<TEntity, TId>`: Definiert einen Vertrag für CRUD-Operationen auf einer Entität des Typs `TEntity` mit dem Identifikator des Typs `TId`.
+
+- `CRUDRepository<TEntity, TId, TDbContext>`: Bietet eine generische Implementierung für CRUD-Operationen innerhalb eines gegebenen `DbContext`.
+
+- `ICRUDService<TCRUDRepository, TCreateDto, TReadDto, TUpdateDto, TEntity, TId>`: Definiert einen Vertrag für CRUD-Operationen auf der Dienstebene unter Verwendung von Datenübertragungsobjekten (DTOs).
+
+- `CRUDService<TCRUDRepository, TCreateDto, TReadDto, TUpdateDto, TEntity, TId>`: Bietet generische CRUD-Operationen für einen bestimmten Entitätstyp.
+
+### Active Directory-Dienste
+
+- `ADService<T>`: Ermöglicht die Interaktion mit dem Active Directory, um Suchvorgänge durchzuführen und Daten in Objekte des Typs `T` zu lesen.
+
+- `ADFilterAttribute`: Spezifiziert die Filterabfrage für Active Directory (AD)-Operationen. Dieses Attribut kann auf Klassen angewendet werden, um benutzerdefinierte Filterabfragen während AD-Operationen zu definieren.
+
+### Ausnahmebehandlung
+
+- `MappingResultNullException`: Repräsentiert Fehler, die während der Zuordnung auftreten, wenn das Ergebnis unerwartet `null` ist. Diese Ausnahme wird speziell verwendet, um anzugeben, dass eine AutoMapper-Zuordnungsoperation ein `null`-Objekt ergab.
+
+### Hilfsklassen
+
+- `AttrHelper`: Bietet Hilfsmethoden zum Arbeiten mit Attributen.
+
+### API-Controller
+
+- `CRUDControllerBase`: Eine Basiskontrollerklasse, die generische CRUD-Operationen für einen bestimmten Entitätstyp bereitstellt.
+
+- `ADControllerBase`: Ein Basiskontroller für die Interaktion mit dem Active Directory-Dienst.
+
+## Anwendung
+
+Diese Bibliothek ist für Entwickler konzipiert, die saubere Architekturprinzipien in ihren .NET-Anwendungen implementieren möchten. Sie bietet eine robuste Grundlage für die Entwicklung von Repositories, Diensten und API-Controllern mit Fokus auf Wartbarkeit, Testbarkeit und Erweiterbarkeit.
+
+## Hinweise
+
+- Die Verwendung von `IMapper` und `IServiceResult` ermöglicht eine flexible Datenübertragung und Fehlerbehandlung.
+
+- Die Implementierung der Active Directory-Dienste setzt voraus, dass die Anwendung auf der Windows-Plattform ausgeführt wird, aufgrund der Verwendung von `DirectorySearcher`.
+
+- Die Ausnahmebehandlungsklassen helfen bei der Identifizierung von Konfigurations- oder Datenquelleproblemen, die während der Automapper-Zuordnung auftreten können.
+
+Für weitere Details zur Implementierung und Nutzung dieser Bibliothek, prüfen Sie die Dokumentation und Beispiele im Code.