[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F468VEARVSRRYBJ8VHJSJ3":3,"skill-same:01M7F468VEARVSRRYBJ8VHJSJ3":69},{"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},"01M7F468VEARVSRRYBJ8VHJSJ3","working-on-crm",null,"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(...)).","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-crm\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: working-on-crm\ndescription: >-\n  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,\n  thanh toán. Dùng skill này KHI làm feature\u002Fsửa bug đụng module crm (customer,\n  appointment, order, treatment, payment) — trước khi đọc code, để tránh phá vỡ business rule đã có (tái khai thác,\n  customer status IN(...)).\n---\n\n# Working on CRM\n\n> reference\u002Fcustomer.md: khách hàng · reference\u002Forder.md: đơn hàng · reference\u002Ftreatment.md:\n> liệu trình ·\n> reference\u002Fcheck-up-psychiatry.md: khám sàng lọc tâm thần ·\n> reference\u002Fappointment-list-performance.md: hợp đồng màn danh sách lịch hẹn (join + tìm kiếm).\n\n\n\nĐiều hướng file chuyên sâu: `INDEX.md` cùng folder.\n\n## Note (Ghi chú)\n- `togglePin`: đổi `is_pin` 0↔1\n- Gắn với `customer_id`\n\n## Reminder (Nhắc nhở)\n- Auto code generation (RE prefix)\n- `STATUS_DONE = 2`\n\n## CustomerLead (Khách tiềm năng)\n- Tạo từ website hoặc Zalo\n- Rate limit, IP duplicate check 30s (từ website)\n\n## Check-Up \u002F Thăm khám ban đầu\n> ⚠ Lịch sử: module check-up KHÔNG còn trong `crm\u002F` của CRM standalone (đã xoá, D1\u002FD17) — mục này chỉ để tra bản ERP cũ.\n- Mỗi chuyên khoa có bảng riêng, KHÔNG trộn chung\n- Tenant scope qua `customer.id` (bảng không có cột scope riêng)\n- Pattern đầy đủ: `skills\u002Fworking-on-crm\u002FSKILL.md`\n  - Tâm thần (`psych_assessment`): `skills\u002Fworking-on-crm\u002Freference\u002Fcheck-up-psychiatry.md`\n\n## WarrantyCard (Thẻ bảo hành)\n- Gắn với customer + service used\n- `confirmCard`: xác nhận bảo hành\n\n---\n\n## Gotchas CRM-wide\n\n- **Response write**: `DataWithMessage(c, result, \"msg\")` — reload từ DB vào `map[string]interface{}`, parse JSON fields, attach customer nếu FE cần\n- **Preload**: chỉ customer (không có IndexedDB). Supplier\u002FUnit\u002FMedicine\u002FBranch\u002FUser → FE resolve từ Dexie cache\n- **isLock**: KHÔNG phải 0\u002F1 — giá trị → Xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Forder.md` (§ OrderServiceUsed Constants)\n- **ShouldBind** thay `ShouldBindJSON` khi FE có thể gửi FormData (file upload)\n- **JSON columns**: GORM scan thành string → gọi `ParseJSONFieldForTable()` trước khi trả response\n- **Birthday**: `*time.Time` (DB date), KHÔNG `*int64`. Timestamp fields dùng `int64` (unix)\n- **Codegen serial**: width tự nở `max(serial_length, len(serial))`, INSERT mới check `affected=1 → serial=1`\n\n## Báo cáo CRM — quyền (epic manage-crm-report 2026-09-14)\n- Toàn bộ 21 trang `\u002Fcrm\u002Freport\u002F*` (xem + export) gate bằng **1 quyền duy nhất `manageCrmReport`** — `viewCrmReport`\u002F`viewReportAppointment` đã xoá khỏi catalog.\n- Dashboard CRM (web `\u002Fcrm` + mobile) **KHÔNG cần `manageCrmReport`** — gate bằng **quyền module CRM** (OR 7 quyền; cách lấy đúng chuỗi quyền: `frontend\u002Fskill\u002Fskills\u002Fhandling-fe-auth-and-i18n\u002FSKILL.md` §4):\n  `viewAppointment, viewCustomer, viewCheckUp, viewPlanOrder, viewTreatmentCourse, viewLaboOrder, viewWarrantyCard`.\n- Nguồn OR 7 quyền — **3 nơi, sửa 1 nơi phải sửa cả 3**: FE `frontend\u002Fsrc\u002Fapp\u002Fdefine\u002Fpermission.define.ts` hằng `CRM_MODULE_PERMISSIONS` (dùng bởi `system-module-menu.ts` ô `cxCrm` + `utilities\u002Fhome\u002Fhome.ts`); BE `route_perm_map.json` (21 entry `\u002Fapi\u002Fcrm\u002Fcrm-dashboard\u002F*` + 20 `\u002Fapi\u002Fmobile\u002Fv1\u002Fcrm\u002F*`), giữ đồng bộ bởi test `backend\u002Finternal\u002Fmodules\u002Fwebapp\u002Fauth\u002Frbac\u002Fseed\u002Fcrm_module_perm_set_test.go`; mobile `packages\u002Fcore_domain\u002Flib\u002Fsrc\u002Fpermissions.dart` hằng `kPermsCrmModule`.\n\n\n## Tổng quan\nLịch hẹn — model trung tâm CRM, kết nối Customer, OrderPlan, Payment, TreatmentCourse.\n\n### Constants\n```\nStatus: NOT_CHECKIN=1, CHECKED_IN=2, CHECKED_OUT=3, CANCEL=4, ADVISE=5, TREATMENT=6\nBookType: DAT_TRUOC=1, PHAT_SINH=2, DU_KIEN=3\nIsAccepted: ACCEPTED=1, NOT_ACCEPTED=2\nConfirmAppointment: 0=Chưa xác nhận, 1=Xác nhận khách đến, 2=Xác nhận khách không đến\n```\n\n### Phân loại loại hẹn (appointment_type)\n- Bảng `appointment_type` quản lý loại lịch hẹn (Tư vấn, Điều trị, Tái khám, Bảo hành…)\n- **KHÔNG hardcode `appointment_type_id`** khi filter loại tư vấn — dùng cột `isTypeRevenue`:\n  - `isTypeRevenue = 1` → loại hẹn tư vấn (revenue-generating consultation)\n  - Pre-fetch IDs: `SELECT id FROM appointment_type WHERE isTypeRevenue = 1 AND status = 1`\n  - Sau đó dùng `appointment_type_id IN (ids)` trong query chính\n- Áp dụng ở mọi dashboard\u002Freport cần lọc riêng lịch hẹn tư vấn (ví dụ: `AppointmentAcceptedStats` trong marketing dashboard)\n\n## Tạo mới\n- `appointment_number` = `SELECT COALESCE(MAX(appointment_number),0) ... FOR UPDATE` + 1 cùng customer_id + appointment_type_id — KHÔNG dùng COUNT+1 (race 2 request đồng thời)\n- `appointment_date_first = appointment_date`\n- (đã bỏ: điền `company_id` từ khách — D15; auto BMI + `checkDoctorConflict` chặn trùng giờ bác sĩ — D17 bỏ vai trò y tế, entity `appointment` không còn `doctor_id`\u002F`emr_*`)\n- `addTimelineEvent('Tạo mới lịch hẹn', content)`\n- afterSave: update `customer.last_contact_date`, customer status → STATUS_APPOINTMENT, gán `customer.branch_id` nếu null\n- afterSave: khách chưa có mã mà (khách hoặc lịch hẹn) có chi nhánh → sinh mã khách (tác dụng phụ ngoài phạm vi lịch hẹn — Update cũng làm), quy tắc: `reference\u002Fcustomer.md` §Mã khách hàng\n- `notifyAppointmentPush(..., \"push_appointment_new\")` — bắn cho `revenue_id`, trừ actor; fire-and-forget\n\n## Cập nhật\n- **Optimistic locking** theo `updated_at` (D6): FE gửi `updated_at` khác DB → `errs.ErrVersionConflict` (bảng không còn cột `version`)\n- Track `appointmentListDate`: nếu appointment_date thay đổi → append `{\"old\": \u003Cunix>, \"new\": \u003Cunix>}` vào JSON array (object, KHÔNG phải chuỗi \"d-m-Y -> d-m-Y\" như comment entity ghi)\n- Sync `customer.branch_id` + `customer.code` khi lịch hẹn có branch_id (`reference\u002Fcustomer.md` §Mã khách hàng)\n- Đổi `appointment_date` → `notifyAppointmentPush(..., \"push_appointment_time_changed\")`\n- afterSave:\n  - **Log changes** → insert log_appointment\n  - **Customer status mapping** — CANCEL → STATUS_APPOINTMENT_CANCEL · NOT_CHECKIN → STATUS_APPOINTMENT · CHECKED_IN\u002FOUT → STATUS_VISITED (chi tiết + `last_visit_date`\u002F`last_contact_date`: § updateCustomerStatus bên dưới)\n  - sortAppointment nếu appointment_type_id thay đổi\n\n## Check-in \u002F Check-out (cùng endpoint `PUT \u002F:id\u002Fcustomer-checkin`)\n- Alias cho client cũ: `POST \u002Fcrm\u002Fappointment\u002Fcustomer-checkin?id=` — route inject `id` từ query\n- FE form `checkin.ts` chỉ gửi `checkin_date \u002F checkout_date \u002F doctor_id \u002F is_accepted \u002F noteAppointment \u002F version` — **KHÔNG gửi `status`**\n- BE auto-derive status nếu `appt.Status == nil`:\n  - `merged.CheckoutDate != nil` → `STATUS_CHECKED_OUT` (3)\n  - `merged.CheckinDate != nil`  → `STATUS_CHECKED_IN` (2)\n  - cả 2 nil → `STATUS_NOT_CHECKIN` (1)\n- **`explicitClears`**: handler đọc raw body, key CÓ MẶT với `null`\u002F`\"\"` mới được xoá (mergeAppointment bỏ qua nil\u002Frỗng). Client gửi payload partial (mobile) không bị xoá oan. Tập cho phép xoá = `checkinClearableFields` (sinh hiệu + mô tả lâm sàng + ghi chú).\n- **Cascade rollback khi xoá date** — xoá `checkin_date` → NULL luôn `doctor_id`, `direct_sales_id`, `checkout_date`, `is_accepted`, `type_service_accepted_id`; xoá `checkout_date` → NULL `is_accepted`, `type_service_accepted_id`\n- Dual-write sinh hiệu sang `emr_vital_measurement` trong CÙNG tx (`prepareVitalDualWrite` TRƯỚC merge, `writeAppointmentVitals` sau Save) (module emr đã bỏ khỏi CRM standalone)\n- Timeline label theo trạng thái cuối: \"Khách check-in\" hoặc \"Khách check-out\"\n- Auto BMI + auto `emr_queue_number` khi chuyển sang CHECKED_IN\n- Triggers beforeSave\u002FafterSave giống Update\n\n## Cancel\n- Force `status = STATUS_CANCEL`\n- `addTimelineEvent('Huỷ lịch hẹn', noteAppointment)`\n- afterSave → customer status → STATUS_APPOINTMENT_CANCEL\n\n## Confirm\n- Bind confirmAppointment = 0\u002F1\u002F2\n- `addTimelineEvent(mess, noteAppointment)` — mess theo giá trị confirm\n\n## Xóa\n- beforeDelete: `DELETE FROM log_appointment` + `DELETE FROM zalo_zns_log` theo appointment_id (xoá sạch lịch sử, KHÔNG insert bản ghi log action=DELETE)\n- beforeDelete: unlink `order_service_used`, `order_treatment_plan`, `treatment_course` (SET appointment_id = NULL)\n- afterDelete: `sortAppointment` cùng customer + type\n\n## Ràng buộc lịch — trạng thái hiện tại\n\n**`checkSlotCapacity` ĐANG TẮT** (`crm\u002Fappointment\u002Fhandler\u002Fappointment.go`): thân hàm `return \"\"` ngay, toàn bộ logic `appointment_time_frame` bị comment (`\u002F\u002F TODO: ... tạm thời tắt`). KHÔNG có chống overbooking theo công suất slot; đừng viết feature\u002Freport dựa trên giả định nó chạy. Endpoint Create\u002FUpdate vẫn gọi hàm và vẫn trả 422 `slot_capacity_full` khi bật lại.\n\nHiện KHÔNG có ràng buộc trùng lịch nào chạy: `checkDoctorConflict` (chặn bác sĩ trùng khung giờ) đã bỏ cùng vai trò bác sĩ (D17) — lịch sử, đừng tìm hàm này trong code.\n\n## AddNote (`POST \u002F:id\u002Fadd-note`)\n\nAppend vào `noteTimeline` atomic bằng `JSON_ARRAY_APPEND` trong 1 UPDATE — KHÔNG đọc-sửa-ghi (`First` → append → `UpdateColumn`) vì không có version guard: 2 request đồng thời (AddNote\u002F\u002FAddNote hoặc AddNote\u002F\u002FUpdate) làm mất event của nhau.\n\n## updateCustomerStatus — 2 nhóm field độc lập\n\n- `last_contact_date` \u002F `last_visit_date`: cập nhật **không phụ thuộc** allow-list. CHECKED_IN → cả 2 = `checkin_date`; CHECKED_OUT → `last_visit_date` = `checkout_date`; NOT_CHECKIN\u002FCANCEL → `last_contact_date` = now.\n- `status` \u002F `accepted`: chỉ đổi khi `define.AllowedAppointmentCustomerStatuses[customer.status]`.\n- `is_accepted` override status: `IsNotAccepted` → LOST; id nằm trong `SELECT id FROM appointment_is_accepted WHERE isAccepted = 1 AND status = 1` → PRE_CUSTOMER + `accepted = ACCEPTED_OK`. KHÔNG hardcode id (cùng lớp với `isTypeRevenue`).\n\n## Màn danh sách + tìm kiếm\n\nJoin customer có điều kiện (`customerFilterColumns`), hợp đồng `applyKeywordFast`, cột list vs detail → `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fappointment-list-performance.md`. Số đo + 4 biến thể tìm kiếm đã loại + quy trình bench → `skill\u002Fskills\u002Fdebugging-backend-queries\u002Freference\u002Fperf-list-endpoints.md`.\n\n## Helpers\n- **addTimelineEvent**: parse `noteTimeline` JSON → append `{action, note, user_id, timestamp}` → marshal back\n- **sortAppointment**: reorder `appointment_number` cùng customer_id + appointment_type_id theo appointment_date ASC (ROW_NUMBER)\n\n## Dependencies\nCustomer, OrderPlan, Payment, TreatmentCourse, LogAppointment, AppointmentReason\n\n\n## Tổng quan\nXử lý tất cả loại thanh toán: đặt cọc, thanh toán đơn hàng, hoàn cọc, hoàn dịch vụ, thu\u002Fchi phòng khám.\n\n## Loại thanh toán (payment_for)\n```\n1 = Hoàn dịch vụ (FOR_REFUND_SERVICE)\n2 = Hoàn cọc (FOR_REFUND_DEPOSIT)\n3 = Đặt cọc (FOR_DEPOSIT)\n4 = Thanh toán đơn hàng (FOR_ORDER)\n5 = Chuyển cọc (FOR_MOVE_DEPOSIT)\n6 = Hoàn ký gửi (FOR_REFUND_DEPOSIT_KG)\n7 = Thu tiền phòng khám (FOR_CLINIC_INCOME)\n8 = Chi tiền phòng khám (FOR_CLINIC_EXPENSE)\n```\n\n## payment_method (Hình thức) — bảng global cố định, id có ý nghĩa\n\n`payment_method` là bảng global (không scope chi nhánh), UNIQUE theo `name`, seed 1 lần (`migrations\u002F00000000000001_seed_data.up.sql`), luôn đúng 4 dòng: `1=Chuyển khoản, 2=Máy POS, 3=Chuyển cọc, 4=Tiền mặt`. Vì bảng cố định → được phép hardcode id như enum (khác các bảng config khác thường phải lookup theo tên).\n\n- **FOR_MOVE_DEPOSIT (chuyển cọc → thanh toán)**: `method` LUÔN set cứng server-side = `define.PaymentMethodTransferDeposit` (=3, \"Chuyển cọc\") trong `MoveDepositToPaymentFromPayment`\u002F`MoveDepositToPayment` (`payment_crud.go`) — **FE không có field chọn method trong `FormMoveDeposit`** (cố ý, không phải thiếu sót), vì bản chất đây là bút toán nội bộ (không có dòng tiền mới phát sinh), không phải user tự chọn hình thức thanh toán.\n- **Bug đã xảy ra 2026-07-27**: hằng số từng đặt tên `PaymentMethodTransfer = 1` (nhầm sang \"Chuyển khoản\" id=1) — trông giống đúng tên nhưng sai giá trị, khiến payment chuyển cọc hiện sai \"Hình thức\". Đã đổi tên `PaymentMethodTransferDeposit = 3` cho khớp nghĩa. Đừng đổi lại giá trị này nếu không verify lại `payment_method.name` trong seed.\n\n## Phiếu DÙNG cọc — cọc phải của chính khách đó (2026-09-22)\n- `validateDepositUse` (`crm\u002Fservice\u002Fpayment_crud.go`) chạy ở 4 luồng tạo: hoàn cọc, hoàn ký gửi, `MoveDepositToPayment*` (cả bản deprecated). Phiếu cọc phải `payment_for = FOR_DEPOSIT`, **cùng `customer_id`** (vế \"cùng `company_id`\" đã bỏ ở story-37, D15); chuyển cọc thì `serviceUsed_id` \u002F `parent_id` từ body cũng phải của khách chủ cọc. Sai ⇒ `errs.ErrDepositCustomerMismatch` (422 `deposit_customer_mismatch`); không phải phiếu cọc ⇒ `ErrDepositNotFound`. Trước đây nhận `deposit_id` từ body không đối chiếu gì (IDOR body-id).\n- Đường SỬA phiếu không đổi được `deposit_id` \u002F `serviceUsed_id` \u002F `customer_id` (`mergePaymentParams`) nên không cần guard ở đó — thêm field vào merge thì PHẢI gọi lại guard.\n- Test: `crm\u002Fservice\u002Fdeposit_use_integration_test.go` (có ca cọc của khách khác — xem `..\u002Ftesting-backend\u002FSKILL.md` §FreshTenant).\n- `payment.deposit_id` có index `idx_payment_deposit_id` (migration `20260922154654`) — trước đó mọi `deletePayment` + tính số dư cọc quét toàn bảng payment.\n\n## Xoá HÀNG LOẠT phiếu — gom phần tính lại (`deferredPaymentRecalc`)\n`deletePaymentWith(p, userID, deferred)`: deferred != nil ⇒ phần lõi (guard kỳ khoá\u002Fhoá đơn, dọn hoa hồng\u002Fdoanh thu\u002Fhoá đơn nháp, log, bút toán đảo, **hoa hồng CTV**) chạy ngay; phần tính lại gom và chạy 1 lần cuối (hàm tính lại đều state-based). Bảng giữ\u002Fgom\u002Fbỏ từng tác dụng: comment `deferredPaymentRecalc` (`crm\u002Fservice\u002Fpayment.go`). Chỉ dùng khi khách\u002Fđơn\u002Fdòng dịch vụ CHẮC CHẮN bị xoá cùng transaction — hiện chỉ `DeleteCustomerWithPayments`. Đo trên clone dev: 5 khách nhiều phiếu nhất 19.2s → 3.9s; so 377 bảng giữa cách cũ và cách gom: 0 khác biệt (bộ so đã đối chứng bằng 1 dòng sửa cố ý). Dev không có CTV nên nhánh hoa hồng CTV không được so — nhánh đó không đổi (vẫn chạy từng phiếu).\n\n## Loại đặt cọc (deposit_type)\n```\n1 = Đặt cọc giữ chỗ (RESERVE)\n2 = Đặt cọc tạm (TEMP)\n3 = Ký gửi (KG) — loại trừ khỏi thực thu\n```\n\n## Routes (19 endpoints) — `internal\u002Fmodules\u002Fwebapp\u002Fcrm\u002Fpayment\u002Froute.go`\n\n### Đặt cọc\n- `POST create-deposit-customer` — Tạo đặt cọc → update customer.totalDeposit\n- `PUT :id\u002Fupdate-deposit-customer` — Cập nhật\n- `DELETE :id\u002Fdelete-deposit-customer` — Xóa\n\n### Thanh toán\n- `POST create-payment-order` — Thanh toán đơn hàng\n- `POST create-payment-customer` — Thanh toán khách hàng\n- `POST \"\"` \u002F `PUT :id` — Thu\u002Fchi phòng khám (CreatePaymentClinic \u002F UpdatePaymentClinic)\n- `PUT :id\u002Fupdate-payment-customer` — Cập nhật\n- `DELETE :id\u002Fdelete-payment-customer` — Xóa\n- `GET :id` — Chi tiết payment\n- `POST :id\u002Fmove-deposit-to-payment` \u002F `PUT :id\u002Fmove-deposit-to-payment` — Chuyển cọc thành thanh toán\n\n### Hoàn trả (reverse logic)\n- `POST create-refund-deposit-customer` — Hoàn cọc\n- `POST create-refund-kg-customer` — Hoàn ký gửi\n- `POST create-refund-order-plan` — Hoàn dịch vụ\n- `DELETE :id\u002Fdelete-refund-customer` — Xóa hoàn cọc\n- `DELETE :id\u002Fdelete-refund-consignment` — Xóa hoàn ký gửi\n- `DELETE :id\u002Fdelete-refund-order-plan` — Xóa hoàn dịch vụ\n\n`GET \u002Fcrm\u002Fpayment\u002Fget-payment-detail-for-customer` KHÔNG nằm trong module — handler ở `customer_detail.go` (package crm), wire riêng trong `router\u002Fcrm.go`.\n\n## Thanh toán 1 phần cho nhiều dịch vụ — waterfall theo created_day\n- `create-payment-customer` (>1 serviceUsed_idArr): amount chỉ cần `\u003C= tổng nợ` (không còn bắt khớp chính xác)\n- Phân bổ waterfall: sort `created_day ASC` (nil = cũ nhất, id tie-break) → trả ĐỦ dịch vụ cũ trước, dư mới chảy qua dịch vụ sau — KHÔNG chia tỷ lệ\n- Pure logic: `allocatePaymentWaterfall` (`payment_crud.go`) — tách riêng để unit-test không cần DB\n- Đọc nợ (`order_service_used`) + tạo payment PHẢI cùng 1 transaction, khóa `clause.Locking{Strength:\"UPDATE\"}` — chặn double-submit tạo trùng\u002Fvượt payment. Cùng pattern `CreatePaymentOrderFromPayment`.\n- Waterfall tạo **nhiều dòng `payment`** (1 dòng\u002Fdịch vụ), mỗi dòng mã riêng vì cột `code` UNIQUE — schema KHÔNG có bảng phân bổ riêng.\n- Hiển thị\u002Fđối soát \"phân bổ của một lần thu\" → gom theo `parent_id` (cùng đơn hàng). KHÔNG gom theo `payment_time`\u002F`created_at`: hai lần thu trong cùng một giây sẽ dính vào nhau.\n\n## afterSave (rất phức tạp)\n- Update customer financials: totalPayment, totalDebt, totalDeposit, totalBonus, refundDeposit, refundService, consignment, refundConsignment\n- Update OrderTreatmentPlan: totalPayment, totalDebt\n- Update OrderServiceUsed: payment_status\n- Log changes (LogPayment)\n- Tính commission cho telesale\u002FdirectSale\u002Fdoctor\u002Ftechnical\u002Fassistant\n  - `listRevenues`, `listDoctors`, `listDirectSales`, `source_id` **KHÔNG còn trong payment entity** — đọc trực tiếp từ `order_service_used` (canonical source)\n  - Handlers commission JOIN `order_service_used` để lấy các field này\n\n**`payment_status = Done` KHÔNG bị hoàn tiền làm tụt (GOTCHA)** — `calculatorPaymentServiceUsed` tính `payment_status` từ `paymentTotal = SUM(payment_for IN Order\u002FMoveDeposit)` so với `totalEnd`. Refund (`payment_for = RefundService`) ghi riêng vào `refundServiceUsed`, **KHÔNG trừ vào `paymentTotal`**.\n- ⇒ hoàn tiền 100% vẫn để `payment_status = Done`. Side-effect nào cần nghĩa \"còn hiệu lực\" (kho, hoa hồng, loyalty, report) phải tự đối chiếu thêm `refundServiceUsed >= totalEnd`, KHÔNG được chỉ đọc `payment_status`.\n- `totalEnd = 0` → luôn ra `Start (1)`, không bao giờ `Done` (điều kiện `totalEnd.IsPositive()`).\n\n## list*\u002Fsource của payment — đọc từ `order_service_used`\n- Payment KHÔNG copy list*\u002Fsource; export JOIN `order_service_used` trực tiếp khi cần.\n- (Lịch sử: helper `setFromServiceUsed` \u002F `setFromCustomer` \u002F `setSourceFromCustomer` chỉ còn để điền `company_id` — đã xoá cùng cột, D15.)\n\n## Commission 1-to-many — list* vs commission tables\n\n→ Xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Forder.md` § \"JSON array columns — listRevenues \u002F listDoctors \u002F listDirectSales\" (phân công vs derived, write pattern idempotent theo payment_id, JSON_CONTAINS\u002FJSON_TABLE).\n\n## Commission snapshot — rate lock tại thời điểm lên đơn\n\n- `order_service_used` có 6 snapshot fields: `commission_telesale_snap`, `commission_telesale_type_snap`, `commission_direct_sale_snap`, `commission_direct_sale_type_snap`, `commission_doctor_consultant_snap`, `commission_doctor_consultant_type_snap`\n- Set 1 lần khi CREATE `order_service_used` — hàm `snapshotCommissionRates` trong `crm\u002Fservice\u002Forder_treatment_plan.go`\n- `OrderPlanType=2` (old customer) → dùng `commission_*` (rate cũ); `=1` (new) → `commission_*_new`\n- Payment handler đọc snap trước; nếu NULL (đơn cũ chưa có snapshot) → fallback JOIN service table\n- KHÔNG re-snapshot khi UPDATE order_service_used — rate bị lock từ lúc lên đơn\n- Commission type: `DiscountTypeNormal=1` = VND cố định, `DiscountTypePercent=2` = phần trăm (`pkg\u002Fdefine\u002Forder_service_used.go`)\n\n**Rule chung (CRITICAL) — áp dụng mọi rate % tính tiền từ bảng master:** nếu commission\u002Ftiền được **recalculate nhiều lần** (mỗi payment, lock\u002Funlock...), phải snapshot rate vào cột riêng NGAY LÚC gán FK — KHÔNG JOIN đọc live từ bảng master mỗi lần recalc, vì admin đổi rate sau đó sẽ làm số tiền đã chốt trước bị tính lại retroactive.\n\n```go\n\u002F\u002F ❌ SAI — recalc sau này đọc rate MỚI thay vì rate lúc phát sinh\ntx.Table(\"broker\").Select(\"commissionRate\").Where(\"id = ?\", brokerID).Scan(&rate)\n\n\u002F\u002F ✅ ĐÚNG — snapshot vào cột riêng, recalc chỉ đọc lại cột đã snapshot\ntx.Exec(`INSERT INTO broker_commission (..., commissionRateSnap) VALUES (..., ?)`, rateSnap)\n```\n\nVới upsert `INSERT ... ON DUPLICATE KEY UPDATE`, chỉ refresh snapshot khi FK thực sự đổi — dùng `IF()` so sánh ngay trong SQL:\n```sql\ncommissionRateSnap = IF(broker_id = VALUES(broker_id), commissionRateSnap, VALUES(commissionRateSnap))\n```\n\nPrecedent thứ 2: `broker_commission.commissionRateSnap` (loyalty module, affiliate path) — thiếu snapshot cho tới fix 2026-07-02, xem `loyalty\u002Fbroker.md § broker_commission lifecycle`.\n\n## Commission report endpoints — response format\n\n- Handler telesale\u002Fdirect-sale\u002Fdoctor-consultant list + summary dùng flat `c.JSON(http.StatusOK, gin.H{...})` — **KHÔNG** `response.Data`\n- FE nhận thẳng `{items, _meta, totalCommission}` — không có lớp `data` bọc ngoài\n- Nếu handler đổi sang `response.Data(c, gin.H{...})`, FE service phải thêm `.pipe(map((r: any) => r?.data ?? r))` vào method tương ứng\n\n## calculatorMoneyCustomer — logic theo payment_for\n| payment_for | Fields cập nhật | Ghi chú |\n|---|---|---|\n| FOR_ORDER (4), FOR_MOVE_DEPOSIT (5) | totalPayment, totalDebt, customerType=OLD | totalDebt = totalRevenue - totalPayment |\n| FOR_REFUND_SERVICE (1) | refundService, totalPayment | **KHÔNG** update totalDebt |\n| FOR_REFUND_DEPOSIT (2) | refundDeposit, totalDeposit | |\n| FOR_REFUND_DEPOSIT_KG (6) | consignment, refundConsignment | |\n| FOR_DEPOSIT (3) | totalDeposit hoặc consignment | tuỳ deposit_type |\n| FOR_CLINIC_INCOME (7), FOR_CLINIC_EXPENSE (8) | **Không gọi updateCustomer** | |\n\n> ⚠️ `FOR_REFUND_SERVICE` chỉ update `refundService` + `totalPayment`, **không** recalc `totalDebt` — đúng theo Yii2.\n\n## Business validation — beforeSave (CRITICAL)\n\n| Loại | Trường check | Rule | Error key |\n|---|---|---|---|\n| FOR_ORDER | `payment_time` | `payment_time >= osu.created_day` | `payment_before_order_date` |\n| FOR_MOVE_DEPOSIT | `payment_of_date` | `payment_of_date >= osu.created_day` | `payment_before_order_date` |\n\n**Tại sao FOR_ORDER dùng `payment_time`, FOR_MOVE_DEPOSIT dùng `payment_of_date`:**\n- FOR_ORDER: `payment_of_date` được sync từ `payment_time` trong `beforeSave` → dùng `payment_time` là canonical.\n- FOR_MOVE_DEPOSIT: `payment_time` lấy từ cọc gốc (có thể trước ngày tạo đơn) → `payment_of_date` mới là ngày user chọn khi chuyển cọc.\n\n**Bỏ qua validation nếu `osu.created_day IS NULL`** — đơn cũ không có trường này, không block.\n\n> Lý do: `osu.created_day` là trường **có thể chỉnh sửa** (\"ngày lên đơn nghiệp vụ\"), khác với `created_at` (timestamp hệ thống). Nếu thanh toán được phép đặt ngày trước ngày lên đơn → `osu.payment` (running total) có thể vượt `totalSum` của báo cáo kế toán lọc theo `payment_of_date` cùng kỳ → số liệu phi logic.\n\n## paymentListSelect — shared const yêu cầu JOIN\n\n- `paymentListSelect` (payment.go) SELECT `order_service_used.listRevenues`, `.listDoctors` — bất kỳ handler nào dùng const này PHẢI tự JOIN `order_service_used`.\n- `buildPaymentFilters` đã JOIN sẵn; các handler có filter riêng (`ListCustomerDepositMkt` v.v.) phải thêm JOIN độc lập:\n  ```go\n  Joins(\"LEFT JOIN order_service_used ON order_service_used.id = payment.serviceUsed_id\")\n  ```\n\n## broker_commission — thêm\u002Fđổi CTV sau khi đã có payment (GOTCHA)\n\nSau upsert broker_commission trong update path PHẢI gọi `syncBrokerCommission(tx, int(svc.ID))` — nếu không, CTV mới có `amount=0` dù đã thanh toán đủ.\n\n## Auto code generation\nPrefix TT, sinh trong `BaseModelWithCode.BeforeCreate` (`internal\u002Fmodels\u002Fbase.go`) → `codegen.GenerateErr(tx, table, branchID)` — chỉ còn tham số chi nhánh (vế company đã bỏ, D15).\n\n## In lại phiếu thanh toán (print\u002Fpayment) — date-scope theo payment_of_date (GOTCHA)\n\n- `internal\u002Fmodules\u002Fwebapp\u002Fprint\u002Fpayment\u002Fhandler\u002Fhandler.go` `PrintPayment`: `historyPayment`\u002F`totalPayment` PHẢI filter `payment.payment_of_date \u003C= payment đang in` (tie-break bằng `id` khi trùng ngày), KHÔNG chỉ theo `parent_id`+`serviceUsed_id` — thiếu filter ngày sẽ gộp cả thanh toán phát sinh SAU thời điểm phiếu in, hiển thị sai \"đã thanh toán hết\".\n- Áp dụng chung: mọi endpoint in lại chứng từ lịch sử (reprint) tính cumulative\u002Frunning-total phải snapshot đến thời điểm bản ghi đang in, không query theo trạng thái hiện tại.\n","# Working on CRM\n\n> reference\u002Fcustomer.md: khách hàng · reference\u002Forder.md: đơn hàng · reference\u002Ftreatment.md:\n> liệu trình ·\n> reference\u002Fcheck-up-psychiatry.md: khám sàng lọc tâm thần ·\n> reference\u002Fappointment-list-performance.md: hợp đồng màn danh sách lịch hẹn (join + tìm kiếm).\n\n\n\nĐiều hướng file chuyên sâu: `INDEX.md` cùng folder.\n\n## Note (Ghi chú)\n- `togglePin`: đổi `is_pin` 0↔1\n- Gắn với `customer_id`\n\n## Reminder (Nhắc nhở)\n- Auto code generation (RE prefix)\n- `STATUS_DONE = 2`\n\n## CustomerLead (Khách tiềm năng)\n- Tạo từ website hoặc Zalo\n- Rate limit, IP duplicate check 30s (từ website)\n\n## Check-Up \u002F Thăm khám ban đầu\n> ⚠ Lịch sử: module check-up KHÔNG còn trong `crm\u002F` của CRM standalone (đã xoá, D1\u002FD17) — mục này chỉ để tra bản ERP cũ.\n- Mỗi chuyên khoa có bảng riêng, KHÔNG trộn chung\n- Tenant scope qua `customer.id` (bảng không có cột scope riêng)\n- Pattern đầy đủ: `skills\u002Fworking-on-crm\u002FSKILL.md`\n  - Tâm thần (`psych_assessment`): `skills\u002Fworking-on-crm\u002Freference\u002Fcheck-up-psychiatry.md`\n\n## WarrantyCard (Thẻ bảo hành)\n- Gắn với customer + service used\n- `confirmCard`: xác nhận bảo hành\n\n---\n\n## Gotchas CRM-wide\n\n- **Response write**: `DataWithMessage(c, result, \"msg\")` — reload từ DB vào `map[string]interface{}`, parse JSON fields, attach customer nếu FE cần\n- **Preload**: chỉ customer (không có IndexedDB). Supplier\u002FUnit\u002FMedicine\u002FBranch\u002FUser → FE resolve từ Dexie cache\n- **isLock**: KHÔNG phải 0\u002F1 — giá trị → Xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Forder.md` (§ OrderServiceUsed Constants)\n- **ShouldBind** thay `ShouldBindJSON` khi FE có thể gửi FormData (file upload)\n- **JSON columns**: GORM scan thành string → gọi `ParseJSONFieldForTable()` trước khi trả response\n- **Birthday**: `*time.Time` (DB date), KHÔNG `*int64`. Timestamp fields dùng `int64` (unix)\n- **Codegen serial**: width tự nở `max(serial_length, len(serial))`, INSERT mới check `affected=1 → serial=1`\n\n## Báo cáo CRM — quyền (epic manage-crm-report 2026-09-14)\n- Toàn bộ 21 trang `\u002Fcrm\u002Freport\u002F*` (xem + export) gate bằng **1 quyền duy nhất `manageCrmReport`** — `viewCrmReport`\u002F`viewReportAppointment` đã xoá khỏi catalog.\n- Dashboard CRM (web `\u002Fcrm` + mobile) **KHÔNG cần `manageCrmReport`** — gate bằng **quyền module CRM** (OR 7 quyền; cách lấy đúng chuỗi quyền: `frontend\u002Fskill\u002Fskills\u002Fhandling-fe-auth-and-i18n\u002FSKILL.md` §4):\n  `viewAppointment, viewCustomer, viewCheckUp, viewPlanOrder, viewTreatmentCourse, viewLaboOrder, viewWarrantyCard`.\n- Nguồn OR 7 quyền — **3 nơi, sửa 1 nơi phải sửa cả 3**: FE `frontend\u002Fsrc\u002Fapp\u002Fdefine\u002Fpermission.define.ts` hằng `CRM_MODULE_PERMISSIONS` (dùng bởi `system-module-menu.ts` ô `cxCrm` + `utilities\u002Fhome\u002Fhome.ts`); BE `route_perm_map.json` (21 entry `\u002Fapi\u002Fcrm\u002Fcrm-dashboard\u002F*` + 20 `\u002Fapi\u002Fmobile\u002Fv1\u002Fcrm\u002F*`), giữ đồng bộ bởi test `backend\u002Finternal\u002Fmodules\u002Fwebapp\u002Fauth\u002Frbac\u002Fseed\u002Fcrm_module_perm_set_test.go`; mobile `packages\u002Fcore_domain\u002Flib\u002Fsrc\u002Fpermissions.dart` hằng `kPermsCrmModule`.\n\n\n## Tổng quan\nLịch hẹn — model trung tâm CRM, kết nối Customer, OrderPlan, Payment, TreatmentCourse.\n\n### Constants\n```\nStatus: NOT_CHECKIN=1, CHECKED_IN=2, CHECKED_OUT=3, CANCEL=4, ADVISE=5, TREATMENT=6\nBookType: DAT_TRUOC=1, PHAT_SINH=2, DU_KIEN=3\nIsAccepted: ACCEPTED=1, NOT_ACCEPTED=2\nConfirmAppointment: 0=Chưa xác nhận, 1=Xác nhận khách đến, 2=Xác nhận khách không đến\n```\n\n### Phân loại loại hẹn (appointment_type)\n- Bảng `appointment_type` quản lý loại lịch hẹn (Tư vấn, Điều trị, Tái khám, Bảo hành…)\n- **KHÔNG hardcode `appointment_type_id`** khi filter loại tư vấn — dùng cột `isTypeRevenue`:\n  - `isTypeRevenue = 1` → loại hẹn tư vấn (revenue-generating consultation)\n  - Pre-fetch IDs: `SELECT id FROM appointment_type WHERE isTypeRevenue = 1 AND status = 1`\n  - Sau đó dùng `appointment_type_id IN (ids)` trong query chính\n- Áp dụng ở mọi dashboard\u002Freport cần lọc riêng lịch hẹn tư vấn (ví dụ: `AppointmentAcceptedStats` trong marketing dashboard)\n\n## Tạo mới\n- `appointment_number` = `SELECT COALESCE(MAX(appointment_number),0) ... FOR UPDATE` + 1 cùng customer_id + appointment_type_id — KHÔNG dùng COUNT+1 (race 2 request đồng thời)\n- `appointment_date_first = appointment_date`\n- (đã bỏ: điền `company_id` từ khách — D15; auto BMI + `checkDoctorConflict` chặn trùng giờ bác sĩ — D17 bỏ vai trò y tế, entity `appointment` không còn `doctor_id`\u002F`emr_*`)\n- `addTimelineEvent('Tạo mới lịch hẹn', content)`\n- afterSave: update `customer.last_contact_date`, customer status → STATUS_APPOINTMENT, gán `customer.branch_id` nếu null\n- afterSave: khách chưa có mã mà (khách hoặc lịch hẹn) có chi nhánh → sinh mã khách (tác dụng phụ ngoài phạm vi lịch hẹn — Update cũng làm), quy tắc: `reference\u002Fcustomer.md` §Mã khách hàng\n- `notifyAppointmentPush(..., \"push_appointment_new\")` — bắn cho `revenue_id`, trừ actor; fire-and-forget\n\n## Cập nhật\n- **Optimistic locking** theo `updated_at` (D6): FE gửi `updated_at` khác DB → `errs.ErrVersionConflict` (bảng không còn cột `version`)\n- Track `appointmentListDate`: nếu appointment_date thay đổi → append `{\"old\": \u003Cunix>, \"new\": \u003Cunix>}` vào JSON array (object, KHÔNG phải chuỗi \"d-m-Y -> d-m-Y\" như comment entity ghi)\n- Sync `customer.branch_id` + `customer.code` khi lịch hẹn có branch_id (`reference\u002Fcustomer.md` §Mã khách hàng)\n- Đổi `appointment_date` → `notifyAppointmentPush(..., \"push_appointment_time_changed\")`\n- afterSave:\n  - **Log changes** → insert log_appointment\n  - **Customer status mapping** — CANCEL → STATUS_APPOINTMENT_CANCEL · NOT_CHECKIN → STATUS_APPOINTMENT · CHECKED_IN\u002FOUT → STATUS_VISITED (chi tiết + `last_visit_date`\u002F`last_contact_date`: § updateCustomerStatus bên dưới)\n  - sortAppointment nếu appointment_type_id thay đổi\n\n## Check-in \u002F Check-out (cùng endpoint `PUT \u002F:id\u002Fcustomer-checkin`)\n- Alias cho client cũ: `POST \u002Fcrm\u002Fappointment\u002Fcustomer-checkin?id=` — route inject `id` từ query\n- FE form `checkin.ts` chỉ gửi `checkin_date \u002F checkout_date \u002F doctor_id \u002F is_accepted \u002F noteAppointment \u002F version` — **KHÔNG gửi `status`**\n- BE auto-derive status nếu `appt.Status == nil`:\n  - `merged.CheckoutDate != nil` → `STATUS_CHECKED_OUT` (3)\n  - `merged.CheckinDate != nil`  → `STATUS_CHECKED_IN` (2)\n  - cả 2 nil → `STATUS_NOT_CHECKIN` (1)\n- **`explicitClears`**: handler đọc raw body, key CÓ MẶT với `null`\u002F`\"\"` mới được xoá (mergeAppointment bỏ qua nil\u002Frỗng). Client gửi payload partial (mobile) không bị xoá oan. Tập cho phép xoá = `checkinClearableFields` (sinh hiệu + mô tả lâm sàng + ghi chú).\n- **Cascade rollback khi xoá date** — xoá `checkin_date` → NULL luôn `doctor_id`, `direct_sales_id`, `checkout_date`, `is_accepted`, `type_service_accepted_id`; xoá `checkout_date` → NULL `is_accepted`, `type_service_accepted_id`\n- Dual-write sinh hiệu sang `emr_vital_measurement` trong CÙNG tx (`prepareVitalDualWrite` TRƯỚC merge, `writeAppointmentVitals` sau Save) (module emr đã bỏ khỏi CRM standalone)\n- Timeline label theo trạng thái cuối: \"Khách check-in\" hoặc \"Khách check-out\"\n- Auto BMI + auto `emr_queue_number` khi chuyển sang CHECKED_IN\n- Triggers beforeSave\u002FafterSave giống Update\n\n## Cancel\n- Force `status = STATUS_CANCEL`\n- `addTimelineEvent('Huỷ lịch hẹn', noteAppointment)`\n- afterSave → customer status → STATUS_APPOINTMENT_CANCEL\n\n## Confirm\n- Bind confirmAppointment = 0\u002F1\u002F2\n- `addTimelineEvent(mess, noteAppointment)` — mess theo giá trị confirm\n\n## Xóa\n- beforeDelete: `DELETE FROM log_appointment` + `DELETE FROM zalo_zns_log` theo appointment_id (xoá sạch lịch sử, KHÔNG insert bản ghi log action=DELETE)\n- beforeDelete: unlink `order_service_used`, `order_treatment_plan`, `treatment_course` (SET appointment_id = NULL)\n- afterDelete: `sortAppointment` cùng customer + type\n\n## Ràng buộc lịch — trạng thái hiện tại\n\n**`checkSlotCapacity` ĐANG TẮT** (`crm\u002Fappointment\u002Fhandler\u002Fappointment.go`): thân hàm `return \"\"` ngay, toàn bộ logic `appointment_time_frame` bị comment (`\u002F\u002F TODO: ... tạm thời tắt`). KHÔNG có chống overbooking theo công suất slot; đừng viết feature\u002Freport dựa trên giả định nó chạy. Endpoint Create\u002FUpdate vẫn gọi hàm và vẫn trả 422 `slot_capacity_full` khi bật lại.\n\nHiện KHÔNG có ràng buộc trùng lịch nào chạy: `checkDoctorConflict` (chặn bác sĩ trùng khung giờ) đã bỏ cùng vai trò bác sĩ (D17) — lịch sử, đừng tìm hàm này trong code.\n\n## AddNote (`POST \u002F:id\u002Fadd-note`)\n\nAppend vào `noteTimeline` atomic bằng `JSON_ARRAY_APPEND` trong 1 UPDATE — KHÔNG đọc-sửa-ghi (`First` → append → `UpdateColumn`) vì không có version guard: 2 request đồng thời (AddNote\u002F\u002FAddNote hoặc AddNote\u002F\u002FUpdate) làm mất event của nhau.\n\n## updateCustomerStatus — 2 nhóm field độc lập\n\n- `last_contact_date` \u002F `last_visit_date`: cập nhật **không phụ thuộc** allow-list. CHECKED_IN → cả 2 = `checkin_date`; CHECKED_OUT → `last_visit_date` = `checkout_date`; NOT_CHECKIN\u002FCANCEL → `last_contact_date` = now.\n- `status` \u002F `accepted`: chỉ đổi khi `define.AllowedAppointmentCustomerStatuses[customer.status]`.\n- `is_accepted` override status: `IsNotAccepted` → LOST; id nằm trong `SELECT id FROM appointment_is_accepted WHERE isAccepted = 1 AND status = 1` → PRE_CUSTOMER + `accepted = ACCEPTED_OK`. KHÔNG hardcode id (cùng lớp với `isTypeRevenue`).\n\n## Màn danh sách + tìm kiếm\n\nJoin customer có điều kiện (`customerFilterColumns`), hợp đồng `applyKeywordFast`, cột list vs detail → `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fappointment-list-performance.md`. Số đo + 4 biến thể tìm kiếm đã loại + quy trình bench → `skill\u002Fskills\u002Fdebugging-backend-queries\u002Freference\u002Fperf-list-endpoints.md`.\n\n## Helpers\n- **addTimelineEvent**: parse `noteTimeline` JSON → append `{action, note, user_id, timestamp}` → marshal back\n- **sortAppointment**: reorder `appointment_number` cùng customer_id + appointment_type_id theo appointment_date ASC (ROW_NUMBER)\n\n## Dependencies\nCustomer, OrderPlan, Payment, TreatmentCourse, LogAppointment, AppointmentReason\n\n\n## Tổng quan\nXử lý tất cả loại thanh toán: đặt cọc, thanh toán đơn hàng, hoàn cọc, hoàn dịch vụ, thu\u002Fchi phòng khám.\n\n## Loại thanh toán (payment_for)\n```\n1 = Hoàn dịch vụ (FOR_REFUND_SERVICE)\n2 = Hoàn cọc (FOR_REFUND_DEPOSIT)\n3 = Đặt cọc (FOR_DEPOSIT)\n4 = Thanh toán đơn hàng (FOR_ORDER)\n5 = Chuyển cọc (FOR_MOVE_DEPOSIT)\n6 = Hoàn ký gửi (FOR_REFUND_DEPOSIT_KG)\n7 = Thu tiền phòng khám (FOR_CLINIC_INCOME)\n8 = Chi tiền phòng khám (FOR_CLINIC_EXPENSE)\n```\n\n## payment_method (Hình thức) — bảng global cố định, id có ý nghĩa\n\n`payment_method` là bảng global (không scope chi nhánh), UNIQUE theo `name`, seed 1 lần (`migrations\u002F00000000000001_seed_data.up.sql`), luôn đúng 4 dòng: `1=Chuyển khoản, 2=Máy POS, 3=Chuyển cọc, 4=Tiền mặt`. Vì bảng cố định → được phép hardcode id như enum (khác các bảng config khác thường phải lookup theo tên).\n\n- **FOR_MOVE_DEPOSIT (chuyển cọc → thanh toán)**: `method` LUÔN set cứng server-side = `define.PaymentMethodTransferDeposit` (=3, \"Chuyển cọc\") trong `MoveDepositToPaymentFromPayment`\u002F`MoveDepositToPayment` (`payment_crud.go`) — **FE không có field chọn method trong `FormMoveDeposit`** (cố ý, không phải thiếu sót), vì bản chất đây là bút toán nội bộ (không có dòng tiền mới phát sinh), không phải user tự chọn hình thức thanh toán.\n- **Bug đã xảy ra 2026-07-27**: hằng số từng đặt tên `PaymentMethodTransfer = 1` (nhầm sang \"Chuyển khoản\" id=1) — trông giống đúng tên nhưng sai giá trị, khiến payment chuyển cọc hiện sai \"Hình thức\". Đã đổi tên `PaymentMethodTransferDeposit = 3` cho khớp nghĩa. Đừng đổi lại giá trị này nếu không verify lại `payment_method.name` trong seed.\n\n## Phiếu DÙNG cọc — cọc phải của chính khách đó (2026-09-22)\n- `validateDepositUse` (`crm\u002Fservice\u002Fpayment_crud.go`) chạy ở 4 luồng tạo: hoàn cọc, hoàn ký gửi, `MoveDepositToPayment*` (cả bản deprecated). Phiếu cọc phải `payment_for = FOR_DEPOSIT`, **cùng `customer_id`** (vế \"cùng `company_id`\" đã bỏ ở story-37, D15); chuyển cọc thì `serviceUsed_id` \u002F `parent_id` từ body cũng phải của khách chủ cọc. Sai ⇒ `errs.ErrDepositCustomerMismatch` (422 `deposit_customer_mismatch`); không phải phiếu cọc ⇒ `ErrDepositNotFound`. Trước đây nhận `deposit_id` từ body không đối chiếu gì (IDOR body-id).\n- Đường SỬA phiếu không đổi được `deposit_id` \u002F `serviceUsed_id` \u002F `customer_id` (`mergePaymentParams`) nên không cần guard ở đó — thêm field vào merge thì PHẢI gọi lại guard.\n- Test: `crm\u002Fservice\u002Fdeposit_use_integration_test.go` (có ca cọc của khách khác — xem `..\u002Ftesting-backend\u002FSKILL.md` §FreshTenant).\n- `payment.deposit_id` có index `idx_payment_deposit_id` (migration `20260922154654`) — trước đó mọi `deletePayment` + tính số dư cọc quét toàn bảng payment.\n\n## Xoá HÀNG LOẠT phiếu — gom phần tính lại (`deferredPaymentRecalc`)\n`deletePaymentWith(p, userID, deferred)`: deferred != nil ⇒ phần lõi (guard kỳ khoá\u002Fhoá đơn, dọn hoa hồng\u002Fdoanh thu\u002Fhoá đơn nháp, log, bút toán đảo, **hoa hồng CTV**) chạy ngay; phần tính lại gom và chạy 1 lần cuối (hàm tính lại đều state-based). Bảng giữ\u002Fgom\u002Fbỏ từng tác dụng: comment `deferredPaymentRecalc` (`crm\u002Fservice\u002Fpayment.go`). Chỉ dùng khi khách\u002Fđơn\u002Fdòng dịch vụ CHẮC CHẮN bị xoá cùng transaction — hiện chỉ `DeleteCustomerWithPayments`. Đo trên clone dev: 5 khách nhiều phiếu nhất 19.2s → 3.9s; so 377 bảng giữa cách cũ và cách gom: 0 khác biệt (bộ so đã đối chứng bằng 1 dòng sửa cố ý). Dev không có CTV nên nhánh hoa hồng CTV không được so — nhánh đó không đổi (vẫn chạy từng phiếu).\n\n## Loại đặt cọc (deposit_type)\n```\n1 = Đặt cọc giữ chỗ (RESERVE)\n2 = Đặt cọc tạm (TEMP)\n3 = Ký gửi (KG) — loại trừ khỏi thực thu\n```\n\n## Routes (19 endpoints) — `internal\u002Fmodules\u002Fwebapp\u002Fcrm\u002Fpayment\u002Froute.go`\n\n### Đặt cọc\n- `POST create-deposit-customer` — Tạo đặt cọc → update customer.totalDeposit\n- `PUT :id\u002Fupdate-deposit-customer` — Cập nhật\n- `DELETE :id\u002Fdelete-deposit-customer` — Xóa\n\n### Thanh toán\n- `POST create-payment-order` — Thanh toán đơn hàng\n- `POST create-payment-customer` — Thanh toán khách hàng\n- `POST \"\"` \u002F `PUT :id` — Thu\u002Fchi phòng khám (CreatePaymentClinic \u002F UpdatePaymentClinic)\n- `PUT :id\u002Fupdate-payment-customer` — Cập nhật\n- `DELETE :id\u002Fdelete-payment-customer` — Xóa\n- `GET :id` — Chi tiết payment\n- `POST :id\u002Fmove-deposit-to-payment` \u002F `PUT :id\u002Fmove-deposit-to-payment` — Chuyển cọc thành thanh toán\n\n### Hoàn trả (reverse logic)\n- `POST create-refund-deposit-customer` — Hoàn cọc\n- `POST create-refund-kg-customer` — Hoàn ký gửi\n- `POST create-refund-order-plan` — Hoàn dịch vụ\n- `DELETE :id\u002Fdelete-refund-customer` — Xóa hoàn cọc\n- `DELETE :id\u002Fdelete-refund-consignment` — Xóa hoàn ký gửi\n- `DELETE :id\u002Fdelete-refund-order-plan` — Xóa hoàn dịch vụ\n\n`GET \u002Fcrm\u002Fpayment\u002Fget-payment-detail-for-customer` KHÔNG nằm trong module — handler ở `customer_detail.go` (package crm), wire riêng trong `router\u002Fcrm.go`.\n\n## Thanh toán 1 phần cho nhiều dịch vụ — waterfall theo created_day\n- `create-payment-customer` (>1 serviceUsed_idArr): amount chỉ cần `\u003C= tổng nợ` (không còn bắt khớp chính xác)\n- Phân bổ waterfall: sort `created_day ASC` (nil = cũ nhất, id tie-break) → trả ĐỦ dịch vụ cũ trước, dư mới chảy qua dịch vụ sau — KHÔNG chia tỷ lệ\n- Pure logic: `allocatePaymentWaterfall` (`payment_crud.go`) — tách riêng để unit-test không cần DB\n- Đọc nợ (`order_service_used`) + tạo payment PHẢI cùng 1 transaction, khóa `clause.Locking{Strength:\"UPDATE\"}` — chặn double-submit tạo trùng\u002Fvượt payment. Cùng pattern `CreatePaymentOrderFromPayment`.\n- Waterfall tạo **nhiều dòng `payment`** (1 dòng\u002Fdịch vụ), mỗi dòng mã riêng vì cột `code` UNIQUE — schema KHÔNG có bảng phân bổ riêng.\n- Hiển thị\u002Fđối soát \"phân bổ của một lần thu\" → gom theo `parent_id` (cùng đơn hàng). KHÔNG gom theo `payment_time`\u002F`created_at`: hai lần thu trong cùng một giây sẽ dính vào nhau.\n\n## afterSave (rất phức tạp)\n- Update customer financials: totalPayment, totalDebt, totalDeposit, totalBonus, refundDeposit, refundService, consignment, refundConsignment\n- Update OrderTreatmentPlan: totalPayment, totalDebt\n- Update OrderServiceUsed: payment_status\n- Log changes (LogPayment)\n- Tính commission cho telesale\u002FdirectSale\u002Fdoctor\u002Ftechnical\u002Fassistant\n  - `listRevenues`, `listDoctors`, `listDirectSales`, `source_id` **KHÔNG còn trong payment entity** — đọc trực tiếp từ `order_service_used` (canonical source)\n  - Handlers commission JOIN `order_service_used` để lấy các field này\n\n**`payment_status = Done` KHÔNG bị hoàn tiền làm tụt (GOTCHA)** — `calculatorPaymentServiceUsed` tính `payment_status` từ `paymentTotal = SUM(payment_for IN Order\u002FMoveDeposit)` so với `totalEnd`. Refund (`payment_for = RefundService`) ghi riêng vào `refundServiceUsed`, **KHÔNG trừ vào `paymentTotal`**.\n- ⇒ hoàn tiền 100% vẫn để `payment_status = Done`. Side-effect nào cần nghĩa \"còn hiệu lực\" (kho, hoa hồng, loyalty, report) phải tự đối chiếu thêm `refundServiceUsed >= totalEnd`, KHÔNG được chỉ đọc `payment_status`.\n- `totalEnd = 0` → luôn ra `Start (1)`, không bao giờ `Done` (điều kiện `totalEnd.IsPositive()`).\n\n## list*\u002Fsource của payment — đọc từ `order_service_used`\n- Payment KHÔNG copy list*\u002Fsource; export JOIN `order_service_used` trực tiếp khi cần.\n- (Lịch sử: helper `setFromServiceUsed` \u002F `setFromCustomer` \u002F `setSourceFromCustomer` chỉ còn để điền `company_id` — đã xoá cùng cột, D15.)\n\n## Commission 1-to-many — list* vs commission tables\n\n→ Xem `skill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Forder.md` § \"JSON array columns — listRevenues \u002F listDoctors \u002F listDirectSales\" (phân công vs derived, write pattern idempotent theo payment_id, JSON_CONTAINS\u002FJSON_TABLE).\n\n## Commission snapshot — rate lock tại thời điểm lên đơn\n\n- `order_service_used` có 6 snapshot fields: `commission_telesale_snap`, `commission_telesale_type_snap`, `commission_direct_sale_snap`, `commission_direct_sale_type_snap`, `commission_doctor_consultant_snap`, `commission_doctor_consultant_type_snap`\n- Set 1 lần khi CREATE `order_service_used` — hàm `snapshotCommissionRates` trong `crm\u002Fservice\u002Forder_treatment_plan.go`\n- `OrderPlanType=2` (old customer) → dùng `commission_*` (rate cũ); `=1` (new) → `commission_*_new`\n- Payment handler đọc snap trước; nếu NULL (đơn cũ chưa có snapshot) → fallback JOIN service table\n- KHÔNG re-snapshot khi UPDATE order_service_used — rate bị lock từ lúc lên đơn\n- Commission type: `DiscountTypeNormal=1` = VND cố định, `DiscountTypePercent=2` = phần trăm (`pkg\u002Fdefine\u002Forder_service_used.go`)\n\n**Rule chung (CRITICAL) — áp dụng mọi rate % tính tiền từ bảng master:** nếu commission\u002Ftiền được **recalculate nhiều lần** (mỗi payment, lock\u002Funlock...), phải snapshot rate vào cột riêng NGAY LÚC gán FK — KHÔNG JOIN đọc live từ bảng master mỗi lần recalc, vì admin đổi rate sau đó sẽ làm số tiền đã chốt trước bị tính lại retroactive.\n\n```go\n\u002F\u002F ❌ SAI — recalc sau này đọc rate MỚI thay vì rate lúc phát sinh\ntx.Table(\"broker\").Select(\"commissionRate\").Where(\"id = ?\", brokerID).Scan(&rate)\n\n\u002F\u002F ✅ ĐÚNG — snapshot vào cột riêng, recalc chỉ đọc lại cột đã snapshot\ntx.Exec(`INSERT INTO broker_commission (..., commissionRateSnap) VALUES (..., ?)`, rateSnap)\n```\n\nVới upsert `INSERT ... ON DUPLICATE KEY UPDATE`, chỉ refresh snapshot khi FK thực sự đổi — dùng `IF()` so sánh ngay trong SQL:\n```sql\ncommissionRateSnap = IF(broker_id = VALUES(broker_id), commissionRateSnap, VALUES(commissionRateSnap))\n```\n\nPrecedent thứ 2: `broker_commission.commissionRateSnap` (loyalty module, affiliate path) — thiếu snapshot cho tới fix 2026-07-02, xem `loyalty\u002Fbroker.md § broker_commission lifecycle`.\n\n## Commission report endpoints — response format\n\n- Handler telesale\u002Fdirect-sale\u002Fdoctor-consultant list + summary dùng flat `c.JSON(http.StatusOK, gin.H{...})` — **KHÔNG** `response.Data`\n- FE nhận thẳng `{items, _meta, totalCommission}` — không có lớp `data` bọc ngoài\n- Nếu handler đổi sang `response.Data(c, gin.H{...})`, FE service phải thêm `.pipe(map((r: any) => r?.data ?? r))` vào method tương ứng\n\n## calculatorMoneyCustomer — logic theo payment_for\n| payment_for | Fields cập nhật | Ghi chú |\n|---|---|---|\n| FOR_ORDER (4), FOR_MOVE_DEPOSIT (5) | totalPayment, totalDebt, customerType=OLD | totalDebt = totalRevenue - totalPayment |\n| FOR_REFUND_SERVICE (1) | refundService, totalPayment | **KHÔNG** update totalDebt |\n| FOR_REFUND_DEPOSIT (2) | refundDeposit, totalDeposit | |\n| FOR_REFUND_DEPOSIT_KG (6) | consignment, refundConsignment | |\n| FOR_DEPOSIT (3) | totalDeposit hoặc consignment | tuỳ deposit_type |\n| FOR_CLINIC_INCOME (7), FOR_CLINIC_EXPENSE (8) | **Không gọi updateCustomer** | |\n\n> ⚠️ `FOR_REFUND_SERVICE` chỉ update `refundService` + `totalPayment`, **không** recalc `totalDebt` — đúng theo Yii2.\n\n## Business validation — beforeSave (CRITICAL)\n\n| Loại | Trường check | Rule | Error key |\n|---|---|---|---|\n| FOR_ORDER | `payment_time` | `payment_time >= osu.created_day` | `payment_before_order_date` |\n| FOR_MOVE_DEPOSIT | `payment_of_date` | `payment_of_date >= osu.created_day` | `payment_before_order_date` |\n\n**Tại sao FOR_ORDER dùng `payment_time`, FOR_MOVE_DEPOSIT dùng `payment_of_date`:**\n- FOR_ORDER: `payment_of_date` được sync từ `payment_time` trong `beforeSave` → dùng `payment_time` là canonical.\n- FOR_MOVE_DEPOSIT: `payment_time` lấy từ cọc gốc (có thể trước ngày tạo đơn) → `payment_of_date` mới là ngày user chọn khi chuyển cọc.\n\n**Bỏ qua validation nếu `osu.created_day IS NULL`** — đơn cũ không có trường này, không block.\n\n> Lý do: `osu.created_day` là trường **có thể chỉnh sửa** (\"ngày lên đơn nghiệp vụ\"), khác với `created_at` (timestamp hệ thống). Nếu thanh toán được phép đặt ngày trước ngày lên đơn → `osu.payment` (running total) có thể vượt `totalSum` của báo cáo kế toán lọc theo `payment_of_date` cùng kỳ → số liệu phi logic.\n\n## paymentListSelect — shared const yêu cầu JOIN\n\n- `paymentListSelect` (payment.go) SELECT `order_service_used.listRevenues`, `.listDoctors` — bất kỳ handler nào dùng const này PHẢI tự JOIN `order_service_used`.\n- `buildPaymentFilters` đã JOIN sẵn; các handler có filter riêng (`ListCustomerDepositMkt` v.v.) phải thêm JOIN độc lập:\n  ```go\n  Joins(\"LEFT JOIN order_service_used ON order_service_used.id = payment.serviceUsed_id\")\n  ```\n\n## broker_commission — thêm\u002Fđổi CTV sau khi đã có payment (GOTCHA)\n\nSau upsert broker_commission trong update path PHẢI gọi `syncBrokerCommission(tx, int(svc.ID))` — nếu không, CTV mới có `amount=0` dù đã thanh toán đủ.\n\n## Auto code generation\nPrefix TT, sinh trong `BaseModelWithCode.BeforeCreate` (`internal\u002Fmodels\u002Fbase.go`) → `codegen.GenerateErr(tx, table, branchID)` — chỉ còn tham số chi nhánh (vế company đã bỏ, D15).\n\n## In lại phiếu thanh toán (print\u002Fpayment) — date-scope theo payment_of_date (GOTCHA)\n\n- `internal\u002Fmodules\u002Fwebapp\u002Fprint\u002Fpayment\u002Fhandler\u002Fhandler.go` `PrintPayment`: `historyPayment`\u002F`totalPayment` PHẢI filter `payment.payment_of_date \u003C= payment đang in` (tie-break bằng `id` khi trùng ngày), KHÔNG chỉ theo `parent_id`+`serviceUsed_id` — thiếu filter ngày sẽ gộp cả thanh toán phát sinh SAU thời điểm phiếu in, hiển thị sai \"đã thanh toán hết\".\n- Áp dụng chung: mọi endpoint in lại chứng từ lịch sử (reprint) tính cumulative\u002Frunning-total phải snapshot đến thời điểm bản ghi đang in, không query theo trạng thái hiện tại.\n",{"name":5,"description":7},"main","ea9f5ed9bd4eaf32e9489bcbe9603955c1462a63","skill\u002Fskills\u002Fworking-on-crm",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-crm",{"tool":39,"command":40},"bunx","bunx skills add cluvix\u002Fcluvix-crm --skill working-on-crm",{"tool":42,"command":43},"pnpm","pnpm dlx skills add cluvix\u002Fcluvix-crm --skill working-on-crm","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002FSKILL.md",true,[47,53,57,61,65],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"reference\u002Fappointment-list-performance.md","REFERENCE","参考文档",2748,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fappointment-list-performance.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"reference\u002Fcheck-up-psychiatry.md",11161,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fcheck-up-psychiatry.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"reference\u002Fcustomer.md",23226,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Fcustomer.md",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"reference\u002Forder.md",16081,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Forder.md",{"path":66,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":67,"sourceHtmlUrl":68},"reference\u002Ftreatment.md",12528,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fworking-on-crm\u002Freference\u002Ftreatment.md",[70,77,84,91,98,105],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"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":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"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":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"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":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"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":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"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",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"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",[],[]]