docs: [barobill] 이관 완료 반영 (README 현황 업데이트, migration-status 70%→95%)

This commit is contained in:
김보곤
2026-03-22 20:26:41 +09:00
parent 492de0ad93
commit fc55d51c98
2 changed files with 60 additions and 32 deletions

View File

@@ -1,7 +1,7 @@
# 바로빌(Barobill) 연동 시스템
> **작성일**: 2026-03-17
> **상태**: MNG 운영 중 / 서비스 이관 준비
> **상태**: API 이관 완료 (12/12 영역) / React UI 미구현
---
@@ -15,15 +15,19 @@
| 항목 | MNG (백오피스) | API (서비스) | React (프론트) |
|------|:------------:|:----------:|:------------:|
| SOAP 연동 서비스 | ✅ 완료 (1,761줄) | 기본 설정만 | — |
| 회원사 관리 | ✅ 운영 중 | 모델만 존재 | 설정 페이지 |
| SOAP 연동 서비스 | ✅ 운영 중 (1,761줄) | ✅ BarobillSoapService (57개 메서드) | — |
| 회원사 관리 | ✅ 운영 중 | ✅ BarobillSyncController | 설정 페이지 |
| 카드 거래 조회 | ✅ 운영 중 | ✅ REST API 16개 | — |
| 은행 거래 조회 | ✅ 운영 중 | ✅ REST API 13개 | — |
| 홈택스 세금계산서 | ✅ 운영 중 | ✅ REST API 13개 | — |
| 카카오톡/SMS | ✅ 운영 중 | | — |
| 과금 시스템 | ✅ 구현 완료 | — | — |
| 전자세금계산서 발행 | ✅ 운영 중 | ✅ TaxInvoiceController (16 EP) | — |
| 카카오톡 발송 | ✅ 운영 중 | ✅ BarobillKakaotalkController (12 EP) | — |
| SMS 발송 | ✅ 운영 중 | ✅ BarobillSmsController (4 EP) | — |
| 구독/과금 관리 | ✅ 운영 중 | ✅ BarobillBillingController (9 EP) | — |
| 사용량 관리 | ✅ 운영 중 | ✅ BarobillUsageController (4 EP) | — |
| 자동 동기화 | ✅ MNG 크론 | ✅ SyncBarobillDataJob | — |
> **핵심**: tenant_id=1 (코드브릿지엑스 본사)에서 실무 운영 중. 서비스 이관 시 멀티테넌트 SOAP 연동이 핵심 과제.
> **2026-03-22**: MNG 바로빌 전체 기능의 API 이관 완료 (12/12 영역). React UI 구현은 Phase 2에서 진행 예정.
### 1.3 바로빌 공식 자료
@@ -286,11 +290,30 @@ tenant_id=N (고객사) → 해당 고객사 데이터만 접근
| 유형 | 경로 |
|------|------|
| 서비스 | `app/Services/BarobillService.php` (기본 설정만) |
| 모델 | `app/Models/Barobill/` (15개) |
| 모델 | `app/Models/Tenants/BarobillSetting.php` |
| 컨트롤러 | `app/Http/Controllers/Api/V1/Barobill*Controller.php` |
| 마이그레이션 | `database/migrations/` (19개 바로빌 관련) |
| SOAP 서비스 | `app/Services/Barobill/BarobillSoapService.php` (57개 SOAP 메서드) |
| 동기화 서비스 | `app/Services/Barobill/BarobillBankSyncService.php` |
| 동기화 서비스 | `app/Services/Barobill/BarobillCardSyncService.php` |
| 동기화 서비스 | `app/Services/Barobill/HometaxSyncService.php` |
| 과금 서비스 | `app/Services/Barobill/BarobillBillingService.php` |
| 사용량 서비스 | `app/Services/Barobill/BarobillUsageService.php` |
| 세금계산서 서비스 | `app/Services/BarobillService.php` (발행/취소/상태) |
| 세금계산서 서비스 | `app/Services/TaxInvoiceService.php` |
| 모델 | `app/Models/Barobill/` (17개) |
| 모델 | `app/Models/Tenants/BarobillSetting.php`, `TaxInvoice.php` |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillController.php` (연동 현황) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillSyncController.php` (동기화/회원) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillSettingController.php` (설정) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillCardTransactionController.php` (카드 16 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillBankTransactionController.php` (은행 13 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/HometaxInvoiceController.php` (홈택스 13 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/TaxInvoiceController.php` (세금계산서 16 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillKakaotalkController.php` (카카오톡 12 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillSmsController.php` (SMS 4 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillBillingController.php` (과금 9 EP) |
| 컨트롤러 | `app/Http/Controllers/Api/V1/BarobillUsageController.php` (사용량 4 EP) |
| 스케줄러 | `app/Jobs/Barobill/SyncBarobillDataJob.php` |
| 라우트 | `routes/api/v1/finance.php` |
| 마이그레이션 | `database/migrations/` (30개 바로빌 관련) |
### 6.3 React (`/home/aweso/sam/react`)
@@ -357,29 +380,33 @@ tenant_id=N (고객사) → 해당 고객사 데이터만 접근
---
## 9. 서비스 이관 계획
## 9. 서비스 이관 현황
### 9.1 이관 범위
### 9.1 API 이관 완료 (2026-03-22)
| 기능 | MNG (현재) | API 이관 | React 이관 | 우선순위 |
|------|:---------:|:-------:|:---------:|:-------:|
| SOAP 연동 서비스 | ✅ | 🔴 필수 | — | P1 |
| 회원사 등록/관리 | ✅ | 🔴 필수 | 🔴 필수 | P1 |
| 테스트/운영 모드 전환 | ✅ | 🔴 필수 | 🟡 관리자 | P1 |
| 카드 거래 동기화 | ✅ | 🟡 중요 | ✅ 완료 | P2 |
| 은행 거래 동기화 | ✅ | 🟡 중요 | — | P2 |
| 홈택스 동기화 | ✅ | 🟡 중요 | — | P2 |
| 세금계산서 발행 | ✅ | 🟡 중요 | 🟡 중요 | P2 |
| 과금 시스템 | ✅ | 🟢 권장 | 🟢 권장 | P3 |
| 카카오톡/SMS | ✅ | 🟢 권장 | — | P3 |
| 기능 | MNG | API 이관 | React 이관 |
|------|:---:|:-------:|:---------:|
| SOAP 연동 서비스 (57개 메서드) | ✅ | ✅ 완료 | — |
| 회원사 등록/관리 | ✅ | ✅ 완료 | 설정 페이지 |
| 테스트/운영 모드 전환 | ✅ | ✅ 완료 | — |
| 카드 거래 동기화 + 조회 | ✅ | ✅ 완료 (16 EP) | — |
| 은행 거래 동기화 + 조회 | ✅ | ✅ 완료 (13 EP) | |
| 홈택스 동기화 + 조회 | ✅ | ✅ 완료 (13 EP) | |
| 세금계산서 발행/취소/상태 | ✅ | ✅ 완료 (16 EP) | |
| 카카오톡 발송 | ✅ | ✅ 완료 (12 EP) | |
| SMS 발송 | ✅ | ✅ 완료 (4 EP) | |
| 구독/과금 관리 | ✅ | ✅ 완료 (9 EP) | — |
| 사용량 관리 | ✅ | ✅ 완료 (4 EP) | — |
| 자동 동기화 스케줄러 | ✅ | ✅ 완료 | — |
### 9.2 이관 시 핵심 과제
> **다음 단계**: React UI 구현 (Phase 2). 상세 계획은 [바로빌 출시 계획](../../dev/dev_plans/barobill-service-launch-plan.md) 참조.
1. **SOAP 서비스 이관**: MNG의 `BarobillService` (1,761줄)를 API로 이동
2. **멀티테넌트 CERTKEY**: 테넌트별로 바로빌 파트너 계약이 필요한지, 공용 CERTKEY로 처리 가능한지 확인
3. **테스트 모드 관리**: 신규 테넌트는 테스트 모드로 시작 → 관리자가 운영 모드로 전환
4. **동기화 스케줄러**: MNG에서 실행 중인 은행/카드/홈택스 동기화를 API Queue로 이관
5. **인증서 관리**: 공동인증서 등록 URL을 테넌트 사용자에게 제공하는 플로우
### 9.2 남은 과제 (출시 전)
1. **멀티테넌트 CERTKEY**: 테넌트별로 바로빌 파트너 계약이 필요한지, 공용 CERTKEY로 처리 가능한지 확인
2. **테스트 모드 관리**: 신규 테넌트는 테스트 모드로 시작 → 관리자가 운영 모드로 전환
3. **인증서 관리**: 공동인증서 등록 URL을 테넌트 사용자에게 제공하는 플로우
4. **React UI 구현**: 계좌/카드/홈택스/세금계산서 조회 화면
---
@@ -392,7 +419,8 @@ tenant_id=N (고객사) → 해당 고객사 데이터만 접근
| [바로빌 회원 마이그레이션](../../dev/guides/barobill-members-migration.md) | 회원 데이터 이관 가이드 |
| [바로빌 카카오톡](../barobill-kakaotalk/README.md) | 카카오톡 알림톡 연동 |
| [재무관리](../finance/README.md) | 재무/자금관리 전체 개요 |
| [전체 이관 추적](../../dev/dev_plans/barobill-full-migration-plan.md) | MNG→API 12개 영역 코드 매핑, 이관 진행 기록 |
---
**최종 업데이트**: 2026-03-17
**최종 업데이트**: 2026-03-22

View File

@@ -60,7 +60,7 @@ API + React 모두 구현 완료된 기능이다.
| 설계/BOM | 75% | 모델 버전, 계산 엔진 |
| 대시보드 | 90% | CEO 포함 5가지 타입 |
| 현장관리 (Site) | 75% | 현장설명회, 계약 |
| 바로빌 (기본) | 70% | 카드/계좌 연동 |
| 바로빌 | 95% | API 전체 이관 완료 (12/12), React UI 미구현 |
---