Skip to content

feat: 문서 상세 조회 및 HWP/HWPX 업로드 지원 - #91

Draft
chaeliki wants to merge 8 commits into
mainfrom
feat/80-document-detail-hwp
Draft

feat: 문서 상세 조회 및 HWP/HWPX 업로드 지원#91
chaeliki wants to merge 8 commits into
mainfrom
feat/80-document-detail-hwp

Conversation

@chaeliki

@chaeliki chaeliki commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

요약

Closes #80

fowoco/client PR #174, #228에서 fowoco/server의 통합 문서함 API(#13)를
실제 화면에 연동하며 발견된 문제들을 해결합니다.

GET /documents 응답에 version이 없어 DocumentDetailPage의 확인/반려
버튼이 실제 API를 호출하지 못하고 있었고, 단건 조회 API가 없어 프론트가
전체 목록에서 직접 찾아야 했습니다. 또한 POST /files가 HWP/HWPX를
지원하지 않아 관련 업로드 UI(#158)가 데모 상태로 남아있었습니다.

완료된 범위 (진행 중)

  • DocumentItemResponse에 version, task_id 필드 추가
  • GET /documents/{documentId} 단건 조회 API 신설
    • Worker·Task 참조, 연결된 파일 정보(이름·MIME·크기·검사 상태) 포함
    • 정상 조회, 타 사업장 접근 차단(404) 통합 테스트 추가

아직 진행 중

  • HWP/HWPX MIME 타입 추가
    • HWPX: application/hwp+zip (한컴 공식 확인)로 MIME 검증 가능
    • HWP: 공식 MIME 타입이 없어, OLE Compound File 내부 FileHeader 스트림의 signature("HWP Document File") 확인이 필요 (파일 시그니처 검증)
    • [Document][P0] 문서 상세 조회·상태 표현·HWP/HWPX 업로드 보완 #80 확장자만 믿지 않고 MIME·크기·파일 시그니처 정책을 함께 검증에
      따라, HWP는 시그니처 검증까지 구현 예정

검증

  • ./gradlew clean test
  • GET /documents/{documentId} 정상 조회 (version, task_id, 파일 정보 포함)
  • GET /documents/{documentId} 타 사업장 접근 시 404
  • DocumentItemResponse 목록 조회에 version, task_id 포함 확인

참고

@chaeliki chaeliki added area:server Spring Boot API·도메인·DB·tenant·Task Workflow 영역; Prompt·모델·Provider 구현 제외 priority:P0 MVP 진행을 막는 최우선 핵심 작업 security:privacy 개인정보·접근권한·토큰·보안 영향이 있는 작업 type:feature 사용자 또는 Agent가 사용하는 기능 개발 labels Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:server Spring Boot API·도메인·DB·tenant·Task Workflow 영역; Prompt·모델·Provider 구현 제외 priority:P0 MVP 진행을 막는 최우선 핵심 작업 security:privacy 개인정보·접근권한·토큰·보안 영향이 있는 작업 type:feature 사용자 또는 Agent가 사용하는 기능 개발

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Document][P0] 문서 상세 조회·상태 표현·HWP/HWPX 업로드 보완

1 participant