Phân Tích Thiết Kế Phần Mềm SPRING_STORE

Tìm hiểu về thiết kế phần mềm cửa hàng mùa xuân qua bài viết của mentor Quách Luyl Đa, khám phá các tiêu chuẩn và giải pháp hiệu quả.

• Trường học: Trường Đại Học Công Nghệ Thông Tin
• Chuyên ngành: Kỹ Thuật Phần Mềm
• Đề tài: Phân Tích Thiết Kế Phần Mềm SPRING_STORE
• Loại tài liệu: Đồ Án Tốt Nghiệp
• Năm xuất bản: 2023
• Địa điểm: Hồ Chí Minh

Mục lục chi tiết

• LỊCH SỬ THAY ĐỔI
• 1. CHƯƠNG 1: TỔNG QUAN KIẾN TRÚC VÀ CƠ SỞ DỮ LIỆU
• 1.1. Gói mã nguồn (Code Packages)
• 1.1.1. Mô tả các gói (Package descriptions)
• 1.2. Mô tả bảng cơ sở dữ liệu (Table Description)
• 2. CHƯƠNG 2: ĐẶC TẢ CHI TIẾT CÁC LỚP VÀ CHỨC NĂNG
• 2.1. Đăng nhập cho người dùng (Login for user)
• 2.1.1. Đặc tả các lớp (Class Specifications)
• 2.1.1.1. LoginController
• 2.1.1.2. UserDAO
• 2.1.1.3. User
• 2.1.1.4. DBContext
• 2.1.2. Biểu đồ tuần tự (Sequence Diagram)
• 2.1.3. Truy vấn cơ sở dữ liệu (Database Queries)
• 2.2. Đăng nhập cho nhân viên (Login for staff)
• 2.2.1. Đặc tả các lớp (Class Specifications)
• 2.2.1.1. LoginController
• 2.2.1.2. StaffDAO
• 2.2.1.3. Staff
• 2.2.1.4. DBContext
• 2.2.2. Biểu đồ tuần tự (Sequence Diagram)
• 2.2.3. Truy vấn cơ sở dữ liệu (Database Queries)
• 2.3. Thêm sản phẩm bởi nhân viên (Add Product By Staff)
• 2.3.1. Đặc tả các lớp (Class Specifications)
• 2.3.1.1. Product Controller
• 2.3.1.2. Product DAO
• 2.3.1.3. HTTPServlet
• 2.4. Cập nhật sản phẩm bởi nhân viên (Update Product By Staff)
• 2.4.1. Đặc tả các lớp (Class Specifications)
• 2.4.1.1. Product Controller
• 2.4.1.2. Product DAO
• 2.4.1.3. Product
• 2.4.2. Biểu đồ tuần tự (Sequence Diagram)
• 2.4.3. Truy vấn cơ sở dữ liệu (Database queries)
• 2.5. Thêm đơn hàng (Add An Order)
• 2.5.1. Đặc tả các lớp (Class Specifications)
• 2.5.1.1. AddAnOrderController
• 2.5.1.2. orderDAO
• 2.5.1.3. Order
• 2.5.1.4. DBContext
• 2.5.2. Biểu đồ tuần tự (Sequence Diagram)
• 2.5.3. Truy vấn cơ sở dữ liệu (Database Queries)
• 2.6. Danh sách danh mục sản phẩm cho người dùng (List Product category by Users)
• 2.6.1. Biểu đồ lớp (Class Diagram)
• 2.6.2. Đặc tả các lớp (Class Specifications)
• 2.6.2.1. Product Controller
• 2.6.2.2. Product DAO
• 2.6.2.3. HTTPServlet
• 2.6.3. Truy vấn cơ sở dữ liệu (Database queries)
• 2.7. Tìm kiếm sản phẩm (Search Product)
• 2.7.1. Biểu đồ lớp (Class diagram)
• 2.7.2. Đặc tả các lớp (Class Specifications)
• 2.7.2.1. Product Controller
• 2.7.2.2. Product DAO
• 2.7.2.3. Product
• 2.7.3. Biểu đồ tuần tự (Sequence Diagram)
• 2.7.4. Truy vấn cơ sở dữ liệu (Database queries)
• 2.8. Xóa danh sách sản phẩm trong giỏ hàng (Delete list product in cart)
• 2.8.1. Đặc tả các lớp (Class Specifications)
• 2.8.1.1. DeleteListProductInCartController
• 2.8.1.2. Product
• 2.8.1.3. Dbconnection
• 2.8.2. Biểu đồ tuần tự (Sequence Diagram)

Tóm tắt

I. Hướng Dẫn Phân Tích Thiết Kế Phần Mềm SPRING_STORE Toàn Diện

Bài viết này cung cấp một phân tích chi tiết về thiết kế phần mềm SPRING_STORE, một dự án website bán hàng được xây dựng dựa trên nền tảng Spring Framework. Mục tiêu chính là làm rõ cấu trúc, kiến trúc và các quyết định thiết kế cốt lõi đã được áp dụng trong quá trình phát triển. Việc phân tích thiết kế hệ thống không chỉ giúp hiểu rõ cách hệ thống hoạt động mà còn là nền tảng để bảo trì, mở rộng và phát triển các tính năng mới trong tương lai. Dự án SPRING_STORE là một ví dụ điển hình của một hệ thống e-commerce cơ bản, bao gồm các chức năng thiết yếu như quản lý người dùng, sản phẩm, giỏ hàng và đơn hàng. Tài liệu gốc cung cấp cái nhìn sâu sắc về cách các thành phần như Controller, DAO (Data Access Object), và Model tương tác với nhau theo mô hình MVC. Phân tích này sẽ đi sâu vào việc đặc tả các yêu cầu, thiết kế cơ sở dữ liệu, và lựa chọn công nghệ. Việc áp dụng các công nghệ như Spring Boot, Spring MVC, và Spring Data JPA cùng với Hibernate cho thấy một cách tiếp cận hiện đại trong việc xây dựng ứng dụng web Java. Bài viết sẽ lần lượt đi qua các thách thức trong thiết kế, giải pháp kiến trúc, phân tích chi tiết bằng UML, và các ứng dụng thực tiễn qua những chức năng cụ thể, tuân thủ một quy trình phát triển phần mềm có cấu trúc.

1.1. Giới thiệu tổng quan về dự án SPRING_STORE và mục tiêu

Dự án SPRING_STORE là một hệ thống quản lý bán hàng trực tuyến, được phát triển nhằm mục đích cung cấp một nền tảng e-commerce đầy đủ chức năng. Mục tiêu của việc phân tích thiết kế phần mềm này là để làm sáng tỏ các thành phần cấu thành hệ thống, từ kiến trúc tổng thể đến chi tiết từng module. Hệ thống được xây dựng để phục vụ ba đối tượng người dùng chính: Người dùng (User), Nhân viên (Staff), và Quản trị viên (Admin), mỗi đối tượng có những vai trò và quyền hạn riêng biệt. Tài liệu đặc tả yêu cầu phần mềm (SRS) chỉ ra các chức năng cốt lõi bao gồm: đăng ký/đăng nhập, quản lý hồ sơ người dùng, xem và tìm kiếm sản phẩm, quản lý giỏ hàng, đặt hàng và xem lịch sử đơn hàng. Đối với nhân viên, hệ thống cho phép quản lý sản phẩm (thêm, sửa, xóa) và xem danh sách đơn hàng. Quản trị viên có quyền cao nhất, bao gồm quản lý tài khoản nhân viên và người dùng. Việc phân tích này giúp đánh giá tính hiệu quả của các giải pháp công nghệ đã chọn, như việc sử dụng Spring Framework để xây dựng một ứng dụng vững chắc và dễ bảo trì.

1.2. Tầm quan trọng của việc phân tích thiết kế trong dự án

Phân tích và thiết kế là giai đoạn nền tảng quyết định sự thành công của bất kỳ dự án phần mềm nào. Đối với SPRING_STORE, việc này đảm bảo rằng tất cả các yêu cầu nghiệp vụ được chuyển hóa thành một cấu trúc kỹ thuật rõ ràng và hiệu quả. Một thiết kế tốt giúp giảm thiểu rủi ro, tối ưu hóa hiệu suất và tạo điều kiện thuận lợi cho việc mở rộng hệ thống sau này. Nó cũng giúp đội ngũ phát triển, từ lập trình viên đến kiểm thử viên, có một cái nhìn chung và nhất quán về sản phẩm. Bằng cách sử dụng các công cụ và phương pháp chuẩn hóa như UML, đội ngũ có thể mô hình hóa các khía cạnh khác nhau của hệ thống một cách trực quan. Việc này giúp phát hiện sớm các mâu thuẫn hoặc thiếu sót trong logic nghiệp vụ trước khi bắt đầu viết mã, tiết kiệm đáng kể thời gian và chi phí. Hơn nữa, tài liệu thiết kế chi tiết là một tài sản quý giá cho quá trình bảo trì, giúp các nhà phát triển mới nhanh chóng nắm bắt được cấu trúc và luồng hoạt động của hệ thống.

II. Thách Thức Khi Thiết Kế Hệ Thống E commerce SPRING_STORE

Xây dựng một hệ thống e-commerce như SPRING_STORE đặt ra nhiều thách thức phức tạp về mặt kỹ thuật và nghiệp vụ. Một trong những vấn đề cốt lõi là việc xác thực và phân quyền cho các vai trò người dùng khác nhau (User, Staff, Admin). Hệ thống phải đảm bảo rằng mỗi người dùng chỉ có thể truy cập và thực hiện các chức năng được cho phép, bảo vệ dữ liệu nhạy cảm và ngăn chặn các hành vi trái phép. Thách thức thứ hai là quản lý trạng thái và dữ liệu một cách nhất quán, đặc biệt là trong các quy trình quan trọng như quản lý đơn hàng và thanh toán trực tuyến. Dữ liệu về sản phẩm, kho hàng, giỏ hàng và đơn hàng phải luôn được đồng bộ và chính xác. Ví dụ, khi một khách hàng đặt hàng, số lượng sản phẩm trong kho phải được cập nhật ngay lập tức để tránh tình trạng bán quá số lượng tồn kho. Một thách thức khác là thiết kế một cơ sở dữ liệu linh hoạt và có khả năng mở rộng, có thể xử lý hiệu quả các mối quan hệ phức tạp giữa các thực thể như người dùng, sản phẩm, đơn hàng và bình luận. Việc lựa chọn giữa kiến trúc nguyên khối (monolithic) và kiến trúc microservices cũng là một quyết định quan trọng ảnh hưởng đến khả năng mở rộng và bảo trì của toàn bộ hệ thống.

2.1. Vấn đề xác thực và phân quyền đa vai trò trong hệ thống

Trong SPRING_STORE, việc quản lý ba vai trò riêng biệt (User, Staff, Admin) đòi hỏi một cơ chế xác thực và phân quyền chặt chẽ. Hệ thống cần một luồng đăng nhập riêng cho User và Staff, như được mô tả trong tài liệu qua các lớp LoginController và các DAO tương ứng (UserDAO, StaffDAO). Thách thức ở đây là làm sao để thiết kế một giải pháp vừa an toàn vừa linh hoạt. Mỗi yêu cầu gửi đến hệ thống phải được kiểm tra để xác thực danh tính người dùng và xác minh quyền truy cập của họ đối với tài nguyên được yêu cầu. Ví dụ, chỉ người dùng có vai trò 'Staff' mới có thể truy cập chức năng 'Add Product By Staff'. Một giải pháp phổ biến là sử dụng các framework bảo mật như Spring Security, giúp định nghĩa các quy tắc truy cập dựa trên vai trò một cách khai báo, giảm thiểu việc viết mã logic phân quyền lặp đi lặp lại trong các controller. Tài liệu thiết kế hiện tại mô tả việc kiểm tra vai trò ngay trong doPost() của LoginController, đây là một cách tiếp cận cơ bản nhưng có thể trở nên phức tạp khi hệ thống mở rộng.

2.2. Đảm bảo tính toàn vẹn dữ liệu trong quản lý đơn hàng

Tính toàn vẹn dữ liệu là yếu tố sống còn đối với một website bán hàng. Quy trình từ lúc người dùng thêm sản phẩm vào giỏ hàng cho đến khi hoàn tất một đơn hàng và thực hiện thanh toán trực tuyến bao gồm nhiều bước và liên quan đến nhiều bảng dữ liệu (Cart, Order, OrderDetail, Product). Thách thức lớn là đảm bảo tất cả các thao tác này diễn ra như một giao dịch nguyên tử (atomic transaction). Nếu bất kỳ bước nào trong quy trình thất bại (ví dụ: lỗi khi cập nhật số lượng sản phẩm), toàn bộ giao dịch phải được hủy bỏ để tránh tình trạng dữ liệu không nhất quán. Các công nghệ như Spring Data JPA và Hibernate cung cấp các cơ chế quản lý giao dịch mạnh mẽ để giải quyết vấn đề này. Bằng cách sử dụng chú thích @Transactional, nhà phát triển có thể đảm bảo rằng một chuỗi các thao tác với cơ sở dữ liệu sẽ được thực thi thành công hoàn toàn hoặc không thực thi gì cả, qua đó bảo vệ tính toàn vẹn của dữ liệu trong quá trình quản lý đơn hàng.

III. Phương Pháp Thiết Kế Kiến Trúc Phần Mềm Với Mô Hình MVC

Để giải quyết các thách thức trong việc xây dựng SPRING_STORE, dự án đã áp dụng một kiến trúc phần mềm kinh điển và hiệu quả: mô hình MVC (Model-View-Controller). Kiến trúc này giúp phân tách rõ ràng các thành phần của ứng dụng thành ba phần có trách nhiệm riêng biệt, tạo điều kiện cho việc phát triển và bảo trì dễ dàng hơn. Trong dự án này, mô hình MVC được hiện thực hóa một cách rõ nét thông qua cấu trúc các package. View (Giao diện người dùng) được định nghĩa trong package View, chứa các file JSP, CSS, và JavaScript, chịu trách nhiệm hiển thị dữ liệu cho người dùng. Model (Mô hình dữ liệu) nằm trong package Models, bao gồm các lớp thực thể như Product, User, Order, đại diện cho cấu trúc dữ liệu của ứng dụng. Cuối cùng, Controller (Bộ điều khiển) được đặt trong package Controller, chứa các Servlet xử lý yêu cầu từ người dùng, tương tác với Model thông qua các lớp DAO, và quyết định View nào sẽ được hiển thị. Việc sử dụng Spring MVC, một phần của Spring Framework, đã cung cấp một bộ khung vững chắc để triển khai mô hình này, giúp quản lý các yêu cầu HTTP, ràng buộc dữ liệu và điều hướng một cách hiệu quả.

3.1. Phân tích cấu trúc các package theo mô hình MVC

Tài liệu thiết kế của SPRING_STORE mô tả một cấu trúc package rất mạch lạc, tuân thủ chặt chẽ nguyên tắc của mô hình MVC. Package View chứa toàn bộ mã nguồn front-end, giúp tách biệt hoàn toàn logic hiển thị khỏi logic nghiệp vụ. Package Models định nghĩa các đối tượng miền (domain objects) như Product, Cart, User, đóng vai trò là xương sống dữ liệu của hệ thống. Package DAOs (Data Access Objects) chứa các lớp như ProductDAO, UserDAO, có nhiệm vụ trừu tượng hóa việc truy cập cơ sở dữ liệu. Thay vì để Controller tương tác trực tiếp với CSDL, nó sẽ gọi các phương thức trong DAO. Cuối cùng, package Controller chứa các Servlet (ví dụ: ProductController, LoginController) làm nhiệm vụ tiếp nhận yêu cầu từ người dùng, gọi các dịch vụ hoặc DAO tương ứng để xử lý, sau đó chuyển dữ liệu đến View để hiển thị. Cấu trúc này không chỉ giúp mã nguồn dễ đọc, dễ hiểu mà còn tăng cường khả năng tái sử dụng và kiểm thử các thành phần một cách độc lập.

3.2. Vai trò của Spring Framework trong việc triển khai kiến trúc

Việc lựa chọn Spring Framework, cụ thể là Spring MVC và Spring Boot, đóng vai trò then chốt trong việc triển khai thành công kiến trúc MVC cho SPRING_STORE. Spring MVC cung cấp một DispatcherServlet hoạt động như một Front Controller, nhận tất cả các yêu cầu và điều phối chúng đến các Controller tương ứng. Điều này giúp tập trung hóa việc xử lý yêu cầu và áp dụng các logic chung như bảo mật, logging. Hơn nữa, Spring cung cấp cơ chế Dependency Injection (DI), cho phép các thành phần (như Controller và DAO) được kết nối với nhau một cách lỏng lẻo, làm tăng tính module hóa và dễ kiểm thử. Mặc dù tài liệu mô tả việc sử dụng các Servlet cơ bản, việc tích hợp Spring MVC sẽ nâng cấp kiến trúc này, thay thế các Servlet bằng các Controller được quản lý bởi Spring. Tương tự, Spring Data JPA và Hibernate đơn giản hóa lớp DAO, giúp các nhà phát triển tương tác với cơ sở dữ liệu một cách hiệu quả hơn thông qua các repository, giảm thiểu đáng kể mã boilerplate.

IV. Bí Quyết Phân Tích Thiết Kế Hệ Thống Qua Sơ Đồ UML ERD

Để trực quan hóa và làm rõ thiết kế của SPRING_STORE, việc sử dụng Ngôn ngữ Mô hình hóa Thống nhất (UML) là một phương pháp không thể thiếu. UML cung cấp một bộ công cụ mạnh mẽ để mô tả các khía cạnh khác nhau của hệ thống, từ yêu cầu người dùng đến cấu trúc tĩnh và hành vi động. Mặc dù tài liệu không cung cấp đầy đủ các sơ đồ, chúng ta có thể suy luận và phân tích dựa trên các mô tả chi tiết. Sơ đồ use case sẽ là công cụ đầu tiên để xác định các tác nhân (Actor) và các chức năng chính mà họ có thể thực hiện. Sơ đồ lớp (class diagram) sẽ mô hình hóa cấu trúc tĩnh của hệ thống, thể hiện các lớp trong package Models và mối quan hệ giữa chúng. Để mô tả luồng tương tác, sơ đồ tuần tự (sequence diagram) là công cụ lý tưởng, và tài liệu đã cung cấp một ví dụ cho chức năng đăng nhập. Bên cạnh đó, sơ đồ hoạt động (activity diagram) có thể được sử dụng để mô hình hóa các quy trình nghiệp vụ phức tạp như quy trình đặt hàng. Song song với UML, việc thiết kế cơ sở dữ liệu được thể hiện qua sơ đồ ERD (Entity-Relationship Diagram), giúp xác định các thực thể, thuộc tính và mối quan hệ giữa chúng, làm cơ sở cho việc tạo ra các bảng trong cơ sở dữ liệu.

4.1. Xây dựng cấu trúc hệ thống với sơ đồ lớp class diagram

Dựa trên mô tả trong package Models và Table Description, một sơ đồ lớp (class diagram) cho SPRING_STORE có thể được xây dựng. Các lớp chính bao gồm User, Staff, Admin, Product, Order, OrderDetail, Cart, và Comment. Sơ đồ này sẽ thể hiện rõ các mối quan hệ giữa chúng. Ví dụ, một User có thể có nhiều Order (quan hệ một-nhiều). Một Order có thể chứa nhiều Product thông qua bảng trung gian OrderDetail (quan hệ nhiều-nhiều). Tương tự, một Product có thể có nhiều Comment, và mỗi Comment thuộc về một User. Sơ đồ lớp cũng chỉ rõ các thuộc tính và phương thức quan trọng của từng lớp. Chẳng hạn, lớp Product sẽ có các thuộc tính như productID, productName, productPrice và các phương thức như getProductByID(). Việc xây dựng sơ đồ này giúp xác nhận cấu trúc dữ liệu và đảm bảo tính nhất quán trước khi triển khai cơ sở dữ liệu và các lớp DAO.

4.2. Mô hình hóa luồng tương tác bằng sơ đồ tuần tự

Tài liệu cung cấp một ví dụ rõ ràng về việc sử dụng sơ đồ tuần tự (sequence diagram) để mô tả luồng đăng nhập của người dùng. Sơ đồ này cho thấy sự tương tác theo thời gian giữa các đối tượng: người dùng (Actor), LoginController, UserDAO, và DBContext. Luồng bắt đầu khi người dùng gửi yêu cầu doPost() đến LoginController. Controller sau đó gọi phương thức login() trong UserDAO, truyền vào email và mật khẩu. UserDAO tiếp tục gọi getConnection() từ DBContext để kết nối cơ sở dữ liệu, sau đó thực thi một câu truy vấn SQL để xác minh thông tin. Cuối cùng, kết quả (một đối tượng Account hoặc null) được trả về ngược lại theo chuỗi gọi. Sơ đồ tuần tự là một công cụ cực kỳ hữu ích để gỡ lỗi và hiểu rõ cách các thành phần khác nhau phối hợp để hoàn thành một chức năng cụ thể. Nó làm rõ trách nhiệm của từng đối tượng và trình tự chính xác của các thông điệp được trao đổi giữa chúng.

4.3. Thiết kế cơ sở dữ liệu hiệu quả với sơ đồ ERD

Phần mô tả bảng trong tài liệu là cơ sở để xây dựng một sơ đồ ERD (Entity-Relationship Diagram). Sơ đồ này trực quan hóa các thực thể chính (Admin, User, Product, Order, Payment, v.v.) và các mối quan hệ giữa chúng thông qua các khóa chính và khóa ngoại. Ví dụ, bảng OrderDetail là một bảng liên kết thể hiện mối quan hệ nhiều-nhiều giữa Order và Product, với khóa chính kết hợp từ orderID và productID. Bảng Comment có khóa ngoại productID và userID, thể hiện rằng mỗi bình luận đều liên quan đến một sản phẩm và một người dùng cụ thể. Việc thiết kế cơ sở dữ liệu cẩn thận qua sơ đồ ERD giúp đảm bảo tính nhất quán, tránh dư thừa dữ liệu và tối ưu hóa hiệu suất truy vấn. Nó là bản thiết kế chi tiết cho việc tạo lập cơ sở dữ liệu vật lý và là tài liệu tham chiếu quan trọng cho việc phát triển lớp truy cập dữ liệu (DAO).

V. Cách Vận Hành Các Quy Trình Nghiệp Vụ Cốt Lõi Thực Tế

Việc phân tích các quy trình nghiệp vụ thực tế giúp hiểu rõ cách thiết kế lý thuyết được áp dụng vào các chức năng cụ thể của website bán hàng SPRING_STORE. Hai trong số các quy trình quan trọng nhất là quản lý sản phẩm bởi nhân viên và quy trình xử lý đơn hàng của người dùng. Đối với việc quản lý sản phẩm, tài liệu mô tả chi tiết các chức năng 'Add Product By Staff' và 'Update Product By Staff'. Quy trình này bắt đầu từ giao diện người dùng (View), nơi nhân viên nhập thông tin sản phẩm. Yêu cầu sau đó được gửi đến ProductController, một Servlet chịu trách nhiệm điều phối. Controller này sẽ gọi các phương thức tương ứng trong ProductDAO, như addProduct() hoặc updateProduct(), để thực hiện các thao tác ghi dữ liệu vào cơ sở dữ liệu. Toàn bộ quy trình này minh họa rõ ràng sự tương tác giữa các lớp trong mô hình MVC, từ việc nhận dữ liệu đầu vào, xử lý logic nghiệp vụ, đến việc cập nhật dữ liệu. Phân tích các quy trình này cũng cho thấy tầm quan trọng của việc thiết kế các RESTful API rõ ràng nếu hệ thống muốn phát triển theo hướng tách biệt front-end và back-end trong tương lai.

5.1. Phân tích quy trình thêm và cập nhật sản phẩm bởi Staff

Quy trình quản lý sản phẩm là một chức năng cốt lõi dành cho vai trò Staff. Khi một nhân viên thêm sản phẩm mới, họ điền thông tin vào một biểu mẫu trên trang JSP. Khi gửi đi, một yêu cầu doPost được gửi đến ProductController. Theo tài liệu, controller này sẽ lấy các tham số từ yêu cầu (tên, giá, mô tả,...) và gọi phương thức addProduct() trong lớp ProductDAO. ProductDAO sau đó sẽ xây dựng câu lệnh SQL INSERT và thực thi nó trên cơ sở dữ liệu. Tương tự, quy trình cập nhật sản phẩm bao gồm hai bước: đầu tiên là một yêu cầu doGet để lấy thông tin sản phẩm hiện tại bằng getProductByID() và hiển thị lên biểu mẫu; sau đó là một yêu cầu doPost để gọi updateProduct() trong ProductDAO với các thông tin đã được chỉnh sửa. Các phương thức này cho thấy sự tương tác trực tiếp với cơ sở dữ liệu để duy trì dữ liệu sản phẩm. Đây là một ví dụ điển hình về hoạt động CRUD (Create, Read, Update, Delete) trong một ứng dụng web.

5.2. Luồng xử lý một đơn hàng từ giỏ hàng đến khi hoàn tất

Quy trình quản lý đơn hàng là một luồng phức tạp, bắt đầu từ khi người dùng thêm sản phẩm vào giỏ hàng. Bảng Cart trong cơ sở dữ liệu lưu trữ các sản phẩm mà người dùng đã chọn. Khi người dùng tiến hành đặt hàng, một yêu cầu được gửi đến AddAnOrderController. Controller này sẽ gọi phương thức addNewOrder() trong OrderDAO. Phương thức này thực hiện nhiều tác vụ quan trọng: tạo một bản ghi mới trong bảng Order, sao chép các sản phẩm từ Cart của người dùng sang bảng OrderDetail, tính tổng giá trị đơn hàng, và cuối cùng là xóa các sản phẩm khỏi Cart. Tài liệu chỉ rõ câu truy vấn INSERT INTO ORDER VALUES (UserID,TotalPrice,purchaseDate); là một phần của quy trình này. Để đảm bảo tính toàn vẹn, toàn bộ các bước này nên được bọc trong một giao dịch cơ sở dữ liệu duy nhất. Quy trình này cho thấy sự phối hợp chặt chẽ giữa các bảng dữ liệu để hoàn thành một nghiệp vụ quan trọng của hệ thống e-commerce.

VI. Kết Luận và Hướng Phát Triển Tương Lai Cho SPRING_STORE

Qua quá trình phân tích thiết kế phần mềm SPRING_STORE, có thể thấy dự án đã xây dựng một nền tảng vững chắc cho một hệ thống e-commerce dựa trên mô hình MVC và công nghệ Java. Thiết kế phân tách rõ ràng các thành phần View, Controller, và Model, cùng với việc sử dụng lớp DAO để trừu tượng hóa truy cập dữ liệu, là một thực hành tốt giúp hệ thống dễ dàng bảo trì và phát triển. Tuy nhiên, để đáp ứng các yêu cầu ngày càng phức tạp của thương mại điện tử hiện đại, có nhiều hướng phát triển tiềm năng. Một trong những hướng đi quan trọng là chuyển đổi từ kiến trúc nguyên khối hiện tại sang kiến trúc microservices. Điều này sẽ giúp chia nhỏ ứng dụng thành các dịch vụ độc lập (ví dụ: dịch vụ quản lý người dùng, dịch vụ sản phẩm, dịch vụ đơn hàng), cho phép phát triển, triển khai và mở rộng quy mô từng phần một cách linh hoạt. Bên cạnh đó, việc áp dụng các design patterns tiên tiến hơn và chuẩn hóa việc xây dựng các RESTful API sẽ giúp hệ thống dễ dàng tích hợp với các ứng dụng di động hoặc các đối tác bên thứ ba. Quy trình phát triển cũng có thể được cải tiến bằng cách áp dụng các phương pháp linh hoạt như Agile và Scrum.

6.1. Đánh giá ưu và nhược điểm của thiết kế hiện tại

Thiết kế hiện tại của SPRING_STORE có nhiều ưu điểm đáng kể. Việc tuân thủ mô hình MVC giúp cấu trúc mã nguồn rõ ràng và có tổ chức. Sự phân tách trách nhiệm giữa Controller, DAO, và Model làm cho mã nguồn dễ hiểu và dễ bảo trì. Việc thiết kế cơ sở dữ liệu với các bảng được chuẩn hóa tốt cũng là một điểm cộng, giúp đảm bảo tính nhất quán dữ liệu. Tuy nhiên, thiết kế này cũng có một số nhược điểm. Kiến trúc hiện tại là một khối monolithic, điều này có thể gây khó khăn khi hệ thống phát triển lớn hơn, việc triển khai một thay đổi nhỏ cũng đòi hỏi phải triển khai lại toàn bộ ứng dụng. Sự phụ thuộc chặt chẽ giữa logic nghiệp vụ và các Servlet trong Controller cũng có thể làm giảm khả năng tái sử dụng và kiểm thử. Lớp DAO thực hiện các truy vấn SQL trực tiếp có thể dẫn đến việc lặp lại mã và khó quản lý hơn so với việc sử dụng một ORM framework như Hibernate với Spring Data JPA.

6.2. Đề xuất cải tiến và áp dụng kiến trúc microservices

Để nâng cao khả năng mở rộng và linh hoạt, một đề xuất quan trọng là tái cấu trúc SPRING_STORE theo kiến trúc microservices. Hệ thống có thể được chia thành các dịch vụ nhỏ, độc lập như: UserService (quản lý đăng ký, đăng nhập, hồ sơ), ProductService (quản lý sản phẩm, danh mục), và OrderService (quản lý giỏ hàng, đơn hàng, thanh toán). Mỗi microservice sẽ có cơ sở dữ liệu riêng và giao tiếp với nhau thông qua các RESTful API. Kiến trúc này cho phép mỗi dịch vụ được phát triển và triển khai độc lập bởi các nhóm khác nhau, sử dụng các công nghệ phù hợp nhất. Spring Boot và Spring Cloud là bộ công cụ lý tưởng để xây dựng hệ sinh thái microservices, cung cấp các giải pháp cho việc khám phá dịch vụ (service discovery), cân bằng tải (load balancing), và quản lý cấu hình tập trung. Việc chuyển đổi này sẽ giúp SPRING_STORE trở nên mạnh mẽ, linh hoạt và sẵn sàng đáp ứng các thách thức trong tương lai.

Nội dung chính

Bối cảnh và vấn đề nghiên cứu

Tài liệu "SPRING_STORE Software Design Specification" là đồ án kỹ thuật thuộc ngành Kỹ thuật phần mềm (Công nghệ thông tin), được thực hiện bởi nhóm tác giả Trần Trọng Nguyễn (mã số sinh viên CE170134), Hồng Bảo Bảo (mã số sinh viên CE170912), và Đoàn Quốc Kiệt (mã số sinh viên CE171400) dưới sự hướng dẫn của Mentor Quách Luyl Đa, hoàn thành tại Cần Thơ vào tháng 01 năm 2022.

Bối cảnh thực tiễn của đề tài xuất phát từ yêu cầu xây dựng một hệ sinh thái ứng dụng web thương mại điện tử hoàn chỉnh mang tên SPRING_STORE. Hệ thống hướng tới việc cung cấp nền tảng số hỗ trợ bán hàng, quản lý đơn hàng, kho vận, tài khoản người dùng và tương tác đánh giá sản phẩm. Để đảm bảo quá trình hiện thực hóa phần mềm diễn ra chính xác, văn bản này đóng vai trò là bản đặc tả thiết kế kỹ thuật (Software Design Specification - SDS), ghi nhận cấu trúc kiến trúc, mô hình dữ liệu và đặc tả chi tiết các lớp xử lý.

Mục tiêu và nhiệm vụ nghiên cứu được phân rã theo các nội dung kỹ thuật cụ thể:

1. Thiết kế và phân vùng cấu trúc các gói mã nguồn (Code Packages) theo mô hình kiến trúc phân tầng.
2. Xây dựng lược đồ cơ sở dữ liệu quan hệ (Database Tables) gồm 12 bảng thực thể, xác định tường minh các khóa chính (Primary Keys) và khóa ngoại (Foreign Keys).
3. Đặc tả chi tiết các lớp (Class Specifications), bao gồm các lớp điều hướng (Controllers), lớp giao tiếp dữ liệu (DAOs), các thực thể mô hình (Models) và kết nối hệ thống (DBContext).
4. Thiết lập quy chuẩn phương thức xử lý (Methods), xác định rõ ràng dữ liệu đầu vào (Input), dữ liệu trả về (Output), thuật toán xử lý và câu lệnh truy vấn cơ sở dữ liệu (Database Queries) tương ứng cho từng chức năng.

Đối tượng và phạm vi nghiên cứu:

• Đối tượng nghiên cứu: Quy trình thiết kế kiến trúc và đặc tả chi tiết hệ thống phần mềm web bán hàng SPRING_STORE.
• Phạm vi không gian: Nghiên cứu kỹ thuật phần mềm thực hiện tại Cần Thơ, triển khai trên môi trường máy chủ web hỗ trợ nền tảng Java EE / Servlet.
• Phạm vi người dùng: Phân quyền cho ba nhóm người dùng độc lập gồm Khách hàng (User), Nhân viên (Staff), và Quản trị viên (Admin).
• Phạm vi nghiệp vụ: Bao quát chu trình mua sắm từ đăng nhập, duyệt sản phẩm theo danh mục, tìm kiếm, quản lý giỏ hàng, đặt hàng, quản lý kích thước sản phẩm, bình luận, đến các tác vụ quản trị gồm nhập kho hàng, thống kê doanh thu và quản lý nhân sự.
• Phạm vi thời gian: Dữ liệu thiết kế hoàn thiện và ghi nhận tại mốc thời gian tháng 01/2022.

Cơ sở lý thuyết và công nghệ áp dụng

Hệ thống SPRING_STORE được thiết kế dựa trên mô hình kiến trúc phần mềm phân tầng kết hợp kiến trúc MVC (Model - View - Controller) và mẫu thiết kế DAO (Data Access Object) nhằm tách biệt giữa giao diện hiển thị, logic điều hướng và tầng xử lý dữ liệu.

Các công nghệ, thư viện và nền tảng lập trình được xác định trong văn bản gồm:

• Java Servlet Framework: Đóng vai trò hạt nhân điều khiển (Controller), sử dụng lớp HttpServlet kế thừa từ GenericServlet và hiện thực giao diện Serializable. Nền tảng này cung cấp các phương thức giao thức HTTP tiêu chuẩn như doGet(), doPost(), doHead(), và doTrace().
• Giao diện người dùng (View): Mã nguồn giao diện bao gồm các trang JSP (JavaServer Pages), kết hợp mã tạo kiểu CSS, thư viện giao diện Bootstrap, thư viện jQuery, kịch bản JavaScript, phông chữ (font), biểu tượng (icon) và hình ảnh (images).
• Tầng truy cập dữ liệu (DAO): Mô hình DAO chịu trách nhiệm tương tác trực tiếp với cơ sở dữ liệu quan hệ để xử lý dữ liệu, nạp dữ liệu vào đối tượng Model và phản hồi cho Controller.
• Tiện ích hỗ trợ (Helper): Lớp hỗ trợ trong gói tiện ích xử lý các giao thức gửi thư điện tử (email) và phát sinh mật khẩu ngẫu nhiên (random new password).
• Tầng kết nối cơ sở dữ liệu (DBContext): Khởi tạo đối tượng kết nối Conn thông qua phương thức getConnection() với 6 tham số cấu hình: dbPrefix, dbPort, dbName, instance, user, và password.

Cấu trúc phân rã các gói mã nguồn (Code Packages) của hệ thống được tổng hợp trong bảng sau:

Số thứ tự	Tên gói (Package)	Mô tả trách nhiệm kỹ thuật
01	View	Chứa toàn bộ mã nguồn giao diện (front-end) bao gồm trang JSP, CSS, JavaScript, hình ảnh, biểu tượng, phông chữ, thư viện Bootstrap và jQuery.
02	Models	Chứa các lớp thực thể (entities) đại diện cho dữ liệu như Product, Cart, Order, User, Staff... phục vụ truy cập và trao đổi dữ liệu giữa các lớp DAO và Controller.
03	DAOs	Bao gồm các lớp ProductDAO, CartDAO, OrderDAO, UserDAO... thực hiện các hàm nghiệp vụ tương tác trực tiếp với cơ sở dữ liệu để Controller nạp dữ liệu cho người dùng.
04	Controller	Chứa các Servlet có trách nhiệm tiếp nhận, xử lý và điều phối luồng dữ liệu thu thập từ người dùng trên giao diện web (View) tới DAO và Model, sau đó chuyển giao tới trang JSP.
05	DBContext	Gói chuyên trách thiết lập và quản lý các kết nối tới cơ sở dữ liệu.
06	Ultis	Chứa lớp Helper cung cấp các hàm chức năng gửi email, tạo mật khẩu ngẫu nhiên và tương tác với người dùng qua email.

Thiết kế và triển khai

Hệ thống cơ sở dữ liệu của SPRING_STORE được thiết kế theo mô hình quan hệ chuẩn hóa với 12 bảng thực thể. Cấu trúc chi tiết các bảng, khóa chính và khóa ngoại được tác giả đặc tả như sau:

STT	Tên bảng (Table)	Mô tả chức năng lưu trữ	Khóa chính (Primary Key)	Khóa ngoại (Foreign Key)
01	Admin	Lưu trữ thông tin tài khoản quản trị viên trong hệ thống.	adminID	Không có (None)
02	User	Lưu trữ thông tin người dùng / khách hàng đã đăng ký.	userID	Không có (None)
03	Staff	Lưu trữ thông tin nhân viên vận hành.	staffID	Không có (None)
04	Product	Lưu trữ thông tin danh mục sản phẩm hiện có trong hệ thống.	productID	Không có (None)
05	Comment	Lưu trữ các bình luận, phản hồi của người dùng về sản phẩm.	commentID	productID (tham chiếu Product), userID (tham chiếu User)
06	Cart	Lưu trữ thông tin giỏ hàng của từng người dùng.	cartID	userID (tham chiếu User), productID (tham chiếu Product)
07	Order	Lưu trữ thông tin các đơn đặt hàng của người dùng.	orderID	userID (tham chiếu User)
08	OrderDetail	Lưu trữ thông tin chi tiết các sản phẩm trong từng đơn hàng.	orderID, productID	orderID, productID
09	Size	Lưu trữ thông tin kích thước (size) cho từng sản phẩm.	productSize, productID	productID
10	Import	Lưu trữ thông tin các đợt nhập hàng hóa.	importID	staffID
11	ImportDetail	Lưu trữ thông tin chi tiết các sản phẩm trong mỗi đợt nhập.	importID, productID	importID, productID
12	Payment	Lưu trữ thông tin thanh toán cho các đơn hàng.	paymentID	orderID

Về mặt luồng điều khiển, hệ thống triển khai theo mô hình phản hồi - yêu cầu (Request-Response) của kiến trúc web. Khi người dùng thao tác trên giao diện JSP, yêu cầu được gửi tới các Servlet trong gói Controller. Servlet phân tích tham số HTTP, gọi các phương thức tương ứng tại gói DAOs. Lớp DAO kết nối cơ sở dữ liệu qua DBContext, thực thi các truy vấn SQL chuẩn bị sẵn (Prepared Queries), chuyển đổi tập kết quả thành các đối tượng thực thể thuộc gói Models, sau đó trả về Controller để lưu vào phiên làm việc (Session) hoặc chuyển tiếp (Forward) kết quả sang trang JSP đích.

Nội dung chính theo từng chương

Văn bản tài liệu phân rã chi tiết thiết kế kỹ thuật cho từng mô-đun chức năng cụ thể:

I. Login for user (Xác thực người dùng)

Mô-đun này thiết kế quy trình xác thực quyền truy cập dành cho đối tượng khách hàng:

• Lớp LoginController: Hiện thực phương thức doPost(). Sau khi người dùng nhấn nút đăng nhập và gửi thông tin, hàm tiếp nhận yêu cầu, kiểm tra vai trò người dùng có phải là "user" hay không. Nếu đúng, hàm gọi tiếp phương thức login() trong lớp UserDAO.
• Lớp UserDAO: Cung cấp phương thức login() nhận ba tham số đầu vào gồm email (kiểu String), password (kiểu String) và chuỗi truy vấn query (kiểu String). Hàm kết nối CSDL qua DBContext, kiểm tra tài khoản và trả về đối tượng acc (kiểu Account) hoặc giá trị null. Phương thức getUser() có nhiệm vụ lưu trữ thông tin phiên làm việc (session) sau khi đăng nhập thành công.
• Lớp thực thể User: Khởi tạo đối tượng User thông qua constructor bằng cách truyền tuần tự các đối số nạp từ bảng kết quả.
• Lớp DBContext: Thực thi hàm getConnection() để khởi tạo kết nối Conn.
• Truy vấn cơ sở dữ liệu: Select * from [User] where userEmail = ? and userPassword=?.

2. Login for staff (Xác thực nhân viên)

Mô-đun này đặc tả cơ chế xác thực riêng biệt dành cho nhân viên vận hành:

• Lớp LoginController: Phương thức doPost() kiểm tra vai trò "staff", sau đó kích hoạt phương thức login() trong lớp StaffDAO.
• Lớp StaffDAO: Thực thi hàm login() với các tham số đầu vào email, password, query tương tự như của người dùng để trả về đối tượng tài khoản hoặc null. Hàm getStaff() thực hiện lưu thông tin phiên làm việc của nhân viên.
• Lớp thực thể Staff: Constructor Staff() tiếp nhận các tham số từ tập kết quả để khởi tạo đối tượng nhân viên.
• Truy vấn cơ sở dữ liệu: Select * from [Staff] where staffEmail = ? and staffPassword=?.

3. Add Product By Staff (Thêm sản phẩm mới bởi nhân viên)

Mô-đun cho phép nhân viên tạo mới sản phẩm trên hệ thống:

• Lớp Product Controller: Phương thức doPost() lấy các tham số từ biểu mẫu nhập liệu thêm sản phẩm, sau đó chuyển giao vào phương thức addProduct() của lớp ProductDAO.
• Lớp Product DAO: Hiện thực hàm addProduct(in product:Product):void. Tham số đầu vào gồm: name (String), Price (String), description (String), Quantity (String), img (String), category (String). Dữ liệu đầu ra trả về giá trị kiểu true/false.
• Tài liệu ghi nhận nền tảng kỹ thuật sử dụng lớp HTTPServlet kế thừa GenericServlet và triển khai Serializable.

4. Update Product By Staff (Cập nhật thông tin sản phẩm bởi nhân viên)

Mô-đun phục vụ việc chỉnh sửa dữ liệu hàng hóa:

• Lớp Product Controller: Cung cấp phương thức doGet() để gọi getProductByID() từ ProductDAO và hiển thị thông tin lên giao diện web. Phương thức doPost() thu thập các tham số chỉnh sửa từ biểu mẫu và truyền vào updateProduct().
• Lớp Product DAO: Phương thức getProductByID() nhận định danh sản phẩm kiểu số nguyên (productId: int). Phương thức updateProduct() tiếp nhận danh sách tham số: productId (int), productName (String), productPrice (double), productQuantity (int), productImg (String), productCategory (String), productDis (String).
• Lớp thực thể Product: Constructor Product() thiết lập giá trị cho các thuộc tính sau khi dữ liệu đã được kiểm tra định dạng.
• Truy vấn cơ sở dữ liệu được ghi nhận trong văn bản: SELECT P.productQuantity FROM [Product] P LEFT JOIN [Size] S OSN P..

5. Add An Order (Tạo đơn đặt hàng)

Mô-đun xử lý giao dịch đặt hàng của khách hàng:

• Lớp AddAnOrderController: Phương thức doPost() kích hoạt hàm addNewOrder() trong lớp orderDAO và cập nhật dữ liệu phản hồi lên web.
• Lớp orderDAO: Chứa ba phương thức chính gồm: addNewOrder() (thực hiện thêm đơn hàng vào CSDL), getUser(email) (kết nối qua DBContext, kiểm tra email đã tồn tại hay chưa, nếu có sẽ chuyển hướng về giao diện đăng ký kèm thông báo), và addNew(user) (tạo mới tài khoản người dùng vào hệ thống).
• Lớp thực thể Order: Khởi tạo đối tượng đơn hàng với các tham số đầu vào gồm orderId (int), userID (int), PurchaseDate (String), productName (String), và totalPrice (float).
• Truy vấn cơ sở dữ liệu: INSERT INTO ORDER VALUES (UserID,TotalPrice,purchaseDate);.

6. List Product category by Users (Liệt kê sản phẩm theo danh mục cho người dùng)

Mô-đun hỗ trợ người dùng phân loại và xem sản phẩm theo nhóm:

• Lớp Produc Controller: Phương thức doGet() tiếp nhận tham số từ giao diện và gọi hàm getproduct() trong ProductDAO.
• Lớp Product DAO: Phương thức Getproduct() nhận các tham số đầu vào name (String), Price (String), description (String), Quantity (String), img (String), category (String); kết quả trả về kiểu boolean (true/false).
• Truy vấn cơ sở dữ liệu: select * from [Product] p where p.productName like ? and [productCategory] like ?.

7. Search Product (Tìm kiếm sản phẩm)

Mô-đun thực hiện tra cứu thông tin sản phẩm:

• Lớp Produc Controller: Phương thức doGet() nhận chuỗi tìm kiếm txtSearch do người dùng nhập từ trang JSP, gọi hàm xử lý trong ProductDAO và trả về danh sách sản phẩm khớp từ khóa hoặc thông báo không tìm thấy.
• Lớp Product DAO: Phương thức searchProduct(in keyword:String): List Product thực hiện tìm kiếm dựa trên từ khóa hoặc mã sản phẩm, trả về các thuộc tính như tên, giá, mô tả, hình ảnh.
• Truy vấn cơ sở dữ liệu ghi nhận trong văn bản: select * from Product where userId like '%?%'.

8. Delete list product in cart (Xóa sản phẩm trong giỏ hàng)

Mô-đun quản lý thao tác loại bỏ sản phẩm khỏi giỏ hàng:

• Lớp DeleteListProductInCartController: Chứa phương thức +DelateProductFormCart() thực hiện xóa sản phẩm dựa trên mã định danh sản phẩm.
• Lớp Dbconnection: Khởi tạo kết nối thông qua phương thức getconnection().

Các chức năng khác trong cấu trúc mục lục

Ngoài các phần được đặc tả chi tiết lớp, tài liệu liệt kê hệ thống các chức năng hoàn chỉnh trong mục lục (Table of Contents), bao gồm: Đăng ký tài khoản (Register for user), xem và cập nhật thông tin cá nhân (View user profile, Update user profile), đổi mật khẩu (Change user password), quản lý nhân viên cho quản trị viên (List staff management, Add new staff, Update information staff, Delete staff for admin), xem danh sách người dùng (View list user), hiển thị chi tiết sản phẩm (Show Detail Product), xóa sản phẩm bởi nhân viên (Delete product by staff), quản lý bình luận (List comment in product detail, Add comment in product detail), xem lịch sử đơn hàng (Show list order history), nạp và thêm sản phẩm vào giỏ hàng (Load list product in cart, Add product into cart from product details), và quản lý doanh thu theo tháng (Monthly Revenue Manager).

Kết quả và đóng góp

Về mặt kết quả kỹ thuật, văn bản cung cấp một bộ hồ sơ thiết kế hoàn chỉnh cho hệ thống SPRING_STORE với các số liệu và cấu trúc cụ thể:

• Xác lập 6 gói mã nguồn phân lớp rõ ràng (View, Models, DAOs, Controller, DBContext, Ultis).
• Định nghĩa chuẩn hóa 12 bảng cơ sở dữ liệu quan hệ với đầy đủ cấu trúc khóa chính, khóa ngoại, đáp ứng các chu trình nghiệp vụ phức tạp.
• Đặc tả chi tiết các phương thức xử lý cho 8 mô-đun chức năng lõi, làm rõ kiểu dữ liệu của các tham số đầu vào, giá trị trả về và các truy vấn SQL tương ứng.

Về mặt đóng góp so với các thiết kế thông thường, tài liệu đã:

• Phân lập rõ ràng giữa hai luồng xác thực User và Staff ở cả ba tầng Controller, DAO và Database, giúp nâng cao tính an toàn và minh bạch trong phân quyền.
• Tích hợp cấu trúc quản lý kích thước sản phẩm (Size) độc lập liên kết với mã sản phẩm, cho phép mở rộng các mặt hàng thời trang hoặc hàng hóa có nhiều quy cách.
• Thiết kế riêng phân hệ quản lý kho nhập hàng (Import và ImportDetail) tách biệt với hệ thống bán hàng (Order và OrderDetail), tạo tiền đề kiểm soát chuỗi cung ứng khép kín.

Hạn chế và hướng nghiên cứu tiếp

Dựa trên nội dung trực tiếp của văn bản, một số hạn chế kỹ thuật được ghi nhận:

• Tồn tại sai lệch cú pháp và logic trong một số câu lệnh truy vấn SQL: Điển hình là câu truy vấn tìm kiếm sản phẩm lại lọc theo trường người dùng (select * from Product where userId like '%?%'); câu lệnh cập nhật sản phẩm bị lỗi cú pháp chưa hoàn chỉnh (LEFT JOIN [Size] S OSN P.); câu lệnh thêm đơn hàng viết hoa tên bảng trùng từ khóa hệ thống (INSERT INTO ORDER VALUES...).
• Tính nhất quán trong quy chuẩn đặt tên chưa triệt để: Xuất hiện lỗi chính tả trong tên phương thức (DelateProductFormCart thay vì DeleteProductFromCart), tên lớp điều khiển viết thiếu ký tự (Produc Controller), và sự xuất hiện song song chưa đồng nhất giữa hai lớp kết nối DBContext và Dbconnection.
• Vi phạm nguyên tắc đơn nhiệm (Single Responsibility Principle) trong thiết kế lớp: Lớp orderDAO kiêm nhiệm cả logic kiểm tra sự tồn tại của email tài khoản (getUser) và tạo mới tài khoản người dùng (addNew), vốn là chức năng thuộc trách nhiệm của UserDAO.

Hướng mở rộng tiếp theo từ phạm vi nghiên cứu:

• Chuẩn hóa toàn bộ các câu truy vấn cơ sở dữ liệu và khắc phục các sai lệch logic truy vấn.
• Hiện thực hóa mã nguồn chi tiết và kiểm thử thực tế cho các mô-đun mới chỉ dừng lại ở danh mục mục lục (như mô-đun quản lý doanh thu tháng Monthly Revenue Manager, quản lý bình luận Comment, và quy trình nhập kho Import).

Giá trị tham khảo

Tài liệu là nguồn tham khảo trực tiếp cho:

• Sinh viên chuyên ngành Kỹ thuật phần mềm, Công nghệ thông tin hoặc Hệ thống thông tin đang thực hiện đồ án tốt nghiệp, bài tập lớn về phát triển ứng dụng web trên nền tảng Java EE (Java Servlet/JSP).
• Những người nghiên cứu cần cấu trúc mẫu về một tài liệu Đặc tả thiết kế phần mềm (Software Design Specification) theo quy chuẩn phân tầng MVC và DAO.

Nội dung đáng giá nhất để tham khảo bao gồm lược đồ cơ sở dữ liệu quan hệ 12 bảng được thiết kế liên kết chặt chẽ cho mô hình bán lẻ trực tuyến, cùng phương pháp phân rã cấu trúc tham số (Input, Output, Process) của các lớp DAO và Servlet.

Câu hỏi thường gặp

1. Cơ sở dữ liệu của SPRING_STORE gồm những bảng nào để phục vụ việc quản lý hàng hóa và kho vận?

Hệ thống sử dụng các bảng gồm Product (lưu thông tin chung về sản phẩm), Size (lưu kích thước sản phẩm theo productID), Import (lưu thông tin các đợt nhập hàng gắn với staffID), và ImportDetail (lưu chi tiết các sản phẩm trong đợt nhập với khóa chính kết hợp importID và productID).

2. Gói mã nguồn Ultis trong hệ thống đảm nhận chức năng gì?

Gói Ultis chứa lớp Helper với các phương thức thực hiện gửi thư điện tử, tạo mật khẩu ngẫu nhiên (random new password) và xử lý các tương tác với người dùng qua hệ thống email.

3. Quy trình xác thực của User và Staff được phân biệt như thế nào tại tầng DAO?

Mặc dù đều đi qua phương thức doPost() của LoginController, nhưng hệ thống kiểm tra vai trò để phân nhánh: nếu vai trò là "user", hàm sẽ gọi UserDAO.login() và truy vấn trên bảng [User]; nếu vai trò là "staff", hàm sẽ gọi StaffDAO.login() và truy vấn trên bảng [Staff].

4. Phương thức addProduct() trong lớp Product DAO nhận các tham số đầu vào nào?

Phương thức này nhận một đối tượng product:Product với 6 tham số gồm: name (String), Price (String), description (String), Quantity (String), img (String), và category (String), trả về kết quả kiểu boolean (true/false).

5. Lớp kết nối cơ sở dữ liệu DBContext yêu cầu những tham số cấu hình nào để tạo kết nối?

Phương thức getConnection() trong DBContext nhận 6 tham số truyền vào bao gồm dbPrefix, dbPort, dbName, instance, user, và password để khởi tạo đối tượng kết nối Conn.

Kết luận

Tài liệu "SPRING_STORE Software Design Specification" của nhóm sinh viên Trần Trọng Nguyễn, Hồng Bảo Bảo và Đoàn Quốc Kiệt đã thiết lập khung thiết kế kỹ thuật tương đối hoàn chỉnh cho một ứng dụng web thương mại điện tử nền tảng Java Servlet/JSP. Văn bản phân định rõ ràng 6 gói mã nguồn, 12 bảng cơ sở dữ liệu quan hệ và các phương thức xử lý dữ liệu trọng yếu. Mặc dù vẫn còn một số điểm hạn chế về tính chuẩn hóa cú pháp truy vấn và phân chia trách nhiệm lớp, tài liệu vẫn phản ánh đầy đủ cấu trúc thiết kế chi tiết cần có của một đồ án kỹ thuật phần mềm.

Trích đoạn nội dung tài liệu

SPRING_STORE Software Design Specification Mentor - Quách Luyl Đa Trần Trọng Nguyễn - CE170134 Hồng Bảo Bảo - CE170912 Đoàn Quốc Kiệt – CE171400 –CanTho, January 2022 – RECORD OF CHANGES Date A* In charge Change Description M, D *A - Added M - Modified D - Deleted Page | 2 Table of Contents I. Login for user. Login for staff. Add Product By Staff.

Update Product By Staff. Add An Order.List Product category by Users.Delete list product in cart.Login for admin. Register for user. View user profile.

Update user profile. Update Product By Staff. List staff management.List comment in product detail.Add comment in product detail.View list user.Delete staff for admin.Update information staff.Add new staff.Change user password.Show Detail Product. Delete product by staff.

Show list product. Monthly Revenue Manager a.Show list order history a.List product on management page by staff .Class Specifications Product Controller.Load list product in cart. Add product into cart from product details. Code Packages Package descriptions No Package Description 01 View This package include font-end source with: jsp page, css, javascript, images, icon, font, bootstrap and jquery library 02 Models This package contains entities(classes) Product, Cart, Order, User, Staff, etc that can be accessed and used by other classes DAO.

03 DAOs Includes class ProductDAO, CartDAO, OrderDAO, UserDAO, and etc with detailed functions that can interact directly with the database for data processing to which the Controller can load data for the user. 04 Controller Includes Servlets with a responsibility to process, transfer the data collected by user on web page(view) to DAO and Model in the database to JSP pages. 05 DBContext This package helps connect database. 06 Ultis This package contains Helper class with functions for sending email, random new password, and interacting with users by email.

Table Description No Table Description 01 Admin Stores information about administrators in the system. - Primary keys: adminID - Foreign keys: None 02 User Stores information about registered users. - Primary keys: userID - Foreign keys: None 03 Staff Stores information about staff members. - Primary keys: staffID - Foreign keys: None 04 Product Stores information about products available in the system.

- Primary keys: productID - Foreign keys: None Page | 9 05 Comment Stores user comments on products. - Primary keys: commentID - Foreign keys: productID (references Product), userID (references User) 06 Cart Stores information about user shopping carts. - Primary keys: cartID - Foreign keys: userID (references User), productID (references Product) 07 Order Stores information about user orders. - Primary keys: orderID - Foreign keys: userID (references User) 08 OrderDetail Stores detailed information about products in each order.

- Primary keys: orderID, productID - Foreign keys: orderID , productID 09 Size Stores information about product sizes. - Primary keys: productSize, productID - Foreign keys: productID 10 Import Stores information about product imports. - Primary keys: importID - Foreign keys: staffID 11 ImportDetail Stores detailed information about products in each import. -Primary keys: importID, productID -Foreign keys: importID , productID 12 Payment Stores information about payments for orders.

- Primary keys: paymentID Page | 10 - Foreign keys: orderID II. Login for user a. Class Specifications LoginController No Method Description 01 doPost() After the user presses the "login" button and submits the necessary information to log in, this function processes and forwards the request from the user. First, it checks if the person logging in has the "user" role, and if so, it calls the login() function in UserDAO to verify the username and password against the stored data.

UserDAO Page | 11 No Method Description 01 login() First, Establish a connection to the database. Second, it sends the email address and password to select an account in the database. If the account is returned, it displays successful login information or incorrect login information. + Input: email(String), password(String): verified data.

query(string): to select data from the database. + Output: acc(Account) or null. 02 getUser() After login into the system successfully, save user session information.