Z?j:! dZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z m Z ddlmZmZddlmZejeZed d g ZGd d e ZGdde ZeddeefdFdZedde ddde dde dde d d!d"#e dd$eefdGd-Zed.d/eefdHd1Zed2d3eegd4fdId6Zed7d8eegd4fdJd9Zed:d;eefdHd<Z Gd=d>e Z!Gd?d@e Z"edAdBeefdHdCZ#edAdDeegd4fdKdEZ$dS)LuAEC 3-Way Matching API Router (Đối soát Hóa Đơn <-> Dự Án <-> Giá Sở Xây Dựng Hải Phòng). Strict Zero-Tolerance Synthetic Data & Decimal(18,4) COMPLIANT. ) annotationsN)Any) APIRouterDepends HTTPExceptionQuery) BaseModelField)get_current_user require_role)Aec3WayMatchingServicez/v1/erp/invoices/3way-matchingz.ERP - AEC 3-Way Matching & SXD Price Benchmark)prefixtagscXeZdZUeddZded<eddZded <dS) ConfirmMatchRequest.uID dự án cần khớp nối descriptionstr project_idNu!ID hạng mục WBS (tùy chọn) str | Nonewbs_id)__name__ __module__ __qualname__r r__annotations__rPC:\Projects\DSCons\app\modules\invoices\presentation\aec_3way_matching_routes.pyrrsTeC-MNNNJNNNNt1TUUUFUUUUUUrrc\eZdZUeddZded<edddd Zd ed <d S)BatchAutoMatchRequestTu@Chế độ xem trước (True) hoặc áp dụng thật (False)rbooldry_runiu:Số lượng hóa đơn tối đa quét trong đợt này)gelerint max_itemsN)rrrr r"rr(rrrr r sXE$,noooGooooU31;wxxxIxxxxxxrr z/summaryuALấy KPI Tổng Hợp 3-Way Matching & Kiểm Toán Giá Sở XD)summary current_userdict[str, Any]returnc t}|S#t$rB}td|dt dt |d}~wwxYw)uwTổng hợp 1.031 hóa đơn mua vào (50,3 tỷ), tỷ lệ khớp dự án và rủi ro đơn giá Sở Xây dựng.u$Lỗi lấy summary 3-way matching: Texc_infor# status_codedetailN)r get_matching_summary Exceptionloggererrorrr)r*serviceexcs rget_3way_summaryr9!s{ >(**++--- >>> ACAAD QQQCHH====>s!$ A0=A++A0z/listu7Danh Sách Hóa Đơn Mua Vào Phục Vụ Đối SoátALLz^(ALL|MATCHED|UNMATCHED)$uTrạng thái khớp nối)patternruLọc theo ID dự ánru?Tìm kiếm theo số HĐ, tên nhà cung cấp hoặc ghi chú2r$)r%r&r%statusrrrsearchlimitr'offsetc t}||||||S#t$rB}td|dt dt |d}~wwxYw)unTruy xuất danh sách hóa đơn mua vào kèm nhãn cảnh báo đơn giá Sở Xây dựng và gợi ý AI.)r?rr@rArBu-Lỗi truy xuất danh sách 3-way matching: Tr.r#r0N)r list_matching_invoicesr4r5r6rr)r?rr@rArBr*r7r8s rlist_3way_invoicesrE.s >(**--! .    >>> JSJJUY ZZZCHH====>s'* A6=A11A6z/{invoice_id}/audit-detailuEChi Tiết Đối Soát 3 Chiều (Hóa Đơn vs WBS vs Giá Sở XD) invoice_idc> t}||S#t$r#}tdt |d}~wt $rB}t d|dtdt |d}~wwxYw)uPhân rã chi tiết từng dòng hàng: Đơn giá thực tế, Đơn giá Sở Xây dựng tương đương và Chênh lệch.r0Nu)Lỗi bóc tách chi tiết 3-way audit: Tr.r#)r get_invoice_audit_detail ValueErrorrrr4r5r6rFr*r7r8s rrIrIFs >(**// ;;; >>>CHH==== >>> FFFQU VVVCHH====>s "% BA  B=BBz/batch-auto-matchuHKích Hoạt Tự Động Khớp Nối AI Hàng Loạt (Dry-Run / Apply)) superadmindirector accountantpmreqc t}||j|jS#t$rB}t d|dtdt|d}~wwxYw)ugTự động phân bổ hàng loạt các hóa đơn mua vào chưa khớp vào Dự Án & Trụ Cột.)r"r(uLỗi batch auto match: Tr.r#r0N) r batch_auto_matchr"r(r4r5r6rr)rPr*r7r8s rrRrRVs>(**'' s}'UUU >>> 555 EEECHH====>s.1 A==A88A=z/{invoice_id}/confirmu8Phê Duyệt Khớp Nối Hóa Đơn Vào Dự Án & WBSc t}|dp|dpd}|||j|j|S#t $r#}t dt|d}~wt$rB}t d|d t d t|d}~wwxYw) uPPhê duyệt khớp nối chính thức 1 hóa đơn vào 1 dự án cụ thể. full_nameemailKế Toán Viên)rFrr user_namerHr0Nu+Lỗi xác nhận khớp nối hóa đơn: Tr.r#) r getconfirm_matchingrrrJrrr4r5r6)rFrPr*r7rWr8s rconfirm_invoice_matchingrZfs >(** $$[11d\5E5Eg5N5NdRd ''!~: (   >>>CHH==== >>> H3HHSW XXXCHH====>s$AA C)B C=CCz/{invoice_id}/suggestionsu5Lấy Gợi Ý Top Dự Án Phù Hợp Cho Hóa Đơnc@ t}||S#t$r#}tdt |d}~wt $rB}t d|dtdt |d}~wwxYw) utTính toán và xếp hạng top dự án thông minh phù hợp cho hóa đơn dựa trên vật tư và vị trí.rFrHr0NuLỗi gợi ý dự án: Tr.r#)r get_smart_project_suggestionsrJrrr4r5r6rKs rget_invoice_project_suggestionsr^s >(**44 4KKK >>>CHH==== >>> 666 FFFCHH====> #& BA B=BBceZdZUdZded<eddZded<ed d Zd ed <edd dZd ed<dZ ded<dS)ItemAllocationItemNrinvoice_item_id.uID dự án nhận phân bổrrrgrr>floatallocated_quantityu/Số tiền thanh toán phân bổ cho dự án)gtrallocated_total_amount_vndnotes) rrrrbrr rrdrfrgrrrraras"&O&&&&eC-LMMMJMMMM %ca 0 0 00000(-caEv(w(w(wwwwwErrac4eZdZUeddZded<dS)MultiAllocationRequest.r$) min_lengthzlist[ItemAllocationItem] allocationsN)rrrr rkrrrrriris2,1E#!,D,D,DKDDDDDDrriz/{invoice_id}/allocationsu9Lấy Danh Sách Phân Bổ Đa Dự Án Của Hóa Đơnc@ t}||S#t$r#}tdt |d}~wt $rB}t d|dtdt |d}~wwxYw) uGTruy vấn bảng phân bổ chi phí đa dự án cho hóa đơn này.r\rHr0Nu*Lỗi truy vấn phân bổ đa dự án: Tr.r#)r get_invoice_allocationsrJrrr4r5r6rKs r get_invoice_allocations_endpointrns >(**..*.EEE >>>CHH==== >>> G#GGRV WWWCHH====>r_u2Lưu Bảng Phân Bổ Đa Dự Án Cho Hóa Đơnc t}|dp|dpd}d|jD}||||S#t$r#}t dt |d}~wt$rB}t d |d t d t |d}~wwxYw) uYPhân bổ hóa đơn đầu vào cho nhiều dự án / nhiều công trình khác nhau.rTrUrVc6g|]}|Sr) model_dump).0as r z5save_invoice_allocations_endpoint..s ???!q||~~???r)rFrkrWir0Nu$Lỗi lưu phân bổ đa dự án: Tr.r#) r rXrksave_invoice_multi_allocationsrJrrr4r5r6)rFrPr*r7rW alloc_dictsr8s r!save_invoice_allocations_endpointrws >(** $$[11d\5E5Eg5N5NdRd ??s??? 55!#6   >>>CHH==== >>> ACAAD QQQCHH====>s$A"A%% C/B  C=CC)r*r+r,r+)r?rrrr@rrAr'rBr'r*r+r,r+)rFrr*r+r,r+)rPr r*r+r,r+)rFrrPrr*r+r,r+)rFrrPrir*r+r,r+)%__doc__ __future__rloggingtypingrfastapirrrrpydanticr r "app.modules.auth.presentation.authr r :app.modules.invoices.application.aec_3way_matching_servicer getLoggerrr5routerrr rXr9rErIpostrRrZr^rarirnrwrrrrs#"""""<<<<<<<<<<<<%%%%%%%%MMMMMMMM]]]]]]  8 $ $  + : ;    VVVVV)VVV yyyyyIyyy J cdd#*7+;#<#< > > > >ed >GVWW%'BPlmmm"U45MNNNt1rsssraC(((%a...#*7+;#<#< >>>>XW>. (2yzz$+7+;#<#< > > > >{z > *tuu$+7 CCCDD$$ > > > >vu > $.hii$+7 CCCDD$$>>>>ji>0 '1hii$+7+;#<#< > > > >ji >EEEEEYEEE '1lmm$+7+;#<#< > > > >nm > (2fgg$+7 CCCDD$$>>>>hg>>>r