// Panel 3: workflow timeline + transition buttons + approval history + changelog. // Pulls nextPhases từ BE bundle (single source of truth) → render per-phase // action button. Approvals + History moved here from PeDetailTabs (2 section // dưới cùng) để Panel 2 tập trung hiển thị nội dung phiếu (Info + NCC + Items). import { useEffect, useState } from 'react' import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query' import { toast } from 'sonner' import { Dialog } from '@/components/ui/Dialog' import { Button } from '@/components/ui/Button' import { Label } from '@/components/ui/Label' import { Textarea } from '@/components/ui/Textarea' import { api } from '@/lib/api' import { getErrorMessage } from '@/lib/apiError' import { cn } from '@/lib/cn' import { useAuth } from '@/contexts/AuthContext' import { ApprovalStage, PurchaseEvaluationPhase, PurchaseEvaluationPhaseColor, PurchaseEvaluationPhaseLabel, WorkflowReturnMode, type PeDepartmentApproval, type PeDetailBundle, } from '@/types/purchaseEvaluation' import { PeApprovalsSection, PeHistorySection } from './PeDetailTabs' export function PeWorkflowPanel({ evaluation, readOnly = false, }: { evaluation: PeDetailBundle /** true = ẩn Chuyển tiếp + Dialog transition (dùng cho Danh sách, không dùng Duyệt). */ readOnly?: boolean }) { const [target, setTarget] = useState(null) const [comment, setComment] = useState('') // Mig 28 (S21 t4) — F1 mode Trả lại. Default Drafter (backward compat S17). const [returnMode, setReturnMode] = useState(WorkflowReturnMode.Drafter) const [returnTargetUserId, setReturnTargetUserId] = useState(null) // Mig 31 (S23 t1) — F2 Approver duyệt thẳng Cấp cuối. Default false (admin opt-in // per slot tick → checkbox visible trong dialog Approve, default unchecked). const [skipToFinalApprover, setSkipToFinalApprover] = useState(false) const qc = useQueryClient() const { user: currentUser } = useAuth() const isAdmin = currentUser?.roles?.includes('Admin') ?? false // Mig 29 (S21 t5) — F1 options per-Level (Cấp Approver hiện tại). const levelOptions = evaluation.currentLevelOptions // S23 t2 fix bro UAT: khi admin tick AllowReturnToAssignee/OneLevel/OneStep // (mode đang gửi duyệt) + UNTICK AllowReturnToDrafter, dialog default mode // phải là first F1 available — KHÔNG để Drafter (radio hidden) làm initial // → user click Xác nhận sai mode → BE throw "không bật mode Drafter". // Drafter chỉ làm fallback khi không có F1 nào enabled. // Per bro intent: "draft chỉ khi trả lại cho người soạn thôi" — 3 F1 modes // mới là "trả lại trong mode đang gửi duyệt". useEffect(() => { if (target === PurchaseEvaluationPhase.TraLai) { const firstAvailable = levelOptions?.allowReturnOneLevel ? WorkflowReturnMode.OneLevel : levelOptions?.allowReturnOneStep ? WorkflowReturnMode.OneStep : levelOptions?.allowReturnToAssignee ? WorkflowReturnMode.Assignee : WorkflowReturnMode.Drafter setReturnMode(firstAvailable) } }, [target, levelOptions]) // List approvers đã ký (cho mode Assignee dropdown pick) const signedApprovers = (evaluation.levelOpinions ?? []) .map(o => ({ userId: o.approverUserId, fullName: o.approverFullName ?? 'NV' })) .filter((v, i, arr) => arr.findIndex(x => x.userId === v.userId) === i) // Mig 24 — V2 schema chỉ cho phép approver trong CurrentApproval.approvers // thao tác cấp hiện tại. UAT S22+1 feedback: "không quyền thao tác = ko quyền // mọi hành động" — disable cả 3 button (Duyệt + Trả lại + Từ chối) khi actor // không match currentLevel.ApproverUserId. BE mirror guard trong // EnsureCanRejectV2Async (defense-in-depth — UI disable + BE reject). // Admin bypass. const v2Approvers = evaluation.currentApproval?.approvers ?? [] const actorInV2Level = isAdmin || (currentUser?.id && v2Approvers.some(a => a.userId === currentUser.id)) // V2 active = phiếu pin V2 + Phase=ChoDuyet + có currentApproval const isV2Pending = !!evaluation.currentApproval const blockedByV2Level = isV2Pending && !actorInV2Level // 2-stage dept approvals (Migration 16) — fetch riêng để FE Workflow Panel // hiển thị progress per phase × dept (Stage Review NV / Confirm TPB). const { data: deptApprovals = [] } = useQuery({ queryKey: ['pe-dept-approvals', evaluation.id], queryFn: async () => { const r = await api.get(`/purchase-evaluations/${evaluation.id}/department-approvals`) return r.data }, }) const transition = useMutation({ mutationFn: async () => { // Decision = Reject (2) khi: // - target = TuChoi (huỷ phiếu) // - target = DangSoanThao từ phase trung gian (= Trả lại legacy Mig 16 // set RejectedFromPhase + clear N-stage rows + Drafter resume jump-back) // - target = TraLai (98) từ phase trung gian — Session 17 spec mới: Trả // lại là Phase RIÊNG (gotcha #45 — thiếu nhánh này gây "Trả về nhưng // hệ thống vẫn duyệt" do BE nhận decision=Approve → ApproveV2Async). // BE có guard mirror trong PurchaseEvaluationWorkflowService.TransitionAsync // throw ConflictException nếu payload mismatch — phải sync 2 phía. const isReject = target === PurchaseEvaluationPhase.TuChoi || (target === PurchaseEvaluationPhase.DangSoanThao && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao) || (target === PurchaseEvaluationPhase.TraLai && evaluation.phase !== PurchaseEvaluationPhase.TraLai) // Mig 28 (S21 t4) — F1: chỉ gửi returnMode khi target=TraLai + mode != null const isTraLaiAction = target === PurchaseEvaluationPhase.TraLai && evaluation.phase !== PurchaseEvaluationPhase.TraLai return api.post(`/purchase-evaluations/${evaluation.id}/transitions`, { targetPhase: target, decision: isReject ? 2 : 1, comment: comment || null, returnMode: isTraLaiAction ? returnMode : null, returnTargetUserId: isTraLaiAction && returnMode === WorkflowReturnMode.Assignee ? returnTargetUserId : null, // Mig 31 (S23 t1) — F2 Approver scope ChoDuyet duyệt thẳng Cấp cuối. // BE check matchingLevel.AllowApproverSkipToFinal (admin opt-in per slot). skipToFinal: !isReject && skipToFinalApprover, }) }, onSuccess: () => { toast.success('Đã chuyển phase.') qc.invalidateQueries({ queryKey: ['pe-detail', evaluation.id] }) qc.invalidateQueries({ queryKey: ['pe-list'] }) qc.invalidateQueries({ queryKey: ['pe-dept-approvals', evaluation.id] }) setTarget(null) setComment('') setReturnMode(WorkflowReturnMode.Drafter) setReturnTargetUserId(null) setSkipToFinalApprover(false) }, onError: e => toast.error(getErrorMessage(e)), }) const next = evaluation.workflow.nextPhases const flow = evaluation.approvalFlow return (

Quy trình duyệt

{evaluation.approvalWorkflowCode && (

{evaluation.approvalWorkflowCode} v{String(evaluation.approvalWorkflowVersion ?? 0).padStart(2, '0')} {evaluation.approvalWorkflowName && <> · {evaluation.approvalWorkflowName}}

)}
{/* Mig 24 V2 — Flow render Bước → Cấp → NV thay phase cards. Status: Done (✓ emerald) / Current (● brand) / Pending (○ slate) */} {flow && flow.steps.length > 0 && (
    {flow.steps.map(step => { const stepIcon = step.status === 'Done' ? '✓' : step.status === 'Current' ? '●' : '○' return (
  1. {stepIcon} Bước {step.order} — {step.name} {step.departmentName && ( {step.departmentName} )}
    {step.levels.length > 0 && (
      {step.levels.map(lv => { const lvIcon = lv.status === 'Done' ? '✓' : lv.status === 'Current' ? '●' : '○' return (
    • {lvIcon}
      {lv.name || `Cấp ${lv.order}`} {lv.status === 'Current' && đang chờ} {lv.status === 'Done' && đã duyệt}
      {lv.approvers.map(a => a.fullName).join(' / ') || '(chưa cấu hình)'}
    • ) })}
    )}
  2. ) })}
)} {/* Phiếu V1 legacy không có flow → fallback hiển thị phase summary đơn giản */} {!flow && (
Phiếu này dùng quy trình cũ — workflow chi tiết không khả dụng.
)} {/* Mig 24 — V2 banner: hiển thị Bước/Cấp hiện tại + danh sách NV được duyệt. Nếu actor không có trong list → banner amber + nút Duyệt sẽ disable. */} {isV2Pending && evaluation.currentApproval && !readOnly && (
Đang chờ Bước {evaluation.currentApproval.stepIndex + 1} ({evaluation.currentApproval.stepName}) {evaluation.currentApproval.stepDepartmentName && <> · {evaluation.currentApproval.stepDepartmentName}} {' — '}Cấp {evaluation.currentApproval.levelOrder}
NV duyệt: {evaluation.currentApproval.approvers.map(a => a.fullName).join(' / ') || '(chưa có)'}
{actorInV2Level ?
✓ Đến lượt bạn duyệt
:
⚠ Không phải lượt bạn — chỉ NV trên mới duyệt được cấp này
}
)} {next.length > 0 && !readOnly && (
{next.map(p => { // Phân loại button theo hành động (3 màu khác nhau, in đậm): // - Duyệt = forward phase tiếp theo — emerald (xanh lá positive) // - Trả lại = về DangSoanThao/TraLai (từ phase trung gian) — amber (request changes) // - Từ chối = TuChoi — red (terminal negative) const isSendBack = (p === PurchaseEvaluationPhase.DangSoanThao || p === PurchaseEvaluationPhase.TraLai) && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao && evaluation.phase !== PurchaseEvaluationPhase.TraLai const isCancel = p === PurchaseEvaluationPhase.TuChoi const isForwardApprove = !isSendBack && !isCancel // S59 anh chốt (UAT: "nhân viên tạo phiếu thì trả lại và từ chối cho ai?"): // người duyệt CHÍNH LÀ người soạn phiếu → ẩn cả Trả lại + Từ chối // (trả cho chính mình vô nghĩa — đang sửa inline được; hủy phiếu sai // = nhờ cấp khác Từ chối, phiếu Nháp có nút Xóa riêng). if ((isSendBack || isCancel) && evaluation.drafterUserId === currentUser?.id) return null // Mig 24 + UAT S22+1 — disable cả 3 button khi actor không match // currentLevel.ApproverUserId. "Không quyền = ko quyền mọi hành động." const isDisabled = blockedByV2Level const label = isSendBack ? '← Trả lại' : isCancel ? '✗ Từ chối' : '✓ Duyệt' const title = isDisabled && evaluation.currentApproval ? `Cấp ${evaluation.currentApproval.levelOrder} chỉ ${evaluation.currentApproval.approvers.map(a => a.fullName).join(' / ')} mới thao tác được (Duyệt / Trả lại / Từ chối).` : isForwardApprove ? `Duyệt → ${PurchaseEvaluationPhaseLabel[p]}` : undefined return ( ) })}
)} {readOnly && next.length > 0 && (
Vào menu “Duyệt” để chuyển phase.
)} {target !== null && (() => { const isCancel = target === PurchaseEvaluationPhase.TuChoi // isSendBack sync với button label + payload isReject (gotcha #45). // Include cả DangSoanThao (legacy Mig 16) lẫn TraLai (Session 17 spec) // — cả 2 là Trả lại Drafter sửa. const isSendBack = (target === PurchaseEvaluationPhase.DangSoanThao || target === PurchaseEvaluationPhase.TraLai) && evaluation.phase !== PurchaseEvaluationPhase.DangSoanThao && evaluation.phase !== PurchaseEvaluationPhase.TraLai const dialogTitle = isCancel ? '✗ Từ chối phiếu (khoá hoàn toàn)' : isSendBack ? '← Trả lại Drafter sửa' : `✓ Duyệt → ${PurchaseEvaluationPhaseLabel[target]}` return ( setTarget(null)} title={dialogTitle} footer={<> } > {isCancel && (
⚠ Phiếu sẽ bị khoá hoàn toàn (không edit/transition được nữa). Drafter cần tạo phiếu mới nếu muốn làm lại.
)} {isSendBack && ( <> {/* Mig 28 (S21 t4) — F1 mode picker khi Trả lại. Show modes enabled per workflow.options. Default Drafter (S17 fallback). */} {(levelOptions?.allowReturnOneLevel || levelOptions?.allowReturnOneStep || levelOptions?.allowReturnToAssignee || levelOptions?.allowReturnToDrafter || !levelOptions) && (
{(levelOptions?.allowReturnOneLevel) && ( )} {(levelOptions?.allowReturnOneStep) && ( )} {(levelOptions?.allowReturnToAssignee) && ( )} {(levelOptions?.allowReturnToDrafter !== false) && ( )}
)}
{returnMode === WorkflowReturnMode.Drafter ? 'Phiếu sẽ về "Cần chỉnh sửa lại". Drafter có thể sửa rồi trình lại từ Cấp 1 Bước 1.' : returnMode === WorkflowReturnMode.Assignee ? 'Phiếu sẽ về Cấp/Bước của NV đã chọn (vẫn "Đã gửi duyệt"). NV nhận lại để duyệt tiếp.' : 'Phiếu sẽ lùi pointer (vẫn "Đã gửi duyệt"). NV trước nhận lại để duyệt tiếp.'}
)} {/* Mig 31 (S23 t1) — F2 Approver toggle: chỉ visible khi Approve forward + admin tick AllowApproverSkipToFinal cho slot Cấp hiện tại. */} {!isCancel && !isSendBack && levelOptions?.allowApproverSkipToFinal && (
)} {!isCancel && !isSendBack && skipToFinalApprover && (
⚠ Bỏ qua mọi Cấp/Bước trung gian, phiếu chuyển thẳng tới NV cuối. NV cuối vẫn phải ký duyệt thật để phiếu thành "Đã duyệt".
)}