sam-docs/dev/dev_plans/barobill-full-migration-plan.md

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

작성일: 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	전체 이관 현황 조사 및 문서화	이 문서 작성

---

관련 문서

문서	설명
바로빌 연동 시스템	전체 구조, 모드, 과금, 멀티테넌트
바로빌 API SOAP 참조	SOAP 57개 메서드, 동기화, MNG 대응표
바로빌 출시 계획	4단계 출시 로드맵
바로빌 회계 API 명세	REST API 42개 엔드포인트
이관 현황	MNG→API+React 전체 이관 현황

---

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