feat: [시공관리] 계약관리 API 구현
- Contract 모델, 마이그레이션 추가 - ContractController CRUD 엔드포인트 구현 - ContractService 비즈니스 로직 구현 - ContractStoreRequest, ContractUpdateRequest 검증 추가 - Swagger API 문서 작성 - 라우트 등록 (GET/POST/PUT/DELETE) - 통계 및 단계별 건수 조회 API 추가 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,99 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1\Construction;
|
||||
|
||||
use App\Helpers\ApiResponse;
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Construction\ContractStoreRequest;
|
||||
use App\Http\Requests\Construction\ContractUpdateRequest;
|
||||
use App\Services\Construction\ContractService;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class ContractController extends Controller
|
||||
{
|
||||
public function __construct(private ContractService $service) {}
|
||||
|
||||
/**
|
||||
* 계약 목록 조회
|
||||
*/
|
||||
public function index(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->index($request->all());
|
||||
}, __('message.contract.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 상세 조회
|
||||
*/
|
||||
public function show(int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
return $this->service->show($id);
|
||||
}, __('message.contract.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 등록
|
||||
*/
|
||||
public function store(ContractStoreRequest $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->store($request->validated());
|
||||
}, __('message.contract.created'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 수정
|
||||
*/
|
||||
public function update(ContractUpdateRequest $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->update($id, $request->validated());
|
||||
}, __('message.contract.updated'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 삭제
|
||||
*/
|
||||
public function destroy(int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
$this->service->destroy($id);
|
||||
|
||||
return 'success';
|
||||
}, __('message.contract.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 일괄 삭제
|
||||
*/
|
||||
public function bulkDestroy(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
$this->service->bulkDestroy($request->input('ids', []));
|
||||
|
||||
return 'success';
|
||||
}, __('message.contract.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 통계 조회
|
||||
*/
|
||||
public function stats(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->stats($request->all());
|
||||
}, __('message.contract.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 계약 단계별 카운트 조회
|
||||
*/
|
||||
public function stageCounts(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->stageCounts($request->all());
|
||||
}, __('message.contract.fetched'));
|
||||
}
|
||||
}
|
||||
75
app/Http/Requests/Construction/ContractStoreRequest.php
Normal file
75
app/Http/Requests/Construction/ContractStoreRequest.php
Normal file
@@ -0,0 +1,75 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\Construction;
|
||||
|
||||
use App\Models\Construction\Contract;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class ContractStoreRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
// 기본 정보
|
||||
'contract_code' => 'required|string|max:50',
|
||||
'project_name' => 'required|string|max:255',
|
||||
|
||||
// 거래처 정보
|
||||
'partner_id' => 'nullable|integer',
|
||||
'partner_name' => 'nullable|string|max:255',
|
||||
|
||||
// 담당자 정보
|
||||
'contract_manager_id' => 'nullable|integer',
|
||||
'contract_manager_name' => 'nullable|string|max:100',
|
||||
'construction_pm_id' => 'nullable|integer',
|
||||
'construction_pm_name' => 'nullable|string|max:100',
|
||||
|
||||
// 계약 상세
|
||||
'total_locations' => 'nullable|integer|min:0',
|
||||
'contract_amount' => 'nullable|numeric|min:0',
|
||||
'contract_start_date' => 'nullable|date',
|
||||
'contract_end_date' => 'nullable|date|after_or_equal:contract_start_date',
|
||||
|
||||
// 상태 정보
|
||||
'status' => [
|
||||
'nullable',
|
||||
Rule::in([Contract::STATUS_PENDING, Contract::STATUS_COMPLETED]),
|
||||
],
|
||||
'stage' => [
|
||||
'nullable',
|
||||
Rule::in([
|
||||
Contract::STAGE_ESTIMATE_SELECTED,
|
||||
Contract::STAGE_ESTIMATE_PROGRESS,
|
||||
Contract::STAGE_DELIVERY,
|
||||
Contract::STAGE_INSTALLATION,
|
||||
Contract::STAGE_INSPECTION,
|
||||
Contract::STAGE_OTHER,
|
||||
]),
|
||||
],
|
||||
|
||||
// 연결 정보
|
||||
'bidding_id' => 'nullable|integer',
|
||||
'bidding_code' => 'nullable|string|max:50',
|
||||
|
||||
// 기타
|
||||
'remarks' => 'nullable|string',
|
||||
'is_active' => 'nullable|boolean',
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'contract_code.required' => __('validation.required', ['attribute' => '계약번호']),
|
||||
'contract_code.max' => __('validation.max.string', ['attribute' => '계약번호', 'max' => 50]),
|
||||
'project_name.required' => __('validation.required', ['attribute' => '현장명']),
|
||||
'contract_end_date.after_or_equal' => __('validation.after_or_equal', ['attribute' => '계약종료일', 'date' => '계약시작일']),
|
||||
];
|
||||
}
|
||||
}
|
||||
73
app/Http/Requests/Construction/ContractUpdateRequest.php
Normal file
73
app/Http/Requests/Construction/ContractUpdateRequest.php
Normal file
@@ -0,0 +1,73 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\Construction;
|
||||
|
||||
use App\Models\Construction\Contract;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class ContractUpdateRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
// 기본 정보
|
||||
'contract_code' => 'sometimes|string|max:50',
|
||||
'project_name' => 'sometimes|string|max:255',
|
||||
|
||||
// 거래처 정보
|
||||
'partner_id' => 'nullable|integer',
|
||||
'partner_name' => 'nullable|string|max:255',
|
||||
|
||||
// 담당자 정보
|
||||
'contract_manager_id' => 'nullable|integer',
|
||||
'contract_manager_name' => 'nullable|string|max:100',
|
||||
'construction_pm_id' => 'nullable|integer',
|
||||
'construction_pm_name' => 'nullable|string|max:100',
|
||||
|
||||
// 계약 상세
|
||||
'total_locations' => 'nullable|integer|min:0',
|
||||
'contract_amount' => 'nullable|numeric|min:0',
|
||||
'contract_start_date' => 'nullable|date',
|
||||
'contract_end_date' => 'nullable|date|after_or_equal:contract_start_date',
|
||||
|
||||
// 상태 정보
|
||||
'status' => [
|
||||
'nullable',
|
||||
Rule::in([Contract::STATUS_PENDING, Contract::STATUS_COMPLETED]),
|
||||
],
|
||||
'stage' => [
|
||||
'nullable',
|
||||
Rule::in([
|
||||
Contract::STAGE_ESTIMATE_SELECTED,
|
||||
Contract::STAGE_ESTIMATE_PROGRESS,
|
||||
Contract::STAGE_DELIVERY,
|
||||
Contract::STAGE_INSTALLATION,
|
||||
Contract::STAGE_INSPECTION,
|
||||
Contract::STAGE_OTHER,
|
||||
]),
|
||||
],
|
||||
|
||||
// 연결 정보
|
||||
'bidding_id' => 'nullable|integer',
|
||||
'bidding_code' => 'nullable|string|max:50',
|
||||
|
||||
// 기타
|
||||
'remarks' => 'nullable|string',
|
||||
'is_active' => 'nullable|boolean',
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'contract_code.max' => __('validation.max.string', ['attribute' => '계약번호', 'max' => 50]),
|
||||
'contract_end_date.after_or_equal' => __('validation.after_or_equal', ['attribute' => '계약종료일', 'date' => '계약시작일']),
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user