🎓 ScholarTrend Project

Hệ thống theo dõi xu hướng công bố báo chí khoa học (Scientific Journal Publication Trend Tracking System).

Dự án SWP — nhóm SU26SWP06. Backend REST API xây dựng trên .NET 9, kế trúc Clean Architecture.

Hỗ trợ cung cấp đầy đủ chức năng từ xác thực người dùng, tìm kiếm bài báo, phân tích luồng dữ liệu Trend, gợi ý cá nhân hóa, đồng bộ data Job Background (Hangfire), đến dashboard và báo cáo.

---

📚 Tài liệu Dự án (Documentation)

Để dễ dàng theo dõi và bảo trì, toàn bộ tài liệu hướng dẫn và đặc tả API của hệ thống đã được phân tách thành các chuyên đề chi tiết trong thư mục docs/. Vui lòng nhấn vào các liên kết bên dưới để xem chi tiết:

1. 🏛️ Tổng quan Kiến trúc & Công nghệ (Tech Stack & Architecture)

   • Phân tầng Clean Architecture.
   • Các công nghệ áp dụng (.NET 9, Hangfire, JWT...).
   • Role người dùng trong hệ thống.

2. 🚀 Hướng dẫn Cài đặt & Chạy Dự án (Setup Guide)

   • Cấu hình chuỗi kết nối Database và appsettings.
   • Cơ chế tạo Dữ liệu mẫu (Seeder).
   • Tài khoản Test mặc định.
   • Hướng dẫn dùng Swagger.

3. 🔐 Chức năng Xác thực & Người dùng (Auth Features)

   • Cơ chế hoạt động của JWT Access Token & Refresh Token.
   • Các API Đăng ký, Đăng nhập (Google Login).
   • Xác thực Email qua Brevo, Quên/Đổi mật khẩu.
   • Profile người dùng.

4. 🔍 Chức năng Tìm kiếm & Cốt lõi (Core Features)

   • API Tìm kiếm, Danh sách Bài báo, Chủ đề (Topics), Tạp chí (Journals), Tác giả.
   • Tính năng lưu trữ Bookmark bài báo.

5. 📈 Động cơ Xu hướng & Cá nhân hóa (Trend & Personalization)

   • API xuất biểu đồ Xu hướng (Line Charts, Dashboards).
   • Chức năng theo dõi (Follows).
   • Hệ thống Thông báo (Notifications).

6. ⚙️ Quản trị viên, Xuất Báo cáo & Đồng bộ (Admin & Sync)

   • Quản trị viên (Phân quyền, bật/tắt User).
   • Kích hoạt Đồng bộ dữ liệu (Data Sync) qua Hangfire từ Semantic Scholar, OpenAlex.
   • Xuất (Export) báo cáo dữ liệu định dạng JSON, CSV.

7. 🧠 Master Plan: Automated Literature Review (Topic Review)

   • Kế hoạch tổng hợp full vision: AI Survey Paper Generator.
   • Pipeline 7 phase, database schema, API design, timeline & rủi ro.

---

🛠️ Công nghệ tóm tắt

• Framework: .NET 9 ASP.NET Core Web API (RESTful)
• Database: Entity Framework Core 9 + PostgreSQL (Supabase / Neon / Docker)
• Authentication: ASP.NET Identity + JWT Bearer
• Job Background: Hangfire (PostgreSQL storage)
• Unit Test: xUnit + Moq + FluentAssertions
• Data Source: Semantic Scholar, OpenAlex, Crossref, ArXiv

---

💡 Mẹo: Project này cung cấp sẵn Data mẫu (Fake Seeding Database) cho lần chạy đầu tiên. Hãy xem file docs/1_getting_started.md để dùng thử nhé!