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	licensing-team, platform-team
Supersedes	—

Bối cảnh

• Licensing ship với APP_ENV_APPLICATION_CODE = SVC-00110-LICENSING (xem mô tả app-info.json và application.ts).
• @nx/outreach đã sở hữu tiền tố SVC-00110 — phần số đụng nhau.
• SVC-00110-LICENSING chưa được đăng ký trong enum ServiceCodes của core.
• Service code cấp dữ liệu cho tương quan log, Kafka client ID, và dashboard vận hành; va chạm rủi ro 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 đã thuộc về helpdesk (đã khai báo SVC-00120-HELPDESK trong app-info.json), nên licensing nhận slot trống kế tiếp là SVC-00140 (SVC-00130 thuộc về taxation).

Hệ quả

Ưu	Nhược
Loại rủi ro gán nhầm telemetry chéo	Yêu cầu động vào app-info.json + ServiceCodes của core + env ở mọi môi trường
Một nguồn sự thật cho code (enum)	Bất kỳ dashboard / alert nào khoá trên SVC-00110-LICENSING 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 cũ hơn/đã ổn định hơn; nhiều biến động hạ nguồn	Bán kính ảnh hưởng cao hơn
Để cả hai trên SVC-00110	Không việc gì	Mơ hồ telemetry vĩnh viễn	Phá vỡ mục đích của service code
Chỉ thêm hậu tố (SVC-00110-LICENSING vs SVC-00110-OUTREACH)	Thay đổi tối thiểu	Tiền tố số vẫn đụng trong nhóm code-prefix	Không sửa va chạm gốc

Tham chiếu

• licensing/src/resources/app-info.json — SVC-00140-LICENSING
• licensing/AGENTS.md — cảnh báo va chạm Quick Reference
• core/src/common/service-codes.ts — enum ServiceCodes (licensing đã đăng ký là SVC-00140-LICENSING)