hskwon
764a6470c6
- v1-analysis: 5130 레거시 기반 견적 분석 추가 - v2-analysis: 기존 MES 분석 문서들 이동 - customer, master-data, order, price - production, production-userflow, quote, site
159 lines
4.1 KiB
Markdown
159 lines
4.1 KiB
Markdown
# 거래처관리 분석 결과
|
|
|
|
> 분석 일시: 2024-12-18
|
|
> 분석 대상: design/mes기획서_리액트 (디자인팀 기획 사이트)
|
|
|
|
## 분석 목적
|
|
|
|
디자인팀에서 제작한 기획 사이트의 거래처관리 기능을 분석하여 API 개발에 필요한 스펙을 추출합니다.
|
|
|
|
---
|
|
|
|
## UI 스크린샷
|
|
|
|
### 1. 거래처 목록 페이지
|
|
|
|
|
|
**주요 요소:**
|
|
- 상단 요약 카드: 전체 거래처, 활성 거래처, 신규(이번달), 미수금 보유
|
|
- 탭 필터: 전체, 1등급, 2등급, 3등급, 4등급, 미분류
|
|
- 검색: 거래처코드, 거래처명, 대표자, 연락처
|
|
- 테이블 컬럼: 체크박스, 번호, 코드, 거래처명, 사업자등록번호, 대표자, 연락처, 신용등급, 결제조건, 등록일, 상태
|
|
|
|
---
|
|
|
|
### 2. 거래처 상세 페이지
|
|
|
|
|
|
**주요 섹션:**
|
|
- **기본 정보**: 거래처코드, 거래처명, 대표자, 사업자등록번호, 업태, 종목, 신용등급, 결제조건, 상태
|
|
- **연락처 정보**: 전화번호, 팩스, 이메일, 주소
|
|
- **거래 현황**: 총 거래금액, 미수금, 최근 거래일
|
|
- **담당자 정보**: 담당자명, 직급, 연락처, 이메일
|
|
- **비고**: 특이사항
|
|
|
|
**헤더 버튼:**
|
|
- 목록
|
|
- 수정
|
|
- 삭제
|
|
|
|
---
|
|
|
|
### 3. 거래처 등록 폼
|
|
|
|
|
|
**입력 필드:**
|
|
|
|
| 섹션 | 필드명 | 타입 | 필수 |
|
|
|------|--------|------|------|
|
|
| 기본 정보 | 거래처명 | text | ✅ |
|
|
| | 대표자 | text | ✅ |
|
|
| | 사업자등록번호 | text | ✅ |
|
|
| | 업태 | text | |
|
|
| | 종목 | text | |
|
|
| | 신용등급 | select | |
|
|
| | 결제조건 | select | |
|
|
| 연락처 정보 | 전화번호 | text | |
|
|
| | 팩스 | text | |
|
|
| | 이메일 | email | |
|
|
| | 우편번호 | text | |
|
|
| | 주소 | text | |
|
|
| | 상세주소 | text | |
|
|
| 담당자 정보 | 담당자명 | text | |
|
|
| | 직급 | text | |
|
|
| | 연락처 | text | |
|
|
| | 이메일 | email | |
|
|
| 기타 | 비고 | textarea | |
|
|
|
|
---
|
|
|
|
## 데이터 스키마
|
|
|
|
### Customer (거래처)
|
|
```
|
|
customers
|
|
├── id (PK)
|
|
├── tenant_id (FK)
|
|
├── customer_code (UNIQUE) - 자동 채번
|
|
├── name - 거래처명
|
|
├── representative - 대표자
|
|
├── business_number - 사업자등록번호
|
|
├── business_type - 업태
|
|
├── business_item - 종목
|
|
├── credit_grade - 신용등급 (1~4등급)
|
|
├── payment_terms - 결제조건
|
|
├── phone
|
|
├── fax
|
|
├── email
|
|
├── postal_code
|
|
├── address
|
|
├── address_detail
|
|
├── contact_name - 담당자명
|
|
├── contact_position - 담당자 직급
|
|
├── contact_phone - 담당자 연락처
|
|
├── contact_email - 담당자 이메일
|
|
├── total_amount - 총 거래금액 (계산)
|
|
├── outstanding_amount - 미수금 (계산)
|
|
├── last_transaction_date - 최근 거래일
|
|
├── status - 상태 (활성/비활성)
|
|
├── note
|
|
├── created_at
|
|
├── updated_at
|
|
└── deleted_at
|
|
```
|
|
|
|
---
|
|
|
|
## API 스펙
|
|
|
|
### 거래처 CRUD
|
|
|
|
```
|
|
GET /api/customers - 거래처 목록
|
|
GET /api/customers/{id} - 거래처 상세
|
|
POST /api/customers - 거래처 등록
|
|
PUT /api/customers/{id} - 거래처 수정
|
|
DELETE /api/customers/{id} - 거래처 삭제
|
|
DELETE /api/customers - 거래처 일괄 삭제
|
|
```
|
|
|
|
### 목록 조회 Query Parameters
|
|
|
|
| 파라미터 | 타입 | 설명 |
|
|
|----------|------|------|
|
|
| credit_grade | string | 신용등급 필터 |
|
|
| status | string | 상태 필터 |
|
|
| search | string | 검색어 |
|
|
| page | number | 페이지 번호 |
|
|
| per_page | number | 페이지당 개수 |
|
|
|
|
---
|
|
|
|
## 신용등급
|
|
|
|
| 등급 | 설명 | 결제조건 |
|
|
|------|------|----------|
|
|
| 1등급 | 최우수 | 후불/여신 가능 |
|
|
| 2등급 | 우수 | 일부 여신 가능 |
|
|
| 3등급 | 보통 | 선불 또는 COD |
|
|
| 4등급 | 주의 | 선불 필수 |
|
|
|
|
---
|
|
|
|
## 결제조건 옵션
|
|
|
|
- 선불
|
|
- 착불
|
|
- 후불 30일
|
|
- 후불 60일
|
|
- 월말정산
|
|
- 기타
|
|
|
|
---
|
|
|
|
## 채번 규칙
|
|
|
|
```
|
|
거래처코드: C-{순번6자리}
|
|
예시: C-000001, C-000002
|
|
``` |