KEYXE / Mã nguồn mở

Chia sẻ tri thức. Mở mã nguồn có trách nhiệm.

KEYXE chọn định hướng open-core: phát triển phần mềm thương mại, đồng thời chuẩn bị một số công cụ, công thức và ví dụ để cộng đồng học hỏi. Công khai mã nguồn không có nghĩa là công khai dữ liệu khách hàng hoặc hệ thống vận hành.

Minh họa quá trình thiết kế và chia sẻ phần mềm mã nguồn mở

Hiểu đúng khái niệm

“Đang phát triển” không đồng nghĩa “đã phát hành”.

KEYXE phân biệt tài liệu có thể đọc trên website, phần mềm đang chuẩn bị phát hành và kho mã nguồn công khai thực tế. Trạng thái mỗi thành phần được lấy từ cùng bản kê phát hành đang sử dụng cho trang tiếng Anh.

Kho mã nguồn công khai: Chưa được công bố. Không có đường dẫn tải mã nguồn hoặc giấy phép được gán trước khi phát hành.

Các giấy phép và điều kiện sử dụng

Đối với phần mã nguồn dự kiến chia sẻ, KEYXE đang xem xét giấy phép được OSI công nhận, chẳng hạn Apache-2.0. Đây chưa phải giấy phép đã được lựa chọn hay gắn cho module.

Ví dụ tài liệu và dữ liệu giả lập có thể cần giấy phép riêng. Mọi tuyên bố về phạm vi sử dụng và quyền phân phối chỉ có hiệu lực khi tài nguyên đã thực sự được công bố kèm điều khoản cụ thể.

Minh họa lộ trình phát triển mã nguồn và rà soát phát hành

Các ứng viên công bố

Lộ trình theo từng thành phần.

Không sử dụng số phiên bản hoặc đường dẫn tải mã nguồn khi tài nguyên chưa được phát hành. Trạng thái được đối chiếu với bản kê kỹ thuật, không phải ước lượng tiếp thị.

Đang phát triển

Định nghĩa công cụ MCP

Tám công cụ chỉ đọc cùng cấu trúc đầu vào/đầu ra dựa trên JSON Schema, sử dụng dữ liệu giả lập.

Đọc tài liệu liên quan (EN) ↗
Dự kiến

Ứng dụng mẫu MCP Client

Ứng dụng mẫu chạy cục bộ được lên kế hoạch phát triển, chưa có mã nguồn hoàn chỉnh.

Đọc tài liệu liên quan (EN) ↗
Đang phát triển

Bộ dữ liệu thương mại giả lập

Dữ liệu bán hàng, tồn kho và quảng cáo được tạo từ đầu bằng thuật toán có thể lặp lại; không sao chép dữ liệu Amazon thật.

Đọc tài liệu liên quan (EN) ↗
Đang phát triển

Thư viện công thức chỉ số

Các công thức ACoS, ROAS, CPC, CTR, tỷ lệ chuyển đổi và ACoS hòa vốn kèm kiểm thử.

Đọc tài liệu liên quan (EN) ↗
Đang phát triển

Công cụ xác thực và kiểm thử

Kiểm tra dữ liệu đầu vào, giới hạn kết quả và chống chèn công thức độc hại vào CSV.

Đọc tài liệu liên quan (EN) ↗
Đang phát triển

Tài liệu giáo dục

Hướng dẫn, thuật ngữ và sơ đồ giải thích số liệu thương mại và công cụ AI; giấy phép mở chưa được quyết định.

Đọc tài liệu liên quan (EN) ↗

Ranh giới open-core

Thành phần có thể xem xét chia sẻ và dữ liệu bắt buộc giữ riêng.

Có thể công bố sau rà soát

  • Định nghĩa công cụ MCP chỉ đọc cùng đầu vào/đầu ra được giả lập
  • Thuật toán tạo dữ liệu thương mại giả lập từ đầu
  • Hàm tính chỉ số thuần túy và bài kiểm thử
  • Tài liệu kỹ thuật, ví dụ và biểu đồ được xem xét quyền sử dụng
  • Bộ kiểm tra CSV và dữ liệu đầu vào không nhạy cảm

Chỉ những thành phần vượt qua kiểm tra bản quyền, bảo mật, tài liệu và giấy phép mới được phát hành.

Luôn giữ riêng tư

  • OAuth client secret, refresh token, API key và thông tin đăng nhập
  • Bản ghi thật của người bán, nhà quảng cáo và khách hàng
  • Dữ liệu định danh, phân quyền theo tenant và nhật ký riêng tư
  • Hệ thống thanh toán, lưu thông tin xác thực và hạ tầng sản xuất
  • Báo cáo sự cố bảo mật và các thông tin triển khai nhạy cảm

Không đưa mã nguồn nhạy cảm hoặc dữ liệu tài khoản Amazon thật vào ví dụ công khai.

Sơ đồ phân chia phần có thể công bố và phần hạ tầng phải giữ kín
Minh họa nguyên tắc phân chia phạm vi công khai và bảo mật của KEYXE.

Từ ý tưởng đến bản phát hành

Học hỏi → Thiết kế → Kiểm thử → Rà soát → Công bố.

  1. 1. Xác định nhu cầu

    Ưu tiên tài liệu và công cụ hữu ích cho việc học và kiểm chứng.

  2. 2. Viết và kiểm thử

    Dùng dữ liệu giả lập, định nghĩa rõ cấu trúc và kết quả.

  3. 3. Rà soát

    Kiểm tra bí mật, giấy phép, dependencies và khả năng tiết lộ dữ liệu.

  4. 4. Công bố

    Đưa lên kho mã nguồn công khai đã được xem xét cùng tài liệu và giấy phép.

Trong khi chưa có kho mã nguồn đã duyệt, bạn có thể đề xuất hướng dẫn, mô-đun mẫu hoặc cải thiện qua biểu mẫu Contact hiện có.