feat(configuration): 파일 도메인 모델 및 규칙 정의 #26

[tlgms]

스택 PR 1/4 — base: develop
이후 PR은 이 브랜치를 base로 합니다. 순서대로 머지해 주세요.

Summary

• Document 파일 처리의 도메인 모델과 형식·용량·파일명 규칙을 정의합니다.
• Spring / AWS / JPA에 의존하지 않는 순수 Kotlin 모듈입니다 (deps.bzl은 비어 있는 상태 유지).

Related Issue

• Ref document 도메인 개발 #26 (스택의 마지막 PR에서 close 합니다)

Scope

• In scope: configuration-domain의 hs.kr.entrydsm.configuration.domain.document 패키지
• Out of scope: 어댑터 구현, REST / gRPC 노출, 트랜잭션 처리

Implementation

API 11종은 허용 확장자·용량 한도·object_key 명명 규칙이 API마다 다릅니다. 이 규칙이 컨트롤러나 어댑터에 흩어지면 원서 슬롯에 이미지가 올라가는 식의 사고를 막을 수 없어 도메인에 모았습니다.

• FileExtension — 확장자↔MIME 매핑. jpeg를 jpg 별칭으로 처리
• FileCategory — 용도별 object_key prefix, 허용 확장자 집합, 최대 용량. 전역 화이트리스트 하나로 두면 카테고리별 제한이 불가능해 카테고리가 자기 허용 집합을 갖습니다
• FileNaming — 명세 응답 예시와 동일한 파일명 생성(application_1001.pdf, photo_5f3c9a2b.jpg 등) + 경로 조작 방어
• 예외 6종 — 명세 에러 코드와 1:1 (INVALID_FILE_FORMAT, FILE_TOO_LARGE, FILE_NOT_FOUND, STORAGE_UPLOAD_FAILED, PRESIGN_FAILED)
• 포트 — port/in 3종, port/out 2종. 참조 구현(EnvironmentVariable)과 동일하게 -application이 아니라 -domain에 둡니다

#7 지원자 목록 excel 다운은 fileName이 그대로 S3 키에 붙으므로 requireSafeFileName으로 경로 구분자·상위 경로 참조를 거부합니다.

Testing

• Unit tests — 도메인 규칙 테스트 12개 (확장자 인식, 카테고리별 허용/용량, 명세와 동일한 파일명 생성, 경로 조작 거부)
• Integration tests
• Manual verification

bazel test //systems/configuration/...

Deployment Notes

• Feature flag: 없음
• Migration required: 없음 (이 PR 범위 한정)
• Rollout considerations: 도메인 모듈만 추가되며 기존 동작에 영향 없음

Checklist

• Matches product/tech requirements
• Backward compatibility considered
• Docs updated if applicable

리뷰 시 봐주셨으면 하는 것

1. 용량 한도가 임의값입니다 — 명세에 수치가 없어 문서 10MB / 사진 5MB / 첨부 20MB로 정했습니다. 팀 기준이 있으면 알려주세요.
2. .hwp MIME — 표준이 없어 application/x-hwp로 고정했습니다.
3. BUILD.bazel 수정 포함 — 기존 test 타깃이 :main에 의존하지 않아 도메인 클래스를 참조하는 테스트가 컴파일되지 않았습니다. 함께 고쳤습니다. kt_jvm_test는 test_class를 하나만 받아 document_test 타깃을 별도로 추가했습니다.
4. 파일이 21개지만 예외·포트가 4~11줄짜리라 실질 리뷰량은 크지 않습니다.

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• ready-for-review

🚫 Excluded labels (none allowed) (2)

• wip
• do-not-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f604da3e-ae74-419d-9aeb-16d7d258eaef

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat(document)-파일-도메인-모델-#26

• 🛠️ cleanup stale imports
• 🛠️ harden error messages
• 🛠️ test clarity pass

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}