MVP 전자세금계산서 발행 전략

6주 실행 계획

즉시 실행 가능한 핵심 세금계산서 발행 솔루션

바로빌 API 기반 빠른 구현

목표: 6주 안에 실무에서 사용 가능한 세금계산서 발행 시스템 MVP 완성

MVP 철학 및 범위

핵심 원칙

"가산세 제로와 자동화로 세무 리스크 최소화"

🎯 MVP 목표

발급·전송 자동화율 85% → 95%로 향상
지연/미전송 건수 월별 0건 목표
반려→정정 소요시간 단축 (3시간 → 30분)
바로빌 API 기반 빠른 구현

✅ MVP 핵심 기능

세금계산서 발급: 정발행, 전자서명, 국세청 전송
임시저장/검증: 필수필드 검증, 금액 검증
발급 현황 조회: 발급내역, 전송상태 실시간 추적
수정/취소: 수정사유코드 기반 수정발급
가산세 알림: 발급기한 알림, 지연 위험 대시보드

🚫 MVP 범위 밖 (Phase 2)

역발행/위수탁 워크플로우
대량발급 엑셀/CSV 업로드
모바일 앱
ERP 연동 커넥터
홈택스 신고보조 파일 생성

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

🏗️ Week 1-2 목표

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

📋 기획 (Week 1-2)

Week 1: MVP 기능 명세 및 데이터 모델
- 발급 프로세스 플로우 정의
- 가산세 리스크 포인트 정리
- 바로빌 API 명세 분석
- 상태 머신 (State Machine) 설계
Week 2: 테스트 시나리오 작성
- 발급 테스트 케이스 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 스키마 구축
- tenants, certificates 테이블
- tax_invoices, parties 테이블
- line_items, events 테이블
- 상태 머신 구현

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

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

📦 Week 1-2 산출물

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

Week 3-4: 발급/전송/조회 핵심 기능 구현

⚡ Week 3-4 목표

세금계산서 발급·전송·조회·수정·취소 API 완성

📋 기획 (Week 3-4)

Week 3: 리포트 MVP 설계
- 발급현황 리포트 템플릿
- 미전송/지연 건 알림 로직
- 반려사유 매핑 테이블
Week 4: QA 준비
- 통합 테스트 시나리오
- 버그 트래킹 시스템
- 사용자 가이드 초안

🎨 디자인 (Week 3-4)

Week 3: 나머지 화면 디자인
- 수정/취소 마법사
- 리포트 대시보드
- 오류검증 패널
Week 4: 디자인 QA
- 프론트엔드 구현 리뷰
- 반응형 디자인 검증
- UX 개선사항 반영

⚙️ 백엔드 (Week 3-4)

Week 3: 발급/전송 API 구현
- 문서 작성/임시저장 API
- 전자서명 & 발급 API
- 국세청 전송 API (자동/수동)
- 전송결과 폴링/웹훅 처리
Week 4: 수정/취소/조회 API
- 수정발급 API (사유코드 기반)
- 발급취소 API
- 발급현황 조회 API
- 리포트 생성 API

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

Week 3: 발급 화면 구현
- 세금계산서 작성 폼
- 필수필드 실시간 검증
- 공급자/수취자 선택
- 품목 입력 테이블
Week 4: 조회/수정 화면
- 발급현황 테이블
- 전송상태 타임라인
- 수정/취소 마법사
- 리포트 대시보드

📦 Week 3-4 산출물

테스트 시나리오 + 사용자 가이드 (기획)
전체 화면 디자인 완료 (디자인)
발급·전송·조회·수정·취소 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: 지연 알림 및 재전송 안정화
- 발급기한 알림 스케줄러 (T-2, T-1)
- NTS_REJECTED 재전송 로직
- 인증서 만료 사전 알림
- 에러 핸들링 개선
Week 6: 프로덕션 배포
- 프로덕션 환경 설정
- 백업 및 모니터링
- API 문서화
- 보안 점검

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

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

📦 Week 5-6 산출물

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

성공 지표 및 완료 기준

MVP 완료 정의

"2개 테넌트가 실제 세금계산서를 발급하고 국세청 전송까지 성공적으로 완료"

✅ 필수 완료 항목

항목	완료 기준	검증 방법
인증서 등록	공동/금융인증서 등록 성공	2개 테넌트 인증서 등록 확인
세금계산서 발급	정발행 + 전자서명 성공	샌드박스 환경 10건 발급
국세청 전송	발급 즉시 자동 전송	NTS_ACCEPTED 상태 확인
수정발급	수정사유코드 기반 수정	5건 수정발급 테스트
발급취소	발급당일 취소 가능	3건 취소 테스트
가산세 알림	T-2, T-1 자동 알림	이메일 알림 발송 확인

📊 정량적 목표

발급 성공률: 95% 이상
전송 성공률: 98% 이상
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개)

테이블명	주요 필드	용도
tenants	id, name, bizno, tax_policy	테넌트 기본정보
certificates	id, tenant_id, type, valid_from, valid_to, kms_key_ref, status	인증서 관리
tax_invoices	id, tenant_id, issue_key, type, supply_amt, vat, total, write_date, state, nts_receipt_no	세금계산서 메인
parties	id, tenant_id, role, bizno, corp_name, ceo, addr, email, tel	공급자/수취자
line_items	id, invoice_id, item_name, qty, unit_price, supply_amt, vat	품목 상세
events	id, invoice_id, event_type, payload, created_at, actor	이벤트 로그

🔗 상태 머신 (State Machine)

DRAFT: 임시저장
READY_TO_ISSUE: 검증완료
SIGNED: 전자서명완료
ISSUED: 발급완료
SENT_NTS: 국세청전송
NTS_ACCEPTED: 접수완료
NTS_REJECTED: 반려
CANCELLED: 발급취소
MODIFIED: 수정발급

Phase 2 계획 (MVP 이후)

MVP 성공 후 확장 로드맵

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

📈 Phase 2 목표 (4주)

대량발급: 엑셀/CSV 업로드로 여러 건 동시 발급
역발행 워크플로우: 매입자발행 승인 프로세스
위수탁 발급: 수탁사업자 정보 포함 발급
향상된 리포트: 월별 발급·수정·취소 현황 상세

🔮 Phase 3 목표 (8주)

모바일 앱: 현장 발급/조회
ERP 연동: 더존/영림원 커넥터
홈택스 신고보조: 부가세 신고서 자동 작성
AI 오류 예측: 발급 전 오류 사전 감지

🎯 장기 비전

중소기업을 위한 완전 자동화 세금계산서 플랫폼

발급·전송 자동화율 95% 이상
지연/미전송 건수 0건 유지
가산세 리스크 완전 제로화

6주 MVP 요약

핵심 메시지

"가산세 제로를 향한 6주 여정"

✅ 최종 체크리스트

주차	핵심 산출물	검증 방법
Week 1-2	바로빌 연동 + DB 스키마	샌드박스 API 호출 성공
Week 3-4	발급·전송·조회·수정·취소 API	10건 발급 + 전송 성공
Week 5-6	2개 테넌트 베타 + 운영전환	실제 사업자 발급 성공

성공 지표

95%

자동화율 목표

0건

지연/미전송

30분

반려→정정

2개

베타 테넌트

감사합니다

MVP 전자세금계산서 발행 전략 - 6주 실행 계획

함께 만들어가는 가산세 제로

빠르고 확실한 시작으로 세무 리스크 최소화

문의 및 피드백

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

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