wace_rps/docs/migration/development/02-ebom.md

# PR-B : E-BOM 등록·조회 묶음 구현 명세 (M3+M4)

> 작성: 2026-05-12 / 범위: 개발관리 M3(E-BOM 등록) + M4(E-BOM 조회) — `part_bom_report` 메인, `bom_part_qty` 트리.

---

## 1. 매퍼 쿼리 1:1 매핑

원본 `wace_plm/src/com/pms/mapper/partMng.xml`:

| Query id | Line | 본 PR 매핑 | 용도 |
|---|---:|---|---|
| `getBOMStandardStructureGridList` | 2,859 | `GET /api/development/ebom/list` | M3 그리드 (PART_BOM_REPORT + 집계) |
| `updateStructureStatus` | 8,027 | `PUT /api/development/ebom/status` | M3 상태변경 (PRODUCT_CD/PART_NO/NAME/VERSION/STATUS) |
| `deleteBomReport` | 6,838 | `DELETE /api/development/ebom` (body `objids`) | M3 다중 삭제 + BOM_PART_QTY CASCADE |
| `deleteBomQty` | 6,847 | (deleteBomReport 내부) | M3 삭제 시 자식 트리 동시 삭제 |
| `structureAscendingList` | 7,361 | `GET /api/development/ebom/ascending` | M4 정전개 (root → leaf) |
| `selectStructureDescendingList` | 6,582 | `GET /api/development/ebom/descending` | M4 역전개 (leaf → root) |

---

## 2. API 엔드포인트 명세

### 2.1 M3 그리드 — `GET /api/development/ebom/list`

**Query**:
```
customer_cd?: string        // part_bom_report.customer_objid
project_name?: string       // part_bom_report.contract_objid (project_mgmt.objid)
unit_code?: string          // pms_wbs_task.objid
search_unit_name?: string   // pms_wbs_task.unit_no/task_name LIKE
search_writer?: string      // part_bom_report.writer
product_cd?: string         // wace 'product_code' 검색 (part_bom_report.product_cd)
search_part_no?: string     // part_bom_report.part_no LIKE
search_part_name?: string   // part_bom_report.part_name LIKE
search_from_date?: string   // regdate from
search_to_date?: string     // regdate to
status?: string             // part_bom_report.status (create/changeDesign/deploy)
page?, page_size?
```

**SQL** (vexplor_rps part_bom_report 스키마 적응 — wace `getBOMStandardStructureGridList` 의 PRODUCT_CD/PART_NO/PART_NAME 분기 활성, MULTI_* 컬럼 그대로):
```sql
SELECT
   ROW_NUMBER() OVER(ORDER BY T.REGDATE DESC) AS NUM,
   T.OBJID, T.CUSTOMER_OBJID, SM.SUPPLY_NAME AS CUSTOMER_NAME,
   T.CONTRACT_OBJID, PM.CUSTOMER_PROJECT_NAME, PM.PROJECT_NO,
   T.UNIT_CODE, COALESCE(WT.UNIT_NO || '-' || WT.TASK_NAME, '') AS UNIT_NAME,
   T.STATUS,
   CASE UPPER(T.STATUS)
     WHEN 'CREATE' THEN '등록중'
     WHEN 'CHANGEDESIGN' THEN '설계변경미배포'
     WHEN 'DEPLOY' THEN '배포완료'
     ELSE '' END AS STATUS_TITLE,
   T.WRITER, UI.DEPT_NAME, UI.USER_NAME,
   COALESCE(UI.DEPT_NAME || '/' || UI.USER_NAME, '') AS DEPT_USER_NAME,
   T.REGDATE, TO_CHAR(T.REGDATE, 'YYYY-MM-DD') AS REG_DATE,
   T.DEPLOY_DATE, T.REVISION,
   EO_DATA.EO_NO, EO_DATA.EO_DATE,
   T.NOTE, T.MULTI_YN, T.MULTI_MASTER_YN, T.MULTI_BREAK_YN, T.MULTI_MASTER_OBJID,
   COALESCE(EO_DATA.BOM_CNT, 0) AS BOM_CNT,
   T.PRODUCT_CD, CC_PRD.code_name AS PRODUCT_NAME,
   T.PART_NO, T.PART_NAME
  FROM PART_BOM_REPORT T
  LEFT JOIN customer_mng SM   ON SM.customer_code = T.CUSTOMER_OBJID  -- vexplor 매핑
  LEFT JOIN PROJECT_MGMT PM   ON PM.OBJID = T.CONTRACT_OBJID
  LEFT JOIN PMS_WBS_TASK WT   ON WT.OBJID = T.UNIT_CODE
  LEFT JOIN USER_INFO UI      ON UI.USER_ID = T.WRITER
  LEFT JOIN COMM_CODE CC_PRD  ON CC_PRD.code_id = T.PRODUCT_CD AND CC_PRD.status = 'active'
  LEFT JOIN (
    SELECT BP.BOM_REPORT_OBJID,
           MAX(PM2.EO_NO) AS EO_NO,
           MAX(PM2.EO_DATE) AS EO_DATE,
           COUNT(*) AS BOM_CNT
      FROM BOM_PART_QTY BP
      LEFT JOIN PART_MNG PM2 ON BP.PART_NO = PM2.OBJID::varchar
     GROUP BY BP.BOM_REPORT_OBJID
  ) EO_DATA ON EO_DATA.BOM_REPORT_OBJID = T.OBJID
 WHERE 1=1 + 동적 (위 11 필터)
```

**Response**: `{ rows: BomReportRow[], total, page, pageSize }`

### 2.2 M3 단건 상세 — `GET /api/development/ebom/:objid`

`SELECT T.* FROM PART_BOM_REPORT T WHERE T.OBJID = $1` + (옵션) BOM_PART_QTY 카운트.
편집 다이얼로그 진입용.

### 2.3 M3 상태 변경 — `PUT /api/development/ebom/:objid/status`

**Body**: `{ product_cd?, part_no?, part_name?, version?, status }` — wace `updateStructureStatus` 1:1.
`STATUS` 만 변경하는 단순 케이스도 지원 (다른 필드 NULL 허용).

```sql
UPDATE PART_BOM_REPORT
   SET PRODUCT_CD = COALESCE($1, PRODUCT_CD),
       PART_NO    = COALESCE($2, PART_NO),
       PART_NAME  = COALESCE($3, PART_NAME),
       REVISION   = COALESCE($4, REVISION),
       STATUS     = $5,
       EDITER     = $6,
       EDIT_DATE  = NOW()
 WHERE OBJID = $7
```

### 2.4 M3 다중 삭제 — `DELETE /api/development/ebom` (body: `{ objids: string[] }`)

**트랜잭션**:
1. `DELETE FROM BOM_PART_QTY  WHERE BOM_REPORT_OBJID = ANY($1)` (자식 트리)
2. `DELETE FROM PART_BOM_REPORT WHERE OBJID = ANY($1)` (메인)

wace는 part_mng도 정리(`deleteBomQtyPart`, status='create'만)하지만 본 PR에서는 part_mng 보존 (M1·M2와 결합 안 됨).

### 2.5 M4 정전개 — `GET /api/development/ebom/ascending`

**Query**:
```
bom_report_objid?: string   // 단일 BOM 한정 조회
project_name?: string       // PART_BOM_REPORT.contract_objid
unit_code?: string
search_part_no?: string
search_part_name?: string
```

**SQL** (재귀 CTE — wace `structureAscendingList` 의 BOM_PART_QTY 트리 1:1):
```sql
WITH RECURSIVE TREE(bom_report_objid, objid, parent_objid, child_objid, part_no, qty, lev, path, cycle) AS (
   SELECT BP.bom_report_objid, BP.objid, BP.parent_objid, BP.child_objid,
          BP.part_no, BP.qty, 1, ARRAY[BP.objid], FALSE
     FROM bom_part_qty BP
    WHERE (BP.parent_objid IS NULL OR BP.parent_objid = '')
      AND BP.bom_report_objid = $bom_report_objid   /* 또는 필터 적용된 PART_BOM_REPORT 서브쿼리 */
   UNION ALL
   SELECT B.bom_report_objid, B.objid, B.parent_objid, B.child_objid,
          B.part_no, B.qty, T.lev + 1, T.path || B.objid, B.objid = ANY(T.path)
     FROM bom_part_qty B
     JOIN TREE T ON B.parent_objid = T.objid AND NOT T.cycle
)
SELECT T.*,
       PM.part_no       AS pm_part_no,
       PM.part_name     AS pm_part_name,
       PM.spec, PM.material, PM.weight, PM.remark,
       PM.edit_date,
       (SELECT COUNT(1) FROM attach_file_info F WHERE F.target_objid = PM.objid::varchar AND F.doc_type='3D_CAD')         AS cu01_cnt,
       (SELECT COUNT(1) FROM attach_file_info F WHERE F.target_objid = PM.objid::varchar AND F.doc_type='2D_DRAWING_CAD') AS cu02_cnt,
       (SELECT COUNT(1) FROM attach_file_info F WHERE F.target_objid = PM.objid::varchar AND F.doc_type='2D_PDF_CAD')     AS cu03_cnt,
       (SELECT MAX(lev) FROM TREE)                                                                                       AS max_level
  FROM TREE T
  LEFT JOIN part_mng PM ON T.part_no = PM.objid::varchar
 ORDER BY T.path
```

**Response**: `{ rows: AscRow[], max_level: number }`

### 2.6 M4 역전개 — `GET /api/development/ebom/descending`

같은 Query 파라미터. 재귀 방향 반대:
- 시작점: 리프(`child_objid` 가 다른 행의 `parent_objid` 가 아닌 행) 또는 사용자가 지정한 PART
- 트리 부모 방향으로 traverse

**SQL** (역전개 — wace `selectStructureDescendingList` 단순 매핑):
```sql
WITH RECURSIVE TREE(...) AS (
   /* 1. anchor: 조건 매칭 BOM 또는 leaf part */
   SELECT BP.* , 1 AS lev, ARRAY[BP.objid] AS path, FALSE AS cycle
     FROM bom_part_qty BP
    WHERE ... /* PART_NO 매칭 등 */
   UNION ALL
   /* 2. parent 방향 traverse */
   SELECT B.*, T.lev + 1, T.path || B.objid, B.objid = ANY(T.path)
     FROM bom_part_qty B
     JOIN TREE T ON B.objid = T.parent_objid AND NOT T.cycle
)
SELECT ... (정전개와 동일 part_mng / attach_file_info JOIN)
```

**Response**: `{ rows: DescRow[], max_level: number }`

---

## 3. Backend 파일 구조

```
backend-node/src/
  routes/
    devBomRoutes.ts         // 6 endpoint
  controllers/
    devBomController.ts
  services/
    devBomService.ts        // list/getById/updateStatus/removeMany/ascending/descending
```

`app.ts`: `app.use("/api/development", devBomRoutes)` (devPart 라우터와 prefix 공유 — Express 중복 등록 안전, 경로 충돌 없음).

---

## 4. Frontend 파일 구조

```
frontend/
  app/(main)/COMPANY_16/development/
    ebom-regist/page.tsx    // M3 그리드 + 검색 + 액션
    ebom-search/page.tsx    // M4 정/역전개 (동적 LEVEL 컬럼)
  components/development/
    BomReportStatusDialog.tsx   // M3 상태 변경 다이얼로그 (status select)
  lib/api/
    devBom.ts               // 6 endpoint 호출 + 타입
```

### 4.1 M3 그리드 (9 셀, wace structureList.jsp:185~215 1:1)

| key | 라벨 | 정렬 | 너비 |
|---|---|---|---:|
| product_name | 제품구분 | center | 160 |
| part_no | 품번 | left | 210 |
| part_name | 품명 | left | flex |
| bom_cnt | E-BOM (folder click) | center | 150 |
| dept_user_name | 등록자 | center | 120 |
| reg_date | 등록일 | center | 130 |
| deploy_date | 확정일 | center | 100 |
| revision | Version | center | 110 |
| status_title | 상태 | center | 110 |

### 4.2 M3 검색 폼 (wace 1:1 — 9 필드)

customer_cd · project_name · unit_code · SEARCH_UNIT_NAME · SEARCH_WRITER · product_cd · SEARCH_PART_NO · SEARCH_PART_NAME · search_fromDate~toDate · status

본 PR 1차: PRODUCT_CD · SEARCH_PART_NO · SEARCH_PART_NAME · STATUS 4필드로 시작. 나머지 추후 보강.

### 4.3 M3 액션 버튼 (wace 1:1)

- 조회 / 삭제 / E-BOM등록(Excel Import — 별 PR) / 상태변경

본 PR 포함: 조회 · 삭제 · 상태변경. **E-BOM등록(Excel Import)은 별 PR**.

### 4.4 M4 동적 LEVEL 컬럼

backend response의 `max_level` 값에 따라 컬럼을 동적 생성:
- LEVEL 1..max_level: 각 레벨 컬럼은 `row.lev === i` 인 행의 `part_no` 표시 (트리 들여쓰기 효과)
- 고정 컬럼: 품번 · 품명 · 3D/2D/PDF · 수량 · 변경일 · 규격 · 재질 · 중량 · 비고

DataGrid의 컬럼 배열을 fetch 결과 도착 시 동적 생성 (state).

### 4.5 M4 액션

- 정전개 조회 (default)
- 역전개 조회
- (Excel Download — 별 PR)

---

## 5. 본 PR 제외 항목

| 항목 | 사유 / 후속 |
|---|---|
| E-BOM 등록 (Excel Import) | `openBomReportExcelImportPopUp.jsp` — 별 PR |
| 정/역전개 Excel Download | `structureAscendingListExcel`/`structureDescendingExcelList` — 별 PR |
| `BOM_PART_QTY` 직접 편집 (수량 변경) | `structureQtySave` — wace 운영판에서도 별 화면 |
| 다중 BOM(MULTI_*) 분기 처리 | 현재 vexplor 데이터 없음 — 기본 1:1만 |
| wace_plm `product_mgmt_spec/upg/vc` 분기 | vexplor 스키마는 product_cd 단순 — 운영판 1:1 적응 |

---

## 6. 검증 시나리오 (verify.md 기준)

1. M3 페이지 진입 → part_bom_report 그리드 (현재 0건, schema/UI 동작 확인)
2. M3 상태변경 다이얼로그 → status='deploy' → DB 반영 확인
3. M3 다중 삭제 → bom_part_qty CASCADE 확인
4. M4 페이지 진입 → 정전개 (`/ascending`) 0건 응답 → 페이지 정상 표시
5. M4 역전개 토글 → `/descending` 응답
6. (시드 후) MAX_LEVEL=3 트리에서 동적 컬럼 3개 생성 확인

---

## 7. 적응 사항 (운영판 대비 변경점)

| # | 항목 | 변경 |
|---|---|---|
| 1 | `customer_mng` 매핑 | wace `SUPPLY_MNG.OBJID::VARCHAR = T.CUSTOMER_OBJID` → vexplor `customer_mng.customer_code = T.CUSTOMER_OBJID` |
| 2 | `PRODUCT_NAME` lookup | wace `CODE_NAME(PRODUCT_CD)` → vexplor `LEFT JOIN comm_code` (`CC_PRD`) |
| 3 | M4 `PRODUCT_MGMT_*` 분기 제거 | vexplor part_bom_report 는 product_cd/version 단순화 — wace `product_mgmt_spec/upg/vc` 컬럼 없음 → JOIN 생략, 정전개는 BOM_PART_QTY 트리만 |
| 4 | 다중 삭제 트랜잭션 | wace 두 매퍼(`deleteBomQty` + `deleteBomReport`) 호출 → backend `transaction()` 한 번 |