[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F426KFFRV8S8MJ066ZPWSK":3,"skill-same:01M7F426KFFRV8S8MJ066ZPWSK":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7F426KFFRV8S8MJ066ZPWSK","using-primeng-components",null,"PrimeNG v22 (rc.2) + Angular 22 trong Cluvix: component quick reference, deprecated components giữ nguyên chủ động (p-multiSelect\u002Fp-password\u002Fp-galleria\u002Fp-colorPicker), brand palette, pricing tier option. Dùng skill này TRƯỚC KHI động vào các component trên, trước khi upgrade PrimeNG tiếp, hoặc khi làm feature FE mới cần biết API Angular 22 mới.","cluvix\u002Fcluvix-crm","cluvix","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F324537109?v=4","01M7F40XX639HYM8HRW4JW1TA5","Cluvix Solutions","01M7F40XYG6YMX0CD0QZNV61K4",21,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Ffrontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: using-primeng-components\ndescription: >-\n  PrimeNG v22 (rc.2) + Angular 22 trong Cluvix: component quick reference, deprecated\n  components giữ nguyên chủ động (p-multiSelect\u002Fp-password\u002Fp-galleria\u002Fp-colorPicker),\n  brand palette, pricing tier option. Dùng skill này TRƯỚC KHI động vào các component\n  trên, trước khi upgrade PrimeNG tiếp, hoặc khi làm feature FE mới cần biết API\n  Angular 22 mới.\n---\n\n# Using PrimeNG components\n\n> UI chi tiết (palette đo contrast, component reference, don'ts): `reference\u002Fui.md`\n> Gotchas Build\u002FTooling\u002FGit (AOT, ng build, script khảo sát): `reference\u002Ffe-patterns-gotchas-build.md`\n\n\n\n> Trạng thái (2026-07-24): **Đã upgrade lên `primeng@22.0.0` bản STABLE** (+ `@primeuix\u002Fthemes@3.0.0`) — trước đó dùng `22.0.0-rc.2` từ lúc migrate (2026-07-09) vì khi đó v22 chỉ có RC. Đã diff source `onToggleAll`\u002F`allSelected`\u002F`isSelected` giữa rc.2 và 22.0.0 stable: **giống hệt nhau**, không có thay đổi hành vi — nâng cấp chỉ để thoát khỏi RC, KHÔNG tự fix bug MultiSelect select-all bên dưới. Build\u002Ftsc pass sau upgrade. `pTemplate` (129 file) đã migrate xong hoàn toàn. `p-multiSelect`\u002F`p-password`\u002F`p-galleria`\u002F`p-colorPicker` — **PHẦN LỚN CHỦ ĐỘNG GIỮ NGUYÊN** (không migrate) do phát hiện feature-gap thật ở component thay thế, xem mục 2. Full log thực chiến `..\u002Fbmad\u002Fprimeng-v22-migration\u002F` đã xóa khi dọn BMAD hoàn thành (2026-07-16) — gotchas đáng giữ đã đúc kết hết vào file này.\n>\n> **Bug upstream chưa fix — MultiSelect \"chọn tất cả\" + filter (2026-07-24):** repo `primefaces\u002Fprimeng` trên GitHub đã **archived (read-only) từ 2026-06-28** — không còn nhận fix cộng đồng. Header \"chọn tất cả\" của `p-multiselect` (khi có `[filter]=\"true\"`, dùng ở HẦU HẾT wrapper multiselect trong Cluvix) bấm BỎ chọn tất cả không clear đúng state — bug có thật, đã báo cáo nhiều lần trên GitHub, KHÔNG PHẢI lỗi code Cluvix: [#15516](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F15516), [#14603](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F14603), [#14252](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F14252) (fix cũ ở #14252 bị regress lại ở #15516, \"Needs Triage\", chưa fix ở bất kỳ version nào tính đến 22.0.0). Hướng xử lý (chưa làm, cần quyết định fan-out ~40 wrapper): tắt `[showToggleAll]=\"false\"` + tự viết nút \"chọn tất cả\" trong `base-multiselect-control.ts` và các wrapper không dùng base, không phụ thuộc logic nội bộ PrimeNG nữa.\n\nNguồn: https:\u002F\u002Fprimeng.dev\u002Fmigration\u002Fv22 (đọc 2026-07-08).\n\n---\n\n## 0. CRITICAL — v22 bắt buộc license key, kể cả bản miễn phí (KHÔNG có ở v21 trở về trước)\n\nTừ v22, PrimeNG (rebrand \"PrimeUI\") verify license key offline qua `@primeui\u002Flicense-manager` (chữ ký Ed25519), gọi qua `providePrimeNG({..., license: 'KEY'})`. Không có key hợp lệ → banner đỏ \"Invalid PrimeUI License\" góc dưới phải (không chặn thao tác, nhưng là vấn đề compliance thật).\n\n- **Community License (miễn phí)**: doanh thu \u003C $1M\u002Fnăm, \u003C 5 dev, \u003C 10 nhân viên, \u003C $3M vốn gọi được. Renew hàng năm.\n- **Commercial License (trả phí)**: công ty không đạt điều kiện trên.\n- Đăng ký: https:\u002F\u002Fprimeui.dev\u002Flicenses\u002Fcommunity hoặc `\u002Fcommercial`.\n- **Hết hạn KHÔNG hỏng chức năng** — chỉ banner đỏ; `verified()` chỉ được đọc để hiện banner, không gate component nào.\n- **Chỉ tier `community` bị kiểm theo đồng hồ** (`Date.now() > exp`, grace 30 ngày). Mọi tier còn gate thứ 2: `RELEASE_DATE` của bản PrimeNG > `exp` ⇒ \"expired\" NGAY, **không grace** — nâng PrimeNG lên bản phát hành sau ngày hết hạn key cũng cần key mới.\n\n**Đây là quyết định kinh doanh, KHÔNG tự động hoá được** — phải chốt trước khi coi migration là hoàn tất, dù build\u002Ftsc\u002Flint đều pass bình thường không có key.\n\n**Cách lưu key (đổi 2026-09-05)**: key nạp lúc CHẠY từ file JSON trên CDN — `share\u002Futils\u002Fprimeui-license.util.ts`; `app.config.ts` đọc lazy `get license() { return primeuiLicense(); }` (gán thẳng sẽ đóng băng giá trị lúc load module). `environment.primeuiLicense` ở 3 file nay chỉ là FALLBACK. Gia hạn = sửa file trên CDN, KHÔNG build lại.\n\n---\n\n## 1. Breaking change quan trọng nhất — base font-size 14px → 16px\n\nPrimeNG tính kích thước component theo `rem` dựa trên root font-size. v22 đổi mặc định từ 14px → 16px (khớp browser default). Có \"compat variant\" preset giữ 14px cho layout cũ.\n\n**Trước khi upgrade:** xác nhận layout hiện tại (đặc biệt các bảng dày đặc, form nhiều field) không vỡ khi component to hơn ~14%. Nếu không muốn sửa layout ngay → bật compat variant thay vì để mặc định 16px.\n\n---\n\n## 2. Component deprecated (xoá hẳn ở v24) — kết quả migrate thật (2026-07-09)\n\n**PHÁT HIỆN QUAN TRỌNG NHẤT của đợt migrate này: \"deprecated, còn hoạt động tới v24\" ≠ \"thay thế mới có đầy đủ tính năng\".** Ban đầu giả định thay component chỉ là đổi tên tag — THỰC TẾ hầu hết component thay thế ở generation v22 sớm này **thiếu tính năng thật so với bản cũ**, không phải chỉ khác API bề mặt. Trước khi migrate BẤT KỲ component nào trong bảng dưới, BẮT BUỘC so sánh 2 danh sách `@Input` qua `node_modules\u002Fprimeng\u002Ftypes\u002Fprimeng-{old}.d.ts` vs `primeng-{new}.d.ts` (lệnh: `grep 'ɵɵComponentDeclaration\u003CX,' file.d.ts`), rồi grep xem file thật trong repo có dùng prop nào nằm trong phần \"chỉ có ở bản cũ\" không — nếu có, ĐỪNG migrate mù.\n\n| Component cũ | Thay bằng | Số file thực tế | Kết quả |\n|---|---|---|---|\n| `pTemplate` | `ng-template` + reference variable | 129 | ✅ Migrate xong 100% — nhưng **KHÔNG tương đương**: xem cảnh báo ngay dưới bảng |\n| `p-multiSelect` (`p-multiselect` sau rename casing) | `p-select` với `multiple` | 137 | ⚠️ **Migrate 54\u002F137, giữ nguyên 83** — `p-select` thiếu `maxSelectedLabels`\u002F`display`\u002F`selectedItemsLabel`\u002F`showToggleAll`, không có template hook thay thế. Chỉ migrate file KHÔNG dùng các prop này |\n| `p-password` | directive `pPassword` | 2 | ❌ **Giữ nguyên cả 2** — directive KHÔNG có UI toggle tương tác (`showPassword` chỉ ép `type=text` 1 chiều, không phải nút bấm), KHÔNG có strength-meter overlay (`feedback` là dead prop trên directive) |\n\n> ⛔ **`pTemplate` trong code MỚI = bảng rỗng, im lặng.** Bảng trên là nhật ký một đợt migrate đã xong,\n> KHÔNG phải \"chuyện đã đóng\". Ở v22 `p-table` chỉ đọc `\u003Cng-template #header|#body|#expandedrow|#emptymessage|#caption|#footer|#loadingbody>`;\n> `pTemplate=\"header\"` vẫn là directive HỢP LỆ nên `tsc` và `ngc --noEmit` đều xanh, nhưng component\n> không nhận template ⇒ render ra bảng **không header, không dòng, không cả empty state**, không lỗi\n> console. Dính thật 2026-09-09 trên production. Danh sách tên template + ví dụ ❌\u002F✅:\n> `frontend\u002Fskill\u002Fskills\u002Fbuilding-angular-signal-forms\u002Freference\u002Ffe-patterns-gotchas-form.md` §`pTemplate` deprecated.\n>\n> Trước khi viết một API PrimeNG theo trí nhớ, đếm xem repo đang dùng cách nào:\n> `grep -rho '\u003Cng-template #[a-z]*' --include='*.html' src\u002Fapp | sort | uniq -c | sort -rn`.\n> 440 file dùng `#header`, 1 file dùng `pTemplate` — file thiểu số là file sai.\n| `p-galleria` | `p-gallery` | 1 | ❌ **Giữ nguyên** — `p-gallery` thiếu `value` (!), `numVisible`, `showThumbnails`, `circular`, `fullScreen`... không cách nào bind data được |\n| `p-colorPicker` (`p-colorpicker` sau rename casing) | `p-inputColor` | 3 | ❌ **Giữ nguyên** — `p-inputcolor` là UI widget khác hẳn (0 overlay\u002Fpanel logic, có vẻ dùng slider\u002Farea trực tiếp thay vì popup swatch cũ), đổi trải nghiệm quá lớn để migrate mù |\n| `p-editor` | PrimeUI PRO Editor (trả phí) | 17 | ⛔ Out of scope — chờ quyết định licensing PrimeUI PRO |\n| `p-chart` | PrimeUI PRO Charts (trả phí) | 13 | ⛔ Out of scope — chờ quyết định licensing PrimeUI PRO |\n| `p-panelMenu` | `p-menu` với `toggleable` | 0 | — |\n| `p-inputMask` | directive `pInputMask` | 0 | — |\n| `p-scrollPanel` | `p-scrollArea` | 0 | — |\n| `p-image` | `p-gallery` | 0 | — |\n\n**Component nào \"giữ nguyên\" ở trên đều vẫn hoạt động bình thường** (chỉ deprecated, chưa xoá tới v24) — không phải lỗi, là quyết định có căn cứ. Revisit khi PrimeNG bổ sung tính năng tương đương cho bản thay thế, hoặc gần mốc v24 buộc phải xử lý.\n\n**Input class có thể là input CHẾT — verify trước khi khoanh style qua nó:** đọc `classes.root` trong `node_modules\u002Fprimeng\u002Ffesm2022\u002Fprimeng-\u003Ccomp>.mjs` xem input đó có được nối vào class thật không. `p-galleria` v22: `containerClass` khai nhưng KHÔNG gắn vào root (mọi CSS khoanh theo nó vô tác dụng); chỉ `maskClass` áp thật.\n\n**`p-editor`\u002F`p-chart` migrate sang PrimeUI PRO — cần xác nhận licensing trước khi upgrade**, không phải thuần code change.\n\n**Nút con của `\u003Cp-buttongroup>` PHẢI giữ component `\u003Cp-button>`, KHÔNG đổi sang `\u003Cbutton pButton>`** — CSS buttongroup chọn theo tên thẻ (`.p-buttongroup p-button:not(:last-child) .p-button`), đổi sang directive thì các nút tách rời, bo tròn riêng lẻ; build không báo lỗi. Ngoài buttongroup vẫn dùng `\u003Cbutton pButton>`.\n\n---\n\n## 2.1 — p-tabs [lazy]=\"true\" KHÔNG lazy thật (rc.2)\n\n`TabPanel.shouldRender()` trả `true` cho tab không active ngay lần render đầu — panel vẫn ẩn đúng qua CSS\nnhưng component con bên trong đã bị tạo, mọi HTTP fetch trong `ngOnInit` bắn ra ngay. Verified qua unit\ntest cô lập (TestBed + component thật từ node_modules\u002Fprimeng), không phải do cách viết template của app.\n\n✅ Fix: bỏ `[lazy]=\"true\"`, bọc nội dung mỗi `\u003Cp-tabpanel>` (trừ tab mặc định active) bằng\n`@defer (when activeTab() === 'X')` — tự có \"render 1 lần rồi giữ\" + code-split JS riêng từng tab.\nCần `activeTab` là signal + `[value]=\"activeTab()\"` + `(valueChange)=\"activeTab.set(...)\"` (controlled).\n\n`p-tabpanel` ẩn panel bằng host attribute `hidden` → nội dung đã render GIỮ NGUYÊN trong DOM, `@defer`\nchỉ chạy 1 lần (verified `node_modules\u002Fprimeng\u002Ffesm2022\u002Fprimeng-tabs.mjs`).\n\n- `@defer` không khai `@placeholder` → render RỖNG cho tới khi `@loading` kịp hiện (`after 150ms`): panel sập về 0px rồi nhảy 2 nhịp. LUÔN khai `@placeholder`, và cho cả placeholder lẫn loading `min-height` bằng chiều cao panel.\n- `min-height` đặt ở `\u003Cp-tabpanels>` (1 lần cho mọi tab), KHÔNG đặt riêng trong 1 panel — đặt lẻ thì card co giãn mỗi lần đổi tab.\n\n---\n\n## 3. Removed API (đã deprecated từ v20\u002Fv21, giờ xoá hẳn)\n\n- `@primeng\u002Fthemes` → `@primeuix\u002Fthemes`\n- `pTemplate` → `ng-template` + reference variable (xem bảng trên)\n- **CamelCase selector → kebab-case\u002Flowercase — ĐÂY LÀ ĐIỂM GÂY LỖI NHIỀU NHẤT KHI MIGRATE THẬT** (không phải chỉ vài attribute nhỏ như hiểu ban đầu — áp dụng cho TÊN COMPONENT SELECTOR). Component compile ra selector toàn lowercase-liền hoặc kebab-case (VD: `p-multiselect, p-multi-select`), selector camelCase cũ (`p-multiSelect`) KHÔNG còn match được nữa — Angular coi thẻ đó là unknown element, kéo theo TOÀN BỘ property binding trên thẻ báo lỗi \"unknown property\" (rất dễ nhầm tưởng property bị đổi\u002Fxoá, thực ra chỉ do thẻ không match). Danh sách đã xác nhận thật khi migrate Cluvix: `p-autoComplete`→`p-autocomplete`, `p-avatarGroup`→`p-avatargroup`, `p-buttonGroup`→`p-buttongroup`, `p-cascadeSelect`→`p-cascadeselect`, `p-cellEditor`→`p-celleditor`, `p-colorPicker`→`p-colorpicker`, `p-confirmDialog`→`p-confirmdialog`, `p-dataView`→`p-dataview`, `p-datePicker`→`p-datepicker`, `p-fileUpload`→`p-fileupload`, `p-inputGroup`→`p-inputgroup`, `p-inputGroupAddon`→`p-inputgroup-addon` (dạng đặc biệt, không phải kebab thuần), `p-inputNumber`→`p-inputnumber`, `p-multiSelect`→`p-multiselect`, `p-orderList`→`p-orderlist`, `p-progressBar`→`p-progressbar`, `p-progressSpinner`→`p-progressspinner`, `p-radioButton`→`p-radiobutton`, `p-selectButton`→`p-selectbutton`, `p-tableCheckbox`→`p-tablecheckbox`, `p-tableHeaderCheckbox`→`p-tableheadercheckbox`, `p-toggleSwitch`→`p-toggleswitch`. **Verify đúng bằng cách grep selector thật trong `node_modules\u002Fprimeng\u002Ffesm2022\u002F*.mjs`** (`selector: \"...\"`), KHÔNG đoán — vài selector không theo pattern kebab thuần (VD `inputGroupAddon`).\n- `pButton` icon\u002Flabel property → directive `pButtonIcon`\u002F`pButtonLabel` (dùng content projection `\u003Cspan pButtonLabel>{{...}}\u003C\u002Fspan>`, không phải `[label]=\"...\"` binding nữa)\n- `p-message` mất input `[text]` — chuyển sang content projection `\u003Cp-message>{{...}}\u003C\u002Fp-message>`\n- `p-drawer`\u002F`p-dialog` mất `[transitionOptions]` — xoá binding (dùng animation mặc định) hoặc dùng `motionOptions` mới nếu cần tuỳ biến\n- `p-tabs [scrollable]` deprecated (cuộn là mặc định) — bỏ attribute, không thì vỡ ở bản sau.\n- `p-tabview`, `p-buttonset`, `p-fluid` không còn được emit ở v22 — CSS bám các class này là chết. Trước khi xoá CSS nghi chết: `grep -rl '\u003Cclass>' node_modules\u002Fprimeng\u002Ffesm2022\u002F*.mjs`, rỗng mới xoá.\n- `showTransitionOptions`\u002F`hideTransitionOptions` → native CSS animation. Thay bằng override class `.{classname}-enter-active`\u002F`.{classname}-leave-active` (định nghĩa animation name\u002Fduration\u002Feasing qua CSS, không qua property JS). 3 nhóm class theo component: anchored overlay (`p-anchored-overlay-*`, dùng cho Select\u002FPopover\u002FAutoComplete), collapsible (`p-collapsible-*`, dùng cho Accordion\u002FPanel\u002FFieldset\u002FStepper), dialog\u002Fdrawer (`p-dialog-*`\u002F`p-drawer-*`). Override global (ảnh hưởng mọi component nhóm đó) hoặc scoped (gắn class riêng từng instance). Chi tiết: https:\u002F\u002Fprimeng.dev\u002Fguides\u002Fanimations\n\n---\n\n## 4. InputMask — component → directive\n\n`InputMask` chuyển từ component riêng sang directive `pInputMask` gắn lên `\u003Cinput>` chuẩn (cùng pattern với `pInputPassword`, `pButtonIcon`). Repo hiện chưa dùng `p-inputMask` (0 file) — không phải audit khi upgrade, nhưng feature mới cần input mask thì viết thẳng theo API v22, không dùng API v21 cũ.\n\n---\n\n## 4.1 CommandMenu — component mới v22, KHÔNG có overlay built-in\n\n`p-commandmenu`\u002F`p-command-menu` chỉ là search-palette INLINE (nhận `model: MenuItem[]`, tự filter theo `search`, gọi `item.command` khi chọn) — không có `visible`\u002Foverlay\u002Fpopup nào tự thân.\nMuốn dùng kiểu Cmd+K command palette (bật\u002Ftắt qua phím tắt) → PHẢI tự bọc trong `p-dialog` (pattern giống `GlobalSearch`: 1 service `WritableSignal\u003Cboolean>` + `p-dialog [visible]=\"service.visible()\"`), không có prop `visible` riêng của CommandMenu để dùng.\n\n---\n\n## 4.2 Option list (`p-autocomplete`\u002F`p-select`) mặc định `white-space: nowrap; overflow: hidden`\n\nTheme gốc (`@primeuix\u002Fstyles`) đã set sẵn, KHÔNG có `text-overflow: ellipsis` — text dài tự động bị clip, KHÔNG wrap xuống dòng. `virtualScrollItemSize` cố định dùng an toàn dù item có text dài, không cần lo item wrap phá layout virtual-scroll.\n\n---\n\n## 4.3 `p-avatar` — `label` ưu tiên hơn `image`, truyền cả 2 thì ảnh không bao giờ hiện\n\nTemplate gốc của `Avatar`: `@if (label()) {...} @else if (image()) {...}` — `label` LUÔN thắng nếu có giá trị. Component nào truyền CẢ `[image]` lẫn `[label]` cùng lúc (kiểu \"ảnh nếu có, chữ tắt nếu không\") thì ảnh KHÔNG BAO GIỜ hiện — bug thật gặp phải ở `indexeddb\u002Fconfig\u002Fcomponents\u002Fuser\u002Fuser-avatar.ts` (2026-08-30, đã fix). Phải tách `@if (hasImage) { \u003Cp-avatar [image]> } @else { \u003Cp-avatar [label]> }`, không bind cả 2 song song.\n\n---\n\n## 4.4 Đổi cỡ\u002Fmàu component PrimeNG từ NGOÀI — dùng biến, không đấu class\u002F`::ng-deep`\n\nClass tiện ích đặt trên host **không** đổi được kích thước component: `\u003Cp-avatar class=\"w-10 h-10\">` vẫn ra **28px** vì `.p-avatar { width: var(--p-avatar-width) }` cùng specificity (0,1,0) nhưng nạp SAU nên thắng — trong khi `\u003Cdiv class=\"w-10 h-10\">` ngay cạnh ra 35px, hai loại avatar lệch nhau mà không ai thấy (đo 2026-09-04).\n\n`::ng-deep` từ component CHA cũng thường thua: Angular gắn `_ngcontent` vào **từng phần tử** trong style của component con, nên `:host > button i` biên dịch thành **(0,3,2)** — cao hơn hầu hết selector `::ng-deep` viết được từ cha.\n\n**Đúng cách: set BIẾN của chính component** (`--p-avatar-width`\u002F`--p-avatar-height`, `--p-icon-size`) ở phần tử cha bất kỳ — biến CSS thừa kế nên không phải đua specificity. Component tự viết mà muốn nơi mount đổi được thì khai biến riêng có fallback: `font-size: var(--tb-icon-size, 1.25rem)`.\n\n⚠ Biến KHÔNG tồn tại thì `background: var(--x)` thành **invalid at computed-value time** ⇒ phần tử về `transparent`, hỏng câm. Kiểm `getComputedStyle(document.documentElement).getPropertyValue('--x')` trước khi dùng một bậc màu mới (vd `--p-primary-900`).\n\n---\n\n## 5. Checklist khi nâng cấp tiếp \u002F audit lại (đã áp dụng xong cho lần migrate 2026-07-09)\n\n```\n☑ Xác nhận Angular core ≥ version PrimeNG yêu cầu — Angular 22 đã sẵn, nhưng PHẢI tự bump @angular\u002Fcdk theo cùng version (không tự động theo `ng update`\u002F`npm install primeng`)\n☑ Bump @angular\u002Fcdk khớp version primeng yêu cầu (`npm ls @angular\u002Fcdk` — peer dep \"invalid\" KHÔNG phải nguyên nhân chính gây lỗi build, xem mục 3 \"CamelCase selector\" mới là root cause thật)\n☑ Quyết định licensing key trước khi coi migration hoàn tất (mục 0) — đã tích hợp qua environment.prod\u002Flocal.ts (gitignored)\n☑ Quyết định base font-size: đã chọn giữ compat 14px qua @primeuix\u002Fthemes\u002Fmaterial-compat\n☑ Migrate pTemplate (129 file) — xong 100%, an toàn hoàn toàn\n☑ So sánh prop-gap TỪNG component deprecated trước khi migrate — đã làm cho p-multiSelect\u002Fp-password\u002Fp-galleria\u002Fp-colorPicker, phát hiện gap thật ở tất cả (xem mục 2)\n□ p-editor\u002Fp-chart — CHƯA quyết định licensing PrimeUI PRO, vẫn out of scope\n□ Nếu upgrade tiếp lên bản v22 stable (khác RC hiện tại) → re-run toàn bộ `ng build` để xem PrimeNG có đổi API thêm gì giữa rc.2 và stable không, ĐỪNG giả định giống hệt\n```\n\n---\n\n## 6. Tham chiếu thêm\n\n- Angular framework upgrade (khác PrimeNG, đừng nhầm số version): `frontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002FSKILL.md`\n- PrimeNG v21 component convention hiện tại: `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002FSKILL.md` (Stack notes)\n\n\n> **Đọc file này trước khi làm bất kỳ feature FE mới nào.**\n> Mục tiêu: luôn dùng API mới nhất của Angular, tránh viết code theo pattern cũ.\n\nPhiên bản hiện tại: **Angular 22.0** (nâng từ 21.1, tháng 6\u002F2026).\nNode yêu cầu: **≥ 22.22.3 hoặc 24+** (dự án đang dùng Node 24).\n\n---\n\n## 1. API mới stable trong v22 — ưu tiên dùng ngay\n\n### `apiResource()` \u002F `rxResource()`\nThay thế pattern `ngOnInit + service.getXxx().subscribe(...)` khi load data đơn giản.\n\n**KHÔNG dùng `httpResource()` raw** — thiếu `withCredentials` (→ 401), bypass `afterLoad()`. Dùng wrapper `apiResource()` → Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002Freference\u002Fresource-patterns.md`\n\n```typescript\n\u002F\u002F ❌ Cũ — boilerplate, phải tự cleanup\nngOnInit() {\n  this.service.getPatient(this.id).pipe(takeUntilDestroyed(this.destroyRef)).subscribe(r => {\n    this.patient.set(r.data);\n  });\n}\n\n\u002F\u002F ✅ Mới — apiResource (wrapper httpResource, share\u002Fresource\u002Fapi-resource.ts)\nreadonly patient = apiResource\u003CPatient>(() => ({ path: `crm\u002Fpatient\u002F${this.id()}` }));\n\u002F\u002F patient.value() → data, patient.isLoading() → loading state, patient.error() → lỗi\n```\n\n**Khi nào dùng:**\n- Load data theo signal param (id thay đổi → tự re-fetch)\n- Thay thế `ngOnInit + subscribe` cho các GET đơn giản\n- Không phù hợp: POST\u002FPUT\u002FDELETE, hoặc fetch cần transform phức tạp — dùng `rxResource()` hoặc service call\n\n### `@Service` decorator\nThay `@Injectable({ providedIn: 'root' })` cho service mới, kèm rule `inject()` → Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002FSKILL.md` (Stack notes). Service cũ giữ nguyên, không migrate hàng loạt.\n\n### Signal debounce built-in — `.debounced()`\n→ Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002Freference\u002Fresource-patterns.md` (section Signal debounce).\n\n---\n\n## 2. Signal Forms (stable v22)\n\nĐã tách sang `skill\u002Fskills\u002Fbuilding-angular-signal-forms\u002FSKILL.md` (2026-08-10, file này vượt 350 dòng) — đọc file đó trước khi viết\u002Fconvert\nbất kỳ form Signal Forms nào (kết luận spike, 23 gotcha, pattern mẫu).\n\n## 3. Breaking changes đã xử lý — KHÔNG cần làm gì thêm\n\n| Breaking change | Trạng thái |\n|---|---|\n| `ChangeDetectionStrategy.Default` → `Eager` | ✅ Không ảnh hưởng — 100% component đã `OnPush` |\n| `afterRender()` → `afterEveryRender()` | ✅ Không dùng trong codebase |\n| `TestBed.get()` removed | ✅ Không dùng |\n| Route param inheritance từ ancestor | ✅ Chỉ 1 chỗ (`app.breadcrumb.ts:149`) — đọc `.data` không phải `.params`, an toàn |\n| Karma removed | ✅ Đã xử lý từ v21 |\n\n---\n\n## 3.1. `provideAnimationsAsync`\u002F`provideAnimations` deprecated — CỐ Ý CHƯA MIGRATE\n\nIDE báo `TS6385: provideAnimationsAsync is deprecated` trong `app.config.ts` — deprecated từ Angular v20.2, khuyến khích chuyển sang `animate.enter`\u002F`animate.leave` (native CSS, bỏ `@angular\u002Fanimations`), dự kiến xoá hẳn ở **v23**.\n\n**KHÔNG xoá\u002Fmigrate ngay** — PrimeNG (kể cả v22) vẫn phụ thuộc `@angular\u002Fanimations`, bỏ `provideAnimations()` làm hỏng animation của `Dialog`\u002F`OverlayPanel`\u002F`Tooltip`\u002F`Menubar` (xác nhận qua issue GitHub `primefaces\u002Fprimeng#18863`, Open, chưa có fix\u002Fworkaround — repo gốc đã archive, PrimeNG rebrand \"PrimeUI\" chưa migrate kịp). Còn thời gian tới v23, giữ nguyên tới khi PrimeNG tự cập nhật.\n\n---\n\n## 4. Suppressions hiện tại — lý do và roadmap\n\n### NG8107 + NG8102 (suppressed trong `tsconfig.json`)\n- **NG8107**: `?.` dùng thừa — TypeScript type không include `null | undefined`\n- **NG8102**: `??` dùng thừa — tương tự\n\nSuppressed vì: 2400+ occurrences, fix tay = rủi ro runtime crash nếu type không chính xác.\nFix đúng là **tighten TypeScript types** từng module, làm dần — không phải xóa `?.` cơ học.\n\n**Roadmap fix đúng (làm theo module, không rush):**\n```\n1. Chọn 1 module nhỏ (vd: loyalty\u002Fbroker)\n2. Tìm NG8107\u002FNG8102 warnings trong module đó\n3. Với mỗi warning: xem field có thực sự nullable không\n   - Nullable → thêm `| null` vào type\n   - Không nullable → xóa `?.` \u002F `??`\n4. Sau khi fix 1 module → verify build + test\n```\n\n### TS5101 `baseUrl` deprecated\nThêm `\"ignoreDeprecations\": \"6.0\"` vào tsconfig. Angular CLI vẫn cần `baseUrl` cho path aliases (`@\u002F*`).\nFix thật: migrate sang `paths` without `baseUrl` khi TypeScript 7.0 release.\n\n### `photoswipe\u002Fstyle.css` (TS2882)\n`src\u002Ftypings.d.ts` khai báo `declare module '*.css'`. Đây là pattern chuẩn.\n\n---\n\n## 5. Checklist khi làm feature FE mới (Angular 22+)\n\n```\n□ Service mới → dùng @Service() thay @Injectable({ providedIn: 'root' })\n□ Load data theo param → cân nhắc apiResource() thay ngOnInit+subscribe (KHÔNG httpResource raw)\n□ Debounce signal → dùng .debounced(300) thay toObservable+debounceTime\n□ OnPush + signals → không mutate object trực tiếp\n□ KHÔNG dùng zone.js API trực tiếp (setTimeout, setInterval) — dùng rxjs hoặc signal\n□ i18n: npm run i18n:find trước khi tạo key mới\n```\n\n---\n\n## 6. Upgrade tiếp theo — Angular 23+\n\nAngular release 1 major\u002F6 tháng. Angular 23 dự kiến **tháng 12\u002F2026**.\n\nTrước khi upgrade:\n1. Đọc blog.ninja-squad.com + angular.love cho release notes\n2. Chạy `ng update --dry-run` để preview\n3. Kiểm tra Node version yêu cầu (xu hướng tăng theo LTS)\n4. Fix permission file trước khi chạy migration: `chmod -R u+w src\u002F`\n\nLệnh nâng:\n```bash\nnvm use 24   # hoặc version LTS mới hơn\nng update @angular\u002Fcore@23 @angular\u002Fcli@23\nnpx tsc --noEmit  # verify sau upgrade\n```\n\n---\n\n## 7. Test builder Karma → Vitest (`@angular\u002Fbuild:unit-test`)\n\n- Builder cần thấy literal `\"zone.js\"` trong mảng `polyfills` của build target để chọn strategy `'static'` (import thường). Nếu app dùng file polyfills custom (`\"src\u002Fpolyfills.ts\"`) thay vì literal `\"zone.js\"`, builder rơi vào `'dynamic'` (top-level await) → fail build test với lỗi \"Top-level await is not available\".\n- Fix: thêm 1 build configuration riêng cho test (không đụng production) với `polyfills: [\"src\u002Fpolyfills.ts\", \"zone.js\"]`, trỏ `test.options.buildTarget` sang configuration đó.\n- Cần cài thêm `jsdom` làm devDependency — không tự bundle kèm vitest.\n\n\n`environment.option: 1 | 2 | 3` trong mỗi file `environment*.ts` — điều khiển module nào hiển thị cho client.\n\n## Tier mapping\n\n| Option | Modules |\n|--------|---------|\n| 1 | CRM, Chăm sóc KH, Nhân sự, Kế toán |\n| 2 | Option 1 + Sale, Kho & Vật tư, EMR |\n| 3 | Tất cả (thêm: Loyalty, Dược & Vật tư, Marketing, Zalo, Cấu hình) |\n\n## Implementation\n\n**Home** (`src\u002Fapp\u002Fmodules\u002Futilities\u002Fhome\u002Fhome.ts`):\n- `ModuleDef.minOption?: number` — tier tối thiểu để hiển thị module\n- Filter trong `computed`: `environment.option \u003C (m.minOption ?? 1)` → ẩn\n\n**Topbar** (`src\u002Fapp\u002Flayout\u002Fcomponents\u002Fapp.topbar.ts`):\n- `protected readonly envOption = environment.option`\n- Template dùng `@if (envOption >= 2)` \u002F `@if (envOption >= 3)` bao quanh từng module block\n\n## Mobile (khác web: KHÔNG build-time)\n\nMobile 1 app cho mọi tenant → tier đọc runtime: option `erpOption` (1|2|3, default 3) trong config_systems (`dexie.ConfigSystemsSetOption(db, define.OptErpOption, v)`) → `\u002Fapi\u002Fmobile\u002Fv1\u002Fping` trả `erp_option` → app persist + filter module theo `minOption` (mirror computed Home web). Đổi tier: sửa option, hiệu lực ≤1 phút, không deploy.\n\n## Thay đổi tier cho client\n\nChỉ sửa `option` trong `environment.prod.ts` của client đó:\n```ts\nexport const environment = {\n  prod: true,\n  option: 2,  \u002F\u002F ← đổi 1 | 2 | 3\n  apiUrl: '\u002Fapi',\n  isDental: false,\n};\n```\n\n## Thêm module mới vào tier system\n\n1. **Home**: thêm `minOption: \u003C1|2|3>` vào object trong `allModules`\n2. **Topbar**: bọc `\u003Ca routerLink=\"...\">` bằng `@if (envOption >= \u003Cn>) { ... } \u003C!-- comment -->`\n\n## File nào tracked git, file nào không\n\n`environment.ts` (base, dùng khi `ng serve` không có `-c`) — TRACKED git.\n`environment.prod.ts`\u002F`environment.local.ts` (dùng qua `fileReplacements` trong `angular.json` cho `-c production`\u002F`-c local`) — GITIGNORED.\nSecret\u002FAPI key\u002Flicense key → đặt ở `environment.prod.ts`\u002F`environment.local.ts`, để rỗng `''` ở `environment.ts`. KHÔNG hardcode secret trực tiếp vào `.ts` khác (vd `app.config.ts`) — mọi file `.ts` ngoài `environments\u002F` đều tracked git.\n","# Using PrimeNG components\n\n> UI chi tiết (palette đo contrast, component reference, don'ts): `reference\u002Fui.md`\n> Gotchas Build\u002FTooling\u002FGit (AOT, ng build, script khảo sát): `reference\u002Ffe-patterns-gotchas-build.md`\n\n\n\n> Trạng thái (2026-07-24): **Đã upgrade lên `primeng@22.0.0` bản STABLE** (+ `@primeuix\u002Fthemes@3.0.0`) — trước đó dùng `22.0.0-rc.2` từ lúc migrate (2026-07-09) vì khi đó v22 chỉ có RC. Đã diff source `onToggleAll`\u002F`allSelected`\u002F`isSelected` giữa rc.2 và 22.0.0 stable: **giống hệt nhau**, không có thay đổi hành vi — nâng cấp chỉ để thoát khỏi RC, KHÔNG tự fix bug MultiSelect select-all bên dưới. Build\u002Ftsc pass sau upgrade. `pTemplate` (129 file) đã migrate xong hoàn toàn. `p-multiSelect`\u002F`p-password`\u002F`p-galleria`\u002F`p-colorPicker` — **PHẦN LỚN CHỦ ĐỘNG GIỮ NGUYÊN** (không migrate) do phát hiện feature-gap thật ở component thay thế, xem mục 2. Full log thực chiến `..\u002Fbmad\u002Fprimeng-v22-migration\u002F` đã xóa khi dọn BMAD hoàn thành (2026-07-16) — gotchas đáng giữ đã đúc kết hết vào file này.\n>\n> **Bug upstream chưa fix — MultiSelect \"chọn tất cả\" + filter (2026-07-24):** repo `primefaces\u002Fprimeng` trên GitHub đã **archived (read-only) từ 2026-06-28** — không còn nhận fix cộng đồng. Header \"chọn tất cả\" của `p-multiselect` (khi có `[filter]=\"true\"`, dùng ở HẦU HẾT wrapper multiselect trong Cluvix) bấm BỎ chọn tất cả không clear đúng state — bug có thật, đã báo cáo nhiều lần trên GitHub, KHÔNG PHẢI lỗi code Cluvix: [#15516](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F15516), [#14603](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F14603), [#14252](https:\u002F\u002Fgithub.com\u002Fprimefaces\u002Fprimeng\u002Fissues\u002F14252) (fix cũ ở #14252 bị regress lại ở #15516, \"Needs Triage\", chưa fix ở bất kỳ version nào tính đến 22.0.0). Hướng xử lý (chưa làm, cần quyết định fan-out ~40 wrapper): tắt `[showToggleAll]=\"false\"` + tự viết nút \"chọn tất cả\" trong `base-multiselect-control.ts` và các wrapper không dùng base, không phụ thuộc logic nội bộ PrimeNG nữa.\n\nNguồn: https:\u002F\u002Fprimeng.dev\u002Fmigration\u002Fv22 (đọc 2026-07-08).\n\n---\n\n## 0. CRITICAL — v22 bắt buộc license key, kể cả bản miễn phí (KHÔNG có ở v21 trở về trước)\n\nTừ v22, PrimeNG (rebrand \"PrimeUI\") verify license key offline qua `@primeui\u002Flicense-manager` (chữ ký Ed25519), gọi qua `providePrimeNG({..., license: 'KEY'})`. Không có key hợp lệ → banner đỏ \"Invalid PrimeUI License\" góc dưới phải (không chặn thao tác, nhưng là vấn đề compliance thật).\n\n- **Community License (miễn phí)**: doanh thu \u003C $1M\u002Fnăm, \u003C 5 dev, \u003C 10 nhân viên, \u003C $3M vốn gọi được. Renew hàng năm.\n- **Commercial License (trả phí)**: công ty không đạt điều kiện trên.\n- Đăng ký: https:\u002F\u002Fprimeui.dev\u002Flicenses\u002Fcommunity hoặc `\u002Fcommercial`.\n- **Hết hạn KHÔNG hỏng chức năng** — chỉ banner đỏ; `verified()` chỉ được đọc để hiện banner, không gate component nào.\n- **Chỉ tier `community` bị kiểm theo đồng hồ** (`Date.now() > exp`, grace 30 ngày). Mọi tier còn gate thứ 2: `RELEASE_DATE` của bản PrimeNG > `exp` ⇒ \"expired\" NGAY, **không grace** — nâng PrimeNG lên bản phát hành sau ngày hết hạn key cũng cần key mới.\n\n**Đây là quyết định kinh doanh, KHÔNG tự động hoá được** — phải chốt trước khi coi migration là hoàn tất, dù build\u002Ftsc\u002Flint đều pass bình thường không có key.\n\n**Cách lưu key (đổi 2026-09-05)**: key nạp lúc CHẠY từ file JSON trên CDN — `share\u002Futils\u002Fprimeui-license.util.ts`; `app.config.ts` đọc lazy `get license() { return primeuiLicense(); }` (gán thẳng sẽ đóng băng giá trị lúc load module). `environment.primeuiLicense` ở 3 file nay chỉ là FALLBACK. Gia hạn = sửa file trên CDN, KHÔNG build lại.\n\n---\n\n## 1. Breaking change quan trọng nhất — base font-size 14px → 16px\n\nPrimeNG tính kích thước component theo `rem` dựa trên root font-size. v22 đổi mặc định từ 14px → 16px (khớp browser default). Có \"compat variant\" preset giữ 14px cho layout cũ.\n\n**Trước khi upgrade:** xác nhận layout hiện tại (đặc biệt các bảng dày đặc, form nhiều field) không vỡ khi component to hơn ~14%. Nếu không muốn sửa layout ngay → bật compat variant thay vì để mặc định 16px.\n\n---\n\n## 2. Component deprecated (xoá hẳn ở v24) — kết quả migrate thật (2026-07-09)\n\n**PHÁT HIỆN QUAN TRỌNG NHẤT của đợt migrate này: \"deprecated, còn hoạt động tới v24\" ≠ \"thay thế mới có đầy đủ tính năng\".** Ban đầu giả định thay component chỉ là đổi tên tag — THỰC TẾ hầu hết component thay thế ở generation v22 sớm này **thiếu tính năng thật so với bản cũ**, không phải chỉ khác API bề mặt. Trước khi migrate BẤT KỲ component nào trong bảng dưới, BẮT BUỘC so sánh 2 danh sách `@Input` qua `node_modules\u002Fprimeng\u002Ftypes\u002Fprimeng-{old}.d.ts` vs `primeng-{new}.d.ts` (lệnh: `grep 'ɵɵComponentDeclaration\u003CX,' file.d.ts`), rồi grep xem file thật trong repo có dùng prop nào nằm trong phần \"chỉ có ở bản cũ\" không — nếu có, ĐỪNG migrate mù.\n\n| Component cũ | Thay bằng | Số file thực tế | Kết quả |\n|---|---|---|---|\n| `pTemplate` | `ng-template` + reference variable | 129 | ✅ Migrate xong 100% — nhưng **KHÔNG tương đương**: xem cảnh báo ngay dưới bảng |\n| `p-multiSelect` (`p-multiselect` sau rename casing) | `p-select` với `multiple` | 137 | ⚠️ **Migrate 54\u002F137, giữ nguyên 83** — `p-select` thiếu `maxSelectedLabels`\u002F`display`\u002F`selectedItemsLabel`\u002F`showToggleAll`, không có template hook thay thế. Chỉ migrate file KHÔNG dùng các prop này |\n| `p-password` | directive `pPassword` | 2 | ❌ **Giữ nguyên cả 2** — directive KHÔNG có UI toggle tương tác (`showPassword` chỉ ép `type=text` 1 chiều, không phải nút bấm), KHÔNG có strength-meter overlay (`feedback` là dead prop trên directive) |\n\n> ⛔ **`pTemplate` trong code MỚI = bảng rỗng, im lặng.** Bảng trên là nhật ký một đợt migrate đã xong,\n> KHÔNG phải \"chuyện đã đóng\". Ở v22 `p-table` chỉ đọc `\u003Cng-template #header|#body|#expandedrow|#emptymessage|#caption|#footer|#loadingbody>`;\n> `pTemplate=\"header\"` vẫn là directive HỢP LỆ nên `tsc` và `ngc --noEmit` đều xanh, nhưng component\n> không nhận template ⇒ render ra bảng **không header, không dòng, không cả empty state**, không lỗi\n> console. Dính thật 2026-09-09 trên production. Danh sách tên template + ví dụ ❌\u002F✅:\n> `frontend\u002Fskill\u002Fskills\u002Fbuilding-angular-signal-forms\u002Freference\u002Ffe-patterns-gotchas-form.md` §`pTemplate` deprecated.\n>\n> Trước khi viết một API PrimeNG theo trí nhớ, đếm xem repo đang dùng cách nào:\n> `grep -rho '\u003Cng-template #[a-z]*' --include='*.html' src\u002Fapp | sort | uniq -c | sort -rn`.\n> 440 file dùng `#header`, 1 file dùng `pTemplate` — file thiểu số là file sai.\n| `p-galleria` | `p-gallery` | 1 | ❌ **Giữ nguyên** — `p-gallery` thiếu `value` (!), `numVisible`, `showThumbnails`, `circular`, `fullScreen`... không cách nào bind data được |\n| `p-colorPicker` (`p-colorpicker` sau rename casing) | `p-inputColor` | 3 | ❌ **Giữ nguyên** — `p-inputcolor` là UI widget khác hẳn (0 overlay\u002Fpanel logic, có vẻ dùng slider\u002Farea trực tiếp thay vì popup swatch cũ), đổi trải nghiệm quá lớn để migrate mù |\n| `p-editor` | PrimeUI PRO Editor (trả phí) | 17 | ⛔ Out of scope — chờ quyết định licensing PrimeUI PRO |\n| `p-chart` | PrimeUI PRO Charts (trả phí) | 13 | ⛔ Out of scope — chờ quyết định licensing PrimeUI PRO |\n| `p-panelMenu` | `p-menu` với `toggleable` | 0 | — |\n| `p-inputMask` | directive `pInputMask` | 0 | — |\n| `p-scrollPanel` | `p-scrollArea` | 0 | — |\n| `p-image` | `p-gallery` | 0 | — |\n\n**Component nào \"giữ nguyên\" ở trên đều vẫn hoạt động bình thường** (chỉ deprecated, chưa xoá tới v24) — không phải lỗi, là quyết định có căn cứ. Revisit khi PrimeNG bổ sung tính năng tương đương cho bản thay thế, hoặc gần mốc v24 buộc phải xử lý.\n\n**Input class có thể là input CHẾT — verify trước khi khoanh style qua nó:** đọc `classes.root` trong `node_modules\u002Fprimeng\u002Ffesm2022\u002Fprimeng-\u003Ccomp>.mjs` xem input đó có được nối vào class thật không. `p-galleria` v22: `containerClass` khai nhưng KHÔNG gắn vào root (mọi CSS khoanh theo nó vô tác dụng); chỉ `maskClass` áp thật.\n\n**`p-editor`\u002F`p-chart` migrate sang PrimeUI PRO — cần xác nhận licensing trước khi upgrade**, không phải thuần code change.\n\n**Nút con của `\u003Cp-buttongroup>` PHẢI giữ component `\u003Cp-button>`, KHÔNG đổi sang `\u003Cbutton pButton>`** — CSS buttongroup chọn theo tên thẻ (`.p-buttongroup p-button:not(:last-child) .p-button`), đổi sang directive thì các nút tách rời, bo tròn riêng lẻ; build không báo lỗi. Ngoài buttongroup vẫn dùng `\u003Cbutton pButton>`.\n\n---\n\n## 2.1 — p-tabs [lazy]=\"true\" KHÔNG lazy thật (rc.2)\n\n`TabPanel.shouldRender()` trả `true` cho tab không active ngay lần render đầu — panel vẫn ẩn đúng qua CSS\nnhưng component con bên trong đã bị tạo, mọi HTTP fetch trong `ngOnInit` bắn ra ngay. Verified qua unit\ntest cô lập (TestBed + component thật từ node_modules\u002Fprimeng), không phải do cách viết template của app.\n\n✅ Fix: bỏ `[lazy]=\"true\"`, bọc nội dung mỗi `\u003Cp-tabpanel>` (trừ tab mặc định active) bằng\n`@defer (when activeTab() === 'X')` — tự có \"render 1 lần rồi giữ\" + code-split JS riêng từng tab.\nCần `activeTab` là signal + `[value]=\"activeTab()\"` + `(valueChange)=\"activeTab.set(...)\"` (controlled).\n\n`p-tabpanel` ẩn panel bằng host attribute `hidden` → nội dung đã render GIỮ NGUYÊN trong DOM, `@defer`\nchỉ chạy 1 lần (verified `node_modules\u002Fprimeng\u002Ffesm2022\u002Fprimeng-tabs.mjs`).\n\n- `@defer` không khai `@placeholder` → render RỖNG cho tới khi `@loading` kịp hiện (`after 150ms`): panel sập về 0px rồi nhảy 2 nhịp. LUÔN khai `@placeholder`, và cho cả placeholder lẫn loading `min-height` bằng chiều cao panel.\n- `min-height` đặt ở `\u003Cp-tabpanels>` (1 lần cho mọi tab), KHÔNG đặt riêng trong 1 panel — đặt lẻ thì card co giãn mỗi lần đổi tab.\n\n---\n\n## 3. Removed API (đã deprecated từ v20\u002Fv21, giờ xoá hẳn)\n\n- `@primeng\u002Fthemes` → `@primeuix\u002Fthemes`\n- `pTemplate` → `ng-template` + reference variable (xem bảng trên)\n- **CamelCase selector → kebab-case\u002Flowercase — ĐÂY LÀ ĐIỂM GÂY LỖI NHIỀU NHẤT KHI MIGRATE THẬT** (không phải chỉ vài attribute nhỏ như hiểu ban đầu — áp dụng cho TÊN COMPONENT SELECTOR). Component compile ra selector toàn lowercase-liền hoặc kebab-case (VD: `p-multiselect, p-multi-select`), selector camelCase cũ (`p-multiSelect`) KHÔNG còn match được nữa — Angular coi thẻ đó là unknown element, kéo theo TOÀN BỘ property binding trên thẻ báo lỗi \"unknown property\" (rất dễ nhầm tưởng property bị đổi\u002Fxoá, thực ra chỉ do thẻ không match). Danh sách đã xác nhận thật khi migrate Cluvix: `p-autoComplete`→`p-autocomplete`, `p-avatarGroup`→`p-avatargroup`, `p-buttonGroup`→`p-buttongroup`, `p-cascadeSelect`→`p-cascadeselect`, `p-cellEditor`→`p-celleditor`, `p-colorPicker`→`p-colorpicker`, `p-confirmDialog`→`p-confirmdialog`, `p-dataView`→`p-dataview`, `p-datePicker`→`p-datepicker`, `p-fileUpload`→`p-fileupload`, `p-inputGroup`→`p-inputgroup`, `p-inputGroupAddon`→`p-inputgroup-addon` (dạng đặc biệt, không phải kebab thuần), `p-inputNumber`→`p-inputnumber`, `p-multiSelect`→`p-multiselect`, `p-orderList`→`p-orderlist`, `p-progressBar`→`p-progressbar`, `p-progressSpinner`→`p-progressspinner`, `p-radioButton`→`p-radiobutton`, `p-selectButton`→`p-selectbutton`, `p-tableCheckbox`→`p-tablecheckbox`, `p-tableHeaderCheckbox`→`p-tableheadercheckbox`, `p-toggleSwitch`→`p-toggleswitch`. **Verify đúng bằng cách grep selector thật trong `node_modules\u002Fprimeng\u002Ffesm2022\u002F*.mjs`** (`selector: \"...\"`), KHÔNG đoán — vài selector không theo pattern kebab thuần (VD `inputGroupAddon`).\n- `pButton` icon\u002Flabel property → directive `pButtonIcon`\u002F`pButtonLabel` (dùng content projection `\u003Cspan pButtonLabel>{{...}}\u003C\u002Fspan>`, không phải `[label]=\"...\"` binding nữa)\n- `p-message` mất input `[text]` — chuyển sang content projection `\u003Cp-message>{{...}}\u003C\u002Fp-message>`\n- `p-drawer`\u002F`p-dialog` mất `[transitionOptions]` — xoá binding (dùng animation mặc định) hoặc dùng `motionOptions` mới nếu cần tuỳ biến\n- `p-tabs [scrollable]` deprecated (cuộn là mặc định) — bỏ attribute, không thì vỡ ở bản sau.\n- `p-tabview`, `p-buttonset`, `p-fluid` không còn được emit ở v22 — CSS bám các class này là chết. Trước khi xoá CSS nghi chết: `grep -rl '\u003Cclass>' node_modules\u002Fprimeng\u002Ffesm2022\u002F*.mjs`, rỗng mới xoá.\n- `showTransitionOptions`\u002F`hideTransitionOptions` → native CSS animation. Thay bằng override class `.{classname}-enter-active`\u002F`.{classname}-leave-active` (định nghĩa animation name\u002Fduration\u002Feasing qua CSS, không qua property JS). 3 nhóm class theo component: anchored overlay (`p-anchored-overlay-*`, dùng cho Select\u002FPopover\u002FAutoComplete), collapsible (`p-collapsible-*`, dùng cho Accordion\u002FPanel\u002FFieldset\u002FStepper), dialog\u002Fdrawer (`p-dialog-*`\u002F`p-drawer-*`). Override global (ảnh hưởng mọi component nhóm đó) hoặc scoped (gắn class riêng từng instance). Chi tiết: https:\u002F\u002Fprimeng.dev\u002Fguides\u002Fanimations\n\n---\n\n## 4. InputMask — component → directive\n\n`InputMask` chuyển từ component riêng sang directive `pInputMask` gắn lên `\u003Cinput>` chuẩn (cùng pattern với `pInputPassword`, `pButtonIcon`). Repo hiện chưa dùng `p-inputMask` (0 file) — không phải audit khi upgrade, nhưng feature mới cần input mask thì viết thẳng theo API v22, không dùng API v21 cũ.\n\n---\n\n## 4.1 CommandMenu — component mới v22, KHÔNG có overlay built-in\n\n`p-commandmenu`\u002F`p-command-menu` chỉ là search-palette INLINE (nhận `model: MenuItem[]`, tự filter theo `search`, gọi `item.command` khi chọn) — không có `visible`\u002Foverlay\u002Fpopup nào tự thân.\nMuốn dùng kiểu Cmd+K command palette (bật\u002Ftắt qua phím tắt) → PHẢI tự bọc trong `p-dialog` (pattern giống `GlobalSearch`: 1 service `WritableSignal\u003Cboolean>` + `p-dialog [visible]=\"service.visible()\"`), không có prop `visible` riêng của CommandMenu để dùng.\n\n---\n\n## 4.2 Option list (`p-autocomplete`\u002F`p-select`) mặc định `white-space: nowrap; overflow: hidden`\n\nTheme gốc (`@primeuix\u002Fstyles`) đã set sẵn, KHÔNG có `text-overflow: ellipsis` — text dài tự động bị clip, KHÔNG wrap xuống dòng. `virtualScrollItemSize` cố định dùng an toàn dù item có text dài, không cần lo item wrap phá layout virtual-scroll.\n\n---\n\n## 4.3 `p-avatar` — `label` ưu tiên hơn `image`, truyền cả 2 thì ảnh không bao giờ hiện\n\nTemplate gốc của `Avatar`: `@if (label()) {...} @else if (image()) {...}` — `label` LUÔN thắng nếu có giá trị. Component nào truyền CẢ `[image]` lẫn `[label]` cùng lúc (kiểu \"ảnh nếu có, chữ tắt nếu không\") thì ảnh KHÔNG BAO GIỜ hiện — bug thật gặp phải ở `indexeddb\u002Fconfig\u002Fcomponents\u002Fuser\u002Fuser-avatar.ts` (2026-08-30, đã fix). Phải tách `@if (hasImage) { \u003Cp-avatar [image]> } @else { \u003Cp-avatar [label]> }`, không bind cả 2 song song.\n\n---\n\n## 4.4 Đổi cỡ\u002Fmàu component PrimeNG từ NGOÀI — dùng biến, không đấu class\u002F`::ng-deep`\n\nClass tiện ích đặt trên host **không** đổi được kích thước component: `\u003Cp-avatar class=\"w-10 h-10\">` vẫn ra **28px** vì `.p-avatar { width: var(--p-avatar-width) }` cùng specificity (0,1,0) nhưng nạp SAU nên thắng — trong khi `\u003Cdiv class=\"w-10 h-10\">` ngay cạnh ra 35px, hai loại avatar lệch nhau mà không ai thấy (đo 2026-09-04).\n\n`::ng-deep` từ component CHA cũng thường thua: Angular gắn `_ngcontent` vào **từng phần tử** trong style của component con, nên `:host > button i` biên dịch thành **(0,3,2)** — cao hơn hầu hết selector `::ng-deep` viết được từ cha.\n\n**Đúng cách: set BIẾN của chính component** (`--p-avatar-width`\u002F`--p-avatar-height`, `--p-icon-size`) ở phần tử cha bất kỳ — biến CSS thừa kế nên không phải đua specificity. Component tự viết mà muốn nơi mount đổi được thì khai biến riêng có fallback: `font-size: var(--tb-icon-size, 1.25rem)`.\n\n⚠ Biến KHÔNG tồn tại thì `background: var(--x)` thành **invalid at computed-value time** ⇒ phần tử về `transparent`, hỏng câm. Kiểm `getComputedStyle(document.documentElement).getPropertyValue('--x')` trước khi dùng một bậc màu mới (vd `--p-primary-900`).\n\n---\n\n## 5. Checklist khi nâng cấp tiếp \u002F audit lại (đã áp dụng xong cho lần migrate 2026-07-09)\n\n```\n☑ Xác nhận Angular core ≥ version PrimeNG yêu cầu — Angular 22 đã sẵn, nhưng PHẢI tự bump @angular\u002Fcdk theo cùng version (không tự động theo `ng update`\u002F`npm install primeng`)\n☑ Bump @angular\u002Fcdk khớp version primeng yêu cầu (`npm ls @angular\u002Fcdk` — peer dep \"invalid\" KHÔNG phải nguyên nhân chính gây lỗi build, xem mục 3 \"CamelCase selector\" mới là root cause thật)\n☑ Quyết định licensing key trước khi coi migration hoàn tất (mục 0) — đã tích hợp qua environment.prod\u002Flocal.ts (gitignored)\n☑ Quyết định base font-size: đã chọn giữ compat 14px qua @primeuix\u002Fthemes\u002Fmaterial-compat\n☑ Migrate pTemplate (129 file) — xong 100%, an toàn hoàn toàn\n☑ So sánh prop-gap TỪNG component deprecated trước khi migrate — đã làm cho p-multiSelect\u002Fp-password\u002Fp-galleria\u002Fp-colorPicker, phát hiện gap thật ở tất cả (xem mục 2)\n□ p-editor\u002Fp-chart — CHƯA quyết định licensing PrimeUI PRO, vẫn out of scope\n□ Nếu upgrade tiếp lên bản v22 stable (khác RC hiện tại) → re-run toàn bộ `ng build` để xem PrimeNG có đổi API thêm gì giữa rc.2 và stable không, ĐỪNG giả định giống hệt\n```\n\n---\n\n## 6. Tham chiếu thêm\n\n- Angular framework upgrade (khác PrimeNG, đừng nhầm số version): `frontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002FSKILL.md`\n- PrimeNG v21 component convention hiện tại: `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002FSKILL.md` (Stack notes)\n\n\n> **Đọc file này trước khi làm bất kỳ feature FE mới nào.**\n> Mục tiêu: luôn dùng API mới nhất của Angular, tránh viết code theo pattern cũ.\n\nPhiên bản hiện tại: **Angular 22.0** (nâng từ 21.1, tháng 6\u002F2026).\nNode yêu cầu: **≥ 22.22.3 hoặc 24+** (dự án đang dùng Node 24).\n\n---\n\n## 1. API mới stable trong v22 — ưu tiên dùng ngay\n\n### `apiResource()` \u002F `rxResource()`\nThay thế pattern `ngOnInit + service.getXxx().subscribe(...)` khi load data đơn giản.\n\n**KHÔNG dùng `httpResource()` raw** — thiếu `withCredentials` (→ 401), bypass `afterLoad()`. Dùng wrapper `apiResource()` → Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002Freference\u002Fresource-patterns.md`\n\n```typescript\n\u002F\u002F ❌ Cũ — boilerplate, phải tự cleanup\nngOnInit() {\n  this.service.getPatient(this.id).pipe(takeUntilDestroyed(this.destroyRef)).subscribe(r => {\n    this.patient.set(r.data);\n  });\n}\n\n\u002F\u002F ✅ Mới — apiResource (wrapper httpResource, share\u002Fresource\u002Fapi-resource.ts)\nreadonly patient = apiResource\u003CPatient>(() => ({ path: `crm\u002Fpatient\u002F${this.id()}` }));\n\u002F\u002F patient.value() → data, patient.isLoading() → loading state, patient.error() → lỗi\n```\n\n**Khi nào dùng:**\n- Load data theo signal param (id thay đổi → tự re-fetch)\n- Thay thế `ngOnInit + subscribe` cho các GET đơn giản\n- Không phù hợp: POST\u002FPUT\u002FDELETE, hoặc fetch cần transform phức tạp — dùng `rxResource()` hoặc service call\n\n### `@Service` decorator\nThay `@Injectable({ providedIn: 'root' })` cho service mới, kèm rule `inject()` → Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002FSKILL.md` (Stack notes). Service cũ giữ nguyên, không migrate hàng loạt.\n\n### Signal debounce built-in — `.debounced()`\n→ Xem `frontend\u002Fskill\u002Fskills\u002Ffrontend-hard-rules\u002Freference\u002Fresource-patterns.md` (section Signal debounce).\n\n---\n\n## 2. Signal Forms (stable v22)\n\nĐã tách sang `skill\u002Fskills\u002Fbuilding-angular-signal-forms\u002FSKILL.md` (2026-08-10, file này vượt 350 dòng) — đọc file đó trước khi viết\u002Fconvert\nbất kỳ form Signal Forms nào (kết luận spike, 23 gotcha, pattern mẫu).\n\n## 3. Breaking changes đã xử lý — KHÔNG cần làm gì thêm\n\n| Breaking change | Trạng thái |\n|---|---|\n| `ChangeDetectionStrategy.Default` → `Eager` | ✅ Không ảnh hưởng — 100% component đã `OnPush` |\n| `afterRender()` → `afterEveryRender()` | ✅ Không dùng trong codebase |\n| `TestBed.get()` removed | ✅ Không dùng |\n| Route param inheritance từ ancestor | ✅ Chỉ 1 chỗ (`app.breadcrumb.ts:149`) — đọc `.data` không phải `.params`, an toàn |\n| Karma removed | ✅ Đã xử lý từ v21 |\n\n---\n\n## 3.1. `provideAnimationsAsync`\u002F`provideAnimations` deprecated — CỐ Ý CHƯA MIGRATE\n\nIDE báo `TS6385: provideAnimationsAsync is deprecated` trong `app.config.ts` — deprecated từ Angular v20.2, khuyến khích chuyển sang `animate.enter`\u002F`animate.leave` (native CSS, bỏ `@angular\u002Fanimations`), dự kiến xoá hẳn ở **v23**.\n\n**KHÔNG xoá\u002Fmigrate ngay** — PrimeNG (kể cả v22) vẫn phụ thuộc `@angular\u002Fanimations`, bỏ `provideAnimations()` làm hỏng animation của `Dialog`\u002F`OverlayPanel`\u002F`Tooltip`\u002F`Menubar` (xác nhận qua issue GitHub `primefaces\u002Fprimeng#18863`, Open, chưa có fix\u002Fworkaround — repo gốc đã archive, PrimeNG rebrand \"PrimeUI\" chưa migrate kịp). Còn thời gian tới v23, giữ nguyên tới khi PrimeNG tự cập nhật.\n\n---\n\n## 4. Suppressions hiện tại — lý do và roadmap\n\n### NG8107 + NG8102 (suppressed trong `tsconfig.json`)\n- **NG8107**: `?.` dùng thừa — TypeScript type không include `null | undefined`\n- **NG8102**: `??` dùng thừa — tương tự\n\nSuppressed vì: 2400+ occurrences, fix tay = rủi ro runtime crash nếu type không chính xác.\nFix đúng là **tighten TypeScript types** từng module, làm dần — không phải xóa `?.` cơ học.\n\n**Roadmap fix đúng (làm theo module, không rush):**\n```\n1. Chọn 1 module nhỏ (vd: loyalty\u002Fbroker)\n2. Tìm NG8107\u002FNG8102 warnings trong module đó\n3. Với mỗi warning: xem field có thực sự nullable không\n   - Nullable → thêm `| null` vào type\n   - Không nullable → xóa `?.` \u002F `??`\n4. Sau khi fix 1 module → verify build + test\n```\n\n### TS5101 `baseUrl` deprecated\nThêm `\"ignoreDeprecations\": \"6.0\"` vào tsconfig. Angular CLI vẫn cần `baseUrl` cho path aliases (`@\u002F*`).\nFix thật: migrate sang `paths` without `baseUrl` khi TypeScript 7.0 release.\n\n### `photoswipe\u002Fstyle.css` (TS2882)\n`src\u002Ftypings.d.ts` khai báo `declare module '*.css'`. Đây là pattern chuẩn.\n\n---\n\n## 5. Checklist khi làm feature FE mới (Angular 22+)\n\n```\n□ Service mới → dùng @Service() thay @Injectable({ providedIn: 'root' })\n□ Load data theo param → cân nhắc apiResource() thay ngOnInit+subscribe (KHÔNG httpResource raw)\n□ Debounce signal → dùng .debounced(300) thay toObservable+debounceTime\n□ OnPush + signals → không mutate object trực tiếp\n□ KHÔNG dùng zone.js API trực tiếp (setTimeout, setInterval) — dùng rxjs hoặc signal\n□ i18n: npm run i18n:find trước khi tạo key mới\n```\n\n---\n\n## 6. Upgrade tiếp theo — Angular 23+\n\nAngular release 1 major\u002F6 tháng. Angular 23 dự kiến **tháng 12\u002F2026**.\n\nTrước khi upgrade:\n1. Đọc blog.ninja-squad.com + angular.love cho release notes\n2. Chạy `ng update --dry-run` để preview\n3. Kiểm tra Node version yêu cầu (xu hướng tăng theo LTS)\n4. Fix permission file trước khi chạy migration: `chmod -R u+w src\u002F`\n\nLệnh nâng:\n```bash\nnvm use 24   # hoặc version LTS mới hơn\nng update @angular\u002Fcore@23 @angular\u002Fcli@23\nnpx tsc --noEmit  # verify sau upgrade\n```\n\n---\n\n## 7. Test builder Karma → Vitest (`@angular\u002Fbuild:unit-test`)\n\n- Builder cần thấy literal `\"zone.js\"` trong mảng `polyfills` của build target để chọn strategy `'static'` (import thường). Nếu app dùng file polyfills custom (`\"src\u002Fpolyfills.ts\"`) thay vì literal `\"zone.js\"`, builder rơi vào `'dynamic'` (top-level await) → fail build test với lỗi \"Top-level await is not available\".\n- Fix: thêm 1 build configuration riêng cho test (không đụng production) với `polyfills: [\"src\u002Fpolyfills.ts\", \"zone.js\"]`, trỏ `test.options.buildTarget` sang configuration đó.\n- Cần cài thêm `jsdom` làm devDependency — không tự bundle kèm vitest.\n\n\n`environment.option: 1 | 2 | 3` trong mỗi file `environment*.ts` — điều khiển module nào hiển thị cho client.\n\n## Tier mapping\n\n| Option | Modules |\n|--------|---------|\n| 1 | CRM, Chăm sóc KH, Nhân sự, Kế toán |\n| 2 | Option 1 + Sale, Kho & Vật tư, EMR |\n| 3 | Tất cả (thêm: Loyalty, Dược & Vật tư, Marketing, Zalo, Cấu hình) |\n\n## Implementation\n\n**Home** (`src\u002Fapp\u002Fmodules\u002Futilities\u002Fhome\u002Fhome.ts`):\n- `ModuleDef.minOption?: number` — tier tối thiểu để hiển thị module\n- Filter trong `computed`: `environment.option \u003C (m.minOption ?? 1)` → ẩn\n\n**Topbar** (`src\u002Fapp\u002Flayout\u002Fcomponents\u002Fapp.topbar.ts`):\n- `protected readonly envOption = environment.option`\n- Template dùng `@if (envOption >= 2)` \u002F `@if (envOption >= 3)` bao quanh từng module block\n\n## Mobile (khác web: KHÔNG build-time)\n\nMobile 1 app cho mọi tenant → tier đọc runtime: option `erpOption` (1|2|3, default 3) trong config_systems (`dexie.ConfigSystemsSetOption(db, define.OptErpOption, v)`) → `\u002Fapi\u002Fmobile\u002Fv1\u002Fping` trả `erp_option` → app persist + filter module theo `minOption` (mirror computed Home web). Đổi tier: sửa option, hiệu lực ≤1 phút, không deploy.\n\n## Thay đổi tier cho client\n\nChỉ sửa `option` trong `environment.prod.ts` của client đó:\n```ts\nexport const environment = {\n  prod: true,\n  option: 2,  \u002F\u002F ← đổi 1 | 2 | 3\n  apiUrl: '\u002Fapi',\n  isDental: false,\n};\n```\n\n## Thêm module mới vào tier system\n\n1. **Home**: thêm `minOption: \u003C1|2|3>` vào object trong `allModules`\n2. **Topbar**: bọc `\u003Ca routerLink=\"...\">` bằng `@if (envOption >= \u003Cn>) { ... } \u003C!-- comment -->`\n\n## File nào tracked git, file nào không\n\n`environment.ts` (base, dùng khi `ng serve` không có `-c`) — TRACKED git.\n`environment.prod.ts`\u002F`environment.local.ts` (dùng qua `fileReplacements` trong `angular.json` cho `-c production`\u002F`-c local`) — GITIGNORED.\nSecret\u002FAPI key\u002Flicense key → đặt ở `environment.prod.ts`\u002F`environment.local.ts`, để rỗng `''` ở `environment.ts`. KHÔNG hardcode secret trực tiếp vào `.ts` khác (vd `app.config.ts`) — mọi file `.ts` ngoài `environments\u002F` đều tracked git.\n",{"name":5,"description":7},"main","ea9f5ed9bd4eaf32e9489bcbe9603955c1462a63","frontend\u002Fskill\u002Fskills\u002Fusing-primeng-components",20,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm","https:\u002F\u002Fgithub.com\u002Fcluvix","cluvixsolutions.com","Cluvix Solutions is a technology outsourcing company specializing in custom software development for growing businesses. We build end-to-end enterprise solution","2026-11-02 19:55:39",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add cluvix\u002Fcluvix-crm --skill using-primeng-components",{"tool":39,"command":40},"bunx","bunx skills add cluvix\u002Fcluvix-crm --skill using-primeng-components",{"tool":42,"command":43},"pnpm","pnpm dlx skills add cluvix\u002Fcluvix-crm --skill using-primeng-components","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Ffrontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"reference\u002Ffe-patterns-gotchas-build.md","REFERENCE","参考文档",29906,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Ffrontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002Freference\u002Ffe-patterns-gotchas-build.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"reference\u002Fui.md",19243,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Ffrontend\u002Fskill\u002Fskills\u002Fusing-primeng-components\u002Freference\u002Fui.md",[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7F47FCP2MP548SWCP0BJ6B1","writing-mysql-migrations","Viết migration MySQL cho Cluvix (golang-migrate, Go + GORM): quy ước timestamp, idempotent ADD\u002FDROP COLUMN, FK constraint thật, decimal tiền, MySQL 9.7 LTS syntax mới\u002Fcũ, và luật CẤM tuyệt đối test\u002Fmigrate chạm DB dev\u002Fprod thật. Dùng skill này TRƯỚC KHI tạo file migration mới, sửa schema, thêm cột\u002FFK, backfill dữ liệu, hoặc trước khi chạy `cmd\u002Fmigrate`\u002Fintegration test đụng tới database — kể cả migration chỉ 1-2 dòng.","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-mysql-migrations\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7F475VEPATD0D8KP8V2HHYV","writing-backend-resources","Hướng dẫn quy trình 6 bước TẠO MỚI resource backend Go (entity, dao, repository, service, handler, router, DTO, module layout) cho ERP Cluvix. Dùng skill này TRƯỚC KHI tạo resource CRUD mới hoặc module mới trong internal\u002Fmodules\u002F, khi cần biết Handler DI\u002FRouter\u002FRepository Reader\u002FDTO pattern chuẩn, hoặc trước khi đụng module service (status filter 2 tầng, cascade, optimistic lock). KHÔNG dùng skill này để debug\u002Fsửa query đang sai — xem debugging-backend-queries cho việc đó.","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-backend-resources\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7F46Z6MMBQ0AP2ZA5HW5R4X","working-on-ops","Hướng dẫn nghiệp vụ dashboard CRM, export, và import dữ liệu trong module ops của backend Cluvix. Dùng skill này KHI đụng report\u002Fdashboard CRM, thêm cột export (`?columns=`), hoặc import khách hàng (migration onboard SAAS client) — đọc trước khi đổi bất kỳ hành vi nào trong các luồng này.","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-ops\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7F46PPNCK976F4SYWVHXAHC","working-on-hr","Quy tắc và pattern nghiệp vụ HR Cluvix trong CRM standalone: user nội bộ, role\u002FRBAC, đổi\u002Fđặt lại mật khẩu, import user. Dùng skill này KHI làm feature\u002Fsửa bug đụng module hr (chỉ còn `hr\u002Fuser`) — trước khi đọc code.","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-hr\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7F468VEARVSRRYBJ8VHJSJ3","working-on-crm","Quy tắc và pattern nghiệp vụ CRM Cluvix: khách hàng, lịch hẹn, liệu trình, đơn hàng, thanh toán. Dùng skill này KHI làm feature\u002Fsửa bug đụng module crm (customer, appointment, order, treatment, payment) — trước khi đọc code, để tránh phá vỡ business rule đã có (tái khai thác, customer status IN(...)).","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7F45Y15Q0CBEP06CFF2AAEY","working-on-config","Quy tắc và pattern nghiệp vụ Config Cluvix còn sống trong CRM standalone: mẫu in (print_template), control field trong bảng (control_field_in_table), IndexedDB sync của config. Dùng skill này KHI làm feature\u002Fsửa bug đụng các module đó — trước khi đọc code. Tổng đài\u002Fchữ ký số\u002FAI config đã bỏ (chỉ còn mô tả lịch sử trong skill, KHÔNG áp dụng).","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-config\u002FSKILL.md",[],[]]