Dữ liệu lịch sử trên MongoDB
Theo mặc định, mọi bảng đều nằm trên kết nối chính của ứng dụng (PostgreSQL hoặc MySQL) — tính năng này không thay đổi điều đó trừ khi bạn chủ động bật. Các cửa hàng tự lưu trữ có lượng lịch sử chỉ ghi thêm lớn (mục nhật ký hoạt động, bản ghi trò chuyện, lịch sử email CRM) có thể chuyển riêng những bảng đó sang một kết nối khác, bao gồm MongoDB, mà không ảnh hưởng đến bất kỳ thành phần nào khác.
Nội dung được chuyển
- Nhật ký hoạt động — bảng
activity_log(mọi mục kiểm toán create/update/delete/login) - Tin nhắn trò chuyện — bảng của module Messaging
msg_messagestin nhắn - Lịch sử email CRM — bảng
crm_email_messagesvàcrm_email_eventscác bảng
Mọi nội dung khác — đơn hàng, sản phẩm, khách hàng, kế toán — luôn nằm trên kết nối chính. Đây chỉ là giải pháp chuyển dữ liệu có mục đích dành riêng cho các bảng lịch sử khối lượng lớn, hiếm khi cần join.
Tùy chọn A: Kết nối SQL khác
Trỏ dữ liệu lịch sử đến bất kỳ kết nối nào đã được định nghĩa trong config/database.php (ví dụ: cơ sở dữ liệu Postgres thứ hai dành riêng cho log):
HISTORICAL_DB_CONNECTION=pgsql_history
Tính năng này hoạt động ngay lập tức mà không cần cài thêm package — Eloquent thuần trên một kết nối SQL thuần.
Tùy chọn B: MongoDB
Một mongodb mẫu kết nối đã được cung cấp sẵn trong config/database.php nhưng sẽ không hoạt động cho đến khi bạn chủ động bật:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
Hỗ trợ MongoDB yêu cầu hai thứ mà nền tảng này không cài đặt theo mặc định:
- PHP extension
mongodbtrên máy chủ của bạn composer require mongodb/laravel-mongodb(được liệt kê trongsuggestở thư mục gốccomposer.json)
Nếu chưa cài extension và package, thiết lập HISTORICAL_DB_CONNECTION=mongodb sẽ được bỏ qua một cách an toàn — mọi model sẽ dùng lại kết nối mặc định và ứng dụng khởi động, vận hành y hệt như trước.
Hỗ trợ Model MongoDB đầy đủ
Sau khi mongodb/laravel-mongodb được cài đặt, chỉ riêng việc chuyển kết nối đã cho phép truy cập collection Mongo ở mức query builder. Để có hỗ trợ Eloquent đầy đủ (BSON casts, khóa chính ObjectId, tài liệu nhúng), bạn cũng cần thêm MongoDB\Laravel\Eloquent\DocumentModel trait của package vào model, cùng với trait chuyển kết nối mà nền tảng này đã cung cấp cho các model lịch sử:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Vì Store Console được cung cấp đầy đủ mã nguồn theo từng giấy phép, thay đổi một dòng này là tùy biến thông thường trên bản sao của bạn — không phải bản vá từ nhà cung cấp.
Cách hoàn tác
Bỏ đặt HISTORICAL_DB_CONNECTION (hoặc đặt lại thành rỗng) và mọi model sẽ trở về kết nối mặc định ở request tiếp theo — không cần migration để tắt tính năng.

