버그의 상당수는 허용되지 않은 상태 변경이 어딘가에서 일어나는 데서 온다. 도메인 모델링은 상태를 바꾸는 길을 몇 개로 좁히고, 그 길에서만 규칙을 지키게 하는 일이다. 객체 캡슐화, 타입으로 표현한 상태 기계, 덮어쓰지 않는 버전 저장은 같은 목표를 서로 다른 층에서 이룬다.
핵심
- 상태 변경 규칙은 데이터 옆에 둔다. 필드를 직접 열지 않고 메서드가 불변 조건을 지키게 하며, 객체는 만들어질 때부터 유효해야 한다. getter와 setter만 있는 빈약한 모델이나 여러 서비스가 상태를 마음대로 바꾸는 구조는 규칙을 흩어 놓는다. OOP의 네 축은 추상화, 캡슐화, 상속, 다형성이지만 실무에서는 상태 일관성이 더 중요하다. 은행 계좌라면 잔액을 바깥에서 고치게 열지 않고, 입금은 양수만, 출금은 잔액 안에서만 허락하는 메서드가 규칙을 지킨다. 책임이 큰 객체는 애그리거트로 나누고, 상속 계층을 깊게 쌓지 않는다.
- 금지된 연산은 검사기로 막기보다 API에서 없앤다. 상태는 enum, 전이는 좁은 메서드로 표현하고 외부 입력은 경계에서 한 번만 도메인 타입으로 파싱한다. 검사기는 우회할 수 있지만 존재하지 않는 메서드는 호출할 수 없다. 잔고 같은 동적 조건은 여전히 런타임 검증이 필요하다. 주문, 승인처럼 허용 전이가 분명한 상태 기계나 화폐처럼 단위와 스케일이 중요한 값에 특히 맞다.
- 상태를 단순화해 보여 줄 때는 권한까지 단순화하지 않는다. 여러 변수를 단계 하나로 투영하면 수치 가드가 사라지므로, 진단용 투영과 실제 실행을 통제하는 전체 상태를 구분한다. 투영된 전이는 어딘가에서 허용된다는 뜻일 뿐이므로, 실행을 통제하려면 전체 구체 상태를 유지하고 그 상태에서의 전이만 허락한다.
- 이력이 중요한 도메인은 덮어쓰지 않고 쌓는다. 새 버전을 추가하고 최신 스냅샷은 따로 캐시하며, 둘을 같은 트랜잭션에서 갱신한다. 삭제도 새 버전으로 표현하고, 버전을 만드는 쓰기 경로는 하나로 모은다. 저장은 모든 버전을 담는
documents와 최신만 담는current_documents로 나눈다. 쓰기는 최신 버전 조회,version + 1로 새 버전 생성,documentsinsert,current_documentsupsert, audit log 기록을 한 트랜잭션에서 한다.(uri, version)유니크 인덱스와 최신 조회용(uri, updated_at)인덱스를 두고, 히스토리 압축과 아카이빙 정책은 미리 정한다. - 동작을 바깥에서 덧붙이는 장치는 보이지 않는 규칙을 만든다. 디자인 패턴의 데코레이터와 TypeScript 데코레이터는 이름만 같고 목적이 다르며, 어느 쪽이든 숨은 동작이 늘면 테스트와 문서화 규칙이 따라와야 한다. 디자인 패턴 데코레이터는 객체를 감싸 로깅, 캐시, 인증을 원본 수정 없이 붙인다. TypeScript 데코레이터는 클래스와 메서드에 메타데이터나 동작을 주입하며, 여러 개를 달면 표현식은 위에서 아래로 평가되고 적용은 아래에서 위로 된다. 공통 관심사는 미들웨어나 인터셉터로 대신할 수 있는지 먼저 보고, 데코레이터 기반 DI나 validation은 팀 숙련도가 없으면 유지보수 비용이 크다.