Files

kent d43433295d feat(construction): Phase L 건설관리 3개 모듈 Mock → API 연동

- pricing-management: Mock → apiClient 표준화, types.ts 타입 추가
- estimates: Mock → apiClient 표준화 (복잡한 중첩 타입 처리)
- category-management: Mock → apiClient 표준화 (에러 타입 처리)

2026-01-09 19:57:30 +09:00

31 KiB

Raw Permalink Blame History

SAM React 작업 현황

2026-01-09 (목) - Phase L 건설관리 Mock → API 연동 (3개 모듈) ✅

작업 목표

Backend API가 이미 존재하는 3개 모듈의 Mock → API 연동
pricing-management, estimates, category-management

완료된 작업

모듈	변경 내용	상태
pricing-management	Mock → apiClient 변환 (378줄), types.ts 타입 추가	✅
estimates	Mock → apiClient 변환, 복잡한 중첩 타입 처리	✅
category-management	Mock → apiClient 변환, 에러 타입 처리 (IN_USE/DEFAULT/GENERAL)	✅

수정된 파일

파일명	설명
`src/components/business/construction/pricing-management/actions.ts`	Mock → apiClient 표준화
`src/components/business/construction/pricing-management/types.ts`	PricingListResponse, PricingFilter, PricingFormData 추가
`src/components/business/construction/estimates/actions.ts`	Mock → apiClient 표준화 (중첩 타입)
`src/components/business/construction/category-management/actions.ts`	Mock → apiClient 표준화

적용된 패턴

'use server' + apiClient from '@/lib/api'
Snake_case API 타입 (ApiXxx) → camelCase Frontend 타입 변환
표준 응답: { success, data?, error? }
페이지네이션: { items, total, page, size, totalPages }

빌드 검증

✅ Next.js 빌드 성공 (349 페이지)

남은 Mock 모듈 (Backend API 개발 필요)

모듈	Backend API	비고
bidding	❌ 없음	Backend 필요
site-briefings	❌ 없음	Backend 필요
structure-review	❌ 없음	Backend 필요
labor-management	❌ 없음	Backend 필요

2026-01-09 (목) - Phase 1.3-1.5 건설관리 apiClient 표준화

작업 목표

건설관리 모듈의 커스텀 apiRequest 함수를 표준 apiClient 패턴으로 변환
Phase 1.3: 계약관리(contract), Phase 1.4: 거래처관리(partners), Phase 1.5: 현장관리(site-management)

수정된 파일

파일명	설명
`src/components/business/construction/contract/actions.ts`	커스텀 apiRequest → apiClient 표준화
`src/components/business/construction/partners/actions.ts`	커스텀 apiRequest → apiClient 표준화
`src/components/business/construction/site-management/actions.ts`	커스텀 apiRequest → apiClient 표준화

주요 변경 내용

1. 제거된 코드 (각 파일에서)

커스텀 apiRequest() 함수 전체
import { cookies } from 'next/headers'
const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL
const API_KEY = process.env.API_KEY

2. 추가된 코드

import { apiClient } from '@/lib/api'
명시적 API 타입 정의:
- contract: ApiContract, ApiContractFile, ApiAttachment, ApiContractStats, ApiContractStageCount
- partners: ApiPartner, ApiPartnerStats
- site-management: ApiSite, ApiSiteStats

3. API 엔드포인트 (변경 없음)

계약관리 (contract)

GET /construction/contracts - 목록
GET /construction/contracts/stats - 통계
GET /construction/contracts/stage-counts - 단계별 건수
GET /construction/contracts/{id} - 상세
POST /construction/contracts - 등록
PUT /construction/contracts/{id} - 수정
DELETE /construction/contracts/{id} - 삭제
DELETE /construction/contracts/bulk - 일괄 삭제

거래처관리 (partners)

GET /clients - 목록
GET /clients/stats - 통계
GET /clients/{id} - 상세
POST /clients - 등록
PUT /clients/{id} - 수정
DELETE /clients/{id} - 삭제
DELETE /clients/bulk - 일괄 삭제

현장관리 (site-management)

GET /sites - 목록
GET /sites/stats - 통계
DELETE /sites/{id} - 삭제
DELETE /sites/bulk - 일괄 삭제

빌드 검증

✅ Next.js 빌드 성공 (349 페이지)

Git 커밋

React: 5db6e59 refactor(construction): 건설관리 3개 모듈 apiClient 표준화

2026-01-09 (목) - Phase 1.2 인수인계보고서 API 표준화

작업 목표

handover-report/actions.ts 커스텀 fetch → 표준 apiClient 변환
기존 API 연동 코드를 프로젝트 표준 패턴으로 통일

수정된 파일

파일명	설명
`src/components/business/construction/handover-report/actions.ts`	커스텀 apiRequest → apiClient 표준화

주요 변경 내용

1. 제거된 코드

커스텀 apiRequest() 함수 (52줄)
cookies() 직접 import
API_BASE_URL, API_KEY 직접 정의

2. 추가된 코드

import { apiClient } from '@/lib/api'
명시적 API 타입 정의: ApiHandoverReport, ApiManager, ApiContractItem, ApiExternalEquipmentCost

3. API 엔드포인트 (변경 없음)

GET /construction/handover-reports - 목록
GET /construction/handover-reports/stats - 통계
GET /construction/handover-reports/{id} - 상세
POST /construction/handover-reports - 등록
PUT /construction/handover-reports/{id} - 수정
DELETE /construction/handover-reports/{id} - 삭제
DELETE /construction/handover-reports/bulk - 일괄 삭제

빌드 검증

✅ Next.js 빌드 성공 (349 페이지)

Git 커밋

React: b7b8b90 refactor(handover-report): 커스텀 fetch → apiClient 표준화

2026-01-09 (목) - Phase 2.4 수주관리 API 연동

작업 목표

시공사 페이지 API 연동 계획 Phase 2.4: 수주관리
order-management/actions.ts Mock 데이터 → 실제 API 연동
common_codes 테이블 기반 공용 코드 시스템 도입

수정된 파일

저장소	파일명	설명
api	`database/migrations/2026_01_09_171700_add_order_codes_to_common_codes.php`	order_status/order_type 코드 추가
api	`app/Http/Controllers/Api/V1/CommonController.php`	index 메서드 구현
react	`src/lib/api/common-codes.ts`	공용 코드 조회 유틸리티 (신규)
react	`src/lib/api/index.ts`	common-codes 모듈 export 추가
react	`src/components/business/construction/order-management/actions.ts`	Mock → API 완전 재작성

주요 변경 내용

1. common_codes 공용 코드 시스템

order_status 코드 그룹: DRAFT, CONFIRMED, IN_PROGRESS, COMPLETED, CANCELLED
order_type 코드 그룹: ORDER, PURCHASE
API 엔드포인트: GET /api/v1/settings/common/{group}

2. 상태 매핑 함수

Frontend	Backend
waiting	DRAFT
order_complete	CONFIRMED
delivery_scheduled	IN_PROGRESS
delivery_complete	COMPLETED

3. API 함수 구현 (10개)

getOrderList() - GET /api/v1/orders
getOrderStats() - GET /api/v1/orders/stats
getOrderDetail() - GET /api/v1/orders/{id}
getOrderDetailFull() - GET /api/v1/orders/{id} (전체 정보)
createOrder() - POST /api/v1/orders
updateOrder() - PUT /api/v1/orders/{id}
deleteOrder() - DELETE /api/v1/orders/{id}
deleteOrders() - 개별 삭제 반복 (batch API 미존재)
duplicateOrder() - 조회 후 새로 생성
updateOrderStatus() - PATCH /api/v1/orders/{id}/status

Git 커밋

API: 9f8bff2 feat(common-codes): order_status/order_type 공용 코드 추가
React: 6615f39 feat(order-management): Mock → API 연동 및 common-codes 유틸리티 추가

빌드 검증

✅ Next.js 빌드 성공 (349 페이지)

2026-01-09 (목) - TODO-1 결재선/참조 Select 버그 수정

작업 목표

결재선/참조 Select 컴포넌트에서 선택한 직원 정보가 표시되지 않는 버그 수정
@/lib/api barrel export 추가 (빌드 오류 해결)

수정된 파일

파일명	설명
`src/components/approval/DocumentCreate/ApprovalLineSection.tsx`	SelectValue 버그 수정
`src/components/approval/DocumentCreate/ReferenceSection.tsx`	SelectValue 버그 수정
`src/lib/api/index.ts`	신규 생성 - barrel export

주요 변경 내용

1. SelectValue 버그 수정

문제: Radix UI SelectValue의 children prop에 조건부 렌더링 사용 시 Select 상태 관리가 깨짐

해결: children 제거, placeholder prop으로 이동

// Before (버그)
<SelectValue placeholder="부서명 / 직책명 / 이름 ▼">
  {person.name ? `${person.department} / ${person.position} / ${person.name}` : null}
</SelectValue>

// After (수정)
<SelectValue
  placeholder={
    person.name && !person.id.startsWith('temp-')
      ? `${person.department || ''} / ${person.position || ''} / ${person.name}`
      : "부서명 / 직책명 / 이름 ▼"
  }
/>

2. @/lib/api barrel export

Phase 2.3 자재관리 작업에서 사용하는 import 경로 지원:

// src/lib/api/index.ts
export { ApiClient, withTokenRefresh } from './client';
export { serverFetch } from './fetch-wrapper';
export { AUTH_CONFIG } from './auth/auth-config';

export const apiClient = new ApiClient({
  mode: 'api-key',
  apiKey: process.env.API_KEY,
});

빌드 검증

✅ Next.js 빌드 성공 (349 페이지)

2026-01-09 (목) - Phase 2.3 자재관리(품목관리) API 연동

작업 목표

시공사 페이지 API 연동 계획 Phase 2.3: 자재관리
item-management/actions.ts Mock 데이터 → 실제 API 연동

수정된 파일

파일명	설명
`src/components/business/construction/item-management/actions.ts`	Mock → API 완전 재작성
`claudedocs/[IMPL-2026-01-09] item-management-api-integration.md`	구현 문서

주요 변경 내용

1. 타입 변환 함수 추가

transformItemType() - Backend item_type → Frontend itemType
transformToBackendItemType() - Frontend itemType → Backend item_type
transformSpecification() - Backend options → Frontend specification
transformOrderType() - Backend options → Frontend orderType
transformStatus() - Backend is_active + options → Frontend status
transformOrderItems() - Backend options → Frontend orderItems
transformItem() - API 응답 → Item 타입
transformItemDetail() - API 응답 → ItemDetail 타입
transformItemToApi() - ItemFormData → API 요청 데이터

2. 품목유형 매핑

Frontend	Backend
제품	FG
부품	PT
소모품	CS
공과	RM

3. API 함수 구현 (8개)

getItemList() - GET /api/v1/items
getItemStats() - GET /api/v1/items/stats
getItem() - GET /api/v1/items/{id}
createItem() - POST /api/v1/items
updateItem() - PUT /api/v1/items/{id}
deleteItem() - DELETE /api/v1/items/{id}
deleteItems() - DELETE /api/v1/items/batch
getCategoryOptions() - GET /api/v1/categories

4. Frontend 전용 필터링

Backend에서 미지원 필터는 Frontend에서 처리:

규격 (specification)
구분 (orderType)
날짜 범위 (startDate, endDate)
정렬 (sortBy)

2025-01-09 (목) - 작업지시 process_type → process_id FK 변환

작업 목표

작업지시의 process_type (varchar enum: 'screen'/'slat'/'bending')를 process_id (FK → processes.id)로 변환
API와 Frontend 전체 스택 마이그레이션

수정된 파일

파일명	설명
`src/components/production/WorkOrders/types.ts`	processId, processName, processCode 필드 추가, transformApiToFrontend에서 processType 하위 호환 유지
`src/components/production/WorkOrders/actions.ts`	getProcessOptions() 추가, createWorkOrder에서 processId 사용
`src/components/production/WorkOrders/WorkOrderCreate.tsx`	processType enum → processId FK 변경, 동적 공정 옵션 로딩
`src/components/production/WorkOrders/WorkOrderList.tsx`	PROCESS_TYPE_LABELS 제거, order.processName 사용
`src/components/production/WorkOrders/WorkOrderDetail.tsx`	PROCESS_TYPE_LABELS 제거, order.processName 사용 (비즈니스 로직은 processType 유지)

주요 변경 내용

1. types.ts - 타입 및 변환 함수

WorkOrder 인터페이스에 processId, processName, processCode 추가
processType은 @deprecated 마킹, 하위 호환용 유지
transformApiToFrontend에서 processName → processType 자동 매핑

2. actions.ts - 서버 액션

getProcessOptions(): 공정 목록 API 조회 (GET /api/v1/processes)
createWorkOrder(): processId 필드 사용 (기존 processType 제거)

3. WorkOrderCreate.tsx - 등록 폼

processType: ProcessType → processId: number | null
useEffect로 공정 옵션 동적 로딩
첫 번째 공정 자동 선택 (기본값)
Select 컴포넌트 동적 옵션 렌더링

4. WorkOrderList.tsx / WorkOrderDetail.tsx - 목록/상세

PROCESS_TYPE_LABELS[order.processType] → order.processName
비즈니스 로직(ProcessSteps, 절곡 확인)은 processType 유지

빌드 검증

✅ Next.js 빌드 성공 (TypeScript 오류 없음)

2025-01-09 (목) - 작업지시 코드 리뷰 기반 프론트엔드 개선

작업 목표

작업지시 기능 코드 리뷰 결과 기반 프론트엔드 개선
Critical, High, Medium 우선순위 항목 전체 수정

수정된 파일

파일명	설명
`src/components/production/WorkOrders/WorkOrderList.tsx`	useCallback 의존성 순환 수정
`src/components/production/WorkOrders/WorkOrderDetail.tsx`	작업 버튼 핸들러 구현
`src/components/production/WorkOrders/types.ts`	scheduledDate 매핑, 다중 담당자 타입 추가
`src/components/production/WorkOrders/actions.ts`	API 경로 수정 (/sales-orders → /orders)
`src/components/production/WorkOrders/SalesOrderSelectModal.tsx`	debounce 적용
`src/components/production/WorkOrders/hooks/useDebounce.ts`	신규 생성 - 커스텀 debounce 훅

주요 변경 내용

useCallback 의존성 수정: 무한 루프 방지를 위한 의존성 배열 수정
scheduledDate 매핑: transformFrontendToApi에 scheduled_date 필드 추가
작업 버튼 구현: "시작"/"완료" 버튼 핸들러 추가
API 경로 수정: /api/v1/sales-orders → /api/v1/orders 변경
debounce 적용: 커스텀 useDebounce 훅 (300ms) 적용
다중 담당자 타입: WorkOrderAssigneeApi 인터페이스 및 assignees 필드 추가

Git 커밋

12b4259 refactor(work-orders): 코드 리뷰 기반 프론트엔드 개선

2025-01-02 (목) - 견적 등록 자동산출 기능 구현

작업 목표

견적 등록 화면에서 BOM 기반 자동산출 기능 구현
MNG 시뮬레이터와 동일하게 동작하도록 API 연동

수정된 파일

파일명	설명
`src/components/quotes/QuoteRegistration.tsx`	FormField type="custom" 추가, API 요청 구조 변경, 응답 파싱 수정
`src/components/quotes/actions.ts`	Item 모델 필드 매핑 수정, BomCalculateItem 인터페이스 변경

주요 변경 내용

FormField 렌더링 수정:
- Input 자식 컴포넌트도 type="custom" 필요
- openWidth, openHeight 필드에 적용
API 필드 매핑 수정 (actions.ts):
- item.item_code → item.code (Laravel Item 모델 필드명)
- item.item_name → item.name
API 요청 구조 변경 (QuoteRegistration.tsx):
- 중첩 구조 제거: { input_variables: { W0, H0 } } → { openWidth, openHeight }
- flat 구조로 API FormRequest와 일치
API Enum 값 변경:
- 가이드레일: "벽면형" → "wall", "측면형" → "floor"
- 모터전원: "220V" → "single", "380V" → "three"
- 제어기: "단독" → "basic", "연동" → "smart"
API 응답 파싱 수정:
- result.data.items 배열 접근
- result.data.summary.grand_total 총합계 접근

Git 커밋

5a3e534 feat(WEB): 견적 등록 자동산출 기능 구현
5f062d5 chore(WEB): 견적 등록 디버깅 로그 제거

2025-01-02 (목) - 채권현황 동적월 지원 및 버그 수정

작업 목표

"최근 1년" 필터 선택 시 동적 월 기간(최근 12개월) 지원
year=0 파라미터 처리 버그 수정
거래처별 연체 상태 및 메모 관리 기능 추가

수정된 파일

파일명	설명
`src/components/accounting/ReceivablesStatus/types.ts`	MonthlyAmount 동적 배열로 변경, 새 필드 추가
`src/components/accounting/ReceivablesStatus/actions.ts`	year=0 처리 버그 수정, updateMemos 액션 추가
`src/components/accounting/ReceivablesStatus/index.tsx`	동적 월 헤더 및 메모 입력 행 추가

주요 변경 내용

types.ts 변경:
- MonthlyAmount: 고정 월 키 → values: number[] 동적 배열
- VendorReceivables: monthLabels, carryForwardBalance, memo 필드 추가
- 정적 MONTH_LABELS, MONTH_KEYS 상수 제거
actions.ts 버그 수정:
- typeof yearValue === 'number' 명시적 타입 체크 추가
- year=0일 때 recent_year=true 파라미터 올바르게 전송
- updateMemos 액션 추가
index.tsx UI 개선:
- API에서 받은 monthLabels 사용하여 동적 헤더 렌더링
- 메모 입력 행 추가 (거래처 단위)
- 연체/메모 변경사항 추적 및 저장

Git 커밋

672b1b4 feat(WEB): 채권현황 동적월 지원 및 year=0 파라미터 버그 수정

남은 작업

디버깅 console.log 제거 (테스트 완료 후)
추가 UI 개선사항 확인

2025-12-28 (토) - 고객센터 시스템 게시판 API 연동 수정

작업 목표

고객센터 컴포넌트에서 시스템 게시판 API 엔드포인트 사용
날짜 범위 필터 초기값 수정 (전체 조회)

수정된 파일 (4개)

파일명	변경 내용
`src/components/customer-center/shared/actions.ts`	`/boards/` → `/system-boards/` API 엔드포인트 변경
`src/components/customer-center/EventManagement/EventList.tsx`	날짜 범위 초기값 빈 문자열로 변경 (전체 조회)
`src/components/customer-center/InquiryManagement/InquiryList.tsx`	날짜 범위 초기값 빈 문자열로 변경 (전체 조회)
`src/components/customer-center/NoticeManagement/NoticeList.tsx`	날짜 범위 초기값 빈 문자열로 변경 (전체 조회)

상세 변경사항

1. shared/actions.ts API 엔드포인트 변경

// 변경 전
const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/boards/${boardCode}/posts`;

// 변경 후
const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/system-boards/${boardCode}/posts`;

영향받는 함수:

getPosts() - 게시글 목록 조회
getPost() - 게시글 상세 조회
createPost() - 게시글 생성
updatePost() - 게시글 수정
deletePost() - 게시글 삭제

2. 날짜 범위 필터 초기값 변경

// 변경 전
const [startDate, setStartDate] = useState(format(new Date(), 'yyyy-MM-dd'));
const [endDate, setEndDate] = useState(format(new Date(), 'yyyy-MM-dd'));

// 변경 후
const [startDate, setStartDate] = useState('');
const [endDate, setEndDate] = useState('');

초기 로드 시 모든 데이터 조회 가능
날짜 필터 미선택 시 전체 기간 조회

연관 API 수정 (api 저장소)

PostService.php - 시스템 게시판 tenant_id 처리 개선
custom_fields field_key → field_id 매핑 지원
댓글 생성 시 tenant_id 추가

2025-12-27 (금) - 결재 문서 작성 버그 수정

수정된 파일 (2개)

파일명	변경 내용
`src/components/approval/DocumentCreate/actions.ts`	transformApiToFormData에서 `form.code` 처리 추가
`src/components/approval/DocumentCreate/index.tsx`	useRef로 toast 중복 호출 방지

완료된 수정

1. 복제 모드 documentType 매핑 오류 수정

문제: 복제로 들어왔을 때 문서유형이 선택되지 않아 추가 폼이 안 보임
원인: API는 form.code로 반환하는데 프론트엔드는 form_code를 기대
수정파일: src/components/approval/DocumentCreate/actions.ts
수정내용: transformApiToFormData에서 apiData.form?.code || apiData.form_code 처리

2. 복제 모드 toast 중복 호출 수정

문제: "문서가 복제되었습니다" 메시지가 두 번 표시됨
원인: React.StrictMode에서 useEffect 두 번 실행
수정파일: src/components/approval/DocumentCreate/index.tsx
수정내용: useRef로 toast 호출 중복 방지

미해결 React Todo 🚧

TODO-1: 결재선/참조 Select 변경 불가 문제

증상: 한번 결재자/참조자를 선택하면 다른 사람으로 변경 불가
원인 후보:
1. SelectTrigger 내부 조건부 렌더링(span vs SelectValue)이 Radix Select 상태 관리에 영향
2. employees 배열에 선택된 person이 없어서 Select value가 유효하지 않음
해결 방향:
- A. employees 배열에 현재 선택된 사람들 포함 (useMemo)
- B. SelectTrigger 내부를 항상 SelectValue만 렌더링하고 표시 내용만 변경
- C. Shadcn/ui Select 컴포넌트 디버깅 필요
파일: ApprovalLineSection.tsx, ReferenceSection.tsx

2025-12-26 (목) - 급여관리 직책/직급 매핑 수정

문제

급여관리 페이지에서 직책과 직급이 사원관리와 다르게 표시됨
position_label → 직책으로 잘못 매핑 (실제로는 직위)
job_title_label → 직급으로 잘못 매핑 (실제로는 직책)

수정된 파일 (1개)

파일명	변경 내용
`src/components/hr/SalaryManagement/actions.ts`	직책/직급 매핑 수정

상세 변경사항

transformApiToFrontend (목록용):
- position: profile?.position_label → profile?.job_title_label (직책)
- rank: profile?.job_title_label → profile?.rank (직급)
transformApiToDetail (상세용):
- 동일하게 수정

매핑 기준 (사원관리 기준 통일)

필드	API 필드	설명	예시
직책 (position)	`job_title_label`	직무상 책임	팀장, 팀원
직급 (rank)	`rank`	호봉 등급	부장, 과장, 대리

2025-12-26 (목) - 휴가관리 사용현황 동기화 수정

작업 목표

휴가 승인 후 사용현황 즉시 반영
부여일수 계산 수정 (기본 15일 + 부여분)

수정된 파일 (1개)

파일명	변경 내용
`src/components/hr/VacationManagement/index.tsx`	승인 후 `fetchUsageData()` 호출 추가, baseVacation 고정 '15일', grantedVacation 계산식 수정

상세 변경사항

handleApproveConfirm: 승인 후 fetchUsageData() 호출 추가
baseVacation: 동적 ${totalDays}일 → 고정 '15일'
grantedVacation: 하드코딩 '0일' → Math.max(0, totalDays - 15)일
useCallback dependencies에 fetchUsageData 추가

Git 커밋

909005c fix(vacation): 휴가 사용현황 동기화 및 부여일수 계산 수정

2025-12-23 (월) - React Mock Data to API 마이그레이션 Phase B

프로젝트 개요

React 컴포넌트에서 Mock 데이터를 실제 API 호출로 교체하는 작업

참고 문서: docs/plans/react-mock-to-api-migration-plan.md

진행 상황

Phase A (완료 - 이전 세션)

A-1 악성채권 관리 API 연동
A-2 거래처 관리 API 연동
A-3 어음 관리 API 연동
A-4 대출 관리 API 연동
A-5 알림 설정 API 연동
A-6 거래처 원장 (API 미존재로 스킵)

Phase B (✅ 완료)

B-1 매출관리 (SalesManagement) API 연동 ✅
B-2 매입관리 (PurchaseManagement) API 연동 ✅
B-2.1 매입 세금계산서 토글 기능 수정 ✅
B-3 입금관리 (DepositManagement) API 연동 ✅
B-4 출금관리 (WithdrawalManagement) API 연동 ✅
B-5 거래처관리 (VendorManagement) API 연동 ✅
B-6 어음관리 (BillManagement) API 연동 ✅

참고: 원본 계획 문서(docs/plans/react-mock-to-api-migration-plan.md)의 Phase B 정의와 일치하도록 수정함

B-1 매출관리 API 연동 (완료)

수정된 파일

src/components/accounting/SalesManagement/types.ts
- API 응답 타입 추가 (ApiSaleData, ApiSalesListResponse 등)
- transformApiSaleToRecord() 변환 함수 추가
- formatDate() 날짜 포맷 함수 추가
src/components/accounting/SalesManagement/index.tsx
- generateMockData() 제거
- fetchSales(), deleteSale() API 함수 추가
- useEffect로 API 데이터 로딩
- 삭제 핸들러 API 연동

테스트 결과

API 연동 성공 (80개 레코드)
페이지네이션 정상 동작 (4페이지)
통계 카드 정상 표시 (총 매출: 679,876,062원)
날짜 포맷 정상 (YYYY-MM-DD)

B-2 매입관리 API 연동 (완료)

수정된 파일

src/components/accounting/PurchaseManagement/types.ts
- API 응답 타입 추가 (ApiPurchaseData, ApiPurchasesListResponse 등)
- transformApiPurchaseToRecord() 변환 함수 추가
- formatDate() 날짜 포맷 함수 추가
src/components/accounting/PurchaseManagement/index.tsx
- generateMockData() 제거
- fetchPurchases(), deletePurchase() API 함수 추가
- useEffect로 API 데이터 로딩
- 삭제 핸들러 API 연동
- toast 알림 추가

테스트 결과

API 연동 성공 (70개 레코드)
페이지네이션 정상 동작 (4페이지)
통계 카드 정상 표시:
- 총 매입: 577,881,642원
- 당월 매입: 164,988,080원
- 매입유형 미설정: 20건
- 세금계산서 수취 미확인: 8건
날짜 포맷 정상 (YYYY-MM-DD)

B-2.1 매입 세금계산서 토글 기능 수정 (2025-12-24)

문제

매입 관리 페이지에서 세금계산서 수취 토글이 작동하지 않음
원인 1: API 마이그레이션 미실행 (tax_invoice_received 컬럼 미존재)
원인 2: index.tsx에서 Mock 데이터 사용 중 (API 미연동)

수정된 파일

src/components/accounting/PurchaseManagement/index.tsx
- Mock 데이터(generateMockData) → API 데이터로 전환
- useEffect 추가로 API 데이터 로딩
- isLoading 상태 추가
- vendorOptions에서 빈 문자열 필터링 (Select.Item 에러 수정)
- format import 제거 (미사용)
- PurchaseType import 제거 (미사용)
src/components/accounting/PurchaseManagement/actions.ts (신규)
- getPurchases(): 매입 목록 조회 서버 액션
- togglePurchaseTaxInvoice(): 세금계산서 수취 토글 서버 액션
- API 응답 변환 함수 포함

API 변경사항 (api 저장소)

마이그레이션 실행: 2025_12_24_160000_add_tax_invoice_received_to_purchases_table
Purchase 모델: tax_invoice_received 필드 추가
PurchaseService: toggleTaxInvoice() 메서드 추가

버그 수정

Console Error: A <Select.Item /> must have a value prop that is not an empty string
- 원인: API 응답에 vendorName이 빈 문자열인 매입 레코드 존재
- 해결: vendorOptions 생성 시 빈 문자열 필터링 추가
```
const uniqueVendors = [...new Set(data.map(d => d.vendorName).filter(v => v && v.trim() !== ''))];
```

테스트 결과

세금계산서 수취 토글 정상 동작 ✅
API 호출 및 UI 업데이트 정상 ✅
Console 에러 해결 ✅

API 연동 패턴 (공통)

// 1. types.ts에 API 타입 추가
export interface ApiXxxData {
  id: number;
  // snake_case 필드들
}

export interface ApiXxxListResponse {
  success: boolean;
  message: string;
  data: {
    data: ApiXxxData[];
    current_page: number;
    last_page: number;
    per_page: number;
    total: number;
  };
}

// 2. 변환 함수 추가
export function transformApiXxxToRecord(apiData: ApiXxxData): XxxRecord {
  // snake_case → camelCase 변환
  // 날짜 포맷 변환
  // 상태 매핑
}

// 3. index.tsx에서 API 함수 추가
async function fetchXxx(params): Promise<ApiXxxListResponse> {
  const url = `/api/proxy/xxx?${searchParams.toString()}`;
  const response = await fetch(url);
  return response.json();
}

// 4. useEffect로 데이터 로딩
useEffect(() => {
  loadData();
}, [loadData]);

Phase C (✅ 완료)

C-1 직원관리 (EmployeeManagement) API 연동 ✅
C-2 근태관리 (AttendanceManagement) API 연동 ✅
C-3 휴가관리 (VacationManagement) API 연동 ✅

Phase D (✅ 완료) - 설정/시스템

D-1 부서관리 (DepartmentManagement) API 연동 ✅
D-2 직급관리 (RankManagement) API 연동 ✅
D-3 직책관리 (TitleManagement) API 연동 ✅
D-4 근무시간설정 (WorkScheduleManagement) API 연동 ✅

Phase E (✅ 완료) - 인사/급여

E-1 급여관리 (SalaryManagement) API 연동 ✅
E-2 카드관리 (CardManagement) API 연동 ✅

Phase F (✅ 완료) - 결재시스템

F-1 기안함 (DraftBox) API 연동 ✅
F-2 결재함 (ApprovalBox) API 연동 ✅
F-3 참조함 (ReferenceBox) API 연동 ✅
F-4 문서작성 (DocumentCreate) API 연동 ✅

Phase G (✅ 완료) - 생산관리

G-1 작업지시 (WorkOrders) API 연동 ✅
G-2 작업실적 (WorkResults) API 연동 ✅
G-3 작업자화면 (WorkerScreen) API 연동 ✅
G-4 생산현황 (ProductionDashboard) API 연동 ✅

Phase H (✅ 완료) - 자재/출하

H-1 재고현황 (StockStatus) API 연동 ✅
H-2 입고관리 (ReceivingManagement) API 연동 ✅
H-3 출하관리 (ShipmentManagement) API 연동 ✅

Phase I (✅ 완료) - 판매/견적

I-1 수주관리 (Orders) API 연동 ✅
I-2 단가관리 (Pricing) API 연동 ✅
I-3 견적관리 (Quotes) API 연동 ✅

Phase J (✅ 완료) - 회계관리

악성채권, 계좌조회, 어음관리, 카드거래 등 13개 모듈 API 연동 ✅

Phase K (✅ 완료) - 보고서

K-1 종합분석 (Reports) API 연동 ✅

Phase L (🔄 진행중 ~80%) - 건설관리

✅ apiClient 표준화 완료:

handover-report (b7b8b90)
contract (5db6e59)
partners (5db6e59)
site-management (5db6e59)
order-management (6615f39)
item-management (Phase 2.3)
pricing-management (Phase L) ✅ 2026-01-09
estimates (Phase L) ✅ 2026-01-09
category-management (Phase L) ✅ 2026-01-09

⏳ Mock → API 변환 필요 (Backend API 개발 필요):

bidding - 입찰관리
site-briefings - 현장설명회
structure-review - 구조검토
labor-management - 노무관리

마이그레이션 진행률: 97% 완료 (41/43 모듈) - 건설관리 4개 모듈 Backend API 개발 필요 점검일: 2026-01-09

다음 작업

Phase L 건설관리 모듈 마이그레이션 완료 (Backend API 개발 필요: bidding, site-briefings, structure-review, labor-management)
~~TODO-1: 결재선/참조 Select 변경 불가 문제~~ ✅ 2026-01-09 수정 완료

31 KiB Raw Permalink Blame History

SAM React 작업 현황

2026-01-09 (목) - Phase L 건설관리 Mock → API 연동 (3개 모듈) ✅

작업 목표

완료된 작업

수정된 파일

적용된 패턴

빌드 검증

남은 Mock 모듈 (Backend API 개발 필요)

2026-01-09 (목) - Phase 1.3-1.5 건설관리 apiClient 표준화

작업 목표

수정된 파일

주요 변경 내용

1. 제거된 코드 (각 파일에서)

2. 추가된 코드

3. API 엔드포인트 (변경 없음)

빌드 검증

Git 커밋

2026-01-09 (목) - Phase 1.2 인수인계보고서 API 표준화

작업 목표

수정된 파일

주요 변경 내용

1. 제거된 코드

2. 추가된 코드

3. API 엔드포인트 (변경 없음)

빌드 검증

Git 커밋

2026-01-09 (목) - Phase 2.4 수주관리 API 연동

작업 목표

수정된 파일

주요 변경 내용

1. common_codes 공용 코드 시스템

2. 상태 매핑 함수

3. API 함수 구현 (10개)

Git 커밋

빌드 검증

2026-01-09 (목) - TODO-1 결재선/참조 Select 버그 수정

작업 목표

수정된 파일

주요 변경 내용

1. SelectValue 버그 수정

2. @/lib/api barrel export

빌드 검증

2026-01-09 (목) - Phase 2.3 자재관리(품목관리) API 연동

작업 목표

수정된 파일

주요 변경 내용

1. 타입 변환 함수 추가

2. 품목유형 매핑

3. API 함수 구현 (8개)

4. Frontend 전용 필터링

관련 API 변경 (api 저장소)

관련 문서

2025-01-09 (목) - 작업지시 process_type → process_id FK 변환

작업 목표

수정된 파일

주요 변경 내용

1. types.ts - 타입 및 변환 함수

2. actions.ts - 서버 액션

3. WorkOrderCreate.tsx - 등록 폼

4. WorkOrderList.tsx / WorkOrderDetail.tsx - 목록/상세

빌드 검증

관련 API 변경 (api 저장소)

2025-01-09 (목) - 작업지시 코드 리뷰 기반 프론트엔드 개선

작업 목표

수정된 파일

주요 변경 내용

Git 커밋

관련 문서

2025-01-02 (목) - 견적 등록 자동산출 기능 구현

작업 목표

수정된 파일

주요 변경 내용

Git 커밋

관련 API

2025-01-02 (목) - 채권현황 동적월 지원 및 버그 수정

작업 목표

수정된 파일

주요 변경 내용

Git 커밋

31 KiB

Raw Permalink Blame History