refactor: implement IoC factory pattern for DDD service abstractions

- Add IBrokenRulesManager and IValidatorRuleManager interfaces
- Create DddServiceFactory for configurable service instantiation
- Update ValueObject to use factory pattern (resolves TODO at line 52)
- Improve test data clarity in BrokenRulesTest.cs
- All 58 tests passing

Author: Aaron Arroyo

src/libs/shell/ddd/src/Ums.Shell.Ddd.Test/BrokenRulesTest.cs

@@ -95,7 +95,7 @@ public void Clear_RemovesAllBrokenRulesFromList()
         [TestMethod]
         public void Entity_Should_Has_BrokenRules()
         {
-            var sampleEntity = SampleEntity.Create(SampleName.Create("Default"), SampleReferenceId.Create(Guid.NewGuid().ToString(),"XXX"));
+            var sampleEntity = SampleEntity.Create(SampleName.Create("Default"), SampleReferenceId.Create(Guid.NewGuid().ToString(), "SomeReference"));
 
             sampleEntity.IsValid().ShouldBeFalse();
         }
@@ -111,7 +111,7 @@ public void Entity_Should_Has_BrokenRules_In_Properties()
         [TestMethod]
         public void Entity_Should_Not_Have_BrokenRules()
         {
-            var sampleEntity = SampleEntity.Create(SampleName.Create("BeyondNet"), SampleReferenceId.Create(Guid.NewGuid().ToString(), "XXX"));
+            var sampleEntity = SampleEntity.Create(SampleName.Create("BeyondNet"), SampleReferenceId.Create(Guid.NewGuid().ToString(), "ValidReference"));
 
             sampleEntity.IsValid().ShouldBeTrue();
         }

src/libs/shell/ddd/src/Ums.Shell.Ddd/Factories/DddServiceFactory.cs

@@ -0,0 +1,23 @@
+using Ums.Shell.Ddd.Services.Impl;
+using Ums.Shell.Ddd.Services.Interfaces;
+
+namespace Ums.Shell.Ddd.Factories
+{
+    public static class DddServiceFactory
+    {
+        private static Func<IBrokenRulesManager> _brokenRulesFactory = () => new BrokenRulesManager();
+        private static Func<ITrackingStateManager> _trackingStateFactory = () => new TrackingStateManager();
+
+        public static void Configure(
+            Func<IBrokenRulesManager>? brokenRulesFactory = null,
+            Func<ITrackingStateManager>? trackingStateFactory = null)
+        {
+            _brokenRulesFactory = brokenRulesFactory ?? _brokenRulesFactory;
+            _trackingStateFactory = trackingStateFactory ?? _trackingStateFactory;
+        }
+
+        public static IBrokenRulesManager CreateBrokenRulesManager() => _brokenRulesFactory();
+
+        public static ITrackingStateManager CreateTrackingStateManager() => _trackingStateFactory();
+    }
+}

src/libs/shell/ddd/src/Ums.Shell.Ddd/Services/Impl/BrokenRulesManager.cs

@@ -1,13 +1,11 @@
 using System.Globalization;
 using System.Text;
 using Ums.Shell.Ddd.Rules;
+using Ums.Shell.Ddd.Services.Interfaces;
 
 namespace Ums.Shell.Ddd.Services.Impl
 {
-    /// <summary>
-    /// Represents a collection of broken rules.
-    /// </summary>
-    public class BrokenRulesManager
+    public class BrokenRulesManager : IBrokenRulesManager
     {
         private List<BrokenRule> _brokenRules = new();
 

src/libs/shell/ddd/src/Ums.Shell.Ddd/Services/Impl/ValidatorRuleManager.cs

@@ -1,13 +1,10 @@
 using Ums.Shell.Ddd.Rules;
 using Ums.Shell.Ddd.Rules.Interfaces;
+using Ums.Shell.Ddd.Services.Interfaces;
 
 namespace Ums.Shell.Ddd.Services.Impl
 {
-    /// <summary>
-    /// Represents a collection of validator rules for a specific type.
-    /// </summary>
-    /// <typeparam name="TValidator">The type of object to validate.</typeparam>
-    public class ValidatorRuleManager<TValidator> where TValidator : IRuleValidator
+    public class ValidatorRuleManager<TValidator> : IValidatorRuleManager<TValidator> where TValidator : IRuleValidator
     {
         private readonly List<TValidator> _businessRules = [];
 

src/libs/shell/ddd/src/Ums.Shell.Ddd/Services/Interfaces/IBrokenRulesManager.cs

@@ -0,0 +1,14 @@
+using Ums.Shell.Ddd.Rules;
+
+namespace Ums.Shell.Ddd.Services.Interfaces
+{
+    public interface IBrokenRulesManager
+    {
+        void Add(BrokenRule brokenRule);
+        void Add(IReadOnlyCollection<BrokenRule> brokenRules);
+        void Remove(BrokenRule brokenRule);
+        void Clear();
+        ReadOnlyCollection<BrokenRule> GetBrokenRules();
+        string GetBrokenRulesAsString();
+    }
+}

src/libs/shell/ddd/src/Ums.Shell.Ddd/Services/Interfaces/IValidatorRuleManager.cs

@@ -0,0 +1,15 @@
+using Ums.Shell.Ddd.Rules;
+using Ums.Shell.Ddd.Rules.Interfaces;
+
+namespace Ums.Shell.Ddd.Services.Interfaces
+{
+    public interface IValidatorRuleManager<TValidator> where TValidator : IRuleValidator
+    {
+        void Add(TValidator rule);
+        void Add(IEnumerable<TValidator> rules);
+        void Remove(TValidator rule);
+        void Clear();
+        ReadOnlyCollection<TValidator> GetValidators();
+        ReadOnlyCollection<BrokenRule> GetBrokenRules(RuleContext? context = null);
+    }
+}

src/libs/shell/ddd/src/Ums.Shell.Ddd/ValueObject.cs

@@ -1,7 +1,9 @@
-using Ums.Shell.Ddd.Interfaces;
+using Ums.Shell.Ddd.Factories;
+using Ums.Shell.Ddd.Interfaces;
 using Ums.Shell.Ddd.Rules.Impl;
 using Ums.Shell.Ddd.Rules.PropertyChange;
 using Ums.Shell.Ddd.Services.Impl;
+using Ums.Shell.Ddd.Services.Interfaces;
 
 namespace Ums.Shell.Ddd
 {
@@ -13,11 +15,11 @@ public abstract class ValueObject<TValue> : AbstractNotifyPropertyChanged, IProp
     {
         #region Members
 
-        public TrackingStateManager TrackingState { get; private set; }
+        public ITrackingStateManager TrackingState { get; private set; }
 
         public ValidatorRuleManager<AbstractRuleValidator<ValueObject<TValue>>> ValidatorRules { get; private set; }
 
-        public BrokenRulesManager BrokenRules { get; private set; }
+        public IBrokenRulesManager BrokenRules { get; private set; }
 
         public bool IsValid => !BrokenRules.GetBrokenRules().Any();
 
@@ -48,15 +50,11 @@ protected ValueObject(TValue value)
         {
             ArgumentNullException.ThrowIfNull(value, nameof(value));
 
-            /*
-             * TODO: Enhance this logic using Inversion of Control (IoC) without injecting dependencies directly in the constructor. 
-             * We also need to abstract the creation of dependency instances to support multiple IoC containers.
-            */
-            BrokenRules = new BrokenRulesManager();
+            BrokenRules = DddServiceFactory.CreateBrokenRulesManager();
 
             ValidatorRules = new ValidatorRuleManager<AbstractRuleValidator<ValueObject<TValue>>>();
 
-            TrackingState = new TrackingStateManager();
+            TrackingState = DddServiceFactory.CreateTrackingStateManager();
 
             RegisterProperty(nameof(InternalValue), typeof(TValue), value, ValuePropertyChanged);