[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F45Y15Q0CBEP06CFF2AAEY":3,"skill-same:01M7F45Y15Q0CBEP06CFF2AAEY":61},{"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},"01M7F45Y15Q0CBEP06CFF2AAEY","working-on-config",null,"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).","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\u002Fskill\u002Fskills\u002Fworking-on-config\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: working-on-config\ndescription: >-\n  Quy tắc và pattern nghiệp vụ Config Cluvix còn sống trong CRM standalone: mẫu in\n  (print_template), control field trong bảng (control_field_in_table), IndexedDB sync\n  của config. Dùng skill này KHI làm feature\u002Fsửa bug đụng các module đó — trước khi đọc\n  code. Tổng đài\u002Fchữ ký số\u002FAI config đã bỏ (chỉ còn mô tả lịch sử trong skill, KHÔNG\n  áp dụng).\n---\n\n# Working on Config\n\n> ⚠ **(đã bỏ, D15\u002FCRM standalone)** Verify 2026-09-28: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002F` trong repo\n> CRM standalone này KHÔNG có `config_call_center`, `config_digital_signature`,\n> hay module `ai` — chỉ còn `branch`, `business_profile`, `appointment_*`, `control_field_in_table`,\n> `print_template` (CÒN SỐNG — section mẫu in bên dưới đã cập nhật theo code 2026-10-17),\n> `options`, `service`\u002F`service_type`, danh mục (`customer_category`, `source`...), `hr_department`,\n> `indexeddb`, `user_profile`, `userscope`... Các section bên dưới nói về tổng đài\u002FOmicall, chữ ký\n> số, AI config mô tả kiến trúc ERP cũ — giữ làm lịch sử\u002Ftham khảo, KHÔNG áp dụng cho repo\n> này. Mọi mention `company_id`\u002F`GetCompanyActiveID`\u002F`companyActiveId` trong các section đó cũng đã\n> bỏ cùng company (D15) — xem `CLAUDE.md` §Hard Rules cho model hiện tại (branch-only).\n>\n> reference\u002Fcall-center-fe.md: FE tổng đài · reference\u002Fomicall-api.md: Omicall REST API ·\n> reference\u002Fomicall-sdk.md: Omicall SDK.\n\n\n\nModule `config\u002Fconfig_call_center` — cấu hình tổng đài per company. Mỗi company có thể cấu hình nhiều provider, chỉ 1 active tại 1 thời điểm.\n\n## Bảng `config_call_center`\n\nNhiều record per company. `company_id IS NULL` = shared template (Core ERP, áp dụng cho tất cả công ty chưa config riêng).\n\n| Column | Type | Ghi chú |\n|---|---|---|\n| `company_id` | `INT UNSIGNED NULL` | NULL = shared template; có giá trị = riêng company đó |\n| `name` | `VARCHAR(255) NOT NULL` | Tên nhận dạng |\n| `provider_type` | `TINYINT UNSIGNED` | Xem constants bên dưới |\n| `config_system` | `JSON` | Credentials tổng đài — **SENSITIVE** |\n| `config_ext` | `JSON` | Danh sách máy nhánh `[{userId, ext, phonenumber, password}]` |\n| `config_other` | `JSON` | Cấu hình phụ — **SENSITIVE** |\n| `status` | `TINYINT` | `1` = active, `0` = inactive |\n\n## Entity — `dao\u002Fentity.go`\n\n```go\ntype ConfigCallCenter struct {\n    models.SimpleModel\n    CompanyID    *uint          `gorm:\"column:company_id;uniqueIndex:uq_company_name;index\" json:\"company_id\"`\n    \u002F\u002F ...\n}\n```\n\n**QUAN TRỌNG**: `CompanyID` phải là `*uint` (pointer) vì column nullable. `uint` zero=0≠NULL → GORM ghi 0 vào DB → orphaned data. Mọi check phải dùng `item.CompanyID != nil && *item.CompanyID > 0`.\n\n## Provider type constants — `pkg\u002Fdefine\u002Fcall_center.go`\n\n```go\nCallCenterProviderVoip24h  = 1   \u002F\u002F config_other.secret\nCallCenterProviderStringee = 2   \u002F\u002F config_system.API_SID, config_system.Secret_Key\nCallCenterProviderOmicall  = 3   \u002F\u002F config_system.api_key, config_system.sipRealm\n```\n\n**KHÔNG hardcode số** — dùng `define.CallCenterProvider(item.ProviderType)`.\n\n## Scope rule\n\n- Dùng `tenant.ScopedDBNullBranch(c, h.DB, \"config_call_center\")` — row `company_id IS NULL` luôn được trả về\n- GET\u002FUPDATE\u002FDELETE by id: `ScopedDBNullBranch(...).First(&item, id)` trước, rồi mới dùng `item.CompanyID`\n- **KHÔNG** `db.DB.First(&item, id)` trực tiếp\n\n## Active\u002FInactive logic — QUAN TRỌNG\n\nMỗi company chỉ có 1 provider active. Pattern đúng (sau khi CompanyID đổi sang `*uint`):\n\n```go\nvar item dao.ConfigCallCenter\nif err := tenant.ScopedDBNullBranch(c, h.DB, \"config_call_center\").First(&item, body.ID).Error; err != nil {\n    response.NotFound(c); return\n}\n\u002F\u002F Deactivate others in same company scope\nif item.CompanyID != nil && *item.CompanyID > 0 {\n    h.DB.Table(\"config_call_center\").Where(\"company_id = ? AND id != ?\", *item.CompanyID, item.ID).Update(\"status\", 0)\n} else {\n    h.DB.Table(\"config_call_center\").Where(\"company_id IS NULL AND id != ?\", item.ID).Update(\"status\", 0)\n}\nh.DB.Table(\"config_call_center\").Where(\"id = ?\", item.ID).Update(\"status\", 1)\n```\n\n**Lý do KHÔNG dùng `GetCompanyActiveID(c)`**: trả về company user đang active, nhưng row có thể thuộc company khác hoặc IS NULL → 0 rows affected mà GORM không báo lỗi.\n\n## Create — dùng LAST_INSERT_ID để reload\n\nRaw INSERT (để `company_id` ghi được NULL) rồi reload theo `LAST_INSERT_ID` thay vì query theo\nname+provider_type (tránh nhầm khi trùng name). Mọi đường tạo đi qua `insertConfigCallCenter`\n(`handler\u002Fhelpers.go`) — INSERT + `LAST_INSERT_ID` trong CÙNG 1 `db.Transaction`. Lý do + test đồng thời:\n`skill\u002Fskills\u002Fdebugging-backend-queries\u002Freference\u002Fpatterns-gotchas-data-integrity.md` §`LAST_INSERT_ID()`.\n\n## Credential masking — `handler\u002Fhelpers.go`\n\nPattern: show 6 ký tự đầu + `****`. Áp dụng cho tất cả GET responses và IndexedDB sync.\n\n```go\nmaskItemCredentials(&item)   \u002F\u002F mutate in-place trước khi trả response\n\n\u002F\u002F Khi update: restore nếu FE gửi lại masked value\nmergedCS, mergedCO := mergeCredentials(item.ProviderType, item.ConfigSystem, body.ConfigSystem, item.ConfigOther, body.ConfigOther)\n```\n\n**Fields bị mask theo provider:**\n- Stringee: `config_system.API_SID`, `config_system.Secret_Key`\n- Omicall: `config_system.api_key` (KHÔNG mask `sipRealm` hay `hotlines`)\n- Voip24h: `config_other.secret`\n\n`mergeCredentials` tự động giữ nguyên giá trị gốc nếu FE gửi lại masked value.\n\n**updateConfigCallCenterByProvider phải gọi cả 2:**\n```go\n\u002F\u002F UPDATE path: merge trước\nmergedCS, mergedCO := mergeCredentials(item.ProviderType, item.ConfigSystem, body.ConfigSystem, item.ConfigOther, body.ConfigOther)\n\u002F\u002F ...sau khi save:\nmaskItemCredentials(&item)\nresponse.Updated(c, item)\n```\n\n## List endpoint — response format\n\n```go\n\u002F\u002F ĐÚNG: c.JSON trực tiếp (BaseApiService.list() không unwrap .data)\nc.JSON(http.StatusOK, result)\n\n\u002F\u002F SAI: response.Data(c, result) → wrap thêm {\"data\": ...} → FE nhận items=undefined\n```\n\n## Routes (17 endpoints)\n\n```\nGET  \u002Fconfig-call-center                              list + paginate\nGET  \u002Fconfig-call-center\u002Fget-call-center-active       lấy provider đang active\nGET  \u002Fconfig-call-center\u002Fget-config-call-center-by-id\nGET  \u002Fconfig-call-center\u002Fget-config-voip24h           provider_type=1\nGET  \u002Fconfig-call-center\u002Fget-config-stringe           provider_type=2\nGET  \u002Fconfig-call-center\u002Fget-config-omicall           provider_type=3\nGET  \u002Fconfig-call-center\u002Fomicall\u002Fextensions           proxy lấy danh sách máy nhánh từ Omicall API\nGET  \u002Fconfig-call-center\u002Fget-token-stringee           tạo JWT token Stringee cho FE\nGET  \u002Fconfig-call-center\u002F:id\nPOST \u002Fconfig-call-center                              create\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-stringee\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-voip24h\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-omicall\nPOST \u002Fconfig-call-center\u002Factive\nPOST \u002Fconfig-call-center\u002Fin-active\nPUT  \u002Fconfig-call-center\u002F:id\nDELETE \u002Fconfig-call-center\u002F:id\n```\n\n## Omicall extensions proxy — `handler\u002Fomicall_client.go`\n\nBE làm proxy để FE không cần biết `api_key`. Pattern chung:\n\n```go\n\u002F\u002F Package-level client — tái sử dụng TCP connections\nvar omicallHTTPClient = &http.Client{\n    Timeout:   15 * time.Second,\n    Transport: http.DefaultTransport,\n}\n\n\u002F\u002F baseURL đọc từ config_system.base_url; fallback về omicallDefaultBaseURL\n\u002F\u002F Truyền baseURL vào tất cả helper functions, KHÔNG dùng global const trực tiếp\nfunc omicallGetToken(baseURL, apiKey string) (string, error)\nfunc omicallListExtensions(baseURL, token string) ([]OmicallExtItem, error)\nfunc omicallExtPassword(baseURL, token, sipUser string) (string, error)\nfunc resolveOmicallExtPasswords(baseURL, apiKey string, extList []map[string]any)\n```\n\n### base_url per tenant\n\nOmicall có thể chạy trên nhiều server. Mỗi tenant cấu hình `base_url` riêng trong `config_system`:\n\n```go\nvar sys struct {\n    APIKey  string `json:\"api_key\"`\n    BaseURL string `json:\"base_url\"`  \u002F\u002F optional — để trống dùng default\n}\nbaseURL := sys.BaseURL\nif baseURL == \"\" {\n    baseURL = omicallDefaultBaseURL  \u002F\u002F \"https:\u002F\u002Fpublic-v1-stg.omicall.com\"\n}\n```\n\n`base_url` được lưu vào `config_system` chỉ khi FE nhập — `buildPayload` dùng spread:\n```typescript\nconfig_system = {\n  api_key: v.Omicall_ApiKey,\n  sipRealm: v.Omicall_SipRealm,\n  hotlines,\n  ...(v.Omicall_BaseURL?.trim() ? { base_url: v.Omicall_BaseURL.trim() } : {}),\n};\n```\n\n### resolveOmicallExtPasswords — parallel, best-effort\n\nList API trả `password: \"XXXXXX\"` (masked). BE tự resolve bằng `extensions\u002Fdetail`. Mỗi extension có `sipRealm` riêng từ `pbx_account.sip_realm`.\n\n```go\ntype omicallExtDetail struct {\n    Password string\n    SipRealm string\n}\n\n\u002F\u002F Condition: resolve khi thiếu password HOẶC thiếu sipRealm\nif ext != \"\" && (pw == \"\" || sipRealm == \"\") {\n    jobs = append(jobs, job{idx: i, ext: ext})\n}\n\n\u002F\u002F Goroutine: chỉ overwrite password nếu trước đó rỗng; luôn set sipRealm\nif detail.Password != \"\" {\n    existing, _ := extList[idx][\"password\"].(string)\n    if existing == \"\" {\n        extList[idx][\"password\"] = detail.Password\n    }\n}\nif detail.SipRealm != \"\" {\n    extList[idx][\"sipRealm\"] = detail.SipRealm\n}\n```\n\n**QUAN TRỌNG**: Condition phải check cả `sipRealm == \"\"`. Nếu chỉ check `pw == \"\"`, extension đã có password sẽ bị skip → `sipRealm` không bao giờ được set.\n\nGọi trong `UpdateConfigCallCenterOmicall` — sau `mergeCredentials`, trước khi save:\n```go\nresolveOmicallExtPasswords(burl, sys.APIKey, extList)\n\u002F\u002F Void return — KHÔNG block save nếu Omicall auth fail\n```\n\n`config_ext` schema sau khi resolve:\n```json\n[{ \"ext\": \"116\", \"userId\": 2, \"password\": \"SwtxyVRQOA\", \"sipRealm\": \"dend\", \"phonenumber\": null }]\n```\n\n### GetOmicallExtensions — auth fail trả 422, không 500\n\n```go\ntoken, err := omicallGetToken(baseURL, sys.APIKey)\nif err != nil {\n    \u002F\u002F Config issue (sai key) → Validate, không ServerError\n    response.Validate(c, i18n.T(c, \"call_center_not_found\")+\" (\"+err.Error()+\")\")\n    return\n}\n```\n\n## IndexedDB sync — `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Findexeddb\u002Fhandler\u002Fsync.go`\n\n`listCallCenters` nằm trong `customTables` (không phải `configTables`) để mask credentials:\n\n```go\n\"listCallCenters\": func(c *gin.Context, d *gorm.DB) interface{} {\n    rows := findRows(tenant.ScopedDBNullBranch(c, d, \"config_call_center\").Table(\"config_call_center\").Order(\"id DESC\"))\n    maskCallCenterCredentials(rows)\n    return rows\n},\n```\n\n`maskCallCenterCredentials` unmarshal `json.RawMessage` → mask key → re-marshal:\n- Stringee: mask `config_system.API_SID`, `config_system.Secret_Key`\n- Omicall: mask `config_system.api_key`\n- Voip24h: mask `config_other.secret`\n\n**`provider_type` type assertion** — MySQL TINYINT scan ra `map[string]interface{}` có thể là bất kỳ numeric type nào (`int64`, `int8`, `uint8`, v.v.), **không phải lúc nào cũng `int64`**. Dùng `toInt64()` helper thay vì direct assertion:\n```go\n\u002F\u002F SAI — silent zero khi không phải int64\npt, _ := row[\"provider_type\"].(int64)\n\n\u002F\u002F ĐÚNG\npt := toInt64(row[\"provider_type\"])\n```\n\nSau CUD: `dexie.BumpDexieTable(h.DB, \"listCallCenters\")`\n\n---\n\n## FE patterns\n\n→ Xem `skill\u002Fskills\u002Fworking-on-config\u002Freference\u002Fcall-center-fe.md` — provider form, extensions dropdown, popup-call SDK, hotline selector, browser permissions.\n\n\nModule `config\u002Fdigital_signature` — cấu hình ký số CA per company.\n\n## Bảng `config_digital_signature`\n\n1 record per company (`company_id UNIQUE`). Upsert qua `POST \u002Fconfig\u002Fdigital-signature\u002Fconfig`.\n\n| Column | Type | Ghi chú |\n|---|---|---|\n| `sign_method` | `ENUM('manual','digital')` | `manual` = ký tay scan; `digital` = CA |\n| `provider` | `VARCHAR(50)` | lowercase: `matbao`, `vnpt`, `viettel`, `fpt`, `bkav`, `newtel`, `ca2`, `misa` |\n| `signing_method` | `VARCHAR(20)` | `USB_TOKEN` \u002F `HSM` \u002F `CLOUD` |\n| `is_active` | `TINYINT(1)` | 1 = đang dùng |\n| `credentials_enc` | `TEXT` | AES-GCM encrypt toàn bộ JSON credentials |\n| `sign_config` | `JSON` | `{sign_page, sign_x, sign_y, sign_width, sign_height, sign_image_base64}` |\n\n## Credentials JSON blob pattern\n\nCredentials là JSON map `map[string]string` encrypt bằng `crypto.EncryptAESGCM`:\n\n```go\n\u002F\u002F Matbao\n{\"taxcode\": \"...\", \"username\": \"...\", \"password\": \"...\"}\n\n\u002F\u002F Generic API provider\n{\"api_endpoint\": \"...\", \"api_key\": \"...\", \"serial_number\": \"...\"}\n```\n\n**KHÔNG dùng cột cố định per provider** — tránh migrate mỗi khi thêm provider mới.\n\n## Masking pattern — secret fields\n\nGET trả `credentials_masked` (không trả `credentials_enc`). Secret fields (`password`, `api_key`) bị mask 8 ký tự đầu + `***`. Non-secret (`taxcode`, `username`, `api_endpoint`, `serial_number`) trả plain.\n\n```go\nvar secretFields = map[string]bool{\"password\": true, \"api_key\": true}\n\nfunc maskSecret(field, value string) string { ... }          \u002F\u002F mask nếu secret\nfunc isMaskedVersion(field, input, original string) bool { } \u002F\u002F true → FE gửi lại masked → giữ nguyên\n```\n\nUpsert merge logic:\n```go\nif isMaskedVersion(k, incomingVal, existingVal) {\n    merged[k] = existingVal  \u002F\u002F giữ nguyên\n} else {\n    merged[k] = incomingVal  \u002F\u002F cập nhật\n}\n```\n\n**CRITICAL:** FE gửi masked value → BE giữ giá trị cũ, không cần FE xử lý gì thêm.\n\n## Response shape\n\n```json\n{\n  \"sign_method\": \"digital\",\n  \"provider\": \"matbao\",\n  \"signing_method\": \"CLOUD\",\n  \"is_active\": true,\n  \"has_credentials\": true,\n  \"credentials_masked\": {\n    \"taxcode\": \"0987654321\",\n    \"username\": \"admin\",\n    \"password\": \"mypass12****\"\n  },\n  \"sign_config\": { \"sign_page\": 1, \"sign_x\": 50, \"sign_y\": 700, \"sign_width\": 150, \"sign_height\": 50 }\n}\n```\n\n`has_credentials: bool` — shorthand để FE check nhanh mà không cần đọc `credentials_masked`.\n\n## Dùng ở đâu\n\n`sign.go` trong `emr\u002Fmedical_record\u002Fhandler` đọc config này khi digital signing:\n\n```go\nh.DB.Table(\"config_digital_signature\").\n    Select(\"provider, credentials_enc, sign_config\").\n    Where(\"company_id = ? AND sign_method = 'digital' AND is_active = 1\", middleware.GetCompanyActiveID(c)).\n    First(&dsCfg)\n```\n\n→ Decrypt credentials → `creds[\"taxcode\"]`, `creds[\"username\"]`, `creds[\"password\"]`\n\n## Validation\n\n- `sign_method=digital` → `provider` bắt buộc, phải thuộc set hợp lệ\n- Tạo mới `digital` mà không có credentials → 400\n- `signing_method` nếu có → phải là `USB_TOKEN` \u002F `HSM` \u002F `CLOUD`\n\n\n## Bảng DB\n\n`print_templates` — `branch_id` (0 = mẫu chung toàn thương hiệu), `template_type`, `name`, `description`, `template_html` (LONGTEXT), `is_default`, `is_active`, `created_at`, `updated_at` (optimistic lock, D21), `created_by`, `updated_by`. KHÔNG còn `company_id`\u002F`version` (D15\u002FD21). Entity: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fprint_template\u002Fdao\u002Fentity.go`.\n\n## Endpoints\n\n| Method | Path | Mô tả |\n|--------|------|-------|\n| GET | `\u002Fconfig\u002Fprint-template` | List (explicit SELECT, không `SELECT *` vì LONGTEXT) |\n| GET | `\u002Fconfig\u002Fprint-template\u002F:id` | Get một record |\n| GET | `\u002Fconfig\u002Fprint-template\u002Fdefault?type=&branch_id=` | Lấy template mặc định |\n| POST | `\u002Fconfig\u002Fprint-template` | Tạo mới |\n| PUT | `\u002Fconfig\u002Fprint-template\u002F:id` | Cập nhật |\n| DELETE | `\u002Fconfig\u002Fprint-template\u002F:id` | Xóa (chặn nếu is_default=1) |\n\n## GetDefault logic\n\nƯu tiên: branch cụ thể (`branch_id` query param, parse ra số trước) → fallback mẫu chung `branch_id=0`, cùng điều kiện `template_type = ? AND is_default = 1 AND is_active = 1`. Không lọc theo company (đã bỏ, story-39\u002FD15). List\u002FGet\u002FUpdate\u002FDelete theo id vẫn qua `tenant.ScopedDBNullBranch(c, h.DB, \"print_templates\")`.\n\n## Optimistic locking\n\nTheo `updated_at` (D21): Update gọi `optlock.Save(tx, &current, input.UpdatedAt)` — `WHERE updated_at = expected`, 0 dòng ⇒ `errs.ErrVersionConflict` ⇒ `response.Conflict` (409, i18n `version_conflict`). FE PHẢI gửi lại `updated_at` đã đọc. (Cột `version` cũ đã bỏ.)\n\n## Template types\n\nĐịnh nghĩa tại `pkg\u002Fdefine\u002Fprint_template.go` → `ValidPrintTemplateTypes` map. Thêm type mới → update map này.\n\n## Render engine (FE)\n\nHandlebars-lite tại `print-template-render.service.ts`:\n- `{{key.path}}` — interpolation\n- `{{#each array}}...{{this.field}}...{{\u002Feach}}` — loop\n- `{{#if condition}}...{{\u002Fif}}` — conditional\n\nStandalone function `renderTemplateHtml(html, data)` dùng cho preview.\n\n## FE — PrintTemplatePage\n\n- Page riêng (không dùng dialog) tại `\u002Fconfig\u002Fprint-template\u002Fcreate` và `\u002Fconfig\u002Fprint-template\u002F:id`\n- Monaco editor (`ngx-monaco-editor-v2`) NGOÀI `\u003Cform>` — tránh CVA `setDisabledState` gotcha\n- Sync Monaco → FormControl thủ công qua `editor.onDidChangeModelContent`\n- Placeholder sidebar: click → `editor.executeEdits()` chèn tại cursor position\n- Live preview: `\u003Ciframe #previewFrame sandbox=\"allow-same-origin\">` set `srcdoc` qua `effect()`\n\n## FE — PrintPayment (ví dụ tích hợp)\n\n`PrintTemplateRenderService.getDefault('payment', branchId)` → nếu có tpl → render + `renderedHtml.set(html)` → `[innerHTML]=\"renderedHtml() | safeHtml\"`. Nếu null → fallback hardcode Angular template.\n\n## Template data shape (payment)\n\n```typescript\n{\n  company: { name, hotline, website, logo },   \u002F\u002F key giữ tên `company` cho template cũ; giá trị lấy từ authBusinessProfile() (business_profile, D22)\n  branch: { name, address, hotline, email },\n  customer: { fullname, phone, email, address, code },\n  payment: { code, date, note, total, outstanding },\n  services: [{ name, quantity, unit_price, subtotal, discount, total }],\n  print: { date, day, month, year },\n}\n```\n\n\nTable `control_field_in_table`: 2 static row, KHÔNG có `company_id`\u002F`branch_id` (global, không tenant-scoped by design — seed 1 lần trong migration, không CRUD thêm row).\n\n- `id=1` \"Bảng khách hàng\" → form Contact\u002FCustomerForm\n- `id=2` \"Bảng khách hàng (Lead)\" → form Lead\u002FFormLead\n\nColumn `control` (`datatypes.JSON`): mảng `{field_name, field_label, create, update, edit}`.\n- `edit=true` = **\"Không được cập nhật\"** (field bị khoá khỏi update), KHÔNG phải \"cho phép sửa\".\n\n## GOTCHA — 2 format lưu trữ khác nhau cho cùng cột `control`\n\nDB có thể lưu 1 trong 2 dạng cho cùng cột:\n- Plain array: `[{...}, {...}]`\n- Wrapped: `{\"control\": [{...}, {...}]}`\n\nMọi nơi đọc field này PHẢI thử unwrap cả 2 dạng, không được assume 1 format cố định:\n```go\nvar fields []map[string]interface{}\nif json.Unmarshal(raw, &fields) != nil {\n\tvar wrapper map[string]json.RawMessage\n\tif json.Unmarshal(raw, &wrapper) == nil {\n\t\tif inner, ok := wrapper[\"control\"]; ok {\n\t\t\t_ = json.Unmarshal(inner, &fields)\n\t\t}\n\t}\n}\n```\nÁp dụng ở: BE `handler.GetFieldCustomer`, BE `CustomerService.applyFieldLocks` (xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fcustomer.md`), FE `customer-form.ts loadValidationRules()`.\n\n## Routes (`internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fcontrol_field_in_table\u002F`)\n\n- `GET :id\u002Fget-field-customer` — trả `control` đã parse, hoặc `defaultCustomerFields` hardcode nếu `control` rỗng\n- `POST :id\u002Fupdate-field-customer` — nhận `{control: [...]}`, lưu nguyên array vào cột `control`\n- `POST :id\u002Fre-build` — set `control = NULL` (reset về default)\n\nKhông có service layer — handler gọi thẳng `h.DB`. Sau CUD: `dexie.BumpDexieTable(h.DB, \"controlFieldInTables\")`.\n\nFE consumer chính không gọi trực tiếp GET endpoint — `customer-form.ts loadValidationRules()` đọc qua IndexedDB cache (`ControlFieldInTableCacheService`).\n\n## KNOWN GAP — chưa fix\n\n`route_perm_map.json` ĐÃ map đủ 3 route — cả 3 dùng `manageConfig` (quyền duy nhất của module Cấu hình từ 2026-09-02), `enforce_phase1:true` ở `update-field-customer` + `re-build` — nhưng enforcer toàn cục đang audit-mode (`PERM_ENFORCE=false`) → chưa chặn thật. Bất kỳ user đã login vẫn gọi thẳng `update-field-customer`\u002F`re-build` được, ảnh hưởng TOÀN hệ thống vì bảng global (không `company_id` để scope theo tenant) — `re-build` reset `control` về NULL cho mọi company.\n\nKhông thêm `requirePerm` riêng cho 3 route này để \"vá sớm\" — gap chung của cả module config, xem `skills\u002Fbackend-hard-rules\u002Freference\u002Fsecurity-patterns.md` §Field lock \u002F permission.\n\n\n\n","# Working on Config\n\n> ⚠ **(đã bỏ, D15\u002FCRM standalone)** Verify 2026-09-28: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002F` trong repo\n> CRM standalone này KHÔNG có `config_call_center`, `config_digital_signature`,\n> hay module `ai` — chỉ còn `branch`, `business_profile`, `appointment_*`, `control_field_in_table`,\n> `print_template` (CÒN SỐNG — section mẫu in bên dưới đã cập nhật theo code 2026-10-17),\n> `options`, `service`\u002F`service_type`, danh mục (`customer_category`, `source`...), `hr_department`,\n> `indexeddb`, `user_profile`, `userscope`... Các section bên dưới nói về tổng đài\u002FOmicall, chữ ký\n> số, AI config mô tả kiến trúc ERP cũ — giữ làm lịch sử\u002Ftham khảo, KHÔNG áp dụng cho repo\n> này. Mọi mention `company_id`\u002F`GetCompanyActiveID`\u002F`companyActiveId` trong các section đó cũng đã\n> bỏ cùng company (D15) — xem `CLAUDE.md` §Hard Rules cho model hiện tại (branch-only).\n>\n> reference\u002Fcall-center-fe.md: FE tổng đài · reference\u002Fomicall-api.md: Omicall REST API ·\n> reference\u002Fomicall-sdk.md: Omicall SDK.\n\n\n\nModule `config\u002Fconfig_call_center` — cấu hình tổng đài per company. Mỗi company có thể cấu hình nhiều provider, chỉ 1 active tại 1 thời điểm.\n\n## Bảng `config_call_center`\n\nNhiều record per company. `company_id IS NULL` = shared template (Core ERP, áp dụng cho tất cả công ty chưa config riêng).\n\n| Column | Type | Ghi chú |\n|---|---|---|\n| `company_id` | `INT UNSIGNED NULL` | NULL = shared template; có giá trị = riêng company đó |\n| `name` | `VARCHAR(255) NOT NULL` | Tên nhận dạng |\n| `provider_type` | `TINYINT UNSIGNED` | Xem constants bên dưới |\n| `config_system` | `JSON` | Credentials tổng đài — **SENSITIVE** |\n| `config_ext` | `JSON` | Danh sách máy nhánh `[{userId, ext, phonenumber, password}]` |\n| `config_other` | `JSON` | Cấu hình phụ — **SENSITIVE** |\n| `status` | `TINYINT` | `1` = active, `0` = inactive |\n\n## Entity — `dao\u002Fentity.go`\n\n```go\ntype ConfigCallCenter struct {\n    models.SimpleModel\n    CompanyID    *uint          `gorm:\"column:company_id;uniqueIndex:uq_company_name;index\" json:\"company_id\"`\n    \u002F\u002F ...\n}\n```\n\n**QUAN TRỌNG**: `CompanyID` phải là `*uint` (pointer) vì column nullable. `uint` zero=0≠NULL → GORM ghi 0 vào DB → orphaned data. Mọi check phải dùng `item.CompanyID != nil && *item.CompanyID > 0`.\n\n## Provider type constants — `pkg\u002Fdefine\u002Fcall_center.go`\n\n```go\nCallCenterProviderVoip24h  = 1   \u002F\u002F config_other.secret\nCallCenterProviderStringee = 2   \u002F\u002F config_system.API_SID, config_system.Secret_Key\nCallCenterProviderOmicall  = 3   \u002F\u002F config_system.api_key, config_system.sipRealm\n```\n\n**KHÔNG hardcode số** — dùng `define.CallCenterProvider(item.ProviderType)`.\n\n## Scope rule\n\n- Dùng `tenant.ScopedDBNullBranch(c, h.DB, \"config_call_center\")` — row `company_id IS NULL` luôn được trả về\n- GET\u002FUPDATE\u002FDELETE by id: `ScopedDBNullBranch(...).First(&item, id)` trước, rồi mới dùng `item.CompanyID`\n- **KHÔNG** `db.DB.First(&item, id)` trực tiếp\n\n## Active\u002FInactive logic — QUAN TRỌNG\n\nMỗi company chỉ có 1 provider active. Pattern đúng (sau khi CompanyID đổi sang `*uint`):\n\n```go\nvar item dao.ConfigCallCenter\nif err := tenant.ScopedDBNullBranch(c, h.DB, \"config_call_center\").First(&item, body.ID).Error; err != nil {\n    response.NotFound(c); return\n}\n\u002F\u002F Deactivate others in same company scope\nif item.CompanyID != nil && *item.CompanyID > 0 {\n    h.DB.Table(\"config_call_center\").Where(\"company_id = ? AND id != ?\", *item.CompanyID, item.ID).Update(\"status\", 0)\n} else {\n    h.DB.Table(\"config_call_center\").Where(\"company_id IS NULL AND id != ?\", item.ID).Update(\"status\", 0)\n}\nh.DB.Table(\"config_call_center\").Where(\"id = ?\", item.ID).Update(\"status\", 1)\n```\n\n**Lý do KHÔNG dùng `GetCompanyActiveID(c)`**: trả về company user đang active, nhưng row có thể thuộc company khác hoặc IS NULL → 0 rows affected mà GORM không báo lỗi.\n\n## Create — dùng LAST_INSERT_ID để reload\n\nRaw INSERT (để `company_id` ghi được NULL) rồi reload theo `LAST_INSERT_ID` thay vì query theo\nname+provider_type (tránh nhầm khi trùng name). Mọi đường tạo đi qua `insertConfigCallCenter`\n(`handler\u002Fhelpers.go`) — INSERT + `LAST_INSERT_ID` trong CÙNG 1 `db.Transaction`. Lý do + test đồng thời:\n`skill\u002Fskills\u002Fdebugging-backend-queries\u002Freference\u002Fpatterns-gotchas-data-integrity.md` §`LAST_INSERT_ID()`.\n\n## Credential masking — `handler\u002Fhelpers.go`\n\nPattern: show 6 ký tự đầu + `****`. Áp dụng cho tất cả GET responses và IndexedDB sync.\n\n```go\nmaskItemCredentials(&item)   \u002F\u002F mutate in-place trước khi trả response\n\n\u002F\u002F Khi update: restore nếu FE gửi lại masked value\nmergedCS, mergedCO := mergeCredentials(item.ProviderType, item.ConfigSystem, body.ConfigSystem, item.ConfigOther, body.ConfigOther)\n```\n\n**Fields bị mask theo provider:**\n- Stringee: `config_system.API_SID`, `config_system.Secret_Key`\n- Omicall: `config_system.api_key` (KHÔNG mask `sipRealm` hay `hotlines`)\n- Voip24h: `config_other.secret`\n\n`mergeCredentials` tự động giữ nguyên giá trị gốc nếu FE gửi lại masked value.\n\n**updateConfigCallCenterByProvider phải gọi cả 2:**\n```go\n\u002F\u002F UPDATE path: merge trước\nmergedCS, mergedCO := mergeCredentials(item.ProviderType, item.ConfigSystem, body.ConfigSystem, item.ConfigOther, body.ConfigOther)\n\u002F\u002F ...sau khi save:\nmaskItemCredentials(&item)\nresponse.Updated(c, item)\n```\n\n## List endpoint — response format\n\n```go\n\u002F\u002F ĐÚNG: c.JSON trực tiếp (BaseApiService.list() không unwrap .data)\nc.JSON(http.StatusOK, result)\n\n\u002F\u002F SAI: response.Data(c, result) → wrap thêm {\"data\": ...} → FE nhận items=undefined\n```\n\n## Routes (17 endpoints)\n\n```\nGET  \u002Fconfig-call-center                              list + paginate\nGET  \u002Fconfig-call-center\u002Fget-call-center-active       lấy provider đang active\nGET  \u002Fconfig-call-center\u002Fget-config-call-center-by-id\nGET  \u002Fconfig-call-center\u002Fget-config-voip24h           provider_type=1\nGET  \u002Fconfig-call-center\u002Fget-config-stringe           provider_type=2\nGET  \u002Fconfig-call-center\u002Fget-config-omicall           provider_type=3\nGET  \u002Fconfig-call-center\u002Fomicall\u002Fextensions           proxy lấy danh sách máy nhánh từ Omicall API\nGET  \u002Fconfig-call-center\u002Fget-token-stringee           tạo JWT token Stringee cho FE\nGET  \u002Fconfig-call-center\u002F:id\nPOST \u002Fconfig-call-center                              create\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-stringee\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-voip24h\nPOST \u002Fconfig-call-center\u002Fupdate-config-call-center-omicall\nPOST \u002Fconfig-call-center\u002Factive\nPOST \u002Fconfig-call-center\u002Fin-active\nPUT  \u002Fconfig-call-center\u002F:id\nDELETE \u002Fconfig-call-center\u002F:id\n```\n\n## Omicall extensions proxy — `handler\u002Fomicall_client.go`\n\nBE làm proxy để FE không cần biết `api_key`. Pattern chung:\n\n```go\n\u002F\u002F Package-level client — tái sử dụng TCP connections\nvar omicallHTTPClient = &http.Client{\n    Timeout:   15 * time.Second,\n    Transport: http.DefaultTransport,\n}\n\n\u002F\u002F baseURL đọc từ config_system.base_url; fallback về omicallDefaultBaseURL\n\u002F\u002F Truyền baseURL vào tất cả helper functions, KHÔNG dùng global const trực tiếp\nfunc omicallGetToken(baseURL, apiKey string) (string, error)\nfunc omicallListExtensions(baseURL, token string) ([]OmicallExtItem, error)\nfunc omicallExtPassword(baseURL, token, sipUser string) (string, error)\nfunc resolveOmicallExtPasswords(baseURL, apiKey string, extList []map[string]any)\n```\n\n### base_url per tenant\n\nOmicall có thể chạy trên nhiều server. Mỗi tenant cấu hình `base_url` riêng trong `config_system`:\n\n```go\nvar sys struct {\n    APIKey  string `json:\"api_key\"`\n    BaseURL string `json:\"base_url\"`  \u002F\u002F optional — để trống dùng default\n}\nbaseURL := sys.BaseURL\nif baseURL == \"\" {\n    baseURL = omicallDefaultBaseURL  \u002F\u002F \"https:\u002F\u002Fpublic-v1-stg.omicall.com\"\n}\n```\n\n`base_url` được lưu vào `config_system` chỉ khi FE nhập — `buildPayload` dùng spread:\n```typescript\nconfig_system = {\n  api_key: v.Omicall_ApiKey,\n  sipRealm: v.Omicall_SipRealm,\n  hotlines,\n  ...(v.Omicall_BaseURL?.trim() ? { base_url: v.Omicall_BaseURL.trim() } : {}),\n};\n```\n\n### resolveOmicallExtPasswords — parallel, best-effort\n\nList API trả `password: \"XXXXXX\"` (masked). BE tự resolve bằng `extensions\u002Fdetail`. Mỗi extension có `sipRealm` riêng từ `pbx_account.sip_realm`.\n\n```go\ntype omicallExtDetail struct {\n    Password string\n    SipRealm string\n}\n\n\u002F\u002F Condition: resolve khi thiếu password HOẶC thiếu sipRealm\nif ext != \"\" && (pw == \"\" || sipRealm == \"\") {\n    jobs = append(jobs, job{idx: i, ext: ext})\n}\n\n\u002F\u002F Goroutine: chỉ overwrite password nếu trước đó rỗng; luôn set sipRealm\nif detail.Password != \"\" {\n    existing, _ := extList[idx][\"password\"].(string)\n    if existing == \"\" {\n        extList[idx][\"password\"] = detail.Password\n    }\n}\nif detail.SipRealm != \"\" {\n    extList[idx][\"sipRealm\"] = detail.SipRealm\n}\n```\n\n**QUAN TRỌNG**: Condition phải check cả `sipRealm == \"\"`. Nếu chỉ check `pw == \"\"`, extension đã có password sẽ bị skip → `sipRealm` không bao giờ được set.\n\nGọi trong `UpdateConfigCallCenterOmicall` — sau `mergeCredentials`, trước khi save:\n```go\nresolveOmicallExtPasswords(burl, sys.APIKey, extList)\n\u002F\u002F Void return — KHÔNG block save nếu Omicall auth fail\n```\n\n`config_ext` schema sau khi resolve:\n```json\n[{ \"ext\": \"116\", \"userId\": 2, \"password\": \"SwtxyVRQOA\", \"sipRealm\": \"dend\", \"phonenumber\": null }]\n```\n\n### GetOmicallExtensions — auth fail trả 422, không 500\n\n```go\ntoken, err := omicallGetToken(baseURL, sys.APIKey)\nif err != nil {\n    \u002F\u002F Config issue (sai key) → Validate, không ServerError\n    response.Validate(c, i18n.T(c, \"call_center_not_found\")+\" (\"+err.Error()+\")\")\n    return\n}\n```\n\n## IndexedDB sync — `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Findexeddb\u002Fhandler\u002Fsync.go`\n\n`listCallCenters` nằm trong `customTables` (không phải `configTables`) để mask credentials:\n\n```go\n\"listCallCenters\": func(c *gin.Context, d *gorm.DB) interface{} {\n    rows := findRows(tenant.ScopedDBNullBranch(c, d, \"config_call_center\").Table(\"config_call_center\").Order(\"id DESC\"))\n    maskCallCenterCredentials(rows)\n    return rows\n},\n```\n\n`maskCallCenterCredentials` unmarshal `json.RawMessage` → mask key → re-marshal:\n- Stringee: mask `config_system.API_SID`, `config_system.Secret_Key`\n- Omicall: mask `config_system.api_key`\n- Voip24h: mask `config_other.secret`\n\n**`provider_type` type assertion** — MySQL TINYINT scan ra `map[string]interface{}` có thể là bất kỳ numeric type nào (`int64`, `int8`, `uint8`, v.v.), **không phải lúc nào cũng `int64`**. Dùng `toInt64()` helper thay vì direct assertion:\n```go\n\u002F\u002F SAI — silent zero khi không phải int64\npt, _ := row[\"provider_type\"].(int64)\n\n\u002F\u002F ĐÚNG\npt := toInt64(row[\"provider_type\"])\n```\n\nSau CUD: `dexie.BumpDexieTable(h.DB, \"listCallCenters\")`\n\n---\n\n## FE patterns\n\n→ Xem `skill\u002Fskills\u002Fworking-on-config\u002Freference\u002Fcall-center-fe.md` — provider form, extensions dropdown, popup-call SDK, hotline selector, browser permissions.\n\n\nModule `config\u002Fdigital_signature` — cấu hình ký số CA per company.\n\n## Bảng `config_digital_signature`\n\n1 record per company (`company_id UNIQUE`). Upsert qua `POST \u002Fconfig\u002Fdigital-signature\u002Fconfig`.\n\n| Column | Type | Ghi chú |\n|---|---|---|\n| `sign_method` | `ENUM('manual','digital')` | `manual` = ký tay scan; `digital` = CA |\n| `provider` | `VARCHAR(50)` | lowercase: `matbao`, `vnpt`, `viettel`, `fpt`, `bkav`, `newtel`, `ca2`, `misa` |\n| `signing_method` | `VARCHAR(20)` | `USB_TOKEN` \u002F `HSM` \u002F `CLOUD` |\n| `is_active` | `TINYINT(1)` | 1 = đang dùng |\n| `credentials_enc` | `TEXT` | AES-GCM encrypt toàn bộ JSON credentials |\n| `sign_config` | `JSON` | `{sign_page, sign_x, sign_y, sign_width, sign_height, sign_image_base64}` |\n\n## Credentials JSON blob pattern\n\nCredentials là JSON map `map[string]string` encrypt bằng `crypto.EncryptAESGCM`:\n\n```go\n\u002F\u002F Matbao\n{\"taxcode\": \"...\", \"username\": \"...\", \"password\": \"...\"}\n\n\u002F\u002F Generic API provider\n{\"api_endpoint\": \"...\", \"api_key\": \"...\", \"serial_number\": \"...\"}\n```\n\n**KHÔNG dùng cột cố định per provider** — tránh migrate mỗi khi thêm provider mới.\n\n## Masking pattern — secret fields\n\nGET trả `credentials_masked` (không trả `credentials_enc`). Secret fields (`password`, `api_key`) bị mask 8 ký tự đầu + `***`. Non-secret (`taxcode`, `username`, `api_endpoint`, `serial_number`) trả plain.\n\n```go\nvar secretFields = map[string]bool{\"password\": true, \"api_key\": true}\n\nfunc maskSecret(field, value string) string { ... }          \u002F\u002F mask nếu secret\nfunc isMaskedVersion(field, input, original string) bool { } \u002F\u002F true → FE gửi lại masked → giữ nguyên\n```\n\nUpsert merge logic:\n```go\nif isMaskedVersion(k, incomingVal, existingVal) {\n    merged[k] = existingVal  \u002F\u002F giữ nguyên\n} else {\n    merged[k] = incomingVal  \u002F\u002F cập nhật\n}\n```\n\n**CRITICAL:** FE gửi masked value → BE giữ giá trị cũ, không cần FE xử lý gì thêm.\n\n## Response shape\n\n```json\n{\n  \"sign_method\": \"digital\",\n  \"provider\": \"matbao\",\n  \"signing_method\": \"CLOUD\",\n  \"is_active\": true,\n  \"has_credentials\": true,\n  \"credentials_masked\": {\n    \"taxcode\": \"0987654321\",\n    \"username\": \"admin\",\n    \"password\": \"mypass12****\"\n  },\n  \"sign_config\": { \"sign_page\": 1, \"sign_x\": 50, \"sign_y\": 700, \"sign_width\": 150, \"sign_height\": 50 }\n}\n```\n\n`has_credentials: bool` — shorthand để FE check nhanh mà không cần đọc `credentials_masked`.\n\n## Dùng ở đâu\n\n`sign.go` trong `emr\u002Fmedical_record\u002Fhandler` đọc config này khi digital signing:\n\n```go\nh.DB.Table(\"config_digital_signature\").\n    Select(\"provider, credentials_enc, sign_config\").\n    Where(\"company_id = ? AND sign_method = 'digital' AND is_active = 1\", middleware.GetCompanyActiveID(c)).\n    First(&dsCfg)\n```\n\n→ Decrypt credentials → `creds[\"taxcode\"]`, `creds[\"username\"]`, `creds[\"password\"]`\n\n## Validation\n\n- `sign_method=digital` → `provider` bắt buộc, phải thuộc set hợp lệ\n- Tạo mới `digital` mà không có credentials → 400\n- `signing_method` nếu có → phải là `USB_TOKEN` \u002F `HSM` \u002F `CLOUD`\n\n\n## Bảng DB\n\n`print_templates` — `branch_id` (0 = mẫu chung toàn thương hiệu), `template_type`, `name`, `description`, `template_html` (LONGTEXT), `is_default`, `is_active`, `created_at`, `updated_at` (optimistic lock, D21), `created_by`, `updated_by`. KHÔNG còn `company_id`\u002F`version` (D15\u002FD21). Entity: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fprint_template\u002Fdao\u002Fentity.go`.\n\n## Endpoints\n\n| Method | Path | Mô tả |\n|--------|------|-------|\n| GET | `\u002Fconfig\u002Fprint-template` | List (explicit SELECT, không `SELECT *` vì LONGTEXT) |\n| GET | `\u002Fconfig\u002Fprint-template\u002F:id` | Get một record |\n| GET | `\u002Fconfig\u002Fprint-template\u002Fdefault?type=&branch_id=` | Lấy template mặc định |\n| POST | `\u002Fconfig\u002Fprint-template` | Tạo mới |\n| PUT | `\u002Fconfig\u002Fprint-template\u002F:id` | Cập nhật |\n| DELETE | `\u002Fconfig\u002Fprint-template\u002F:id` | Xóa (chặn nếu is_default=1) |\n\n## GetDefault logic\n\nƯu tiên: branch cụ thể (`branch_id` query param, parse ra số trước) → fallback mẫu chung `branch_id=0`, cùng điều kiện `template_type = ? AND is_default = 1 AND is_active = 1`. Không lọc theo company (đã bỏ, story-39\u002FD15). List\u002FGet\u002FUpdate\u002FDelete theo id vẫn qua `tenant.ScopedDBNullBranch(c, h.DB, \"print_templates\")`.\n\n## Optimistic locking\n\nTheo `updated_at` (D21): Update gọi `optlock.Save(tx, &current, input.UpdatedAt)` — `WHERE updated_at = expected`, 0 dòng ⇒ `errs.ErrVersionConflict` ⇒ `response.Conflict` (409, i18n `version_conflict`). FE PHẢI gửi lại `updated_at` đã đọc. (Cột `version` cũ đã bỏ.)\n\n## Template types\n\nĐịnh nghĩa tại `pkg\u002Fdefine\u002Fprint_template.go` → `ValidPrintTemplateTypes` map. Thêm type mới → update map này.\n\n## Render engine (FE)\n\nHandlebars-lite tại `print-template-render.service.ts`:\n- `{{key.path}}` — interpolation\n- `{{#each array}}...{{this.field}}...{{\u002Feach}}` — loop\n- `{{#if condition}}...{{\u002Fif}}` — conditional\n\nStandalone function `renderTemplateHtml(html, data)` dùng cho preview.\n\n## FE — PrintTemplatePage\n\n- Page riêng (không dùng dialog) tại `\u002Fconfig\u002Fprint-template\u002Fcreate` và `\u002Fconfig\u002Fprint-template\u002F:id`\n- Monaco editor (`ngx-monaco-editor-v2`) NGOÀI `\u003Cform>` — tránh CVA `setDisabledState` gotcha\n- Sync Monaco → FormControl thủ công qua `editor.onDidChangeModelContent`\n- Placeholder sidebar: click → `editor.executeEdits()` chèn tại cursor position\n- Live preview: `\u003Ciframe #previewFrame sandbox=\"allow-same-origin\">` set `srcdoc` qua `effect()`\n\n## FE — PrintPayment (ví dụ tích hợp)\n\n`PrintTemplateRenderService.getDefault('payment', branchId)` → nếu có tpl → render + `renderedHtml.set(html)` → `[innerHTML]=\"renderedHtml() | safeHtml\"`. Nếu null → fallback hardcode Angular template.\n\n## Template data shape (payment)\n\n```typescript\n{\n  company: { name, hotline, website, logo },   \u002F\u002F key giữ tên `company` cho template cũ; giá trị lấy từ authBusinessProfile() (business_profile, D22)\n  branch: { name, address, hotline, email },\n  customer: { fullname, phone, email, address, code },\n  payment: { code, date, note, total, outstanding },\n  services: [{ name, quantity, unit_price, subtotal, discount, total }],\n  print: { date, day, month, year },\n}\n```\n\n\nTable `control_field_in_table`: 2 static row, KHÔNG có `company_id`\u002F`branch_id` (global, không tenant-scoped by design — seed 1 lần trong migration, không CRUD thêm row).\n\n- `id=1` \"Bảng khách hàng\" → form Contact\u002FCustomerForm\n- `id=2` \"Bảng khách hàng (Lead)\" → form Lead\u002FFormLead\n\nColumn `control` (`datatypes.JSON`): mảng `{field_name, field_label, create, update, edit}`.\n- `edit=true` = **\"Không được cập nhật\"** (field bị khoá khỏi update), KHÔNG phải \"cho phép sửa\".\n\n## GOTCHA — 2 format lưu trữ khác nhau cho cùng cột `control`\n\nDB có thể lưu 1 trong 2 dạng cho cùng cột:\n- Plain array: `[{...}, {...}]`\n- Wrapped: `{\"control\": [{...}, {...}]}`\n\nMọi nơi đọc field này PHẢI thử unwrap cả 2 dạng, không được assume 1 format cố định:\n```go\nvar fields []map[string]interface{}\nif json.Unmarshal(raw, &fields) != nil {\n\tvar wrapper map[string]json.RawMessage\n\tif json.Unmarshal(raw, &wrapper) == nil {\n\t\tif inner, ok := wrapper[\"control\"]; ok {\n\t\t\t_ = json.Unmarshal(inner, &fields)\n\t\t}\n\t}\n}\n```\nÁp dụng ở: BE `handler.GetFieldCustomer`, BE `CustomerService.applyFieldLocks` (xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fcustomer.md`), FE `customer-form.ts loadValidationRules()`.\n\n## Routes (`internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fcontrol_field_in_table\u002F`)\n\n- `GET :id\u002Fget-field-customer` — trả `control` đã parse, hoặc `defaultCustomerFields` hardcode nếu `control` rỗng\n- `POST :id\u002Fupdate-field-customer` — nhận `{control: [...]}`, lưu nguyên array vào cột `control`\n- `POST :id\u002Fre-build` — set `control = NULL` (reset về default)\n\nKhông có service layer — handler gọi thẳng `h.DB`. Sau CUD: `dexie.BumpDexieTable(h.DB, \"controlFieldInTables\")`.\n\nFE consumer chính không gọi trực tiếp GET endpoint — `customer-form.ts loadValidationRules()` đọc qua IndexedDB cache (`ControlFieldInTableCacheService`).\n\n## KNOWN GAP — chưa fix\n\n`route_perm_map.json` ĐÃ map đủ 3 route — cả 3 dùng `manageConfig` (quyền duy nhất của module Cấu hình từ 2026-09-02), `enforce_phase1:true` ở `update-field-customer` + `re-build` — nhưng enforcer toàn cục đang audit-mode (`PERM_ENFORCE=false`) → chưa chặn thật. Bất kỳ user đã login vẫn gọi thẳng `update-field-customer`\u002F`re-build` được, ảnh hưởng TOÀN hệ thống vì bảng global (không `company_id` để scope theo tenant) — `re-build` reset `control` về NULL cho mọi company.\n\nKhông thêm `requirePerm` riêng cho 3 route này để \"vá sớm\" — gap chung của cả module config, xem `skills\u002Fbackend-hard-rules\u002Freference\u002Fsecurity-patterns.md` §Field lock \u002F permission.\n\n\n\n",{"name":5,"description":7},"main","ea9f5ed9bd4eaf32e9489bcbe9603955c1462a63","skill\u002Fskills\u002Fworking-on-config",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 working-on-config",{"tool":39,"command":40},"bunx","bunx skills add cluvix\u002Fcluvix-crm --skill working-on-config",{"tool":42,"command":43},"pnpm","pnpm dlx skills add cluvix\u002Fcluvix-crm --skill working-on-config","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-config\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"reference\u002Fcall-center-fe.md","REFERENCE","参考文档",16171,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-config\u002Freference\u002Fcall-center-fe.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"reference\u002Fomicall-api.md",10846,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-config\u002Freference\u002Fomicall-api.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"reference\u002Fomicall-sdk.md",7890,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-config\u002Freference\u002Fomicall-sdk.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"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":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"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":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"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":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"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":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"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":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M7F45FK4E7YJ0MENAWJT9NGY","testing-backend","Hạ tầng test Go: unit test, integration test với TEST_MYSQL_DSN (MySQL disposable thật, KHÔNG dockertest), FreshTenant helper, HTTP handler test qua httptest, và mutation test (`go test -overlay`) để chứng minh test thật sự neo hành vi. Dùng skill này TRƯỚC KHI viết test mới cho backend Go, khi cần biết cách dựng DB test sạch mỗi lần chạy, trước khi báo một AC dạng phủ định\u002Fmặc định là Done, hoặc trước khi verify build\u002Ftest theo Development Protocol bước 4 (Validate).","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Ftesting-backend\u002FSKILL.md",[],[]]