Bookstore.Mobile - Ứng dụng Quản lý Nhà sách

Giao diện Hiện đại, Thân thiện cho Hệ thống Quản lý Nhà sách (A Modern and User-Friendly Interface for the Bookstore Management System)

Mục lục

• Tổng quan
• Tính năng Chính (Phía Client)
• Kiến trúc Client (MAUI)
• Công nghệ Sử dụng (Client)
• Ảnh chụp Màn hình (Screenshots)
• Đóng góp
• License

Tổng quan

Bookstore.Mobile là một ứng dụng đa nền tảng được xây dựng bằng .NET MAUI, cung cấp giao diện người dùng trực quan và hiện đại để tương tác với BookStoreManagement-API. Ứng dụng cho phép cả Khách hàng (Customers) và Nhân viên/Quản trị viên (Staff/Admin) truy cập và quản lý các hoạt động của nhà sách một cách hiệu quả.

Ứng dụng được thiết kế để chạy trên Android, iOS, Windows và macOS (tùy thuộc vào cấu hình và mục tiêu triển khai).

Tính năng Chính (Phía Client)

Ứng dụng MAUI này triển khai các chức năng tương ứng với các API đã được cung cấp bởi backend:

• Khách hàng (Customer):
  • 🔐 Đăng ký & Đăng nhập: Tạo tài khoản mới và đăng nhập an toàn.
  • 🏠 Trang chủ: Hiển thị sách mới, khuyến mãi nổi bật.
  • 📖 Duyệt Sản phẩm: Xem danh sách danh mục, duyệt sách theo danh mục, tìm kiếm sách.
  • ℹ️ Xem Chi tiết Sách: Xem thông tin đầy đủ, hình ảnh, mô tả, giá, đánh giá.
  • ❤️ Danh sách Yêu thích: Thêm/xóa sách vào danh sách yêu thích cá nhân.
  • 🛒 Giỏ hàng: Thêm sách vào giỏ, cập nhật số lượng, xóa sản phẩm, xem tổng tiền.
  • 👤 Quản lý Hồ sơ: Xem thông tin cá nhân, quản lý địa chỉ giao hàng (thêm, sửa, xóa, đặt mặc định).
  • 🛍️ Đặt hàng (Checkout): Chọn địa chỉ, xem lại đơn hàng, đặt hàng (tích hợp thanh toán giả lập).
  • 📋 Lịch sử Đơn hàng: Xem danh sách các đơn hàng đã đặt và chi tiết từng đơn.
  • ⭐ Gửi Đánh giá: Viết và gửi đánh giá cho các cuốn sách.
  • 🔑 Đăng xuất.
• Quản trị viên & Nhân viên (Admin/Staff - Các chức năng này sẽ hiển thị tùy theo vai trò sau khi đăng nhập):
  • 📊 Dashboard Quản lý: Xem các số liệu tổng quan nhanh (doanh thu, đơn hàng mới...).
  • 📦 Quản lý Đơn hàng: Xem danh sách tất cả đơn hàng, lọc theo trạng thái, xem chi tiết, cập nhật trạng thái đơn hàng.
  • 📚 Quản lý Sản phẩm: Xem danh sách, Thêm/Sửa/Xóa Sách, Danh mục, Tác giả. Upload ảnh bìa.
  • 🚚 Quản lý Kho: Tạo phiếu nhập kho, xem lịch sử phiếu nhập, thực hiện điều chỉnh tồn kho thủ công.
  • 🏷️ Quản lý Khuyến mãi: Xem danh sách, Thêm/Sửa/Xóa mã khuyến mãi.
  • 👥 Quản lý Người dùng (Admin): Xem danh sách người dùng, xem chi tiết, kích hoạt/vô hiệu hóa tài khoản, (tùy chọn) thay đổi vai trò.
  • 📈 Xem Báo cáo: Truy cập các báo cáo Doanh thu, Sách bán chạy, Tồn kho thấp (có thể kèm biểu đồ).

Kiến trúc Client (MAUI)

Ứng dụng MAUI được xây dựng theo kiến trúc MVVM (Model-View-ViewModel) để đảm bảo sự phân tách rõ ràng và khả năng bảo trì:

• Views: Các file XAML định nghĩa giao diện người dùng và các file code-behind (.xaml.cs) tối thiểu logic.
• ViewModels: Các lớp chứa logic trình bày, trạng thái của View và các lệnh (Commands) được binding với View. Sử dụng CommunityToolkit.Mvvm.
• Models/DTOs: Các lớp đại diện cho dữ liệu (thường là các DTOs được copy hoặc tham chiếu từ project API) được sử dụng trong ViewModels và Views.
• Services: Các lớp chịu trách nhiệm thực hiện các tác vụ cụ thể như gọi API, quản lý trạng thái đăng nhập, điều hướng...
• Interfaces: Định nghĩa các "hợp đồng" cho Services và API Clients.
• Handlers: Các DelegatingHandler tùy chỉnh để xử lý các vấn đề xuyên suốt như đính kèm token xác thực.
• Converters: Các IValueConverter để chuyển đổi dữ liệu cho mục đích binding trên UI.
• Shell: Sử dụng .NET MAUI Shell cho cấu trúc điều hướng chính (Flyout/Tabs) và routing.

Công nghệ Sử dụng (Client)

• Framework: .NET MAUI (trên .NET 8.0 / .NET 9 Preview)
• Ngôn ngữ: C#
• UI: XAML
• Kiến trúc: MVVM (sử dụng CommunityToolkit.Mvvm)
• Gọi API: Refit (với System.Text.Json hoặc Newtonsoft.Json)
• Điều hướng: .NET MAUI Shell
• Dependency Injection: Tích hợp sẵn trong .NET MAUI (Microsoft.Extensions.DependencyInjection)
• Lưu trữ An toàn: Microsoft.Maui.Storage.SecureStorage (cho JWT token)
• Lưu trữ Tùy chọn: Microsoft.Maui.Storage.Preferences
• Xử lý Ảnh (Hiển thị): Các control Image chuẩn của MAUI, có thể xem xét FFImageLoading.Maui hoặc CommunityToolkit.Maui.ImageCaching để tối ưu.
• Biểu đồ: Microcharts.Maui
• Logging: Microsoft.Extensions.Logging

Ảnh chụp Màn hình (Screenshots)

Đóng góp

License