[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F475VEPATD0D8KP8V2HHYV":3,"skill-same:01M7F475VEPATD0D8KP8V2HHYV":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7F475VEPATD0D8KP8V2HHYV","writing-backend-resources",null,"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 đó.","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\u002Fwriting-backend-resources\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: writing-backend-resources\ndescription: >-\n  Hướng dẫn quy trình 6 bước TẠO MỚI resource backend Go (entity, dao, repository, service,\n  handler, router, DTO, module layout) cho ERP Cluvix. Dùng skill này TRƯỚC KHI tạo resource\n  CRUD mới hoặc module mới trong internal\u002Fmodules\u002F, khi cần biết Handler DI\u002FRouter\u002FRepository\n  Reader\u002FDTO pattern chuẩn, hoặc trước khi đụng module service (status filter 2 tầng, cascade,\n  optimistic lock). KHÔNG dùng skill này để debug\u002Fsửa query đang sai — xem\n  debugging-backend-queries cho việc đó.\n---\n\n# Tạo resource backend mới (Go)\n\n> Kiến trúc DI\u002FHandler\u002FRouter\u002FDTO chi tiết: `reference\u002Fpatterns-arch.md`\n> Pattern module Service (status filter 2 tầng, cascade, optimistic lock, service_material): `reference\u002Fservice.md`\n\n\n> **Layout chuẩn (Plan 03 \u002F Plan 08 + restructure 4 nhóm 2026-07-28):**\n> - Resource web-app mới ở `internal\u002Fmodules\u002Fwebapp\u002F\u003Cdomain>\u002F\u003Cresource>\u002F` (client\u002Fmobile\u002Fpublic có nhóm riêng — xem Hard Rules)\n> - Entity trong `dao\u002Fentity.go`\n> - KHÔNG tạo file mới trong `internal\u002Fmodels\u002F` (chỉ `base.go` ở đó)\n> - `internal\u002Fhandlers\u002F` và `internal\u002Fservices\u002F` đã XOÁ (Plan 07)\n\n---\n\n## Bước 1 — Migration\n\n```bash\n# Tạo file BẰNG TAY — KHÔNG dùng `-cmd=create` (nó sinh kèm `.down.sql`, trái rule)\ncd backend && ls migrations | sort | tail -3   # timestamp mới phải lớn hơn file mới nhất\ntouch migrations\u002F$(date +%Y%m%d%H%M%S)_create_{table_name}.up.sql\n```\n\nViết `.up.sql`:\n- `CREATE TABLE` với đầy đủ columns, index, comment tiếng Việt\n- `created_at`, `updated_at`: `BIGINT` (Unix), KHÔNG `DATETIME`\n- `BaseModel` embed: cần `id`, `status`, `created_by`, `updated_by`, `created_at`, `updated_at` (KHÔNG còn `company_id` — D15\u002Fstory-62; `branch_id` khai riêng trong entity nếu bảng có chi nhánh)\n- `SimpleModel` embed: cần `id`, `status`, `created_at`, `updated_at`\n- `status TINYINT(1) DEFAULT 1` nếu cần show\u002Fhide\n- `sort_order INT DEFAULT 0` nếu cần sắp xếp\n- **KHÔNG tạo `.down.sql`** (chi tiết: `skills\u002Fwriting-mysql-migrations\u002FSKILL.md`)\n\n```bash\ncd backend && go run cmd\u002Fmigrate\u002Fmain.go -cmd=up\n```\n\n---\n\n## Bước 2 — Entity (dao\u002Fentity.go)\n\nTemplate đầy đủ entity.go + dao.go → Xem `skill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fpatterns-arch.md` §Dao\u002F Pattern.\n\n- Chỉ GORM struct + TableName() — không có method, không business logic\n- Embed `models.BaseModel` (tenant table) hoặc `models.SimpleModel` (shared table)\n- camelCase DB column → `gorm:\"column:xxx\"`\n- JSON column → `datatypes.JSON`, KHÔNG `string`\n- Nullable fields → pointer `*Type`\n- KHÔNG tạo entity ở `internal\u002Fmodels\u002F{module}\u002F`\n\n---\n\n## Bước 3 — Dao (dao\u002Fdao.go)\n\n`IDao` + `Dao` + `BaseRepo` + `var _ IDao = (*Dao)(nil)` — code → Xem `skill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fpatterns-arch.md` §Dao\u002F Pattern.\n\nBỏ qua khi: `_shared\u002Fdao` (types\u002Fconstants chung) hoặc readonly view.\n\n---\n\n## Bước 4 — Service (service\u002Fservice.go) — chỉ khi có business logic\n\nTạo khi có: validate business, side effects, optimistic locking.\n\n```go\npackage service\n\nimport (\n    dao \"{domain}\u002F{resource}\u002Fdao\"\n    \"gorm.io\u002Fgorm\"\n)\n\ntype Service struct {\n    db  *gorm.DB\n    dao dao.IDao\n}\n\nfunc New(db *gorm.DB) *Service {\n    return &Service{db: db, dao: dao.New(db)}\n}\n```\n\nBỏ qua nếu CRUD đơn giản không có side effect.\n\n---\n\n## Bước 5 — Handler (handler\u002Fhandler.go)\n\n```go\npackage handler\n\nimport (\n    \"gorm.io\u002Fgorm\"\n    dao \"{resource_import_path}\u002Fdao\"\n    \"erpCluvix\u002Fpkg\u002Fhelpers\"\n    \"erpCluvix\u002Fpkg\u002Fpagination\"\n    \"erpCluvix\u002Fpkg\u002Fresponse\"\n    \"erpCluvix\u002Fpkg\u002Ftenant\"\n    \"github.com\u002Fgin-gonic\u002Fgin\"\n    \"net\u002Fhttp\"\n    \"strings\"\n)\n\ntype Deps struct {\n    DB *gorm.DB\n}\n\ntype Handler struct {\n    Deps\n}\n\nfunc New(d Deps) *Handler { return &Handler{Deps: d} }\n\nfunc (h *Handler) List{Resource}(c *gin.Context) {\n    query := tenant.ScopedDBNullBranch(c, h.DB, \"{table_name}\").Model(&dao.{Resource}{})\n    if keyword := c.Query(\"_keyword\"); keyword != \"\" {\n        like := \"%\" + strings.TrimSpace(keyword) + \"%\"\n        query = query.Where(\"{searchable_column} LIKE ?\", like)\n        \u002F\u002F {searchable_column} PHẢI khớp cột thật trên entity — 2 lần lỗi 1054 production\n        \u002F\u002F (warranty_code, supplier_service) vì copy nguyên \"name\" không có trên bảng\n    }\n    query = query.Order(\"sort_order DESC\")\n    var items []dao.{Resource}\n    result := pagination.Paginate(c, query, &items)\n    c.JSON(http.StatusOK, result)\n}\n\nfunc (h *Handler) Get{Resource}(c *gin.Context) { ... response.Data(c, item) }\nfunc (h *Handler) Create{Resource}(c *gin.Context) { ... response.Created(c, item) }\nfunc (h *Handler) Update{Resource}(c *gin.Context) { ... response.Updated(c, item) }\nfunc (h *Handler) Delete{Resource}(c *gin.Context) { ... response.Deleted(c) }\n```\n\n- Tenant table → `tenant.ScopedDBNullBranch(c, h.DB, \"{table_name}\")`\n- Bảng dùng chung không có `branch_id` (danh mục toàn thương hiệu) → `ScopedDBNullBranch` vẫn an toàn (bảng không đăng ký `branchTables` ⇒ không thêm điều kiện); GET\u002FUPDATE\u002FDELETE theo id vẫn đi qua nó theo Hard Rules\n- Sau CUD config: `dexie.BumpDexieTable(h.DB, \"\u003Cdexie_table_key>\")`\n- Update: typed DTO với pointer fields (nil = omit)\n- KHÔNG import `db.DB` global\n\n---\n\n## Bước 6 — Route (route.go)\n\n```go\npackage {resource}\n\nimport (\n    \"erpCluvix\u002Finternal\u002Fmodules\u002Fwebapp\u002F{domain}\u002F{resource}\u002Fhandler\"\n    \"github.com\u002Fgin-gonic\u002Fgin\"\n)\n\nfunc RegisterRoutes(authed gin.IRouter, db *gorm.DB) {\n    h := handler.New(handler.Deps{DB: db})\n    g := authed.Group(\"\u002F{resource-path}\")\n    g.GET(\"\", h.List{Resource})\n    g.GET(\"\u002F:id\", h.Get{Resource})\n    g.POST(\"\", h.Create{Resource})\n    g.PUT(\"\u002F:id\", h.Update{Resource})\n    g.DELETE(\"\u002F:id\", h.Delete{Resource})\n}\n```\n\nĐăng ký trong `internal\u002Frouter\u002F` hoặc domain `router.go`.\n\n**Màn chỉ-đọc cần hình dạng response khác → thêm `GET \u002F:id\u002Fdetail` RIÊNG:**\n- KHÔNG đổi `GET \u002F:id` đang phục vụ form sửa — đổi hình dạng ở đó là đụng luồng ghi và mọi màn khác đang tiêu thụ.\n- Endpoint mới viết `Select` tường minh theo đúng field màn cần; đối chiếu schema **sau migration**, không chép cột từ baseline.\n- Đăng ký sau `GET \u002F:id` trong cùng group; thêm vào `route_perm_map.json` bằng edit additive.\n\n---\n\n## Layout tổng thể\n\n```\ninternal\u002Fmodules\u002Fwebapp\u002F{domain}\u002F{resource}\u002F\n├── route.go\n├── handler\u002F\n│   ├── handler.go        # Deps + Handler + New\n│   ├── find.go           # List + Get\n│   ├── upsert.go         # Create + Update\n│   ├── delete.go         # Delete\n│   └── dto.go            # DTO structs (optional)\n├── service\u002F\n│   └── service.go        # Business logic (bỏ qua nếu CRUD thuần)\n└── dao\u002F\n    ├── entity.go          # GORM struct + TableName\n    └── dao.go             # IDao + Dao + BaseRepo\n```\n\nPilot: `internal\u002Fmodules\u002Fwebapp\u002Fcrm\u002Forder_plan\u002F`\n\n---\n\n## Checklist sau khi tạo xong\n\n- [ ] Migration đã chạy thành công\n- [ ] Entity ở `dao\u002Fentity.go`, không phải `internal\u002Fmodels\u002F`\n- [ ] `dao\u002Fdao.go` có IDao + Dao + `var _ IDao = (*Dao)(nil)`\n- [ ] Handler dùng Deps struct + `h.DB`\n- [ ] List + single-record đều qua `tenant.ScopedDBNullBranch`\n- [ ] Bảng có `branch_id` (là quyền sở hữu của dòng) → đã đăng ký `branchTables` trong `pkg\u002Ftenant\u002Fscope.go` (`tenantTables`\u002Fcompany đã xoá, story-41); verify `grep '\"\u003Ctable>\"' pkg\u002Ftenant\u002Fscope.go` ra 1 hit (thiếu = `ScopedDBNullBranch` no-op câm lặng → IDOR; xem `skill\u002Fskills\u002Fbackend-hard-rules\u002Freference\u002Fsecurity-patterns.md`)\n- [ ] Sau CUD: `dexie.BumpDexieTable` nếu là config table\n- [ ] Route đã đăng ký đủ endpoints\n- [ ] `go build .\u002F...` clean\n- [ ] Không có magic string\u002Fnumber — constants trong `pkg\u002Fdefine\u002F`\n\n---\n\n## FE form patterns (CRITICAL)\n\n### Validators cho FK fields\n\n`Validators.required` của Angular chấp nhận `0` là valid. FK = 0 → BE vỡ FK constraint.\n\n```ts\n\u002F\u002F ❌ NEVER cho FK \u002F select id\nemr_department_id: [model.emr_department_id, Validators.required]\n\n\u002F\u002F ✅ ALWAYS dùng [required, min(1)]\nemr_department_id: [model.emr_department_id, [Validators.required, Validators.min(1)]]\ndepartment_type:   [model.department_type,   [Validators.required, Validators.min(1)]]\n```\n\n### Visual invalid indicator\n\n```html\n\u003Capp-foo-autocomplete-form-control\n  [class.ng-invalid]=\"isFieldInvalid('foo_id')\"\n  class=\"ng-dirty\"\n  formControlName=\"foo_id\"\n\u002F>\n\u003Clabel for=\"foo_id\">Tên field \u003Cspan class=\"text-red-500\">*\u003C\u002Fspan>\u003C\u002Flabel>\n```\n\n`isFieldInvalid` ở `BaseForm`:\n```ts\nreturn !!c && c.invalid && (c.dirty || c.touched || this.submitted());\n```\n\n### BE defense-in-depth — KHÔNG phụ thuộc FE validate\n\n```go\n\u002F\u002F Sentinel error = i18n key, KHÔNG hardcode string tiếng Việt\nvar errEmrDepartmentRequired = errors.New(\"emr_department_required\") \u002F\u002F key có trong pkg\u002Fi18n\u002F*\nfunc resolveDepartmentTypeForUpdates(tx *gorm.DB, updates map[string]interface{}) error {\n    edid, ok := updates[\"emr_department_id\"]\n    if !ok || edid == nil { return errEmrDepartmentRequired }\n    if helpers.ToInt64(edid) \u003C= 0 { return errEmrDepartmentRequired }\n    \u002F\u002F ...auto-derive department_type\n}\n\nif err := resolveDepartmentTypeForUpdates(tx, updates); err != nil {\n    if errors.Is(err, errEmrDepartmentRequired) {\n        response.HandleError(c, err)  \u002F\u002F sentinel → i18n.TryT → 422\n    } else {\n        response.ServerError(c, err)  \u002F\u002F 500\n    }\n    return\n}\n```\n\nReference: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fservice\u002Fhandler\u002Fhandler.go` (`errEmrDepartmentRequired`).\n\n### Data trong IndexedDB — KHÔNG attach từ BE\n\n- BE trả raw FK id (`service_id`, `branch_id`)\n- FE lookup qua helper: `servicesHelper.getServiceInfo(id)` \u002F `branchHelper.getBranchInfo(id)`\n- Nếu resource KHÔNG có IndexedDB cache → mới attach qua `attachRelation` ở handler\n","# Tạo resource backend mới (Go)\n\n> Kiến trúc DI\u002FHandler\u002FRouter\u002FDTO chi tiết: `reference\u002Fpatterns-arch.md`\n> Pattern module Service (status filter 2 tầng, cascade, optimistic lock, service_material): `reference\u002Fservice.md`\n\n\n> **Layout chuẩn (Plan 03 \u002F Plan 08 + restructure 4 nhóm 2026-07-28):**\n> - Resource web-app mới ở `internal\u002Fmodules\u002Fwebapp\u002F\u003Cdomain>\u002F\u003Cresource>\u002F` (client\u002Fmobile\u002Fpublic có nhóm riêng — xem Hard Rules)\n> - Entity trong `dao\u002Fentity.go`\n> - KHÔNG tạo file mới trong `internal\u002Fmodels\u002F` (chỉ `base.go` ở đó)\n> - `internal\u002Fhandlers\u002F` và `internal\u002Fservices\u002F` đã XOÁ (Plan 07)\n\n---\n\n## Bước 1 — Migration\n\n```bash\n# Tạo file BẰNG TAY — KHÔNG dùng `-cmd=create` (nó sinh kèm `.down.sql`, trái rule)\ncd backend && ls migrations | sort | tail -3   # timestamp mới phải lớn hơn file mới nhất\ntouch migrations\u002F$(date +%Y%m%d%H%M%S)_create_{table_name}.up.sql\n```\n\nViết `.up.sql`:\n- `CREATE TABLE` với đầy đủ columns, index, comment tiếng Việt\n- `created_at`, `updated_at`: `BIGINT` (Unix), KHÔNG `DATETIME`\n- `BaseModel` embed: cần `id`, `status`, `created_by`, `updated_by`, `created_at`, `updated_at` (KHÔNG còn `company_id` — D15\u002Fstory-62; `branch_id` khai riêng trong entity nếu bảng có chi nhánh)\n- `SimpleModel` embed: cần `id`, `status`, `created_at`, `updated_at`\n- `status TINYINT(1) DEFAULT 1` nếu cần show\u002Fhide\n- `sort_order INT DEFAULT 0` nếu cần sắp xếp\n- **KHÔNG tạo `.down.sql`** (chi tiết: `skills\u002Fwriting-mysql-migrations\u002FSKILL.md`)\n\n```bash\ncd backend && go run cmd\u002Fmigrate\u002Fmain.go -cmd=up\n```\n\n---\n\n## Bước 2 — Entity (dao\u002Fentity.go)\n\nTemplate đầy đủ entity.go + dao.go → Xem `skill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fpatterns-arch.md` §Dao\u002F Pattern.\n\n- Chỉ GORM struct + TableName() — không có method, không business logic\n- Embed `models.BaseModel` (tenant table) hoặc `models.SimpleModel` (shared table)\n- camelCase DB column → `gorm:\"column:xxx\"`\n- JSON column → `datatypes.JSON`, KHÔNG `string`\n- Nullable fields → pointer `*Type`\n- KHÔNG tạo entity ở `internal\u002Fmodels\u002F{module}\u002F`\n\n---\n\n## Bước 3 — Dao (dao\u002Fdao.go)\n\n`IDao` + `Dao` + `BaseRepo` + `var _ IDao = (*Dao)(nil)` — code → Xem `skill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fpatterns-arch.md` §Dao\u002F Pattern.\n\nBỏ qua khi: `_shared\u002Fdao` (types\u002Fconstants chung) hoặc readonly view.\n\n---\n\n## Bước 4 — Service (service\u002Fservice.go) — chỉ khi có business logic\n\nTạo khi có: validate business, side effects, optimistic locking.\n\n```go\npackage service\n\nimport (\n    dao \"{domain}\u002F{resource}\u002Fdao\"\n    \"gorm.io\u002Fgorm\"\n)\n\ntype Service struct {\n    db  *gorm.DB\n    dao dao.IDao\n}\n\nfunc New(db *gorm.DB) *Service {\n    return &Service{db: db, dao: dao.New(db)}\n}\n```\n\nBỏ qua nếu CRUD đơn giản không có side effect.\n\n---\n\n## Bước 5 — Handler (handler\u002Fhandler.go)\n\n```go\npackage handler\n\nimport (\n    \"gorm.io\u002Fgorm\"\n    dao \"{resource_import_path}\u002Fdao\"\n    \"erpCluvix\u002Fpkg\u002Fhelpers\"\n    \"erpCluvix\u002Fpkg\u002Fpagination\"\n    \"erpCluvix\u002Fpkg\u002Fresponse\"\n    \"erpCluvix\u002Fpkg\u002Ftenant\"\n    \"github.com\u002Fgin-gonic\u002Fgin\"\n    \"net\u002Fhttp\"\n    \"strings\"\n)\n\ntype Deps struct {\n    DB *gorm.DB\n}\n\ntype Handler struct {\n    Deps\n}\n\nfunc New(d Deps) *Handler { return &Handler{Deps: d} }\n\nfunc (h *Handler) List{Resource}(c *gin.Context) {\n    query := tenant.ScopedDBNullBranch(c, h.DB, \"{table_name}\").Model(&dao.{Resource}{})\n    if keyword := c.Query(\"_keyword\"); keyword != \"\" {\n        like := \"%\" + strings.TrimSpace(keyword) + \"%\"\n        query = query.Where(\"{searchable_column} LIKE ?\", like)\n        \u002F\u002F {searchable_column} PHẢI khớp cột thật trên entity — 2 lần lỗi 1054 production\n        \u002F\u002F (warranty_code, supplier_service) vì copy nguyên \"name\" không có trên bảng\n    }\n    query = query.Order(\"sort_order DESC\")\n    var items []dao.{Resource}\n    result := pagination.Paginate(c, query, &items)\n    c.JSON(http.StatusOK, result)\n}\n\nfunc (h *Handler) Get{Resource}(c *gin.Context) { ... response.Data(c, item) }\nfunc (h *Handler) Create{Resource}(c *gin.Context) { ... response.Created(c, item) }\nfunc (h *Handler) Update{Resource}(c *gin.Context) { ... response.Updated(c, item) }\nfunc (h *Handler) Delete{Resource}(c *gin.Context) { ... response.Deleted(c) }\n```\n\n- Tenant table → `tenant.ScopedDBNullBranch(c, h.DB, \"{table_name}\")`\n- Bảng dùng chung không có `branch_id` (danh mục toàn thương hiệu) → `ScopedDBNullBranch` vẫn an toàn (bảng không đăng ký `branchTables` ⇒ không thêm điều kiện); GET\u002FUPDATE\u002FDELETE theo id vẫn đi qua nó theo Hard Rules\n- Sau CUD config: `dexie.BumpDexieTable(h.DB, \"\u003Cdexie_table_key>\")`\n- Update: typed DTO với pointer fields (nil = omit)\n- KHÔNG import `db.DB` global\n\n---\n\n## Bước 6 — Route (route.go)\n\n```go\npackage {resource}\n\nimport (\n    \"erpCluvix\u002Finternal\u002Fmodules\u002Fwebapp\u002F{domain}\u002F{resource}\u002Fhandler\"\n    \"github.com\u002Fgin-gonic\u002Fgin\"\n)\n\nfunc RegisterRoutes(authed gin.IRouter, db *gorm.DB) {\n    h := handler.New(handler.Deps{DB: db})\n    g := authed.Group(\"\u002F{resource-path}\")\n    g.GET(\"\", h.List{Resource})\n    g.GET(\"\u002F:id\", h.Get{Resource})\n    g.POST(\"\", h.Create{Resource})\n    g.PUT(\"\u002F:id\", h.Update{Resource})\n    g.DELETE(\"\u002F:id\", h.Delete{Resource})\n}\n```\n\nĐăng ký trong `internal\u002Frouter\u002F` hoặc domain `router.go`.\n\n**Màn chỉ-đọc cần hình dạng response khác → thêm `GET \u002F:id\u002Fdetail` RIÊNG:**\n- KHÔNG đổi `GET \u002F:id` đang phục vụ form sửa — đổi hình dạng ở đó là đụng luồng ghi và mọi màn khác đang tiêu thụ.\n- Endpoint mới viết `Select` tường minh theo đúng field màn cần; đối chiếu schema **sau migration**, không chép cột từ baseline.\n- Đăng ký sau `GET \u002F:id` trong cùng group; thêm vào `route_perm_map.json` bằng edit additive.\n\n---\n\n## Layout tổng thể\n\n```\ninternal\u002Fmodules\u002Fwebapp\u002F{domain}\u002F{resource}\u002F\n├── route.go\n├── handler\u002F\n│   ├── handler.go        # Deps + Handler + New\n│   ├── find.go           # List + Get\n│   ├── upsert.go         # Create + Update\n│   ├── delete.go         # Delete\n│   └── dto.go            # DTO structs (optional)\n├── service\u002F\n│   └── service.go        # Business logic (bỏ qua nếu CRUD thuần)\n└── dao\u002F\n    ├── entity.go          # GORM struct + TableName\n    └── dao.go             # IDao + Dao + BaseRepo\n```\n\nPilot: `internal\u002Fmodules\u002Fwebapp\u002Fcrm\u002Forder_plan\u002F`\n\n---\n\n## Checklist sau khi tạo xong\n\n- [ ] Migration đã chạy thành công\n- [ ] Entity ở `dao\u002Fentity.go`, không phải `internal\u002Fmodels\u002F`\n- [ ] `dao\u002Fdao.go` có IDao + Dao + `var _ IDao = (*Dao)(nil)`\n- [ ] Handler dùng Deps struct + `h.DB`\n- [ ] List + single-record đều qua `tenant.ScopedDBNullBranch`\n- [ ] Bảng có `branch_id` (là quyền sở hữu của dòng) → đã đăng ký `branchTables` trong `pkg\u002Ftenant\u002Fscope.go` (`tenantTables`\u002Fcompany đã xoá, story-41); verify `grep '\"\u003Ctable>\"' pkg\u002Ftenant\u002Fscope.go` ra 1 hit (thiếu = `ScopedDBNullBranch` no-op câm lặng → IDOR; xem `skill\u002Fskills\u002Fbackend-hard-rules\u002Freference\u002Fsecurity-patterns.md`)\n- [ ] Sau CUD: `dexie.BumpDexieTable` nếu là config table\n- [ ] Route đã đăng ký đủ endpoints\n- [ ] `go build .\u002F...` clean\n- [ ] Không có magic string\u002Fnumber — constants trong `pkg\u002Fdefine\u002F`\n\n---\n\n## FE form patterns (CRITICAL)\n\n### Validators cho FK fields\n\n`Validators.required` của Angular chấp nhận `0` là valid. FK = 0 → BE vỡ FK constraint.\n\n```ts\n\u002F\u002F ❌ NEVER cho FK \u002F select id\nemr_department_id: [model.emr_department_id, Validators.required]\n\n\u002F\u002F ✅ ALWAYS dùng [required, min(1)]\nemr_department_id: [model.emr_department_id, [Validators.required, Validators.min(1)]]\ndepartment_type:   [model.department_type,   [Validators.required, Validators.min(1)]]\n```\n\n### Visual invalid indicator\n\n```html\n\u003Capp-foo-autocomplete-form-control\n  [class.ng-invalid]=\"isFieldInvalid('foo_id')\"\n  class=\"ng-dirty\"\n  formControlName=\"foo_id\"\n\u002F>\n\u003Clabel for=\"foo_id\">Tên field \u003Cspan class=\"text-red-500\">*\u003C\u002Fspan>\u003C\u002Flabel>\n```\n\n`isFieldInvalid` ở `BaseForm`:\n```ts\nreturn !!c && c.invalid && (c.dirty || c.touched || this.submitted());\n```\n\n### BE defense-in-depth — KHÔNG phụ thuộc FE validate\n\n```go\n\u002F\u002F Sentinel error = i18n key, KHÔNG hardcode string tiếng Việt\nvar errEmrDepartmentRequired = errors.New(\"emr_department_required\") \u002F\u002F key có trong pkg\u002Fi18n\u002F*\nfunc resolveDepartmentTypeForUpdates(tx *gorm.DB, updates map[string]interface{}) error {\n    edid, ok := updates[\"emr_department_id\"]\n    if !ok || edid == nil { return errEmrDepartmentRequired }\n    if helpers.ToInt64(edid) \u003C= 0 { return errEmrDepartmentRequired }\n    \u002F\u002F ...auto-derive department_type\n}\n\nif err := resolveDepartmentTypeForUpdates(tx, updates); err != nil {\n    if errors.Is(err, errEmrDepartmentRequired) {\n        response.HandleError(c, err)  \u002F\u002F sentinel → i18n.TryT → 422\n    } else {\n        response.ServerError(c, err)  \u002F\u002F 500\n    }\n    return\n}\n```\n\nReference: `internal\u002Fmodules\u002Fwebapp\u002Fconfig\u002Fservice\u002Fhandler\u002Fhandler.go` (`errEmrDepartmentRequired`).\n\n### Data trong IndexedDB — KHÔNG attach từ BE\n\n- BE trả raw FK id (`service_id`, `branch_id`)\n- FE lookup qua helper: `servicesHelper.getServiceInfo(id)` \u002F `branchHelper.getBranchInfo(id)`\n- Nếu resource KHÔNG có IndexedDB cache → mới attach qua `attachRelation` ở handler\n",{"name":5,"description":7},"main","ea9f5ed9bd4eaf32e9489bcbe9603955c1462a63","skill\u002Fskills\u002Fwriting-backend-resources",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 writing-backend-resources",{"tool":39,"command":40},"bunx","bunx skills add cluvix\u002Fcluvix-crm --skill writing-backend-resources",{"tool":42,"command":43},"pnpm","pnpm dlx skills add cluvix\u002Fcluvix-crm --skill writing-backend-resources","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-backend-resources\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"reference\u002Fpatterns-arch.md","REFERENCE","参考文档",6077,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fpatterns-arch.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"reference\u002Fservice.md",14740,"https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-backend-resources\u002Freference\u002Fservice.md",[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7F47FCP2MP548SWCP0BJ6B1","writing-mysql-migrations","Viết migration MySQL cho Cluvix (golang-migrate, Go + GORM): quy ước timestamp, idempotent ADD\u002FDROP COLUMN, FK constraint thật, decimal tiền, MySQL 9.7 LTS syntax mới\u002Fcũ, và luật CẤM tuyệt đối test\u002Fmigrate chạm DB dev\u002Fprod thật. Dùng skill này TRƯỚC KHI tạo file migration mới, sửa schema, thêm cột\u002FFK, backfill dữ liệu, hoặc trước khi chạy `cmd\u002Fmigrate`\u002Fintegration test đụng tới database — kể cả migration chỉ 1-2 dòng.","https:\u002F\u002Fgithub.com\u002Fcluvix\u002Fcluvix-crm\u002Fblob\u002Fmain\u002Fskill\u002Fskills\u002Fwriting-mysql-migrations\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"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":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"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":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"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":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"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":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"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",[],[]]