Phiên bản CalVer

Bắt đầu từ phiên bản 2026.3.0, iSPA CMS sử dụng Calendar Versioning (CalVer) thay cho Semantic Versioning (SemVer).

Định dạng

YYYY.MM.PATCH

Ví dụ: 2026.03.0 — phát hành tháng 3 năm 2026, bản gốc.

Phiên bản cấp ứng dụng

File VERSION ở thư mục gốc dự án là nguồn mà cms:version và cấu hình ứng dụng đọc để báo phiên bản cấp CMS.

2026.03.0

Giá trị này được đọc trực tiếp bởi:

• config('ispa-cms.app_version') — config Laravel
• php artisan cms:version — phiên bản ứng dụng, PHP và Laravel

module.json và composer.json của từng module là metadata riêng. Lệnh cms:bump có thể đồng bộ chúng theo VERSION, nhưng không nên mặc định rằng mọi module trong working tree luôn đang cùng phiên bản.

Bump phiên bản

Sử dụng lệnh cms:bump để tăng phiên bản đồng loạt:

# Tăng patch
php artisan cms:bump patch

# Tháng mới
php artisan cms:bump minor

# Xem trước
php artisan cms:bump patch --dry-run

Files được cập nhật

Khi bump, lệnh sẽ cập nhật:

1. VERSION — file gốc
2. Mọi cms/*/module.json khớp glob — trường version
3. Mọi cms/*/composer.json khớp glob — trường version

Tại sao CalVer?

• Dễ hiểu: Nhìn phiên bản biết ngay thời điểm phát hành.
• Phù hợp với CMS: iSPA CMS phát hành liên tục, không theo chu kỳ major/minor truyền thống.
• Có công cụ đồng bộ: cms:bump có thể đưa mọi manifest/composer module khớp glob về cùng version trong một release đã duyệt.
• Được sử dụng rộng rãi: Ubuntu, pip, nhiều dự án lớn dùng CalVer.

So sánh với SemVer