docs: add project docs and test updates

docs/보안관련/03-개인정보_암호화.md

@@ -0,0 +1,73 @@
+# 개인정보 암호화 (전화번호·이메일 등)
+
+> 비밀번호는 해시(일방향), 전화번호·이메일 등은 **암호화(양방향)** 로 저장해, 키가 없으면 개발자도 복호화할 수 없게 하는 방법.
+
+---
+
+## 1. 해시 vs 암호화
+
+| 구분 | 비밀번호 | 전화번호·이메일 등 |
+|------|----------|---------------------|
+| **목적** | 로그인 시 “같은지”만 검사 | 화면·연락에 **다시 읽어서** 써야 함 |
+| **방식** | 해시(일방향) | 암호화(양방향) |
+| **저장** | 해시만 저장 | 암호문 저장, **키**로 복호화 |
+
+그래서 개인정보는 **암호화**해서 저장하고, 읽을 때만 **복호화**합니다.
+
+---
+
+## 2. “개발자가 해독할 수 없게” 하려면
+
+- 암호화/복호화는 **키(비밀키)** 로 합니다.
+- 키를 **앱/코드 밖**에 두면, 코드를 아는 개발자라도 키가 없으면 복호화할 수 없습니다.
+
+**권장:**
+
+- **암호화 키**를 `.env`(또는 환경 변수)에만 넣고, **저장소에는 올리지 않음** (`.env`는 `.gitignore`).
+- 운영 서버에서는 서버만 갖는 키를 두고, 개발 PC에는 키를 두지 않거나 테스트용 키만 둠.
+- 필요하면 AWS KMS, HashiCorp Vault 등 **키 관리 서비스**로 키를 분리할 수 있습니다.
+
+이렇게 하면 “키가 없는 사람(예: 코드만 본 개발자)”은 DB에 저장된 암호문을 풀 수 없습니다.
+
+---
+
+## 3. 이 프로젝트에서의 구현 개요
+
+- **대상 필드**: `member.mb_phone`, `member.mb_email` (선택: `mb_name`)
+- **방식**: 저장 전 암호화, 조회 후 복호화. CI4 `Encryption`(OpenSSL) 사용.
+- **키**: `app/Config/Encryption.php` → `.env`의 `encryption.key`. 키가 비어 있으면 암호화/복호화를 건너뛰어 기존 평문 데이터와 호환.
+- **저장 형식**: 암호문 앞에 `ENC:` 접두어를 붙여 “암호화된 값”인지 구분. 기존 평문 데이터는 그대로 두고, 새로 넣거나 수정할 때만 암호화해 저장.
+
+---
+
+## 4. 키 설정 방법
+
+1. **키 생성** (32바이트):
+   ```bash
+   php -r "echo bin2hex(random_bytes(32));"
+   ```
+2. **.env**에 추가 (저장소에 커밋하지 않음):
+   ```
+   encryption.key = 위에서 나온 64자 hex 문자열
+   ```
+3. `app/Config/Encryption.php`에서 `$key`가 환경 변수에서 오도록 설정했는지 확인. (기본값은 빈 문자열이고, `.env`에서 덮어쓰면 됨.)
+
+키를 넣지 않으면 암호화/복호화가 동작하지 않고, 값은 평문으로 저장·조회됩니다.
+
+---
+
+## 5. 구현 요약 (이 프로젝트)
+
+- **헬퍼**: `app/Helpers/pii_encryption_helper.php` — `pii_encrypt($value)`, `pii_decrypt($value)`
+- **대상 필드**: `member.mb_phone`, `member.mb_email` (상수 `PII_ENCRYPTED_FIELDS`)
+- **저장 형식**: 암호화 시 `ENC:` + base64(암호문). 미암호화(키 없음) 또는 기존 평문은 그대로 저장·조회.
+- **사용처**: `Auth::register` 저장 전 암호화, `Admin\User::store` / `update` 저장 전 암호화, `Admin\User::index` / `edit` 조회 후 복호화.
+- **설정**: `app/Config/Encryption.php` — `.env`의 `encryption.key`(64자 hex)를 읽어 사용. 키가 없으면 암호화/복호화 생략.
+
+---
+
+## 6. 정리
+
+- 전화번호·이메일 등은 **암호화**해서 저장하고, **키**로만 복호화합니다.
+- 키를 **코드/저장소 밖**(`.env`·키 관리 서비스)에 두면, **개발자가 해독할 수 없게** 할 수 있습니다.
+- 비밀번호는 계속 **해시만** 저장하고, 개인정보 필드만 암호화하는 방식이 적절합니다.