Giao diện
RFC 0004: Publish lên npmjs với scope @tasco-fe
- Trạng thái: Accepted
- Người đề xuất: Core team
- Ngày: 2026-11-10
Bối cảnh & vấn đề
Các package @tasco/* hiện chỉ publish lên GitLab Package Registry (access: restricted). Muốn phát hành lên npmjs thì gặp hai trở ngại:
- Scope
@tascotrên npmjs đã có chủ. Kiểm tra ngày 2026-11-10 bằngnpm org ls:tascotrả 200 (đã đăng ký), còn tên bịa trả 404Scope not found. Không dùng được, chưa biết ai giữ. - Code còn gắn hạ tầng nội bộ:
nuxt-layer-base(server/utils/iam.ts,routes/auth/login.post.ts), data của@tasco/mcp(docs.json,primitives.jsonchứa linkweb.docs.vtii.vn), template của@tasco/cli(.gitlab-ci.yml,_npmrc,docker-compose.*,.mcp.json).
@tasco-fe còn trống (cùng ngày, kiểm tra cùng cách, kèm đối chứng).
Đề xuất
- Đăng ký org npm
@tasco-fe(bước thủ công trên npmjs.com, người có quyền của công ty thực hiện). - Đổi tên 10 package
@tasco/*→@tasco-fe/*, phát hành thành major 3.0.0 (breaking: đổi mọi import vàextends). - Tên nội bộ không đổi:
tasco:<khu>:<tên>,$tasco<Tên>,--tasco-*, tiền tốTasco/C*. - Tách mọi host nội bộ ra cấu hình (
runtimeConfig, biến môi trường), không để giá trị mặc định trỏ hạ tầng nội bộ. - Release qua GitLab CI như hiện tại, đổi
.npmrcsangregistry.npmjs.orgvới granular token chỉ có quyền publish scope@tasco-fe, đặt Protected và Masked.
Kết quả rà soát tham chiếu nội bộ (2026-11-10)
Quét packages/ (bỏ test, story, CHANGELOG, node_modules, dist):
| Nơi | Tham chiếu | Cách xử lý |
|---|---|---|
nuxt-layer-base | baseURL mặc định đã rỗng (cấu hình qua env). Còn ví dụ host IAM nội bộ trong comment (nuxt.config.ts, iam.ts), README; mock dev dùng email miền nội bộ; đường dẫn endpoint mặc định (/auth/auth/login-v1, /iam/user/userInfo…) khớp IAM nội bộ | Thay bằng ví dụ trung lập; cân nhắc để endpoint mặc định rỗng hoặc chuyển sang preset |
@tasco/cli templates | _npmrc, .gitlab-ci.yml (host GitLab, registry), docker-compose.*, _env.example, .mcp.json, scripts/deploy-prod.sh | Biến hoá bằng placeholder/prompt khi scaffold, hoặc tách sang template nội bộ |
@tasco/mcp code | DOCS_ORIGIN = https://web.docs.vtii.vn (links.ts, server.ts) | Đổi theo domain docs công khai hoặc cấu hình qua env |
@tasco/mcp data | docs.json: ~1.486 link web.docs.vtii.vn + 18 chỗ host GitLab nội bộ (từ trang docs hướng dẫn cài registry và clone repo); components.json: 17, primitives.json: 52 link | Đã làm: scripts/generate.ts thay host nội bộ bằng <host-noi-bo> khi ghi data (src/redact.ts), email ví dụ trong docs đổi sang example.com. Hướng dẫn cài qua GitLab sẽ viết lại khi đổi sang registry npm |
| README các package | Link docs, URL AI gateway và API gateway nội bộ | Đổi sang ví dụ trung lập |
Chưa xác định: docs web.docs.vtii.vn đã công khai chưa, và host GitLab nội bộ có lộ ra ngoài ý muốn không.
Endpoint và mapping IAM mặc định (đã đánh giá)
runtimeConfig.auth mặc định khớp IAM Tasco: đường dẫn (/auth/auth/login-v1, /iam/user/userInfo…), field response (body.tokenData.access_token, listRole, authorization) và mã authenMethod. Host để trống (baseURL: ''), nên bản công khai không tự gọi tới hạ tầng nào; lộ ra chỉ là hình dạng API, và hình dạng đó đã nằm trong docs công khai.
- Làm ngay (không breaking): thay ví dụ mang định danh nghiệp vụ nội bộ (mã role và permission URI thật) bằng ví dụ trung lập
ORDER_ADMIN,/orders/*trong comment, JSDoc và docs. - Giữ nguyên mặc định ở 3.0: đổi sang rỗng làm mọi team đang dùng mặc định phải đặt thêm ~12 biến
NUXT_AUTH_*, lợi ích bảo mật thấp. Nếu về sau muốn layer trung lập, thêmauth.preset: 'tasco'ở bản minor, rồi mới đổi mặc định ở major sau.
Câu hỏi mở (cần chốt trước khi Accepted)
Công khai hay private?Đã chốt (2026-11-10): công khai. Org@tasco-feđã đăng ký, dùng gói Free (chỉ publish được package công khai) →access: public. Phải xử lý hết mục "Kết quả rà soát" dưới đây trước khi publish.LicenseĐã chốt (2026-11-10): MIT, thêm fileLICENSEở gốc và trong từng package.- Có giữ publish song song lên GitLab (scope cũ
@tasco) cho các team còn ở major 2 không.
Tác động
- Team sản phẩm: đổi import,
extends,.npmrc, lockfile; có hướng dẫn migration2.x → 3.0trong docs. - Docs,
CLAUDE.md, template CLI, data MCP, rule ESLintnoDirectAntdvđều nhắc tên scope. @tasco/miniapp-sdk(project khác cùng group GitLab) không thuộc phạm vi RFC này.
Việc cần làm
- Tách cấu hình nội bộ khỏi code và template; quét bí mật (
gitleaks) trước khi công khai. - Đổi tên package, import, template, data MCP, docs; thêm
repository,homepage,bugs,engines,sideEffects,LICENSE. - CI:
pnpm pack --dry-runkiểm tra danh sách file; smoke test càinuxt-layer-basevào app sạch trước publish. - Publish thử tag
beta(3.0.0-beta.0), một team cài thử, rồi mớilatest. - Cập nhật
docs/core/npmrc.md,docs/core/releasing.md.
Rủi ro & rollback
- Bản đã publish lên npm không gỡ được sau 72 giờ và không dùng lại được số version: bắt buộc qua
beta. - Lộ code/kiến trúc BFF–IAM nếu chọn công khai mà chưa tách cấu hình.
- Rollback: ngừng publish lên npm, deprecate các bản
3.xđã đẩy, team sản phẩm ở lại major 2 trên GitLab.