<aside> 💾 Repository ↔ Service ↔ Postgres 3-layer. 모든 repo 가 단일 pgxpool.Pool 공유. · 원본: docs/architecture/internal/storage/README.md

</aside>

Service → Repository → Postgres 3-layer. 모든 repo 가 단일 pgxpool.Pool 공유.

🧰 Repository 인터페이스 + 공유 타입

원본: docs/architecture/internal/storage/README.md

책임 — ContentRepository / RawContentRepository / ParsingRuleRepository / SampleURLRepository 인터페이스 + Filter / 에러 / ValidationStatus.

적용된 패턴 —

• Repository — 인터페이스만 정의, 구현 분리
• Sentinel error — ErrNotFound · ErrDuplicate

구현 디테일 —

• 테이블: contents · content_bodies · content_meta · raw_contents · parsing_rules · parsing_rule_sample_urls · schema_migrations

🧠 Service Layer

원본: docs/architecture/internal/storage/service.md

책임 — 순수 CRUD 이상의 비즈니스 로직 — 중복 감지 · 일괄 저장 · validation status 업데이트 · Claim Check 정리.

알고리즘 / 동작 —

• ContentService.Store: ContentHash(제목+본문) 동일 시 기존 ID 반환 — Title/PublishedAt 갱신만 또는 무시
• RawContentService.Delete: idempotent (Claim Check 정리)

적용된 패턴 —

• Service Layer — repo 위 로직 캡슐화
• Idempotent operations — Delete · Store 결과 isDuplicate flag

관련 이슈 — #134 Claim Check · #135/#161 validation_status 영속화