From fc55d51c98f358718deeed81e8f2229f075ce636 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Sun, 22 Mar 2026 20:26:41 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[barobill]=20=EC=9D=B4=EA=B4=80=20?= =?UTF-8?q?=EC=99=84=EB=A3=8C=20=EB=B0=98=EC=98=81=20(README=20=ED=98=84?= =?UTF-8?q?=ED=99=A9=20=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8,=20migration-s?= =?UTF-8?q?tatus=2070%=E2=86=9295%)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- features/barobill/README.md | 90 ++++++++++++++++++++++++------------- system/migration-status.md | 2 +- 2 files changed, 60 insertions(+), 32 deletions(-) diff --git a/features/barobill/README.md b/features/barobill/README.md index c89f942..5318990 100644 --- a/features/barobill/README.md +++ b/features/barobill/README.md @@ -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 diff --git a/system/migration-status.md b/system/migration-status.md index 32b2b69..d897ca7 100644 --- a/system/migration-status.md +++ b/system/migration-status.md @@ -60,7 +60,7 @@ API + React 모두 구현 완료된 기능이다. | 설계/BOM | 75% | 모델 버전, 계산 엔진 | | 대시보드 | 90% | CEO 포함 5가지 타입 | | 현장관리 (Site) | 75% | 현장설명회, 계약 | -| 바로빌 (기본) | 70% | 카드/계좌 연동 | +| 바로빌 | 95% | API 전체 이관 완료 (12/12), React UI 미구현 | ---