Files
sam-manage/app/Http/Controllers/DevTools/FlowTesterController.php
kent aa1fd76a99 feat: Flow Tester 기능 개선 및 안정화
- FlowTesterController: 테스트 실행 로직 개선
  - 에러 핸들링 강화
  - 응답 형식 표준화
- FlowExecutor: API 호출 실행기 개선
  - 다단계 플로우 지원 강화
  - 변수 바인딩 및 검증 개선
- index.blade.php: UI 개선
  - 테스트 결과 표시 개선
  - 사용성 향상
- routes/web.php: 라우트 정리
- composer.lock: 의존성 업데이트

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-21 01:35:54 +09:00

510 lines
16 KiB
PHP

<?php
namespace App\Http\Controllers\DevTools;
use App\Http\Controllers\Controller;
use App\Models\Admin\AdminApiFlow;
use App\Models\Admin\AdminApiFlowRun;
use App\Services\FlowTester\FlowExecutor;
use Illuminate\Http\Request;
use Illuminate\View\View;
/**
* API Flow Tester Controller
*
* API 플로우 테스트 도구 컨트롤러
*/
class FlowTesterController extends Controller
{
/**
* 플로우 목록
*/
public function index(): View
{
$flows = AdminApiFlow::with(['runs' => fn ($q) => $q->latest()->limit(1)])
->orderByDesc('created_at')
->paginate(20);
// 세션에 저장된 토큰 (API Explorer와 공유)
$savedToken = session('api_explorer_token');
$selectedUserId = session('api_explorer_user_id');
$selectedUser = $selectedUserId ? \App\Models\User::find($selectedUserId) : null;
return view('dev-tools.flow-tester.index', compact('flows', 'savedToken', 'selectedUser'));
}
/**
* 플로우 생성 폼
*/
public function create(): View
{
return view('dev-tools.flow-tester.create');
}
/**
* 플로우 저장
*/
public function store(Request $request)
{
$validated = $request->validate([
'name' => 'required|string|max:100',
'description' => 'nullable|string',
'category' => 'nullable|string|max:50',
'flow_definition' => 'required|json',
]);
$validated['flow_definition'] = json_decode($validated['flow_definition'], true);
$validated['created_by'] = auth()->id();
$flow = AdminApiFlow::create($validated);
return redirect()
->route('dev-tools.flow-tester.edit', $flow->id)
->with('success', '플로우가 생성되었습니다.');
}
/**
* 플로우 편집 폼
*/
public function edit(int $id): View
{
$flow = AdminApiFlow::findOrFail($id);
return view('dev-tools.flow-tester.edit', compact('flow'));
}
/**
* 플로우 수정
*/
public function update(Request $request, int $id)
{
$flow = AdminApiFlow::findOrFail($id);
$validated = $request->validate([
'name' => 'required|string|max:100',
'description' => 'nullable|string',
'category' => 'nullable|string|max:50',
'flow_definition' => 'required|json',
'is_active' => 'boolean',
]);
$validated['flow_definition'] = json_decode($validated['flow_definition'], true);
$validated['updated_by'] = auth()->id();
$flow->update($validated);
return redirect()
->route('dev-tools.flow-tester.edit', $flow->id)
->with('success', '플로우가 수정되었습니다.');
}
/**
* 플로우 삭제
*/
public function destroy(int $id)
{
$flow = AdminApiFlow::findOrFail($id);
$flow->delete();
// AJAX 요청인 경우 JSON 응답 반환
if (request()->ajax() || request()->wantsJson()) {
return response()->json([
'success' => true,
'message' => '플로우가 삭제되었습니다.',
]);
}
return redirect()
->route('dev-tools.flow-tester.index')
->with('success', '플로우가 삭제되었습니다.');
}
/**
* 플로우 복제
*/
public function clone(int $id)
{
$original = AdminApiFlow::findOrFail($id);
$clone = $original->replicate();
$clone->name = $original->name.' (복사본)';
$clone->created_by = auth()->id();
$clone->updated_by = null;
$clone->save();
return redirect()
->route('dev-tools.flow-tester.edit', $clone->id)
->with('success', '플로우가 복제되었습니다.');
}
/**
* JSON 유효성 검사 및 메타 정보 추출
*/
public function validateJson(Request $request)
{
$json = $request->input('flow_definition', '');
try {
$data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
// 기본 구조 검증
$errors = [];
if (! isset($data['steps']) || ! is_array($data['steps'])) {
$errors[] = 'steps 배열이 필요합니다.';
} else {
foreach ($data['steps'] as $i => $step) {
if (empty($step['id'])) {
$errors[] = "steps[{$i}]: id가 필요합니다.";
}
if (empty($step['method'])) {
$errors[] = "steps[{$i}]: method가 필요합니다.";
}
if (empty($step['endpoint'])) {
$errors[] = "steps[{$i}]: endpoint가 필요합니다.";
}
}
}
if (! empty($errors)) {
return response()->json([
'valid' => false,
'errors' => $errors,
]);
}
// meta 정보 추출 (최상위 또는 meta 객체에서)
$meta = $data['meta'] ?? [];
$tags = $meta['tags'] ?? [];
// 카테고리 추론: 최상위 category > tags[0] > endpoint에서 추출 (login 제외)
$category = $data['category'] ?? $tags[0] ?? null;
if (! $category && ! empty($data['steps'])) {
// login, auth, refresh, logout 등 인증 관련 엔드포인트는 건너뛰고 추출
$authEndpoints = ['/login', '/logout', '/refresh', '/auth'];
foreach ($data['steps'] as $step) {
$endpoint = $step['endpoint'] ?? '';
// 인증 엔드포인트가 아닌 첫 번째 스텝에서 카테고리 추출
if (! in_array($endpoint, $authEndpoints) && preg_match('#^/([^/]+)#', $endpoint, $matches)) {
$category = $matches[1];
break;
}
}
}
// 이름 추론: 최상위 name > meta.name > description 첫 부분
$name = $data['name'] ?? $meta['name'] ?? null;
if (! $name) {
$description = $data['description'] ?? $meta['description'] ?? null;
if ($description) {
// 설명의 첫 번째 줄 또는 50자까지
$name = mb_substr(strtok($description, "\n"), 0, 50);
}
}
// 설명 추론: 최상위 description > meta.description
$description = $data['description'] ?? $meta['description'] ?? null;
return response()->json([
'valid' => true,
'stepCount' => count($data['steps'] ?? []),
'extracted' => [
'name' => $name,
'description' => $description,
'category' => $category,
'author' => $meta['author'] ?? null,
'tags' => $tags,
'version' => $data['version'] ?? '1.0',
],
]);
} catch (\JsonException $e) {
return response()->json([
'valid' => false,
'errors' => ['JSON 파싱 오류: '.$e->getMessage()],
]);
}
}
/**
* 플로우 실행
*/
public function run(int $id)
{
$flow = AdminApiFlow::findOrFail($id);
// 실행 기록 생성
$run = AdminApiFlowRun::create([
'flow_id' => $flow->id,
'status' => AdminApiFlowRun::STATUS_RUNNING,
'started_at' => now(),
'total_steps' => $flow->step_count,
'executed_by' => auth()->id(),
]);
try {
// FlowExecutor로 실제 실행
$executor = new FlowExecutor;
$result = $executor->execute($flow->flow_definition);
// 실행 결과 저장
$run->update([
'status' => $result['status'],
'completed_at' => now(),
'duration_ms' => $result['duration'],
'completed_steps' => $result['completedSteps'],
'failed_step' => $result['failedStep'],
'execution_log' => $result['executionLog'],
'error_message' => $result['errorMessage'],
'api_logs' => $result['apiLogs'] ?? [],
]);
return response()->json([
'success' => $result['status'] === 'SUCCESS',
'run_id' => $run->id,
'status' => $result['status'],
'message' => $this->getResultMessage($result),
'result' => $result,
]);
} catch (\Exception $e) {
// 예외 발생 시 실패 처리
$run->update([
'status' => AdminApiFlowRun::STATUS_FAILED,
'completed_at' => now(),
'error_message' => $e->getMessage(),
]);
return response()->json([
'success' => false,
'run_id' => $run->id,
'status' => 'FAILED',
'message' => '실행 오류: '.$e->getMessage(),
], 500);
}
}
/**
* 실행 결과 메시지 생성
*/
private function getResultMessage(array $result): string
{
return match ($result['status']) {
'SUCCESS' => "플로우 실행 완료! ({$result['completedSteps']}/{$result['totalSteps']} 스텝 성공)",
'FAILED' => '플로우 실행 실패: '.($result['errorMessage'] ?? '알 수 없는 오류'),
'PARTIAL' => "부분 성공: {$result['completedSteps']}/{$result['totalSteps']} 스텝 완료",
default => "실행 완료 (상태: {$result['status']})",
};
}
/**
* 실행 상태 조회 (Polling)
*/
public function runStatus(int $runId)
{
$run = AdminApiFlowRun::findOrFail($runId);
return response()->json([
'status' => $run->status,
'progress' => $run->progress,
'completed_steps' => $run->completed_steps,
'total_steps' => $run->total_steps,
'is_completed' => $run->isCompleted(),
'execution_log' => $run->execution_log,
]);
}
/**
* 실행 이력 목록
*/
public function history(int $id): View
{
$flow = AdminApiFlow::findOrFail($id);
$runs = $flow->runs()
->orderByDesc('created_at')
->paginate(20);
return view('dev-tools.flow-tester.history', compact('flow', 'runs'));
}
/**
* 실행 상세 보기
*/
public function runDetail(int $runId): View
{
$run = AdminApiFlowRun::with('flow')->findOrFail($runId);
return view('dev-tools.flow-tester.run-detail', compact('run'));
}
/*
|--------------------------------------------------------------------------
| Token & User Management (API Explorer와 공유)
|--------------------------------------------------------------------------
*/
/**
* API 서버에 직접 로그인하여 토큰 발급
*
* MNG에서 토큰을 발급하면 API 서버에서 인식하지 못하므로,
* API 서버에 직접 로그인하여 토큰을 발급받습니다.
*/
public function loginToApi(Request $request)
{
$validated = $request->validate([
'user_id' => 'required|string',
'user_pwd' => 'required|string',
]);
try {
// API Base URL 결정
$baseUrl = $this->getApiBaseUrl();
// Docker 환경에서는 내부 URL로 변환
$requestUrl = $baseUrl.'/login';
$headers = ['Accept' => 'application/json', 'Content-Type' => 'application/json'];
if ($this->isDockerEnvironment()) {
$parsedUrl = parse_url($baseUrl);
$host = $parsedUrl['host'] ?? '';
// *.sam.kr 도메인을 nginx 컨테이너로 라우팅
if (str_ends_with($host, '.sam.kr') || $host === 'sam.kr') {
$headers['Host'] = $host;
$requestUrl = preg_replace('#https?://[^/]+#', 'https://nginx', $baseUrl).'/login';
}
}
// API 서버에 로그인 요청
$response = \Illuminate\Support\Facades\Http::withHeaders($headers)
->withoutVerifying() // Docker 내부 SSL 인증서 무시
->timeout(10)
->post($requestUrl, [
'user_id' => $validated['user_id'],
'user_pwd' => $validated['user_pwd'],
]);
if (! $response->successful()) {
$body = $response->json();
return response()->json([
'success' => false,
'message' => $body['message'] ?? '로그인 실패: '.$response->status(),
], 401);
}
$body = $response->json();
$token = $body['access_token'] ?? $body['data']['token'] ?? null;
if (! $token) {
return response()->json([
'success' => false,
'message' => '토큰을 받지 못했습니다. 응답: '.json_encode($body, JSON_UNESCAPED_UNICODE),
], 500);
}
// 세션에 저장 (API Explorer와 공유)
session([
'api_explorer_token' => $token,
'api_explorer_user_id' => $body['user']['id'] ?? null,
'api_explorer_user_name' => $body['user']['name'] ?? $validated['user_id'],
]);
return response()->json([
'success' => true,
'message' => 'API 서버 로그인 성공!',
'user' => $body['user'] ?? ['name' => $validated['user_id']],
'token_preview' => substr($token, 0, 20).'...',
]);
} catch (\Exception $e) {
return response()->json([
'success' => false,
'message' => 'API 서버 연결 실패: '.$e->getMessage(),
], 500);
}
}
/**
* API Base URL 결정
*/
private function getApiBaseUrl(): string
{
// 환경변수 우선
$envUrl = env('FLOW_TESTER_API_BASE_URL');
if ($envUrl) {
return rtrim($envUrl, '/');
}
// config에서 로컬 환경 URL
$environments = config('api-explorer.default_environments', []);
foreach ($environments as $env) {
if ($env['name'] === '로컬') {
return rtrim($env['base_url'], '/');
}
}
// 기본값
return 'https://api.sam.kr';
}
/**
* Docker 환경인지 확인
*/
private function isDockerEnvironment(): bool
{
return file_exists('/.dockerenv') || (getenv('DOCKER_CONTAINER') === 'true');
}
/**
* Bearer 토큰 저장 (직접 입력)
*/
public function saveToken(Request $request)
{
$validated = $request->validate([
'token' => 'required|string',
]);
// API Explorer와 같은 세션 키 사용
session([
'api_explorer_token' => $validated['token'],
'api_explorer_user_id' => null, // 직접 입력 시 사용자 정보 없음
]);
return response()->json([
'success' => true,
'message' => '토큰이 저장되었습니다.',
]);
}
/**
* Bearer 토큰 초기화
*/
public function clearToken()
{
session()->forget(['api_explorer_token', 'api_explorer_user_id']);
return response()->json([
'success' => true,
'message' => '인증이 초기화되었습니다.',
]);
}
/**
* 현재 토큰 상태 조회
*/
public function tokenStatus()
{
$token = session('api_explorer_token');
$userId = session('api_explorer_user_id');
$user = $userId ? \App\Models\User::find($userId) : null;
return response()->json([
'has_token' => ! empty($token),
'token_preview' => $token ? substr($token, 0, 20).'...' : null,
'user' => $user ? [
'id' => $user->id,
'name' => $user->name,
'email' => $user->email,
] : null,
]);
}
}