Ami - Trợ lý học thuật | AI Academic Agent

Ứng dụng web song ngữ Việt/Anh giúp nhà nghiên cứu đọc tài liệu, chấm mức độ phù hợp, tóm tắt, chọn đoạn đáng trích dẫn và sao chép trích dẫn đúng chuẩn quốc tế. Bản quyền đóng, mọi quyền được bảo lưu (xem LICENSE). Tác giả: Lương Việt Hoàng (ISA Vietnam).

Luồng người dùng

1. Đăng ký + xác thực email (Supabase Auth). Chưa xác thực thì không đăng nhập và không gọi được API.
2. Nhập Abstract/Proposal (tối thiểu 40 từ). Đây là chuẩn để đo độ phù hợp.
3. Tải tài liệu PDF/DOC/DOCX tối đa 2 MB (15 MB với tài khoản đã được quản trị viên xác thực; được chứa ảnh). Văn bản được trích ngay trên máy người dùng; chỉ văn bản gửi lên.
4. AI đánh giá: điểm 0-100 theo 5 tiêu chí (chủ đề 40, khái niệm 20, phương pháp 15, bằng chứng 15, cập nhật 10), tóm tắt, điểm phù hợp/hạn chế.
   • ≥ 60 điểm: danh sách đoạn nên trích, xếp hạng và tô màu ưu tiên cao/trung bình/thấp, kèm số trang. Mỗi đoạn là nguyên văn đã đối chiếu với văn bản gốc; đoạn AI "bịa" bị loại.
   • < 60 điểm: gợi ý nên tìm gì thay thế, công trình tương tự (OpenAlex) và tạp chí đối chiếu với CSDL EduFind: AI chọn 1 đến 3 trong 28 lĩnh vực phù hợp với đề tài, gợi ý tạp chí quốc tế (hạng Q của SJR) và trong nước (điểm tối đa HĐGSNN), kèm liên kết đúng trang lĩnh vực.
5. Trích dẫn: APA 7, Harvard, Chicago (author-date), MLA 9, IEEE, Vancouver, AMA, BibTeX, RIS. Chọn ngôn ngữ trích dẫn tiếng Việt (và, tr., và cs.) hoặc tiếng Anh (&, pp., et al.) độc lập với ngôn ngữ giao diện. Sao chép giữ chữ nghiêng khi dán vào Word.

Kết quả đánh giá hiển thị song ngữ (đổi ngôn ngữ giao diện là đổi cả nhận xét, không gọi AI lần nữa), viết theo văn phong học thuật phù hợp lĩnh vực mà người dùng khai báo trong hồ sơ. Sau phần nhận xét là hộp Quyết định của bạn để chọn hướng đi (trích dẫn, tìm nguồn khác, chỉnh abstract, hoặc vẫn trích dẫn nguồn có điểm thấp). Lịch sử trích dẫn cho đổi kiểu và ngôn ngữ ngay trên từng mục.

Dung lượng tệp: 15 MB cho người dùng đã được quản trị viên xác thực, 2 MB cho tài khoản chưa xác thực (chỉnh được trong Quản trị → Cài đặt). Trang Quản trị → Thống kê có chi phí API thực tế (USD và VND) theo ngày, theo người dùng, token, số lượt phân tích, phân bố điểm phù hợp, người dùng mới và lượt truy cập, kèm biểu đồ tương tác và chế độ xem bảng. Lịch sử trích dẫn gom theo đề tài (abstract đã lưu) hoặc, nếu chỉ có một đề tài, xếp theo mức ưu tiên và điểm phù hợp.

Hạn mức theo hạng tài khoản. Cơ bản (chưa xác thực): đến hết 09/10/2026 là 1 lượt/ngày, từ 10/10/2026 là 1 lượt/tuần (tuần bắt đầu thứ Hai, giờ Việt Nam; ngày áp dụng và số lượt chỉnh trong Quản trị → Cài đặt), lịch sử trích dẫn chỉ xem lại khi đã xác thực (dữ liệu vẫn được lưu) và gợi ý tài liệu chỉ hiện số lượng. Đã xác thực: hạn mức riêng từng người do tác giả đặt (mặc định 1 lượt/ngày), đầy đủ tính năng. Hết lượt thì hiện lời mời xác thực kèm email/SĐT/Zalo của tác giả. Quản trị viên cấp thêm lượt, đặt hạn mức riêng và lọc người dùng thường xuyên chưa xác thực trong trang Quản trị. Master (role admin) không giới hạn. Lượt bị hoàn lại nếu AI lỗi hoặc tài liệu ngôn ngữ khác. Không lưu tài liệu; chỉ lưu hồ sơ, hạn mức và lịch sử trích dẫn đã sao chép.

Chạy trên hosting dùng chung

Ngoài Vercel + Supabase, ứng dụng chạy được như một máy chủ Node + SQLite duy nhất (server/, build với VITE_BACKEND=local) trên hosting cPanel. Xem docs/CPANEL.md (triển khai, di chuyển dữ liệu và tài khoản, chuyển DNS, quay lại).

Phát hành

Dự án theo Semantic Versioning (MAJOR.MINOR.PATCH) và Keep a Changelog. Lịch sử có ở CHANGELOG.md (tiếng Anh), trên web tại /ghi-chu-phat-hanh và /en/release-notes, và ở trang Releases của GitHub. Nguồn duy nhất là scripts/releases.mjs. Ghi chú phát hành chỉ nêu điều người dùng cuối cảm nhận được, không đưa chi tiết kỹ thuật hay việc nội bộ (xem CLAUDE.md).

Quy trình phát hành phiên bản X.Y.Z:

1. Thêm mục mới ở đầu RELEASES trong scripts/releases.mjs (song ngữ), tăng version trong package.json (npm version X.Y.Z --no-git-tag-version), APP.release trong src/lib/config.ts và softwareVersion trong index.html.
2. Chạy npm run release:notes để sinh lại CHANGELOG.md và hai trang ghi chú; cập nhật lastmod trong public/sitemap.xml.
3. npm run typecheck && npm test && npm run build (có tests/release.test.ts kiểm tra các số phiên bản và bản sinh khớp nhau), mở PR vào main và gộp khi CI xanh. Vercel tự triển khai main.
4. Tạo thẻ và GitHub Release: gắn thẻ có chú thích rồi đẩy lên (git tag -a vX.Y.Z -m "AI Academic Agent X.Y.Z" && git push origin vX.Y.Z), hoặc vào Actions → Release → Run workflow (nhập version, tùy chọn target là commit đích; workflow tự tạo thẻ). Workflow .github/workflows/release.yml kiểm tra mục tương ứng trong CHANGELOG.md, chạy typecheck, kiểm thử và build (với phiên bản mới nhất), rồi tạo GitHub Release với nội dung lấy từ CHANGELOG.md.
5. Ứng dụng tự báo trên web: số phiên bản và liên kết ghi chú ở chân trang, thông báo "Mới trong phiên bản X.Y.Z" một lần cho mỗi người dùng (lưu tl-seen-release trong trình duyệt).

This is the beginning of the README. Read the rest at the original. Read the full README ↗