# Business Logic — JKKCustMemberSbtChgCC.execute() [685 LOC]
| Field | Value |
|-------|-------|
| Fully Qualified Name | `com.fujitsu.futurity.bp.custom.common.JKKCustMemberSbtChgCC` |
| Layer | CC/Common Component — shared business logic component called by multiple screens |
| Module | `common` (Package: `com.fujitsu.futurity.bp.custom.common`) |
## 1. Role
### JKKCustMemberSbtChgCC.execute()
This method performs **customer membership type upgrade** — converting a temporary, open, or family-member customer into a master member (individual or corporate) within the K-Opticom/Mineo telecom customer management system. Per the Javadoc: "Processes the change of the specified customer ID to a master member. If already a master member, does nothing. If resigned, recovers the customer." It implements a **conditional-dispatch routing pattern**: based on the customer's current membership type (CD00039 code), the method branches into distinct processing paths — early return for master members, recovery for resigned customers, type-determination for non-master customers, and then a series of post-change side-effect operations (hosting contract synchronization, ISP gateway creation, group management, CCMG integration, payment method cleanup, and directive registration). It serves as a **cross-cutting business hub** called during new-contract intake and screen lookups, where membership decisions need to be resolved and all downstream entities (contact associations, payment methods, service agreements) kept consistent.
## 2. Processing Pattern (Detailed Business Logic)
```mermaid
flowchart TD
START(["execute(handle, param, fixedText)"])
START --> INIT["Initialize: custMap, oPE_DATE, targetUcwkList"]
INIT --> EXTRACT["Extract: memberSbtCd, keisyaTypeCd, sysid, currentSysid, cust_taikai_ymd, eonetidMiIkoFlgBefore"]
EXTRACT --> CHECK_TAikai{"退会年月日
(cust_taikai_ymd)
is present?"}
CHECK_TAikai -->|Yes| RECOVER["Customer Recovery Processing
editCustKaihkMap() + JCKCustKaihkCmnCC.execute()"]
RECOVER --> RET_MEMBER_1["Return regitMemberSbtCd"]
CHECK_TAikai -->|No| CHECK_MASTER{"Current membership
is MASTER_KOJIN or
MASTER_HOJIN?"}
CHECK_MASTER -->|Yes - Already Master| CHECK_SJISHO{"Called from
KKSV076601CC
(mineo lookup)?"}
CHECK_SJISHO -->|Yes| PUT_AX_RENKEI["Link: putAxMRenkeiDataKbn11
(customer info update directive)"]
PUT_AX_RENKEI --> ADD_SJISHO["addSjisho(handle, param, sjishoMap)"]
ADD_SJISHO --> RET_MEMBER_2["Return regitMemberSbtCd"]
CHECK_SJISHO -->|No| RET_MEMBER_2
CHECK_MASTER -->|No - Non-Master| DETERMINE_TYPE["Determine target membership type
based on keisyaTypeCd"]
DETERMINE_TYPE --> TYPE_KOJIN{"keisyaType =
CD00036_KOJIN?"}
TYPE_KOJIN -->|Yes| SET_MASTER_KOJIN["regitMemberSbtCd = CD00039_MASTER_KOJIN"]
SET_MASTER_KOJIN --> CALL_SVC_CHECK
TYPE_KOJIN -->|No| TYPE_HOJIN_OR_JISHA{"keisyaType =
CD00036_HOJIN
or CD00036_JISHA_USE?"}
TYPE_HOJIN_OR_JISHA -->|Yes| SET_MASTER_HOJIN["regitMemberSbtCd = CD00039_MASTER_HOJIN"]
SET_MASTER_HOJIN --> CALL_SVC_CHECK
TYPE_HOJIN_OR_JISHA -->|No - MNT| CHECK_AGREEMENTS["Query ECK0021A010 (individual)
and ECK0031A010 (corporate)
agreements to determine type"]
CHECK_AGREEMENTS --> AGREE_KOJIN{"ECK0021A010 has records?"}
AGREE_KOJIN -->|Yes| SET_KOJIN_AGREE["regitMemberSbtCd = CD00039_MASTER_KOJIN"]
SET_KOJIN_AGREE --> AGREE_HOJIN
AGREE_KOJIN -->|No| AGREE_HOJIN{"ECK0031A010 has records?"}
AGREE_HOJIN -->|Yes| SET_HOJIN_AGREE["regitMemberSbtCd = CD00039_MASTER_HOJIN"]
SET_HOJIN_AGREE --> AGREE_HOJIN_DEFAULT
AGREE_HOJIN -->|No| DEFAULT_HOJIN["regitMemberSbtCd = CD00039_MASTER_HOJIN"]
DEFAULT_HOJIN --> AGREE_HOJIN_DEFAULT
SET_KOJIN_AGREE --> AGREE_HOJIN_DEFAULT
SET_HOJIN_AGREE --> AGREE_HOJIN_DEFAULT
AGREE_HOJIN_DEFAULT --> CALL_SVC_CHECK
CALL_SVC_CHECK --> SVC_CHECK["callScCmn EKK0081B519
Query service contracts"]
SVC_CHECK --> CHECK_HOSTING{"Has hosting
(CD00130_04 = '04')
and active (SVC_KEI_STAT_100)?"}
CHECK_HOSTING -->|Yes| EXISTS_HOSTING["existsContentsAgreement = true"]
EXISTS_HOSTING --> HOST_SYNC["Sync contract info:
edit customer info via C010,
edit contact associations,
handle contact insert (OM-2014-0002974)"]
HOST_SYNC --> BREAK_HOSTING["break - skip ISP flow"]
CHECK_HOSTING -->|No| CHECK_OPEN_MEMBER{"Current membership =
CD00039_30 (Open Member)?"}
CHECK_OPEN_MEMBER -->|Yes| ISP_FLOW_INIT["ispKessaiCreateFlg = true"]
ISP_FLOW_INIT --> ISP_CHECK_SVC{"Has other eo services
excluding hosting/mineo?"}
ISP_CHECK_SVC -->|Yes| ISP_SET_FALSE["ispKessaiCreateFlg = false"]
ISP_SET_FALSE --> ISP_BREAK["break"]
ISP_CHECK_SVC -->|No| ISP_TRUE["ispKessaiCreateFlg remains true"]
ISP_TRUE --> ISP_BREAK
ISP_BREAK --> HOLD_BEFORE["memberSbtCdBefore = memberSbtCd
dslAfSkssnsKh = null"]
HOLD_BEFORE --> CHECK_UPGRADE{"Was Open Member
and now Master?"}
CHECK_UPGRADE -->|Yes| SET_DSL_FAIL["dslAfSkssnsKh = CD00003_FAIL
(contract cancellation request blocked)"]
SET_DSL_FAIL --> MEMBER_UPDATE
CHECK_UPGRADE -->|No| MEMBER_UPDATE
MEMBER_UPDATE["editMapMemberSbt(param, custMap, regitMemberSbtCd, dslAfSkssnsKh)"]
MEMBER_UPDATE --> EXEC_MEMBER_SCLOOP["Loop: ServiceComponentRequestInvoker
execute member type change SC"]
EXEC_MEMBER_SCLOOP --> SYSID_UPDATE["Update sysid from result
Update ck0011UpdDtm"]
SYSID_UPDATE --> FAMILY_CHECK["callScCmn ECK0111B002
Query family member group"]
FAMILY_CHECK --> IS_GROUP{"Is family group?
(eck0111MsgList > 0)"}
IS_GROUP -->|Yes| SET_IS_GROUP["isGroup = true
grp_leader_sysid = eck0111MsgList[0].grp_leader_sysid"]
SET_IS_GROUP --> GROUP_DECISION
IS_GROUP -->|No| SET_NOT_GROUP["isGroup = false"]
SET_NOT_GROUP --> GROUP_DECISION
GROUP_DECISION{"isGroup=false
OR was Family
Member before?"}
GROUP_DECISION -->|Yes| PREP_GRP_SETUP["Query ECK0121B020
(customer group settings)"]
PREP_GRP_SETUP --> EXEC_REGIST["callScCmn ECK0111D010
Register group"]
EXEC_REGIST --> CHECK_PREV_FAMILY{"Was previous
Family Member?"}
CHECK_PREV_FAMILY -->|Yes| DISABLE_PREV_GRP["Invalidate previous
customer group setting ECK0121C020"]
DISABLE_PREV_GRP --> FAMILY_TYPE_HANDLER
CHECK_PREV_FAMILY -->|No| FAMILY_TYPE_HANDLER
GROUP_DECISION -->|No| SKIP_TO_RENKEI["Skip group operations"]
FAMILY_TYPE_HANDLER{"Was previous
Family Member
(KOJIN or HOJIN)?"}
FAMILY_TYPE_HANDLER -->|Yes| FAMILY_FLOW["Handle family-to-master upgrade"]
FAMILY_FLOW --> WIFI_SPOT{"grp_leader_sysid != null?"}
WIFI_SPOT -->|Yes| UPDATE_WIFI["updateWifiSpotLoginSysid()"]
UPDATE_WIFI --> HAKKO_SOD["hakkoSodCc() — Wi-Fi spot SOD"]
HAKKO_SOD --> CCMG_INTEGRATION
WIFI_SPOT -->|No| CCMG_INTEGRATION
CCMG_INTEGRATION{"needCallApiMmbSbtUpd()"}
CCMG_INTEGRATION -->|Yes| REQUEST_CCMG["requestCcmgApiChgMmbSbtDsl()"]
REQUEST_CCMG --> PAYWAY_UPDATE
CCMG_INTEGRATION -->|No| PAYWAY_UPDATE
PAYWAY_UPDATE["callECN0131B006 — Payment method inquiry"]
PAYWAY_UPDATE --> PAYWAY_LOOP_LOOP["Loop: payment method records"]
PAYWAY_LOOP_LOOP --> PAYWAY_ISPKS{"payway_input_shien_cd =
PAYWAY_INPSUP_CD_ISPKS?"}
PAYWAY_ISPKS -->|Yes - ISP Payway| PAYWAY_PARENT{"ISP svc_kei_no in
parent customer set?"}
PAYWAY_PARENT -->|Yes| DELETE_PAYWAY["callECH0231B010 +
callECN0131E011 +
callECK0151D010Map
— Delete old ISP payway"]
DELETE_PAYWAY --> PAYWAY_LOOP_END
PAYWAY_PARENT -->|No| PAYWAY_LOOP_END
PAYWAY_ISPKS -->|No| PAYWAY_LOOP_END
PAYWAY_LOOP_END --> PAYWAY_LOOP_NEXT["Next payment record"]
PAYWAY_LOOP_NEXT --> PAYWAY_LOOP_CHECK{"More records?"}
PAYWAY_LOOP_CHECK -->|Yes| PAYWAY_LOOP_LOOP
PAYWAY_LOOP_CHECK -->|No| SKIP_TO_RENKEI_FLOW
FAMILY_TYPE_HANDLER -->|No| SKIP_TO_RENKEI_FLOW
CHECK_OPEN_POST{"Was previous
Open Member?"}
CHECK_OPEN_POST -->|Yes| OPEN_MEMBER_CCMG["needCallApiMmbSbtUpd() +
requestCcmgApiChgMmbSbtDsl()"]
OPEN_MEMBER_CCMG --> OPEN_BREAK["break"]
CHECK_OPEN_POST -->|No| OPEN_BREAK
OPEN_BREAK --> PUT_CUST_GRP["putAxMRenkeiDataKbn
(customer group info — RENAME_DATA_KBN_CUST_GRP)"]
PUT_CUST_GRP --> PUT_BASIC_INFO{"Was previous
Open/Family Member?"}
PUT_BASIC_INFO -->|Yes| PUT_BASIC_UPD["putAxMRenkeiDataKbn11
(customer info — UPDATE)"]
PUT_BASIC_UPD --> PUT_FINAL_SJISHO
PUT_BASIC_INFO -->|No| PUT_BASIC_ADD["putAxMRenkeiDataKbn
(customer info — ADD)"]
PUT_BASIC_ADD --> PUT_FINAL_SJISHO
PUT_FINAL_SJISHO{"ispKessaiCreateFlg?
(ISP Gateway auto-set)"}
PUT_FINAL_SJISHO -->|Yes| CREATE_ISP_GW["callECN0131D011ForIspks
— Create ISP gateway payway
putAxMRenkeiDataKbn08 (directive ADD)"]
CREATE_ISP_GW --> EXEC_SJISHO
PUT_FINAL_SJISHO -->|No| EXEC_SJISHO
EXEC_SJISHO["addSjishoCC.addSjisho() — Directive registration"]
EXEC_SJISHO --> RET_MEMBER_3["Return regitMemberSbtCd"]
RET_MEMBER_3 --> END(["End"])
SKIP_TO_RENKEI --> PUT_CUST_GRP
RET_MEMBER_1 --> END
RET_MEMBER_2 --> END
```
## 3. Parameter Analysis
| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| 1 | `handle` | `SessionHandle` | Database/session handle used for all SC (Service Component) invocations within this transaction. Carries the persistence context and connection state. |
| 2 | `param` | `IRequestParameterReadWrite` | Request parameter object carrying the customer data map (keyed by `fixedText`), directive registration maps, error message lists, and cross-component data passing. Contains `custMap` which holds the result of customer single-query lookup. |
| 3 | `fixedText` | `String` | A unique map key prefix used to namespace data maps within `param`. Combines with constants like `SJISHO_MAP` and `CUSTKAIHK_MAPKEY_SUFFIX` to form keys such as `"KKSV076601CC_CUSTMMBSBT_CHG_SJISHO_MAP"`. Also serves as a caller identifier (e.g., `"KKSV076601CC"`) to detect which screen triggered the membership change. |
**Instance fields read by this method:**
| Field | Type | Business Description |
|-------|------|---------------------|
| `oPE_DATE` | `String` | Operation date (set to current business date via `JCCBPCommon.getOpeDate()`) — used in group registration templates |
| `targetUcwkList` | `List