1.2. 프로젝트 상세 (Project Detail)

프로젝트 상세 페이지는 역할 기반 대시보드(Role-based Dashboard) 방식으로 전면 개편되었습니다. 현재 로그인한 사용자의 역할(Seller 또는 Buyer)에 따라 맞춤형 화면이 자동으로 표시되며, 거래 진행 상황을 한눈에 파악할 수 있도록 설계되었습니다.

💬 Lyra에게 시켜보세요
"이 프로젝트 문서 상태 알려줘"
"CI 기반으로 PL 폼 채워줘"
"이 프로젝트 데이터 Excel로 뽑아줘"
자세한 기능 안내: Lyra 인터랙티브 기능 가이드

1. 역할 기반 대시보드 (Role-based Dashboard)

프로젝트에 접속하면 나의 역할(actorType)에 따라 대시보드가 자동으로 분기됩니다.

역할	대시보드 유형	KPI 거래 상대방 표시
`seller`, `seller_forwarder`	Seller Dashboard	Buyer
`buyer`, `buyer_forwarder`	Buyer Dashboard	Seller

파트너(상대방)와 화면이 다르게 보이는 것은 정상입니다. 동일한 프로젝트를 각자의 역할에 맞는 관점으로 보여줍니다.

프로젝트 상세 - 역할 기반 대시보드

화면 상단에는 프로젝트의 기본 요약 정보가 표시됩니다.

프로젝트 유형 배지: Import(녹청색), Export(파란색), Intermediary
예상 기간: 예상 시작일 ~ 종료일 (설정된 경우에만 표시)
멤버 칩 (Member Chips): 프로젝트 참여 멤버가 이니셜 아바타 + 이름 + 역할로 표시됩니다.
actorType 아바타 색상
seller 파란색
buyer 청록색
seller_forwarder 주황색
buyer_forwarder 보라색

actorType	아바타 색상
`seller`	파란색
`buyer`	청록색
`seller_forwarder`	주황색
`buyer_forwarder`	보라색

3. 마일스톤 타임라인 (Milestone Track)

거래 흐름에 따른 핵심 마일스톤을 가로 타임라인으로 시각화합니다.

마일스톤은 날짜 비례 위치에 배치됩니다.
파란 진행선: 오늘 날짜 위치까지 자동 표시되어 현재 거래 진행 위치를 직관적으로 파악합니다.
같은 날짜의 마일스톤은 하나의 마커에 통합 표시됩니다.

마일스톤 타임라인

마일스톤 마커 상태:

상태	표시	설명
`done`	파란 마커	완료된 마일스톤
`progress` / `review`	파란 마커 + 바운스 애니메이션	현재 진행 중
`todo` (기한 초과)	빨간 마커 + 펄스 애니메이션	지연(Overdue) 마일스톤
`todo` (기한 미도래)	회색 마커	미래 마일스톤

4. KPI 카드 (4개)

페이지 중앙에 거래의 핵심 지표를 나타내는 카드 4개가 표시됩니다.

KPI 카드 4개

카드	표시 내용	비고
Counterparty	거래 상대방 이름 및 역할	Seller 뷰: Buyer 표시 / Buyer 뷰: Seller 표시
Trade Amount	총 거래 금액 + 인코텀즈	USD($), EUR(€), KRW(₩) 통화 기호 자동 적용
Progress	전체 작업 진행률 (%)	완료/전체 태스크 수, 진행률 바 포함
Payment ✨	결제 마일스톤 리스트 + CRUD 모달	T/T, L/C, D/P, D/A, Escrow, O/A, CAD 중 선택

Payment 카드 상세 ✨ NEW

Payment KPI 카드는 단순한 요약을 넘어 마일스톤 CRUD가 가능한 인터랙티브 카드로 확장되었습니다.

카드 내부에 결제 마일스톤 리스트(차수·금액·방법·예정일·상태)가 스크롤 형태로 표시됩니다.
카드 상단 + Add 버튼 → 결제 마일스톤 추가 모달
- 금액, 통화, 결제 방법(method) 선택 (T/T / L/C / D/P / D/A / Escrow / O/A / CAD)
- 예정일(Due Date), 설명 입력
각 행의 Edit / **Delete**로 마일스톤 수정·삭제
Escrow로 설정한 마일스톤은 escrow_cases 테이블과 자동 동기화되어 3.2. 토큰 에스크로에서 동일한 내역을 볼 수 있습니다.
리스트 하단에 SUBTOTAL / TAX / SHIPPING 합계 섹션이 새로 추가되어, 세금·운임을 포함한 총액을 한눈에 확인합니다.

결제 마일스톤 추가 모달

5. 하단 3단 섹션

KPI 카드 아래 3개의 정보 섹션이 나란히 표시됩니다.

Trade Summary (무역 요약) — 인코텀즈·ETD·적재항/양하항·선박명·포워더 등 화물과 선적의 핵심 정보
Shipping Documents (선적 서류 현황) — 등록된 무역 서류 목록과 각 서류의 처리 상태
Recent Activity (최근 활동) — 프로젝트 내 최근 활동 내역

Trade Summary (무역 요약)

화물 및 선적 관련 핵심 정보를 한눈에 확인합니다.

항목	설명
Incoterms	인코텀즈 조건 (예: CIF, FOB, EXW)
ETD	예상 출항일 (Estimated Time of Departure)
Port of Loading	적재항
Port of Discharge	양하항
Vessel	선박명
Forwarder	포워더 담당자 (미지정 시 `Not Assigned` 표시)

Shipping Documents (선적 서류 현황)

등록된 무역 서류 목록과 각 서류의 처리 상태를 확인합니다.

상태	색상	의미
Ready	녹청색	서류 등록 및 검토 완료
Pending	주황색	처리 중 (progress / review / analysing)
Not Started	회색	미등록 또는 미착수

지원 서류 약어: CI (Commercial Invoice), PL (Packing List), BL (Bill of Lading), COO (Certificate of Origin), COI (Certificate of Insurance), PI (Proforma Invoice), PO (Purchase Order), QT (Quotation), Health Certificate(위생증명서) ✨

서류는 Documents(문서) 탭에서 업로드하거나, Calendar 탭의 태스크에 문서를 연결하면 이 목록에 자동으로 반영됩니다.

Recent Activity (최근 활동)

프로젝트 내 최근 활동 내역이 시간 순서대로 표시됩니다.

활동 시간은 상대적으로 표시됩니다: 방금 전, X시간 전, 어제, 또는 정확한 날짜
시스템 자동 기록과 멤버 작성 내용이 모두 포함됩니다.

6. 프로젝트 내비게이션 메뉴 (ProjectNaviMenu)

페이지 상단의 내비게이션 메뉴를 통해 프로젝트 하위 섹션으로 이동할 수 있습니다.

Calendar: 일정, 간트 차트, 태스크 상태 보드 관리 → 가이드
Documents / DocuBox: 무역 서류 업로드 및 관리 → 가이드
Freight & Insurance: 화물 운송 및 보험 정보 → 가이드
Payment: 대금 지불 및 에스크로 현황 → 가이드
Comments / Parties(거래 당사자): 멘션 코멘트 및 외부 공유 링크 관리 → 가이드

💡 문제 해결 (FAQ)

화면에 보이는 내용

Q: "상대방(파트너)과 화면이 다르게 보입니다."
- A: 정상입니다. TFlow는 역할 기반 대시보드를 제공하므로 Seller와 Buyer는 같은 프로젝트를 각자의 관점으로 봅니다. KPI 카드의 "Counterparty" 항목에서 상대방 정보를 확인할 수 있습니다.
Q: "마일스톤이 빨간색으로 깜빡입니다."
- A: 기한(endDate)이 지났지만 상태가 여전히 todo인 마일스톤은 Overdue(지연)로 표시됩니다. Calendar 탭에서 해당 작업의 상태를 업데이트하세요.
Q: "Shipping Documents에 서류가 표시되지 않습니다."
- A: 서류는 Documents 탭에서 업로드하거나, Calendar 탭의 태스크에 문서를 연결하면 이 목록에 자동으로 반영됩니다.

상태 변경과 멤버 초대

Q: "상태를 완료(Done)로 변경하려고 하는데 에러가 납니다."
- 에러코드/현상: CANNOT_CLOSE_PROJECT_MISSING_DOCS
- A: Documents(문서) 탭에서 필수 운송 서류 업로드가 누락되지 않았는지 확인하세요. "Cannot close project without confirmed shipping documents" 메시지가 표시되면 서류 등록 후 다시 시도하세요.
Q: "외부 파트너사를 프로젝트에 초대할 수 없나요?"
- 에러코드/현상: USER_NOT_FOUND_IN_FRIENDS
- A: 외부 계정은 Parties(거래 당사자) 탭의 보안 링크를 통해 읽기 권한으로 공유하는 것이 원칙입니다. 편집 권한을 부여하려면 My Friends 등록을 먼저 완료한 후 프로젝트 멤버로 추가할 수 있습니다.
Q: "상태를 완료(Done)로 설정했다가 다시 진행 중으로 되돌릴 수 있나요?"
- 에러코드/현상: PROJECT_STATUS_ROLLBACK
- A: 네, 가능합니다. Calendar 탭 또는 내비게이션 메뉴를 통해 상태를 이전 단계로 롤백할 수 있습니다.