============================================================
BABYSHOP - HỆ THỐNG THƯƠNG MẠI ĐIỆN TỬ MẸ & BÉ
TỔNG HỢP CHỨC NĂNG (FEATURE LIST)
============================================================
THÔNG TIN CHUNG
- Công nghệ:
- Backend/Framework: PHP 8.3 + Laravel 11
- CSDL: MySQL 8.4
- Trang quản trị (Admin panel): Filament 4
- Frontend storefront: Blade + Tailwind CSS + Alpine.js + Vite
- Nền tảng bất đồng bộ: Laravel Queue + Scheduler (email/đơn định kỳ)
- AI: Claude API (claude-opus-4-8) + RAG trên Blog
- Kiến trúc tích hợp: Adapter + bản Mock (thanh toán, vận chuyển, SMS,
social login, AI) — chạy được ngay, cắm khóa thật sau
- Đối tượng sử dụng:
- Khách vãng lai (guest, không cần tài khoản)
- Khách có tài khoản (mẹ bỉm sữa / bố bầu)
- Quản trị viên (Admin / Nhân viên kho)
============================================================
1. CHỨC NĂNG DÀNH CHO KHÁCH HÀNG
============================================================
1.1. TÀI KHOẢN & XÁC THỰC
- Đăng ký / Đăng nhập bằng email + mật khẩu
- Đăng nhập bằng số điện thoại qua mã OTP (SMS)
- Đăng nhập mạng xã hội: Google, Facebook
- Quản lý thông tin tài khoản, đổi mật khẩu, quên mật khẩu
- Sổ địa chỉ nhận hàng (nhiều địa chỉ, đặt mặc định)
- Hồ sơ Bé (đặc thù Mẹ & Bé):
- Lưu tên bé, giới tính, ngày sinh, chiều cao, cân nặng, ghi chú
(dị ứng, sở thích)
- Tự động tính tuổi bé -> phân nhóm giai đoạn phát triển
- Cá nhân hóa gợi ý sản phẩm theo hồ sơ bé
1.2. DUYỆT & TÌM KIẾM SẢN PHẨM
- Danh mục sản phẩm đa cấp (cha - con): Sữa, Tã bỉm, Quần áo, Đồ chơi,
Đồ dùng cho mẹ bầu...
- Bộ lọc đặc thù ngành Mẹ & Bé:
- Lọc theo độ tuổi / giai đoạn của bé (Sơ sinh, 3-12 tháng, 1-3 tuổi,
4-6 tuổi, trên 6 tuổi)
- Lọc theo giới tính (bé trai / bé gái / dùng
- Lọc theo thương hiệu
- Lọc theo khoảng giá
- Lọc theo size / phân loại
- Sắp xếp: mới nhất, giá tăng/giảm, bán chạy (lượt
- Tìm kiếm với gợi ý tự động (autocomplete)
- Trang chi tiết sản phẩm:
- Thư viện ảnh, mô tả, thương hiệu, độ tuổi, giới tính phù hợp
- Biến thể sản phẩm (màu / size / dung tích) +
- Hiển thị giá khuyến mãi / giá flash sale
- Link "Hướng dẫn chọn size"
- Nút Yêu thích (tim)
- Đăng ký giao hàng định kỳ ngay tại trang sản
- "Báo tôi khi có hàng" khi sản phẩm hết hàng
- Sản phẩm liên quan
1.3. HƯỚNG DẪN CHỌN SIZE (ĐẶC THÙ)
- Trang bảng size theo giới tính / độ tuổi / chiều cao / cân nặng
- Áp dụng cho quần áo, giày dép cho bé
1.4. GIỎ HÀNG & THANH TOÁN
- Giỏ hàng: Thêm / Sửa số lượng / Xóa sản phẩm
- Mini-cart hiển thị nhanh ở header (cập nhật real
- Hỗ trợ giỏ hàng cho cả khách vãng lai (theo session) và tài khoản
- Tự động gộp giỏ khách vãng lai vào tài khoản
- Thanh toán (hỗ trợ Guest Checkout - không cần tài khoản):
- Nhập / chọn địa chỉ giao hàng đã lưu
- Chọn đơn vị / phương thức vận chuyển + tính phí ship tự động
- Áp dụng Mã giảm giá (coupon)
- Áp dụng Thẻ quà tặng (Gift Card)
- Sử dụng Điểm thưởng để giảm giá
- Tự động áp khuyến mãi (miễn phí ship theo ngưỡng đơn...)
- Chọn phương thức thanh toán: COD, chuyển kho
- Thanh toán trực tuyến qua cổng (VNPay ký thật; Momo/ZaloPay dạng adapter)
- Nhận email xác nhận đơn hàng tự động
1.5. QUẢN LÝ ĐƠN HÀNG
- Tra cứu đơn hàng công khai (không cần đăng nhập)
- Theo dõi trạng thái đơn theo thời gian thực (lịc
- Xem mã vận đơn + hãng vận chuyển
- Lịch sử đơn hàng của tài khoản
- Mua lại (đặt lại đơn cũ)
1.6. YÊU THÍCH & DANH SÁCH QUÀ TẶNG (REGISTRY)
- Danh sách sản phẩm yêu thích
- Tạo Danh sách quà tặng (Registry) cho dịp đầy tháng, sinh nhật...
- Chia sẻ công khai qua đường link (token)
- Người thân chọn quà, hiển thị số lượng "còn cần tặng"
1.7. GỢI Ý CÁ NHÂN HÓA THEO BÉ
- Gợi ý sản phẩm theo giai đoạn phát triển của từn
(dựa trên tuổi + giới tính trong hồ sơ bé)
1.8. KHÁCH HÀNG THÂN THIẾT (LOYALTY)
- Tích điểm khi mua sắm (tự cộng khi đơn giao thàn
- Tiêu điểm để giảm giá khi thanh toán
- Phân hạng thành viên (Đồng / Bạc / Vàng / Kim cư
- Hệ số nhân điểm + ưu đãi theo hạng
- Thanh tiến trình lên hạng kế tiếp
- Lịch sử tích/tiêu điểm
1.9. KHUYẾN MÃI
- Trang Flash Sale (đếm ngược thời gian, thanh "đã
- Combo tiết kiệm (mua theo bộ, hiển thị mức tiết kiệm)
- Mã giảm giá theo %/số tiền/miễn phí ship, điều k
- Thẻ quà tặng (gift card) trừ dần số dư
1.10. TIẾP THỊ LIÊN KẾT (AFFILIATE)
- Đăng ký làm cộng tác viên, nhận link giới thiệu
- Theo dõi lượt click, đơn phát sinh, hoa hồng
1.11. GIAO HÀNG ĐỊNH KỲ (SUBSCRIPTION)
- Đăng ký nhận sản phẩm hay dùng (bỉm, sữa) theo c
- Tạm dừng / tiếp tục / hủy đăng ký
- Hệ thống tự tạo đơn khi đến kỳ giao
1.12. NỘI DUNG & CẨM NANG (BLOG)
- Blog cẩm nang Mẹ & Bé (dinh dưỡng, chăm sóc bé, mẹo cho mẹ)
- Lọc theo danh mục, tìm kiếm bài viết
- Chi tiết bài viết chuẩn SEO (meta OG, canonical, dữ liệu JSON-LD),
thời gian đọc, bài liên quan
1.13. TRỢ LÝ AI CHATBOT
- Chat widget nổi trên toàn bộ storefront
- Tư vấn sản phẩm, tư vấn chọn size cho bé
- Hỏi đáp kiến thức (RAG dựa trên nội dung Blog)
- Tra cứu đơn hàng qua chat
- Trả lời kèm nguồn tham chiếu (sản phẩm / bài viết / đơn hàng)
1.14. BẢN TIN (NEWSLETTER)
- Đăng ký nhận bản tin ở footer
- Hủy đăng ký qua link (token)
============================================================
2. CHỨC NĂNG DÀNH CHO QUẢN TRỊ VIÊN (ADMIN / NHÂN
============================================================
2.1. QUẢN LÝ DANH MỤC SẢN PHẨM
- CRUD Sản phẩm (kèm ảnh bìa, thư viện ảnh, mô tả,
- Quản lý thuộc tính đặc thù: giới tính, nhóm tuổi phù hợp, thương hiệu
- Quản lý Biến thể sản phẩm (Size tã, dung tích sữ
- SKU, giá / giá KM riêng, tồn kho, khối lượng (tính phí ship)
- Quản lý tồn kho + ngưỡng cảnh báo hết hàng (low
- CRUD Danh mục đa cấp
- CRUD Thương hiệu
- CRUD Nhà cung cấp
2.2. QUẢN LÝ ĐƠN HÀNG & GIAO HÀNG
- Danh sách đơn, lọc theo trạng thái / thanh toán
- Xem chi tiết đơn (khách hàng, sản phẩm, tiền, khuyến mãi áp dụng)
- Cập nhật trạng thái đơn + ghi lịch sử
- Tạo vận đơn qua hãng vận chuyển (GHN / GHTK) -> sinh mã tracking
- Theo dõi trạng thái thanh toán
2.3. QUẢN LÝ KHUYẾN MÃI
- Khuyến mãi / Mã giảm giá (tự động hoặc mã nhập tay, giới hạn lượt dùng)
- Flash Sale (đợt giảm giá theo thời gian + danh s
- Combo sản phẩm
- Thẻ quà tặng (tạo mã, mệnh giá, hạn dùng)
2.4. KHÁCH HÀNG THÂN THIẾT
- Cấu hình Hạng thành viên (ngưỡng điểm, hệ số nhân, ưu đãi %)
- (Điểm thưởng cộng/trừ tự động theo đơn)
2.5. CỘNG TÁC VIÊN & GIAO HÀNG ĐỊNH KỲ
- Quản lý cộng tác viên (Affiliate): tỉ lệ hoa hồng, click, đơn, số dư
- Theo dõi đăng ký giao hàng định kỳ (Subscription
2.6. QUẢN LÝ NỘI DUNG
- CRUD Bài viết Blog (trình soạn thảo, ảnh bìa, tag, SEO, lịch xuất bản)
- CRUD Danh mục Blog
- CRUD Bảng hướng dẫn chọn size
2.7. EMAIL & BẢN TIN
- Soạn & gửi chiến dịch bản tin tới toàn bộ người
- Quản lý danh sách người đăng ký nhận bản tin
2.8. AI CHATBOT
- Xem lại lịch sử hội thoại chatbot của khách
- Xem tag hành vi khách hàng (ý định, mối quan tâm sản phẩm)
2.9. BÁO CÁO & THỐNG KÊ
- Báo cáo doanh thu, đơn hàng
- Thống kê sản phẩm bán chạy
- Quản lý người dùng / tài khoản
==================================================
3. TỰ ĐỘNG HÓA & TÍCH HỢP HỆ THỐNG
==================================================
3.1. EMAIL TỰ ĐỘNG (QUEUE)
- Email xác nhận đơn hàng (ngay khi đặt)
- Email nhắc giỏ hàng bỏ quên (theo lịch, không gử
- Email chúc mừng sinh nhật bé + tặng mã giảm giá (theo lịch hằng ngày)
- Email báo "hàng về" khi sản phẩm có hàng trở lại
- Gửi chiến dịch bản tin
3.2. TÁC VỤ THEO LỊCH (SCHEDULER)
- Quét & nhắc giỏ hàng bỏ quên
- Gửi lời chúc sinh nhật bé
- Tự động tạo đơn cho các đăng ký giao hàng định k
3.3. TÍCH HỢP BÊN THỨ BA (ADAPTER + MOCK, CẮM KHÓA
- Cổng thanh toán: VNPay (ký HMAC thật), Momo, ZaloPay
- Hãng vận chuyển: GHN, GHTK
- SMS OTP (nhà cung cấp SMS)
- Đăng nhập mạng xã hội: Google, Facebook
- AI: Claude API (chatbot + RAG)
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
Hướng dẫn chạy dự án BabyShop
Tổng quan
BabyShop là ứng dụng thương mại điện tử bán đồ trẻ em, xây dựng bằng Laravel 13 + Filament 5 (admin panel) + Tailwind
CSS + Alpine.js.
Yêu cầu môi trường
┌──────────┬─────────────────────┬───────────────────────────────────────────────────────────────────────────────┐
│ Phần mềm │ Phiên bản tối thiểu │ Ghi chú │
├──────────┼─────────────────────┼───────────────────────────────────────────────────────────────────────────────┤
│ PHP │ 8.3+ │ Cần extension: pdo_sqlite, mbstring, openssl, tokenizer, xml, ctype, fileinfo │
├──────────┼─────────────────────┼───────────────────────────────────────────────────────────────────────────────┤
│ Composer │ 2.x │ Quản lý PHP packages │
├──────────┼─────────────────────┼───────────────────────────────────────────────────────────────────────────────┤
│ Node.js │ 18+ │ Cần cho Vite/Tailwind │
├──────────┼─────────────────────┼───────────────────────────────────────────────────────────────────────────────┤
│ npm │ 9+ │ Đi kèm với Node.js │
├──────────┼─────────────────────┼───────────────────────────────────────────────────────────────────────────────┤
│ SQLite │ 3.x │ Mặc định cho dev (không cần cài riêng nếu PHP có pdo_sqlite) │
└──────────┴─────────────────────┴───────────────────────────────────────────────────────────────────────────────┘
▎ MySQL chỉ cần thiết cho production. Dev dùng SQLite đơn giản hơn.
---
Cài đặt lần đầu
Bước 1 — Clone và cài PHP dependencies
git clone <repo-url> babyshop
cd babyshop
composer install
Bước 2 — Tạo file .env
cp .env.example .env
php --ini
Lấy đường dẫn file php.ini và mở lên sau đó làm việc sau
xóa dấu ; trước extension=openssl và thêm extension_dir = "ext"
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'c8b085408188070d5f52bcfe4ecfbee5f727afa458b2573b8eaaf77b3419b0bf2768dc67c86944da1544f06fa544fd47') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"
php composer-setup.php
php -r "unlink('composer-setup.php');"
php artisan key:generate
Bước 3 — Tạo SQLite database và migrate
# Tạo file database
touch database/database.sqlite
# Chạy migrations (tạo tất cả tables)
php artisan migrate
Bước 4 — Cài Node dependencies và build assets
npm install
npm run build
Bước 5 (tuỳ chọn) — Seed dữ liệu mẫu
php artisan db:seed
---
Hoặc: Cài đặt một lệnh duy nhất
composer run setup
Lệnh này tự động chạy tất cả các bước trên (install, copy .env, key:generate, migrate, npm install, npm build).
---
Chạy môi trường development
composer run dev
Lệnh này khởi động 4 process song song:
┌──────────────────────────┬────────────┬──────────────────────────────────────────────┐
│ Process │ Màu │ Chức năng │
├──────────────────────────┼────────────┼──────────────────────────────────────────────┤
│ php artisan serve │ Xanh dương │ Web server tại http://localhost:8000 │
├──────────────────────────┼────────────┼──────────────────────────────────────────────┤
│ php artisan queue:listen │ Tím │ Xử lý background jobs (email, notifications) │
├──────────────────────────┼────────────┼──────────────────────────────────────────────┤
│ php artisan pail │ Đỏ hồng │ Stream logs ra terminal real-time │
├──────────────────────────┼────────────┼──────────────────────────────────────────────┤
│ npm run dev (Vite) │ Cam │ Hot reload CSS/JS │
└──────────────────────────┴────────────┴──────────────────────────────────────────────┘
Mở trình duyệt: http://localhost:8000
Admin panel: http://localhost:8000/admin
---
Cấu hình .env quan trọng
File .env mặc định đã hoạt động cho dev. Dưới đây là các biến cần biết:
# === APP ===
APP_NAME=BabyShop
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost
# === DATABASE (mặc định SQLite, không cần thay đổi) ===
DB_CONNECTION=sqlite
# Nếu muốn dùng MySQL:
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=babyshop
# DB_USERNAME=root
# DB_PASSWORD=your_password
# === MAIL (mặc định ghi ra log, không cần mail server) ===
MAIL_MAILER=log # Email sẽ xuất hiện trong storage/logs/laravel.log
# === PAYMENT (mặc định dùng mock, không cần credentials thật) ===
# VNPAY_TMN_CODE=
# VNPAY_HASH_SECRET=
# === SHIPPING (mặc định dùng mock) ===
# GHN_TOKEN=
# GHTK_TOKEN=
# === AI CHATBOT (tuỳ chọn — bỏ trống sẽ dùng mock heuristic) ===
# ANTHROPIC_API_KEY=sk-ant-...
# === SOCIAL LOGIN (tuỳ chọn) ===
# GOOGLE_CLIENT_ID=
# GOOGLE_CLIENT_SECRET=
# FACEBOOK_CLIENT_ID=
# FACEBOOK_CLIENT_SECRET=
---
Cấu hình MySQL (cho production hoặc nếu muốn)
1. Tạo database:
CREATE DATABASE babyshop CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
2. Cập nhật .env:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=babyshop
DB_USERNAME=root
DB_PASSWORD=your_password
3. Chạy lại migrate:
php artisan migrate
---
Các lệnh hữu ích
# Chạy tests
composer run test
# Xem logs
php artisan pail
# Clear cache khi thay đổi config
php artisan config:clear
php artisan cache:clear
# Chạy scheduled tasks thủ công (cron jobs)
php artisan schedule:run
# Xem tất cả routes
php artisan route:list
# Tạo admin user (nếu seeder không tạo)
php artisan tinker
# >>> \App\Models\User::factory()->create(['email' => 'admin@example.com', 'password' => bcrypt('password')])
---
Tích hợp tuỳ chọn (để mở khoá tính năng thật)
┌─────────────────────┬────────────────────────────────────────────┐
│ Tính năng │ Biến ENV cần thêm │
├─────────────────────┼────────────────────────────────────────────┤
│ VNPay payment │ VNPAY_TMN_CODE, VNPAY_HASH_SECRET │
├─────────────────────┼────────────────────────────────────────────┤
│ GHN shipping │ GHN_TOKEN, GHN_SHOP_ID │
├─────────────────────┼────────────────────────────────────────────┤
│ GHTK shipping │ GHTK_TOKEN │
├─────────────────────┼────────────────────────────────────────────┤
│ AI Chatbot (Claude) │ ANTHROPIC_API_KEY │
├─────────────────────┼────────────────────────────────────────────┤
│ Google Login │ GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET │
├─────────────────────┼────────────────────────────────────────────┤
│ Facebook Login │ FACEBOOK_CLIENT_ID, FACEBOOK_CLIENT_SECRET │
├─────────────────────┼────────────────────────────────────────────┤
│ SMS OTP (thật) │ SMS_DRIVER=api, SMS_API_KEY │
└─────────────────────┴────────────────────────────────────────────┘
Không có credentials → hệ thống tự động dùng mock/adapter, ứng dụng vẫn chạy bình thường.
---
Kiểm tra cài đặt PHP extensions
php -m | grep -E "pdo|sqlite|mbstring|openssl|tokenizer|xml|ctype|fileinfo|curl|zip"
Nếu thiếu extension nào trên Windows:
1. Mở php.ini (php --ini để tìm đường dẫn)
2. Bỏ dấu ; trước extension=tên_extension
3. Khởi động lại terminal
Nguồn: Topcode.vn
