린트 체크 및 테스트 실행 가이드

이 문서는 Baron SSO 프로젝트의 각 모듈별 정적 분석(Lint) 및 테스트 수행 방법을 설명합니다.

1. 준비 사항

테스트를 실행하기 위해 다음 도구들이 설치되어 있어야 합니다.

Docker & Docker Compose (백엔드 인프라 의존성용)
Go 1.26.2+
Flutter SDK
Node.js 24 LTS+

2. 모듈별 실행 명령어

2.1 Backend (Go)

백엔드 테스트는 Redis와 ClickHouse 컨테이너가 실행 중이어야 합니다.

# 인프라 서비스 실행
docker compose -f compose.infra.yaml up -d redis clickhouse

cd backend

# 린트 및 포맷 확인
go fmt ./...
go vet ./...

# 유닛 테스트 실행
export REDIS_ADDR=localhost:6379 CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT_NATIVE=9000
go test ./...

2.2 Userfront (Flutter)

cd userfront

# 코드 포맷 확인
dart format --output=none --set-exit-if-changed lib test

# 정적 분석 (경고/정보 메시지는 무시)
flutter analyze --no-fatal-warnings --no-fatal-infos

# 유닛 및 위젯 테스트
flutter test

2.3 Adminfront & Devfront (React)

Biome을 사용하여 린트 및 포맷팅을 관리하며, Playwright로 E2E 테스트를 수행합니다.

cd adminfront # 또는 cd devfront

# 린트 및 포맷 자동 수정
npx biome check --write .

# 안전하지 않은 규칙까지 포함하여 자동 수정 (필요 시)
npx biome check --write --unsafe .

# E2E 테스트 실행
npm test

2.4 i18n 검증

코드 내에서 사용되는 다국어 키와 locales/*.toml 파일 간의 정합성을 검증합니다.

# 프로젝트 루트에서 실행
node tools/i18n-scanner/index.js
node tools/i18n-scanner/report.js

# 결과 확인
cat reports/i18n-report.txt

3. 통합 실행 (Batch)

프로젝트 루트의 스크립트를 통해 전체 과정을 한 번에 시도할 수 있습니다.

bash run_local_checks.sh

4. 정리 (Cleanup)

테스트 완료 후 실행 중인 테스트용 인프라 서비스를 종료합니다.

docker compose -f compose.infra.yaml down

2.1 KiB Raw Blame History