Vhat.Core 10.27.440

Core Library - Vhat System

<div align="center">

Bộ thư viện tập trung các thành phần dùng chung cho các dịch vụ .NET

Tính năng • Cài đặt • Sử dụng • Tài liệu • Đóng góp

</div>

📋 Giới thiệu

Core Library là bộ thư viện nền tảng của Viet Hung Automation Technology, cung cấp các thành phần và utilities dùng chung cho các dịch vụ .NET. Dự án được xây dựng trên .NET 10.0 với kiến trúc 2-layer (Core + Infrastructure) và tích hợp đầy đủ CI/CD pipeline thông qua GitHub Actions.

✨ Tính năng

Core Components

• Caching: Multi-layer caching với Redis và Memory cache, hỗ trợ tag-based invalidation
• Data Access: Bulk operations, connection pooling, retry policies với Polly
• Message Queue: RabbitMQ integration với reliable messaging patterns
• Object Storage: MinIO/S3 compatible storage service
• Search: Elasticsearch integration cho full-text search
• Security: RSA encryption, JWT handling, secure utilities
• Monitoring: InfluxDB integration, health checks, performance metrics
• Logging: Structured logging với Serilog

Architecture

• 2-Layer Design: Vhat.Core (abstractions) + Vhat.Infrastructure (implementations)
• Dependency Injection: Primary constructor pattern
• Async/Await: Toàn bộ I/O operations sử dụng async
• Entity Pattern: BaseEntity với ULID (26 chars, sortable)
• Interface-First: Mọi service đều có interface tương ứng

🚀 Trạng thái dự án

📁 Cấu trúc dự án

core-lib/
├── src/
│   ├── Vhat.Core/              # Core abstractions & entities
│   │   ├── Entities/           # BaseEntity, domain models
│   │   ├── Interfaces/         # Service interfaces
│   │   └── Extensions.cs       # Core extension methods
│   └── Vhat.Infrastructure/    # Concrete implementations
│       ├── Caching/            # Redis & Memory cache
│       ├── Data/               # Data access layer
│       ├── MessageQueue/       # RabbitMQ services
│       ├── ObjectStore/        # MinIO storage
│       ├── Search/             # Elasticsearch
│       ├── Security/           # Encryption & auth
│       └── Monitoring/         # Metrics & health checks
├── tests/
│   ├── Vhat.UnitTests/        # Unit tests (xUnit)
│   └── Vhat.Benchmarks/       # Performance benchmarks
└── tools/
    └── Vhat.Tool/             # CLI development tools

📦 Cài đặt

NuGet Packages

# Core package (entities, interfaces, utilities)
dotnet add package Vhat.Core

# Infrastructure package (implementations)
dotnet add package Vhat.Infrastructure

Yêu cầu hệ thống

• .NET 10.0 SDK trở lên
• Visual Studio 2022 hoặc VS Code với C# extension
• Docker (tùy chọn - cho Redis, MongoDB, SQL Server local)

💻 Sử dụng nhanh

1. Cấu hình Dependency Injection

// Program.cs
var builder = WebApplication.CreateBuilder(args);

// Đăng ký services
builder.Services.AddVhatCore();
builder.Services.AddVhatInfrastructure(builder.Configuration);

var app = builder.Build();

2. Sử dụng Caching Service

public class MyService(IHybridRedisCacheService cache)
{
    public async Task<User> GetUserAsync(string userId)
    {
        var cacheKey = $"user:{userId}";

        return await cache.GetOrSetAsync(
            cacheKey,
            async () => await _repository.GetUserAsync(userId),
            TimeSpan.FromMinutes(30)
        );
    }
}

3. Sử dụng Data Access

public class UserRepository(ICoreData coreData)
{
    public async Task<IEnumerable<User>> GetAllAsync()
    {
        return await coreData.SelectAsync<User>(
            "SELECT * FROM Users WHERE IsActive = @IsActive",
            new { IsActive = true }
        );
    }

    public async Task BulkInsertAsync(IEnumerable<User> users)
    {
        await coreData.BulkInsertAsync(users);
    }
}

Xem thêm ví dụ chi tiết trong API.md.

📚 Tài liệu

🤝 Đóng góp

Chúng tôi chào đón mọi đóng góp! Vui lòng đọc CONTRIBUTING.md để biết:

• Quy trình phát triển và pull request
• Coding conventions và best practices
• Branching strategy
• Testing requirements

Để báo cáo lỗi hoặc đề xuất tính năng, xem ISSUES.md.

🔐 Bảo mật

Nếu phát hiện lỗ hổng bảo mật, KHÔNG tạo public issue. Vui lòng liên hệ trực tiếp:

• Email: phivanloi@outlook.com
• Điện thoại: 0588953888

Xem thêm chi tiết trong SECURITY.md.

📄 Giấy phép

Copyright © 2020-2025 Viet Hung Automation Technology. All rights reserved.

Dự án này sử dụng giấy phép độc quyền (proprietary). Mã nguồn chỉ được sử dụng cho mục đích nội bộ và các bên được cấp phép. Xem LICENSE để biết thêm chi tiết.

📞 Liên hệ

• Tổ chức: Viet Hung Automation Technology
• Người phụ trách: Phí Văn Lời
• Email: phivanloi@outlook.com
• Phone: 0588953888
• Repository: github.com/vhatsystem/core-lib

<div align="center"> Made with ❤️ by Viet Hung Automation Technology </div>