feat(API): standarisasi response API dengan ResponseCode enum dan penambahan struktur meta

- Menambahkan ResponseCode enum untuk standarisasi semua response API.
- Integrasi meta data: nomor rekening, periode, request_id, dan reference_code.
- Memperbarui validasi input dengan response code standar (INVALID_FIELD).
- Struktur response dibuat konsisten untuk success dan error.
- Logging diperkuat untuk debugging dan monitoring.
This commit is contained in:
Daeng Deni Mardaeni
2025-08-27 17:07:57 +07:00
parent ffdb528360
commit e53b522f77
5 changed files with 217 additions and 47 deletions

View File

@@ -10,6 +10,7 @@ use Modules\Webstatement\Http\Requests\DetailedBalanceRequest;
use Modules\Webstatement\Services\AccountBalanceService;
use Modules\Webstatement\Http\Resources\BalanceSummaryResource;
use Modules\Webstatement\Http\Resources\DetailedBalanceResource;
use Modules\Webstatement\Enums\ResponseCode;
use Exception;
class AccountBalanceController extends Controller
@@ -30,17 +31,16 @@ class AccountBalanceController extends Controller
public function getBalanceSummary(BalanceSummaryRequest $request): JsonResponse
{
try {
$accountNumber = $request->input('account_number');
$startDate = $request->input('start_date');
$endDate = $request->input('end_date');
$startDate = $request->input('start_date');
$endDate = $request->input('end_date');
Log::info('Account balance summary requested', [
'account_number' => $accountNumber,
'start_date' => $startDate,
'end_date' => $endDate,
'ip' => $request->ip(),
'user_agent' => $request->userAgent()
'start_date' => $startDate,
'end_date' => $endDate,
'ip' => $request->ip(),
'user_agent' => $request->userAgent()
]);
$result = $this->accountBalanceService->getBalanceSummary(
@@ -49,21 +49,49 @@ class AccountBalanceController extends Controller
$endDate
);
return (new BalanceSummaryResource($result))->response();
if (empty($result)) {
return response()->json(
ResponseCode::DATA_NOT_FOUND->toResponse(
null,
'Data saldo tidak ditemukan untuk nomor rekening: ' . $accountNumber
),
ResponseCode::DATA_NOT_FOUND->getHttpStatus()
);
}
return response()->json(
ResponseCode::SUCCESS->toResponse(
(new BalanceSummaryResource($result))->toArray($request),
),
ResponseCode::SUCCESS->getHttpStatus()
);
} catch (Exception $e) {
Log::error('Error getting account balance summary', [
'error' => $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine(),
'file' => $e->getFile(),
'line' => $e->getLine(),
'trace' => $e->getTraceAsString()
]);
return response()->json([
'success' => false,
'message' => 'Terjadi kesalahan saat mengambil data saldo',
'error' => config('app.debug') ? $e->getMessage() : null
], 500);
$responseCode = match ($e->getCode()) {
404 => ResponseCode::DATA_NOT_FOUND,
401 => ResponseCode::UNAUTHORIZED,
403 => ResponseCode::UNAUTHORIZED,
408 => ResponseCode::TIMEOUT,
503 => ResponseCode::SERVICE_UNAVAILABLE,
400 => ResponseCode::INVALID_FIELD,
default => ResponseCode::SYSTEM_MALFUNCTION
};
return response()->json(
$responseCode->toResponse(
null,
config('app.debug') ? $e->getMessage() : 'Terjadi kesalahan sistem'
),
$responseCode->getHttpStatus()
);
}
}
}