QT(견적) 핸드셰이크

QT(Quotation, 견적) 핸드셰이크는 판매자(Seller)와 구매자(Buyer)가 하나의 견적 문서를 나란히 놓고 조건을 주고받는 화면입니다. 왼쪽 Seller 견적과 오른쪽 Buyer 견적을 줄 단위로 비교하며, 역제안(Counter)·수락(Accept)을 오가다가 합의되면 발주서(PO)가 자동으로 만들어집니다.

💡 누가 쓰나요? 바이어와 가격·수량·조건을 여러 번 조율해 견적을 확정해야 하는 무역 실무자. 이메일로 견적서를 왔다 갔다 하지 않고, 한 화면에서 어디가 달라졌는지를 보며 합의까지 끌고 갈 수 있습니다.

ℹ️ 권한 조건 — QT의 모든 액션(편집·저장·승인·Accept 등) 은 실행 전에 라이선스를 확인합니다. 라이선스가 없으면 열람은 되지만 액션 버튼을 누를 때 안내 모달이 뜹니다.
(라이선스 제한이 켜진 환경 한정 — 라이선스 참고)

1. 진입 — 문서 뷰어의 QT 모드

🖼️ 화면 캡처 문서 뷰어 상단 뷰 모드 토글 — Single / Split / QT (QT 문서에서만 QT 버튼 노출) 📍 tflowx.com/projects/:id 문서 뷰어 · 저장 위치 images/app/qt-viewmode-toggle.png

1. 프로젝트의 문서 뷰어에서 견적(Quotation) 문서를 엽니다.
2. 상단 뷰 모드 토글에서 모드를 고릅니다.

3. QT 를 누르면 견적 핸드셰이크 화면으로 전환됩니다.

ℹ️ QT 버튼은 열어 둔 문서가 견적(Quotation) 문서일 때만 나타납니다. 다른 종류의 문서에서는 Single/Split만 보입니다.

2. 화면 구성 — Seller ↔ Buyer 2분할과 diff

QT 화면은 좌우 2분할입니다.

• 각 페인에서 버전을 선택해 원하는 시점의 견적을 볼 수 있습니다.
• Seller와 Buyer의 값을 비교해 서로 다른 항목(행)은 하이라이트(diff) 로 강조됩니다. 어디가 바뀌었는지 한눈에 보입니다.

🖼️ 화면 캡처 QT Split View — 좌 Seller / 우 Buyer 견적 + 불일치 행 diff 하이라이트 📍 tflowx.com/projects/:id 문서 뷰어(QT) · 저장 위치 images/app/qt-split-diff.png

3. 지금 누를 수 있는 버튼만 보입니다

견적은 진행 단계에 따라 지금 할 수 있는 동작만 버튼으로 보여 줍니다. 버튼이 안 보인다면 상대방의 응답을 기다리는 차례입니다.

• 지금 상황에서 할 수 없는 동작의 버튼은 아예 보이지 않습니다.
• 수락은 Accept 버튼으로만 할 수 있습니다. 다른 경로로 견적을 확정할 수는 없습니다.
• 견적 요청·수정은 수출자(Seller) 측 편집 권한자만 할 수 있습니다. 버튼이 없다면 내 역할로는 할 수 없는 동작입니다.
• 모든 액션은 실행 직전 라이선스를 확인합니다.^{권한 조건}

4. 버전 기록 — 보낸 견적은 버전으로 남습니다 ✨ NEW

견적서는 한 프로젝트에 하나를 두고, 바뀐 견적은 그 안에 버전으로 쌓입니다. 보낸 견적·역제안·합의가 각각 버전(v1, v2 …)이 되고, 지난 버전은 읽기만 할 수 있습니다.

• 수정 견적 — 보낸 견적을 고치려면 셀러가 수정 견적을 누릅니다. 직전 견적이 복사된 새 버전이 열리고, 고친 뒤 수정 견적 보내기 를 누르면 바이어에게 보입니다. 바이어가 응답하기 전이어도 됩니다.
  • 바이어가 역제안을 작성하는 중이면 수정 견적·수정 견적 보내기가 흐리게 보입니다(바이어의 초안이 지난 버전에 걸리지 않게). 바이어가 역제안을 보내면 다시 쓸 수 있습니다.

버전 고르기 · 저장 이력

• 버전 고르기 — 단일 보기 오른쪽 위 v3 · 수정 견적 · 이전 2 버튼을 누르면 버전 기록이 보입니다(셀러·바이어, 사건, 시각, 작성자). 지난 버전을 고르면 "지난 버전이라 고칠 수 없어요" 띠와 함께 읽기 전용으로 열리고, 현재로 로 돌아옵니다. QT 분할 보기의 탭에도 사건(견적·수정 견적·역제안·합의)이 표시됩니다.
• 저장 이력 — 마지막으로 보낸 뒤 저장한 것들은 작성한 측에만 저장 이력으로 보입니다. 저장본을 골라 되돌리기 하면 그 내용이 새 저장으로 다시 기록됩니다(지금 내용도 이력에 남습니다). 보내면 그 사이의 저장은 버전 하나로 정리됩니다.
• 견적서를 또 만들면 — 문서함에서 문서 생성 → 견적서를 누르면 새 문서 대신 기존 견적서의 새 버전이 열립니다(공유 전이면 그 견적서를 그대로 엽니다). 합의(수락)로 끝난 견적서뿐이면 새 견적서를 만듭니다.
• 문서함의 견적서 이름 옆 v2 · 이전 2 배지는 보낸 버전 기록이 있다는 표시입니다.

🖼️ 화면 캡처 단일 보기 버전 기록 메뉴(버전·저장 이력) / 지난 버전 보기 띠 📍 tflowx.com/projects/:id/documents · 저장 위치 images/app/qt-versions.png

5. 합의 — Accept 시 자동 PO 생성, 승인 후 편집 잠금

• Buyer가 Accept(수락) 하면 그 견적을 바탕으로 발주서(PO)가 자동 생성됩니다.
• 견적이 종결됐는데 어떤 이유로 PO가 누락되면 화면에 PO 재생성 배너가 뜹니다. 눌러서 다시 만들 수 있습니다.
• 승인 후 잠금: 승인이 끝나 견적이 잠기면 편집 진입이 차단됩니다. 이미 합의된 견적을 실수로 고치지 못하도록 막는 장치입니다.

🖼️ 화면 캡처 Accept 후 자동 생성된 PO(발주서) 안내 / PO 누락 시 나타나는 PO 재생성 배너 📍 tflowx.com/projects/:id · 저장 위치 images/app/qt-po-generated.png

6. 실시간 갱신

QT 화면은 상대방의 변경을 자동으로 반영합니다.

• 협업 채널 이벤트로 상대가 견적을 바꾸면 화면이 자동 새로고침됩니다.
• 단, 내가 편집 중일 때는 자동 새로고침이 보류되어 작업 중인 내용이 날아가지 않습니다. 편집을 마치면 최신 상태로 갱신됩니다.

💡 문제 해결 (FAQ)

Q. 문서 뷰어에 QT 버튼이 안 보여요. A. QT 버튼은 열어 둔 문서가 견적(Quotation) 문서일 때만 나타납니다. 견적 문서가 맞는지, 상단 뷰 모드 토글을 확인하세요.

Q. 액션 버튼(Accept·Counter 등)이 하나도 안 보여요. A. QT는 현재 상태에서 가능한 액션만 보여 줍니다. 지금은 상대의 응답을 기다리는 차례이거나, 해당 동작이 허용되지 않는 상태일 수 있습니다. 상대가 액션을 하면 내 차례 버튼이 나타납니다.

Q. 버튼을 눌렀더니 "라이선스가 필요합니다"가 떠요. A. QT의 모든 액션은 라이선스가 필요합니다.^{권한 조건} 회사 마스터에게 라이선스 배정을 요청하세요. → 라이선스

Q. Accept 했는데 발주서(PO)가 안 보여요. A. 대개 자동 생성되지만 누락되면 PO 재생성 배너가 나타납니다. 배너를 눌러 다시 생성하세요.

Q. 견적을 수정하려는데 편집이 안 돼요. A. 이미 보낸 견적과 승인이 끝나 잠긴 견적은 편집할 수 없습니다. 보낸 견적은 수정 견적 으로 새 버전을 만들어 고치세요. 합의(수락)로 끝난 견적은 바꿀 수 없습니다.

버전 · 수정 견적

Q. 견적서를 새로 만들었는데 새 문서가 안 생기고 기존 견적서가 열려요. A. 정상입니다. 한 프로젝트의 견적은 하나의 견적서 안에 버전으로 쌓입니다. 새로 만든 대신 기존 견적서의 새 버전이 열렸고, 지난 견적은 버전 기록에서 볼 수 있습니다.

Q. 수정 견적 버튼이 흐리게 보여요. A. 바이어가 역제안을 작성하고 있는 중입니다. 바이어가 역제안을 보내거나 지우면 다시 누를 수 있습니다.