Giới thiệu Govex Cloud
Govex Cloud là bộ thư viện nền tảng cho các service Spring Boot trong hệ sinh thái Govex Cloud. Các dependency được phát hành dưới dạng Maven artifact với groupId vn.govex.cloud, đóng gói theo dạng Spring Boot starter/auto-configuration: chỉ cần thêm dependency vào classpath là bean, cấu hình mặc định và tiện ích đi kèm được kích hoạt tự động.
Bản hiện tại: 1.0.0-SNAPSHOT, version được quản lý tập trung một lần qua property ${revision} của BOM.
Các nhóm tính năng
Bộ thư viện chia theo năng lực hạ tầng thành các nhóm dưới đây. Artifact đầy đủ có tiền tố govex-cloud-, ví dụ vn.govex.cloud:govex-cloud-common.
| Nhóm | Dependency |
|---|---|
| Nền tảng dùng chung | common, core, config, error, validation, crypto |
| Truy cập dữ liệu | data-jpa, data-audit, data-revision, data-permission, data-elasticsearch, datasource, liquibase |
| Bảo mật & định danh | security, iam, idp, oauth2, lock, log |
| Tích hợp & thông báo | feign, mq, mail, sms, notification, oss |
| Hạ tầng runtime | cache, transaction, dynamic, sqlparser |
| Web & API | api, apidoc, application, web, mapstruct, mapstruct-processor, apt |
| Tài liệu & quy trình | aspose, onlyoffice, template, workflow |
Mỗi nhóm có một mục riêng trên thanh tài liệu; mỗi dependency có trang hướng dẫn cài đặt, cấu hình và sử dụng chi tiết.
Mục đích
- Chuẩn hoá hạ tầng dùng chung: mỗi dependency đóng gói một năng lực hạ tầng (dữ liệu, bảo mật, tích hợp, cache, tài liệu, quy trình...) theo cùng một quy ước.
- Tích hợp nhanh: nhờ cơ chế Spring Boot auto-configuration, ứng dụng chỉ cần thêm dependency — không phải khai báo bean thủ công.
- Quản lý version tập trung: toàn bộ version dependency/plugin do BOM
vn.govex.cloud:dependenciesquản lý, ứng dụng thêm dependency không cần ghi version.
Yêu cầu môi trường
| Thành phần | Yêu cầu |
|---|---|
| JDK | 17 trở lên (khuyến nghị JDK 21) |
| Spring Boot | 3.5.x |
| Maven | 3.8+ |
Nền tảng được xây dựng trên Spring Boot 3.5.7 và Spring Cloud 2025.0.0. BOM có maven-enforcer-plugin chặn build khi JDK/Maven thấp hơn phiên bản tối thiểu.
Để bắt đầu tích hợp, xem tiếp Cài đặt & tích hợp và Cấu hình chung.