{"time":1755239574341,"blocks":[{"id":"Nt1SG_oNx-","type":"warning","data":{"title":"해당 글은 오직 BSS 도메인과 소프트웨어 설계 관점에서 요구사항을 효율적으로 풀어나가기 위해 고민했던 흔적으로 보안이나 문제의 소지가 될 내용은 모두 배제했습니다.","message":""}},{"id":"FbVAS2Wffu","type":"customHeader","data":{"text":"Overview "}},{"id":"v2LpI7OVAb","type":"paragraph","data":{"text":"SKT 프로젝트에서 사용자가 '기존 요금제'에서 '다른 요금제'로 전환 가능한지 판단하는 API 가 필요했습니다. 이를 판단하기 위해서는, 여러가지 조건을 판단하는 Rule 에 의해서 결정되는데요, 이 후 비즈니스 요구사항이 확장되며, 특정 혜택 가입 가능 여부 판단 기능까지 추가로 개발하게 되었습니다. "}},{"id":"ZFI6O-7lh2","type":"delimiter","data":{}},{"id":"o5rpzLk6DY","type":"header","data":{"text":"Rule 이란?","level":2}},{"id":"OoH8zbXSUD","type":"paragraph","data":{"text":"통신 분야에서 주로 사용되는 BSS(Business Support System) 에서는 특정 요금제에서 다른 요금제로 변경(가입/전환) 하기위해서 여러 Rule 로서 관리합니다."}},{"id":"puCjULV8WJ","type":"paragraph","data":{"text":"Rule 에 대한 예시는 아래로 표현할 수 있는데요"}},{"id":"aFeye8aKYs","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"5G 요금제에서 -> LTE 요금제 전환 불가 ","meta":{},"items":[]},{"content":"특정 프로모션 요금제 -> 동일 프로모션 기간 내에서만 전환 가능","meta":{},"items":[]},{"content":"만 19세 미만은 특정 데이터 무제한 요금제 전환 불가 ","meta":{},"items":[]}]}},{"id":"S7-IZTCCpg","type":"paragraph","data":{"text":"
SKT 에서 BSS 시스템을 개발하면서 기존, 요금제를 가입/변경을 위한 Rule 뼈대를 만들어 두었는데, 이번에 고객의 요구사항으로 혜택에 대해서도, 특정 혜택의 가입여부를 판단하기 위한 Rule 을 넣어달라고 요청하셨고, 해당 기능을 구현하기 위해서는 아키텍처 리팩토링을 하게 되었습니다."}},{"id":"yKc5pjij6N","type":"delimiter","data":{}},{"id":"6smTd7HwgI","type":"header","data":{"text":"요구사항","level":2}},{"id":"ONpPu2K7hw","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"특정 요금제에 여러 가지 Rule 을 할당할 수 있다 ","meta":{},"items":[]}]}},{"id":"Vfp7QI1ymT","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"A 요금제에서 B 요금제로 변경 시, B 요금제에 할당된 여러 Rule 들을 모두 판단하여 하나라도 Rule 이 실패하면, 가입가능 '불가'로 취급한다","meta":{},"items":[]},{"content":"Rule 중에, 연령룰은 '월 기준', '일 기준', '년 기준'처럼 여러 기준으로 판단할 수 있다","meta":{},"items":[]},{"content":"특정 혜택에 대해서도 여러 가지 Rule 을 할당할 수 있다 ","meta":{},"items":[]},{"content":"Rule 중 몇개는 요금제와, 혜택 모두에서 사용된다. ","meta":{},"items":[]}]}},{"id":"R4lXbPawxa","type":"delimiter","data":{}},{"id":"zFsB05_8NM","type":"header","data":{"text":"Architecturing ","level":2}},{"id":"9zmkwhYT38","type":"paragraph","data":{"text":"해당 요구사항을 만족하기 위해서 OOP 관점으로 짜려고 노력했고, 비록, 기존의 Legacy 코드가 존재해, 여러 Dependency 가 있어서, 해당 요구사항을 최적화 할 수는 없었지만, 크게 3가지의 '인터페이스'를 활용해서 책임을 나눴습니다."}},{"id":"3x5MoWaFuZ","type":"header","data":{"text":"RuleService ","level":4}},{"id":"yuXdzVQCF0","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"API 진입점을 나타내는 부분으로, '요금제 가입가능 여부' 와 '혜택 가입가능 여부' API 명세를 담은 인터페이스","meta":{},"items":[]}]}},{"id":"jDb9HXM7dZ","type":"header","data":{"text":"RuleFactory","level":4}},{"id":"9ixaLQCOxN","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"특정 요금제나, 혜택에 대해서 할당된 Rule 들을 DB 에서 가져오는 역할을 하는 인터페이스","meta":{},"items":[]}]}},{"id":"5QZ3GgWUpD","type":"header","data":{"text":"RuleType","level":4}},{"id":"s1nq-35Lu8","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"DB 에서 가져온 여러 Rule 들에 대해서 각 Rule 판단 구현을 담당하는 인터페이스 ","meta":{},"items":[]}]}},{"id":"bY-6tazbBa","type":"paragraph","data":{"text":"이렇게 각각의 역할을 담고 있는 3가지의 인터페이스를 분리함으로써, 각 인터페이스간에 결합도를 낮추고, 인터페이스를 상속하는 여러 클래스간의 응집도를 높였습니다."}},{"id":"5A-Qv1-iqZ","type":"delimiter","data":{}},{"id":"QKijtwlKiu","type":"image","data":{"caption":"","withBorder":false,"withBackground":false,"stretched":true,"file":{"url":"https://backend.owl-dev.me/images/skt_architecture.png"}}},{"id":"jmuiA-qP9I","type":"delimiter","data":{}},{"id":"z_JdSuz6Au","type":"header","data":{"text":"Architecturing Point","level":2}},{"id":"0UcOXUKqw8","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"RuleType 에 enum 타입으로 요금제(MOBILE_PLAN) / 혜택(BENEFIT) 룰을 분리하고, RuleFactory 에서 getRules 이라는 하나의 메서드로 '요금제'와 '혜택' 가입가능 여부를 모두 핸들링 가능하도록 처리합니다. ","meta":{},"items":[]},{"content":"RuleType 인터페이스를 상속하는 Abstact Class 를 만들고 또 이를 상속해 여러 Rule 들을 구현하도록 해서, 향후 추가되는 Rule 들에 대해서도 구현이 쉽고, 기존 Rule 의 변경에도 유지보수가 용이하도록 확장성 높은 구조 설계를 가져갔습니다.","meta":{},"items":[]},{"content":"RuleType 에 int getOrder() 함수를 통해, 빨리 끝나는 Rule 부터 처리하도록 순서를 지정하여, 전체 Rule 판단 성능을 개선합니다.","meta":{},"items":[]},{"content":"RuleFactory 에서 DB 를 활용하도록 하여, 다른 서비스인 GUI 화면에서도 요금제와, Rule 을 관리할수 있도록 합니다.","meta":{},"items":[]}]}},{"id":"LXjE1s8w_V","type":"header","data":{"text":"Architecturing Flow","level":2}},{"id":"ymaKLyd0LN","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"API 요청을 통해, 'serviceId', 'RuleCategory' 파라미터를 수신하도록 합니다.","meta":{},"items":[]},{"content":"' RuleFactory' 에서 해당 조건에 맞는 룰들을 동적으로 생성합니다.","meta":{},"items":[]},{"content":"각 RuleType 구현체에 대해 filterServices() 실행합니다.","meta":{},"items":[]},{"content":"실패한 룰 식별 및 응답을 구성합니다.","meta":{},"items":[]}]}},{"id":"Z1ogYMKOtz","type":"header","data":{"text":"Extension Strategy","level":2}},{"id":"sJJhzk9DjX","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"'RuleCategory' enum 도입 (MOBILE_PLAN, BENEFIT)","meta":{},"items":[]},{"content":"룰 재사용을 위해 카테고리 필터링 로직을 RuleFactory에 구현 ","meta":{},"items":[]},{"content":"DB 테이블 'rule_category' , 'rule_types' 설계로 룰을 동적으로 관리","meta":{},"items":[]}]}},{"id":"Y4yLcktZGJ","type":"delimiter","data":{}},{"id":"ntiHqC6ZtA","type":"header","data":{"text":"장점 (Strengths)","level":2}},{"id":"aug6VqFXd9","type":"header","data":{"text":"1. 높은 확장성과 재사용성","level":3}},{"id":"p3JZq0PJ43","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"동일한 룰 클래스가 요금제/혜택 모두에서 사용 가능하도록 했습니다. 이를 통해, 기존 뼈대를 최대한 활용해 전체 개발기간을 단축합니다.","meta":{},"items":[]},{"content":"새로운 룰 추가 시 인터페이스 구현만으로 간편하게 확장 가능하고 변경에도 용이하게 합니다. (OCP 충실)","meta":{},"items":[]}]}},{"id":"gsa22JZHN8","type":"header","data":{"text":"2. 유지보수 용이성 ","level":3}},{"id":"wyHPrrnwNq","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"RuleType, RuleFactory, RuleService 등 역할별 책임이 명확히 분리되어 있어 변경에 유연합니다. ","meta":{},"items":[]},{"content":"테스트 및 디버깅 용이 (우선순위 기반 실행 및 실패 룰 식별 기능 포함) 하도록 합니다.","meta":{},"items":[]}]}},{"id":"bfwEwFRtty","type":"header","data":{"text":"3. 데이터 기반 관리","level":3}},{"id":"bQ-dz0h-54","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"룰 구성을 DB 테이블로 정의하여 GUI 연동 및 룰 관리 자동화 기반 마련하도록 합니다.","meta":{},"items":[]}]}},{"id":"Rx4Hj8ZeEg","type":"delimiter","data":{}},{"id":"ppjrDgxm8I","type":"header","data":{"text":"Verification","level":2}},{"id":"NiXpr10Q7I","type":"paragraph","data":{"text":"변경 후 코드에 대해서, 기존 로직이 이상없는지 체크하기 위한 기준으로 기존에 만들어 두었던 자체 솔루션중 하나인 Test Framework 의 CheckAvailability (API 명) 부분에서, 기존에 관리되던 룰중 하나인 AgeRule, DeviceRule 체크 로직에서의 판별과, 모든 룰에서 통과하는 케이스에 통과함을 확인하면서, 검증했습니다."}},{"id":"o78wQQSPlk","type":"delimiter","data":{}},{"id":"HXa0iv1vlV","type":"header","data":{"text":"결론","level":2}},{"id":"ARvQ0Y9Xt0","type":"paragraph","data":{"text":"이번 설계를 통해서 다음과 같은 성과를 달성했습니다."}},{"id":"yL6quo7GIc","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"기존 구조를 유지하면서 신규 요구사항(BENEFIT) 혜택을 유연하게 수용","meta":{},"items":[]},{"content":"OOP 원칙에 충실하면서도 실무에 맞는 구조적 확장성 확보","meta":{},"items":[]},{"content":"데이터 기반의 룰 관리 체계를 마련함으로써 운영/관리 편의성 제고 ","meta":{},"items":[]}]}},{"id":"uuOZilpfKW","type":"paragraph","data":{"text":"이 구조는 향후 요금제 추천, 사전체크, 포로모션 적용 등 다양한 비즈니스 룰 확장에도 재사용 가능한 기반으로 작동하며, 실무에서 안정적인 Rule 기반 처리의 전형적인 사례로 활용될 수 있습니다."}},{"id":"d7RCaavOOt","type":"delimiter","data":{}},{"id":"PKhWGXtrok","type":"header","data":{"text":"Code Point","level":2}},{"id":"gKZXIscael","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"By declaring the RuleType interface, we specify which methods and domain objects each rule must implement.","meta":{},"items":[]}]}},{"id":"VOEOWWkqt8","type":"code","data":{"code":"public interface RuleType {\n enum RuleCategory { MOBILE_PLAN, BENEFIT } // RuleType 인터페이스에 카테고리 enum 선언 \n List filterServices(List services, Customer customer, RuleSharedData sharedData) throws RuleException;\n Long getId();\n int getOrder();\n}\n"}},{"id":"HhC9UDzzCx","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"In RuleServiceImpl, even if the same serviceId is provided, the system retrieves only the rules matching the specified category, ensuring that only the relevant rules are evaluated.","meta":{},"items":[]}]}},{"id":"lPjzsemvUj","type":"code","data":{"code":" Map> rules = ruleFactory.getRules(serviceIds, RuleType.RuleCategory.MOBILE_PLAN);\n Map> rules = ruleFactory.getRules(serviceIds, RuleType.RuleCategory.BENEFIT);\n"}},{"id":"R1xy9HC1GF","type":"list","data":{"style":"unordered","meta":{},"items":[{"content":"By this getRules methods, can get ruleCategory rules even use same serviceIds,","meta":{},"items":[]}]}},{"id":"oofgLUiZn0","type":"code","data":{"code":"public Map> getRules(List serviceIds, RuleType.RuleCategory ruleCategory){\n List rel = getRuleToServiceRel(serviceIds);\n Map sServiceRuleMap = transformServiceRuleMap(rel);\n sServiceRuleMap = ruleCategoryFiltering(ruleCategory, sServiceRuleMap); // 여기서 룰 카테고리 필터링\n\n Map>> service2type2params = fetchServiceToRuleParam(rel);\n Map> ruleType2ServiceIds = getRuleTypeToServiceId(rel, sServiceRuleMap);\n Comparator comparator = Comparator.comparingInt(RuleType::getOrder);\n\n Map> ruleType2Services = new TreeMap<>(comparator);\n for (var entry: ruleType2ServiceIds.entrySet()) {\n RuleType ruleType = entry.getKey();\n AbstractRule commonRule = (AbstractRule) ruleType;\n\n List services = entry.getValue().stream()\n .map(id -> RuleBasedService.builder()\n .serviceId(id)\n .type2Params(service2type2params.getOrDefault(id, Collections.emptyMap()))\n .build())\n .collect(Collectors.toList());\n ruleType2Services.put(commonRule, services);\n }\n return ruleType2Services;\n }\n"}}],"version":"2.31.0-rc.7"}

Tag List