[CARECODE-014] 삭제된 API 문서 산출물(asciidoc/html/pdf) 관리 정책 확정

[RosieOh]

🧑‍💻 오늘의 개발하면서 생긴 크고 작은 이슈사항을 기록해주세요

💚 어떤 기능인가요?

API 문서 산출물(asciidoc/html/pdf) 관리 정책을 확정하고, 문서 생성 파이프라인과 저장소 상태를 일관화하는 작업입니다. 현재 산출물 삭제 변경이 워킹트리에 남아 있어 관리 정책 불일치가 드러난 상태입니다.

상세 배경

• src/docs/asciidoc 및 템플릿 파일 관리 정책이 불명확
• 생성 산출물을 버전관리할지, 생성물로만 다룰지 기준 부재
• 스크립트/입력(swagger.json)과 결과물 동기화 기준 필요

기대 효과

• 문서 관련 불필요한 diff 감소
• CI/CD에서 문서 생성 검증 신뢰도 향상
• 팀원 간 문서 운영 방식 일치

✅ To Dos

• API 문서 산출물의 버전관리 포함/제외 범위 확정
• generate-asciidoc.sh 실행 결과와 저장소 정책 정합성 점검
• swagger.json 입력 변경 시 문서 갱신 절차 정의
• .gitignore/문서 가이드 업데이트
• 정책 확정 후 현재 문서 변경 상태(삭제/복원) 일괄 정리 커밋

완료 조건

• 문서 생성/관리 정책이 문서화되어 누구나 동일하게 수행 가능
• 문서 산출물 관련 충돌/노이즈 diff 대폭 감소
• CI에서 문서 정합성 검증 가능

[RosieOh]

정책 확정 + 잔재 제거를 함께 했습니다.

정책: springdoc 런타임 생성만 쓰고 asciidoc/html/pdf 산출물은 만들지 않습니다 (#29).

제거: asciidoctorj, asciidoctorj-pdf 가 implementation 으로 선언돼 있었는데 .adoc 파일도 사용처도 0건이었습니다. 그런데 implementation 이라 실행 jar 에 그대로 들어가고 있었습니다.

	크기
제거 전	191 MB
제거 후	156 MB

JRuby 를 전이 의존성으로 끌고 와서 35MB 였습니다. 배포 이미지가 줄고 Trivy 스캔 표면도 함께 줄어듭니다.