[Feat] 계약서 내보내기

[MeongW]

🚀 관련 이슈

🔑 주요 변경사항

✔️ 체크 리스트

• Merge 하려는 브랜치가 올바른가? (main branch에 실수로 PR 생성 금지)
• Merge 하려는 PR 및 Commit들을 로컬에서 실행했을 때 에러가 발생하지 않았는가?
• 라벨을 등록했는가?
• 리뷰어를 지정했는가?

📢 To Reviewers

📸 스크린샷 or 실행영상

↗️ 개선 사항

Summary by CodeRabbit

• New Features

  • CORS 활성화로 타 도메인에서의 요청/파일 업로드 지원
  • 업로드 한도 및 버퍼 확장으로 대용량 전송 지원(파일/요청 크기·개수 제한 설정)

• Bug Fixes

  • 전자서명 업로드와 PDF 생성 흐름 안정화(빈 값 처리, 상태 저장 일관성, 로그 보강)

• Chores

  • 배포 파이프라인 인증 토큰 및 구성 업데이트
  • 서비스 계정 파일을 빌드 산출물에 포함하여 외부 연동 안정성 향상

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

• CI 워크플로우에서 서브모듈 인증 토큰을 GHCR_TOKEN으로 변경하고 Firebase 서비스 계정 JSON을 리소스에 복사합니다.
• 최종계약 DTO의 서명 필드를 String에서 byte[]로 변경했습니다.
• 서명 처리/익스포트 흐름을 보강하고 Redis 상태 저장 타이밍과 로그를 추가했습니다.
• CORS 설정 빈을 추가하고 활성화했습니다.
• 멀티파트 업로드/서블릿 제한을 구성하는 설정을 추가/조정했습니다.

Changes

Cohort / File(s)	Change Summary
CI/CD Workflow .github/workflows/cd.yml	서브모듈 체크아웃 토큰을 ${{ secrets.GHCR_TOKEN }}로 변경; config-submodule/firebase-service-account.json을 src/main/resources/로 복사하는 단계 추가
Final Contract DTO (signature bytes) src/main/java/.../dto/SaveFinalContractDTO.java	서명 필드 4종을 String→byte[]로 변경; toDTO에서 일부 플래그 매핑 제거
Signature handling & export flow src/main/java/.../service/ContractServiceImpl.java, src/main/java/.../service/ContractExportSyncService.java	Base64 서명 디코딩 및 byte[] 적용; 데이터 URL 프리픽스 보정; 서명 완료 조건/로그 강화; Redis 상태 선저장/재저장; PDF 생성 전 최신 상태 재조회; 대기 시간 2s→200ms
Security CORS config src/main/java/.../auth/config/SecurityConfig.java	CorsConfigurationSource 빈 추가 및 http.cors() 활성화; 허용 오리진/메서드/헤더/노출헤더/크리덴셜/캐시시간 설정
Multipart & server limits src/main/java/.../global/config/MultipartConfig.java, src/main/java/.../global/config/WebConfig.java	멀티파트 설정 신규 클래스 추가(위치/최대 크기/threshold, MAX_FILE_COUNT=100); WebSocket 버퍼, 파일/파라미터/POST 제한 설정; FILE_SIZE_THRESHOLD 5MB→1MB

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant ContractService as ContractServiceImpl
  participant Redis
  participant ExportSync as ContractExportSyncService
  participant PDF as PDF Generator
  participant WS as WebSocket

  Client->>ContractService: 서명 데이터 제출 (Base64 또는 바이트)
  ContractService->>ContractService: 데이터 URL 제거/디코딩 → byte[]
  ContractService->>Redis: 상태 저장(서명 진행 상황)
  ContractService->>ExportSync: 익스포트 트리거

  ExportSync->>ExportSync: 서명 프리픽스 보정/검증
  ExportSync->>Redis: 상태 저장(소유자/매수인 완료 여부)
  ExportSync->>Redis: 최종 상태 재조회
  ExportSync->>PDF: 최종 PDF 생성 요청
  PDF-->>ExportSync: 생성 결과
  ExportSync->>Redis: 최종 상태 저장
  ExportSync->>WS: 진행/완료 브로드캐스트

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• [FEAT] 계약서 : 대기 / 정보조회 / 금액조정 #84: ContractServiceImpl의 단계 진행/엔드포인트 변경과 본 PR의 서명 처리/익스포트 흐름 수정이 동일 영역을 다룸
• [FEAT] 적법성 검사 #86: ContractServiceImpl 및 관련 DTO 수정이 겹치며 서명 데이터 경로가 충돌할 가능성 있음

Suggested labels

✨ feature

Poem

귀 쫑긋 토끼가 톡톡, 바이트를 꾹꾹 담아
문자열 대신 바삭한 배열, 사인도 착착 정리해요.
레디스에 소식 전하고, PDF는 뚝딱!
CORS는 문 활짝, 파일길도 반듯반듯.
깡총! 오늘도 배포 밟고, 달빛 아래 머지 완료 🐇✨

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

---

📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

• MCP integration is disabled by default for public repositories
• Jira integration is disabled by default for public repositories
• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between a879a79 and d5ba1b5.

📒 Files selected for processing (7)

• .github/workflows/cd.yml (2 hunks)
• src/main/java/org/scoula/domain/contract/dto/SaveFinalContractDTO.java (1 hunks)
• src/main/java/org/scoula/domain/contract/service/ContractExportSyncService.java (4 hunks)
• src/main/java/org/scoula/domain/contract/service/ContractServiceImpl.java (14 hunks)
• src/main/java/org/scoula/global/auth/config/SecurityConfig.java (4 hunks)
• src/main/java/org/scoula/global/config/MultipartConfig.java (1 hunks)
• src/main/java/org/scoula/global/config/WebConfig.java (2 hunks)

✨ Finishing Touches

• 📝 Generate Docstrings

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/contract-export

---

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

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

• Visit our Status Page to check the current availability of CodeRabbit.
• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.