Files

김보곤 157e8a95d5 docs:고객/거래처/채권관리 개발문서 추가 (5개 메뉴)

- 거래처관리: vendor/freelancer 타입, OCR 명함인식
- 고객사관리: VIP/Gold/Silver/Bronze 등급, 업종별 관리
- 미수금관리: 부분/전액 수금, 연체 추적, API 서비스
- 미지급금관리: 부분/전액 지급, 세금계산서 추적
- 환불/해지관리: 승인 워크플로우, refund/cancel 타입

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-11 16:54:06 +09:00

4.2 KiB

Raw Blame History

고객/거래처/채권관리 기능

개요

SAM 프로젝트의 고객/거래처/채권관리 모듈은 거래처 및 고객사 정보 관리, 미수금/미지급금 채권·채무 추적, 환불/해지 요청 처리를 종합적으로 관리하는 시스템입니다. OCR 기반 명함 인식, 부분 수금/지급 처리, 승인 워크플로우를 지원합니다.

메뉴 구성

메뉴	경로	설명	UI 기술
거래처관리	`/finance/partners`	거래처(업체/프리랜서) 등록 관리	React 18
고객사관리	`/finance/customers`	고객사 정보 및 등급 관리	React 18
미수금관리	`/finance/receivables`	채권 현황 및 수금 처리	React 18
미지급금관리	`/finance/payables`	채무 현황 및 지급 처리	React 18
환불/해지관리	`/finance/refunds`	환불/해지 요청 및 승인 처리	React 18

아키텍처

┌───────────────────────────────────────────────────────────────┐
│                  고객/거래처/채권관리 모듈                       │
├───────────┬───────────┬───────────┬───────────┬───────────────┤
│ 거래처관리 │ 고객사관리 │ 미수금관리 │ 미지급금관리│ 환불/해지관리 │
│(업체/프리) │(등급관리) │(채권추적) │(채무추적)  │(요청/승인)   │
│ OCR인식   │ VIP~Brz  │ 수금처리  │ 지급처리   │ 워크플로우    │
└─────┬─────┴─────┬─────┴─────┬─────┴─────┬─────┴───────┬──────┘
      │           │           │           │             │
      ▼           ▼           ▼           ▼             ▼
┌───────────────────────────────────────────────────────────────┐
│                     데이터베이스                                │
│  trading_partners, customers,                                 │
│  receivables, payables, refunds                               │
└───────────────────────────────────────────────────────────────┘

주요 기술 스택

기술	용도
Laravel 11 (PHP 8.3)	백엔드 프레임워크
React 18 + Babel	클라이언트 렌더링 UI (전 페이지)
Tailwind CSS + Lucide	스타일링 및 아이콘
OCR (Claude Vision)	명함 인식 (거래처관리)
MySQL 8.0	데이터 저장

공통 패턴

멀티 테넌트

모든 테이블은 tenant_id 기반으로 데이터를 격리합니다.

부분 수금/지급

미수금과 미지급금은 부분 처리를 지원합니다:

수금/지급액 입력 → collected/paid_amount 누적
→ 전액 수금/지급: collected/paid 상태로 변경
→ 부분 수금/지급: partial 상태로 변경

상태 관리 비교

기능	상태값
거래처	active / inactive
고객사	active / inactive
미수금	outstanding → partial → collected / overdue
미지급금	unpaid → partial → paid / overdue
환불/해지	pending → approved → completed / rejected

데이터베이스 테이블 요약

테이블	역할
`trading_partners`	거래처 정보 (업체/프리랜서, 사업자번호, 계좌 등)
`customers`	고객사 정보 (등급, 업종, 담당자 등)
`receivables`	미수금 (고객별 인보이스, 수금액, 연체 추적)
`payables`	미지급금 (업체별 인보이스, 지급액, 세금계산서)
`refunds`	환불/해지 요청 (타입, 사유, 처리상태)

4.2 KiB Raw Blame History