O24Platform 2.2.19

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package O24Platform --version 2.2.19
                    


                    

                
NuGet\Install-Package O24Platform -Version 2.2.19
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="O24Platform" Version="2.2.19" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="O24Platform" Version="2.2.19" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="O24Platform" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add O24Platform --version 2.2.19
                    


                    

                
#r "nuget: O24Platform, 2.2.19"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package O24Platform@2.2.19
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=O24Platform&version=2.2.19
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=O24Platform&version=2.2.19
                    


                            Install as a Cake Tool

O24Platform

Nền tảng thư viện dùng chung cho các dự án O24 — hỗ trợ Open API, workflow, queue (RabbitMQ), migration đa database, logging và tích hợp microservice.

Cài đặt

dotnet add package O24Platform

Cấu hình nhanh

Thêm section O24OpenAPIConfiguration vào App_Data/appsettings.json (hoặc secret store tương ứng):

"O24OpenAPIConfiguration": {
  "YourServiceID": "MS1",
  "IsMicroservice": true,
  "ConnectToWFO": true,
  "WFOGrpcURL": "https://wfo.example.com",
  "YourGrpcURL": "https://your-service.example.com"
}
  • IsMicroservice = false: tắt queue, RabbitMQ event bus consumer và đăng ký WFO — phù hợp service standalone/API thuần.
  • IsMicroservice = true (mặc định): giữ hành vi microservice mesh như trước.

Release Notes

2.2.19 — 2026-08-06

  • CodeList filter theo CodeId

  • Bổ sung field CodeId vào GetCodeListByGroupAndNameQuery và CodeListGroupAndNameRequestModel.

  • GET_CODE_LIST_BY_GROUP_AND_NAME hỗ trợ lọc danh sách theo tiền tố CodeId.

  • CodeListService.GetByGroupAndName hỗ trợ cùng cơ chế lọc theo CodeId.

  • Việc lọc không phân biệt chữ hoa/chữ thường.

  • CodeId là tham số tùy chọn:

  • Không truyền, truyền null, chuỗi rỗng hoặc khoảng trắng → bỏ qua điều kiện lọc.

  • Truyền giá trị, ví dụ HPH → trả về các mã bắt đầu bằng HPH, như HPH07059, HPH07062, HPH07068, HPH08003.

  • Bổ sung kiểm tra CodeId khác null trước khi thực hiện StartsWith, tránh lỗi với dữ liệu không có mã.

Ví dụ request:

{
  "code_id": "HPH",
  "page_index": 0,
  "page_size": 20
}

2.2.18 — 2026-08-05

DI, EngineContext và AsyncScope

  • IEngine.CreateScope(WorkContextTemplate?) và CaptureWorkContextSnapshot() — snapshot WorkContext từ AsyncScope → HTTP → ambient scope (xử lý scope đã dispose).
  • AsyncScope: TryGetServiceProvider(), Reset() (chỉ xóa pointer) vs Clear() (dispose + reset); bỏ property ServiceProvider dễ NRE.
  • TaskUtils / TransactionDispatcher: capture snapshot trên thread gọi, CreateScope, restore ambient trong finally.
  • QueueClient (command/event): CreateScope(template); dispose scope message + restore/Reset ambient (không Clear() kèm using).
  • StartEngine: khôi phục AsyncScope sau migration/queue init (tránh trỏ scope đã dispose).
  • Ghi chú trên EngineContext.Current: ưu tiên constructor DI; locator chỉ khi bắt buộc.

Health & runtime

  • MapO24HealthEndpoints: GET /api/health/ping, GET /api/health/info (version, uptime, … qua IAppRuntimeInfoProvider).
  • Startup banner dùng runtime info khi có.

Logging HTTP

  • RestApiLoggingMiddleware: giới hạn kích thước body log, redact header, LogSanitizer; inject WorkContext.
  • CorrelationIdMiddleware: tôn trọng header X-Correlation-ID.
  • Cấu hình qua section Logging (LoggingConfig).

Event bus & queue

  • IEventBus.PublishAsync(eventName, payload) — publish theo tên + object, không bắt buộc deserialize IntegrationEvent.
  • RabbitMQEventBus / NoOpEventBus cập nhật tương ứng.

Data & cache

  • Migration PlatformEntityIndexesMigration: index hiệu năng (không unique) cho entity platform (ví dụ LocaleStringResource, audit, CDC config, …).
  • DistributedCacheManager.ClearAll(): xóa theo key đã track, không dùng Redis KEYS *.

Startup

  • CreateDatabaseAsync() gọi trong StartEngine (async), bỏ .Wait() trên request pipeline.

Gợi ý dùng EngineContext (khi không inject được DI)

  1. Request API: EngineContext.Current.Resolve<T>() thường ổn (ưu tiên HttpContext.RequestServices).
  2. Background: CaptureWorkContextSnapshot() trên caller → using var scope = EngineContext.Current.CreateScope(snapshot) → restore ambient; hoặc TaskUtils.RunAsync / RunInNewScope.
  3. Không gọi AsyncScope.Clear() trong finally nếu scope đã Dispose() bằng using/biến local.

2.2.17 — 2026-07-31

JSON static files (sandbox theo thư mục cấu hình)

  • IJsonStaticFileService: search / get / update file .json trong RootPath; chặn path traversal và path ngoài root.
  • Extension DI: AddJsonStaticFileService — root từ O24OpenAPIConfiguration.JsonStaticFileRootPath (mặc định ./StaticConfig).
  • CQRS (MediatorKey = "fw"):
    • POST api/json-static-files/search
    • POST api/json-static-files/get
    • POST api/json-static-files/update

O24Resource / localization

  • Bổ sung mã lỗi dùng chung (vi/en): NotFound, NotExists, InvalidInput, path/file/JSON validation, unique/conflict, … — cùng format class phẳng như các hằng validation hiện có.
  • Migration O24ResourceMigration seed resource mới qua BaseResourceMigration.

Ví dụ đăng ký host (RootPath lấy từ O24OpenAPIConfiguration.JsonStaticFileRootPath):

"O24OpenAPIConfiguration": {
  "JsonStaticFileRootPath": "./StaticConfig"
}

builder.AddJsonStaticFileService();

2.2.16 — 2026-07-24

Connection string password decrypt / escape theo DataProvider

  • DataConfig.DecryptConnectionString escape password theo từng DataProvider (Oracle / SqlServer / MySql / PostgreSQL).
  • Oracle: không bọc single-quote (tránh ORA-01017 với Oracle.ManagedDataAccess.Core 23.x); chỉ double-quote khi password có delimiter.
  • SqlServer: single-quote khi cần; MySQL / PostgreSQL: double-quote khi cần.
  • Đổi DataProvider sẽ invalidate cache decrypted connection string.

2.2.15 — 2026-07-23

Stored procedure workflow V2

  • Thêm ProcessNumber.StoredProcedureV2 (6).
  • O24OpenAPIServiceManager hỗ trợ luồng HandleStoredProcedureWorkflowV2 khi processing_version = StoredProcedureV2.
  • BaseQueue bổ sung CallStoredProcedureV2 và chuẩn hóa response data (snake_case) cho stored procedure V2.

2.2.14 — 2026-07-22

WorkContext scope

  • Thêm WorkContext.Scope / WorkContextTemplate.Scope và SetScope.
  • Thêm abstraction IScopeHandler để service tự implement xử lý scope.
  • O24OpenAPIServiceManager gọi IScopeHandler.HandleScope() trước khi execute workflow khi Scope có giá trị.

2.2.13 — 2026-07-22

CodeList CQRS / WorkflowStep

  • Thêm feature cho domain C_CODELIST (LinKit CQRS + [WorkflowStep]):
    • GET_CODE_LIST_BY_GROUP_AND_NAME
    • GET_CODE_LIST_BY_ID
    • CREATE_CODE_LIST
    • UPDATE_CODE_LIST
    • DELETE_CODE_LIST
  • Response dùng CodeListResponseModel; caption resolve theo Language qua CodeListUtils.

Platform WorkflowStepInvoker

  • Thêm O24Analyzer để gen WorkflowStepInvoker trong assembly O24Platform.
  • Đăng ký IWorkflowStepInvoker keyed "fw" cùng AddLinKitCqrs("fw") — service dùng platform có thể invoke step CodeList qua mediator key fw.

2.2.12 — 2026-07-21

Read/write database split (read replica)

  • Thêm cấu hình opt-in trên ConnectionStrings (DataConfig):
    • UseReadReplica: bật dùng read replica.
    • ReadConnectionString: connection string replica (decrypt giống ConnectionString).
    • Khi tắt hoặc thiếu read string → toàn bộ traffic vẫn đi primary (backward compatible).
  • IDataConnectionFactory hỗ trợ DbAccessMode (Write | Read):
    • Query dùng read khi replica được bật.
    • Trong transaction (command / TransactionBehavior) luôn force Write để đảm bảo read-your-writes.
  • BaseRepository tách connection theo thao tác:
    • Đọc (Table, Get*, Count, Search*) → Read.
    • Ghi (Insert / Update / Delete / bulk / audit) và mutate-by-query (WriteTable, WriteTableFilter) → Write.

Ví dụ cấu hình:

"ConnectionStrings": {
  "ConnectionString": "...",
  "ReadConnectionString": "...",
  "UseReadReplica": true
}

2.2.11 — 2026-07-20

Event Dispatching

  • Hỗ trợ tham số mediatorKey trong IEventDispatcher.DispatchAsync và LinKitEventDispatcher để resolve IMediator instance theo tên (hỗ trợ sử dụng multi-mediator).

2.2.10 — 2026-07-19

Multi-database execution trên ServiceDBContext

  • Bật đầy đủ EF Core provider cho SQL Server, PostgreSQL, MySQL/MariaDB và Oracle trong OnConfiguring (theo DataConfig.DataProvider / RDBMSType).
  • Thống nhất execute SQL, query, DML, paged query và stored procedure qua dialect helpers (SqlServer | PostgreSQL | MySql | Oracle):
    • Parameter prefix (@ / :), identifier quoting ([] / "" / `), LIKE concat.
    • Schema switch: USE / SET search_path / ALTER SESSION SET CURRENT_SCHEMA.
    • Workflow SP: EXEC / CALL / BEGIN … END với output parameter chung.
  • Thêm package Npgsql.EntityFrameworkCore.PostgreSQL, Pomelo.EntityFrameworkCore.MySql; cập nhật EF Core 9.0.1, MySqlConnector 2.4.0.

2.2.9 — 2026-07-19

Microservice opt-out

  • Thêm O24OpenAPIConfiguration.IsMicroservice (mặc định true) để xác định service có tham gia hệ thống microservice hay không.
  • Khi IsMicroservice = false:
    • Không khởi tạo QueueClient, không gọi WFO QueryServiceInfo, không chạy reconnect scheduler.
    • Không đăng ký RabbitMQEventBus consumer; dùng NoOpEventBus cho IEventBus.
    • Bỏ qua SyncProjectCodeAsync và InitializeMessageQueue.
    • Startup banner hiển thị Queue Status: DISABLED.

Bug fix

  • CodeListService.GetByGroupAndName: trả về thêm field MCaption trong kết quả phân trang.

2.2.8 — 2026-07-17

  • Bổ sung interface và implementation xử lý event.
  • Refactor quản lý domain events.

2.2.6 — 2026-07-16

  • Thêm ProjectCode vào O24OpenAPIConfiguration.
  • Đồng bộ project code từ WFO qua SyncProjectCodeAsync.

2.2.x (trước 2.2.6)

  • Chuẩn hóa pagination (PageIndex, offset) trên PagedList và ServiceDBContext.
  • RabbitMQ event bus với partition-based dispatch.
  • Data provider abstraction (SQL Server, Oracle, MySQL, PostgreSQL) và migration infrastructure.
  • Workflow step source generator, O24OpenAPIServiceManager, logging Serilog, schedule tasks.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on O24Platform:

Package Downloads
O24Kit

Bộ Kit cho O24OpenAPI (Keyvault, Signature, Models...)

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.2.19 0 8/6/2026
2.2.18 64 8/5/2026
2.2.17.6 50 8/4/2026
2.2.17.5 63 8/3/2026
2.2.17.4 52 8/3/2026
2.2.17.3 73 7/31/2026
2.2.17.2 58 7/31/2026
2.2.17.1 59 7/31/2026
2.2.17 49 7/31/2026
2.2.16.7 74 7/27/2026
2.2.16.6 71 7/26/2026
2.2.16.5 61 7/25/2026
2.2.16.4 55 7/25/2026
2.2.16.3 53 7/25/2026
2.2.16.2 63 7/25/2026
2.2.16.1 57 7/25/2026
2.2.16 61 7/24/2026
2.2.15 70 7/23/2026
2.2.14 70 7/22/2026
2.2.13 57 7/22/2026
Loading failed

2.2.19: Bổ sung lọc CodeList theo CodeId cho CQRS và CodeListService; hỗ trợ tìm theo tiền tố, không phân biệt hoa thường; CodeId là tham số tùy chọn, không truyền, null hoặc rỗng thì bỏ qua điều kiện lọc.