Sample vs main solution

[sdudnic-ingerop]

We remark differences between the main solution (Clean.Architecture) and the Sample (NimblePros.SampleToDo).

Let's take Contributor.cs: in Clean.Architecture it's older that in the Sample (where the PhoneNumber is also present as class and field), and the Name is a string, in the Sample the name is a ContributorName, and there is no PhoneNumber anymore:

namespace Clean.Architecture.Core.ContributorAggregate;

public class Contributor(string name) : EntityBase, IAggregateRoot
{
  // Example of validating primary constructor inputs
  // See: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/tutorials/primary-constructors#initialize-base-class
  public string Name { get; private set; } = Guard.Against.NullOrEmpty(name, nameof(name));
  public ContributorStatus Status { get; private set; } = ContributorStatus.NotSet;
  public PhoneNumber? PhoneNumber { get; private set; }

  public void SetPhoneNumber(string phoneNumber) => PhoneNumber = new PhoneNumber(string.Empty, phoneNumber, string.Empty);

  public void UpdateName(string newName) => Name = Guard.Against.NullOrEmpty(newName, nameof(newName));
}

public class PhoneNumber(string countryCode,
  string number,
  string? extension) : ValueObject
{
  public string CountryCode { get; private set; } = countryCode;
  public string Number { get; private set; } = number;
  public string? Extension { get; private set; } = extension;

  protected override IEnumerable<object> GetEqualityComponents()
  {
    yield return CountryCode;
    yield return Number;
    yield return Extension ?? String.Empty;
  }
}

versus SampleToDo

using NimblePros.SampleToDo.Core.ContributorAggregate.Events;

namespace NimblePros.SampleToDo.Core.ContributorAggregate;

public class Contributor : EntityBase, IAggregateRoot
{
  public ContributorName Name { get; private set; }

  public Contributor(ContributorName name)
  {
    Name = name;
  }

  public void UpdateName(ContributorName newName)
  {
    if (Name.Equals(newName)) return;
    Name = newName;
    this.RegisterDomainEvent(new ContributorNameUpdatedEvent(this));
  }
}

[ardalis]

Yes, I'm using the sample as a place to play around with some ideas, and to demonstrate how more complex models work. In the template, since you're going to need to throw away everything that isn't useful to your domain model, I'm keeping it simple(r) by design. I may move some of the things you see in the sample into the template, though, such as using Vogen for IDs and some other value object types.