Feat: 외부 포트폴리오 조회 응답에 status 및 originalFileName 추가

[hyoinkang]

Summary

외부 포트폴리오 조회 응답에 status 및 originalFileName 추가

Changes

• 외부 포트폴리오 조회 응답 구조 변경
• originalFileName 저장 로직 추가
• 기업분석정보 조회 명세 정합화

Type of Change

해당하는 항목에 체크해주세요:

• Bug fix (기존 기능을 수정하는 변경)
• New feature (새로운 기능 추가)
• Breaking change (기존 기능에 영향을 주는 변경)
• Refactoring (기능 변경 없이 코드 개선)
• Documentation (문서 변경)
• Chore (빌드, 설정 등)

Target Environment

배포 대상 브랜치를 선택해주세요:

• Dev (dev)
• Prod (main)

Related Issues

관련 이슈를 연결해주세요:

• Closes [Feat] 기업분석정보 및 포트폴리오 pdf 추출 조회 응답에 status 추가 #379

Testing

테스트 방법을 작성해주세요:

• Postman/Swagger로 API 호출 확인
• 단위 테스트 통과
• E2E 테스트 통과

Checklist

PR 생성 전 확인사항:

• 코드 컨벤션을 준수했습니다 (docs/development/CODE_STYLE.md)
• Git 컨벤션을 준수했습니다 (docs/development/GIT_CONVENTIONS.md)
• 네이밍 컨벤션을 준수했습니다 (docs/development/NAMING_CONVENTIONS.md)
• 로컬에서 빌드가 성공합니다 (pnpm run build)
• 로컬에서 린트가 통과합니다 (pnpm run lint)
• (API 변경 시) Swagger 문서가 업데이트되었습니다
• (필요 시) 테스트 코드를 작성했습니다

Screenshots (Optional)

UI 변경이 있다면 스크린샷을 첨부해주세요.

Additional Notes

리뷰어에게 전달할 추가 정보가 있다면 작성해주세요.

[Copilot]

Pull request overview

Updates the portfolio-correction module’s external portfolio retrieval API to return extraction status and originalFileName, and persists the original filename on extract requests. Also aligns parts of the portfolio-correction API documentation/spec with recent response changes.

Changes:

• Add original_file_name column to portfolio_correction and persist originalFileName during external portfolio extraction.
• Change GET /external-portfolios response to a wrapper DTO including { status, originalFileName, portfolios } (and update Swagger/docs).
• Add status to GET /portfolio-corrections/{correctionId} response DTO and adjust company-insight Swagger error responses.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
supabase/migrations/20260419153000_add_original_file_name_to_portfolio_correction.sql	Adds original_file_name column for persistence.
src/modules/portfolio-correction/presentation/services/external-portfolio-extract-request-parser.service.ts	Normalizes uploaded filename when parsing multipart extract requests.
src/modules/portfolio-correction/presentation/services/external-portfolio-extract-request-parser.service.spec.ts	Adds tests for Korean filename normalization (latin1 mojibake, NFD→NFC).
src/modules/portfolio-correction/presentation/portfolio-correction.controller.ts	Updates Swagger error response list for company-insight endpoint.
src/modules/portfolio-correction/presentation/external-portfolio.controller.ts	Changes external portfolios GET to return wrapper DTO; updates Swagger decorator usage.
src/modules/portfolio-correction/presentation/decorators/portfolio-correction-swagger.decorator.ts	Adds ApiCorrectionIdResponse decorator for non-array responses.
src/modules/portfolio-correction/domain/portfolio-correction.entity.ts	Adds originalFileName column mapping.
src/modules/portfolio-correction/application/services/portfolio-correction.service.ts	Adds updateOriginalFileName service method.
src/modules/portfolio-correction/application/facades/external-portfolio.facade.ts	Saves originalFileName on extract; returns wrapper DTO including status + filename.
src/modules/portfolio-correction/application/facades/external-portfolio.facade.spec.ts	Updates/extends tests for new behavior (status wrapper, filename normalization).
src/modules/portfolio-correction/application/dtos/external-portfolio.dto.ts	Introduces ExternalPortfolioListResDTO and response filename normalization.
src/modules/portfolio-correction/application/dtos/correction-result.dto.ts	Adds status field to correction detail response DTO.
docs/API.md	Documents updated response shapes for affected endpoints.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이번 변경은 외부 포트폴리오 조회 API의 응답 구조를 개선하여 사용자 경험을 향상시키는 데 목적이 있습니다. 특히 파일 업로드 시 발생할 수 있는 인코딩 문제를 해결하기 위한 정규화 로직을 도입하고, 관련 데이터베이스 스키마와 API 명세를 최신화하여 시스템의 안정성과 데이터 일관성을 확보했습니다.

Highlights

• 응답 구조 개선: 외부 포트폴리오 조회 응답에 status와 originalFileName 필드를 추가하여 클라이언트가 포트폴리오 처리 상태와 원본 파일명을 명확히 확인할 수 있도록 변경했습니다.
• 파일 이름 정규화 로직 추가: 다양한 인코딩 환경(Latin1 깨짐, NFD 등)에서 업로드된 파일명이 올바르게 표시되도록 정규화 로직을 구현하여 한글 파일명 처리의 안정성을 높였습니다.
• 데이터베이스 및 API 명세 업데이트: 데이터베이스에 original_file_name 컬럼을 추가하고, 관련 API 응답 DTO와 Swagger 문서를 업데이트하여 정합성을 맞췄습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Ignored Files

• Ignored by pattern: *.md (1)
  • docs/API.md

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request introduces the originalFileName and status fields to the PortfolioCorrection entity and its associated DTOs, supported by a database migration and updates to the facade and controller layers. It also implements complex normalization logic to handle filename encoding issues (mojibake) and Unicode normalization (NFC/NFD). The review feedback identifies that this normalization logic is duplicated across the DTO and the request parser service, suggesting it be refactored into a common utility to improve maintainability and ensure consistency.