Files
sam-api/app/Http/Controllers/Api/V1/QuoteController.php
권혁성 e364239572 feat: 견적 참조 데이터 API, 수주 전환 로직 개선, 검사기준서 필드 통합
- 견적 참조 데이터(현장명, 부호) 조회 API 추가 (GET /quotes/reference-data)
- 수주 전환 시 floor_code/symbol_code를 quoteItem.note에서 파싱하도록 변경
- 수주 전환 시 note에 formula_category 저장
- 검사기준서 프리셋: standard + standard_criteria → text_with_criteria로 통합
- tolerance 컬럼 width 조정 (120px → 85px)
- LOGICAL_RELATIONSHIPS.md 문서 갱신

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 23:07:08 +09:00

291 lines
8.9 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Quote\QuoteBomBulkCalculateRequest;
use App\Http\Requests\Quote\QuoteBomCalculateRequest;
use App\Http\Requests\Quote\QuoteBulkDeleteRequest;
use App\Http\Requests\Quote\QuoteCalculateRequest;
use App\Http\Requests\Quote\QuoteIndexRequest;
use App\Http\Requests\Quote\QuoteSendEmailRequest;
use App\Http\Requests\Quote\QuoteSendKakaoRequest;
use App\Http\Requests\Quote\QuoteStoreRequest;
use App\Http\Requests\Quote\QuoteUpdateRequest;
use App\Services\Quote\QuoteCalculationService;
use App\Services\Quote\QuoteDocumentService;
use App\Services\Quote\QuoteNumberService;
use App\Services\Quote\QuoteService;
use Illuminate\Support\Facades\Log;
class QuoteController extends Controller
{
public function __construct(
private QuoteService $quoteService,
private QuoteNumberService $numberService,
private QuoteCalculationService $calculationService,
private QuoteDocumentService $documentService
) {}
/**
* 견적 목록 조회
*/
public function index(QuoteIndexRequest $request)
{
return ApiResponse::handle(function () use ($request) {
return $this->quoteService->index($request->validated());
}, __('message.quote.fetched'));
}
/**
* 견적 단건 조회
*/
public function show(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->quoteService->show($id);
}, __('message.quote.fetched'));
}
/**
* 견적 생성
*/
public function store(QuoteStoreRequest $request)
{
// DEBUG: 요청 데이터 로깅
Log::info('[QuoteController::store] 원본 요청:', [
'author' => $request->input('author'),
'manager' => $request->input('manager'),
'contact' => $request->input('contact'),
'remarks' => $request->input('remarks'),
]);
$validated = $request->validated();
// DEBUG: validated 데이터 로깅
Log::info('[QuoteController::store] validated 데이터:', [
'author' => $validated['author'] ?? 'NOT_SET',
'manager' => $validated['manager'] ?? 'NOT_SET',
'contact' => $validated['contact'] ?? 'NOT_SET',
'remarks' => $validated['remarks'] ?? 'NOT_SET',
]);
return ApiResponse::handle(function () use ($validated) {
return $this->quoteService->store($validated);
}, __('message.quote.created'));
}
/**
* 견적 수정
*/
public function update(QuoteUpdateRequest $request, int $id)
{
return ApiResponse::handle(function () use ($request, $id) {
return $this->quoteService->update($id, $request->validated());
}, __('message.quote.updated'));
}
/**
* 견적 삭제
*/
public function destroy(int $id)
{
return ApiResponse::handle(function () use ($id) {
$this->quoteService->destroy($id);
return null;
}, __('message.quote.deleted'));
}
/**
* 견적 일괄 삭제
*/
public function bulkDestroy(QuoteBulkDeleteRequest $request)
{
return ApiResponse::handle(function () use ($request) {
$count = $this->quoteService->bulkDestroy($request->validated()['ids']);
return ['deleted_count' => $count];
}, __('message.quote.bulk_deleted'));
}
/**
* 견적 확정
*/
public function finalize(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->quoteService->finalize($id);
}, __('message.quote.finalized'));
}
/**
* 견적 확정 취소
*/
public function cancelFinalize(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->quoteService->cancelFinalize($id);
}, __('message.quote.finalize_cancelled'));
}
/**
* 수주 전환
*/
public function convertToOrder(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->quoteService->convertToOrder($id);
}, __('message.quote.converted'));
}
/**
* 입찰 전환
* 시공 견적을 입찰로 변환합니다.
*/
public function convertToBidding(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->quoteService->convertToBidding($id);
}, __('message.bidding.converted'));
}
/**
* 참조 데이터 조회 (현장명, 부호 목록)
*/
public function referenceData()
{
return ApiResponse::handle(function () {
return $this->quoteService->referenceData();
}, __('message.fetched'));
}
/**
* 견적번호 미리보기
*/
public function previewNumber(?string $productCategory = null)
{
return ApiResponse::handle(function () use ($productCategory) {
return $this->numberService->preview($productCategory);
}, __('message.fetched'));
}
/**
* 자동산출 미리보기
*/
public function calculate(QuoteCalculateRequest $request)
{
return ApiResponse::handle(function () use ($request) {
$validated = $request->validated();
return $this->calculationService->calculate(
$validated['inputs'] ?? $validated,
$validated['product_category'] ?? null
);
}, __('message.quote.calculated'));
}
/**
* BOM 기반 자동산출 (10단계 디버깅 포함)
*
* React 견적등록 화면에서 완제품 코드와 입력 변수를 받아
* BOM 기반으로 품목/단가/금액을 계산합니다.
*/
public function calculateBom(QuoteBomCalculateRequest $request)
{
return ApiResponse::handle(function () use ($request) {
return $this->calculationService->calculateBom(
$request->finished_goods_code,
$request->getInputVariables(),
$request->boolean('debug', false)
);
}, __('message.quote.calculated'));
}
/**
* 다건 BOM 기반 자동산출
*
* React 견적등록 화면에서 여러 품목의 완제품 코드와 입력 변수를 받아
* BOM 기반으로 일괄 계산합니다.
* React QuoteFormItem 필드명(camelCase)과 API 변수명(약어) 모두 지원합니다.
*/
public function calculateBomBulk(QuoteBomBulkCalculateRequest $request)
{
return ApiResponse::handle(function () use ($request) {
return $this->calculationService->calculateBomBulk(
$request->getInputItems(),
$request->boolean('debug', false)
);
}, __('message.quote.bulk_calculated'));
}
/**
* 자동산출 입력 스키마 조회
*/
public function calculationSchema(?string $productCategory = null)
{
return ApiResponse::handle(function () use ($productCategory) {
return $this->calculationService->getInputSchema($productCategory);
}, __('message.fetched'));
}
/**
* 견적서 PDF 생성
*/
public function generatePdf(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->documentService->generatePdf($id);
}, __('message.quote.pdf_generated'));
}
/**
* 견적서 이메일 발송
*/
public function sendEmail(QuoteSendEmailRequest $request, int $id)
{
return ApiResponse::handle(function () use ($request, $id) {
return $this->documentService->sendEmail($id, $request->validated());
}, __('message.quote_email_sent'));
}
/**
* 견적서 카카오톡 발송
*/
public function sendKakao(QuoteSendKakaoRequest $request, int $id)
{
return ApiResponse::handle(function () use ($request, $id) {
return $this->documentService->sendKakao($id, $request->validated());
}, __('message.quote_kakao_sent'));
}
/**
* 발송 이력 조회
*/
public function sendHistory(int $id)
{
return ApiResponse::handle(function () use ($id) {
return $this->documentService->getSendHistory($id);
}, __('message.fetched'));
}
/**
* 품목 단가 조회
*
* 품목 코드 배열을 받아 단가를 조회합니다.
* 수동 품목 추가 시 단가를 조회하여 견적금액에 반영합니다.
*/
public function getItemPrices(\Illuminate\Http\Request $request)
{
$request->validate([
'item_codes' => 'required|array|min:1',
'item_codes.*' => 'required|string',
]);
return ApiResponse::handle(function () use ($request) {
return $this->calculationService->getItemPrices($request->input('item_codes'));
}, __('message.fetched'));
}
}