바로빌 기획서 추가

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

barobill/planning.md

@@ -0,0 +1,64 @@
+# [기획서] 바로빌 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 작성.

index.php

@@ -201,6 +201,9 @@
                              <a href="Requestforcorrection/index.php" class="block px-4 py-2 text-sm text-slate-700 hover:bg-brand-50 hover:text-brand-600 font-medium">
                                  경정청구 소개
                              </a>
+                             <a href="barobill/index.php" class="block px-4 py-2 text-sm text-slate-700 hover:bg-brand-50 hover:text-brand-600 font-medium">
+                                 바로빌 API 통합기획서
+                             </a>
                              <a href="corp/kodata.php" class="block px-4 py-2 text-sm text-slate-700 hover:bg-brand-50 hover:text-brand-600 font-medium">
                                  기업분석 한국평가데이터 (kodata)
                              </a>