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ì tính ổn định địa chỉ và các tín hiệu SEO.

Hiện tại, các URI của bản thân các Concepts đã được chuẩn hóa và có thể thay đổi an toàn thông qua 301, nhưng tính toàn vẹn của các liên kết bên trong content thì không được đảm bảo. Kết quả là các liên kết nội bộ bị hỏng đã xuất hiện trong một số Concepts do AI tạo ra.

Cần làm gì

1. Resolver xác thực liên kết hỏng cho Concepts

Thêm một GraphQL resolver quản trị để phân tích content của Concepts và tìm các liên kết trỏ đến các URI nội bộ không tồn tại.

Một cách triển khai tương tự đã tồn tại ở dự án khác — trước tiên hãy tìm và tái sử dụng/thích ứng cách tiếp cận hiện có thay vì viết thuật toán từ đầu.

Resolver tối thiểu phải có khả năng:

• kiểm tra một Concept;
• kiểm tra một tập hợp/tất cả các Concepts;
• trích xuất các liên kết Markdown/HTML/custom-tag nội bộ dẫn đến các tuyến đường của trang web;
• phân biệt URI hiện có với URI bị hỏng;
• trả về Concept, href nguồn và lý do lỗi;
• nếu có thể, phân biệt giữa một tuyến đường bị thiếu hoàn toàn và một URI được biết sẵn redirect/canonical replacement.

2. Helper chung cho create/update Concept

Tách việc xử lý liên kết thành một reusable helper và tích hợp nó vào quá trình tạo và cập nhật Concept.

Trước khi lưu content, helper phải:

1. phân tích các liên kết nội bộ;
2. kiểm tra chúng dựa trên các tuyến đường/Concept URI hiện tại;
3. nếu liên kết trỏ đến một URI cũ đã biết với canonical/redirect rõ ràng — tự động thay thế href bằng URI hiện tại;
4. không sửa đổi các URL bên ngoài;
5. không thực hiện các bản sửa lỗi mang tính mơ hồ một cách âm thầm;
6. giữ nguyên cấu trúc Markdown và các custom tags được cho phép.

Mục tiêu là để AI và người dùng có thể tham chiếu đến một Concept theo địa chỉ quen thuộc, trong khi hệ thống tự động duy trì các liên kết nội bộ luôn được cập nhật.

Tại sao điều này quan trọng

Trong mô hình haih-agent/fi1osof.ru mới, đồ thị Concepts chính là cốt lõi thông tin. Một liên kết hỏng không chỉ là lỗi UX của trang, mà là sự đứt gãy của đồ thị ngữ nghĩa.

Xác thực tự động là cần thiết để:

• SEO và khả năng thu thập thông tin (crawlability);
• bảo tồn PageRank/tín hiệu liên kết nội bộ;
• điều hướng người dùng chính xác;
• hoạt động đáng tin cậy của AI khi chuyển đổi qua các liên kết Concept;
• thay đổi hàng loạt ЧПУ (human-readable URLs) một cách an toàn;
• ngăn chặn việc tích tụ nợ kỹ thuật khi quản lý nội dung bằng AI.

Tiêu chí nghiệm thu

• Có admin resolver để kiểm tra một và nhiều Concepts về các liên kết nội bộ bị hỏng.
• Đã nghiên cứu trước và nếu có thể, tái sử dụng cách triển khai từ dự án khác.
• Resolver trả về cụ thể Concept + href + loại sự cố.
• Quá trình Create/update Concept đi qua helper xử lý liên kết nội bộ chung.
• Các URI cũ đã biết được tự động thay thế bằng canonical URI hiện tại khi sự tương ứng là rõ ràng.
• Các liên kết bên ngoài không bị viết lại.
• Các liên kết mơ hồ/không xác định không bị sửa bằng cách đoán mò.
• Đã thêm các bài kiểm tra (tests) cho liên kết hợp lệ, 404, redirect/canonical replacement, nhiều liên kết, liên kết bên ngoài và nội dung custom-tag/Markdown.
• Các Concepts hiện có có thể được kiểm tra hàng loạt và nhận báo cáo để khắc phục sau đó.