도메인 모델링

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

엔티티

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

주요 특징:

고유한 식별성(일반적으로 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`	불변 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가 생성한 구조:

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.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 섹션에서 자세히 다룰 예정입니다.

현재 진화 워크플로

lino entity new 대화형 흐름 외에도, 서비스, 모듈, 이름을 이미 알고 있다면 CLI 명령에서 의도를 명시할 수 있습니다:

lino entity new --name <EntityName> --service <ServiceName> --module <ModuleName>
lino entity edit --service <ServiceName> --module <ModuleName> --entity <EntityName>
lino entity list --service <ServiceName> --module <ModuleName>

큰 모듈에서 새 개념을 만들기 전에 entity list를 사용하십시오. 편집 중에는 식별자, 속성, 필수 여부, 길이, 관계, 인덱스, ownership, tenant, migrations 영향도를 검토합니다.

Strongly Typed IDs, ownership, invariants

Strongly Typed IDs가 활성화되면 식별자는 ProductId와 같은 전용 타입이 되어 서로 다른 엔티티의 IDs를 실수로 바꾸는 일을 줄입니다. 관계는 실제 도메인 ownership을 반영해야 합니다. 모든 참조가 직접 탐색이 될 필요는 없으며, 많은 경우 식별자, shadow entity, integration event 또는 명시적 쿼리가 모듈 경계를 더 잘 보호합니다.

invariants는 UI, 데이터베이스 또는 validators에만 두지 말고 도메인에 두십시오. 엔티티를 변경한 후에는 build를 실행하고 diff를 검토한 다음 migrations를 생성하거나 업데이트하십시오.

Value Object

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

주요 특징:

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

Lino로 Value Object 생성하기

다음 명령을 실행하세요:

lino value-object new

CLI가 다음을 요청합니다:

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

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

사용 가능한 필드 타입

타입	설명	비고
`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 이상

예제

Value Object 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):

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.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에 의해 관리되어 데이터 모델을 동기화 상태로 유지할 수 있습니다.

현재 진화 워크플로

대화형 명령 외에도 개념을 어디에 만들어야 하는지 이미 알고 있다면 파라미터를 사용하십시오:

lino value-object new --name <ValueObjectName> --service <ServiceName> --module <ModuleName>
lino value-object edit --service <ServiceName> --module <ModuleName> --value-object <ValueObjectName>
lino value-object list --service <ServiceName> --module <ModuleName>

엔티티 속성이 ValueObject로 선언되면 Lino는 엔티티 모델링 중 기존 Value Object를 재사용하거나 새로 만들 수 있습니다. 필드 집합이 금액, 주소, 치수, 기간 또는 문서처럼 하나의 개념을 나타낼 때 이 옵션을 우선하십시오.

영속성, UI 및 현지화

Lino는 모듈의 영속성 계층을 통해 Value Objects의 속성을 매핑하고 표시 메타데이터를 resources로 전달합니다. 이를 통해 중첩된 값에 대해 현지화된 labels와 메시지를 제공할 수 있습니다. Value Object는 생성된 모듈에 속하며, 명시적인 integration 없이는 모듈 간 공유 계약이 되지 않습니다.

invariants는 타입 자체에서 보호하십시오. 음수 값, 잘못된 통화, 뒤집힌 기간 또는 잘못된 형식의 문서가 유효하게 생성되어서는 안 됩니다.

열거형

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

동기:

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

주요 특징:

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

Lino로 열거형 생성하기

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

lino enumeration new

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

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

예제

PersonStatus 열거형:

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

생성된 구조:

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.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를 생성하고 적용하여 데이터베이스가 도메인 모델을 반영하도록 하세요. 자세한 내용은 영속성 계층 섹션을 참고하십시오.

현재 진화 워크플로

대화형 명령 외에도 위치와 이름이 이미 정해져 있다면 파라미터를 사용하십시오:

lino enumeration new --name <EnumerationName> --service <ServiceName> --module <ModuleName>
lino enumeration edit --service <ServiceName> --module <ModuleName> --enumeration <EnumerationName>
lino enumeration list --service <ServiceName> --module <ModuleName>

Enumeration, 엔티티 또는 설정

Enumeration 사용	엔티티 또는 설정 사용
주문 상태, 게시 상태, 기술적 통합 유형	사용자가 관리하는 카테고리, tenant별로 설정 가능한 사유, backoffice에서 관리되는 공급자
코드와 함께 버전 관리되는 값	runtime에 변경되거나 권한으로 제어되는 값
값별 단순 규칙 또는 작은 동작	라이프사이클, 감사, 동적 번역 또는 자체 관계

Enumeration이 표시 이름을 노출하면 Lino는 현지화된 labels용 resources를 생성할 수 있습니다. 지속되거나 seed data로 사용되는 경우 값을 추가, 제거 또는 이름 변경한 뒤 migrations를 검토하십시오. 코드, 데이터베이스, UI 간 일관성도 도메인 변경의 일부입니다.