🔨 Fix - 가격 계산 API 응답값 OCR 가격, OnedayScan 가격 추가

[GiHwan2]

Related issue 🛠

closed #782

어떤 변경사항이 있었나요?

• 🔨 Fix: Feature change or bug fix

CheckPoint ✅

PR이 다음 요구 사항을 충족하는지 확인하세요.

• PR 컨벤션에 맞게 작성했습니다. (필수)
• 코드가 정상적으로 동작합니다. (필수)
• 코드 리뷰어에게 리뷰를 요청했습니다. (필수)

Work Description ✏️

가격 계산 API 응답값에 OCR 가격과 OnedayScan 가격 정보를 추가했습니다.

주요 변경사항

• EstimateUserOrderPriceResponseDto: estimated_ocr_price, estimated_one_day_scan_price 필드 추가
• Document 엔티티: getEstimatedOcrPrice(), getEstimatedOneDayScanPrice() 메서드 추가
• DocumentService: 제본 옵션 가격 계산 로직 수정 (400페이지까지 기본 3,000원, 이후 300페이지당 3,000원)

기능 개선사항

• 가격 견적 API에서 예상 OCR 비용과 당일 스캔 비용을 별도로 제공하여 사용자가 옵션별 비용을 더 명확하게 파악할 수 있도록 개선
• 제본 옵션 가격 정책 변경으로 더 합리적인 요금 체계 적용

Uncompleted Tasks 😅

N/A

To Reviewers 📢

• 가격 계산 로직의 변경사항을 확인해 주세요 (제본 옵션 가격 정책)
• 새로 추가된 예상 가격 필드들이 올바르게 계산되는지 검토해 주세요

Summary by CodeRabbit

• 신규 기능

  • 가격 견적 응답에 예상 OCR 비용과 당일 스캔 예상 비용을 추가했습니다. 문서별 항목과 전체 합계가 함께 제공됩니다.
  • SPRING 복구 옵션의 가격 규칙을 조정했습니다: 기본 포함 분량을 400페이지로 확대하고, 초과분은 300페이지당 3,000원 단위로 계산됩니다.

• 기타

  • 내부 계산 로직을 최신 규칙에 맞게 정리하고 주석을 업데이트했습니다.

[coderabbitai]

Walkthrough

문서 도메인에 추정 가격 메서드 2개가 추가되고, 복구 옵션 가격 계산 로직의 기준·구간이 변경되었습니다. 응답 DTO에는 문서별·총합 추정 가격 필드가 추가되며, 빌더/집계 로직이 확장되어 새 추정 값을 포함합니다. 공개 API 시그니처는 유지됩니다.

Changes

Cohort / File(s)	Summary of changes
Domain: Document estimated prices src/main/java/com/tookscan/tookscan/order/domain/Document.java	무조건적 추정 가격 메서드 2개 추가: getEstimatedOcrPrice(), getEstimatedOneDayScanPrice(); 기존 게이팅 로직과 무관하게 페이지 수 기반 계산.
Service: Recovery option pricing rule update src/main/java/com/tookscan/tookscan/order/domain/service/DocumentService.java	SPRING 복구 옵션 가격 규칙 변경: 기본 커버 범위 300→400페이지, 추가 구간 100p/1,000원→300p/3,000원, 계산식 갱신; 공개 API 변화 없음.
API DTO: Estimated price fields and aggregation src/main/java/com/tookscan/tookscan/order/presentation/dto/response/EstimateUserOrderPriceResponseDto.java	최상위 및 문서별 추정 OCR/당일스캔 가격 필드 추가, JSON 프로퍼티 매핑 및 NotNull 지정, 빌더/생성자 확장, fromEntity 및 of(...)에서 합계 집계 로직 추가.

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant Controller
  participant Service
  participant Document
  participant DTO

  Client->>Controller: 견적 요청
  Controller->>Service: 주문/문서 조회 후 가격 계산
  loop 각 문서
    Service->>Document: getEstimatedOcrPrice(), getEstimatedOneDayScanPrice()
    Document-->>Service: 추정 가격 반환
  end
  Service->>DTO: 문서별 정보 매핑 및 추정 가격 합계 설정
  DTO-->>Controller: EstimateUserOrderPriceResponseDto
  Controller-->>Client: 응답(JSON)

Loading

sequenceDiagram
  participant Service
  participant PricingRule

  Service->>PricingRule: SPRING 복구 옵션 계산(pageCount)
  alt pageCount <= 400
    PricingRule-->>Service: 3,000
  else pageCount > 400
    PricingRule-->>Service: 3,000 + ceil((pageCount-400)/300)*3,000
  end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

토끼 발끝 튕기며 코드숲 달려가,
페이지 셈하며 OCR 꿈을 더해봐.
하루 스캔 바람 타고 숫자들이 춤추네,
400 넘은 길엔 300씩 콩콩쾅!
새 견적 담은 바구니, 삐약 삐약 JSON 봄. 🐇📄💨

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: Free

💡 Knowledge Base configuration:

• Jira integration is disabled
• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between c82c00b and 9caff80.

📒 Files selected for processing (3)

• src/main/java/com/tookscan/tookscan/order/domain/Document.java (1 hunks)
• src/main/java/com/tookscan/tookscan/order/domain/service/DocumentService.java (1 hunks)
• src/main/java/com/tookscan/tookscan/order/presentation/dto/response/EstimateUserOrderPriceResponseDto.java (9 hunks)

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

🪧 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? Join our Discord community 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.