/layers-conceptual-model
프레임워크 컨텍스트를 위해 /layers-intro가 로드되었다고 가정합니다.
개념적 모델은 가장 소홀히 다뤄지지만 가장 중요한 부담 레이어입니다. 이 모델은 제품이 인식하는 객체, 객체 간의 관계, 객체가 가질 수 있는 상태, 그리고 모든 것에 사용되는 용어를 정의합니다. 이 모델은 솔루션 공간에 존재합니다. 사용자의 기존 정신 모델(모순적이고 혼란스러운 — 이것은 도메인 레이어의 역할)을 캡처하는 것이 아니라, 제품이 자신의 도메인을 어떻게 모델링할지에 대한 의도적인 설계 결정입니다.
무엇인지 — 그리고 무엇이 아닌지:
- 혼란스러운 도메인을 일관되고 독단적인 구조로 해결하는 설계 결정
- 데이터베이스 스키마가 아님 — 엔지니어는 자신의 데이터 결정을 내리지만, 이 모델과 엔지니어가 구축하는 것 사이의 차이가 중요합니다. 크고 검토되지 않은 차이는 UX 부채(사용자가 모델과 모순되는 제품을 경험함)이자 기술 부채(시스템을 진화시키기 어려워짐)입니다.
- 와이어프레임이나 흐름이 아님 — 화면이나 내비게이션이 없습니다. 그것들은 위 레이어에 속합니다.
- 중립적이지 않음 — 모든 명명 결정, 모든 관계 경계, 포함되거나 제외된 모든 객체는 관점을 반영합니다.
이 레이어가 내려야 할 결정:
- 이 제품이 인식할 객체는 무엇이며, 그 경계는 무엇인가?
- 그 객체들은 서로 어떻게 관련되는가?
- 사용자는 각 객체로 무엇을 할 수 있는가?
- 각 객체는 어떤 상태를 가질 수 있으며, 어떤 전환이 중요한가?
- 제품의 용어는 무엇인가 — 개념당 하나의 이름, 선택하고 약속한 것?
방법:
| 방법 | 적용 시기 |
|---|---|
| 명사 수집 + OOUX (Sophia Prater) | 연구나 도메인 노트를 마이닝할 기본 방법. 자연어에서 객체를 추출합니다. |
| 시맨틱 IxD / 행동 문법 (Daniel Rosenberg) | 많은 객체에 걸쳐 많은 행동이 있고 동사 일관성과 정밀성을 감사하려는 경우. |
| 이벤트 스토밍 — 명령/정책 단계 (Brandolini) | 도메인에 복잡한 프로세스가 있는 경우. 발생하는 일부터 시작하여 관련 객체로 거슬러 올라갑니다. |
| 카드 분류 | 용어가 사용자나 팀 간에 불명확하거나 논쟁 중인 경우. |
| DDD 바운디드 컨텍스트 매핑 | 여러 사용자 유형이 같은 단어를 다르게 사용하는 경우 — 모델이 자연스러운 경계를 가진 곳을 드러냅니다. |
| 기존 제품 살펴보기 | 리디자인 중인 경우. 현재 UI가 암시적 모델을 드러냅니다 — 사용자가 실제로 어떻게 생각하는지와 비교하세요. |
기본값: 명사 수집 및 객체 정의.
품질 신호 — 좋은 모델의 특징:
- 모든 객체는 사용자에게 독립적으로 의미가 있습니다 — UI 요소가 아니고, 모호한 추상화도 아닙니다.
- 객체가 여러 역할을 할 수 있는 경우 관계 역할이 명시적으로 명명됩니다.
- 실제로는 관계인 속성이 도전받고 변환되었습니다.
- 추측성 추가가 없습니다 — 모든 객체, 속성, 관계는 사용자 필요로 추적됩니다.
- 상태 전이는 객체의 상태가 사용자가 할 수 있는 일을 실질적으로 변경하는 객체에 대해 정의됩니다.
- 시간 관련 결정이 다루어집니다: 삭제 의미론, 관계 시간성, 히스토리.
- 보편적 언어가 확립됩니다: 개념당 하나의 이름, 이름당 하나의 개념.
가이드 세션
모델을 정의할 제품이나 기능을 알려주거나, "안내해 주세요"라고 말하면 명사 수집 및 객체 정의를 시작합니다.
질문: "이 세션의 작업을 어디에 기록해야 하나요?" (/layers-intro의 옵션 참조)
디자이너가 문제 공간에서 가진 것(도메인 노트, 연구, 사용자 필요)을 확인합니다. 아무것도 없으면: 진행하지만 도메인 지식 없이 구축된 모델은 종종 사용자의 현실보다 가정을 더 많이 반영한다는 점을 표시합니다.
리디자인 중인 경우: "현재 모델을 설명해 주세요, 비공식적으로라도 — 기존 제품은 어떤 암시적 모델을 가지고 있나요?"
1단계 — 범위 설정
- 개념적 모델을 정의할 제품이나 기능은 무엇인가요?
- 사용자가 이 기능으로 수행하려는 핵심 작업은 무엇인가요?
- 어떤 자료를 가지고 작업하고 있나요?
2단계 — 객체 발견
연구 또는 도메인 노트에서: 모든 명사(사물, 사람, 역할, 문서, 장소, 상태, 개념, 이벤트)를 추출합니다. 넓게 퍼뜨리세요; 아직 필터링하지 마세요. 원시 목록을 제시한 후 질문: 누락된 명사가 있나요? 다른 이름으로 같은 것이 있나요?
기존 제품에서: 함께 살펴봅니다. "사용자가 여기서 보고 있는 것은 무엇인가요? 이 것은 무엇이라고 불리나요?"
처음부터: "사용자가 손을 뻗어 동료에게 건넬 수 있다면 무엇을 건네겠나요?"
다음으로 분류:
- 객체 — 지속되고, 독자적인 속성을 가지며, 그 자체로 사용자에게 중요한 것
- 속성 — 객체를 설명하는 특성, 객체 자체가 아님
- 제쳐둠 — UI 요소, 모호한 추상화, 명사로 위장된 행동
진정한 객체는 사용자에게 독립적으로 의미가 있어야 하며, 다른 것의 속성일 뿐이어서는 안 됩니다.
3단계 — 각 객체 정의
각 핵심 객체를 작업합니다:
객체: [이름]
정의: [사용자 관점에서 한 문장]
속성: [사용자가 알거나 관심을 갖는 특성]
관계: [다른 객체와의 연결 — 카디널리티와 역할 이름]
행동 (CTA): [사용자가 이 객체에 대해 할 수 있는 것]
네 가지 규율 검사:
-
관계 역할: 관계가 여러 역할을 수행할 수 있는 객체(예: 추천인과 추천 대상 모두인 사용자)에 연결될 때, 역할을 명시적으로 지정하세요: "한 사용자(추천인으로서)에 속함"이 아니라 "한 사용자에 속함."
-
실제로는 관계인 속성: 속성이 단지 모델 내 다른 객체의 이름이나 ID라면, 그것은 관계입니다 — 모델링하고 속성으로 중복하지 마세요.
-
추측성 추가 금지: 명시된 사용자 필요에 근거하지 않은 속성, 관계, 행동을 추가하지 마세요. 개념적 모델 레이어의 범위 확장은 위의 모든 레이어로 전파됩니다.
-
구현 대 설계 결정: 대화가 무언가가 생성, 저장, 계산되는 방식으로 흘러갈 때 — 방향을 전환: "생성 방식은 엔지니어링 영역입니다. 여기서 중요한 것은: 사용자가 이것을 변경할 수 있나요? 이미 참조하고 있던 것에는 어떤 일이 일어나나요?"
-
동사 정밀성: 각 행동에 대해, 동사가 사용자에게 최종 결과나 수행 중인 실제 작업을 알려주는지 질문하세요. "PIN 입력"은 PIN이 이미 존재한다는 것을 암시하기 때문에 실패합니다 — "생성"이 정확합니다. 더 중요하게: 일반 동사(편집, 삭제, 업데이트)가 의미 있게 다른 실제 결과를 가진 작업을 숨기고 있는지 확인하세요. "주소 편집"은 오타 수정(덮어쓰기 가능)과 이사 기록(새 레코드를 생성하고 이전 것을 보존해야 함)이라는 두 가지 작업을 혼동합니다 — 하나는 히스토리를 보존하고 하나는 보존하지 않는 두 작업으로, 다른 시스템 동작과 다른 사용자 의도가 필요합니다. 연역적 인터페이스는 일반 동사를 사용하고 사용자가 자신의 의도를 매핑하도록 요청합니다; 귀납적 인터페이스는 실제 작업을 명명하고("주소 변경 등록") 그 의미를 보존합니다. 일반 동사가 사용자가 실제로 하려는 것에 따라 다른 것을 의미할 수 있을 때, 작업을 별도로 명명하세요.
4단계 — 객체 맵
관계형 객체 맵을 생성합니다: 엔티티는 노드로, 관계는 카디널리티 표시가 있는 레이블이 지정된 선으로 표시합니다. 고정된 방향은 없습니다 — 관계를 가장 읽기 쉽게 만드는 방식을 따르세요. Mermaid에서는 erDiagram을 사용합니다.
제시할 때 카디널리티를 설명하세요: || = 정확히 하나, o{ = 0 또는 다수, |{ = 1 또는 다수. 까마귀 발은 항상 "다수" 쪽에 있습니다. 관계 레이블은 선언된 방향으로 읽습니다(첫 번째 엔티티 → 두 번째 엔티티).
질문: "이것이 이러한 것들에 대한 당신의 생각을 반영하나요? 누락된 관계, 반대 방향, 있어서는 안 될 연결이 있나요?"
5단계 — 상태 전이 및 시간 관련 결정
생애주기나 상태가 중요한 각 객체에 대해: "[객체]는 어떤 상태를 가질 수 있나요? 무엇이 상태 사이를 이동시키나요? 각 상태에서 무엇이 불가능해지나요?"
상태 다이어그램을 생성합니다: 상태는 노드로, 전이는 레이블이 지정된 화살표로, 명확한 시작 상태로 표시합니다. 상태 수에 따라 위에서 아래로 또는 왼쪽에서 오른쪽으로 배열합니다. Mermaid에서는 stateDiagram-v2를 사용합니다.
또한 시간 관련 결정(/layers-intro에서)을 탐색합니다: 중간 작업 상태, 읽기 모델 지연, 관계 시간성, 삭제 의미론, 히스토리. 구현과 얽힌 질문에 대해 성급한 답변을 강요하지 마세요 — 사용자 경험 요구 사항을 명확히 하고 엔지니어링 대화를 위한 명명된 미해결 질문으로 플래그를 지정하세요.
6단계 — 보편적 언어
보편적 언어는 명사(객체, 속성)와 동사(행동) 모두를 다룹니다. 두 가지 모두에 동일한 원칙이 적용됩니다: 개념당 하나의 단어, 단어당 하나의 개념.
명사: 선택된 모든 객체 및 속성 이름을 나열합니다. 동의어나 명명 충돌이 있는 명사에 대해:
용어: [선택된 이름]
거부된 대안: [나타난 다른 이름들]
결정: [이 용어가 선택된 이유]
동사 — 행동 용어: 모든 객체에 걸친 모든 행동 동사를 컴파일합니다. 두 가지 테스트를 적용합니다:
동의어 검사: 여러 동사가 같은 작업에 사용되고 있나요? 같은 작업 유형에 대해 "생성"과 "추가"를 통합해야 합니다. 동사 용어를 최소화하면 사용자가 배워야 할 양이 줄어듭니다 — 같은 동사가 모든 객체에서 동일하게 작동하면(잘라내기/복사/붙여넣기처럼) 사용자는 한 번 배워서 모든 곳에 전이할 수 있습니다. 모든 동의어는 새로 기억해야 할 것입니다.
평탄화 검사: 반대 위험 — 하나의 동사가 실질적으로 다른 작업을 덮고 있는 경우입니다. "주소 편집"은 간단해 보이지만 두 가지를 혼동합니다: 오타 수정(덮어쓰기 가능)과 이사 기록(새 레코드를 생성하고 이전 것을 보존해야 함). 도메인은 이들을 다르게 취급합니다; 인터페이스는 그것을 숨겨서는 안 됩니다. 각 일반 CRUD 동사(편집, 삭제, 업데이트, 생성)에 대해 질문하세요: 이것이 다른 실제 결과(다른 히스토리 함의, 다른 하류 효과, 사용자가 실제로 달성하려는 다른 것)를 가진 작업을 덮을 수 있나요? 그렇다면 별도의 이름을 부여하세요. "주소 변경 등록"과 "주소 수정"은 장황한 것이 아니라 정확한 것입니다.
동사: [선택된 행동 이름]
적용 대상: [어떤 객체]
거부된 대안: [고려된 다른 동사]
결정: [이 동사를 선택한 이유; 명명된 실제 작업]
"이것이 당신 제품의 보편적 언어입니다. 이 용어를 일관되게 사용하세요 — UI에서, 도움말 텍스트에서, API 이름에서, 내부 대화에서. 이 모델과 표면 사이의 모든 불일치는 사용자에게 인지 부하를 만듭니다."
완료
다음을 생성합니다:
- 객체 정의 — 속성, 관계, 행동
- 객체 맵 —
erDiagram - 상태 전이 다이어그램 — 의미 있는 생애주기가 있는 객체의 경우
- 보편적 언어 — 해결된 충돌과 결정이 있는 선택된 명사 및 동사
- 미해결 질문 — 연기된 결정, 얇게 느껴진 객체, 플래그가 지정되었지만 해결되지 않은 모든 것
다음으로 마무리: "개념적 모델은 이 제품에 존재하는 것을 정의합니다. 다음: 사용자가 이러한 객체와 상호작용하는 방식을 설계합니다. /layers-interaction-flow를 실행하세요."
도메인 작업이 수행되지 않은 경우: "이 모델은 도메인 연구 없이 구축되었습니다 — 가설입니다. 증거를 확보한 후 재방문할 계획을 세우세요."