9ce6a897a8
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
[기획서] 바로빌 API 기반 멀티테넌시 회계 지원 솔루션
1. 프로젝트 개요
- 목적: 바로빌(Barobill) API를 활용한 멀티테넌시 환경의 회계 자동화 시스템 구축
- 주요 기능:
- API 기반 회원사 가입 및 관리
- 공인인증서 플러그인 연동
- 전자세금계산서 발행 및 관리
- 카드 내역 및 계좌 거래 내역 실시간 조회
2. 통합 워크플로우 (Workflow)
2.1 회원 온보딩 프로세스
- 회원 가입: 솔루션 내에서 사업자 정보 입력 -> 바로빌
RegistCorpAPI 호출 -> 연동키 발급 및 DB 저장. - 인증서 등록: 바로빌 전용 플러그인 호출 -> 사용자 인증서 선택 및 서명 -> 바로빌 보안 서버로 인증서 전송.
- 연동 확인: 등록 완료 후 솔루션 내에서 연동 상태 '활성(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)
- 화면 설계서(Wireframe): 각 단계별 UI 레이아웃 확정.
- API 매핑 상세: 솔루션 필드와 바로빌 파라미터 1:1 매칭 테이블 작성.
- DB 스키마 설계: 테넌트 및 금융 데이터 저장을 위한 ERD 작성.