---
# Business Logic — JDKCommon48CC.checkTkniKikiSbtCd() [34 LOC]

| Field | Value |
|-------|-------|
| Fully Qualified Name | `com.fujitsu.futurity.bp.custom.common.JDKCommon48CC` |
| Layer | CC/Common Component (Service-facing business logic, in `com.fujitsu.futurity.bp.custom.common`) |
| Module | `common` (Package: `com.fujitsu.futurity.bp.custom.common`) |

## 1. Role

### JDKCommon48CC.checkTkniKikiSbtCd()

This method determines whether a given "tkniKikiSbtCd" (indoor equipment type code) qualifies the equipment for **Return SOD (Service Order Data) issuance**. In the Fujitsu Futurity telecom order fulfillment system, when customers return or exchange indoor networking equipment (e.g., FTTH ONUs, broadband routers, home gateways), a Return SOD must be generated to track the equipment in the backend service order pipeline. This method acts as a **filtering gate**: if the equipment type code is one of the eligible types, it returns `true`, allowing the calling business logic to proceed with Return SOD creation; otherwise, it returns `false` and the calling process skips the Return SOD issuance step. It handles five equipment categories: "50" (Optical Phone VA — FTTH voice equipment), "F0" (BBR — Broadband Router), "J0" (UNO/VOIP — Voice over IP equipment), "R0" (Takinort — Multi-function Router), and "S0" (HGW — Home Gateway). The method follows a simple predicate/gateway design pattern and is a shared utility called by two enclosing methods across different screens (DKSV0050 and DKSV0081) that handle return SOD workflows.

## 2. Processing Pattern (Detailed Business Logic)

```mermaid
flowchart TD
    START(["checkTkniKikiSbtCd tkniKikiSbtCd"])
    CHECK_50["Code is 50"]
    RETURN_TRUE_50["Return true"]
    CHECK_F0["Code is F0"]
    RETURN_TRUE_F0["Return true"]
    CHECK_J0["Code is J0"]
    RETURN_TRUE_J0["Return true"]
    CHECK_R0["Code is R0"]
    RETURN_TRUE_R0["Return true"]
    CHECK_S0["Code is S0"]
    RETURN_TRUE_S0["Return true"]
    ELSE_BRANCH["Code not recognized"]
    RETURN_FALSE["Return false"]

    START --> CHECK_50
    CHECK_50 -- Yes --> RETURN_TRUE_50
    CHECK_50 -- No --> CHECK_F0
    CHECK_F0 -- Yes --> RETURN_TRUE_F0
    CHECK_F0 -- No --> CHECK_J0
    CHECK_J0 -- Yes --> RETURN_TRUE_J0
    CHECK_J0 -- No --> CHECK_R0
    CHECK_R0 -- Yes --> RETURN_TRUE_R0
    CHECK_R0 -- No --> CHECK_S0
    CHECK_S0 -- Yes --> RETURN_TRUE_S0
    CHECK_S0 -- No --> ELSE_BRANCH
    ELSE_BRANCH --> RETURN_FALSE
```

**Branch descriptions:**

- **"50" (Optical Phone VA):** `TKNKIKI_SBT_CD_GBDEN_VA = "50"` — Fiber-optic integrated voice/video terminal equipment (light telephone VA). Eligible for return SOD issuance.
- **"F0" (BBR):** `TKNKIKI_SBT_CD_BBR = "F0"` — Broadband Router. Eligible for return SOD issuance.
- **"J0" (UNO/VOIP):** `TKNKIKI_SBT_CD_UNO = "J0"` — VOIP (Voice over IP) equipment. Eligible for return sOD.
- **"R0" (Takinort/Multi-function Router):** `TKNKIKI_SBT_CD_TAKINORT = "R0"` (from JKKStrConst.java:2980) — Multi-function Router. Eligible for return SOD issuance.
- **"S0" (HGW/Home Gateway):** `TKNKIKI_SBT_CD_HGW = "S0"` (from JKKStrConst.java:2616) — Home Gateway. Eligible for return SOD issuance. Added in ticket ANK-4315-00-00.
- **Any other code:** The method returns `false`, indicating the equipment type is not a target for return SOD issuance.

## 3. Parameter Analysis

| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| 1 | `tkniKikiSbtCd` | `String` | Indoor Equipment Type Code — a short alphanumeric code identifying the type of customer-premises networking equipment (e.g., FTTH ONU, broadband router, home gateway). This code is retrieved from the domestic equipment type consensus CBS result (`EZM0411A010CBSMsg1List.TAKNKIKI_SBT_CD`) and determines whether the equipment qualifies for Return SOD generation. |

**External state read:** None. The method is stateless and relies solely on its input parameter and hardcoded constant comparisons.

## 4. CRUD Operations / Called Services

This method contains no method calls, no database access, and no service component invocations. It is a pure **predicate function** — a read-only conditional check against hardcoded values.

| CRUD | SC / CBS | SC Code | Entity / DB | Operation Description |
|------|----------|---------|-------------|----------------------|
| — | — | — | — | N/A — No CRUD operations. Pure boolean predicate with no data access. |

## 5. Dependency Trace

### Pre-computed evidence from code analysis graph:

Direct callers found: 2 methods.

| # | Caller (Screen/Batch) | Call Chain (Full Path to this Method) | Terminal (SC / CRUD / Entity) |
|---|----------------------|--------------------------------------|-------------------------------|
| 1 | Screen:DKSV0050 | `JDKCommon48CC.addHmpinSodHakko` -> `checkTkniKikiSbtCd` | `EZM0411A010BSMapper [R] domestic equipment type consensus` |
| 2 | Screen:DKSV0081 | `JDKCommon08CC` (Return SOD issuance loop body) -> `checkTkniKikiSbtCd` | `EZM0411A010BSMapper [R] domestic equipment type consensus` |

**Notes:**
- Caller #1: `addHmpinSodHakko` is a private method in the same class (`JDKCommon48CC`). It is invoked from the **Home Repair/Exchange Equipment Information Update** process (`EZM0411` screen). After confirming domestic equipment type consensus via CBS, this method filters which equipment types trigger Return SOD creation. If the check fails, the method returns early and skips Return SOD issuance.
- Caller #2: `JDKCommon08CC` contains an iteration loop over equipment records in a Return SOD batch processing context. For each equipment record, it queries the domestic equipment type and uses `checkTkniKikiSbtCd` as a guard before proceeding to the Return SOD creation CBS (`EKK0341B034BSMapper`).
- The `checkTkniKikiSbtCd` method is also duplicated as a private method in `JDKCommon08CC` (line 2479), which is a common pattern in this codebase where the same predicate logic exists in both common classes.

## 6. Per-Branch Detail Blocks

**Block 1** — IF `(condition: tkniKikiSbtCd equals "50") [TKNKIKI_SBT_CD_GBDEN_VA="50"] (L1223)`

> Check whether the equipment type code is "50" (Optical Phone VA — fiber-optic integrated voice/video equipment). This is the primary FTTH customer premises device.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true;` // Equipment is eligible for Return SOD issuance |

**Block 2** — ELSE-IF `(condition: tkniKikiSbtCd equals "F0") [TKNKIKI_SBT_CD_BBR="F0"] (L1228)`

> Check whether the equipment type code is "F0" (BBR — Broadband Router). Broadband routers are eligible for return SOD.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true;` // Equipment is eligible for Return SOD issuance |

**Block 3** — ELSE-IF `(condition: tkniKikiSbtCd equals "J0") [TKNKIKI_SBT_CD_UNO="J0"] (L1233)`

> Check whether the equipment type code is "J0" (UNO/VOIP — Voice over IP equipment). VOIP equipment is eligible for return SOD.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true;` // Equipment is eligible for Return SOD issuance |

**Block 4** — ELSE-IF `(condition: tkniKikiSbtCd equals JKKStrConst.TAKNKIKI_SBT_CD_TAKINORT) [-> TKNKIKI_SBT_CD_TAKINORT="R0" (JKKStrConst.java:2980)] (L1238)`

> Check whether the equipment type code is "R0" (Takinort — Multi-function Router). Multi-function routers combine broadband routing, WiFi, and VoIP functions. Eligible for return SOD.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true;` // Equipment is eligible for Return SOD issuance |

**Block 5** — ELSE-IF `(condition: tkniKikiSbtCd equals JKKStrConst.TAKNKIKI_SBT_CD_HGW) [-> TKNKIKI_SBT_CD_HGW="S0" (JKKStrConst.java:2616)] (L1244)`

> Check whether the equipment type code is "S0" (HGW — Home Gateway). Added in ANK-4315-00-00. Home Gateways are newer-generation residential gateway devices. Eligible for return SOD.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true;` // Equipment is eligible for Return SOD issuance |

**Block 6** — ELSE `(default: unrecognized code) (L1249)`

> No matching equipment type code was found. The equipment is not a target for Return SOD issuance.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return false;` // Equipment is not eligible for Return SOD issuance |

## 7. Glossary

| Term | Type | Business Meaning |
|------|------|------------------|
| `tkniKikiSbtCd` | Field | Indoor Equipment Type Code — an alphanumeric code classifying the type of customer-premises networking equipment. Retrieved from the domestic equipment type consensus CBS result. |
| SOD | Acronym | Service Order Data — the telecom order fulfillment entity used to track equipment provisioning, change, and return operations in the backend system. |
| Return SOD | Business term | A specialized Service Order generated when returning or exchanging customer-owned or leased networking equipment at the customer premises. |
| VA | Acronym | Voice and Video — indicates an FTTH terminal that supports both voice (telephone) and video services alongside data. |
| Optical Phone VA | Business term | Fiber-optic integrated voice/video terminal — the customer-side device for NTT Hikari Fiber (FTTH) service that combines internet, telephone, and optionally video. |
| BBR | Acronym | Broadband Router — a standalone networking device providing internet access and LAN connectivity to customer premises. |
| UNO | Business term | NTT's VOIP service brand — Voice over IP telephone service equipment. |
| VOIP | Acronym | Voice over Internet Protocol — telephony service delivered over IP networks instead of traditional telephone lines. |
| Takinort | Business term | Multi-function Router — a combined device integrating broadband routing, WiFi access point, and VoIP telephone functions. |
| HGW | Acronym | Home Gateway — a next-generation residential gateway device that consolidates modem, router, WiFi, and VoIP functions into a single unit. |
| Domestic Equipment Type Consensus | Business term | A CBS (Business Component Service) call (`EZM0411A010`) that queries and confirms the type/model of equipment installed at the customer premises. |
| `addHmpinSodHakko` | Method | Return SOD Issuance Processing — a private method in JDKCommon48CC that orchestrates the creation of Return SOD records for eligible equipment. |
| DKSV0050 | Screen | Screen handling home repair/exchange equipment information updates that invoke Return SOD issuance. |
| DKSV0081 | Screen | Screen handling Return SOD batch processing of equipment records. |
| EZM0411A010 | CBS Code | Domestic Equipment Type Consistency Confirmation — CBS that queries equipment model and type information. |
| EKK0341B034 | CBS Code | Equipment Provider Service Contract Summary (Return SOD) — CBS that creates Return SOD records. |
| TKNKIKI_SBT_CD | Field | Indoor Equipment Type Code — the constant field name in CBS message lists for the equipment type code. |

---