한빛건설 법인카드 경비 전산
법인카드 경비 처리를 자동화하는 사내 시스템을, 가상 회사 "한빛건설"과 가상 데이터로 다시 만든 체험용 데모입니다.
데모 사이트: https://hanbit-expense-demo.vercel.app
회사명·인물·카드번호를 포함한 모든 데이터는 가상입니다. 실제 개인정보나 업무 데이터는 들어 있지 않습니다.
체험할 수 있는 것
| 화면 | 하는 일 |
|---|
| 정산서 자동 작성 | 카드사에서 받은 사용내역 엑셀을 업로드하면, 어떤 카드로 쓴 내역인지 찾고 취소된 결제를 제외한 뒤 경비 정산서 엑셀을 만들어 줍니다. |
| 경비 규정 준수 확인 | 작성한 정산서를 회사 경비 규정과 비교해 식비·음료 한도 초과, 결제가 금지된 주차비, 인원이 적히지 않은 내역을 찾아 리포트 엑셀로 내려 줍니다. |
정산서 자동 작성 — 카드 사용내역을 읽어 정산서에 들어갈 내역을 보여 주는 화면
경비 규정 준수 확인 — 정산서를 경비 규정과 비교한 확인 결과 화면
각 화면에서 샘플 파일을 내려받아 그대로 업로드하면 결과까지 볼 수 있습니다. 경비 규정 준수 확인에서는 한도를 바꿔 결과가 다시 계산되는 것도 확인할 수 있습니다.
특징
- 서버가 없습니다. 정적 사이트이고, 엑셀 읽기·판정·생성이 모두 브라우저 안에서 이루어집니다. 업로드한 파일은 어디로도 전송되지 않습니다.
- 규칙은 코드 밖에 있습니다. 한도와 금지 항목은
src/lib/audit/expenseRules.json 에서 관리합니다.
- 핵심 로직은 화면과 분리돼 있습니다.
src/lib 는 프레임워크에 의존하지 않아 node 로 바로 테스트합니다.
실행
npm install
npm run dev # 개발 서버 (http://localhost:3000)
npm run build # 정적 사이트 생성 → out/
테스트
npx tsc --noEmit
# 경비 규정 준수 확인 로직 (파일별로 실행)
node scripts/audit/testSamples.mjs
node scripts/audit/testAudit.mjs
node scripts/audit/testNoteParser.mjs
node scripts/audit/testAuditReport.mjs
node scripts/audit/testExpenseLimits.mjs
# 정산서 자동 작성 로직
node --import ./scripts/advance/register.mjs --test scripts/advance/advance.test.mts
폴더 구조
src/app/ 화면 (홈, demo/advance, demo/audit)
src/components/ 공용 컴포넌트 (단계 표시, 파일 업로드, 알림, 창)
src/lib/advance/ 카드 사용내역 읽기 → 정산서 엑셀 생성
src/lib/audit/ 정산서 읽기 → 규칙 판정 → 리포트 엑셀 생성
public/samples/ 화면에서 내려받는 샘플 2개와 정산서 양식
scripts/ 테스트, 샘플 생성 스크립트, 테스트 전용 샘플(fixtures)
기술
Next.js (정적 export) · React · TypeScript · SheetJS · ExcelJS
