ADR-0002. Giải quyết va chạm service-code SVC-00110 với outreach

Trường	Giá trị
Status	Accepted
Date	2026-04-21
Deciders	Phat Nguyen
Supersedes	-

Bối cảnh

• Licensing được phát hành với APP_ENV_APPLICATION_CODE = SVC-00110-LICENSING (xem phần mô tả trong app-info.json và application.ts).
• @nx/outreach đã sở hữu tiền tố SVC-00110 - phần số bị trùng.
• SVC-00110-LICENSING chưa được đăng ký trong enum ServiceCodes của core.
• Service code cung cấp dữ liệu cho việc tương quan log, Kafka client ID và dashboard vận hành; sự trùng lặp có nguy cơ gán nhầm telemetry chéo giữa hai service.

Quyết định

Licensing được gán lại thành SVC-00140-LICENSING và đăng ký trong enum ServiceCodes của core. Outreach giữ SVC-00110. Số SVC-00120 từng được đề xuất ban đầu hoá ra đã thuộc về helpdesk (helpdesk đã khai báo SVC-00120-HELPDESK trong app-info.json của nó), nên licensing nhận chỗ trống kế tiếp là SVC-00140 (SVC-00130 thuộc về taxation).

Hệ quả

Ưu	Nhược
Loại bỏ nguy cơ gán nhầm telemetry chéo	Phải đụng vào app-info.json + ServiceCodes của core + biến môi trường ở mọi môi trường
Một nguồn sự thật duy nhất cho mã (enum)	Mọi dashboard / cảnh báo đang khoá theo SVC-00110-LICENSING đều phải cập nhật

Phương án đã cân nhắc

Phương án	Ưu	Nhược	Vì sao loại
Giữ SVC-00110, đánh số lại outreach	Licensing không đổi	Outreach lâu đời hơn/đã ổn định hơn; gây nhiều xáo trộn phía sau	Phạm vi ảnh hưởng lớn hơn
Để cả hai trên SVC-00110	Không phải làm gì	Telemetry mơ hồ vĩnh viễn	Đi ngược lại mục đích của service code
Chỉ thêm hậu tố (SVC-00110-LICENSING so với SVC-00110-OUTREACH)	Thay đổi tối thiểu	Tiền tố số vẫn trùng khi gom nhóm theo tiền tố mã	Không giải quyết được sự trùng lặp gốc

Tham chiếu

• licensing/src/resources/app-info.json - SVC-00140-LICENSING
• licensing/AGENTS.md - cảnh báo trùng lặp trong phần Quick Reference
• core/src/common/service-codes.ts - enum ServiceCodes (licensing nay đã đăng ký là SVC-00140-LICENSING)