02 · Duyệt và ghi nhận giải ngân khoản vay

Ví dụ chọn admin đồng ý trước rồi khách đồng ý. Thứ tự có thể đảo; khi bên còn lại APPROVED, service chuyển từ NEGOTIATING sang APPROVED. Nếu admin gửi alsoApproveForUser=true thì có thể chấp thuận thay khách trong cùng request. Nguồn: LoanApplicationV2ServiceImpl.java:526–648.
Hai API approve yêu cầu NEGOTIATING; user phải sở hữu hồ sơ. Khi user kèm bankInfo, các trường ngân hàng phải đầy đủ. Các code lỗi chính: BANK_INFO_INCOMPLETE, INVALID_STATUS_TRANSITION và BOTH_PARTIES_MUST_APPROVE.

Sơ đồ mô tả ghi nhận DISBURSED trong ứng dụng; phần code đã đọc không gọi ngân hàng/core để chuyển tiền. Đổi trạng thái và tạo lịch là hai trách nhiệm riêng.
generateSchedule bỏ qua nếu thiếu disbursedAt, negotiatedLoanAmount hoặc interestRate. Lịch lấy preferredFirstDueDate nếu có, nếu không thì suy ra từ repaymentDayOfMonth; kỳ cuối bù chênh lệch làm tròn. Nguồn: LoanPaymentServiceImpl.java:50–111.
StatusTransitionService bắt và log exception từ generateSchedule. Vì vậy response ghi nhận giải ngân không tự chứng minh lịch đã tạo thành công. Nếu khoản vay thuộc chuỗi rollover, còn cập nhật liên kết khoản vay trước. Nguồn: LoanApplicationV2StatusTransitionService.java:225–248.

Một bên chưa đồng ý thì hồ sơ vẫn NEGOTIATING. Từ chối / ON_HOLD / hủy đi theo ma trận chuyển trạng thái của LoanApplicationV2Status.java:23–35.
Admin approve có thể có docIds: HEAD trước, attach sau commit; luồng chính chọn không đính thêm file để giữ trọng tâm ở hai quyết định. Gateway và quyền endpoint được gộp vào Loan API.

Backend ghim commit 2d27752a4257d2f7d9e27811f98d14e9936ef94e. Các file được trích dẫn khớp commit; sơ đồ mô tả code, chưa chạy giao dịch nghiệp vụ thật.
Gateway / xác thực và các helper nội bộ được gộp vào API tương ứng. Mũi tên endpoint có thể rút gọn tiền tố; khoảng cách dọc là thứ tự, không phải thời gian đo.
SRC trên nút giao diện dẫn tới hợp đồng backend mà giao diện gọi. Nguồn mobile/admin đối chiếu riêng được liệt kê trong source-evidence.md ở trang mục lục.
Nội dung tiếng Việt; một số nút điều khiển Archify dùng tiếng Anh.