# 바로빌 전체 서비스 이관 계획

> **작성일**: 2026-03-22
> **상태**: 이관 진행 중
> **담당**: R&D실

---

## 1. 개요

### 1.1 목적

MNG의 바로빌 관련 **전체** 회계/통신 기능을 API+React 서비스로 이관한다. 기존 출시 계획(`barobill-service-launch-plan.md`)은 Phase 1~4 로드맵이며, 이 문서는 **MNG 코드 단위의 상세 이관 추적**에 집중한다.

### 1.2 이관 원칙

```
✅ MNG 코드는 수정/삭제하지 않는다 (독립 운영 유지)
✅ API에 독립적으로 새로 구현한다 (SOAP 포함)
✅ 같은 DB(samdb)를 공유하되, 각각 독립 SOAP 호출
✅ 멀티테넌트(tenant_id) 격리 필수
```

---

## 2. 이관 현황 요약

### 2.1 영역별 상태

| # | 영역 | MNG | API | 상태 | 우선순위 |
|---|------|:---:|:---:|:----:|:--------:|
| 1 | SOAP 연동 서비스 (BarobillSoapService) | ✅ 1,761줄 | ✅ 57개 메서드 | ✅ 완료 | — |
| 2 | 바로빌 설정 (Config/Setting) | ✅ | ✅ BarobillSettingController | ✅ 완료 | — |
| 3 | 회원사 관리 (Member) | ✅ 32.6KB | ✅ BarobillSyncController | ✅ 완료 | — |
| 4 | 계좌 조회 (EAccount) | ✅ 83.8KB | ✅ BankTransaction + SyncService | ✅ 완료 | — |
| 5 | 카드 조회 (ECard) | ✅ 91.2KB | ✅ CardTransaction + SyncService | ✅ 완료 | — |
| 6 | 홈택스 매입/매출 (Hometax) | ✅ 79.7KB | ✅ HometaxInvoice + SyncService | ✅ 완료 | — |
| 7 | 자동 동기화 스케줄러 | ✅ (MNG 크론) | ✅ SyncBarobillDataJob | ✅ 완료 | — |
| 8 | **전자세금계산서 발행 (ETax)** | ✅ EtaxController | ⚠️ TaxInvoice 모델/CRUD만 | **P1** | 1순위 |
| 9 | **카카오톡 발송** | ✅ KakaotalkController 14.5KB | ❌ 미구현 | **P2** | 2순위 |
| 10 | **SMS 발송** | ✅ SmsController | ❌ 미구현 | **P2** | 2순위 |
| 11 | **구독/과금 비즈니스 로직** | ✅ BillingService 8.4KB | ⚠️ 모델만 존재 | **P3** | 3순위 |
| 12 | **사용량 관리** | ✅ UsageService 9.6KB + Controller | ❌ 미구현 | **P3** | 3순위 |

### 2.2 구현율

```
완료:  7/12 영역 (58%)  — SOAP, 설정, 회원, 계좌, 카드, 홈택스, 스케줄러
부분:  2/12 영역 (17%)  — 세금계산서 발행, 구독/과금
미착수: 3/12 영역 (25%)  — 카카오톡, SMS, 사용량
```

---

## 3. P1: 전자세금계산서 발행 완성 (1순위)

### 3.1 현재 상태

**API에 있는 것:**
- `TaxInvoice` 모델 + 마이그레이션
- `TaxInvoiceController` — CRUD, 발행/취소, 상태조회, 일괄발행 라우트
- `TaxInvoiceService` — 기본 서비스
- `BarobillSoapService` — TI.asmx SOAP 3개 메서드 (URL 조회용)

**MNG에 있는 것 (이관 대상):**
- `EtaxController` — SOAP TI.asmx 직접 호출로 세금계산서 작성/발행/수정/취소
- 바로빌 발행 상태 추적 (국세청 전송 포함)
- 승인번호 조회, 발급 상태 확인

### 3.2 이관 작업 목록

| # | 작업 | 상세 | 파일 |
|---|------|------|------|
| 8-1 | SOAP 발행 메서드 추가 | `BarobillSoapService`에 `issueTaxInvoice()`, `cancelTaxInvoice()`, `getInvoiceStatus()` 등 | `api/Services/Barobill/BarobillSoapService.php` |
| 8-2 | TaxInvoiceService 보강 | 바로빌 SOAP 발행 연동, 상태 동기화 | `api/Services/TaxInvoiceService.php` |
| 8-3 | 발행 워크플로우 구현 | 임시저장→발행→국세청전송→완료 상태 관리 | `api/Controllers/Api/V1/TaxInvoiceController.php` |
| 8-4 | 수정세금계산서 지원 | 수정 사유 코드, 원본 참조 | TaxInvoice 모델 보강 |

### 3.3 MNG 참조 파일

```
mng/app/Http/Controllers/Barobill/EtaxController.php
mng/app/Services/Barobill/BarobillService.php (TI 관련 메서드)
```

---

## 4. P2: 카카오톡/SMS 발송 (2순위)

### 4.1 현재 상태

**API BarobillSoapService에 SOAP 메서드 구현 완료:**
- 카카오톡: 15개 메서드 (채널, 템플릿, 알림톡, 친구톡, 결과조회, 예약취소)
- SMS: 4개 메서드 (발송, 발신번호 확인/목록, 상태조회)

**미구현:** Controller, Service, Route

### 4.2 이관 작업 목록

| # | 작업 | 상세 |
|---|------|------|
| 9-1 | KakaotalkController 생성 | 채널/템플릿 조회, 발송, 이력, 예약취소 API |
| 9-2 | KakaotalkService 생성 | 발송 로직, 이력 저장, 예약 관리 |
| 9-3 | SmsController 생성 | 발송, 발신번호 관리, 상태 조회 API |
| 9-4 | SmsService 생성 | 발송 로직, 이력 관리 |
| 9-5 | Route 등록 | `routes/api/v1/finance.php`에 추가 |
| 9-6 | 발송 이력 테이블 (선택) | 발송 기록 저장 필요 시 마이그레이션 |

### 4.3 MNG 참조 파일

```
mng/app/Http/Controllers/Barobill/KakaotalkController.php   (14.5KB)
mng/app/Http/Controllers/Barobill/SmsController.php
mng/app/Http/Controllers/Api/Admin/Barobill/BarobillKakaotalkController.php
mng/app/Http/Controllers/Api/Admin/Barobill/BarobillSmsController.php
```

### 4.4 MNG 엔드포인트 → API 매핑

**카카오톡:**

| MNG 엔드포인트 | API 대응 | 상태 |
|---------------|---------|:----:|
| `GET /api/admin/barobill/kakaotalk/channels` | `GET /v1/barobill/kakaotalk/channels` | ❌ |
| `GET /api/admin/barobill/kakaotalk/channels/management-url` | `GET /v1/barobill/kakaotalk/channels/management-url` | ❌ |
| `GET /api/admin/barobill/kakaotalk/templates` | `GET /v1/barobill/kakaotalk/templates` | ❌ |
| `POST /api/admin/barobill/kakaotalk/send` | `POST /v1/barobill/kakaotalk/send` | ❌ |
| `GET /api/admin/barobill/kakaotalk/send-history` | `GET /v1/barobill/kakaotalk/history` | ❌ |
| `DELETE /api/admin/barobill/kakaotalk/send/{sendKey}/cancel` | `DELETE /v1/barobill/kakaotalk/{sendKey}` | ❌ |

**SMS:**

| MNG 엔드포인트 | API 대응 | 상태 |
|---------------|---------|:----:|
| `POST /api/admin/barobill/sms/send` | `POST /v1/barobill/sms/send` | ❌ |
| `GET /api/admin/barobill/sms/from-numbers` | `GET /v1/barobill/sms/from-numbers` | ❌ |
| `POST /api/admin/barobill/sms/check-from-number` | `POST /v1/barobill/sms/check-from-number` | ❌ |
| `GET /api/admin/barobill/sms/send-state/{sendKey}` | `GET /v1/barobill/sms/{sendKey}/status` | ❌ |

---

## 5. P3: 구독/과금/사용량 (3순위)

### 5.1 현재 상태

**API에 있는 것 (모델/마이그레이션만):**
- `BarobillSubscription` — 월정액 구독
- `BarobillBillingRecord` — 과금 기록
- `BarobillMonthlySummary` — 월별 요약
- `BarobillPricingPolicy` — 가격 정책

**미구현:** Controller, Service (비즈니스 로직)

### 5.2 이관 작업 목록

| # | 작업 | 상세 |
|---|------|------|
| 11-1 | BillingService 생성 | 구독 CRUD, 월별 과금 처리, 사용량 기반 과금 |
| 11-2 | BillingController 생성 | 구독 관리, 과금 기록 조회, 요약 |
| 11-3 | UsageService 생성 | 서비스별 사용량 집계, 통계 |
| 11-4 | UsageController 생성 | 사용량 목록, 통계, 내보내기 |
| 11-5 | 월별 과금 배치 Job | 매월 1일 자동 과금 처리 |
| 11-6 | Route 등록 | admin 영역 또는 v1 영역 |

### 5.3 MNG 참조 파일

```
mng/app/Services/Barobill/BarobillBillingService.php   (8.4KB)
mng/app/Services/Barobill/BarobillUsageService.php     (9.6KB → 실제 13.95KB)
mng/app/Http/Controllers/Api/Admin/Barobill/BarobillBillingController.php  (15.2KB)
mng/app/Http/Controllers/Api/Admin/Barobill/BarobillUsageController.php    (9.6KB)
```

---

## 6. 코드 매핑 전체표

### 6.1 MNG → API 파일 대응

| MNG 파일 | API 파일 | 상태 |
|----------|---------|:----:|
| **Services** | | |
| `Services/Barobill/BarobillService.php` (1,761줄) | `Services/Barobill/BarobillSoapService.php` | ✅ |
| `Services/Barobill/BarobillBankSyncService.php` | `Services/Barobill/BarobillBankSyncService.php` | ✅ |
| `Services/Barobill/BarobillCardSyncService.php` | `Services/Barobill/BarobillCardSyncService.php` | ✅ |
| `Services/Barobill/HometaxSyncService.php` | `Services/Barobill/HometaxSyncService.php` | ✅ |
| `Services/Barobill/BarobillBillingService.php` | — | ❌ P3 |
| `Services/Barobill/BarobillUsageService.php` | — | ❌ P3 |
| **Controllers (Web)** | | |
| `Controllers/Barobill/EaccountController.php` | `Controllers/Api/V1/BarobillBankTransactionController.php` | ✅ |
| `Controllers/Barobill/EcardController.php` | `Controllers/Api/V1/BarobillCardTransactionController.php` | ✅ |
| `Controllers/Barobill/HometaxController.php` | `Controllers/Api/V1/HometaxInvoiceController.php` | ✅ |
| `Controllers/Barobill/EtaxController.php` | `Controllers/Api/V1/TaxInvoiceController.php` | ⚠️ P1 |
| `Controllers/Barobill/KakaotalkController.php` | — | ❌ P2 |
| `Controllers/Barobill/SmsController.php` | — | ❌ P2 |
| `Controllers/Barobill/BarobillController.php` | `Controllers/Api/V1/BarobillController.php` | ✅ |
| **Controllers (Admin API)** | | |
| `Api/Admin/Barobill/BarobillConfigController.php` | `Controllers/Api/V1/BarobillSettingController.php` | ✅ |
| `Api/Admin/Barobill/BarobillMemberController.php` | `Controllers/Api/V1/BarobillSyncController.php` | ✅ |
| `Api/Admin/Barobill/BarobillSettingController.php` | `Controllers/Api/V1/BarobillSettingController.php` | ✅ |
| `Api/Admin/Barobill/BarobillBillingController.php` | — | ❌ P3 |
| `Api/Admin/Barobill/BarobillUsageController.php` | — | ❌ P3 |
| `Api/Admin/Barobill/BarobillKakaotalkController.php` | — | ❌ P2 |
| `Api/Admin/Barobill/BarobillSmsController.php` | — | ❌ P2 |
| **Models (18개)** | | |
| `Models/Barobill/*` (18개) | `Models/Barobill/*` (17개) + `Models/Tenants/BarobillSetting` | ✅ |

### 6.2 SOAP 메서드 구현율

| 카테고리 | MNG | API | 구현율 | 비고 |
|---------|:---:|:---:|:------:|------|
| CORPSTATE (회원관리) | 3 | 3 | 100% | ✅ |
| BANKACCOUNT (계좌) | 13 | 14 | 100%+ | ✅ |
| CARD (카드) | 11 | 11 | 100% | ✅ |
| TI (세금계산서) | 3 | 3 | 100% | ⚠️ URL 조회만, 발행 로직 P1 |
| KAKAOTALK (카카오톡) | 15 | 15 | 100% | ❌ Controller 미구현 P2 |
| SMS (문자) | 4 | 4 | 100% | ❌ Controller 미구현 P2 |
| **합계** | **49** | **50** | **100%** | SOAP은 완료, Controller/Route가 부족 |

---

## 7. 작업 순서

### Phase A: P1 — 세금계산서 발행 (즉시)

```
1. MNG EtaxController 분석 → SOAP 발행 메서드 파악
2. BarobillSoapService에 TI 발행/취소/상태 메서드 추가
3. TaxInvoiceService에 바로빌 발행 연동 구현
4. TaxInvoiceController 발행/취소 액션 완성
5. 테스트 (테스트 모드)
```

### Phase B: P2 — 카카오톡/SMS (P1 완료 후)

```
1. KakaotalkController + KakaotalkService 생성
2. SmsController + SmsService 생성
3. Route 등록
4. 발송 이력 테이블 필요 시 마이그레이션
5. 테스트
```

### Phase C: P3 — 구독/과금/사용량 (P2 완료 후)

```
1. BillingService + BillingController 생성
2. UsageService + UsageController 생성
3. 월별 과금 배치 Job 생성
4. Route 등록
5. 테스트
```

---

## 8. 진행 기록

| 날짜 | 작업 | 결과 |
|------|------|------|
| 2026-03-22 | 전체 이관 현황 조사 및 문서화 | 이 문서 작성 |

---

## 관련 문서

| 문서 | 설명 |
|------|------|
| [바로빌 연동 시스템](../../features/barobill/README.md) | 전체 구조, 모드, 과금, 멀티테넌트 |
| [바로빌 API SOAP 참조](../../features/barobill/api-soap-reference.md) | SOAP 57개 메서드, 동기화, MNG 대응표 |
| [바로빌 출시 계획](./barobill-service-launch-plan.md) | 4단계 출시 로드맵 |
| [바로빌 회계 API 명세](../../frontend/api-specs/barobill-api.md) | REST API 42개 엔드포인트 |
| [이관 현황](../../system/migration-status.md) | MNG→API+React 전체 이관 현황 |

---

**최종 업데이트**: 2026-03-22