HƯỚNG DẪN CÀI ĐẶT

eBuildFlow Pro V1.0

Phần mềm Quản lý Vật liệu Xây dựng

Đối tượng sử dụng: Quản trị viên, kỹ thuật viên hoặc người thực hiện cài đặt hệ thống.

1. YÊU CẦU HỆ THỐNG

Trước khi cài đặt, hãy đảm bảo máy chủ đáp ứng các yêu cầu sau:

Không cần cài thêm

• Composer

• Node.js

Gói cài đặt đã bao gồm các thư viện cần thiết và giao diện đã được biên dịch.

Trình cài đặt thông minh: Bước đầu tiên sẽ tự động kiểm tra môi trường máy chủ. Nếu thiếu thành phần, hệ thống sẽ xác định thành phần còn thiếu và hướng dẫn cách khắc phục.

2. CÀI ĐẶT TRÊN MÁY CÁ NHÂN

Sử dụng Laragon

Phương án này phù hợp khi:

• Chạy thử phần mềm;

• Phát triển hoặc kiểm thử;

• Sử dụng trong mạng nội bộ cửa hàng.

Bước 1 — Khởi động máy chủ

Mở Laragon và chọn:

Start All

Đảm bảo Apache và MySQL đang hoạt động.

Bước 2 — Giải nén phần mềm

Giải nén gói cài đặt vào:

C:\laragon\www\qlvlxd\

Bước 3 — Tạo cơ sở dữ liệu

Mở HeidiSQL từ Laragon và tạo cơ sở dữ liệu mới.

Ví dụ:

Tên CSDL: qlvlxd
Collation: utf8mb4_unicode_ci

Bước 4 — Mở trình cài đặt

Truy cập:

http://qlvlxd.test

Tại bước cấu hình cơ sở dữ liệu, nhập:

Nếu tên miền .test không hoạt động

Thực hiện một trong hai cách:

Laragon → Apache → Reload

hoặc bật:

Menu → Preferences → Auto virtual hosts

3. CÀI ĐẶT TRÊN SHARED HOSTING

Áp dụng cho:

• cPanel;

• DirectAdmin;

• Plesk;

• Các hosting PHP/MySQL tương thích.

Quá trình cài đặt gồm 4 bước chính.

Bước 1 — Tải mã nguồn

Mở File Manager và tạo thư mục bên ngoài public_html.

Ví dụ:

/home/taikhoan/qlvlxd/

Tải file ZIP lên và chọn Extract.

Khuyến nghị bảo mật

Nên đặt mã nguồn bên ngoài public_html để các file cấu hình và mã nguồn nội bộ không nằm trực tiếp trong vùng có thể truy cập từ Internet.

Bước 2 — Cấu hình Document Root

Đây là bước đặc biệt quan trọng.

Document Root phải trỏ đến:

/home/taikhoan/qlvlxd/public

Cấu hình đúng

.../qlvlxd/public

Không nên cấu hình

.../qlvlxd

⚠️ CẢNH BÁO BẢO MẬT

Trỏ sai Document Root có thể khiến .env — nơi chứa thông tin kết nối cơ sở dữ liệu và khóa mã hóa — nằm trong vùng web.

File .htaccess đi kèm chỉ đóng vai trò bảo vệ bổ sung và không thay thế việc cấu hình Document Root đúng cách.

Bước 3 — Tạo cơ sở dữ liệu

Trong MySQL Databases, thực hiện đủ 3 thao tác:

1. Create New Database

2. Add New User

3. Add User To Database → ALL PRIVILEGES

Ví dụ:

Database: taikhoan_qlvlxd
User:     taikhoan_vlxd
Password: ************

Lưu ý: Việc quên gán User vào Database là một trong những nguyên nhân phổ biến khiến trình cài báo lỗi kết nối dù tên đăng nhập và mật khẩu chính xác.

Hãy lưu lại:

• Tên cơ sở dữ liệu;

• Tên người dùng;

• Mật khẩu.

Hosting thường tự thêm tiền tố tài khoản. Hãy sử dụng đầy đủ tên có tiền tố.

Bước 4 — Chạy trình cài đặt

Mở tên miền của phần mềm.

Trình cài đặt eBuildFlow Pro sẽ tự động xuất hiện.

Ở phần cấu hình CSDL, thông thường sử dụng:

Máy chủ CSDL: localhost

Sau đó tiếp tục theo hướng dẫn trên màn hình.

4. TRÌNH CÀI ĐẶT TỰ ĐỘNG 4 BƯỚC

eBuildFlow Pro cung cấp trình cài đặt trực quan gồm:

Bước 1 — Kiểm tra môi trường

Hệ thống tự động kiểm tra:

• Phiên bản PHP;

• PHP Extensions;

• Quyền ghi thư mục;

• Các điều kiện cần thiết khác.

Nếu phát hiện lỗi, hệ thống hiển thị vị trí và hướng dẫn xử lý.

Bước 2 — Kết nối cơ sở dữ liệu

Nhập:

• Máy chủ;

• Cổng;

• Tên cơ sở dữ liệu;

• Tài khoản;

• Mật khẩu.

Hệ thống kiểm tra kết nối trước khi lưu cấu hình.

Bước 3 — Khởi tạo doanh nghiệp

Khai báo:

• Tên doanh nghiệp;

• Tài khoản quản trị;

• Mật khẩu;

• Dữ liệu ban đầu.

Bước 4 — Hoàn tất

Hệ thống:

• Hoàn thành cấu hình;

• Ghi nhận trạng thái đã cài đặt;

• Khóa trình cài đặt.

Sau khi hoàn tất, đường dẫn cài đặt sẽ không còn được phép truy cập.

5. LỰA CHỌN DỮ LIỆU BAN ĐẦU

eBuildFlow Pro cung cấp 3 chế độ:

⚠️ Quan trọng: Dữ liệu dùng thử chỉ dành cho mục đích trải nghiệm. Không nên sử dụng để vận hành chính thức.

6. VIỆC CẦN LÀM SAU KHI CÀI ĐẶT

1. Hoàn thiện thông tin doanh nghiệp

Truy cập:

Hệ thống → Cài đặt

Khai báo:

• Mã số thuế;

• Địa chỉ;

• Điện thoại;

• Tài khoản ngân hàng;

• Logo;

• Thông tin chứng từ.

2. Tạo tài khoản nhân viên

Truy cập:

Hệ thống → Nhân viên

Mỗi nhân viên nên có một tài khoản riêng và được cấp đúng quyền.

Không nên dùng chung tài khoản vì sẽ làm giảm giá trị của chức năng nhật ký thao tác.

3. Kiểm tra sao lưu

Truy cập:

Hệ thống → Sao lưu dữ liệu → Sao lưu ngay

Sau đó tải bản sao lưu về máy để kiểm tra.

4. Kiểm tra bảo mật .env

Thử truy cập:

tenmien.com/.env

Kết quả phải là:

403 Forbidden

hoặc:

404 Not Found

Tuyệt đối không được hiển thị nội dung .env.

7. KHẮC PHỤC SỰ CỐ THƯỜNG GẶP

Trang trắng hoặc lỗi 500

Kiểm tra quyền ghi của:

storage/
bootstrap/cache/
public/tai-len/

Ưu tiên quyền:

755

Nếu máy chủ yêu cầu:

775

Có thể xem nhật ký lỗi tại:

storage/logs/laravel.log

Hiển thị danh sách file thay vì phần mềm

Nguyên nhân: Document Root đang trỏ sai.

Cách xử lý: Đảm bảo Document Root trỏ vào:

qlvlxd/public

Không kết nối được cơ sở dữ liệu

Kiểm tra lần lượt:

1. User đã được gán vào Database chưa?

2. Tên Database/User có thiếu tiền tố hosting không?

3. Thử đổi localhost ↔ 127.0.0.1.

Không tìm thấy cơ sở dữ liệu

Hãy tạo Database trước khi chạy trình cài.

Trình cài đặt không tự tạo Database trên các hosting không cấp quyền này.

Giao diện bị vỡ hoặc mất CSS

Kiểm tra thư mục:

public/build

Nếu thiếu, cần sử dụng lại gói cài đặt đầy đủ.

Lỗi khi sao lưu

eBuildFlow Pro có thể tự chuyển phương thức sao lưu khi máy chủ không cho phép sử dụng mysqldump.

Nếu vẫn xảy ra lỗi, kiểm tra quyền ghi:

storage/app/sao-luu/

8. NÂNG CẤP PHIÊN BẢN

Trước khi nâng cấp:

Bước 1 — Sao lưu

Hệ thống → Sao lưu dữ liệu → Sao lưu ngay

Tải bản sao lưu về máy.

Bước 2 — Lưu riêng dữ liệu quan trọng

Sao chép:

.env
public/tai-len/
storage/app/sao-luu/

Bước 3 — Cập nhật mã nguồn

Giải nén phiên bản mới vào thư mục cài đặt.

Bước 4 — Khôi phục các file riêng

Chép lại các dữ liệu đã lưu ở bước 2.

Bước 5 — Cập nhật cơ sở dữ liệu

Nếu có quyền SSH:

php artisan migrate --force

⚠️ Luôn sao lưu dữ liệu trước khi nâng cấp.

9. CÀI ĐẶT TRÊN VPS

Đối với máy chủ có SSH:

cd /var/www
unzip qlvlxd-1.0.0.zip -d qlvlxd
cd qlvlxd

chown -R www-data:www-data storage bootstrap/cache public/tai-len
chmod -R 775 storage bootstrap/cache public/tai-len

Document Root của Apache/Nginx phải trỏ đến:

/var/www/qlvlxd/public

Sau khi cấu hình web server, mở tên miền và thực hiện Trình cài đặt 4 bước như bình thường.

10. CHECKLIST SAU CÀI ĐẶT

• Website truy cập bình thường

• Document Root trỏ đúng thư mục public/

• File .env không thể truy cập từ Internet

• Đăng nhập được tài khoản quản trị

• Đã cập nhật thông tin doanh nghiệp

• Đã tạo tài khoản riêng cho nhân viên

• Phân quyền người dùng chính xác

• Upload logo/ảnh hoạt động bình thường

• Sao lưu dữ liệu thành công

• Đã tải ít nhất một bản sao lưu về máy

• Nhật ký hoạt động ghi nhận bình thường

HOÀN TẤT

Sau khi hoàn thành checklist trên, eBuildFlow Pro đã sẵn sàng để đưa vào sử dụng.

eBuildFlow Pro
Quản lý dòng hàng – Kiểm soát dòng tiền – Phát triển bền vững.