🔎 AI dò lỗi để làm gì?

• Thêm lỗi vào kho: mỗi lần gặp lỗi, lưu lại phân hệ + tiêu đề + nội dung + thao tác + cách xử lý + ảnh. Kho càng nhiều, dò càng chính xác.
• Dò lỗi bằng ảnh: lần sau gặp lỗi, chỉ cần gửi ảnh. AI xem ảnh, so với kho và trả về các lỗi giống nhất xếp trên cùng (kèm % độ giống và cách xử lý đã lưu).
• Có thể gửi nhiều ảnh một lần; điền phân hệ để AI ưu tiên đúng nhóm.

🛡 Phân quyền dùng để làm gì?

• Mỗi dòng là một tài khoản user (admin luôn toàn quyền nên không liệt kê).
• Giới hạn sản phẩm: không tick = user được góp ý mọi sản phẩm; tick rồi chọn = user chỉ góp ý được các sản phẩm đã chọn.
• 🤖 Trợ lý hệ thống: tick để cho phép tài khoản đó thấy & dùng chat nổi 💬 với Claude (việc hệ thống). Mặc định chỉ admin dùng được; bỏ tick = ẩn nút 💬 với user đó.
• Bấm Lưu phân quyền để áp dụng. User cần tải lại trang để thấy thay đổi nút 💬.

Quy trình góp ý → tự sửa

• Bấm + Mới để tạo góp ý: chọn sản phẩm, mô tả vấn đề, đính kèm ảnh/tệp nếu cần.
• 💾 Nội dung đang soạn được TỰ LƯU (nháp): nếu bạn đang gõ góp ý mới rồi bấm sang xem góp ý khác (kể cả cái đang chạy) hay mở lại + Mới, phần chữ vẫn còn nguyên — không bị mất. Nháp chỉ bị xoá sau khi bạn Gửi góp ý thành công. (Lưu ý: chỉ giữ phần chữ; tệp/ảnh đính kèm cần đính lại nếu bạn rời form trước khi gửi.)
• Hệ thống tự chạy Claude để sửa → build bản TEST → chuyển sang Chờ duyệt.
• Người duyệt xem kết quả (kèm ảnh) rồi Duyệt → góp ý vào danh sách chờ update (CHƯA đè trang chính). Khi nào bấm 🚀 Update (chọn tất cả hoặc 1 vài) thì bản sửa mới được đè vào trang chính ("Có gì mới").
• 📱 Trên điện thoại: màn hình chỉ hiện danh sách. Kích đúp (chạm 2 lần) vào một góp ý — hoặc bấm + Mới — để mở phần chi tiết / soạn góp ý ở hộp thoại (dialog) nổi toàn màn hình; bấm ← Danh sách để đóng và quay lại.

Trạng thái góp ý

• 🟠 Chưa làm · 🔵 Đang làm · 🟣 Chờ duyệt · 🟢 Đã duyệt · chờ update · ✅ Đã update.
• Tách 2 trạng thái sau khi duyệt: Duyệt chỉ đánh dấu đã OK và đưa vào danh sách chờ update; phải bấm 🚀 Chờ update (nút trên thanh đầu trang) để chọn update tất cả hoặc 1 vài yêu cầu thì mới đè vào trang chính. Con số trên nút = số yêu cầu đang chờ update.
• Lọc TÁCH RIÊNG 2 trạng thái sau duyệt: ô “Lọc trạng thái” (và thanh thống kê) có 2 mục độc lập — 🟢 Đã duyệt · chờ update (đã OK nhưng CHƯA đè trang chính) và ✅ Đã update (đã đè vào “Có gì mới”). Tích riêng từng mục để chỉ xem một nhóm, ví dụ chỉ xem các yêu cầu đang chờ update.
• Lọc theo trạng thái / sản phẩm ở cột trái.
• Mỗi góp ý trong danh sách hiển thị người gửi (👤) và ngày gửi dạng dd/MM/yyyy HH:mm.
• Phân trang: danh sách hiển thị mỗi trang 50 góp ý (chịu được vài chục nghìn dòng); dùng thanh « ‹ › » ở cuối danh sách để chuyển trang.
• Lọc theo người gửi (chỉ admin): khi tích 👥 Tất cả người dùng, hiện ô “👤 Tất cả người gửi” để lọc theo 1 tài khoản cụ thể.
• Lọc theo khoảng ngày (🟢 Đã duyệt từ … đến …): CHỈ áp dụng cho góp ý ĐÃ DUYỆT — các trạng thái khác luôn hiện. Mặc định lấy 1 tuần gần nhất; bấm ✕ để bỏ lọc ngày.
• Thanh thống kê đầu danh sách (Đang làm / Chờ duyệt / Chờ làm / Đã duyệt · chờ update / Đã update) vừa hiển thị số lượng, vừa là nút tích lọc: bấm 1 chip để bật/tắt (☑/☐) lọc theo trạng thái đó — đồng bộ với dropdown “Lọc trạng thái”. Chip mờ = đang ẩn trạng thái đó. Số trên thanh đã ÁP đúng các bộ lọc ở trên (sản phẩm, người gửi, khoảng ngày duyệt) — chỉ trừ chính bộ lọc trạng thái — nên số luôn KHỚP với danh sách bên dưới.
• 📱 Trên điện thoại: thanh chip thống kê được ẩn cho khỏi tràn; số lượng từng trạng thái đã gộp vào ô multi-select “Lọc trạng thái” (mở ra thấy badge số bên cạnh mỗi trạng thái) — vừa xem số, vừa tích chọn nhiều trạng thái trong 1 ô gọn.
• ↔ Kéo rộng danh sách → chữ chạy theo: kéo thanh dọc giữa danh sách (cột trái) và phần chi tiết để chỉnh độ rộng. Dòng tóm tắt mỗi góp ý tự xuống dòng và hiện nhiều chữ hơn khi danh sách rộng (tối đa 2 dòng), không còn bị cắt cứng theo độ rộng cũ.

🤖 Trợ lý hệ thống (chat nổi với Claude)

• Chỉ admin: bấm nút tròn 💬 ở góc dưới bên phải để mở khung chat nổi với Claude — nhờ làm các việc liên quan hệ thống nói chung (không gắn góp ý nào).
• Vd: khai/đổi lệnh restart bản TEST/THẬT cho sản phẩm, tra cứu cấu hình, hỏi về mã nguồn. Bấm ? trên khung để xem hướng dẫn riêng.

📝 Diễn giải đã sửa (kết quả Claude)

• Sau khi Claude sửa xong, phần “Diễn giải đã sửa” trình bày đẹp, dễ đọc: tự xuống dòng, hỗ trợ đậm, danh sách, bảng và khối mã (markdown) thay vì một đoạn chữ dài liền nhau.
• Nội dung được gom theo từng LẦN XỬ LÝ: mặc định chỉ hiện LẦN CUỐI (gắn nhãn 🔁 Lần thử N · mới nhất), các lần trước được thu gọn trong mục 🗂 Xem N lần xử lý trước — bấm để mở. Trong mỗi lần, văn bản tự xuống dòng theo câu và các mục đánh số (1)(2)(3) được thụt vào để nhìn rõ từng ý.
• Mỗi lần xử lý được tách thành các VÙNG có nhãn & màu riêng cho trực quan, dễ liếc: 🔍 Nguyên nhân (cam), 🔧 Đã sửa (tím), 🧪 Kết quả test (xanh lá), 🏗️ Build, 🖼️ Ảnh (xanh dương), 📌 Ghi chú. Mở đầu (lý do/phản hồi của bạn) hiển thị dạng trích dẫn nghiêng. Nếu diễn giải không có nhãn vùng thì hiện liền mạch như bình thường.
• Các từ khoá trạng thái được tô điểm nhấn: PASS/ĐẠT (xanh), FAIL/LỖI (đỏ), CẢNH BÁO (vàng) để liếc nhanh thấy kết quả test.
• 🕒 Dòng thời gian xử lý: phần phản hồi của bạn (chấm xanh dương ↩) và diễn giải đã sửa của Claude (chấm tím 📝) được đan xen theo đúng thứ tự thời gian trên một trục dọc — không còn để cả dãy phản hồi dồn một chỗ rồi diễn giải tách riêng. Mỗi lần xử lý là MỘT mốc diễn giải riêng, chèn ngay sau phản hồi mà nó trả lời và có nhãn ↳ trả lời phản hồi lúc … để biết diễn giải đó đáp lại phản hồi nào. Mỗi mốc ghi rõ giờ ở góc phải; lần diễn giải mới nhất gắn nhãn mới nhất.

💬 Hỏi Claude về góp ý

• Trong chi tiết góp ý, gõ câu hỏi vào ô “Nhập câu hỏi cho Claude…” rồi nhấn Enter hoặc nút Gửi.
• Đính kèm ảnh/tệp bằng nút 📎, hoặc dán (paste) / kéo-thả ảnh vào khung chat.
• 💬 Chèn câu hỏi mới vào luồng (trong lúc Claude đang trả lời): không cần đợi — cứ gõ câu hỏi bổ sung rồi bấm Gửi thêm; câu mới sẽ vào hàng đợi (hiện mờ kèm “⏳ đang chờ”) và được Claude xử lý ngay sau câu hiện tại, theo đúng thứ tự bạn gửi.
• Trên điện thoại: cuộn trang xuống để thấy ô chat ở cuối — ô luôn bấm được bình thường (đã sửa lỗi phải bấm lệch lên trên).
• ↔ Chỉnh độ rộng khung chat: kéo thanh dọc giữa nội dung và khung chat để mở rộng/thu hẹp — nội dung (text) sẽ tự co giãn theo. Bấm đúp thanh để về mặc định; độ rộng được nhớ theo máy.

Công cụ khác

• 🌙 sáng/tối · 🎨 đổi màu giao diện · ✈ Telegram · 🔑 đổi mật khẩu.
• Admin: ⚙ Sản phẩm · 👥 Tài khoản · 🛡 Phân quyền góp ý.
• Trong 👥 Tài khoản: nút 🔑 mỗi dòng để đặt lại mật khẩu cho user (không cần mật khẩu cũ).

Quản lý sản phẩm

• Cột trái: danh sách sản phẩm. Bấm để chọn, + Thêm sản phẩm để tạo mới, 🗑 trong chi tiết để xoá.
• Khai báo: Mã (id), Tên, Loại, các Folder Code / Build Test / Build Product, System Prompt riêng, Git, cổng test/thật.
• Nhấn Lưu cấu hình để ghi vào products.json (bấm ✔ Kiểm tra để soát lỗi trước).

↕ Sắp xếp sản phẩm (kéo-thả)

• Mỗi sản phẩm có tay cầm ⠿ ở mép trái — giữ & kéo lên/xuống để đổi vị trí (dùng được cả chuột lẫn cảm ứng/điện thoại).
• Kéo được qua nhiều vị trí trong một lần: sản phẩm đang kéo bám theo con trỏ, các sản phẩm khác trượt mượt nhường chỗ để bạn thấy trước nơi sẽ thả.
• Thả tay ra là tự lưu ngay thứ tự vào products.json và áp dụng cho mọi nơi chọn sản phẩm (ô lọc, form tạo góp ý).

↔ Chỉnh độ rộng 2 vùng (split move)

• Giữa danh sách (trái) và chi tiết (phải) có thanh kéo dọc — giữ & kéo sang trái/phải để chỉnh độ rộng 2 vùng theo ý bạn (không còn cố định cứng nữa).
• Độ rộng được nhớ lại theo máy (lưu trên trình duyệt máy này) — lần sau mở lại vẫn giữ nguyên.
• Bấm đúp vào thanh kéo để trả về độ rộng mặc định.

▶ Khởi động lại service (khai lệnh restart)

• Nút “▶ Khởi động lại TEST / THẬT” chạy đúng lệnh restart bạn khai cho môi trường đó. Nếu chưa khai sẽ báo “Chưa khai lệnh restart cho bản …”.
• Khai lệnh ở đâu: cuộn xuống khối “Deploy TEST” / “Deploy THẬT” trong chi tiết sản phẩm → ô “Lệnh restart” (luôn hiện cho cả Local lẫn Remote). Nhập lệnh rồi Lưu cấu hình — hoặc bấm thẳng nút Khởi động lại (đã tự lưu trước khi chạy).
• Ví dụ web chạy systemd: sudo systemctl restart erpketoan (bản TEST) và sudo systemctl restart erpketoan_real (bản THẬT).
• Lệnh mặc định cài sẵn (khỏi khai tay, để trống ô là dùng được luôn): feedback-self → sudo systemctl restart feedback-site; His6_Site (hissite) → sudo systemctl restart his6-test (TEST) / sudo systemctl restart his6-prod (THẬT). Muốn lệnh khác thì cứ nhập đè vào ô.
• Sản phẩm WinForm (LRQC, His_PostGres) không có service nền để restart — có thể để trống.
• Mẹo: khi bấm Khởi động lại mà thiếu lệnh, hệ thống tự cuộn & focus tới đúng ô “Lệnh restart” để bạn khai ngay.

⬇ Tải bản build (zip)

• Trong chi tiết mỗi sản phẩm có khối “⬇ Tải bản build” với 2 nút: TEST (nén Folder Build Test) và THẬT (nén Folder Build Product).
• Hệ thống đóng gói toàn bộ thư mục build thành 1 file .zip rồi tải về máy bạn.
• Cần khai đúng đường dẫn Folder Build tương ứng và thư mục phải tồn tại trên máy chủ.

⎇ Git — gửi code (push) & trạng thái

• Git Remote Url: địa chỉ kho từ xa (vd https://github.com/.../repo.git hoặc git@host:repo.git).
• 🔍 Kiểm tra trạng thái: xem nhanh — thư mục có phải repo chưa, nhánh hiện tại, số file thay đổi, đã có token chưa và đủ điều kiện push hay không.
• ⇪ Send Git (thủ công): tự add → commit → push Folder Code lên remote. Auto Send Git bật thì hệ thống tự push sau mỗi lần sửa xong.
• 🔑 Đăng nhập Git (token — dùng chung): máy chủ KHÔNG lưu sẵn tài khoản GitHub nên push https sẽ thất bại nếu thiếu token. Nhập GitHub Username + Personal Access Token (PAT, scope repo) một lần — dùng chung cho mọi sản phẩm. Token lưu riêng ở git.json, không hiển thị lại, và không bao giờ ghi vào lịch sử log.
• Tạo PAT: GitHub → Settings → Developer settings → Personal access tokens → cấp quyền repo. Dùng 🗑 Xoá token khi muốn gỡ.
• ⚠ Lỗi could not read Username for 'https://github.com' khi git push = máy chủ chưa có token. Sau khi nhập PAT một lần ở đây, token được ghi vào git credential store nên cả lệnh git thủ công (vd git push -u origin master) lẫn auto push đều xác thực được, không cần nhập tay nữa.
• Lỗi remote: Not Found = sai URL (vd gõ nhầm .../repo/git thay vì .../repo.git); hệ thống tự sửa đuôi /git → .git khi push.

🚀 Tách 2 bước: Duyệt → Update

• Duyệt (đã OK): ở chi tiết góp ý có bản sửa, bấm ✓ Duyệt → góp ý chuyển sang 🟢 Đã duyệt · chờ update. Lúc này CHƯA đè gì vào trang chính.
• Update (đè vào trang chính): mở cửa sổ này (nút 🚀 Chờ update trên thanh đầu trang) → tích chọn các yêu cầu rồi bấm 🚀 Update đã chọn, hoặc bấm 🚀 Update tất cả. Khi đó các yêu cầu đã chọn mới được ban hành vào "Có gì mới" (trang chính) và nâng số phiên bản.
• Bạn cũng có thể update 1 yêu cầu ngay trong chi tiết của nó bằng nút 🚀 Update — đè vào trang chính.
• Mỗi yêu cầu chỉ ban hành 1 lần cho mỗi lần duyệt. Nếu sau đó bạn phản hồi mở lại để sửa tiếp rồi duyệt lại, nó sẽ quay lại danh sách chờ update để bạn update bản mới.
• Con số trên nút 🚀 Chờ update ở thanh đầu trang = số yêu cầu đã duyệt nhưng chưa update.

🆕 Có gì mới (ghi chú bản phát hành)

• Mỗi lần một góp ý được Duyệt (ban hành), hệ thống tự tạo một ghi chú bản phát hành mới và thêm vào danh sách này.
• Số hiệu bản (v…) nâng theo TỪNG sản phẩm: mỗi bản mới của một sản phẩm sẽ nâng +1 ver của riêng sản phẩm đó (v1 → v2 → v3…), độc lập với sản phẩm khác.
• Mỗi mục gồm: số hiệu bản (v…), thời điểm phát hành, sản phẩm, tóm tắt thay đổi (lấy từ nội dung góp ý) và diễn giải đã sửa gì (lấy từ ghi chú sửa của bản đó).
• Danh sách mới nhất ở trên cùng — dùng để biết bản cập nhật gần đây có gì mới (whatnew/changelog).
• Để tool update so sánh phiên bản: mỗi bản build tải về (mục Tải bản build trong Cấu hình sản phẩm) đã kèm file version.json mô tả số hiệu ver + ghi chú từng ver của sản phẩm đó. Tool cũng có thể gọi GET /api/products/<id>/version để biết ver mới nhất rồi so với bản đang cài.
• Nếu một góp ý đã duyệt bị phản hồi mở lại rồi duyệt lại, sẽ sinh thêm một mục bản phát hành mới cho lần ban hành đó.

🤖 Trợ lý hệ thống là gì?

• Là khung chat nổi với Claude (bấm nút tròn 💬 ở góc dưới bên phải để mở/đóng) — chỉ hiện với admin và tài khoản được cấp quyền (admin cấp ở 🛡 Phân quyền › mục “Trợ lý hệ thống”).
• Khác với “💬 Hỏi Claude về góp ý”: chat này KHÔNG gắn với góp ý nào, dùng để nhờ Claude làm các việc liên quan hệ thống nói chung.
• Lịch sử RIÊNG theo tài khoản: mỗi người chỉ thấy hội thoại của chính mình — không lẫn với người khác. Đăng nhập bằng tài khoản khác sẽ thấy lịch sử khác.

Có thể nhờ làm gì?

• Khai / đổi lệnh restart cho sản phẩm (bản TEST và bản THẬT) — vd: “khai lệnh restart bản thật cho His6_Site là sudo systemctl restart his6-prod”. Claude sẽ cập nhật products.json cho bạn.
• Tra cứu cấu hình, kiểm tra trạng thái, hỏi về mã nguồn / cách hệ thống hoạt động.
• Các tác vụ cấu hình khác bạn yêu cầu trực tiếp.

Cách dùng

• Gõ yêu cầu vào ô nhập rồi nhấn Enter hoặc nút Gửi. Claude trả lời ngay trong khung (có thể mất chút thời gian khi cần đọc/sửa mã).
• ⛶ Phóng to khung: bấm nút ⛶ trên đầu khung để “gỡ” rộng khung ra gần kín màn hình (đỡ bị ngắn, dễ đọc câu trả lời dài); bấm lại (🗕) để thu về kích thước thường. Trạng thái được ghi nhớ theo máy.
• 💬 Gửi thêm trong lúc Claude đang trả lời: không cần đợi — cứ gõ yêu cầu bổ sung rồi Gửi thêm; tin sẽ vào hàng đợi (hiện mờ kèm “⏳ đang chờ”) và được xử lý ngay sau câu hiện tại.
• ⛔ Dừng câu trả lời: khi Claude đang trả lời, một thanh trạng thái “⏳ Claude đang trả lời…” hiện ngay phía trên ô nhập, kèm nút ⛔ Dừng ở mép phải — bấm để huỷ ngay câu trả lời đang chạy (máy chủ dừng tiến trình) và xoá luôn hàng đợi chờ xử lý. Một dòng “⛔ Đã dừng câu trả lời theo yêu cầu của bạn.” được ghi lại; sau đó bạn có thể hỏi câu mới như thường.
• 📎 Đính kèm ảnh/tệp: bấm nút 📎 để chọn (được nhiều tệp), hoặc dán (Ctrl+V) ảnh, hoặc kéo-thả tệp vào khung. Claude sẽ xem ảnh / đọc nội dung tệp khi trả lời.
• Nút 🗑 trên đầu khung để xoá lịch sử trò chuyện của riêng bạn (không ảnh hưởng người khác).
• ↖ Kéo chỉnh kích thước: kéo góc trên-trái của khung để mở rộng/thu nhỏ độ rộng & chiều cao; bấm đúp vào góc đó để đặt lại kích thước mặc định (kích thước được ghi nhớ cho lần mở sau).
• ✋ Di chuyển nút 💬: kéo nút tròn 💬 tới bất kỳ vị trí nào trên màn hình (vd khi nó che mất thông báo) — khung chat sẽ tự bám theo nút. Vị trí được ghi nhớ riêng theo từng máy/trình duyệt; bấm-đúp vào nút để trả về góc dưới-phải mặc định. Một cú chạm nhanh (không kéo) vẫn mở/đóng khung như cũ.
• Cuộn lại lịch sử: khung không còn tự nhảy xuống đáy khi bạn đang kéo lên đọc tin cũ — chỉ tự cuộn xuống khi bạn đang ở đáy hoặc vừa mở khung.

An toàn

• Trợ lý không tự restart tiến trình watcher (sẽ chỉ hướng dẫn bạn tự restart khi cần), và không xoá dữ liệu/cấu hình quan trọng.