IMEX.CORE 1.0.2.11

IMEX.CORE

Giới thiệu

IMEX.CORE là một dự án phần mềm mạnh mẽ được xây dựng trên nền tảng .NET Core, cung cấp các chức năng quản lý cơ sở dữ liệu, xử lý log, mã hóa dữ liệu, và quản lý quyền truy cập hiệu quả. Dự án được thiết kế để hỗ trợ phát triển các ứng dụng web hiện đại với tính mở rộng cao và hiệu suất tốt.

Tính năng

• Quản lý Logging: Hỗ trợ ghi log đồng thời, dễ dàng cấu hình và mở rộng với nhiều loại log khác nhau như AOPLogEx, RequestIpInfoLog, RecordAccessLogs, SqlLog, và RequestResponseLog.

• Xử lý File: Cung cấp các tiện ích để đọc, ghi, xóa, sao chép, và lưu files một cách dễ dàng và an toàn.

• Migration Database: Hỗ trợ migration cơ sở dữ liệu và seeding dữ liệu tự động, đảm bảo cấu trúc dữ liệu luôn cập nhật.

• API Response: Cấu trúc trả về API linh hoạt với các mã trạng thái và thông báo chi tiết, giúp dễ dàng quản lý và xử lý phản hồi.

• Chuyển đổi số và ký tự: Các công cụ chuyển đổi số thành chữ bằng tiếng Việt, mã hex và Unicode, hỗ trợ đa dạng hóa xử lý dữ liệu.

• Quản lý Quyền Truy Cập: Hệ thống quản lý quyền truy cập linh hoạt, sử dụng phép toán bit để xác định quyền hạn của người dùng.

• Bảo Mật: Triển khai các phương thức mã hóa và giải mã dữ liệu an toàn với RSA và SM4, đảm bảo bảo mật thông tin truyền tải.

• Kết nối database sử dụng SqlSugar ORM: Cấu hình kết nối trong file appsetting.json.

  "MainDB": "DB_Main",// Db chính có ConnId = DB_Main
  "MultiDBEnabled": true,
  "DBConnections": [
     {
       "ConnId": "configID",
       "DBType": 1,
       "Enable": true,
       "HitRate": 50,
       "ConnectionStr": "Data Source=(localdb);Initial Catalog=WMBLOG_MSSQL_2;Integrated Security=True;Connect Timeout=30;Encrypt=False;TrustServerCertificate=False;ApplicationIntent=ReadWrite;MultiSubnetFailover=False",
       "ProviderName": "System.Data.SqlClient",
        "Slaves": [
         {
           "HitRate": 0, //Độ ưu tiên，giá trị càng cao thì độ ưu tiên càng cao, nếu = 0 thì không sử dụng
           "Connection": "Data Source=MSSQLLocalDB;Initial Catalog=WMBLOG_MSSQL_2;Integrated Security=True;Connect Timeout=30;Encrypt=False;TrustServerCertificate=False;ApplicationIntent=ReadWrite;MultiSubnetFailover=False"
         }
       ]
     }]
  

Cài đặt và Cấu hình

Yêu cầu

• .NET SDK phiên bản 8.0 hoặc cao hơn.
• Hệ điều hành Windows, macOS hoặc Linux.

Cài đặt

1. GET nuget

   NuGet\Install-Package IMEX.CORE -Version 1.0.2.10
   paket add IMEX.CORE --version 1.0.2.10
   

Cấu hình

Các cấu hình cần thiết được lưu trữ trong các file cấu hình như appsettings.json. Đảm bảo thiết lập đúng các mục như kết nối database, cấu hình log, và các thiết lập API.

Sử dụng

Dự án cung cấp các lớp helper và extension để dễ dàng tích hợp vào các phần khác của ứng dụng. Một số tính năng chính bao gồm:

• Logging: Sử dụng LogHelper để ghi log với các cấp độ khác nhau.
• File Handling: Sử dụng FileHelper để quản lý các thao tác file như đọc, ghi, xóa, và sao chép.
• Database Migration: Sử dụng MigrationDB để thực hiện các thao tác migration và seeding dữ liệu.
• API Response: Sử dụng ApiResponse và MessageModel để chuẩn hóa phản hồi từ API.
• Quản lý Quyền: Định nghĩa và kiểm tra quyền truy cập thông qua các lớp trong Core/Global.