Freelancer bank CSV expense categorizer for bookkeeping review

# Freelancer bank CSV expense categorizer for bookkeeping review: 주문 데이터를 인보이스 PDF로 바꾸는 로컬 자동화

Freelancer bank CSV expense categorizer for bookkeeping review는 Freelancers and solo founders preparing monthly bookkeeping from bank CSV exports를 위해 만든 로컬 Python CLI 자동화입니다. 핵심 문제는 Monthly bank exports require manual categorization before a bookkeeper or accounting tool can review them.이며, 이 도구는 주문 파일을 읽어 검토 가능한 인보이스 산출물로 바꾸는 반복 작업을 줄입니다.

소스 설명 기준으로 이 패키지는 Buyer-specific v3 Python package that categorizes a monthly business bank CSV, writes bookkeeping import rows, and creates review reports.입니다. Local buyer-deliverable automation. No external API calls, payments, emails, bank connections, or accounting uploads are performed by default.

Freelancer bank CSV expense categorizer for bookkeeping review 주문 파일 입력과 인보이스 PDF 산출물 흐름 — Freelancer bank CSV expense categorizer for bookkeeping review 입력, 처리, 산출물 흐름

이 글의 핵심

입력 파일을 사람이 템플릿에 옮겨 적는 작업을 CLI 실행 한 번으로 줄입니다.
결과물은 인보이스 HTML/PDF, 요약 CSV, 실행 리포트처럼 검수 가능한 파일로 남습니다.
고객 데이터는 외부 API, 이메일, 결제 시스템으로 전송하지 않는 로컬 처리 범위입니다.

해결하는 문제

Freelancers and solo founders preparing monthly bookkeeping from bank CSV exports는 주문 내역을 인보이스 양식으로 옮기는 데 시간을 씁니다. 이 과정은 단순하지만 실수가 나기 쉽고, 주문이 늘어날수록 검수 시간이 같이 늘어납니다.

이 서비스 폴더의 설명은 다음처럼 요약할 수 있습니다. Buyer-specific v3 package for freelancers and solo founders who export a monthly business bank CSV and need a categorized file for bookkeeping review.

동작 방식

주문 파일 입력

CSV 또는 Excel 주문 파일을 입력으로 받습니다.

컬럼 매핑과 검증

설정 파일 기준으로 invoice ID, 고객명, 수량, 단가 같은 필드를 읽습니다.

인보이스 생성

주문 행을 invoice ID로 묶고 고객별 인보이스 데이터를 만듭니다.

HTML/PDF 렌더링

각 인보이스를 HTML과 PDF 파일로 저장합니다.

검수 산출물 저장

요약 CSV와 실행 리포트를 함께 남겨 납품 증거와 회계 검토에 사용합니다.

소스 구조와 기능 근거

주요 코드 파일

tool.py
src/__init__.py
src/automation_core.py
src/automation_product.py
src/product_contract.py
src/product_runtime.py

샘플 입력

sample_input/freelancer_bank_june.csv

샘플 출력

sample_output/bookkeeping_import.csv
sample_output/bookkeeping_ready_import.csv
sample_output/categorization_summary.html
sample_output/categorization_summary.json
sample_output/categorized_transactions.csv
sample_output/execution_manifest.json
sample_output/expense_summary_by_category.csv
sample_output/uncategorized_review.csv

실행 예시

bash

python3 tool.py --demo --output-dir sample_output

실제 고객 파일을 처리할 때는 입력 파일, 설정 파일, 출력 폴더를 지정합니다.

bash

python3 tool.py \
  --input /path/to/orders.csv \
  --config sample_config.json \
  --output-dir /path/to/generated-invoices

산출물

고객별 인보이스 HTML 파일
고객별 인보이스 PDF 파일
invoices_summary.csv
run_report.json
고객 컬럼명에 맞춘 설정 파일

운영 범위

이 자동화는 납품 가능한 로컬 도구입니다. 이메일 발송, 결제 처리, 회계 SaaS 연동, 외부 업로드는 기본 범위에 포함하지 않습니다. 구매자에게는 샘플 데이터와 설정 파일을 함께 제공하고, 실제 데이터는 구매자 PC 안에서 처리하게 하는 구성이 적합합니다.

다음 개선 방향

구매자별 컬럼명 매핑 프리셋 추가
브랜드 로고와 결제 안내 문구 커스터마이징
세금, 할인, 배송비 규칙 확장
PDF 외 추가 요약 리포트 형식 추가