Cài đặt & triển khai

Yêu cầu hệ thống

Trước khi cài đặt, cần chuẩn bị:

• Windows Server hoặc Windows 10 trở lên.
• Microsoft SQL Server đã cài đặt và hoạt động.
• .NET 8 Hosting Bundle hoặc .NET 8 Runtime.
• Tài khoản có quyền tạo database trên SQL Server.

Chuẩn bị thư mục triển khai

1. Giải nén hoặc chép thư mục publish lên máy đích.
2. Đặt thư mục tại vị trí cố định, ví dụ:

D:/apps/WarehouseManagement

💡

Gợi ý

Nên đặt ứng dụng trong thư mục riêng, tránh đặt trực tiếp ở Desktop hoặc Downloads để dễ quản lý khi cập nhật phiên bản.

Tạo cơ sở dữ liệu lần đầu

1. Mở SQL Server Management Studio hoặc sqlcmd.
2. Chạy file script:

docs/database-script.sql

3. Kiểm tra database đã được tạo thành công:

WarehouseManagementDb

Cấu hình kết nối database

1. Mở file appsettings.json trong thư mục publish.
2. Tìm cấu hình ConnectionStrings:DefaultConnection.
3. Cập nhật thông tin kết nối SQL Server.

Ví dụ dùng SQL Login:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=TEN_SERVER;Database=WarehouseManagementDb;User Id=sa;Password=MatKhau;TrustServerCertificate=True;"
  }
}

⚠️

Lưu ý bảo mật

Không nên sử dụng mật khẩu ví dụ trong môi trường thật. Hãy dùng tài khoản SQL riêng cho ứng dụng và cấp quyền vừa đủ.

Chạy ứng dụng trực tiếp bằng dotnet

1. Mở terminal tại thư mục publish.
2. Chạy lệnh:

dotnet WarehouseManagement.dll

3. Truy cập URL được hiển thị trong terminal.

Tài khoản mặc định lần đầu

🔐

Bắt buộc khuyến nghị

Sau khi đăng nhập thành công lần đầu, hãy đổi mật khẩu mặc định ngay.

Triển khai qua IIS

1. Cài .NET 8 Hosting Bundle trước khi cấu hình IIS.
2. Mở IIS Manager.
3. Tạo website mới và trỏ tới thư mục publish.
4. Cấp quyền đọc/ghi cần thiết cho App Pool Identity.
5. Bind domain hoặc port theo nhu cầu.
6. Truy cập website để kiểm tra.

Cập nhật phiên bản mới

1. Dừng ứng dụng hoặc recycle App Pool.
2. Sao lưu thư mục publish hiện tại.
3. Ghi đè bằng bản publish mới.
4. Nếu có thay đổi schema, chạy SQL script mới nhất.
5. Khởi động lại ứng dụng.
6. Kiểm tra đăng nhập, dashboard và nghiệp vụ chính.

Kiểm tra sau cài đặt

Sau khi cài đặt, nên kiểm tra theo checklist sau:

• Đăng nhập bằng tài khoản admin.
• Đổi mật khẩu mặc định.
• Mở Dashboard.
• Kiểm tra các menu danh mục.
• Tạo thử một phiếu nhập.
• Xác nhận phiếu nhập và kiểm tra tồn kho đã tăng đúng.
• Tạo thử một phiếu xuất nếu có dữ liệu tồn.
• Kiểm tra báo cáo tồn kho.

Xử lý lỗi thường gặp