SurfSense/_bmad-output/index.md

Mục Lục Tài Liệu Tổng Hợp (Master Index)

Chào mừng đến với tài liệu kỹ thuật của SurfSense. Đây là một nền tảng tìm kiếm và kiến thức AI đa thành phần.

🧭 Bắt Đầu

• Tổng Quan Dự Án - Tóm tắt cấp cao về hệ thống.
• Phân Tích Cây Mã Nguồn - Bản đồ các thư mục và tệp tin.
• Kiến Trúc Tích Hợp - Cách các thành phần giao tiếp với nhau.

📚 Hướng Dẫn Sử Dụng

• Hướng Dẫn Người Dùng - Cài đặt, sử dụng tính năng, troubleshooting.
• Hướng Dẫn Quản Trị - Quản lý users, cấu hình hệ thống, monitoring.
• Hướng Dẫn Developer - Setup môi trường, API reference, deployment.

🏗️ Tài Liệu Thành Phần

🐍 Backend (surfsense_backend)

Bộ não của hệ thống. Python/FastAPI microservice.

• Kiến Trúc - DeepAgents, LangGraph, và RAG.
• Hợp Đồng API - Các REST Endpoints và Auth.
• Mô Hình Dữ Liệu - Database Schema & Thực thể.

💻 Web Dashboard (surfsense_web)

Giao diện người dùng. Next.js 16 Web App.

• Kiến Trúc - App Router, Server Actions, ElectricSQL.
• Inventory Component - Phân tích thư viện UI.

🧩 Browser Extension (surfsense_browser_extension)

Bộ thu thập dữ liệu. Plasmo/React Extension.

• Kiến Trúc - Popup, Background Services, Manifest V3.

📊 Báo Cáo

• Báo Cáo Quét Dự Án - Dữ liệu quét dạng máy đọc (machine-readable).