# 작업내역 — feature/crypto-module (eapim-admin)

> 작업일: 2026-05-07
> 브랜치: `feature/crypto-module`
> 작업자: curry772
> 프로젝트: `eapim-admin`

---

## 작업 목적

2026-05-06 작업 미완료 항목 처리 및 기능 테스트 중 발견된 버그 수정, UX 개선.

---

## 변경 파일 목록

### DB DDL

| 항목 | 내용 |
|---|---|
| `EMSAPP.CRYPTO_MODULE_CONFIG` 테이블 컬럼 추가 | 기존 DDL에서 누락된 `MODIFIED_BY`, `MODIFIED_AT` 컬럼 추가 |

```sql
ALTER TABLE EMSAPP.CRYPTO_MODULE_CONFIG
ADD (
    MODIFIED_BY  VARCHAR2(50),
    MODIFIED_AT  TIMESTAMP
);
```

> 전체 DDL (신규 환경용)
```sql
CREATE TABLE EMSAPP.CRYPTO_MODULE_CONFIG (
    CRYPTO_ID          VARCHAR2(36)   NOT NULL,
    CRYPTO_NAME        VARCHAR2(100)  NOT NULL,
    CRYPTO_DESC        VARCHAR2(500),
    ALG_TYPE           VARCHAR2(10)   NOT NULL,
    CIPHER_MODE        VARCHAR2(20)   NOT NULL,
    PADDING            VARCHAR2(30),
    IV_HEX             VARCHAR2(200),
    KEY_SOURCE_TYPE    VARCHAR2(20)   NOT NULL,
    ENC_KEY_HEX        VARCHAR2(200),
    DEC_KEY_HEX        VARCHAR2(200),
    KEY_DERIV_STRATEGY VARCHAR2(200),
    KEY_DERIV_PARAMS   VARCHAR2(2000),
    CACHE_YN           CHAR(1)        NOT NULL,
    CACHE_TTL_SEC      NUMBER(10),
    USE_YN             CHAR(1)        NOT NULL,
    MODIFIED_BY        VARCHAR2(50),
    MODIFIED_AT        TIMESTAMP,
    CONSTRAINT PK_CRYPTO_MODULE_CONFIG PRIMARY KEY (CRYPTO_ID),
    CONSTRAINT UQ_CRYPTO_MODULE_CONFIG_NAME UNIQUE (CRYPTO_NAME)
);
```

---

### 비즈니스 레이어 — `CryptoModuleConfigManService.java`

#### 버그 수정: detached entity passed to persist

**원인**
- `AbstractEntity`가 `Persistable<I>`를 구현하고 `@Transient boolean isNew = true`로 선언
- `@PostLoad`에서 `isNew = false`로 전환하는 구조
- `AbstractDataService.getById(id)`는 `repository.getReferenceById(id)` (lazy proxy) 반환
- lazy proxy는 실제 DB 조회를 하지 않아 `@PostLoad`가 호출되지 않음 → `isNew = true` 유지
- `save(proxy)` 호출 시 `isNew() = true` → `em.persist(proxy)` → detached entity 에러

**수정 내용**

| 메서드 | 변경 전 | 변경 후 |
|---|---|---|
| `selectDetail()` | `dataService.getById(cryptoId)` | `dataService.findById(cryptoId).orElseThrow(...)` |
| `update()` | `dataService.getById(ui.getCryptoId())` | `dataService.findById(ui.getCryptoId()).orElseThrow(...)` |
| `insert()` | — | `entity.setCryptoId(null)` 추가 |

- `findById()`는 실제 DB 조회 → `@PostLoad` 호출 → `isNew = false` → `merge()` 정상 동작
- `insert()` 에서 `setCryptoId(null)` 추가: JSP `<input type="hidden" name="cryptoId" />`가 빈 문자열 `""`로 전송될 때 UUID 생성기가 정상 동작하도록 보장

---

### 목록 화면 — `cryptoModuleMan.jsp`

#### 버그 수정: 검색 조건 누락

**원인**
- 공통 함수 `getSearchForJqgrid()`는 `name^=search` 패턴 필드만 자동 수집
- `algType`, `keySourceType`, `useYn`은 해당 패턴이 아니어서 검색 버튼 클릭 시 postData에서 누락

**수정 내용**
- 검색 버튼 클릭 핸들러에서 세 필드를 명시적으로 postData에 추가

```javascript
var postData = getSearchForJqgrid("cmd", "LIST");
postData['algType']       = $('select[name=algType]').val();
postData['keySourceType'] = $('select[name=keySourceType]').val();
postData['useYn']         = $('select[name=useYn]').val();
```

---

### 상세 화면 — `cryptoModuleManDetail.jsp`

#### 기능 추가 1: 텍스트 → HEX 변환 보조 입력 + 키 길이 표시

**배경**
- AES/ARIA 암호화 키, 복호화 키, IV를 HEX 값으로 직접 입력하는 것은 불편
- 단, HEX → 텍스트 역변환이 항상 가능하지 않음 (랜덤 바이트 키는 유효하지 않은 UTF-8 시퀀스 포함 가능)
- 텍스트 변환 기능은 개발/테스트 편의용, 운영 환경에서는 랜덤 키 생성 권장

**추가 내용**
- `encKeyHex`, `decKeyHex`, `ivHex` 각 필드에 텍스트 입력 보조 필드 추가
  - 텍스트 입력 시 `TextEncoder`(UTF-8)로 HEX 자동 변환 → HEX 필드에 반영
  - 보조 입력 필드는 `name` 속성 없음 → form submit에 포함되지 않음
- HEX 필드 옆에 키 길이 실시간 표시 (`N bytes (M자)` 형식)
  - HEX 직접 입력 시 및 조회 시에도 즉시 반영
  - 참고 기준: AES-128: 16bytes / AES-192: 24bytes / AES-256: 32bytes

**추가 함수**
```javascript
textToHex(text)           // TextEncoder UTF-8 기반 HEX 변환
updateHexFromText(...)    // 텍스트 입력 → HEX 필드 갱신 + 길이 표시
updateHexLength(hex, id)  // HEX 문자열 길이 계산 및 표시
```

#### 기능 추가 2: 수정자 / 수정일시 정보 표시

- 테이블 하단에 수정자/수정일시 행 추가 (read-only `<span>` 표시)
- 신규 등록 화면: 행 숨김 (`display:none`)
- 상세 조회 화면: 값이 있을 때만 행 표시
- `MODIFIED_AT` 포맷: `LocalDateTime.toString()` 결과의 `T` → 공백 치환 (`2026-05-07 09:30:00`)

---

## 주요 설계 결정

### `getById()` vs `findById()`
이 프로젝트에서 `AbstractDataService.getById()`는 `getReferenceById()`를 래핑한다.
`AbstractEntity`가 `Persistable<isNew>`를 구현하므로, lazy proxy 상태에서는 `isNew = true`가 유지되어 `save()` 시 `persist()`가 호출되는 문제가 있다.
**수정/조회 후 저장이 필요한 경우 반드시 `findById()`를 사용해야 한다.**

---

## 미완료 / 다음 작업

- [ ] 관리자 메뉴 테이블에 경로 등록 (`/onl/admin/security/cryptoModuleMan.view`)
- [ ] 화면 접근 권한(ACL) 등록
- [ ] 전체 파일 커밋 (eapim-admin + eapim-online 양쪽)
