QT(견적) 핸드셰이크
QT(Quotation, 견적) 핸드셰이크는 판매자(Seller)와 구매자(Buyer)가 하나의 견적 문서를 나란히 놓고 조건을 주고받는 화면입니다. 왼쪽 Seller 견적과 오른쪽 Buyer 견적을 줄 단위로 비교하며, 역제안(Counter)·수락(Accept)을 오가다가 합의되면 발주서(PO)가 자동으로 만들어집니다.
💡 누가 쓰나요? 바이어와 가격·수량·조건을 여러 번 조율해 견적을 확정해야 하는 무역 실무자. 이메일로 견적서를 왔다 갔다 하지 않고, 한 화면에서 어디가 달라졌는지를 보며 합의까지 끌고 갈 수 있습니다.
ℹ️ 권한 조건 — QT의 모든 액션(편집·저장·승인·Accept 등) 은 실행 전에 라이선스를 확인합니다. 라이선스가 없으면 열람은 되지만 액션 버튼을 누를 때 안내 모달이 뜹니다.
(라이선스 게이팅이 켜진 환경 한정 — 라이선스 참고)
🖼️ 화면 캡처 문서 뷰어 상단 뷰 모드 토글 — Single / Split / QT (QT 문서에서만 QT 버튼 노출) 📍
tflowx.com/projects/:id문서 뷰어 · 저장 위치images/app/qt-viewmode-toggle.png
1. 진입 — 문서 뷰어의 QT 모드
- 프로젝트의 문서 뷰어에서 견적(Quotation) 문서를 엽니다.
- 상단 뷰 모드 토글에서 모드를 고릅니다.
| 모드 | 설명 |
|---|---|
| Single | 한 문서만 크게 보기 |
| Split | 두 문서를 좌우로 나란히 보기 |
| QT | 견적 문서일 때만 나타나는 버튼. Seller↔Buyer 핸드셰이크 화면 |
- QT 를 누르면 견적 핸드셰이크 화면으로 전환됩니다.
ℹ️ QT 버튼은 열어 둔 문서가 견적(Quotation) 문서일 때만 나타납니다. 다른 종류의 문서에서는 Single/Split만 보입니다.
2. 화면 구성 — Seller ↔ Buyer 2분할과 diff
QT 화면은 좌우 2분할입니다.
| 영역 | 내용 |
|---|---|
| 왼쪽 (Seller) | 판매자 측 견적 — 버전 선택 + 견적 뷰어 |
| 가운데 핸들 | 좌우 폭을 조절하는 리사이즈 핸들 |
| 오른쪽 (Buyer) | 구매자 측 견적 — 버전 선택 + 견적 뷰어 |
- 각 페인에서 버전을 선택해 원하는 시점의 견적을 볼 수 있습니다.
- Seller와 Buyer의 값을 비교해 서로 다른 항목(행)은 하이라이트(diff) 로 강조됩니다. 어디가 바뀌었는지 한눈에 보입니다.
🖼️ 화면 캡처 QT Split View — 좌 Seller / 우 Buyer 견적 + 불일치 행 diff 하이라이트 📍
tflowx.com/projects/:id문서 뷰어(QT) · 저장 위치images/app/qt-split-diff.png
3. 상태머신 — 지금 할 수 있는 액션만
QT는 상태에 따라 가능한 동작만 버튼으로 보여 줍니다. 서버가 내려주는 canAct 값에 따라, 지금 내가 할 수 있는 액션만 나타납니다.
| 역할 | 할 수 있는 액션(상태에 따라 노출) |
|---|---|
| Seller(판매자) | 견적 편집·저장, 승인 요청/승인, 승인 취소, New Quote(새 견적), Accept Counter(역제안 수락), Send New Quote |
| Buyer(구매자) | Counter Offer(역제안), Send Offer, Accept(수락), Request Accept(수락 요청) |
- 지금 상황에서 할 수 없는 동작의 버튼은 아예 보이지 않습니다. 버튼이 안 보인다면 상대의 응답을 기다리는 차례이거나, 현재 상태에서 허용되지 않는 동작입니다.
- 모든 액션은 실행 직전 라이선스를 확인합니다.권한 조건
4. 합의 — Accept 시 자동 PO 생성, 승인 후 편집 잠금
- Buyer가 Accept(수락) 하면 그 견적을 바탕으로 발주서(PO)가 자동 생성됩니다.
- 견적이 종결됐는데 어떤 이유로 PO가 누락되면 화면에 PO 재생성 배너가 뜹니다. 눌러서 다시 만들 수 있습니다.
- 승인(approve) 후 잠금: 승인이 끝나 상태가 잠기면(locked) 견적 편집 진입이 차단됩니다. 이미 합의된 견적을 실수로 고치지 못하도록 막는 장치입니다.
🖼️ 화면 캡처 Accept 후 자동 생성된 PO(발주서) 안내 / PO 누락 시 나타나는 PO 재생성 배너 📍
tflowx.com/projects/:id· 저장 위치images/app/qt-po-generated.png
5. 실시간 갱신
QT 화면은 상대방의 변경을 자동으로 반영합니다.
- 협업 채널 이벤트로 상대가 견적을 바꾸면 화면이 자동 새로고침됩니다.
- 단, 내가 편집 중일 때는 자동 새로고침이 보류되어 작업 중인 내용이 날아가지 않습니다. 편집을 마치면 최신 상태로 갱신됩니다.
💡 문제 해결 (FAQ)
Q. 문서 뷰어에 QT 버튼이 안 보여요. A. QT 버튼은 열어 둔 문서가 견적(Quotation) 문서일 때만 나타납니다. 견적 문서가 맞는지, 상단 뷰 모드 토글을 확인하세요.
Q. 액션 버튼(Accept·Counter 등)이 하나도 안 보여요. A. QT는 현재 상태에서 가능한 액션만 보여 줍니다. 지금은 상대의 응답을 기다리는 차례이거나, 해당 동작이 허용되지 않는 상태일 수 있습니다. 상대가 액션을 하면 내 차례 버튼이 나타납니다.
Q. 버튼을 눌렀더니 "라이선스가 필요합니다"가 떠요. A. QT의 모든 액션은 라이선스가 필요합니다.권한 조건 회사 Master에게 라이선스 배정을 요청하세요. → 라이선스
Q. Accept 했는데 발주서(PO)가 안 보여요. A. 대개 자동 생성되지만 누락되면 PO 재생성 배너가 나타납니다. 배너를 눌러 다시 생성하세요.
Q. 견적을 수정하려는데 편집이 안 돼요. A. 승인이 끝나 상태가 잠긴(locked) 견적은 편집할 수 없습니다. 합의된 내용을 보호하기 위한 것으로, 변경이 필요하면 새 견적(New Quote)으로 다시 제안하세요.