# [기획서] 바로빌 API 기반 멀티테넌시 회계 지원 솔루션

## 1. 프로젝트 개요

- **목적**: 바로빌(Barobill) API를 활용한 멀티테넌시 환경의 회계 자동화 시스템 구축
- **주요 기능**:
  - API 기반 회원사 가입 및 관리
  - 공인인증서 플러그인 연동
  - 전자세금계산서 발행 및 관리
  - 카드 내역 및 계좌 거래 내역 실시간 조회

---

## 2. 통합 워크플로우 (Workflow)

### 2.1 회원 온보딩 프로세스

1. **회원 가입**: 솔루션 내에서 사업자 정보 입력 -> 바로빌 `RegistCorp` API 호출 -> 연동키 발급 및 DB 저장.
2. **인증서 등록**: 바로빌 전용 플러그인 호출 -> 사용자 인증서 선택 및 서명 -> 바로빌 보안 서버로 인증서 전송.
3. **연동 확인**: 등록 완료 후 솔루션 내에서 연동 상태 '활성(Active)'으로 변경.

### 2.2 서비스 이용 프로세스

- **전자세금계산서**: 매출 데이터 생성 -> `RegistTaxInvoice` 호출 -> 국세청 전송 및 상태 모니터링.
- **금융 데이터 수집**:
  - **카드**: 카드 정보 등록 -> `GetCardLog` 호출 -> 지출 내역 스크래핑 및 장부 기록.
  - **계좌**: 계좌 연결 -> `GetBankAccountLog` 호출 -> 입출금 내역 동기화 및 미수금 대조.

---

## 3. 메뉴 구조도 (Information Architecture)

- **대메뉴 1: 대시보드** (회계 요약, 알림)
- **대메뉴 2: 매출/매입 관리**
  - 전자세금계산서 발행/목록
  - 카드 이용 내역
  - 계좌 거래 내역
- **대메뉴 3: 설정 및 연동**
  - 회사 정보 관리
  - 바로빌 연동 설정 (인증서 관리)
  - 사용자 권한 설정

---

## 4. 멀티테넌시 데이터 관리 전략

### 4.1 데이터 격리 (Data Isolation)

- 모든 테이블에 `TenantID` 또는 `PartnerBarobillID`를 부여하여 회원사 간 데이터 혼선 방지.
- API 호출 시 해당 테넌트의 고유 연동키를 동적으로 매핑.

### 4.2 보안 및 예외 처리

- **인증 보안**: HTTPS 통신 및 바로빌 인증 토큰 기반 보안 강화.
- **오류 대응**: 인증서 만료, API 호출 한도 초과 등에 대한 사용자 알림 로직 구현.
- **로그 관리**: API 요청 및 응답 전문을 로그로 기록하여 이슈 발생 시 추적 가능하도록 설계.

---

## 5. 향후 상세 설계 항목 (Next Steps)

1. **화면 설계서(Wireframe)**: 각 단계별 UI 레이아웃 확정.
2. **API 매핑 상세**: 솔루션 필드와 바로빌 파라미터 1:1 매칭 테이블 작성.
3. **DB 스키마 설계**: 테넌트 및 금융 데이터 저장을 위한 ERD 작성.