도메인 모델링

도메인 주도 설계 애플리케이션의 핵심에는 시스템의 핵심 지식과 비즈니스 규칙을 나타내는 모델이 있습니다. 도메인을 잘 모델링한다는 것은 현실 세계의 개념을 표현력 있고, 응집력 있으며, 일관성 있는 소프트웨어 구조로 변환하는 것을 의미합니다.

엔티티

엔티티는 주로 식별성으로 정의되는 객체이며 단순히 속성만으로 정의되지 않습니다. 속성이 시간이 지나면서 변경되더라도 엔티티의 식별성은 변하지 않습니다.

주요 특징:

고유한 식별성(일반적으로 Id)을 가집니다.
중요한 것은 엔티티가 무엇을 포함하는지가 아니라 누구인지입니다.
속성은 시간이 지나면서 변경될 수 있습니다.

Lino로 엔티티 생성하기

Lino를 사용하여 새 엔티티를 생성하려면 다음을 실행하세요:

lino entity new

CLI 도우미가 요청합니다:

서비스 – 엔티티가 생성될 서비스입니다.
모듈 – 엔티티가 생성될 모듈(모듈형 서비스에만 해당).
엔티티 이름 – 도메인과 데이터베이스 테이블에서 사용되는 이름입니다.

그 후, 각 필드를 설정하여 엔티티를 구성합니다.

사용 가능한 필드 타입

타입	설명	범위 / 참고 사항
`short`	16비트 정수	-32,768 → 32,767
`int`	32비트 정수	-2,147,483,648 → 2,147,483,647
`long`	64비트 정수	-9,223,372,036,854,775,808 → 9,223,372,036,854,775,807
`string`	텍스트	약 20억 문자까지
`bool`	불리언 값	`true` 또는 `false`
`Guid`	글로벌 고유 식별자	분산된 고유성
`decimal`	고정 소수점 숫자	금융 값에 적합
`float`	부동 소수점 숫자 (32비트)	약 6–9자리 정밀도
`double`	부동 소수점 숫자 (64비트)	약 15–17자리 정밀도
`DateTime`	날짜 및 시간	시간대 포함
`DateOnly`	날짜만 (C# 10+)	–
`TimeOnly`	시간만 (C# 10+)	–
`Entity`	다른 엔티티 참조	1 : 1 또는 1 : N
`Value Object`	불변 값 객체	예: 주소, CPF
`Enum`	열거형	고정된 값 집합
`List<Entity>`	엔티티 리스트	1 : N
`ManyToMany`	다대다 관계	조인 테이블 필요

예제

Person 엔티티 생성하기:

┌────┬────┬───────────────┬────────┬────────┬───────────┬────────────────┐
│ PK │ FK │ Property name │ Type   │ Length │ Required  │ Auto-increment │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│ x  │    │ Id            │ int    │        │     x     │       x        │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│    │    │ Name          │ string │  100   │     x     │                │
└────┴────┴───────────────┴────────┴────────┴───────────┴────────────────┘

Lino가 생성한 구조:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Errors/
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

엔티티를 정의한 후, Lino를 사용하여 Migrations를 관리하고 데이터베이스를 동기화하세요. 이 과정은 Persistence Layer 섹션에서 자세히 다룰 예정입니다.

값 객체

값 객체는 오직 속성들로만 정의되는 도메인 개념을 나타내며, 자체적인 식별자가 없습니다. 두 값 객체는 모든 값이 같으면 동일하다고 간주됩니다.

주요 특징:

생성 후 불변입니다.
Id가 없습니다.

Lino로 값 객체 생성하기

다음 명령을 실행하세요:

lino value-object new

CLI가 다음을 요청합니다:

서비스 – 객체가 생성될 서비스.
모듈 – 객체가 생성될 모듈(모듈형 서비스에만 해당).
위치 – 도메인 루트 또는 특정 애그리게이트.
값 객체 이름.

그런 다음 객체를 구성하는 필드를 정의하세요.

사용 가능한 필드 타입

타입	설명	비고
`short`	16비트 정수	-32,768 → 32,767
`int`	32비트 정수	-2,147,483,648 → 2,147,483,647
`long`	64비트 정수	-9,223,372,036,854,775,808 → 9,223,372,036,854,775,807
`string`	텍스트	약 20억 문자까지
`bool`	불리언	`true`/`false`
`decimal`	정확한 소수점 숫자	금액 값
`float`	부동 소수점 숫자 (32비트)	약 6~9자리
`double`	부동 소수점 숫자 (64비트)	약 15~17자리
`DateTime`	날짜/시간	타임존 포함
`DateOnly`	날짜만	C# 10 이상
`TimeOnly`	시간만	C# 10 이상

예제

값 객체 Address:

┌───────────────┬────────┬────────┬───────────┐
│ Property name │ Type   │ Length │ Required  │
├───────────────┼────────┼────────┼───────────┤
│ Street        │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Number        │ string │   10   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Neighborhood  │ string │   50   │           │
├───────────────┼────────┼────────┼───────────┤
│ City          │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ State         │ string │   2    │     x     │
├───────────────┼────────┼────────┼───────────┤
│ PostalCode    │ string │   20   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Country       │ string │  100   │     x     │
└───────────────┴────────┴────────┴───────────┘

생성된 파일 구조 (애그리게이트 Person):

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

엔티티와 마찬가지로 Migrations는 Lino에 의해 관리되어 데이터 모델을 동기화 상태로 유지할 수 있습니다.

열거형

DDD에서 열거형은 C#의 전통적인 enum을 넘어설 수 있습니다. 상태를 표현하는 풍부한 객체로서 유효성 검사, 보조 메서드, 심지어 동작까지 포함할 수 있습니다.

동기:

C#의 enum은 정수 또는 문자열 값에만 제한됩니다.
클래스로 열거형을 모델링하면 더 큰 유연성과 표현력을 제공합니다.

주요 특징:

공통 기본 클래스를 상속하며 Id와 이름을 캡슐화하는 클래스입니다.
유효성 검사, 보조 메서드 및 동작을 추가할 수 있습니다.

Lino로 열거형 생성하기

다음 명령어를 실행하세요:

lino enum new

도움말이 다음을 요청합니다:

서비스.
모듈 (적용 가능한 경우).
위치 – 도메인 루트 또는 애그리게이트.
열거형 이름.
유형 – 전통적인 enum 또는 스마트 Enum (class).
저장 방식 – 데이터베이스에서 int 또는 string.

예제

PersonStatus 열거형:

┌───────┬───────────┬──────────────┐
│ Value │ Name      │ Display Name │
├───────┼───────────┼──────────────┤
│ 1     │ Active    │ Active       │
├───────┼───────────┼──────────────┤
│ 2     │ Inactive  │ Inactive     │
├───────┼───────────┼──────────────┤
│ 3     │ Suspended │ Suspended    │
├───────┼───────────┼──────────────┤
│ 4     │ Deleted   │ Deleted      │
└───────┴───────────┴──────────────┘

생성된 구조:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Enums/
                        │   └── PersonStatus.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            ├── Person/
                            │   ├── PersonResources.resx
                            │   ├── PersonResources.en.resx
                            │   └── PersonResources.pt-BR.resx
                            └── PersonStatus/
                                ├── PersonStatusResources.resx
                                ├── PersonStatusResources.en.resx
                                └── PersonStatusResources.pt-BR.resx

열거형 값을 string으로 저장하는 것도 가능하며 가독성을 높일 수 있지만, 성능과 저장 공간 면에서는 덜 효율적일 수 있습니다. 따라서 값은 int로 저장하고, 무결성 유지와 유지보수를 쉽게 하기 위해 열거형 값과 일치하는 기본 키를 가진 보조 엔티티(테이블)를 생성하는 것을 권장합니다.

열거형을 정의한 후에는 Lino를 사용하여 Migrations를 생성하고 적용하여 데이터베이스가 도메인 모델을 반영하도록 하세요. 자세한 내용은 영속성 계층 섹션을 참고하십시오.