Insurance category, coverage type, and period baseline (#120)

[tkdgusqkr]

Summary

• insurance_items 에 분류(PRIMARY/ADDON), 보장유형(유상운송종합/책임/시간제/원데이/기타), 기본 기간(unit + value) 컬럼 추가.
• rider_insurances 에 starts_at / ends_at / rider_bike_contract_id 추가 — 보험 라이프사이클 + 계약 연결 표현 가능.
• 4개 기본 보험 시드 (유상운송종합/책임 12개월 + 시간제 + 원데이). UUID 가 deterministic 이라 Slice A 의 `default_insurance_item_id` 가 향후 가리킬 수 있음.
• Service 검증: half-supplied default duration 거부, endsAt > startsAt 강제, 기존 unique 정책 유지.

Trace

• Target issue: Insurance category, coverage type, and period baseline #120
• Change-control issue: Change request: insurance category, coverage type, and period baseline clever-change-control#114
• Root project-start: Project start: thundercrew-domain MVP clever-change-control#45
• Builds on (no hard dep): Slice A — Contract template category, return type, and duration unit baseline #118 (default_insurance_item_id pointer)

Scope

Backend-only. Slice A 와 같은 패턴이며 보험 도메인만 건드림. 기존 unique 정책은 유지하고 ADDON 다중 발급(시작시점별 unique)은 후속 슬라이스로 분리.

Included:

• Flyway V8 + 시드 4개.
• `InsuranceCategory` / `InsuranceCoverageType` / `InsuranceDurationUnit` enum.
• `InsuranceItem` / `RiderInsurance` 엔티티 + Create/Update/Read DTO + Service.
• 통합 테스트 `InsuranceClassificationApiTests` (8 케이스).

Excluded:

• 자동 보험 발급 로직 (Slice D).
• ADDON 다중 발급 partial-unique 정책 변경 (후속).
• 라이더 교육 (Slice C — 별도 PR).
• 프론트 어드민 폼 (Slice E).

Validation

항목	결과
`./gradlew compileJava compileTestJava`	✅ BUILD SUCCESSFUL (19s)
`./gradlew test --tests ArchitectureBoundaryTests ScaffoldPackageSkeletonTests`	✅ BUILD SUCCESSFUL (24s)
Testcontainers 통합 테스트 (`./gradlew test` 전체)	⚠️ Docker 미설치로 sandbox 미실행. 리뷰어/IDE 환경 검증 필요.

Test plan

• IDE에서 `./gradlew test` 전체 (Testcontainers PostgreSQL 포함) 실행 → `InsuranceClassificationApiTests` 8개 통과 + 기존 `InsuranceItemCommandApiContractTests` / `RiderInsuranceCommandApiContractTests` / `ReadOnlyApiContractTests` 회귀 없음.
• V8 시드 4행이 dev DB 에 반영되는지 (`select count(*) from insurance_items where id like 22222222-2222-2222-2222-%` = 4).
• 기존 보험 행은 `category=PRIMARY` 디폴트로 보존되는지.
• 라이더-보험 링크 생성 시 `endsAt < startsAt` 가 `409 INVALID_STATE_TRANSITION` 으로 거부되는지.
• 어드민 웹 어드민 폼이 새 컬럼 없이 `name` / `description` / `enabled` 만 보내는 페이로드도 그대로 동작하는지 (legacy 호환).

Concurrent work gate

• Decision: `allowed-with-non-overlap`.
• Open target issues: Monitoring map background and global sidebar baseline #116 / Contract template category, return type, and duration unit baseline #118 (file-disjoint) / Insurance category, coverage type, and period baseline #120 (이 PR 타깃).
• Open target PRs: Monitoring map background and global sidebar baseline (#116) #117 / Contract template category, return type, and duration unit baseline (#118) #119 (file-disjoint).
• Open clever-change-control issues: Record AWS OIDC trust blocker after variable exposure #100 / Add service-ops-api contract template command baseline #24 / Add bike write-command baseline #23 (delivery server / msa-platform — 무관).

Note

Slice A (PR #119) 와 파일 충돌 0 — 다른 도메인. dev 머지 순서 무관. 향후 Slice D 에서 contract template + insurance item 자동 발급 로직을 도입할 때 두 슬라이스가 모두 머지된 상태가 전제.