옥션스팟 Flutter: 경매 화면에서 API와 실시간 채널까지

이 저장소는 옥션스팟의 Flutter 클라이언트 코드를 담는다. 루트 README는 기본 Flutter 시작 문구라 서비스 기능의 증거로 쓰기 어렵다. 실제 구현은 루트 lib/와 pubspec.yaml에서 확인했다. 저장소 안의 auction_spot/lib/main.dart에는 별도의 기본 카운터 예제가 남아 있다. 어느 디렉터리를 실제 빌드·배포했는지는 정적 파일만으로 확정할 수 없으므로, 아래는 루트 앱 코드의 흐름이다. 루트 README · 루트 main.dart · 내부 시작 예제

냉정한 기술 평가

평가일: 2026-10-28 · 근거 커밋: abb91bc2abe406e821c55f362e9f209ea61c2db9. 공개 소스의 정적 평가이며 실제 운영 결과나 개인의 기여 범위를 확정하지 않는다.

• 구조·설계 — 양호 라우터, 인증 HTTP 클라이언트, 경매 REST 저장소, STOMP 채널이 별도 파일로 분리돼 있다. app_router.dart 15–72행 auction_repository.dart 8–72행
• 구현 품질 — 위험 401 처리에서 같은 Dio 인스턴스로 토큰 갱신을 보내므로 갱신 요청도 같은 오류 인터셉터를 통과할 수 있다. 갱신 자체가 401인 경우 재진입·반복 요청 가능성을 코드에서 배제하지 못한다. dio_client.dart의 onError, 46–77행
• 운영 준비 — 보완 필요 요청·응답 본문 로깅이 실행 모드 조건 없이 등록된다. 인증 응답이나 사용 데이터가 진단 로그에 남을 수 있으므로 배포 설정에서 분리할 필요가 있다. 실제 로그 노출은 확인하지 않았다. dio_client.dart 17–21행
• 유지보수 — 양호 API 경로와 응답 변환이 기능별 저장소에 모여 있다. auction_repository.dart 13–67행

좋은 점: 화면·네트워크·실시간 이벤트의 모듈 경계가 읽힌다. 개선 우선순위: P1 — 갱신 전용 클라이언트 또는 갱신 경로 제외·동시 요청 조정을 넣고, 본문 로그를 개발 모드로 제한한다. 이는 만료 시 요청 폭주와 민감 데이터 기록 가능성을 줄인다.

앱 진입과 화면 경로

루트 main.dart는 Flutter 바인딩을 준비하고 Firebase 초기화를 시도한 뒤 Riverpod ProviderScope에서 앱을 시작한다. 초기화 오류는 debug 모드에서 기록하고 계속 진행한다. app_router.dart는 splash·onboarding·login과 홈, 물품 등록, 채팅, 마이페이지를 배치하며 /item/:itemId, /auction/:auctionId, /chat/:roomId 상세 경로를 둔다. 이는 화면 이동을 위한 코드 구조이지 각 기능의 실제 서비스 성공을 검증했다는 뜻은 아니다. 앱 진입 · 라우터

REST 요청과 입찰 이벤트

DioClient는 API 기본 URL과 10초 연결·응답 제한을 설정한다. 요청 인터셉터가 저장된 액세스 토큰을 Bearer 헤더에 넣고, 401 응답에서 리프레시 토큰이 있으면 갱신 뒤 원래 요청을 재시도한다. 로그 인터셉터는 요청·응답 본문 출력으로 설정돼 있다. 이 코드만으로 토큰 갱신 동시성이나 운영 로그의 안전성을 보장할 수 없다. HTTP 클라이언트

AuctionRepository는 오늘의 경매, 상세, 입찰 목록·제출, 결과를 /auctions/... REST 경로로 요청하고 응답 모델로 변환한다. AuctionWsClient는 STOMP로 /topic/auctions/{auctionId}를 구독해 이벤트 스트림에 전달하며 3초 재연결 간격을 설정한다. 경매 결과와 실시간 이벤트가 화면에 어떻게 합쳐지는지는 이 두 파일만으로 모두 확인하지 않았다. REST 경매 저장소 · STOMP 클라이언트

입찰 제출 메서드는 경매 ID와 가격을 POST하고, 백엔드 입찰 서비스는 행 잠금·입찰 금액·즉시 낙찰 조건을 검사한 뒤 이벤트를 발행하는 경로를 둔다. 이는 두 저장소의 코드에서 요청과 처리 단계를 나란히 확인한 것이다. 실제 앱 화면에서 서버까지 성공적으로 전달됐는지는 실행 확인하지 않았다. 클라이언트 placeBid 46–57행 · 서버 placeBid 39–117행

이미지 업로드와 백엔드 연결

StorageRepository.uploadItemImage는 파일 바이트를 multipart file 필드에 담아 /storage/upload로 POST하고 응답의 url을 돌려준다. 파일 확장자로 JPEG·PNG·WebP·GIF MIME을 정한다. AppConstants.baseUrl은 로컬 API의 /api/v1이고 Android 에뮬레이터에서는 호스트 주소를 10.0.2.2로 바꾼다. 따라서 클라이언트가 만드는 전체 경로는 옥션스팟 API의 업로드 컨트롤러 경로와 대응한다. 요청·응답 계약의 정적 대응을 확인한 것이며 두 저장소의 실제 통합 실행을 확인한 것은 아니다. 업로드 호출 · API 주소 · 서버 컨트롤러

확인한 기술과 한계

루트 pubspec.yaml에는 Flutter·Riverpod·go_router·Dio·secure storage·geolocator·STOMP·Firebase Messaging 의존성이 선언돼 있다. 선언은 실제 사용 여부를 각각 증명하지 않으므로 위에서 읽은 코드의 Flutter, Riverpod, Dio, STOMP만 구체적 흐름으로 설명했다. 루트 의존성

검토 기준은 abb91bc2abe406e821c55f362e9f209ea61c2db9의 위 파일이다. 앱 빌드, 서버 통합, 입찰 실시간 전달, 푸시 수신은 실행하지 않았다. 개인 담당 범위와 기술 선택 이유·성과도 확인하지 못했다. 루트 README와 실제 앱 코드의 정보량 차이를 남겨 향후 문서 갱신 때 확인할 수 있게 한다.