Project Init

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

colaflow-api/src/Shared/ColaFlow.Shared.Kernel/Common/AggregateRoot.cs

@@ -0,0 +1,31 @@
+using ColaFlow.Shared.Kernel.Events;
+
+namespace ColaFlow.Shared.Kernel.Common;
+
+/// <summary>
+/// Base class for all aggregate roots
+/// </summary>
+public abstract class AggregateRoot : Entity
+{
+    private readonly List<DomainEvent> _domainEvents = new();
+
+    public IReadOnlyCollection<DomainEvent> DomainEvents => _domainEvents.AsReadOnly();
+
+    protected AggregateRoot() : base()
+    {
+    }
+
+    protected AggregateRoot(Guid id) : base(id)
+    {
+    }
+
+    protected void AddDomainEvent(DomainEvent domainEvent)
+    {
+        _domainEvents.Add(domainEvent);
+    }
+
+    public void ClearDomainEvents()
+    {
+        _domainEvents.Clear();
+    }
+}

colaflow-api/src/Shared/ColaFlow.Shared.Kernel/Common/Entity.cs

@@ -0,0 +1,54 @@
+namespace ColaFlow.Shared.Kernel.Common;
+
+/// <summary>
+/// Base class for all entities
+/// </summary>
+public abstract class Entity
+{
+    public Guid Id { get; protected set; }
+
+    protected Entity()
+    {
+        Id = Guid.NewGuid();
+    }
+
+    protected Entity(Guid id)
+    {
+        Id = id;
+    }
+
+    public override bool Equals(object? obj)
+    {
+        if (obj is not Entity other)
+            return false;
+
+        if (ReferenceEquals(this, other))
+            return true;
+
+        if (GetType() != other.GetType())
+            return false;
+
+        return Id == other.Id;
+    }
+
+    public static bool operator ==(Entity? a, Entity? b)
+    {
+        if (a is null && b is null)
+            return true;
+
+        if (a is null || b is null)
+            return false;
+
+        return a.Equals(b);
+    }
+
+    public static bool operator !=(Entity? a, Entity? b)
+    {
+        return !(a == b);
+    }
+
+    public override int GetHashCode()
+    {
+        return Id.GetHashCode();
+    }
+}

colaflow-api/src/Shared/ColaFlow.Shared.Kernel/Common/Enumeration.cs

@@ -0,0 +1,78 @@
+using System.Reflection;
+
+namespace ColaFlow.Shared.Kernel.Common;
+
+/// <summary>
+/// Base class for creating type-safe enumerations
+/// </summary>
+public abstract class Enumeration : IComparable
+{
+    public int Id { get; private set; }
+    public string Name { get; private set; }
+
+    protected Enumeration(int id, string name)
+    {
+        Id = id;
+        Name = name;
+    }
+
+    public override string ToString() => Name;
+
+    public static IEnumerable<T> GetAll<T>() where T : Enumeration
+    {
+        var fields = typeof(T).GetFields(BindingFlags.Public |
+                                          BindingFlags.Static |
+                                          BindingFlags.DeclaredOnly);
+
+        return fields.Select(f => f.GetValue(null)).Cast<T>();
+    }
+
+    public override bool Equals(object? obj)
+    {
+        if (obj is not Enumeration otherValue)
+        {
+            return false;
+        }
+
+        var typeMatches = GetType().Equals(obj.GetType());
+        var valueMatches = Id.Equals(otherValue.Id);
+
+        return typeMatches && valueMatches;
+    }
+
+    public override int GetHashCode() => Id.GetHashCode();
+
+    public static int AbsoluteDifference(Enumeration firstValue, Enumeration secondValue)
+    {
+        var absoluteDifference = Math.Abs(firstValue.Id - secondValue.Id);
+        return absoluteDifference;
+    }
+
+    public static T FromValue<T>(int value) where T : Enumeration
+    {
+        var matchingItem = Parse<T, int>(value, "value", item => item.Id == value);
+        return matchingItem;
+    }
+
+    public static T FromDisplayName<T>(string displayName) where T : Enumeration
+    {
+        var matchingItem = Parse<T, string>(displayName, "display name", item => item.Name == displayName);
+        return matchingItem;
+    }
+
+    private static T Parse<T, K>(K value, string description, Func<T, bool> predicate) where T : Enumeration
+    {
+        var matchingItem = GetAll<T>().FirstOrDefault(predicate);
+
+        if (matchingItem == null)
+            throw new InvalidOperationException($"'{value}' is not a valid {description} in {typeof(T)}");
+
+        return matchingItem;
+    }
+
+    public int CompareTo(object? other)
+    {
+        if (other == null) return 1;
+        return Id.CompareTo(((Enumeration)other).Id);
+    }
+}

colaflow-api/src/Shared/ColaFlow.Shared.Kernel/Common/ValueObject.cs

@@ -0,0 +1,46 @@
+namespace ColaFlow.Shared.Kernel.Common;
+
+/// <summary>
+/// Base class for all value objects
+/// </summary>
+public abstract class ValueObject
+{
+    protected abstract IEnumerable<object> GetAtomicValues();
+
+    public override bool Equals(object? obj)
+    {
+        if (obj == null || obj.GetType() != GetType())
+            return false;
+
+        var other = (ValueObject)obj;
+        return GetAtomicValues().SequenceEqual(other.GetAtomicValues());
+    }
+
+    public override int GetHashCode()
+    {
+        return GetAtomicValues()
+            .Aggregate(1, (current, obj) =>
+            {
+                unchecked
+                {
+                    return (current * 23) + (obj?.GetHashCode() ?? 0);
+                }
+            });
+    }
+
+    public static bool operator ==(ValueObject? a, ValueObject? b)
+    {
+        if (a is null && b is null)
+            return true;
+
+        if (a is null || b is null)
+            return false;
+
+        return a.Equals(b);
+    }
+
+    public static bool operator !=(ValueObject? a, ValueObject? b)
+    {
+        return !(a == b);
+    }
+}