docs(tutorial): part2/4/5 튜토리얼 본문을 framework helper 패턴으로 통일 (영/한)

직전 sed 부작용 정정. 옛 사용자 정의 static class 호출(Domain.X(args) 또는
DomainErrors.X(args))을 모두 framework helper 패턴(DomainError.For<T>(new
XKind(), value, msg))으로 본문 재작성.

대상:
- part2-validation-patterns/01..05 (영/한)
- part4-practical-guide/03-cqrs-integration, 04-testing-strategies (영/한)
- part5-domain-examples/03-user-management-domain/UserManagementDomain (영/한)
- part5-domain-examples/04-scheduling-domain/{root,SchedulingDomain} (영/한)
- part1-valueobject-concepts/12-type-safe-enums (영/한)

각 라인의 짝이 되는 .cs 파일에서 실제 사용 패턴(TypeName, ErrorKind, 메시지)
을 확인 후 1:1 매핑. 컴파일 가능한 코드로 통일.

검증: \bDomain\.[A-Z]+\( 같은 컴파일 불가 패턴 0건.

후속(별도 커밋): 13/14 학습 흐름 자체가 옛 사용자 정의 패턴 도입·진화이므로
본문 재구성 필요. 30+ 라인 영향, 큰 작업.

Author: hhko

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part1-valueobject-concepts/12-type-safe-enums/index.md

@@ -266,17 +266,17 @@ public sealed class Currency : SmartEnum<Currency, string>
     public static Validation<Error, string> Validate(string currencyCode) =>
         !string.IsNullOrWhiteSpace(currencyCode)
             ? ValidateThreeLetters(currencyCode)
-            : DomainErrors.Empty(currencyCode);
+            : DomainError.For<Currency>(new DomainErrorKind.Empty(), currencyCode, "Currency code is empty");
 
     private static Validation<Error, string> ValidateThreeLetters(string currencyCode) =>
         currencyCode.Length == 3 && currencyCode.All(char.IsLetter)
             ? ValidateSupported(currencyCode)
-            : DomainErrors.NotThreeLetters(currencyCode);
+            : DomainError.For<Currency>(new DomainErrorKind.WrongLength(), currencyCode, "Currency code must be exactly 3 letters");
 
     private static Validation<Error, string> ValidateSupported(string currencyCode) =>
         GetAllSupportedCurrencies().Any(c => c.GetCode() == currencyCode)
             ? currencyCode
-            : DomainErrors.Unsupported(currencyCode);
+            : DomainError.For<Currency>(new Unsupported(), currencyCode, "Currency is not supported");
 }
 ```
 
@@ -349,7 +349,7 @@ public sealed class PriceRange : ComparableValueObject
         Price minPrice, Price maxPrice) =>
         (decimal)minPrice.Amount <= (decimal)maxPrice.Amount
             ? (minPrice, maxPrice)
-            : DomainErrors.MinExceedsMax(minPrice, maxPrice);
+            : DomainError.For<PriceRange>(new MinExceedsMax(), $"{minPrice}/{maxPrice}", "Minimum price exceeds maximum");
 
     protected override IEnumerable<IComparable> GetComparableEqualityComponents()
     {

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part2-validation-patterns/01-bind-sequential-validation/index.md

@@ -66,7 +66,7 @@ private static Validation<Error, string> ValidateCountryAndPostalCodeMatch(strin
         ("KR", var code) when code.Length == 5 && code.All(char.IsDigit) => country,
         ("US", var code) when code.Length == 5 && code.All(char.IsDigit) => country,
         ("JP", var code) when code.Length == 7 && code.All(char.IsDigit) => country,
-        _ => Domain.CountryPostalCodeMismatch(country, postalCode)
+        _ => DomainError.For<Address>(new CountryPostalCodeMismatch(), $"{country}/{postalCode}", "Country and postal code mismatch")
     };
 ```
 
@@ -142,7 +142,7 @@ public sealed class Address : ValueObject
             ("KR", var code) when code.Length == 5 && code.All(char.IsDigit) => country,
             ("US", var code) when code.Length == 5 && code.All(char.IsDigit) => country,
             ("JP", var code) when code.Length == 7 && code.All(char.IsDigit) => country,
-            _ => Domain.CountryPostalCodeMismatch(country, postalCode)
+            _ => DomainError.For<Address>(new CountryPostalCodeMismatch(), $"{country}/{postalCode}", "Country and postal code mismatch")
         };
 }
 ```

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part2-validation-patterns/02-apply-parallel-validation/index.md

@@ -201,12 +201,12 @@ public sealed class UserRegistration : ValueObject
     private static Validation<Error, string> ValidateEmailFormat(string email) =>
         !string.IsNullOrWhiteSpace(email) && email.Contains("@") && email.Contains(".")
             ? email
-            : Domain.EmailMissingAt(email);
+            : DomainError.For<UserRegistration>(new EmailMissingAt(), email, "Email is missing @ sign");
 
     private static Validation<Error, string> ValidatePasswordStrength(string password) =>
         password.Length >= 8
             ? password
-            : Domain.PasswordTooShort(password);
+            : DomainError.For<UserRegistration>(new PasswordTooShort(), password, "Password is too short");
 }
 ```
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part2-validation-patterns/03-apply-bind-combined-validation/index.md

@@ -69,7 +69,7 @@ private static Validation<Error, decimal> ValidateFinalAmount(string orderAmount
     decimal.TryParse(discountInput, out var discount) &&
     discount >= 0 && discount <= orderAmount
         ? orderAmount - discount
-        : Domain.DiscountAmountExceedsOrder(orderAmountInput, discountInput);
+        : DomainError.For<OrderInfo>(new DiscountAmountExceedsOrder(), $"{orderAmountInput}:{discountInput}", "Discount amount exceeds order amount");
 ```
 
 ## 실전 지침
@@ -145,7 +145,7 @@ public sealed class OrderInfo : ValueObject
         decimal.TryParse(discountInput, out var discount) &&
         discount >= 0 && discount <= orderAmount
             ? orderAmount - discount
-            : Domain.DiscountAmountExceedsOrder(orderAmountInput, discountInput);
+            : DomainError.For<OrderInfo>(new DiscountAmountExceedsOrder(), $"{orderAmountInput}:{discountInput}", "Discount amount exceeds order amount");
 }
 ```
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part2-validation-patterns/04-apply-internal-bind-validation/index.md

@@ -156,12 +156,12 @@ public sealed class MemberRegistration : ValueObject
     private static Validation<Error, string> ValidateUsernameFormat(string username) =>
         !string.IsNullOrWhiteSpace(username) && username.Length >= 3
             ? username
-            : Domain.UsernameTooShort(username);
+            : DomainError.For<MemberRegistration>(new UsernameTooShort(), username, "Username is too short");
 
     private static Validation<Error, string> ValidateUsernameAvailability(string username) =>
         !username.StartsWith("admin")
             ? username
-            : Domain.UsernameNotAvailable(username);
+            : DomainError.For<MemberRegistration>(new UsernameNotAvailable(), username, "Username is not available");
 }
 ```
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part2-validation-patterns/05-bind-internal-apply-validation/index.md

@@ -61,23 +61,23 @@ public static Validation<Error, (string CountryCode, string AreaCode, string Loc
 private static Validation<Error, string> ValidatePhoneNumberFormat(string phoneNumber) =>
     !string.IsNullOrWhiteSpace(phoneNumber) && phoneNumber.Length >= 10
         ? phoneNumber
-        : Domain.PhoneNumberTooShort(phoneNumber);
+        : DomainError.For<PhoneNumber>(new DomainErrorKind.TooShort(), phoneNumber, "Phone number is too short");
 
 // 구성 요소 병렬 검증 - Apply 내부에서 병렬 실행
 private static Validation<Error, string> ValidateCountryCode(string phoneNumber) =>
     phoneNumber.StartsWith("+82") || phoneNumber.StartsWith("+1")
         ? phoneNumber.Substring(0, 3)
-        : Domain.CountryCodeUnsupported(phoneNumber);
+        : DomainError.For<PhoneNumber>(new CountryCodeUnsupported(), phoneNumber, "Country code is not supported");
 
 private static Validation<Error, string> ValidateAreaCode(string phoneNumber) =>
     phoneNumber.Length >= 6 && phoneNumber.Substring(3, 3).All(char.IsDigit)
         ? phoneNumber.Substring(3, 3)
-        : Domain.AreaCodeInvalid(phoneNumber);
+        : DomainError.For<PhoneNumber>(new DomainErrorKind.InvalidFormat(), phoneNumber, "Area code is invalid");
 
 private static Validation<Error, string> ValidateLocalNumber(string phoneNumber) =>
     phoneNumber.Length >= 10 && phoneNumber.Substring(6).All(char.IsDigit)
         ? phoneNumber.Substring(6)
-        : Domain.LocalNumberInvalid(phoneNumber);
+        : DomainError.For<PhoneNumber>(new DomainErrorKind.InvalidFormat(), phoneNumber, "Local number is invalid");
 ```
 
 ## 실전 지침
@@ -154,23 +154,23 @@ public sealed class PhoneNumber : ValueObject
     private static Validation<Error, string> ValidatePhoneNumberFormat(string phoneNumber) =>
         !string.IsNullOrWhiteSpace(phoneNumber) && phoneNumber.Length >= 10
             ? phoneNumber
-            : Domain.PhoneNumberTooShort(phoneNumber);
+            : DomainError.For<PhoneNumber>(new DomainErrorKind.TooShort(), phoneNumber, "Phone number is too short");
 
     // 구성 요소 병렬 검증 - Apply 내부에서 병렬 실행
     private static Validation<Error, string> ValidateCountryCode(string phoneNumber) =>
         phoneNumber.StartsWith("+82") || phoneNumber.StartsWith("+1")
             ? phoneNumber.Substring(0, 3)
-            : Domain.CountryCodeUnsupported(phoneNumber);
+            : DomainError.For<PhoneNumber>(new CountryCodeUnsupported(), phoneNumber, "Country code is not supported");
 
     private static Validation<Error, string> ValidateAreaCode(string phoneNumber) =>
         phoneNumber.Length >= 6 && phoneNumber.Substring(3, 3).All(char.IsDigit)
             ? phoneNumber.Substring(3, 3)
-            : Domain.AreaCodeInvalid(phoneNumber);
+            : DomainError.For<PhoneNumber>(new DomainErrorKind.InvalidFormat(), phoneNumber, "Area code is invalid");
 
     private static Validation<Error, string> ValidateLocalNumber(string phoneNumber) =>
         phoneNumber.Length >= 10 && phoneNumber.Substring(6).All(char.IsDigit)
             ? phoneNumber.Substring(6)
-            : Domain.LocalNumberInvalid(phoneNumber);
+            : DomainError.For<PhoneNumber>(new DomainErrorKind.InvalidFormat(), phoneNumber, "Local number is invalid");
 }
 ```
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part4-practical-guide/03-cqrs-integration/index.md

@@ -245,9 +245,9 @@ public sealed class Email : IEquatable<Email>
     public static Fin<Email> Create(string? value)
     {
         if (string.IsNullOrWhiteSpace(value))
-            return Domain.Empty(value ?? "null");
+            return DomainError.For<Email>(new DomainErrorKind.Empty(), value ?? "null", "Email is empty");
         if (!value.Contains('@'))
-            return Domain.InvalidFormat(value);
+            return DomainError.For<Email>(new DomainErrorKind.InvalidFormat(), value, "Email format is invalid");
         return new Email(value.ToLowerInvariant());
     }
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part4-practical-guide/04-testing-strategies/index.md

@@ -293,9 +293,9 @@ public sealed class Email : IEquatable<Email>
     public static Fin<Email> Create(string? value)
     {
         if (string.IsNullOrWhiteSpace(value))
-            return Domain.Empty(value ?? "null");
+            return DomainError.For<Email>(new DomainErrorKind.Empty(), value ?? "null", "Email is empty");
         if (!value.Contains('@'))
-            return Domain.InvalidFormat(value);
+            return DomainError.For<Email>(new DomainErrorKind.InvalidFormat(), value, "Email format is invalid");
         return new Email(value.ToLowerInvariant());
     }
 

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part5-domain-examples/03-user-management-domain/UserManagementDomain/index.md

@@ -68,15 +68,15 @@ dotnet run
 public static Fin<Email> Create(string? value)
 {
     if (string.IsNullOrWhiteSpace(value))
-        return Domain.Empty;
+        return DomainError.For<Email>(new DomainErrorKind.Empty(), value ?? "", "Email is empty");
 
     var normalized = value.Trim().ToLowerInvariant();
 
     if (normalized.Length > 254)
-        return Domain.TooLong;
+        return DomainError.For<Email, int>(new DomainErrorKind.TooLong(), normalized.Length, "Email exceeds maximum length");
 
     if (!Pattern.IsMatch(normalized))
-        return Domain.InvalidFormat;
+        return DomainError.For<Email>(new DomainErrorKind.InvalidFormat(), value, "Email format is invalid");
 
     return new Email(normalized);
 }
@@ -105,7 +105,7 @@ public static Fin<Password> Create(string? plainText)
         .Count(x => x);
 
     if (score < 3)
-        return Domain.WeakPassword;
+        return DomainError.For<Password, int>(new InsufficientComplexity(), score, "Password is too weak");
 
     return new Password(HashPassword(plainText));
 }
@@ -125,7 +125,7 @@ public static Fin<Password> Create(string? plainText)
 public static Fin<PhoneNumber> Create(string? value, string defaultCountryCode = "82")
 {
     if (string.IsNullOrWhiteSpace(value))
-        return Domain.Empty;
+        return DomainError.For<PhoneNumber>(new DomainErrorKind.Empty(), value ?? "", "Phone number is empty");
 
     var digits = new string(value.Where(char.IsDigit).ToArray());
 
@@ -134,7 +134,7 @@ public static Fin<PhoneNumber> Create(string? value, string defaultCountryCode =
         digits = digits[1..];
 
     if (digits.Length < 9 || digits.Length > 11)
-        return Domain.InvalidFormat;
+        return DomainError.For<PhoneNumber>(new DomainErrorKind.WrongLength(), value, "Phone number length is invalid");
 
     return new PhoneNumber(defaultCountryCode, digits);
 }
@@ -161,7 +161,7 @@ public static Fin<Username> Create(string? value)
 {
     // ...
     if (ReservedNames.Contains(normalized))
-        return Domain.Reserved(normalized);
+        return DomainError.For<Username>(new ReservedName(), normalized, "Username is reserved");
 
     return new Username(normalized);
 }

Docs.Site/src/content/docs/ko/tutorials/functional-valueobject/part5-domain-examples/04-scheduling-domain/SchedulingDomain/index.md

@@ -81,7 +81,7 @@ public sealed class DateRange : IEquatable<DateRange>
     public static Fin<DateRange> Create(DateOnly start, DateOnly end)
     {
         if (end < start)
-            return Domain.EndBeforeStart;
+            return DomainError.For<DateRange>(new EndBeforeStart(), $"{start}~{end}", "End is before start");
         return new DateRange(start, end);
     }
 
@@ -131,9 +131,9 @@ public sealed class Duration : IComparable<Duration>
     public static Fin<Duration> FromMinutes(int minutes)
     {
         if (minutes < 0)
-            return Domain.NegativeDuration;
+            return DomainError.For<Duration, int>(new DomainErrorKind.Negative(), minutes, "Duration is negative");
         if (minutes > 525600) // 1년
-            return Domain.ExceedsMaximum;
+            return DomainError.For<Duration, int>(new DomainErrorKind.AboveMaximum(), minutes, "Duration exceeds maximum");
         return new Duration(minutes);
     }
 
@@ -161,7 +161,7 @@ public sealed class RecurrenceRule : IEquatable<RecurrenceRule>
     public static Fin<RecurrenceRule> Weekly(params DayOfWeek[] days)
     {
         if (days.Length == 0)
-            return Domain.NoDaysSpecified;
+            return DomainError.For<RecurrenceRule, int>(new DomainErrorKind.Empty(), 0, "No days specified");
         return new RecurrenceRule(RecurrenceType.Weekly, days, null, 1);
     }
 
@@ -179,7 +179,7 @@ public sealed class RecurrenceRule : IEquatable<RecurrenceRule>
 public static Fin<DateRange> Create(DateOnly start, DateOnly end)
 {
     if (end < start)
-        return Domain.EndBeforeStart;
+        return DomainError.For<DateRange>(new EndBeforeStart(), $"{start}~{end}", "End is before start");
     return new DateRange(start, end);
 }
 ```