04 · Mở sổ tiết kiệm và xác nhận nộp tiền

Backend kiểm tra eligible, sản phẩm đang chào theo termMonths, principal tối thiểu và phương thức trả lãi. Mặc định AT_MATURITY nếu khách không gửi phương thức. Nguồn: SavingsBookServiceImpl.java:71–101.
Mở sổ tạo PENDING_DEPOSIT, cycleNo=1 và chỉ thị ROLLOVER_PRINCIPAL_AND_INTEREST; chưa sinh lịch lãi. Cán bộ có thể mở hộ qua endpoint admin dùng cùng service.
confirmDeposit chỉ nhận PENDING_DEPOSIT. Cán bộ có thể sửa tiền/kỳ hạn/phương thức trong cùng request; seri phải khả dụng. Ngày bắt đầu là LocalDate.now(), đáo hạn bằng cộng số tháng. Nguồn: SavingsBookServiceImpl.java:153–206.

InterestScheduleGenerator tạo các kỳ theo chu kỳ sổ, tiền gốc, rate, phương thức và hai ngày. interestAmount của sổ là tổng lãi dự kiến của các kỳ. Lưu sổ ACTIVE, các kỳ và transaction log trong transaction nghiệp vụ.
Luồng này ghi nhận nộp tiền trong ứng dụng và hiển thị lịch lãi; phần service đã đọc không gọi hệ thống core hay ngân hàng để chuyển tiền.
SAVINGS_BOOK_OPENED và SAVINGS_DEPOSIT_CONFIRMED được chuyển qua SavingsEventRelay AFTER_COMMIT. Dù lớp record tên SavingsOutboxEvent, đoạn code này là application event trong bộ nhớ; không suy ra có durable outbox table.

KYC_NOT_ELIGIBLE hoặc PROFILE_SERVICE_UNAVAILABLE khi không kiểm tra được định danh; SAVINGS_PRODUCT_NOT_FOUND, PRINCIPAL_BELOW_MINIMUM, INTEREST_PAYMENT_METHOD_NOT_SUPPORTED hoặc PAYMENT_METHOD_NOT_OFFERED khi điều khoản không hợp lệ.
SAVINGS_BOOK_NOT_PENDING_DEPOSIT nếu xác nhận nhầm trạng thái; SERIAL_NUMBER_ALREADY_EXISTS nếu trùng seri. Relay bắt lỗi broker để log. Toàn bộ nguồn tiết kiệm hiện đã commit cùng revision trong bộ sơ đồ này.

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.