환경 설정

필요 환경

항목	최소 버전	비고
.NET SDK	10.0	dotnet --version으로 확인
IDE	VS 2022 / Rider / VS Code	C# 지원 IDE

필요 패키지

아키텍처 테스트 프로젝트에는 다음 NuGet 패키지가 필요합니다.

테스트 프레임워크

테스트 실행과 검증의 기반이 되는 패키지들입니다.

패키지	용도
xunit.v3	테스트 프레임워크
xunit.runner.visualstudio	IDE 테스트 탐색기 지원
Microsoft.NET.Test.Sdk	.NET 테스트 SDK

아키텍처 테스트

어셈블리를 분석하고 규칙을 검증하기 위한 패키지들입니다.

패키지	용도
TngTech.ArchUnitNET.xUnitV3	ArchUnitNET xUnit 통합
Shouldly	Assertion 라이브러리

프로젝트 참조

Functorium의 Validator 패턴(ClassValidator, InterfaceValidator 등)을 사용하기 위한 참조입니다.

프로젝트	용도
Functorium.Testing	ArchitectureRules 프레임워크 (ClassValidator 등)

프로젝트 구조

각 챕터는 다음 구조를 따릅니다:

01-Chapter-Name/
├── README.md                           # 챕터 설명
├── ProjectName/                        # 검증 대상 프로젝트
│   ├── ProjectName.csproj
│   ├── Program.cs
│   └── Domains/                        # 도메인 클래스
│       └── ...
└── ProjectName.Tests.Unit/             # 아키텍처 테스트
    ├── ProjectName.Tests.Unit.csproj
    ├── xunit.runner.json
    ├── ArchitectureTestBase.cs         # 공통 설정
    └── XxxArchitectureTests.cs         # 테스트 파일

테스트 프로젝트 설정

.csproj 파일

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" />
    <PackageReference Include="Microsoft.Testing.Extensions.CodeCoverage" />
    <PackageReference Include="Microsoft.Testing.Extensions.TrxReport" />
    <PackageReference Include="Shouldly" />
    <PackageReference Include="TngTech.ArchUnitNET.xUnitV3" />
    <PackageReference Include="xunit.v3" />
    <PackageReference Include="xunit.runner.visualstudio" />
  </ItemGroup>

  <ItemGroup>
    <Content Include="xunit.runner.json" CopyToOutputDirectory="PreserveNewest" />
  </ItemGroup>

  <ItemGroup>
    <ProjectReference Include="..\ProjectName\ProjectName.csproj" />
    <ProjectReference Include="..\..\..\..\..\..\Src\Functorium.Testing\Functorium.Testing.csproj" />
  </ItemGroup>

</Project>

패키지 버전은 Directory.Packages.props에서 중앙 관리됩니다.

xunit.runner.json

{
  "$schema": "https://xunit.net/schema/current/xunit.runner.schema.json",
  "parallelizeAssembly": false,
  "parallelizeTestCollections": true,
  "methodDisplay": "method",
  "methodDisplayOptions": "replaceUnderscoreWithSpace",
  "diagnosticMessages": true
}

Architecture 로딩 패턴

모든 아키텍처 테스트는 ArchitectureTestBase 클래스를 상속합니다. 이 클래스가 어셈블리를 로딩하고 네임스페이스 문자열을 제공하므로, 개별 테스트는 규칙 정의에만 집중할 수 있습니다.

using ArchUnitNET.Loader;

public abstract class ArchitectureTestBase
{
    protected static readonly ArchUnitNET.Domain.Architecture Architecture =
        new ArchLoader()
            .LoadAssemblies(typeof(SomeClassInTargetAssembly).Assembly)
            .Build();

    protected static readonly string DomainNamespace =
        typeof(SomeClassInTargetAssembly).Namespace!;
}

“ArchitectureTestBase는 ‘무엇을 분석할지’를 한 곳에서 정의합니다. 개별 테스트는 ‘어떤 규칙을 적용할지’에만 집중하면 됩니다.”

핵심 포인트:

1. ArchLoader로 검증 대상 어셈블리를 로딩합니다
2. typeof(...).Assembly로 어셈블리를 참조합니다
3. 네임스페이스 문자열은 typeof(...).Namespace!로 안전하게 추출합니다
4. static readonly 필드로 선언하여 테스트 간 재사용합니다

테스트 실행

# 개별 프로젝트 테스트
dotnet test --project Path/To/ProjectName.Tests.Unit

# 전체 솔루션 테스트
dotnet test --solution architecture-rules.slnx

FAQ

Q1: ArchLoader로 여러 어셈블리를 동시에 로딩할 수 있나요?

A: 네, LoadAssemblies(assembly1, assembly2, ...)처럼 여러 어셈블리를 전달할 수 있습니다. 레이어 간 의존성 규칙을 검증할 때는 도메인, 애플리케이션, 인프라 어셈블리를 함께 로딩해야 합니다.

Q2: ArchitectureTestBase를 꼭 추상 클래스로 만들어야 하나요?

A: 필수는 아니지만, 추상 클래스로 만들면 테스트 프레임워크가 이 클래스 자체를 테스트로 인식하지 않습니다. 또한 각 테스트 클래스가 반드시 상속해야 한다는 의도를 명확히 전달합니다.

Q3: static readonly로 선언하는 이유는 무엇인가요?

A: 어셈블리 로딩은 비용이 높은 작업입니다. static readonly로 선언하면 테스트 클래스당 한 번만 로딩되어 전체 테스트 실행 속도가 크게 향상됩니다.

---

다음 단계

환경 설정이 완료되었으니, 첫 번째 아키텍처 테스트를 작성해봅니다.

→ Part 1: ClassValidator 기초 - 1.1 첫 번째 아키텍처 테스트