Nhiệm vụ: Thêm tính năng cập nhật chuyển tự URI bắt buộc và tự động cho Concept
Thêm tính năng cập nhật chuyển tự URI bắt buộc và tự động cho Concept
Thêm nút cập nhật thủ công chuyển tự của Concept và tự động duy trì URL thân thiện (ChPU) khi tạo/cập nhật nội dung.
Bối cảnh
Nguồn chân lý kiến trúc: Hệ thống URI thân thiện với con người trong haih-agent duy trì sự ổn định của địa chỉ và tín hiệu SEO.
Trên fi1osof.ru, các Concept đang trở thành các trang SEO/GEO công khai chính. Các URL thân thiện (ChPU) phải tương ứng một cách có hệ thống với tên/nội dung hiện tại của Concept và không phụ thuộc vào việc người dùng có nhớ cập nhật thủ công URI hay không.
Cần làm gì
1. Nút cập nhật chuyển tự bắt buộc
Trong giao diện chỉnh sửa Concept, thêm một hành động rõ ràng, chẳng hạn như "Cập nhật URI / chuyển tự".
Thao tác này cần:
- tính toán lại URI thân thiện theo quy tắc slugify/transliteration hiện hành;
- hiển thị/áp dụng URI mới;
- sử dụng cơ chế thay đổi URI chung để địa chỉ cũ được chuyển hướng thông qua 301;
- xử lý chính xác xung đột (collision) của URI mới.
Điều này là cần thiết đối với các Concept đã tồn tại và các trường hợp cần xây dựng lại một cách rõ ràng một slug cũ hoặc không tốt.
2. Chuyển tự tự động khi tạo/cập nhật (create/update)
Khi tạo Concept, URI phải được tự động tạo từ name hiện tại theo logic ChPU chung.
Khi cập nhật Concept, cần tự động cập nhật chuyển tự/slug trong các trường hợp tên hoặc trường khác mà URI phụ thuộc vào đã thay đổi.
Không sao chép thuật toán slugify ở frontend: sử dụng hàm phía máy chủ (server) chung của haih-agent.
Khi thay đổi URI, bắt buộc phải sử dụng cơ chế hiện có old URI → 301 → new URI.
Điều quan trọng là không tạo ra cơ chế xáo trộn vô tận: nếu URI được tính toán trùng khớp với URI hiện tại, không thay đổi gì cả.
Ý nghĩa SEO
Tên của Concept là một trong những tín hiệu ngữ nghĩa chính của trang. URI phải phản ánh chủ đề hiện tại để:
- các từ khóa xuất hiện trong URL;
- các Concept mới được tạo ngay lập tức với URL thân thiện thay vì CUID;
- một Concept được đổi tên không bị kẹt mãi với slug vô nghĩa cũ;
- canonical URL và các liên kết nội bộ duy trì sự đồng bộ;
- các địa chỉ cũ giữ lại các tín hiệu tích lũy thông qua chuyển hướng 301.
Tiêu chí nghiệm thu
- Trong trình chỉnh sửa Concept có nút tính toán lại URI/chuyển tự bắt buộc.
- Khi tạo Concept, URL thân thiện được tạo tự động.
- Khi thay đổi tên (name), URI sẽ tự động được đưa về slug hiện hành theo quy tắc thống nhất.
- Sử dụng logic slugify/transliteration chung ở phía máy chủ của haih-agent.
- Khi thay đổi URI, hệ thống tự động tạo/sử dụng chuyển hướng 301 từ địa chỉ cũ.
- Lưu lại lần nữa mà không thay đổi slug đích thì sẽ không làm thay đổi URI.
- Xung đột của URI mới được xử lý một cách an toàn và rõ ràng.
- Đã thêm các bài kiểm tra hồi quy (regression tests) cho các thao tác tạo, đổi tên, làm mới bắt buộc, giữ nguyên slug và xung đột.