Giter VIP home page Giter VIP logo

ddd-tactical-design's Introduction

키친포스

요구 사항

상품

  • 상품을 등록할 수 있다.
  • 상품의 가격이 올바르지 않으면 등록할 수 없다.
    • 상품의 가격은 0원 이상이어야 한다.
  • 상품의 이름이 올바르지 않으면 등록할 수 없다.
    • 상품의 이름에는 비속어가 포함될 수 없다.
  • 상품의 가격을 변경할 수 있다.
  • 상품의 가격이 올바르지 않으면 변경할 수 없다.
    • 상품의 가격은 0원 이상이어야 한다.
  • 상품의 가격이 변경될 때 메뉴의 가격이 메뉴에 속한 상품 금액의 합보다 크면 메뉴가 숨겨진다.
  • 상품의 목록을 조회할 수 있다.

메뉴 그룹

  • 메뉴 그룹을 등록할 수 있다.
  • 메뉴 그룹의 이름이 올바르지 않으면 등록할 수 없다.
    • 메뉴 그룹의 이름은 비워 둘 수 없다.
  • 메뉴 그룹의 목록을 조회할 수 있다.

메뉴

  • 1 개 이상의 등록된 상품으로 메뉴를 등록할 수 있다.
  • 상품이 없으면 등록할 수 없다.
  • 메뉴에 속한 상품의 수량은 0 이상이어야 한다.
  • 메뉴의 가격이 올바르지 않으면 등록할 수 없다.
    • 메뉴의 가격은 0원 이상이어야 한다.
  • 메뉴에 속한 상품 금액의 합은 메뉴의 가격보다 크거나 같아야 한다.
  • 메뉴는 특정 메뉴 그룹에 속해야 한다.
  • 메뉴의 이름이 올바르지 않으면 등록할 수 없다.
    • 메뉴의 이름에는 비속어가 포함될 수 없다.
  • 메뉴의 가격을 변경할 수 있다.
  • 메뉴의 가격이 올바르지 않으면 변경할 수 없다.
    • 메뉴의 가격은 0원 이상이어야 한다.
  • 메뉴에 속한 상품 금액의 합은 메뉴의 가격보다 크거나 같아야 한다.
  • 메뉴를 노출할 수 있다.
  • 메뉴의 가격이 메뉴에 속한 상품 금액의 합보다 높을 경우 메뉴를 노출할 수 없다.
  • 메뉴를 숨길 수 있다.
  • 메뉴의 목록을 조회할 수 있다.

주문 테이블

  • 주문 테이블을 등록할 수 있다.
  • 주문 테이블의 이름이 올바르지 않으면 등록할 수 없다.
    • 주문 테이블의 이름은 비워 둘 수 없다.
  • 빈 테이블을 해지할 수 있다.
  • 빈 테이블로 설정할 수 있다.
  • 완료되지 않은 주문이 있는 주문 테이블은 빈 테이블로 설정할 수 없다.
  • 방문한 손님 수를 변경할 수 있다.
  • 방문한 손님 수가 올바르지 않으면 변경할 수 없다.
    • 방문한 손님 수는 0 이상이어야 한다.
  • 빈 테이블은 방문한 손님 수를 변경할 수 없다.
  • 주문 테이블의 목록을 조회할 수 있다.

주문

  • 1개 이상의 등록된 메뉴로 배달 주문을 등록할 수 있다.
  • 1개 이상의 등록된 메뉴로 포장 주문을 등록할 수 있다.
  • 1개 이상의 등록된 메뉴로 매장 주문을 등록할 수 있다.
  • 주문 유형이 올바르지 않으면 등록할 수 없다.
  • 메뉴가 없으면 등록할 수 없다.
  • 매장 주문은 주문 항목의 수량이 0 미만일 수 있다.
  • 매장 주문을 제외한 주문의 경우 주문 항목의 수량은 0 이상이어야 한다.
  • 배달 주소가 올바르지 않으면 배달 주문을 등록할 수 없다.
    • 배달 주소는 비워 둘 수 없다.
  • 빈 테이블에는 매장 주문을 등록할 수 없다.
  • 숨겨진 메뉴는 주문할 수 없다.
  • 주문한 메뉴의 가격은 실제 메뉴 가격과 일치해야 한다.
  • 주문을 접수한다.
  • 접수 대기 중인 주문만 접수할 수 있다.
  • 배달 주문을 접수되면 배달 대행사를 호출한다.
  • 주문을 서빙한다.
  • 접수된 주문만 서빙할 수 있다.
  • 주문을 배달한다.
  • 배달 주문만 배달할 수 있다.
  • 서빙된 주문만 배달할 수 있다.
  • 주문을 배달 완료한다.
  • 배달 중인 주문만 배달 완료할 수 있다.
  • 주문을 완료한다.
  • 배달 주문의 경우 배달 완료된 주문만 완료할 수 있다.
  • 포장 및 매장 주문의 경우 서빙된 주문만 완료할 수 있다.
  • 주문 테이블의 모든 매장 주문이 완료되면 빈 테이블로 설정한다.
  • 완료되지 않은 매장 주문이 있는 주문 테이블은 빈 테이블로 설정하지 않는다.
  • 주문 목록을 조회할 수 있다.

용어 사전

상품

한글명 영문명 설명
상품 product 메뉴를 관리하는 기준이 되는 데이터
이름 product name 음식을 상상하게 만드는 중요한 요소
가격 product price 음식을 상상하게 만드는 중요한 요소

메뉴

한글명 영문명 설명
금액 amount 가격 * 수량
메뉴 menu 메뉴 그룹에 속하는 실제 주문 가능 단위
메뉴 그룹 menu group 각각의 메뉴를 성격에 따라 분류하여 묶어둔 그룹
메뉴 상품 menu product 메뉴에 속하는 수량이 있는 상품
숨겨진 메뉴 not displayed menu 주문할 수 없는 숨겨진 메뉴
이름 displayed name 음식을 상상하게 만드는 중요한 요소

매장 주문

한글명 영문명 설명
방문한 손님 수 number of guests 식기가 필요한 사람 수. 필수 사항은 아니며 주문은 0명으로 등록할 수 있다.
빈 테이블 empty table 주문을 등록할 수 없는 주문 테이블
서빙 served 조리가 완료되어 음식이 나갈 수 있는 단계
완료 completed 고객이 모든 식사를 마치고 결제를 완료한 단계
접수 accepted 주문을 받고 음식을 조리하는 단계
접수 대기 waiting 주문이 생성되어 매장으로 전달된 단계
주문 order 매장에서 식사하는 고객 대상. 손님들이 매장에서 먹을 수 있도록 조리된 음식을 가져다준다.
주문 상태 order status 주문이 생성되면 매장에서 주문을 접수하고 고객이 음식을 받기까지의 단계를 표시한다.
주문 테이블 order table 매장에서 주문이 발생하는 영역
주문 항목 order line item 주문에 속하는 수량이 있는 메뉴

배달 주문

한글명 영문명 설명
배달 delivering 배달원이 매장을 방문하여 배달 음식의 픽업을 완료하고 배달을 시작하는 단계
배달 대행사 delivery agency 준비한 음식을 고객에게 직접 배달하는 서비스
배달 완료 delivered 배달원이 주문한 음식을 고객에게 배달 완료한 단계
서빙 served 조리가 완료되어 음식이 나갈 수 있는 단계
완료 completed 배달 및 결제 완료 단계
접수 accepted 주문을 받고 음식을 조리하는 단계
접수 대기 waiting 주문이 생성되어 매장으로 전달된 단계
주문 order 집이나 직장 등 고객이 선택한 주소로 음식을 배달한다.
주문 상태 order status 주문이 생성되면 매장에서 주문을 접수하고 고객이 음식을 받기까지의 단계를 표시한다.
주문 항목 order line item 주문에 속하는 수량이 있는 메뉴

포장 주문

한글명 영문명 설명
서빙 served 조리가 완료되어 음식이 나갈 수 있는 단계
완료 completed 고객이 음식을 수령하고 결제를 완료한 단계
접수 accepted 주문을 받고 음식을 조리하는 단계
접수 대기 waiting 주문이 생성되어 매장으로 전달된 단계
주문 order 포장하는 고객 대상. 고객이 매장에서 직접 음식을 수령한다.
주문 상태 order status 주문이 생성되면 매장에서 주문을 접수하고 고객이 음식을 받기까지의 단계를 표시한다.
주문 항목 order line item 주문에 속하는 수량이 있는 메뉴

모델링

상품

  • Product는 식별자와 ProductNameProductPrice 가진다.
  • ProductName은 필수값이다.
  • ProductNameProfanity가 포함될 수 없다.
  • ProductPrice는 필수값이다.
  • ProductPrice는 음수가 될 수 없다.

메뉴

  • MenuGroup은 식별자와 이름을 가진다.
  • Menu는 식별자와 Displayed Name, 가격, MenuProducts를 가진다.
  • Menu는 특정 MenuGroup에 속한다.
  • Menu의 가격은 MenuProducts의 금액의 합보다 적거나 같아야 한다.
  • Menu의 가격이 MenuProducts의 금액의 합보다 크면 NotDisplayedMenu가 된다.
  • MenuProduct는 가격과 수량을 가진다.

매장 주문

  • OrderTable은 식별자와 이름, NumberOfGuests를 가진다.
  • OrderTable의 추가 OrderOrderTable에 계속 쌓이며 모든 Order가 완료되면 EmptyTable이 된다.
  • EmptyTable인 경우 NumberOfGuests는 0이며 변경할 수 없다.
  • Order는 식별자와 OrderStatus, 주문 시간, OrderLineItems를 가진다.
  • 메뉴가 노출되고 있으며 판매되는 메뉴 가격과 일치하면 Order가 생성된다.
  • Order는 접수 대기 ➜ 접수 ➜ 서빙 ➜ 계산 완료 순서로 진행된다.
  • OrderLineItem는 가격과 수량을 가진다.
  • OrderLineItem의 수량은 기존 Order를 취소하거나 변경해도 수정되지 않기 때문에 0보다 적을 수 있다.

배달 주문

  • Order는 식별자와 OrderStatus, 주문 시간, 배달 주소, OrderLineItems를 가진다.
  • 메뉴가 노출되고 있으며 판매되는 메뉴 가격과 일치하면 Order가 생성된다.
  • Order는 접수 대기 ➜ 접수 ➜ 서빙 ➜ 배달 ➜ 배달 완료 ➜ 계산 완료 순서로 진행된다.
  • Order가 접수되면 DeliveryAgency가 호출된다.
  • OrderLineItem는 가격과 수량을 가진다.
  • OrderLineItem의 수량은 1보다 커야 한다.

포장 주문

  • Order는 식별자와 OrderStatus, 주문 시간, OrderLineItems를 가진다.
  • 메뉴가 노출되고 있으며 판매되는 메뉴 가격과 일치하면 Order가 생성된다.
  • Order는 접수 대기 ➜ 접수 ➜ 서빙 ➜ 계산 완료 순서로 진행된다.
  • OrderLineItem는 가격과 수량을 가진다.
  • OrderLineItem의 수량은 1보다 커야 한다.

ddd-tactical-design's People

Contributors

ghojeong avatar wotjd243 avatar

ddd-tactical-design's Issues

2단계 - 리팩터링(메뉴)

키친포스의 요구 사항과 용어 사전, 모델링을 기반으로 메뉴 CONTEXT를 리팩터링한다.
메뉴 CONTEXT의 도메인 계층만 먼저 구현한다.
menus 패키지 밑에 tobe.domain 패키지를 만들고 거기서부터 구현을 시작한다.
용어 사전과 모델링이 부자연스럽거나 불완전하거나 잘못된 경우 지속적으로 수정한다.
새로운 모델에 맞게끔 클래스, 메서드, 모듈의 이름을 다시 지으면서 코드를 리팩터링한다.
REPOSITORY 구현 시 자신에게 익숙하고 편한 것을 선택하여 진행한다.

3단계 - 리팩터링(매장 식사 주문)

매장 식사 주문 CONTEXT의 도메인 계층만 먼저 구현한다.
eatinorders 패키지 밑에 tobe.domain 패키지를 만들고 거기서부터 구현을 시작한다.

Translator vs Manager

CONTEXT 간의 연동을 구현한 다른 프로젝트 참고

  • domain 패키지의 OrderProduct
  • domain 패키지의 OrderProductMapper 인터페이스
package orders.domain

import commons.model.OrderSheet;

import java.util.List;

public interface OrderProductMapper {
    List<OrderProduct> mapFrom(List<OrderSheet.OrderSheetItem> orderSheetItems);
}
  • 이것을 구현하는 integrate(= infra) 패키지의 RemoteOrderCatalogsService
package orders.integrate;

import java.util.List;
import java.util.stream.Collectors;

import lombok.AllArgsConstructor;
import commons.model.OrderSheet;
import orders.domain.entity.OrderProduct;
import orders.domain.entity.OrderProductItem;
import orders.domain.entity.OrderProductMapper;
import orders.integrate.catalogs.Product;
import orders.integrate.catalogs.ProductRepository;

@AllArgsConstructor
public class RemoteOrderCatalogsService implements OrderProductMapper {
    private ProductRepository productRepository;

    @Override
    public List<OrderProduct> mapFrom(List<OrderSheet.OrderSheetItem> orderSheetItems) {
        return orderSheetItems.stream().map(orderSheetItem -> {
            // 생략
        }).collect(Collectors.toList());
    }

    private Product getProductFor(OrderSheet.OrderSheetItem item) {
        return productRepository.getProduct(item.getProductId());
    }
}

JPA Entity vs Domain Entity

Object vs Datastructure

DDD 철학으로 개발된 프레임워크는 Spring Data JDBC 입니다. JPA와 같은 ORM 프레임워크가 DDD 철학으로부터 비롯된 것인지는 다시 살펴 봐야 될 것 같아요! 준석님이 말씀하셨던 것처럼 JPA의 엔티티는 기술의 구현체로 봐야 하고, DDD의 엔티티는 기술적 관심사와 분리하여 봐주시면 좋을 듯 합니다. 그렇기 때문에 원론적으로 구현하시는 분은 도메인 모델에 JPA 애너테이션 사용도 기술의 침범이라고 봅니다. 저는 이 부분에 대해 트레이드오프라고 생각하고 분리하는 것보다 함께 사용할 때 편리한 점이 더 많았다고 설명하였습니다. 결과적으로 DDD의 엔티티에 해당하지만 기술적으로 값 객체처럼 구현할 수도 있고, 값 객체지만 JPA의 엔티티로도 구현할 수 있습니다. 아래의 글도 참고하세요!

https://stackoverflow.com/questions/57148900/jpa-entity-responsibility-in-domain-driven-design

1단계 - 리팩터링(상품)

키친포스의 요구 사항과 용어 사전, 모델링을 기반으로 상품 CONTEXT를 리팩터링한다.
상품 CONTEXT의 도메인 계층만 먼저 구현한다.
products 패키지 밑에 tobe.domain 패키지를 만들고 거기서부터 구현을 시작한다.
용어 사전과 모델링이 부자연스럽거나 불완전하거나 잘못된 경우 지속적으로 수정한다.
새로운 모델에 맞게끔 클래스, 메서드, 모듈의 이름을 다시 지으면서 코드를 리팩터링한다.

리팩토링 시 클래스명 중복으로 인한 의존성 주입 문제

domain 을 리팩토링할 때, 클래스명이 같아서 객체 생성이 제대로 되지 않는 문제 어떻게 해결해야하는지 조언 부탁드립니다!
가령 domain.Product 와 tobe.domain.Product 의 클래스명이 같다고,
JPA 가 엔티티 객체를 생성하지 못하고 서버가 터져서요.

마찬가지로 리팩토링된 domain 에 맞추어,
tobe.domain.ProductService 를 새로 만들었을 때,
기존의 domain.ProductService 와 클래스명이 같아서,
빈 팩토리가 의존성 주입을 제대로 하지 않는 문제는 어떻게 해결해야하는지 질문드립니다.

지금은 무식하게 클래스명 앞에 Tobe 라고 접두어를 붙였습니다.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.