MVP 법인카드 세무항목 매칭 전략

6주 실행 계획

법인카드 내역을 자동으로 세무항목에 매칭하는 핵심 솔루션

바로빌 API 기반 빠른 구현

목표: 6주 안에 실무에서 사용 가능한 법인카드 세무 자동화 시스템 MVP 완성

MVP 철학 및 범위

핵심 원칙

"수작업 70% → 자동화 90%로 세무 업무 효율 극대화"

🎯 MVP 목표

법인카드 내역 자동 수집 및 정규화
룰 기반 세무항목 자동 분류 (정확도 90%)
금전출납부 전표 자동 생성
세무 담당자 검토 시간 단축 (시간 → 분)

✅ MVP 핵심 기능

카드 등록: 법인카드 정보 등록 및 바로빌 연동
내역 수집: 바로빌 API를 통한 자동 수집
룰 기반 분류: 가맹점명 기반 세무항목 자동 매칭
금전출납부 생성: 세무 전표 자동 생성 및 검토

🚫 MVP 범위 밖 (Phase 2)

ML 기반 지능형 분류 엔진
영수증 이미지 OCR 처리
ERP 연동 및 자동 전표 입력
홈택스 신고보조 파일 생성
모바일 앱 및 알림 기능

Week 1-2: 바로빌 연동 및 기반 구축

🏗️ Week 1-2 목표

바로빌 샌드박스 연동 및 핵심 DB 스키마 구축

📋 기획 (Week 1-2)

Week 1: MVP 기능 명세 및 데이터 모델
- 법인카드 내역 수집 플로우 정의
- 세무항목 분류 룰 체계 설계
- 바로빌 카드 API 명세 분석
- 가맹점-세무항목 매핑 전략
Week 2: 룰북 및 테스트 시나리오
- 세무항목 분류 룰북 초안 (50개 가맹점)
- 테스트 시나리오 20개
- 검토 워크플로우 정의

🎨 디자인 (Week 1-2)

Week 1: 디자인 시스템 구축
- 컬러 팔레트 (오렌지/옐로우 계열 - 활력/효율)
- 기본 컴포넌트 (카드 리스트, 테이블)
- 와이어프레임 5개 화면
Week 2: 핵심 화면 디자인
- 카드 등록 및 관리 화면
- 내역 수집 및 분류 화면
- 금전출납부 검토 대시보드

⚙️ 백엔드 (Week 1-2)

Week 1: 바로빌 샌드박스 연동
- 바로빌 카드 API 키 발급
- 카드 등록 API 연동
- PHP 8.2 프로젝트 초기화
- MySQL 8.0 데이터베이스 설정 (SAM 프로젝트 DB)
Week 2: 핵심 DB 스키마 구축
- cards, card_transactions_raw 테이블
- merchants, rules 테이블
- postings, reports_cashbook 테이블
- 카드 내역 수집 스케줄러 설계

💻 프론트엔드 (Week 1-2)

Week 1: 프로젝트 설정
- 기존 jQuery/Bootstrap 활용
- 공통 레이아웃 구성
- Ajax 통신 설정
Week 2: 기본 화면 구현
- 대시보드 레이아웃
- 테이블 컴포넌트 (DataTables)
- 폼 검증 라이브러리

📦 Week 1-2 산출물

MVP 기능 명세서 + 룰북 초안 (기획)
디자인 시스템 + 와이어프레임 (디자인)
바로빌 연동 + DB 스키마 (백엔드)
프로젝트 기반 + 레이아웃 (프론트엔드)

Week 3-4: 수집/정규화/분류 핵심 기능 구현

⚡ Week 3-4 목표

카드 내역 수집, 룰 엔진 구현, 전표 생성 API 완성

📋 기획 (Week 3-4)

Week 3: 룰북 확장 및 정제
- 세무항목 분류 룰 100개로 확장
- 가맹점명 정규화 규칙 정의
- 미분류 건 처리 프로세스
Week 4: QA 준비
- 통합 테스트 시나리오
- 버그 트래킹 시스템
- 사용자 가이드 초안

🎨 디자인 (Week 3-4)

Week 3: 나머지 화면 디자인
- 룰 관리 화면
- 분류 검토 및 수정 화면
- 리포트 대시보드
Week 4: 디자인 QA
- 프론트엔드 구현 리뷰
- 반응형 디자인 검증
- UX 개선사항 반영

⚙️ 백엔드 (Week 3-4)

Week 3: 수집 및 룰 엔진 구현
- 바로빌 카드 내역 수집 API
- 가맹점명 정규화 엔진
- 룰 기반 세무항목 매칭 엔진
- 수집 스케줄러 구현 (일별)
Week 4: 전표 생성 API
- 금전출납부 전표 생성 API
- 분류 검토 및 수정 API
- 리포트 생성 API
- 룰 관리 API (CRUD)

💻 프론트엔드 (Week 3-4)

Week 3: 카드 관리 및 수집 화면
- 카드 등록 및 관리 폼
- 내역 수집 실행 및 모니터링
- 수집 결과 테이블
- 정규화/분류 결과 표시
Week 4: 분류 검토 화면
- 분류 결과 테이블
- 미분류 건 수동 매칭
- 금전출납부 미리보기
- 리포트 대시보드

📦 Week 3-4 산출물

룰북 100개 + 테스트 시나리오 (기획)
전체 화면 디자인 완료 (디자인)
수집·정규화·분류·전표 생성 API (백엔드)
카드 관리 + 분류 검토 화면 (프론트엔드)

Week 5-6: 통합 테스트 및 베타 런칭

🚀 Week 5-6 목표

2개 테넌트 베타, 룰북 튜닝, 리포트 생성, 운영전환

📋 기획 (Week 5-6)

Week 5: 2개 테넌트 베타 테스트
- 실제 법인카드로 샌드박스 테스트
- 수집·분류·전표 생성 E2E 테스트
- 분류 정확도 측정 및 개선
- 버그 우선순위 관리
Week 6: 운영전환 준비
- 최종 테스트 및 검수
- 릴리스 노트 작성
- 운영가이드/감사로그 정비
- Phase 2 백로그 정리

🎨 디자인 (Week 5-6)

Week 5: 디자인 QA
- 크로스 브라우저 테스트
- 모바일 반응형 검증
- 접근성 체크
Week 6: 마케팅 자료
- 제품 스크린샷
- 데모 시나리오
- UI 개선사항 문서화

⚙️ 백엔드 (Week 5-6)

Week 5: 룰북 튜닝 및 리포트 생성
- 베타 피드백 기반 룰북 개선
- 미분류율 감소 (20% → 10%)
- 금전출납부 리포트 생성
- 에러 핸들링 개선
Week 6: 프로덕션 배포
- 프로덕션 환경 설정
- 백업 및 모니터링
- API 문서화
- 보안 점검

💻 프론트엔드 (Week 5-6)

Week 5: 버그 수정 및 최적화
- 통합 테스트 버그 수정
- 성능 최적화
- 로딩 상태 및 에러 처리
Week 6: 최종 점검 및 배포
- 브라우저 호환성 검증
- 배포 및 모니터링
- 사용자 매뉴얼 배포

📦 Week 5-6 산출물

베타 테스트 리포트 + 릴리스 노트 (기획)
마케팅 자료 + UI 문서 (디자인)
프로덕션 API + 모니터링 (백엔드)
배포된 프로덕션 웹앱 (프론트엔드)

성공 지표 및 완료 기준

MVP 완료 정의

"2개 테넌트가 실제 법인카드 내역을 수집하고 90% 이상 자동 분류하여 금전출납부 생성"

✅ 필수 완료 항목

항목	완료 기준	검증 방법
카드 등록	법인카드 정보 등록 및 연동	2개 테넌트 카드 등록 확인
내역 수집	바로빌 API 자동 수집 성공	샌드박스 환경 100건 수집
룰 기반 분류	자동 분류율 90% 이상	100건 중 90건 자동 분류
금전출납부 생성	전표 자동 생성 성공	분류된 건 전표 생성 확인

📊 정량적 목표

수집 성공률: 98% 이상
자동 분류율: 90% 이상
분류 정확도: 95% 이상
API 응답 속도: 평균 1초 이하
Critical 버그: 0건
베타 테스트: 2개 테넌트 실사용 가능

기술 스택 (기존 시스템 활용)

⚙️ 백엔드 스택

기술	선택 이유
PHP 8.2	최신 PHP 기능 활용 및 성능 향상
MySQL 8.0	SAM 프로젝트 전용 데이터베이스
PDO	준비된 문장으로 SQL 인젝션 방지
바로빌 API	법인카드 내역 수집 전문 서비스

💻 프론트엔드 스택

기술	선택 이유
jQuery	기존 프로젝트 표준, 빠른 개발
Bootstrap	기존 UI 라이브러리, 일관성 유지
DataTables	카드 내역 테이블 표시
jQuery Validation	폼 검증 간소화

🛠️ 개발 도구

버전 관리: Git + .auto-commit.sh
디자인: 기존 시스템 UI 패턴 활용
테스트: 바로빌 샌드박스 환경
배포: Apache + mod_rewrite

데이터베이스 설계 (MVP 범위)

📊 핵심 테이블 (6개)

테이블명	주요 필드	용도
cards	id, tenant_id, card_no, card_name, issuer, status	법인카드 기본정보
card_transactions_raw	id, card_id, trans_date, merchant_raw, amount, status	수집 원본 내역
merchants	id, merchant_name, normalized_name, category, tax_item_id	가맹점 마스터
rules	id, pattern, tax_item_id, priority, is_active	분류 룰
postings	id, trans_id, tax_item_id, amount, posting_date, status	전표 데이터
reports_cashbook	id, tenant_id, period, report_data, generated_at	금전출납부 리포트

🔗 데이터 흐름

1단계: 바로빌 API → card_transactions_raw (원본 수집)
2단계: 정규화 엔진 → merchants (가맹점 정규화)
3단계: 룰 엔진 → rules 매칭 (세무항목 분류)
4단계: 전표 생성 → postings (금전출납부 전표)
5단계: 리포트 생성 → reports_cashbook (최종 리포트)

📋 룰 엔진 우선순위

Priority 1: 정확 매칭 (exact match)
Priority 2: 패턴 매칭 (LIKE pattern)
Priority 3: 카테고리 매칭 (category-based)
Priority 4: 기본값 (default rule)

Phase 2 계획 (MVP 이후)

MVP 성공 후 확장 로드맵

사용자 피드백 기반 점진적 기능 확장

📈 Phase 2 목표 (4주)

ML 분류 엔진: 룰 기반 → 머신러닝 기반 자동 분류
영수증 OCR: 이미지 업로드 및 자동 데이터 추출
향상된 리포트: 월별/분기별 세무 분석 리포트
알림 기능: 미분류 건, 이상 거래 알림

🔮 Phase 3 목표 (8주)

ERP 연동: 더존/영림원 자동 전표 입력
홈택스 신고 보조: 부가세 신고 파일 자동 생성
모바일 앱: 현장 영수증 촬영 및 즉시 분류
AI 이상 거래 탐지: 비정상 패턴 자동 감지

🎯 장기 비전

중소기업을 위한 완전 자동화 법인카드 세무 관리 플랫폼

자동 분류율 90% → 98% 향상
세무 담당자 업무 시간 80% 단축
세무 오류 및 누락 제로화

6주 MVP 요약

핵심 메시지

"수작업 70% → 자동화 90%로의 혁신적 전환"

✅ 최종 체크리스트

주차	핵심 산출물	검증 방법
Week 1-2	바로빌 연동 + DB 스키마	샌드박스 API 호출 성공
Week 3-4	수집·정규화·분류·전표 생성 API	100건 수집 + 90건 자동 분류
Week 5-6	2개 테넌트 베타 + 운영전환	실제 법인카드 자동화 성공

성공 지표

90%

자동 분류율

시간→분

마감 시간

95%

분류 정확도

2개

베타 테넌트

감사합니다

MVP 법인카드 세무항목 매칭 전략 - 6주 실행 계획

함께 만들어가는 세무 자동화

빠르고 확실한 시작으로 세무 업무 효율 극대화

문의 및 피드백

본 계획안에 대한 의견이나 추가 논의가 필요하신 경우

프로젝트 팀으로 연락 주시기 바랍니다.