Merge branch 'master' of github.com:CodeShayk/ActiveForge

Author: NinjaRocks

README.md

@@ -20,29 +20,53 @@ All connection types live in the `ActiveForge` namespace, so a single `using Act
 
 ## Features
 
+ActiveForge streamlines data-centric development with a cohesive approach to entities, queries, and data management.
+
 ### 🗂 Entities & Mapping
-- **Active Record pattern** — entities carry both data and persistence behaviour; no separate repository class required
-- **Type-safe field wrappers** — `TString`, `TInt`, `TDecimal`, `TPrimaryKey`, `TForeignKey`, and 25+ more; each tracks null/loaded state and supports implicit conversion
-- **Polymorphic mapping** — map abstract base types to concrete subtypes via `FactoryBase`
-- **Custom field mappers** — implement `IDBFieldMapper` for non-standard type conversions
-- **Field encryption** — transparent encrypt/decrypt via `[Encrypted]` attribute
+
+- **Active Record pattern**  
+  Entities contain both state and persistence logic, removing the need for external repositories.
+- **Type-safe fields**  
+  Provides wrappers for types (string, int, decimal, keys, etc.), tracking nullability and state, and handling conversion automatically.
+- **Polymorphic mapping**  
+  Maps base types to concrete subtypes at runtime.
+- **Custom field mappers**  
+  Easily support non-standard type conversions.
+- **Field encryption**  
+  Simple attribute-based encryption/decryption for sensitive data.
 
 ### 🔍 Querying
-- **Composable query predicates** — `EqualTerm`, `ContainsTerm`, `InTerm`, `GreaterThanTerm`, `LessThanTerm`, `LessOrEqualTerm`, `GreaterOrEqualTerm`, `IsNullTerm`, `LikeTerm`, composed with `&`, `|`, `!`
-- **LINQ query support** — `conn.Query<T>().Where(...).OrderBy(...).Take(...).Skip(...)` translated to native ORM predicates
-- **Pagination** — `QueryPage` with `StartRecord`, `PageSize`, `IsMoreData`, `TotalRowCount`
-- **Lazy streaming** — `LazyQueryAll<T>` streams rows without buffering the full result set
-- **Field subsets** — partial SELECTs and partial UPDATEs via `FieldSubset`
 
-### 💾 Data Management
-- **Transactions** — manual nested transactions via `BeginTransaction` / `CommitTransaction` / `RollbackTransaction`
-- **Unit of Work** — `IUnitOfWork`, `UnitOfWorkBase`, provider-specific implementations, `With.Transaction`, `[Transaction]` attribute, Castle DynamicProxy interceptor. `[Transaction]` — wraps a service method in a `IUnitOfWork` transaction via Castle DynamicProxy; combine with `[ConnectionScope]` for the full open → begin → commit → close lifecycle
-- **Connection-level lifecycle** — set `conn.UnitOfWork = uow` once; every write operation (`Insert`, `Update`, `Delete`, `ProcessActionQueue`, `ExecStoredProcedure`) automatically opens the connection, begins a transaction, commits, and closes — no proxy required; coordinates transparently with `[ConnectionScope]` via `IsOpen`. `[ConnectionScope]` — marks service methods/classes where the `DataConnection` is opened before and closed after; nested calls share one connection via `IsOpen` state.
-- **Action queue** — batch operations via `QueueForInsert` / `QueueForUpdate` / `QueueForDelete` → `ProcessActionQueue`
+- **Composable predicates**  
+  Build queries with terms for equality, containment, ranges, null checks, and pattern matching; combine them with logical operators.
+- **LINQ support**  
+  Write queries using familiar C# syntax, auto-translated to efficient ORM operations.
+- **Pagination**  
+  Built-in paging with metadata for efficient handling of large datasets.
+- **Lazy streaming**  
+  Stream results row-by-row for memory efficiency.
+- **Field subsets**  
+  Load or update only the fields you need.
 
-### 🌐 DI & Service Proxy Integration
-- **Auto-scan registration** — `AddActiveForgeSqlServer(...).AddServices(assembly)` discovers all `IService` implementations and registers them as interface-proxied scoped services in one call. `IService` marker — implement on any service class for automatic discovery and proxy registration. `IActiveForgeBuilder` — fluent builder returned by all `AddTurquoise*` methods; chain `.AddServices()`, `.AddService<I, T>()` for granular control.
+### 💾 Data Management
 
+- **Transactions**  
+  Explicit and nested transaction support; control scope via code or attributes.
+- **Unit of Work**  
+  Integrated pattern for grouping multiple changes; supports both code-based and attribute-based usage.
+- **Connection lifecycle**  
+  Connections and transactions are managed automatically on every write, ensuring reliability.
+- **Batch operations**  
+  Queue up changes and execute them in bulk to reduce database round-trips.
+
+### 🌐 Dependency Injection & Service Proxy
+
+- **Auto-discovery & registration**  
+  Services marked with a simple interface are discovered and registered automatically.
+- **Fluent builder API**  
+  Register all or selected services with fine-grained control.
+- **Seamless DI integration**  
+  Simplifies service composition, testing, and enables proxy/interceptor scenarios.
 ---
 
 ## Requirements