Dựng dịch vụ tìm kiếm mở rộng
với FastAPI và PostgreSQL

VAI TRÒ
Bạn là kỹ sư backend, quen xây dịch vụ tìm kiếm có khả năng mở rộng. Bạn ưu tiên mã rõ ràng, dễ bảo trì và tách module.

NHIỆM VỤ
Thiết kế và viết mã cho dịch vụ tìm kiếm dùng FastAPI và PostgreSQL theo yêu cầu trong phần ĐẦU VÀO.

ĐẦU VÀO
- Loại dữ liệu cần tìm: [VÍ DỤ: BÀI VIẾT, SẢN PHẨM]
- Trường cần tìm: [VÍ DỤ: TIÊU ĐỀ, MÔ TẢ, THẺ]
- Truy vấn cần hỗ trợ: [VÍ DỤ: TỪ KHÓA, TỪ ĐỒNG NGHĨA, LỌC]
- Quy mô dự kiến: [SỐ BẢN GHI, LƯU LƯỢNG]
- Ràng buộc kỹ thuật: [VÍ DỤ: PYTHON 3.11, POSTGRES 15]
- Đường mở rộng mong muốn: [VÍ DỤ: ELASTICSEARCH, KAFKA]

QUY TẮC
1. Bắt đầu bằng kiến trúc tổng quan dạng module và lý do chọn từng phần.
2. Thiết kế bảng và chỉ mục cho tìm kiếm toàn văn, nêu rõ trường nào dùng chỉ mục nào.
3. Viết các endpoint FastAPI cho tìm kiếm từ khóa, tìm từ đồng nghĩa và lọc kết quả.
4. Tách lớp truy vấn khỏi lớp API để sau này thay bằng Elasticsearch dễ dàng.
5. Mô tả cách ghi log truy vấn và cập nhật dữ liệu thời gian thực qua Kafka bằng lời, chưa cần mã đầy đủ.
6. Có xử lý phân trang và giới hạn kết quả.
7. Ghi chú chỗ nào cần thêm chỉ mục khi dữ liệu lớn lên.

KHUÔN ĐẦU RA
1. Kiến trúc module
2. Sơ đồ bảng và chỉ mục
3. Mã endpoint chính kèm lớp truy vấn
4. Kế hoạch mở rộng sang Elasticsearch và Kafka

Thay nội dung trong dấu [ ] trước khi sử dụng.