KDIGI CMS

KDIGI CMS

Mã nguồn mở: giấy phép MIT, kho mã và đóng góp

Giấy phép MIT: dùng, sửa, phân phối và bán lại, kể cả cho dự án thương mại.

Cập nhật lần cuối:

Cây nhánh mã nguồn mở và ổ khoá mở bằng kính mờ trên đế đất sét, minh họa giấy phép MIT của KDIGI CMS

KDIGI CMS là CMS headless nhiều website, phát hành theo giấy phép MIT (bản quyền 2026 KDIGI). Mã nguồn công khai tại github.com/kdigivn/kdigi-cms-open, xây trên Payload 3, Next.js 15 và PostgreSQL.

Tóm tắt nhanh

  • Giấy phép MIT, file LICENSE ở gốc repo.
  • Repo kdigivn/kdigi-cms-open, phiên bản hiện tại 1.2.0.
  • Có Contributing, Code of Conduct, Security policy, mẫu issue/PR.
  • CI chạy typecheck, unit test, lint, integration test.
  • Báo lỗ hổng bảo mật riêng tư, không mở issue công khai.

Ảnh chụp bảng điều khiển KDIGI CMS, phần mềm mã nguồn mở quản lý nhiều website

Giấy phép MIT với bạn

Bạn muốn MIT cho phép
Dùng cho website khách hàng, kể cả thu phí Có
Cài một bản phục vụ nhiều website Có
Fork và sửa mã theo nhu cầu Có
Phân phối lại bản đã sửa, kể cả đóng gói thương mại Có
Đòi tác giả bảo hành Không

Điều kiện duy nhất: giữ thông báo bản quyền và văn bản giấy phép. Đóng góp của bạn cũng được cấp phép MIT. Đây là tóm lược, không phải tư vấn pháp lý; văn bản LICENSE trong repo mới có hiệu lực.

Có gì trong repo

Lưu ý Theo CHANGELOG, mã tách ra từ một hệ thống đã chạy production. Module đặc thù nghiệp vụ, công cụ CDN, pipeline clone và importer một lần cho từng site riêng không được mang sang.

Cấu trúc kho mã

Thư mục Vai trò
src/ Collections, access, hooks, endpoints, importer WordPress, seed
src/migrations/ Migration PostgreSQL có timestamp; schema không tự đồng bộ
docs/ Bộ tài liệu: cấu hình, deploy, REST API, SEO, multi-site, vai trò
docker/, Dockerfile, docker-compose*.yml Đóng gói và triển khai
e2e/, .github/ Kiểm thử Playwright, CI, mẫu issue/PR

Cách đóng góp

  1. Mở hoặc tìm issue Thay đổi lớn nên thống nhất hướng trước.
  2. Fork, tạo nhánh từ main Một thay đổi logic cho mỗi pull request.
  3. Chạy kiểm tra như CI next build bỏ qua lint và typecheck, nên build xanh chưa đủ.
  4. Đổi schema thì thêm migration Phải đảo ngược được, không giả định database trống.
  5. Commit và ghi CHANGELOG Theo Conventional Commits; ghi vào mục Unreleased.
pnpm typecheck
pnpm lint
pnpm test
pnpm test:integration   # cần PostgreSQL qua DATABASE_URI và PAYLOAD_INTEGRATION=1

Cài môi trường phát triển: bắt đầu nhanh. Quy ước chính:

  • Mọi collection khai báo access.* tường minh
  • Không log hay trả về bí mật (thông tin lưu trữ, API key)
  • vi là locale mặc định, en là fallback
  • Dùng example.com và change-me, không đưa domain hay bí mật thật vào mã

Chính sách bảo mật

  • 3 ngày làm việc để xác nhận báo cáo
  • 10 ngày làm việc để cập nhật trạng thái
  • 90 ngày tối đa để vá trước khi công bố

Cảnh báo Đừng mở issue công khai cho lỗ hổng. Báo riêng tại GitHub Security Advisories kèm phiên bản, cách chạy, tác động và bước tái hiện.

Bản 1.x mới nhất được vá bảo mật. Khi vận hành, theo phần bảo mật trong hướng dẫn tự host và bảo mật, phân quyền.

Quy tắc ứng xử

Dự án áp dụng Contributor Covenant 2.1. Kênh chính thức là GitHub Issues. Muốn thử trước khi tham gia, dùng bản demo.

Lộ trình

Repo chưa có tài liệu roadmap riêng. Lịch sử thay đổi ở trang phát hành; website chỉ nêu những gì đã có trong phiên bản phát hành.

Câu hỏi thường gặp

KDIGI CMS dùng giấy phép mã nguồn mở nào?

Giấy phép MIT, bản quyền 2026 KDIGI. Bạn được dùng, sửa, phân phối và bán bản sao, kể cả cho dự án thương mại, với điều kiện giữ thông báo bản quyền và giấy phép. Phần mềm cung cấp nguyên trạng, không bảo hành.

Tôi có được dùng KDIGI CMS cho khách hàng của agency không?

Được. MIT không giới hạn mục đích thương mại hay số website. Bạn có thể cài một bản phục vụ nhiều site khách hàng, hoặc fork và tùy biến, miễn là giữ thông báo bản quyền và giấy phép.

Làm sao đóng góp mã cho KDIGI CMS?

Fork repo kdigivn/kdigi-cms-open, tạo nhánh từ main và gửi pull request nhỏ. Chạy pnpm typecheck, lint, test trước; commit theo Conventional Commits, cập nhật CHANGELOG. Thay đổi lớn nên mở issue trước.

Phát hiện lỗ hổng bảo mật thì báo ở đâu?

Không mở issue công khai. Dùng báo cáo riêng tư của GitHub (Security Advisories) của repo kdigivn/kdigi-cms-open. Dự án cam kết phản hồi trong 3 ngày làm việc và nhắm tới vá trong 90 ngày.

Dự án có lộ trình (roadmap) công khai không?

Hiện chưa có tài liệu roadmap riêng. Những gì đã phát hành nằm trong CHANGELOG; mục Unreleased chứa thay đổi chưa phát hành. Đề xuất tính năng gửi qua GitHub Issues bằng mẫu feature request.
Đọc tài liệu kỹ thuật tương ứng

Đọc tiếp