test(api): 백엔드 테스트 커버리지 10% → 65.64% 확대

[cocoyoon]

Summary

• packages/api-server 테스트 커버리지를 10% → 65.64% 까지 확대 (+607 tests, 총 985개 lib 테스트)
• scripts/pre-push.sh tarpaulin 임계값을 10% → 65% 로 상향
• SeaORM mock feature 도입 + AppState.db를 Arc<DatabaseConnection> 으로 전환하여 단위 테스트에서 DB 의존 로직까지 커버

왜

기존 백엔드 lib 테스트는 주로 DTO 직렬화 스모크 테스트 수준이라 서비스/핸들러 로직의 회귀를 단위 테스트로 잡지 못했습니다. cargo test --lib가 실제 비즈니스 로직을 거의 실행하지 않는 상태였어서, DB 의존 함수까지 mock으로 검증 가능하도록 인프라부터 다시 세팅했습니다.

핵심 변경

테스트 인프라

• Cargo.toml: SeaORM mock feature 활성화 (dev-dependencies)
• AppState.db: DatabaseConnection → Arc<DatabaseConnection>
  • SeaORM mock feature는 DatabaseConnection 의 Clone derive를 제거하므로, Arc 래핑으로 cheap clone 지원
  • 호출부 174곳의 &state.db → state.db.as_ref() 일괄 변환
  • BackendGrpcService, SynonymManager, upsert_solution_embedding 시그니처도 Arc<DatabaseConnection> 기반으로 정리
• src/tests/fixtures.rs 신규: 엔티티 팩토리 (post/user/spot/solution/comment/badge/curation/... 등) + count_row(n) 헬퍼 (SeaORM PaginatorTrait::count mocking)
• src/tests/helpers.rs 확장: test_config, test_app_state, empty_mock_db, mock_db_with_query_results, mock_user, mock_admin_user

테스트 추가 (+607, 총 985개)

• 도메인 서비스/핸들러: posts, users, solutions, rankings, feed, votes, spots, comments, badges, categories, subcategories, earnings, post_magazines, post_likes, saved_posts, reports, search
• Admin: dashboard, curations, badges, synonyms, magazine_sessions, editorial_candidates
• Batch: badge_check, trending_calc, rank_update, retry_failed_items, click_aggregation, search_reindex, scheduler
• Services: storage/config, affiliate/config, search/synonym_manager, embedding/sync, decoded_ai_grpc/client, backend_grpc/server (0% → 커버)
• Middleware: auth (User 구조체)
• Core: error.rs, config.rs (AppConfig::from_env 전 경로), handlers.rs (/health 0% → 커버), utils/jwt.rs

빌드/CI

• scripts/pre-push.sh: TARPAULIN_FAIL_UNDER 기본값 10 → 65
• src/tests/architecture.rs::migration_no_duplicate_sequence: 기존 dev 에 merge된 m20260402_000001_add prefix 중복을 KNOWN_DUPLICATES 로 허용 (seaql_migrations 레코드와 호환 유지)
• scripts/check-migration-sync.sh: 6자리 순번이 없는 레거시 파일명(m20260409_add_image_dimensions)도 수용하도록 regex 완화

로컬 CI 검증 결과 (scripts/pre-push.sh 전 단계 통과)

단계	상태
1. cargo fmt --check	✅
2. cargo clippy -D warnings (migration, entity, decoded-api)	✅
3. cargo test --lib	✅ 985 passed, 0 failed
4. cargo deny check	✅
5. cargo tarpaulin --fail-under 65	✅ 65.64% (4,978 / 7,584 lines)
6. check-migration-sync.sh	✅ "DB와 코드 마이그레이션 목록 일치 (50개)"

커버리지 진행 스냅샷

Milestone	커버리지	테스트 수
Before	10.00%	378
20% 목표	20.75%	558
30% 목표	37.43%	685
40% 목표	46.46%	767
50% 목표	56.08%	863
60% 목표	64.97%	963
최종 (65% 게이트)	65.64%	985

Test plan

• cargo fmt --check
• cargo clippy -p migration -p entity -p decoded-api --all-targets -- -D warnings
• cargo test --lib — 985 passed
• cargo tarpaulin --lib --exclude-files 'src/entities/*' --fail-under 65 — 65.64%
• DATABASE_URL=... bash packages/api-server/scripts/check-migration-sync.sh — DB/코드 일치
• SKIP_FE_CI=1 DATABASE_URL=... bash scripts/git-pre-push.sh — 전체 로컬 CI 통과
• CI (GitHub Actions) 에서 동일 단계 재확인

Notes

• AppState.db 타입 변경은 기존 핸들러/서비스 호출부 174곳을 state.db.as_ref() 로 바꾸는 mechanical 패치입니다. SeaORM 쿼리 동작에는 변화 없습니다.
• migration_no_duplicate_sequence 의 KNOWN_DUPLICATES 는 이미 dev 에 배포된 레거시 충돌을 수용하기 위한 임시 조치입니다. 이후 신규 중복은 계속 차단됩니다.
• 기존 tests/integration_*.rs 의 &state.db 사용부도 동일 패턴으로 업데이트했습니다 (일부 파일은 여전히 #[ignore] 상태이므로 실 DB 필요).

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
decoded-app	Ready	Preview, Comment	Apr 10, 2026 5:48am