Hệ thống cho thuê sân bóng mini

Cách tiếp cận:

Phân tích yêu cầu
Thiết kế Use case diagram
Thiết kế kiến trúc tổng quan hệ thống và công nghệ sử dụng
Thiết kế ERD và Database
Thiết kế API
Thiết kế UI/UX

Hoặc tham khảo hướng Data-driven development:

Giai đoạn	Mục tiêu	Kết quả
1. Phân tích dữ liệu nghiệp vụ	Xác định các thực thể, mối quan hệ, nghiệp vụ phát sinh dữ liệu	Danh sách thực thể: Khách hàng, Hóa đơn, Mặt hàng, Đặt sân, ...
2. Thiết kế ERD (Entity Relationship Diagram)	Cấu trúc hóa dữ liệu: bảng, khóa chính, khóa ngoại, ràng buộc	Sơ đồ ERD chính thức
3. Thiết kế Physical Database Schema	Chuyển ERD thành lược đồ SQL cụ thể (PostgreSQL/MySQL...)	Câu lệnh `CREATE TABLE`, ràng buộc FK, chỉ mục
4. Phân tích usecase → truy vấn dữ liệu	Đặt câu hỏi: thống kê cần gì? hóa đơn cần dữ liệu nào?	Danh sách các truy vấn mẫu, chỉ số cần thống kê
5. Thiết kế API phù hợp dữ liệu	Xây dựng API đọc dữ liệu đúng với mô hình	REST/GraphQL APIs rõ ràng, phân trang, lọc
6. UI & Use Case Logic (sau cùng)	Thiết kế màn hình để hiện dữ liệu từ DB/APIs	Giao diện thống kê, hóa đơn, tìm kiếm khách hàng

I. Usecase

1. Use case diagram tổng quan

graph TD
    actor1((Khách hàng))
    actor2((Nhân viên))
    actor3((Quản lý))

    subgraph UseCases
        UC1["Thuê sân (đặt sân)"]
        UC2["Nhận phiếu đặt sân"]
        UC3["Cập nhật mặt hàng đã dùng"]
        UC4["Thanh toán"]
        UC5["Nhận hóa đơn"]
        UC6["Quản lý sân bóng"]
        UC7["Quản lý mặt hàng"]
        UC8["Thống kê doanh thu"]
        UC9["Nhập hàng từ nhà cung cấp"]
    end

    actor1 --> UC1
    UC1 --> UC2
    actor1 --> UC4
    UC4 --> UC5

    actor2 --> UC1
    actor2 --> UC3
    actor2 --> UC4

    actor3 --> UC6
    actor3 --> UC7
    actor3 --> UC8
    actor3 --> UC9

    %% Coloring
    classDef Red fill:#ffcccc, stroke:#ff0000, stroke-width:2px
    classDef Blue fill:#cce5ff, stroke:#0033cc, stroke-width:2px
    classDef Green fill:#ccffcc, stroke:#009900, stroke-width:2px

    class actor1,actor2,actor3 Red
    class UC8 Green
    class UC1 Blue

📝 Giải thích sơ bộ:

Khách hàng có thể:

Đặt sân
Nhận phiếu đặt sân
Thanh toán và nhận hóa đơn

Nhân viên có vai trò trung gian thực hiện thao tác:

Đặt sân thay khách
Cập nhật mặt hàng đã dùng mỗi buổi
Xử lý thanh toán

Quản lý:

Quản lý thông tin sân bóng
Nhập và quản lý mặt hàng
Xem thống kê doanh thu
Nhập hàng từ nhà cung cấp

2. Use case diagram chi tiết cho chức năng Thống kê doanh thu

graph TD
    subgraph "Tính năng thống kê doanh thu"
    TK[Thống kê doanh thu]
    end

    subgraph "Tính năng tạo dữ liệu"
        TT[Thanh toán] --> TK
        MH[Mặt hàng đã dùng] --> TK
        DS[Đặt sân] --> TK
    end

    subgraph "Nguồn dữ liệu"
        HD[Hóa đơn]
        CTMH[Chi tiết mặt hàng]
        SB[Thông tin sân]
        KH[Thông tin khách hàng]
        NCC[Nhập hàng NCC]
    end

    HD --> TK
    CTMH --> TK
    SB --> TK
    KH --> TK
    NCC --> TK

    subgraph "Thành phần hệ thống"
        API[API Thống kê] --> TK
        UI[Giao diện thống kê] --> API
    end

Dữ liệu đầu vào

Nguồn dữ liệu	Mô tả chi tiết
Hóa đơn thanh toán	Bao gồm thông tin: khách hàng, sân thuê, thời gian, chi phí thuê, mặt hàng sử dụng, số tiền đã trả. Đây là nguồn chính để thống kê.
Mặt hàng ăn uống đã dùng	Được cập nhật từ chức năng "Checkout buổi thuê" sau khi khách đá xong, dùng để thống kê doanh thu từ dịch vụ kèm theo.
Thông tin sân bóng	Để phân tích doanh thu theo từng sân mini/lớn.
Thông tin khách hàng	Phục vụ phân loại doanh thu theo nhóm KH nếu cần (cá nhân, tổ chức, thuê theo tháng...).

Các tính năng liên quan

Tính năng	Mối liên hệ
Thanh toán	Là nơi tạo ra dữ liệu hóa đơn, quyết định thời gian - số tiền cần ghi nhận trong thống kê.
Cập nhật mặt hàng đã dùng	Ảnh hưởng đến phần doanh thu từ dịch vụ phụ trợ (nước uống, đồ ăn).
Đặt sân	Tác động gián tiếp đến thống kê bằng cách tạo ra dự kiến thu (nếu muốn phân tích hiệu quả đặt sân).
Nhập hàng từ nhà cung cấp	Nếu hệ thống tính lợi nhuận = doanh thu - chi phí thì cần dùng dữ liệu nhập hàng để phân tích.
Giao diện thống kê (UI)	Cho phép quản lý chọn khoảng thời gian (tháng, quý, năm), xem bảng thống kê và chi tiết hóa đơn.
API thống kê (Backend)	Nhận yêu cầu thống kê từ UI, truy vấn DB, tổng hợp dữ liệu, trả về kết quả.

Phụ thuộc hệ thống

CSDL:

Bảng hoa_don (invoice)
Bảng chi_tiet_mat_hang_da_dung
Bảng san_bong, khach_hang, mat_hang, nha_cung_cap

API:

GET /thong-ke?type=thang&year=2025
GET /hoa-don?from=2025-04-01&to=2025-04-30

UI/UX:

Dropdown chọn tháng/quý/năm
Bảng tổng hợp doanh thu
Bảng chi tiết hóa đơn trong từng dòng thống kê

II. Kiến trúc tổng quan hệ thống

graph TD
    User["Người dùng"]
    FE["FE <br/> (React + Next.js)"]
    BE["BE <br/> (Node.js + Express.js)"]
    DB["DB <br/> (Sqlite)"]

    User --> FE --> BE --> DB

Lựa chọn công nghệ:

1. DB

Câu hỏi: nên dùng SQL hay NoSQL?

Tiêu chí	SQL (SQLite)	NoSQL (MongoDB)
Tính chất dữ liệu	Có cấu trúc rõ ràng, nhiều quan hệ (relationship)	Dữ liệu bán cấu trúc, thiên về document
Sự phù hợp với nghiệp vụ	Tuyệt vời: hệ thống có hợp đồng, phiếu đặt sân, hóa đơn, mặt hàng, khách hàng, nhiều ràng buộc FK	Không tối ưu: sẽ phải dùng join bằng code, mất ràng buộc dữ liệu
Khả năng truy vấn thống kê	Rất mạnh nhờ SQL (`GROUP BY`, `JOIN`, `SUM`, `DATE_TRUNC`,...)	Có aggregation nhưng phức tạp và verbose
Mức độ thay đổi cấu trúc	Ràng buộc chặt → dễ kiểm soát	Linh hoạt → dễ lộn xộn nếu không kiểm soát
Dễ debug & maintain	Cao	Thấp hơn nếu dữ liệu bị lồng sâu
Công cụ hỗ trợ	Phong phú (ERD tool, SQL Studio, DB Browser)	Có nhưng thiên về developer, ít hỗ trợ quản trị tổng thể

Kết luận:

SQL là lựa chọn tốt hơn cho hệ thống này vì bài toán thiên về dữ liệu dạng bảng và có quan hệ chặt, có nhiều ràng buộc dữ liệu, cần tính toán thống kê và liên kết nhiều bảng.
SQLite là lựa chọn đơn giản và dễ tiếp cận, có thể chuyển sang PostgreSQL hoặc MS SQL Server sau này nếu cần.

2. Backend

Công nghệ: Node.js + Express.js

Lý do chọn lựa:

Node.js: Nền tảng JavaScript phổ biến, dễ dàng mở rộng và có hiệu suất cao cho các ứng dụng I/O.
Express.js: Framework nhẹ cho Node.js, giúp xây dựng API nhanh chóng và dễ dàng.

3. Frontend

Công nghệ: React + Next.js

Lý do chọn lựa:

React: Thư viện JavaScript phổ biến cho việc xây dựng giao diện người dùng, cho phép tái sử dụng component.
Next.js: Framework cho React, hỗ trợ SSR (Server-Side Rendering) và tối ưu hóa hiệu suất.

III. Thiết kế ERD và Database

1. Tóm tắt các thực thể chính (Entities)

Thực thể	Vai trò
`khach_hang`	Người thuê sân
`san_bong`	Thông tin các sân mini/lớn
`phieu_dat_san`	Phiếu xác nhận đặt sân của khách hàng
`chi_tiet_dat_san`	Một dòng đặt sân cụ thể: sân nào, khung giờ, ngày bắt đầu/kết thúc
`hoa_don`	Hóa đơn thanh toán cuối kỳ
`mat_hang`	Đồ ăn, nước uống bán kèm
`chi_tiet_su_dung_mat_hang`	Danh sách mặt hàng sử dụng mỗi buổi
`nha_cung_cap`	Nguồn cung cấp mặt hàng
`phieu_nhap_hang`	Hóa đơn nhập hàng
`chi_tiet_phieu_nhap`	Mặt hàng nhập cụ thể của 1 phiếu

2. Thiết kế ERD

erDiagram
    khach_hang {
        INT id PK
        STRING ho_ten
        STRING sdt
        STRING email
    }

    san_bong {
        INT id PK
        STRING ten_san
        STRING loai_san
        STRING mo_ta
        FLOAT gia_thue_theo_gio
    }

    phieu_dat_san {
        INT id PK
        INT khach_hang_id FK
        DATE ngay_dat
        FLOAT tong_tien_du_kien
        FLOAT tien_dat_coc
    }

    chi_tiet_dat_san {
        INT id PK
        INT phieu_dat_san_id FK
        INT san_bong_id FK
        TIME gio_bat_dau
        TIME gio_ket_thuc
        DATE ngay_bat_dau
        DATE ngay_ket_thuc
        TIME gio_nhan_san
        TIME gio_tra_san
        FLOAT gia_thue_theo_gio
    }

    hoa_don {
        INT id PK
        INT phieu_dat_san_id FK
        DATE ngay_thanh_toan
        FLOAT tong_tien
        FLOAT tien_thue_san
        FLOAT so_tien_thuc_tra
        FLOAT so_tien_con_lai
    }

    mat_hang {
        INT id PK
        STRING ten
        STRING don_vi
        FLOAT gia_ban
    }

    chi_tiet_su_dung_mat_hang {
        INT id PK
        INT hoa_don_id FK
        DATE ngay_su_dung
        INT mat_hang_id FK
        INT so_luong
        FLOAT gia_ban
        FLOAT thanh_tien
    }

    nha_cung_cap {
        INT id PK
        STRING ten
        STRING dia_chi
        STRING email
        STRING dien_thoai
        STRING mo_ta
    }

    phieu_nhap_hang {
        INT id PK
        INT nha_cung_cap_id FK
        DATE ngay_nhap
    }

    chi_tiet_phieu_nhap {
        INT id PK
        INT phieu_nhap_hang_id FK
        INT mat_hang_id FK
        INT so_luong
        FLOAT don_gia
        FLOAT thanh_tien
    }

    khach_hang ||--o{ phieu_dat_san : dat
    phieu_dat_san ||--o{ chi_tiet_dat_san : gom
    san_bong ||--o{ chi_tiet_dat_san : duoc_dat
    phieu_dat_san ||--|| hoa_don : tao_hoa_don
    hoa_don ||--o{ chi_tiet_su_dung_mat_hang : gom
    mat_hang ||--o{ chi_tiet_su_dung_mat_hang : su_dung
    nha_cung_cap ||--o{ phieu_nhap_hang : cung_cap
    phieu_nhap_hang ||--o{ chi_tiet_phieu_nhap : co
    mat_hang ||--o{ chi_tiet_phieu_nhap : duoc_nhap

Chú thích:

Các bảng chi_tiet_* cho phép mô hình hóa 1-nhiều linh hoạt và rõ ràng.
hoa_don tách riêng khỏi phieu_dat_san để phản ánh biến động phát sinh thực tế (thêm buổi, đồ ăn...).
mat_hang có thể dùng chung cho cả bán lẻ và nhập kho, nhờ phân biệt qua chi_tiet_su_dung_mat_hang và chi_tiet_phieu_nhap.

3. Thiết kế Database

Tham khảo file schema.sql để biết chi tiết về cấu trúc bảng và các ràng buộc.

4. Dữ liệu mẫu

Dữ liệu mẫu tham khảo trong file seed.sql.

Clean data tham khảo file clean.sql.

5. Truy vấn mẫu

Thống kê doanh thu

📅 Doanh thu theo tháng:

SELECT 
    strftime('%Y-%m', ngay_thanh_toan) AS thang,
    SUM(tong_tien) AS tong_doanh_thu
FROM hoa_don
GROUP BY thang
ORDER BY thang DESC;

🧾 Chi tiết hóa đơn trong một tháng:

SELECT
    hd.id AS hoa_don_id,
    kh.ho_ten AS ten_khach,
    sb.ten_san,
    hd.ngay_thanh_toan,
    hd.tong_tien
FROM hoa_don hd
JOIN phieu_dat_san pds ON pds.id = hd.phieu_dat_san_id
JOIN khach_hang kh ON kh.id = pds.khach_hang_id
JOIN chi_tiet_dat_san ctds ON ctds.phieu_dat_san_id = pds.id
JOIN san_bong sb ON sb.id = ctds.san_bong_id
WHERE strftime('%Y-%m', hd.ngay_thanh_toan) = '2025-04';

🍹 Doanh thu từ mặt hàng:

SELECT
    mh.ten,
    SUM(c.so_luong) AS tong_so_luong,
    SUM(c.thanh_tien) AS tong_doanh_thu
FROM chi_tiet_su_dung_mat_hang c
JOIN mat_hang mh ON mh.id = c.mat_hang_id
GROUP BY mh.id
ORDER BY tong_doanh_thu DESC;

Quản lí sân bóng

Các chức năng:

🔍 Tìm sân bóng theo tên (LIKE keyword)
🧾 Xem chi tiết sân bóng theo ID
✏️ Cập nhật thông tin sân bóng
➕ Thêm mới sân bóng
❌ Xóa sân bóng

🔍 1. Tìm kiếm sân bóng theo tên

SELECT * FROM san_bong
WHERE ten_san LIKE '%' || :keyword || '%';

🧾 2. Xem chi tiết sân bóng theo ID

SELECT * FROM san_bong
WHERE id = :id;

✏️ 3. Cập nhật thông tin sân bóng

UPDATE san_bong
SET ten_san = :ten_san,
    loai_san = :loai_san,
    mo_ta = :mo_ta
WHERE id = :id;

➕ 4. Thêm mới sân bóng

INSERT INTO san_bong (ten_san, loai_san, mo_ta)
VALUES (:ten_san, :loai_san, :mo_ta);

❌ 5. Xóa sân bóng

DELETE FROM san_bong
WHERE id = :id;

⚠️ Lưu ý: Nên kiểm tra xem sân có đang được sử dụng trong các phiếu đặt sân trước khi xoá.

Đặt sân

Các bảng chính liên quan: khach_hang, san_bong, phieu_dat_san, chi_tiet_dat_san.

Đáp ứng các chức năng:

Lưu thông tin khách hàng (khach_hang).
Lưu thông tin sân bóng (san_bong).
Lưu phiếu đặt sân, liên kết khách hàng, ngày đặt, tổng tiền dự kiến, tiền cọc (phieu_dat_san).
Lưu chi tiết từng sân được đặt, khung giờ, ngày bắt đầu/kết thúc, giá thuê một buổi (chi_tiet_dat_san).

Tìm sân trống theo khung giờ, loại sân, ngày bắt đầu/kết thúc:

Tham số: loại sân, khung giờ, ngày bắt đầu, ngày kết thúc:

-- Tìm các sân còn trống theo loại sân, khung giờ, ngày bắt đầu/kết thúc
SELECT s.*
FROM san_bong s
WHERE s.loai_san = ? -- loại sân cần tìm
  AND s.id NOT IN (
    SELECT ctds.san_bong_id
    FROM chi_tiet_dat_san ctds
    WHERE ctds.khung_gio = ? -- khung giờ cần tìm, ví dụ '18:00-20:00'
      AND (
        -- Kiểm tra giao thoa khoảng ngày
        ctds.ngay_bat_dau <= ? -- ngày kết thúc cần đặt
        AND ctds.ngay_ket_thuc >= ? -- ngày bắt đầu cần đặt
      )
  );

Tìm khách hàng theo tên (tìm kiếm fuzzy):

SELECT * FROM khach_hang
WHERE ho_ten LIKE '%' || ? || '%';

Thêm mới khách hàng:

INSERT INTO khach_hang (ho_ten, sdt, email)
VALUES (?, ?, ?);

Lưu phiếu đặt sân (tạo phiếu đặt sân mới):

INSERT INTO phieu_dat_san (khach_hang_id, ngay_dat, tong_tien_du_kien, tien_dat_coc)
VALUES (?, DATE('now'), ?, ?);

Lưu chi tiết đặt sân (cho từng sân, từng khung giờ):

INSERT INTO chi_tiet_dat_san (phieu_dat_san_id, san_bong_id, khung_gio, ngay_bat_dau, ngay_ket_thuc, gia_thue_theo_gio)
VALUES (?, ?, ?, ?, ?, ?);

Tính tổng số buổi và tổng tiền dự kiến:

Số buổi = số ngày trong khoảng (ngay_bat_dau → ngay_ket_thuc) * số khung giờ (nếu đặt nhiều khung giờ).
Tổng tiền = số buổi * giá thuê một buổi.

SELECT 
  julianday(ngay_ket_thuc) - julianday(ngay_bat_dau) + 1 AS so_ngay,
  gia_thue_theo_gio,
  (julianday(ngay_ket_thuc) - julianday(ngay_bat_dau) + 1) * gia_thue_theo_gio AS tong_tien
FROM chi_tiet_dat_san
WHERE id = ?;

Checkout sân

Lấy danh sách phiếu đặt sân của khách hàng (theo tên):

SELECT pds.*, kh.ho_ten, kh.sdt
FROM phieu_dat_san pds
JOIN khach_hang kh ON pds.khach_hang_id = kh.id
WHERE kh.ho_ten LIKE '%' || ? || '%';

Lấy danh sách hóa đơn (buổi thuê) của một khách hàng:

SELECT hd.*, pds.ngay_dat, kh.ho_ten
FROM hoa_don hd
JOIN phieu_dat_san pds ON hd.phieu_dat_san_id = pds.id
JOIN khach_hang kh ON pds.khach_hang_id = kh.id
WHERE kh.id = ?;

Lấy danh sách mặt hàng đã dùng của một hóa đơn (buổi thuê):

SELECT ctsdmh.*, mh.ten AS ten_mat_hang, mh.don_vi
FROM chi_tiet_su_dung_mat_hang ctsdmh
JOIN mat_hang mh ON ctsdmh.mat_hang_id = mh.id
WHERE ctsdmh.hoa_don_id = ?;

Tìm mặt hàng theo tên (autocomplete):

SELECT * FROM mat_hang WHERE ten LIKE '%' || ? || '%';

Thêm mặt hàng đã dùng cho một hóa đơn (buổi thuê):

INSERT INTO chi_tiet_su_dung_mat_hang (hoa_don_id, ngay_su_dung, mat_hang_id, so_luong, gia_ban, thanh_tien)
VALUES (?, ?, ?, ?, ?, ?);

Sửa thông tin mặt hàng đã dùng:

UPDATE chi_tiet_su_dung_mat_hang
SET so_luong = ?, gia_ban = ?, thanh_tien = ?
WHERE id = ?;

Xóa mặt hàng đã dùng:

DELETE FROM chi_tiet_su_dung_mat_hang WHERE id = ?;

Tính tổng tiền mặt hàng đã dùng của một hóa đơn (buổi thuê):

SELECT SUM(thanh_tien) AS tong_tien
FROM chi_tiet_su_dung_mat_hang
WHERE hoa_don_id = ?;

Thanh toán

-- 1. Tìm khách hàng theo tên (autocomplete/fuzzy search)
SELECT * FROM khach_hang
WHERE ho_ten LIKE '%' || :keyword || '%';

-- 2. Lấy danh sách phiếu đặt sân của khách hàng
SELECT pds.*, kh.ho_ten, kh.sdt
FROM phieu_dat_san pds
JOIN khach_hang kh ON pds.khach_hang_id = kh.id
WHERE kh.id = :khach_hang_id
ORDER BY pds.ngay_dat DESC;

-- 3. Lấy hóa đơn của một phiếu đặt sân
SELECT hd.*, pds.ngay_dat, kh.ho_ten
FROM hoa_don hd
JOIN phieu_dat_san pds ON hd.phieu_dat_san_id = pds.id
JOIN khach_hang kh ON pds.khach_hang_id = kh.id
WHERE pds.id = :phieu_dat_san_id;

-- 4. Lấy chi tiết mặt hàng đã dùng của hóa đơn
SELECT ctsdmh.*, mh.ten AS ten_mat_hang, mh.don_vi
FROM chi_tiet_su_dung_mat_hang ctsdmh
JOIN mat_hang mh ON ctsdmh.mat_hang_id = mh.id
WHERE ctsdmh.hoa_don_id = :hoa_don_id;

-- 5. Cập nhật số tiền thực trả, số tiền còn lại của hóa đơn
UPDATE hoa_don
SET so_tien_thuc_tra = :so_tien_thuc_tra,
    so_tien_con_lai = tong_tien - :so_tien_thuc_tra
WHERE id = :hoa_don_id;

-- 6. Sửa thông tin mặt hàng đã dùng (nếu có sai lệch)
UPDATE chi_tiet_su_dung_mat_hang
SET so_luong = :so_luong, gia_ban = :gia_ban, thanh_tien = :thanh_tien
WHERE id = :chi_tiet_su_dung_mat_hang_id;

-- 7. Xóa mặt hàng đã dùng (nếu cần)
DELETE FROM chi_tiet_su_dung_mat_hang
WHERE id = :chi_tiet_su_dung_mat_hang_id;

-- 8. Thêm mặt hàng đã dùng mới (nếu bổ sung)
INSERT INTO chi_tiet_su_dung_mat_hang (hoa_don_id, ngay_su_dung, mat_hang_id, so_luong, gia_ban, thanh_tien)
VALUES (:hoa_don_id, :ngay_su_dung, :mat_hang_id, :so_luong, :gia_ban, :thanh_tien);

-- 9. Tính tổng tiền mặt hàng đã dùng của hóa đơn
SELECT SUM(thanh_tien) AS tong_tien_mat_hang
FROM chi_tiet_su_dung_mat_hang
WHERE hoa_don_id = :hoa_don_id;

-- 10. In hóa đơn: tổng hợp thông tin khách hàng, phiếu đặt sân, hóa đơn, mặt hàng đã dùng
SELECT hd.*, pds.*, kh.*, ctds.*, sb.ten AS ten_san
FROM hoa_don hd
JOIN phieu_dat_san pds ON hd.phieu_dat_san_id = pds.id
JOIN khach_hang kh ON pds.khach_hang_id = kh.id
JOIN chi_tiet_dat_san ctds ON ctds.phieu_dat_san_id = pds.id
JOIN san_bong sb ON ctds.san_bong_id = sb.id
WHERE hd.id = :hoa_don_id;
-- Lấy thêm mặt hàng đã dùng như truy vấn số 4
-- (Gộp các truy vấn trên, hoặc join để lấy đầy đủ thông tin cho in hóa đơn)

IV. Thiết kế API

1. API thống kê doanh thu

todo

2. API chi tiết hóa đơn

todo

V. Thiết kế UI/UX

1. Giao diện thống kê doanh thu

todo

2. Giao diện chi tiết hóa đơn

todo

X. Tổng kết

✅ Những gì đã thực hiện

Hạng mục	Tình trạng	Ghi chú
Phân tích yêu cầu bài toán từ file	✅	Đã đọc kỹ từ `yeu-cau.txt`
Use Case Diagram bằng Mermaid	✅	Có đầy đủ actor + chức năng
Lựa chọn hướng thiết kế (SQL vs NoSQL)	✅	Chọn SQLite (SQL-first, data-driven)
Thiết kế ERD + Mermaid	✅	Chuẩn hóa toàn bộ thực thể, quan hệ
Sinh schema SQL cho SQLite	✅	Dễ triển khai, tối ưu sẵn
Truy vấn thống kê doanh thu mẫu	✅	`GROUP BY` tháng, hóa đơn, mặt hàng
Seed data năm 2025 (nhiều tháng)	✅	Gồm cả thuê sân + đồ ăn
Tạo REST API bằng Express	✅	`GET /thong-ke` + `/thong-ke/chi-tiet`
Xây dựng frontend React + Next.js	✅	Giao diện thống kê, lọc, click để xem hóa đơn
Component React: `FilterBar`, `RevenueTable`, `InvoiceDetails`	✅	Giao diện tương tác hoàn chỉnh
Seed dữ liệu mở rộng (2023, 2024)	✅	Phủ dữ liệu đa niên, rải rác nhiều tháng

❌ Các tính năng đã gợi ý nhưng CHƯA thực hiện

Đề xuất	Mô tả	Ghi chú
🔒 Đăng nhập bằng Keycloak (OIDC)	Xác thực người dùng (quản lý/nhân viên)	Đã có đề cập đến OIDC trong đầu bài
📊 Biểu đồ doanh thu (Chart)	Trực quan hóa doanh thu bằng biểu đồ	Dùng `recharts` hoặc `chart.js`
🧾 Xuất PDF báo cáo	In hoặc lưu thống kê doanh thu/hóa đơn	Dùng `jspdf`, `react-pdf`
📦 Triển khai Docker	Dockerize backend/frontend	Tách `backend` (Express) và `frontend` (Next.js)
🔍 Lọc nâng cao hóa đơn theo khách hàng/sân	Lọc hóa đơn theo tên khách/sân cụ thể	Cần bổ sung param lọc trong API `/chi-tiet`
🧪 Tạo dữ liệu giả lập (faker)	Sinh dữ liệu random phục vụ load test	Dùng `faker.js`, `csvgen`, hoặc script seed động

Name		Name	Last commit message	Last commit date
Latest commit History 45 Commits
backend		backend
db		db
frontend		frontend
.gitignore		.gitignore
BAOCAO.md		BAOCAO.md
README-old.md		README-old.md
README.md		README.md
YEUCAU.md		YEUCAU.md

Folders and files

Latest commit

History

Repository files navigation

Hệ thống cho thuê sân bóng mini

I. Usecase

1. Use case diagram tổng quan

2. Use case diagram chi tiết cho chức năng Thống kê doanh thu

Dữ liệu đầu vào

Các tính năng liên quan

Phụ thuộc hệ thống

II. Kiến trúc tổng quan hệ thống

1. DB

2. Backend

3. Frontend

III. Thiết kế ERD và Database

1. Tóm tắt các thực thể chính (Entities)

2. Thiết kế ERD

3. Thiết kế Database

4. Dữ liệu mẫu

5. Truy vấn mẫu

Thống kê doanh thu

Quản lí sân bóng

Đặt sân

Checkout sân

Thanh toán

IV. Thiết kế API

1. API thống kê doanh thu

2. API chi tiết hóa đơn

V. Thiết kế UI/UX

1. Giao diện thống kê doanh thu

2. Giao diện chi tiết hóa đơn

X. Tổng kết

✅ Những gì đã thực hiện

❌ Các tính năng đã gợi ý nhưng CHƯA thực hiện

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages