---
name: bkit-manage-banks
description: "Quản lý danh mục ngân hàng Việt Nam trong BKIT: tìm, xem, thêm, sửa và ngừng sử dụng ngân hàng. Dùng khi người dùng nhắc mã ngân hàng, tên ngân hàng, website, logo hoặc trạng thái hoạt động."
---

# Quản lý ngân hàng BKIT

## Phạm vi

- Danh sách: `/dashboard/bank`; tạo mới: `/dashboard/bank/new`; sửa: `/dashboard/bank/{id}/edit`.
- Điểm neo: `#bank-list-page`, `#bank-search-box`, `#bank-add-btn`, `#bank-form`, `#bank-save-btn`.
- Trường chính: `#bank-field-bank-short-name`, `#bank-field-bank-fullname`, `#bank-field-website`, `#bank-field-logo`, `#currentlyOutOfService`.

## Quy trình

1. Giữ nguyên origin đang dùng và kiểm tra phiên đăng nhập.
2. Tìm theo mã ngân hàng; nếu có nhiều kết quả, đối chiếu tên đầy đủ.
3. Khoanh vùng đúng dòng theo mã và tên, không dựa vào chỉ số `bank-row-{i}`.
4. Khi tạo, nhập mã và tên bắt buộc; chỉ điền website hoặc logo khi người dùng cung cấp.
5. Khi sửa, chỉ thay các trường được yêu cầu. Dùng “ngừng sử dụng” cho yêu cầu vô hiệu hóa.
6. Lưu và chờ toast hoặc dữ liệu danh sách thay đổi; tìm lại ngân hàng để xác minh.

## Quy tắc an toàn

- Không tự tạo mã viết tắt nếu người dùng chưa chấp thuận.
- Không xóa ngân hàng bằng cách suy diễn; màn hình này ưu tiên trạng thái ngừng sử dụng.
- Không chọn dòng chỉ vì nó đang ở đầu bảng.
- Nếu mã đã tồn tại, không ghi đè bản ghi khác; báo xung đột.

## Báo cáo kết quả

Nêu mã, tên ngân hàng và trường đã đổi. Nếu lưu thất bại, trích nội dung lỗi ngắn gọn và không thử lặp mù quáng.
