FastVocab là một ứng dụng web được xây dựng với .NET 9 và Blazor Server, giúp người dùng học và quản lý từ vựng một cách hiệu quả thông qua các phương pháp luyện tập đa dạng.
FastVocab không chỉ là một ứng dụng ghi chú từ vựng đơn thuần. Đây là một hệ thống toàn diện cho phép bạn:
- Tổ chức từ vựng theo các chủ đề (topics) cụ thể.
- Học từ mới thông qua giao diện người dùng trực quan.
- Ôn tập kiến thức với nhiều hình thức kiểm tra: trắc nghiệm, chép chính tả, và ghép thẻ.
Dự án được xây dựng nhằm mục đích thực hành và áp dụng các công nghệ .NET mới nhất, cùng với kiến trúc phần mềm hiện đại như Clean Architecture và CQRS.
- ✅ Quản lý Chủ đề (Topics): Tạo, xem, sửa, xóa các chủ đề từ vựng (ví dụ: "IELTS Reading", "Từ vựng IT", "Tiếng Anh công sở").
- ✅ Quản lý Từ vựng (Vocabulary): Thêm từ mới vào các chủ đề, kèm theo định nghĩa, ví dụ, và phát âm.
- ✅ Luyện tập Trắc nghiệm (Multiple Choice): Hệ thống tự động tạo bài kiểm tra trắc nghiệm dựa trên các chủ đề bạn chọn.
- ✅ Luyện tập Chép chính tả (Dictation): Nghe và gõ lại từ vựng để luyện kỹ năng nghe và viết.
- ✅ Luyện tập Ghép thẻ (Matching): Kéo thả để ghép từ vựng với định nghĩa hoặc hình ảnh tương ứng.
- ✅ Giao diện hiện đại: Sử dụng thư viện Ant Design Blazor cho trải nghiệm người dùng mượt mà và đẹp mắt.
Bạn có thể xem demo trực tiếp tại đây: https://youtu.be/zlP1AwH6dpA
| Trang chủ | Luyện tập trắc nghiệm | Chép chính tả | Ghép thẻ |
|---|---|---|---|
 |
 |
 |
 |
Dự án này là sự kết hợp của các công nghệ và phương pháp luận tiên tiến trong hệ sinh thái .NET.
- Nền tảng: .NET 9
- Database: SQL Server 2022
- Frameworks:
- Backend: ASP.NET Core Web API 9
- Frontend: Blazor Server
- Data Access: Entity Framework Core 9 (EF Core)
- UI Component: Ant Design Blazor
- In-Memory Messaging: MediatR
Dự án được xây dựng dựa trên:
- Clean Architecture: Phân tách rõ ràng các lớp (Domain, Application, Infrastructure, Presentation) để đảm bảo tính độc lập, dễ bảo trì và dễ kiểm thử (testable).
- CQRS (Command Query Responsibility Segregation): Tách biệt các luồng xử lý "Ghi" (Commands) và "Đọc" (Queries) để tối ưu hóa hiệu suất và đơn giản hóa logic nghiệp vụ. MediatR được sử dụng để triển khai pattern này một cách hiệu quả.
Để chạy dự án này local, bạn cần:
- .NET 9 SDK
- SQL Server 2022 (hoặc SQL Server Express/Developer Edition)
- Một IDE như Visual Studio 2022 hoặc VS Code.
-
Clone repository:
git clone https://github.com/annghdev/FastVocab.git cd FastVocab -
Cấu hình Database:
- Mở file
appsettings.jsonhoặc tạoappsettings.Development.jsontrong dự ánFastVocab.Api(hoặc dự án Infrastructure của bạn). - Cập nhật chuỗi
ConnectionStringsđể trỏ đến instance SQL Server 2022 của bạn.
"ConnectionStrings": { "DefaultConnection": "Server=YOUR_SERVER;Database=FastVocabDb;User Id=YOUR_USER;Password=YOUR_PASSWORD;TrustServerCertificate=True;" }
- Mở file
-
Áp dụng Migrations:
- Mở Terminal/Command Prompt trong thư mục gốc của dự án.
- Chạy lệnh sau để tạo database và schema (đảm bảo bạn đã cài đặt
dotnet-eftool):
dotnet ef database update --project server/src/FastVocab.Infrastructure
- Hoặc dùng tool trong Visual Studio 2022, xem video demo nếu bạn chưa biết
-
Chạy ứng dụng:
- Cách 1 (Visual Studio): Mở file
.slnvà thiết lập "Multiple startup projects". Chọn "Start" cho cả dự án API (FastVocab.Api) và dự án Blazor Server (FastVocab.Blazor). - Cách 2 (CLI):
- Mở 2 terminal.
- Terminal 1 (chạy API):
dotnet run --project server/src/FastVocab.API - Terminal 2 (chạy Blazor):
dotnet run --project clients/web/FastVocab.BlazorWebApp
- Cách 1 (Visual Studio): Mở file
-
Truy cập ứng dụng: Mở trình duyệt và truy cập vào địa chỉ mà Blazor Server đang chạy (
https://localhost:7226). Temple file excel nhập từ vựng nằm trong folder/documents
Dự án này được cấp phép theo Giấy phép MIT. Xem chi tiết tại file LICENSE
Bản quyền (c) 2025 annghdev
Cảm ơn bạn đã ghé thăm dự án! Nếu bạn thấy hữu ích, đừng quên tặng một ⭐ nhé!