Các tác vụ chính

Phần này cung cấp các hướng dẫn chi tiết cho các tác vụ cụ thể.

Triển khai

Triển khai với Ansible

Dự án này sử dụng Ansible để tự động hóa việc triển khai.

1. Cài đặt Ansible: Đảm bảo bạn đã cài đặt Ansible trên máy điều khiển.
2. Cấu hình Inventory: Sửa tệp ansible/inventory để thêm thông tin về các server đích.
3. Cấu hình biến: Sửa các tệp trong ansible/vars và ansible/vault (sử dụng ansible-vault edit) để định cấu hình cho môi trường của bạn.
4. Chạy Playbook:

ansible-playbook -i ansible/inventory ansible/task/main.yml

Quản lý dữ liệu

Đồng bộ hóa sách

Để cập nhật danh sách sách từ nguồn dữ liệu, bạn có thể chạy script sync_book.py.

python scripts/sync_book.py  

Tạo Vector Store

Để chatbot có thể tìm kiếm thông tin từ tài liệu, bạn cần tạo hoặc cập nhật vector store.

python scripts/vectorstore.py

Phát triển

Thêm một API Endpoint mới

1. Tạo schema: Định nghĩa Pydantic model trong app/schema/.
2. Viết service logic: Thêm business logic vào một tệp trong app/services/.
3. Tạo router: Thêm một tệp mới trong app/routes/ và định nghĩa endpoint sử dụng FastAPI's decorators (@router.post, @router.get, etc.).
4. Include router: Thêm router mới vào app/routes/Routers và import nó trong main.py.