ai-code-app/docs/components/evidence-attachment-strip-ui.md

Evidence Attachment Strip UI

목적

Plan/Board 계열 화면에서 반복되는 산출물 카드, 링크, 미리보기 진입 UI를 공통 스트립으로 정리하는 컴포넌트입니다.

공통 설계 원칙

• 샘플(samples)을 제외한 컴포넌트에는 API 호출이나 화면 전용 로직을 직접 넣지 않습니다.
• 컴포넌트는 최대한 멍청하게 설계하고, 직관적인 props를 받아 직관적인 UI 동작만 수행합니다.
• 기능 처리와 비즈니스 로직은 src/features 또는 해당 화면 전용 패키지 레벨에서 담당합니다.
• 공통 컴포넌트는 여러 곳에서 재사용되므로, 수정 시에는 기존 동작을 바꾸지 않는 범위에서만 보완합니다.

지원 타입

• image
• markdown
• code
• text
• json
• preview
• video
• audio
• pdf
• empty

주요 props

• attachments
• onPreview
• onCopy
• maxVisible
• compact
• emptyText
• title
• description

기본 액션

• 링크 열기
• 복사
• 미리보기 진입

적용 예시

• PlanBoardPage의 WorklogEvidenceTab 산출물 Preview 영역
• 작업일지/스크린샷/로그/preview 링크 혼합 카드 목록
• 모바일 보조 패널 또는 상세 모달의 compact 첨부 목록

확장 포인트

• EvidenceAttachmentPreviewBody를 별도 export 하므로 상세 모달 본문에서 같은 렌더러를 재사용할 수 있습니다.
• copyValue, language, format을 항목별로 제어해 코드/텍스트/경로형 산출물 표현을 조정할 수 있습니다.