@sdcorejs/angular 20.3.2 → 20.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (267) hide show
  1. package/assets/THEME.md +58 -6
  2. package/assets/scss/core/form.scss +291 -3
  3. package/assets/scss/themes/_component-tokens.scss +35 -6
  4. package/components/badge/index.d.ts +19 -1
  5. package/components/query-bar/index.d.ts +126 -11
  6. package/components/section/index.d.ts +13 -1
  7. package/components/splitter/index.d.ts +1 -1
  8. package/components/tab-router/index.d.ts +47 -5
  9. package/components/table/index.d.ts +300 -25
  10. package/components/upload-file/index.d.ts +181 -21
  11. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  12. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  13. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
  14. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  15. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +460 -42
  16. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  17. package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
  18. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  19. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  20. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  21. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  22. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +393 -78
  23. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  24. package/fesm2022/sdcorejs-angular-components-table.mjs +1669 -126
  25. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  26. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +887 -174
  27. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  28. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
  29. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  30. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
  31. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  32. package/fesm2022/sdcorejs-angular-forms-chip.mjs +422 -122
  33. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  34. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
  35. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  36. package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
  37. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  38. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
  39. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  40. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +17 -2
  41. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  42. package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
  43. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  44. package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
  45. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  46. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
  47. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  48. package/fesm2022/sdcorejs-angular-i18n.mjs +350 -5
  49. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  50. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-D_1BxDC9.mjs} +3 -3
  51. package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-DnbDCdcz.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-D_1BxDC9.mjs.map} +1 -1
  52. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-CgH8Qi25.mjs} +3 -3
  53. package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-EBHM4kx2.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-CgH8Qi25.mjs.map} +1 -1
  54. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs → sdcorejs-angular-modules-generic-generic-list.page-CyCGqW9W.mjs} +3 -3
  55. package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-BtHe8YIW.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-CyCGqW9W.mjs.map} +1 -1
  56. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DTmU8Te4.mjs} +4 -4
  57. package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-eFshU7ew.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DTmU8Te4.mjs.map} +1 -1
  58. package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
  59. package/fesm2022/sdcorejs-angular-modules-layout.mjs +348 -11
  60. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  61. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
  62. package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
  63. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
  64. package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
  65. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-okZVmcd5.mjs +51 -0
  66. package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-okZVmcd5.mjs.map +1 -0
  67. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CB4F9cBe.mjs +144 -0
  68. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CB4F9cBe.mjs.map +1 -0
  69. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CowdEzyv.mjs +145 -0
  70. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CowdEzyv.mjs.map +1 -0
  71. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-2-dyjvCH.mjs +113 -0
  72. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-2-dyjvCH.mjs.map +1 -0
  73. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BCoG3bVV.mjs +142 -0
  74. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-BCoG3bVV.mjs.map +1 -0
  75. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-LPUj7MqG.mjs +460 -0
  76. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-LPUj7MqG.mjs.map +1 -0
  77. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
  78. package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
  79. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-Caua6Xto.mjs +66 -0
  80. package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-Caua6Xto.mjs.map +1 -0
  81. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bu6E63bN.mjs +148 -0
  82. package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-Bu6E63bN.mjs.map +1 -0
  83. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B2Y0PbbC.mjs +484 -0
  84. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-B2Y0PbbC.mjs.map +1 -0
  85. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-_c_4slgf.mjs +172 -0
  86. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-_c_4slgf.mjs.map +1 -0
  87. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-awjgX7ph.mjs +90 -0
  88. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-awjgX7ph.mjs.map +1 -0
  89. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-C_HziBQN.mjs +514 -0
  90. package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-C_HziBQN.mjs.map +1 -0
  91. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-FwmYVkag.mjs +61 -0
  92. package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-FwmYVkag.mjs.map +1 -0
  93. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BRsdOwWy.mjs +87 -0
  94. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BRsdOwWy.mjs.map +1 -0
  95. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BttbZ_yr.mjs +170 -0
  96. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BttbZ_yr.mjs.map +1 -0
  97. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DalxHa8D.mjs +232 -0
  98. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DalxHa8D.mjs.map +1 -0
  99. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-kdEZ9s7K.mjs +70 -0
  100. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-kdEZ9s7K.mjs.map +1 -0
  101. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-B2dNqckm.mjs +100 -0
  102. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-B2dNqckm.mjs.map +1 -0
  103. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-Dq8Q8Vfm.mjs +812 -0
  104. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-Dq8Q8Vfm.mjs.map +1 -0
  105. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-B3-th1z4.mjs +164 -0
  106. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-B3-th1z4.mjs.map +1 -0
  107. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Bs9hhMr7.mjs +115 -0
  108. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-Bs9hhMr7.mjs.map +1 -0
  109. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CRttQEXa.mjs +118 -0
  110. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CRttQEXa.mjs.map +1 -0
  111. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CeX57FPi.mjs +629 -0
  112. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CeX57FPi.mjs.map +1 -0
  113. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DS8A17mM.mjs +71 -0
  114. package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DS8A17mM.mjs.map +1 -0
  115. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-Dfil91qL.mjs +1069 -0
  116. package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-Dfil91qL.mjs.map +1 -0
  117. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs +193 -0
  118. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
  119. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs +99 -0
  120. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
  121. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
  122. package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
  123. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-PaIGZ1ve.mjs +48 -0
  124. package/fesm2022/sdcorejs-angular-modules-pattern-product.service-PaIGZ1ve.mjs.map +1 -0
  125. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-B8j8cieu.mjs +297 -0
  126. package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-B8j8cieu.mjs.map +1 -0
  127. package/fesm2022/sdcorejs-angular-modules-pattern-routes-0Vh73aXL.mjs +45 -0
  128. package/fesm2022/sdcorejs-angular-modules-pattern-routes-0Vh73aXL.mjs.map +1 -0
  129. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BoB2usST.mjs +43 -0
  130. package/fesm2022/sdcorejs-angular-modules-pattern-routes-BoB2usST.mjs.map +1 -0
  131. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CFLETqYK.mjs +66 -0
  132. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CFLETqYK.mjs.map +1 -0
  133. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CFT9DyKj.mjs +165 -0
  134. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CFT9DyKj.mjs.map +1 -0
  135. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CZusLcS3.mjs +74 -0
  136. package/fesm2022/sdcorejs-angular-modules-pattern-routes-CZusLcS3.mjs.map +1 -0
  137. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Cq4BqjE9.mjs +99 -0
  138. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Cq4BqjE9.mjs.map +1 -0
  139. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Cw9uJySU.mjs +50 -0
  140. package/fesm2022/sdcorejs-angular-modules-pattern-routes-Cw9uJySU.mjs.map +1 -0
  141. package/fesm2022/sdcorejs-angular-modules-pattern-routes-nrxSHE-O.mjs +74 -0
  142. package/fesm2022/sdcorejs-angular-modules-pattern-routes-nrxSHE-O.mjs.map +1 -0
  143. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-CJ6hUHjk.mjs +406 -0
  144. package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-CJ6hUHjk.mjs.map +1 -0
  145. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-C_AFK_9X.mjs +317 -0
  146. package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-C_AFK_9X.mjs.map +1 -0
  147. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-C74EEboR.mjs +143 -0
  148. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-C74EEboR.mjs.map +1 -0
  149. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Dj9lvkCP.mjs +132 -0
  150. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-Dj9lvkCP.mjs.map +1 -0
  151. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-B7H9pp-R.mjs +100 -0
  152. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-B7H9pp-R.mjs.map +1 -0
  153. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Dhfba-qx.mjs +138 -0
  154. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Dhfba-qx.mjs.map +1 -0
  155. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-hRTu79uE.mjs +359 -0
  156. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-hRTu79uE.mjs.map +1 -0
  157. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
  158. package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
  159. package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
  160. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  161. package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
  162. package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
  163. package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
  164. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  165. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
  166. package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
  167. package/forms/chip/index.d.ts +136 -26
  168. package/i18n/index.d.ts +70 -1
  169. package/modules/layout/index.d.ts +89 -6
  170. package/modules/pattern/README.md +76 -0
  171. package/modules/pattern/docs/detail.md +237 -0
  172. package/modules/pattern/docs/drawer.md +484 -0
  173. package/modules/pattern/docs/flow.md +631 -0
  174. package/modules/pattern/docs/form.md +815 -0
  175. package/modules/pattern/docs/header-actions.md +344 -0
  176. package/modules/pattern/docs/list.md +247 -0
  177. package/modules/pattern/docs/relation.md +180 -0
  178. package/modules/pattern/docs/select.md +214 -0
  179. package/modules/pattern/docs/split.md +350 -0
  180. package/modules/pattern/docs/states.md +168 -0
  181. package/modules/pattern/features/approval/entity.resolver.ts +21 -0
  182. package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
  183. package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
  184. package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
  185. package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
  186. package/modules/pattern/features/approval/routes.ts +30 -0
  187. package/modules/pattern/features/approval/services/approval.model.ts +38 -0
  188. package/modules/pattern/features/approval/services/approval.service.ts +23 -0
  189. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +130 -0
  190. package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
  191. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
  192. package/modules/pattern/features/category/entity.resolver.ts +27 -0
  193. package/modules/pattern/features/category/pages/list/list.component.html +20 -0
  194. package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
  195. package/modules/pattern/features/category/routes.ts +42 -0
  196. package/modules/pattern/features/category/services/category.model.ts +39 -0
  197. package/modules/pattern/features/category/services/category.service.ts +36 -0
  198. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +138 -0
  199. package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
  200. package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
  201. package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
  202. package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
  203. package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
  204. package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
  205. package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
  206. package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
  207. package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
  208. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
  209. package/modules/pattern/features/customer/entity.resolver.ts +21 -0
  210. package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
  211. package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
  212. package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
  213. package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
  214. package/modules/pattern/features/customer/routes.ts +59 -0
  215. package/modules/pattern/features/customer/services/customer.model.ts +87 -0
  216. package/modules/pattern/features/customer/services/customer.service.ts +79 -0
  217. package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
  218. package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
  219. package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
  220. package/modules/pattern/features/import/routes.ts +19 -0
  221. package/modules/pattern/features/import/services/import.model.ts +82 -0
  222. package/modules/pattern/features/import/services/import.service.ts +18 -0
  223. package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
  224. package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
  225. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
  226. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +182 -0
  227. package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
  228. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
  229. package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
  230. package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
  231. package/modules/pattern/features/order/entity.resolver.ts +37 -0
  232. package/modules/pattern/features/order/pages/create/create.component.ts +113 -0
  233. package/modules/pattern/features/order/pages/detail/detail.component.ts +224 -0
  234. package/modules/pattern/features/order/pages/list/list.component.html +38 -0
  235. package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
  236. package/modules/pattern/features/order/pages/update/update.component.ts +126 -0
  237. package/modules/pattern/features/order/routes.ts +54 -0
  238. package/modules/pattern/features/order/services/order.model.ts +109 -0
  239. package/modules/pattern/features/order/services/order.service.ts +63 -0
  240. package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
  241. package/modules/pattern/features/partner/routes.ts +20 -0
  242. package/modules/pattern/features/partner/services/partner.model.ts +30 -0
  243. package/modules/pattern/features/partner/services/partner.service.ts +17 -0
  244. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
  245. package/modules/pattern/features/product/components/product-select/product-select.component.ts +73 -0
  246. package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
  247. package/modules/pattern/features/product/entity.resolver.ts +21 -0
  248. package/modules/pattern/features/product/pages/create/create.component.ts +92 -0
  249. package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
  250. package/modules/pattern/features/product/pages/list/list.component.html +30 -0
  251. package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
  252. package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
  253. package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
  254. package/modules/pattern/features/product/routes.ts +48 -0
  255. package/modules/pattern/features/product/services/product.model.ts +38 -0
  256. package/modules/pattern/features/product/services/product.service.ts +48 -0
  257. package/modules/pattern/features/settings/pages/update/update.component.ts +228 -0
  258. package/modules/pattern/features/settings/routes.ts +24 -0
  259. package/modules/pattern/features/settings/services/settings.model.ts +18 -0
  260. package/modules/pattern/features/settings/services/settings.service.ts +15 -0
  261. package/modules/pattern/features/settings/settings.resolver.ts +8 -0
  262. package/modules/pattern/index.d.ts +50 -0
  263. package/package.json +5 -1
  264. package/services/api/index.d.ts +5 -5
  265. package/services/cache/index.d.ts +4 -2
  266. package/services/storage/index.d.ts +3 -1
  267. package/services/unsaved-changes/index.d.ts +11 -0
package/i18n/index.d.ts CHANGED
@@ -38,6 +38,7 @@ declare const EN_MESSAGES: {
38
38
  readonly 'core.component.table.mobile.reorder': "Drag to reorder row";
39
39
  readonly 'core.component.table.mobile.details': "Details";
40
40
  readonly 'core.component.table.mobile.summary': "Summary";
41
+ readonly 'core.common.back': "Back";
41
42
  readonly 'core.common.cancel': "Cancel";
42
43
  readonly 'core.common.close': "Close";
43
44
  readonly 'core.common.reload': "Reload page";
@@ -142,6 +143,15 @@ declare const EN_MESSAGES: {
142
143
  readonly 'core.form.chip.required': "Please enter information";
143
144
  readonly 'core.form.chip.minlength': "Please enter at least {min} values";
144
145
  readonly 'core.form.chip.maxlength': "Please enter at most {max} values";
146
+ readonly 'core.form.chip.remove': "Remove {value}";
147
+ readonly 'core.form.chip.placeholder': "Type, then press Enter";
148
+ readonly 'core.form.chip.locked': "Cannot be removed";
149
+ readonly 'core.form.chip.duplicate': "“{value}” is already added";
150
+ readonly 'core.form.chip.full': "All {max} values are added";
151
+ readonly 'core.form.chip.added': "Added {count}";
152
+ readonly 'core.form.chip.skipped': "skipped {count} duplicates";
153
+ readonly 'core.form.chip.more': "Show {count} more";
154
+ readonly 'core.form.chip.clear': "Remove all";
145
155
  readonly 'core.form.chip-calendar.required': "Please enter information";
146
156
  readonly 'core.form.chip-calendar.minlength': "Please enter at least {min} values";
147
157
  readonly 'core.form.chip-calendar.maxlength': "Please enter at most {max} values";
@@ -469,6 +479,10 @@ declare const EN_MESSAGES: {
469
479
  readonly 'core.component.table.skip': "Skip";
470
480
  readonly 'core.component.table.apply': "Apply";
471
481
  readonly 'core.component.table.filter': "Filter";
482
+ readonly 'core.component.table.query-bar.filters': "Filters";
483
+ readonly 'core.component.table.query-bar.columns': "Columns";
484
+ readonly 'core.component.table.filter-by': "Filter by {title}";
485
+ readonly 'core.component.table.filtering-by': "Filtering by {title}";
472
486
  readonly 'core.component.table.clear-selection': "Clear selection";
473
487
  readonly 'core.component.table.customize': "Customize";
474
488
  readonly 'core.component.table.search': "Search";
@@ -492,14 +506,33 @@ declare const EN_MESSAGES: {
492
506
  readonly 'core.component.table.error-occurred': "An error occurred";
493
507
  readonly 'core.component.table.not-an-array': "Data is not an array";
494
508
  readonly 'core.component.table.config.confirm-reset': "Confirm reset all settings to defaults";
495
- readonly 'core.component.table.config.drag-hint': "Drag the ⠿ handle to reorder columns";
509
+ readonly 'core.component.table.config.drag-hint': "Drag ⠿, or focus ⠿ and use ↑ ↓ to reorder.";
496
510
  readonly 'core.component.table.config.drag-handle': "Drag to reorder column";
511
+ readonly 'core.component.table.config.reset': "Restore defaults";
512
+ readonly 'core.component.table.config.find-column': "Find column";
513
+ readonly 'core.component.table.config.shown-count': "{shown}/{total} columns shown";
514
+ readonly 'core.component.table.config.show-all': "Show all";
515
+ readonly 'core.component.table.config.drag-disabled-search': "Clear the search to reorder.";
516
+ readonly 'core.component.table.config.width-auto': "Auto";
517
+ readonly 'core.component.table.config.hidden': "Hidden";
518
+ readonly 'core.component.table.config.origin': "Original: {title}";
519
+ readonly 'core.component.table.config.restore': "Restore";
520
+ readonly 'core.component.table.config.fixed-label': "Keep visible when scrolling horizontally";
521
+ readonly 'core.component.table.config.truncate-label': "Shorten long content";
522
+ readonly 'core.component.table.config.truncate-hint': "Cut with \"…\"; hover to see it all.";
523
+ readonly 'core.component.table.config.reorder-picked': "Picked up {title}, position {index} of {total}.";
524
+ readonly 'core.component.table.config.reorder-moved': "{title}: position {index} of {total}.";
525
+ readonly 'core.component.table.config.reorder-dropped': "Moved {title} to position {index}.";
526
+ readonly 'core.component.table.config.reorder-cancelled': "Reorder cancelled.";
527
+ readonly 'core.component.table.config.customized': "Using custom settings";
497
528
  readonly 'core.component.table.popup-export.select-columns': "Please select columns to export";
498
529
  readonly 'core.component.table.selector-action.selected': "Selected {count}";
499
530
  readonly 'core.component.table.selector-action.more': "More";
500
531
  readonly 'core.component.table.selector-action.default-msg': "items selected";
501
532
  readonly 'core.component.tab-router.too-many-tabs': "You have opened too many tabs.";
502
533
  readonly 'core.component.tab-router.close-tab': "Close tab";
534
+ readonly 'core.component.tab-router.close-others': "Close other tabs";
535
+ readonly 'core.component.tab-router.unsaved': "Unsaved changes";
503
536
  readonly 'core.component.tab-router.open-tabs': "{count} open tabs";
504
537
  readonly 'core.component.tab-router.tab-list': "Tab list";
505
538
  readonly 'core.component.upload-file.upload': "Upload file";
@@ -548,6 +581,12 @@ declare const EN_MESSAGES: {
548
581
  readonly 'core.module.layout.forbidden.title': "Access denied";
549
582
  readonly 'core.module.layout.forbidden.message': "You don't have permission to access this page. Please contact your administrator or go back to the home page";
550
583
  readonly 'core.module.layout.forbidden.back-home': "Back to home";
584
+ readonly 'core.module.layout.page.actions': "Page actions";
585
+ readonly 'core.module.layout.page.toc': "Contents";
586
+ readonly 'core.module.layout.page.leave.title': "Leave this page without saving?";
587
+ readonly 'core.module.layout.page.leave.message': "Unsaved changes will be lost.";
588
+ readonly 'core.module.layout.page.leave.stay': "Stay";
589
+ readonly 'core.module.layout.page.leave.leave': "Leave";
551
590
  readonly 'core.module.layout.not-found.title': "404 - Page not found";
552
591
  readonly 'core.module.layout.not-found.message': "The page you're looking for doesn't exist or has been removed. Please check the URL or go back to the home page to continue.";
553
592
  readonly 'core.module.layout.not-found.back': "Go back";
@@ -587,6 +626,12 @@ declare const EN_MESSAGES: {
587
626
  readonly 'core.component.query-bar.saved-filters.empty': "No saved filters yet.";
588
627
  readonly 'core.component.query-bar.saved-filters.save': "Save current filter";
589
628
  readonly 'core.component.query-bar.saved-filters.name-label': "Filter name";
629
+ readonly 'core.component.query-bar.all': "All";
630
+ readonly 'core.component.query-bar.required': "Select {label} to view data";
631
+ readonly 'core.component.query-bar.find-field': "Find field";
632
+ readonly 'core.component.query-bar.range.from': "From {value}";
633
+ readonly 'core.component.query-bar.range.to': "To {value}";
634
+ readonly 'core.component.query-bar.clear': "Clear all";
590
635
  readonly 'core.component.query-builder.date-mode.absolute': "Specific date";
591
636
  readonly 'core.component.query-builder.date-mode.now': "Today";
592
637
  readonly 'core.component.query-builder.date-mode.relative': "Relative";
@@ -876,11 +921,35 @@ declare const EN_MESSAGES: {
876
921
  readonly 'core.form.select.search': "Search";
877
922
  readonly 'core.form.search-field.clear': "Clear search";
878
923
  readonly 'core.component.table.loading': "Loading table data";
924
+ readonly 'core.component.table.loaded': "Loaded {count} rows";
925
+ readonly 'core.component.table.loaded-one': "Loaded 1 row";
926
+ readonly 'core.component.table.tree-toggle': "Toggle child rows";
879
927
  readonly 'core.component.upload-file.loading': "Uploading file";
880
928
  readonly 'core.component.import-excel.loading': "Loading data";
881
929
  readonly 'core.component.upload-file.remove': "Remove file";
882
930
  readonly 'core.component.upload-file.zoom': "Zoom image";
883
931
  readonly 'core.component.upload-file.view-all': "View all images";
932
+ readonly 'core.component.upload-file.viewer.download': "Download";
933
+ readonly 'core.component.upload-file.viewer.open-new-tab': "Open in new tab";
934
+ readonly 'core.component.upload-file.viewer.zoom-in': "Zoom in";
935
+ readonly 'core.component.upload-file.viewer.zoom-out': "Zoom out";
936
+ readonly 'core.component.upload-file.viewer.fit': "Fit to window";
937
+ readonly 'core.component.upload-file.viewer.rotate': "Rotate";
938
+ readonly 'core.component.upload-file.viewer.prev': "Previous file";
939
+ readonly 'core.component.upload-file.viewer.next': "Next file";
940
+ readonly 'core.component.upload-file.viewer.load-error': "Could not load the file";
941
+ readonly 'core.component.upload-file.viewer.load-error-hint': "Try again or download it to open in another app.";
942
+ readonly 'core.component.upload-file.viewer.no-preview': "No preview available";
943
+ readonly 'core.component.upload-file.viewer.loading': "Loading…";
944
+ readonly 'core.component.upload-file.viewer.position': "File {index} of {total}";
945
+ readonly 'core.component.upload-file.retry': "Retry";
946
+ readonly 'core.component.upload-file.add-image': "Add image";
947
+ readonly 'core.component.upload-file.upload-tile': "Upload";
948
+ readonly 'core.component.upload-file.drop-hint': "Drag files here or";
949
+ readonly 'core.component.upload-file.choose-file': "choose a file";
950
+ readonly 'core.component.upload-file.drop-to-upload': "Drop to upload";
951
+ readonly 'core.component.upload-file.remove-named': "Remove {name}";
952
+ readonly 'core.component.upload-file.no-files': "No files";
884
953
  readonly 'core.component.form-builder.canvas': "Form design canvas";
885
954
  readonly 'core.component.form-builder.toolbar': "Form builder toolbar";
886
955
  readonly 'core.component.form-builder.mode': "Mode";
@@ -2,12 +2,15 @@ import * as _angular_core from '@angular/core';
2
2
  import { Signal, InjectionToken, PipeTransform } from '@angular/core';
3
3
  import * as i1$1 from '@angular/common';
4
4
  import * as i1 from '@angular/router';
5
- import { Params } from '@angular/router';
5
+ import { Params, CanDeactivateFn } from '@angular/router';
6
6
  import { SdStorage } from '@sdcorejs/angular/services';
7
7
  import { MaybeAsync } from '@sdcorejs/utils/models';
8
8
  import { Observable } from 'rxjs';
9
9
  import { SdViewport } from '@sdcorejs/angular/services/viewport';
10
10
  import * as _sdcorejs_angular_modules_layout from '@sdcorejs/angular/modules/layout';
11
+ import { SdBadgeData } from '@sdcorejs/angular/components/badge';
12
+ import { SdSectionRegistry, SdSection } from '@sdcorejs/angular/components/section';
13
+ import { SdTableLayout } from '@sdcorejs/angular/components/table';
11
14
  import { FlexibleConnectedPositionStrategyOrigin, ConnectedPosition } from '@angular/cdk/overlay';
12
15
 
13
16
  declare class HomeRoutingModule {
@@ -535,14 +538,94 @@ declare class SdLayoutContextService {
535
538
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutContextService>;
536
539
  }
537
540
 
538
- declare class SdPageComponent {
541
+ /** Bề rộng cột nội dung: `full` không giới hạn · `wide` 1200px · `medium` 960px · `narrow` 720px. */
542
+ type SdPageWidth = 'full' | 'wide' | 'medium' | 'narrow';
543
+ /** Đích của nút ←: URL hoặc router commands như `routerLink`. */
544
+ type SdPageBackLink = string | readonly unknown[];
545
+ /** Vị trí cột phụ `[sdAside]` khi đủ chỗ đặt cạnh nội dung. */
546
+ type SdPageAside = 'end' | 'start';
547
+ interface SdPageTocItem {
548
+ readonly title: string;
549
+ readonly el: HTMLElement;
550
+ }
551
+ declare class SdPageComponent implements SdSectionRegistry {
552
+ #private;
539
553
  private el;
540
554
  title: _angular_core.InputSignal<string>;
541
555
  description: _angular_core.InputSignal<string>;
542
556
  noHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
557
+ /** Hiện nút ← trước title; title, description và badges vẫn lấy từ input. */
558
+ backLink: _angular_core.InputSignal<SdPageBackLink | null | undefined>;
559
+ /** Tối đa 2 badge cạnh title: trạng thái trước, thuộc tính sau. Badge không có `title` bị bỏ qua. */
560
+ badges: _angular_core.InputSignal<readonly SdBadgeData[] | null | undefined>;
561
+ /** `null` / không truyền thì lấy mặc định theo selector: `sd-page` full · `sd-page-detail` wide · `sd-page-form` medium. */
562
+ width: _angular_core.InputSignal<SdPageWidth | null | undefined>;
563
+ /** Cột phụ ở cuối (mặc định) hay ở đầu. Viewport < 1200px thì cột phụ luôn xuống dưới nội dung. */
564
+ aside: _angular_core.InputSignal<SdPageAside | null | undefined>;
565
+ /** Mục lục ở cột phụ, liệt kê các `sd-section` có `title` ở cấp ngoài cùng của thân trang. */
566
+ toc: _angular_core.InputSignalWithTransform<boolean, unknown>;
567
+ readonly resolvedWidth: _angular_core.Signal<SdPageWidth>;
568
+ protected readonly visibleBadges: _angular_core.Signal<SdBadgeData[]>;
569
+ /** Header có nút ← hoặc badge: title một dòng, cắt bằng dấu "…". Màn cũ giữ title xuống dòng như trước. */
570
+ protected readonly hasLead: _angular_core.Signal<boolean>;
571
+ protected readonly tocItems: _angular_core.WritableSignal<readonly SdPageTocItem[]>;
572
+ protected readonly activeTocIndex: _angular_core.WritableSignal<number>;
573
+ private readonly titleBlock;
574
+ private readonly wrapper;
543
575
  constructor();
576
+ /** Cuộn tới section của mục lục thứ `index`. */
577
+ protected scrollToSection(index: number): void;
578
+ /** Thêm một section ngoài cùng của thân trang vào mục lục (gọi bởi `sd-section`). */
579
+ register(section: SdSection, el: HTMLElement): () => void;
544
580
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdPageComponent, never>;
545
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPageComponent, "sd-page", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "noHeader": { "alias": "noHeader"; "required": false; "isSignal": true; }; }, {}, never, ["[headerLeft]", "[headerRight]", "*"], true, never>;
581
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPageComponent, "sd-page, sd-page-detail, sd-page-form", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "noHeader": { "alias": "noHeader"; "required": false; "isSignal": true; }; "backLink": { "alias": "backLink"; "required": false; "isSignal": true; }; "badges": { "alias": "badges"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "aside": { "alias": "aside"; "required": false; "isSignal": true; }; "toc": { "alias": "toc"; "required": false; "isSignal": true; }; }, {}, never, ["[headerLeft],[sdHeaderLeft]", "[headerRight],[sdHeaderRight]", "[sdSubheader]", "*", "[sdAside]", "[sdFooterLeft]", "[sdFooterRight]"], true, never>;
582
+ }
583
+
584
+ /**
585
+ * Guard rời trang của `sd-page-form`: còn thay đổi chưa lưu (watcher của `SdUnsavedChangesService`, thường đăng ký
586
+ * bằng `registerSdUnsavedChangesForm(..., { dirty: 'value' })`) thì hỏi bằng dialog xác nhận của Core.
587
+ *
588
+ * why: adapter của service là của cả app (mặc định `window.confirm`); guard này truyền adapter riêng cho lần hỏi
589
+ * này nên app đang dùng `sdUnsavedChangesGuard` không đổi hành vi.
590
+ */
591
+ declare const sdPageFormLeaveGuard: CanDeactivateFn<unknown>;
592
+
593
+ /**
594
+ * Cách mở chi tiết (route con của danh sách): thay danh sách bằng một trang, drawer đè lên danh sách, hoặc `'none'`:
595
+ * `sd-page-list` không đặt router-outlet, route con hiện trong outlet do màn tự đặt trong thân (chia đôi).
596
+ */
597
+ type SdPageListDetail = 'page' | 'drawer' | 'none';
598
+ /** Trạng thái `sd-page-list` mà nội dung bên trong (score card, route con…) đọc qua `SD_PAGE_LIST`. */
599
+ interface SdPageListContext {
600
+ /** Màn thấp (viewport cao < 720px) và `autoCompact` bật: vùng phụ nên chuyển sang dạng gọn. */
601
+ readonly compact: Signal<boolean>;
602
+ /** Đang có route con (chi tiết, tạo, cập nhật). */
603
+ readonly childActive: Signal<boolean>;
604
+ readonly detail: Signal<SdPageListDetail>;
605
+ }
606
+ declare const SD_PAGE_LIST: InjectionToken<SdPageListContext>;
607
+ declare class SdPageList implements SdPageListContext, SdTableLayout {
608
+ #private;
609
+ title: _angular_core.InputSignal<string>;
610
+ description: _angular_core.InputSignal<string>;
611
+ backLink: _angular_core.InputSignal<SdPageBackLink | null | undefined>;
612
+ badges: _angular_core.InputSignal<readonly SdBadgeData[] | null | undefined>;
613
+ width: _angular_core.InputSignal<SdPageWidth | null | undefined>;
614
+ /** Chi tiết là route con: `page` thay danh sách bằng trang con, `drawer` giữ danh sách và mở drawer. */
615
+ detail: _angular_core.InputSignal<SdPageListDetail>;
616
+ /** Tự thu gọn vùng phụ khi viewport thấp. Tắt thì vùng phụ luôn đầy đủ và thân trang cuộn khi thiếu chỗ. */
617
+ autoCompact: _angular_core.InputSignalWithTransform<boolean, unknown>;
618
+ readonly compact: Signal<boolean>;
619
+ readonly childActive: _angular_core.WritableSignal<boolean>;
620
+ /** Bảng chính: `[sdPageListMain]`, hoặc `sd-table` con trực tiếp cuối cùng của thân trang. */
621
+ readonly fillTarget: _angular_core.WritableSignal<Element | null>;
622
+ readonly externalFilterCollapsed: Signal<boolean>;
623
+ protected readonly hidesList: Signal<boolean>;
624
+ constructor();
625
+ protected onActivate(): void;
626
+ protected onDeactivate(): void;
627
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdPageList, never>;
628
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdPageList, "sd-page-list", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "backLink": { "alias": "backLink"; "required": false; "isSignal": true; }; "badges": { "alias": "badges"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "detail": { "alias": "detail"; "required": false; "isSignal": true; }; "autoCompact": { "alias": "autoCompact"; "required": false; "isSignal": true; }; }, {}, never, ["[headerRight],[sdHeaderRight]", "[sdSubheader]", "[sdFooterLeft]", "[sdFooterRight]", "*"], true, never>;
546
629
  }
547
630
 
548
631
  declare class SdLayoutComponent {
@@ -1006,7 +1089,7 @@ declare class SdLayoutContextSwitcher {
1006
1089
  /** Context configuration of the sidebar; nothing renders without items. */
1007
1090
  configuration: _angular_core.InputSignal<SdLayoutContextConfiguration | null | undefined>;
1008
1091
  /** Header trigger, collapsed-rail avatar, or mobile row that opens a bottom sheet. */
1009
- appearance: _angular_core.InputSignal<"sheet" | "header" | "rail">;
1092
+ appearance: _angular_core.InputSignal<"header" | "sheet" | "rail">;
1010
1093
  /** Side the desktop popover opens on; defaults to `below` for the header and `right` for the rail. The sheet ignores it. */
1011
1094
  placement: _angular_core.InputSignal<"below" | "right" | undefined>;
1012
1095
  /**
@@ -1115,5 +1198,5 @@ declare class SdLayoutModule {
1115
1198
  static ɵinj: _angular_core.ɵɵInjectorDeclaration<SdLayoutModule>;
1116
1199
  }
1117
1200
 
1118
- export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_CONTEXT_MARKER_KEY, SD_LAYOUT_CONTEXT_RUNTIME, SD_LAYOUT_DEMO_FALLBACK, SD_LAYOUT_STORAGE_NAMESPACE, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutContextService, SdLayoutContextSwitcher, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SdSidebarMobileOverlay, SdSidebarMobileV1, SdSidebarMobileV2, SdSidebarMobileV3, SdSidebarMobileV4, SdSidebarV2, SdSidebarV3, SdSidebarV4, collectMatchedMenuPaths, containsMenuPath, createSdLayoutContextBrowserRuntime, flattenMenuLeaves, getMenuStableKey, groupMenusBySection, isMenuPathMatch, normalizeLayoutMobileBreakpoint, normalizeMenuPath, normalizeSidebarConfiguration, resolveActiveMenuPath, resolveMenuKeys, resolveMenuTrailing, resolveSidebarV2Interaction, resolveSidebarV3Recent, resolveTabName, searchAvailableMenuLeaves, searchMenuLeaves, selectPrimaryMenuGroups };
1119
- export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutContext, SdLayoutContextConfiguration, SdLayoutContextRuntime, SdLayoutMenu, SdLayoutMenuBadge, SdLayoutMenuSectionGroup, SdLayoutMenuStatus, SdLayoutMenuTrailing, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutStorageNamespace, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3, SidebarConfigurationV4 };
1201
+ export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_CONTEXT_MARKER_KEY, SD_LAYOUT_CONTEXT_RUNTIME, SD_LAYOUT_DEMO_FALLBACK, SD_LAYOUT_STORAGE_NAMESPACE, SD_LAYOUT_VIEWPORT, SD_PAGE_LIST, SdLayoutComponent, SdLayoutContextService, SdLayoutContextSwitcher, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SdPageList, SdSidebarMobileOverlay, SdSidebarMobileV1, SdSidebarMobileV2, SdSidebarMobileV3, SdSidebarMobileV4, SdSidebarV2, SdSidebarV3, SdSidebarV4, collectMatchedMenuPaths, containsMenuPath, createSdLayoutContextBrowserRuntime, flattenMenuLeaves, getMenuStableKey, groupMenusBySection, isMenuPathMatch, normalizeLayoutMobileBreakpoint, normalizeMenuPath, normalizeSidebarConfiguration, resolveActiveMenuPath, resolveMenuKeys, resolveMenuTrailing, resolveSidebarV2Interaction, resolveSidebarV3Recent, resolveTabName, sdPageFormLeaveGuard, searchAvailableMenuLeaves, searchMenuLeaves, selectPrimaryMenuGroups };
1202
+ export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutContext, SdLayoutContextConfiguration, SdLayoutContextRuntime, SdLayoutMenu, SdLayoutMenuBadge, SdLayoutMenuSectionGroup, SdLayoutMenuStatus, SdLayoutMenuTrailing, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutStorageNamespace, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SdPageAside, SdPageBackLink, SdPageListContext, SdPageListDetail, SdPageWidth, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3, SidebarConfigurationV4 };
@@ -0,0 +1,76 @@
1
+ # `@sdcorejs/angular/modules/pattern`
2
+
3
+ Màn mẫu theo entity, chạy trên Core thật với mock API. Mỗi màn là code Angular hoàn chỉnh trong `features/`, theo cấu trúc project-structure của Angular Portal Blueprint. Tài liệu trong `docs/` giữ quy tắc và lý do; mọi khối code trong đó được trích từ `features/` khi build (`npm run pattern:docs`), nên không có code minh hoạ tách rời code chạy thật.
4
+
5
+ Đọc theo thứ tự: README này → `docs/<pattern>.md` của loại màn cần làm → thư mục `features/<entity>/` gần nhất. Gói npm mang theo cả ba (`node_modules/@sdcorejs/angular/modules/pattern/`).
6
+
7
+ ## Chọn pattern theo loại màn
8
+
9
+ | Loại màn | Pattern | Selector / thành phần | Route mẫu |
10
+ | --- | --- | --- | --- |
11
+ | Danh sách có bảng | [list](docs/list.md) | `sd-page-list` + `sd-table` | `product`, `order`, `customer`, `category` |
12
+ | Xem một bản ghi | [detail](docs/detail.md) | `sd-page-detail` | `product/:id/detail`, `order/:id/detail`, `customer/:id/360` |
13
+ | Tạo / cập nhật một bước | [form](docs/form.md) | `sd-page-form` (`toc` khi nhiều nhóm) | `product/create`, `order/create`, `settings` |
14
+ | Quy trình nhiều bước | [flow](docs/flow.md) | `sd-page` hẹp + `sd-stepper`, nút bước ở footer | `import`, `partner/create` |
15
+ | Xem / sửa ngay trên danh sách | [drawer](docs/drawer.md) | `sd-side-drawer` trong route con | `customer/create`, `customer/:id/detail`, `category/:id/update` |
16
+ | Xử lý nhanh từng mục | [split](docs/split.md) | `sd-page-list detail="none"` + `sd-splitter` | `approval` |
17
+ | Chọn entity / enum | [select](docs/select.md) | wrapper `<entity>-select` của feature sở hữu entity | `product-select`, `customer-select` |
18
+ | Hiện quan hệ theo ID | [relation](docs/relation.md) | pipe `<entity>Detail` | `customerDetail`, `productDetail` |
19
+ | Nút ở header | [header-actions](docs/header-actions.md) | `headerRight`, Action Popover của `sd-button` | `product` (menu Nhập/Xuất) |
20
+ | Đang tải, rỗng, lỗi, thiếu quyền | [states](docs/states.md) | `sd-table`, `sd-data-state`, resolver, guard | mọi route |
21
+
22
+ Không có loại màn phù hợp: dùng `sd-page` và ghép các pattern trên. Có màn thứ ba cùng loại mới tách thành selector hoặc pattern riêng.
23
+
24
+ ## Gắn vào portal
25
+
26
+ Route `pattern` của host lazy-load `SD_PATTERN_ROUTES` và đặt `provideSdPatterns({ mockApi: true })` trong `providers` của chính route đó. Interceptor mock chỉ chạy trên `HttpClient` con của route này; quyền mẫu (`SdPermissionService`, `SdPermissionGuard`, `SD_PERMISSION_CONFIGURATION`) cũng được cấp lại ở đây nên không đụng quyền của host. `mockApi: false` + `apiBaseUrl` cho service gọi API thật. Lỗi tải bản ghi trước khi mở trang (404, 403, timeout) đi tới navigation error handler của host; `forbiddenUrl` là trang host mở khi vai trò thiếu quyền vào route.
27
+
28
+ Thanh công cụ dưới cùng của `/pattern` (vai trò, độ trễ, lỗi giả lập, khôi phục dữ liệu, xem source) và drawer "Tuỳ chỉnh hiển thị" của `/pattern/order` thuộc `core/pattern-shell`, không phải code của feature: không chép sang màn thật.
29
+
30
+ ## Cấu trúc một feature
31
+
32
+ ```text
33
+ features/<entity>/
34
+ routes.ts route list + route con (create, :id/detail, :id/update), service cấp ở đây
35
+ entity.resolver.ts tải bản ghi bằng detail(id) trước khi mở trang
36
+ services/<entity>.model.ts DTO, Req, const/enum, badge
37
+ services/<entity>.service.ts gọi API qua BaseApiService; không biết có mock hay không
38
+ pages/list|detail|create|update/ trang có route
39
+ components/ -form, -view, -select, *-side-drawer của entity
40
+ pipes/<entity>-detail.pipe.ts relation theo ID cho màn khác
41
+ ```
42
+
43
+ Tên feature đã có trong đường dẫn, không lặp lại trong tên file bên trong. Dựng feature mới: chép thư mục entity gần nhất rồi đổi tên.
44
+
45
+ ## Quyết định đã chốt
46
+
47
+ | Mã | Quyết định |
48
+ | --- | --- |
49
+ | E1 | Danh sách vừa khít màn hình, không có scrollbar ngoài; chỉ vùng dữ liệu của bảng cuộn. Feature không viết chiều cao hay SCSS cho danh sách. |
50
+ | E2 | `backLink` hiện nút ← trước title; title, mô tả và tối đa hai badge truyền qua input. |
51
+ | E3 | Nút Lưu của page nằm ở `headerRight`; drawer và flow đặt nút ở footer. |
52
+ | E4 | Drawer chỉ đóng bằng X (cùng Esc, backdrop); không có nút Đóng/Huỷ thường trực. |
53
+ | E5 | Dùng "Cập nhật <entity>", không dùng "Chỉnh sửa". |
54
+ | E6 | Không dùng quick search cùng external filter trên một màn; mỗi field chỉ một chỗ lọc. |
55
+ | E7 | Giữ mặc định `hideInlineFilter: false`; màn ít dữ liệu dùng `'auto'`; không dùng `true`. |
56
+ | E8 | Flow là pattern: `sd-page` + `sd-stepper`, giữ dữ liệu khi đổi bước. |
57
+ | E9 | Drawer 480px mặc định, 600px cho chi tiết và form thường, tối đa 800px. |
58
+ | E10 | Code trong tài liệu được trích từ `features/`; khối lệch code thì kiểm tra trong CI thất bại. |
59
+ | E11 | Tài liệu không ghi chú theo version; khác biệt giữa version ghi ở CHANGELOG. |
60
+ | E12 | `features/*` theo cấu trúc project-structure của Blueprint. |
61
+ | E13 | Sau lưu: page sang chi tiết, drawer đóng và danh sách tải lại. Lưu lỗi: focus field lỗi đầu tiên, lỗi API gắn vào field. Xoá, duyệt, từ chối, mọi tác vụ đổi trạng thái đều hỏi xác nhận, cả từng bản ghi lẫn hàng loạt; hàng loạt báo kết quả từng phần và cho thử lại phần lỗi. |
62
+
63
+ ## Mã quyền
64
+
65
+ `PATTERN_<ENTITY>_<R|C|U|D>_<ACTION>`: R đọc, C tạo, U đổi một bản ghi (cập nhật và mọi tác vụ trạng thái), D xoá. Feature ghi thẳng mã trong `data.permission` và `*sdPermission`; vai trò mẫu (Quản trị, Nhân viên không xoá không duyệt, Chỉ xem) nằm trong `core/permission`.
66
+
67
+ ## Đóng góp
68
+
69
+ Thêm hoặc sửa một màn mẫu:
70
+
71
+ - [ ] Route trong `SD_PATTERN_ROUTES` và dòng trong mục lục `/pattern` (`core/pattern-shell/catalog`).
72
+ - [ ] Resource của mock API trong `core/mock-api/resources`, seed cố định.
73
+ - [ ] Mã quyền mới có trong `core/permission/pattern-permission.ts`; mã không còn dùng thì xoá.
74
+ - [ ] Tài liệu trong `docs/` trỏ tới file của feature bằng marker `@source`; chạy `npm run pattern:docs` (cập nhật cả manifest của tab Source).
75
+ - [ ] Playwright cho route trong `showcase/e2e/pattern/`.
76
+ - [ ] Quy tắc review: không có chiều cao hay `overflow` tự viết trong danh sách, không có `hideInlineFilter: true`, không có nút Đóng thường trực trong drawer, không có chữ "Chỉnh sửa".
@@ -0,0 +1,237 @@
1
+ # Detail
2
+
3
+ Xem một bản ghi: `sd-page-detail`. Route mẫu: `/pattern/product/:id/detail` (section và `sd-view`), `/pattern/order/:id/detail` (workflow duyệt, cột phụ quy trình), `/pattern/customer/:id/360` (hồ sơ nhiều tab).
4
+
5
+ ## Khi nào dùng / khi nào không
6
+
7
+ - Dùng khi bản ghi có nhiều nhóm thông tin, quan hệ hoặc tác vụ nghiệp vụ.
8
+ - Bản ghi ngắn, xem nhanh ngay trên danh sách: dùng drawer chi tiết ([drawer](drawer.md)).
9
+ - Nhiều tab, bảng quan hệ lớn (hồ sơ 360°): luôn là trang, không đặt vào drawer.
10
+
11
+ ## Code mẫu
12
+
13
+ Bản ghi do resolver tải trước khi mở trang; trang nhận bản ghi qua `ActivatedRoute.data`, không gọi lại API chính.
14
+
15
+ <!-- @source features/product/entity.resolver.ts -->
16
+ ```ts
17
+ import { HttpErrorResponse } from '@angular/common/http';
18
+ import { inject } from '@angular/core';
19
+ import type { ResolveFn } from '@angular/router';
20
+ import { map, timeout } from 'rxjs';
21
+ import { ProductService } from './services/product.service';
22
+ import type { ProductDto } from './services/product.model';
23
+
24
+ /** Tải sản phẩm trước khi mở detail/update; lỗi (404, 403, timeout) đi tới navigation error handler của host. */
25
+ export const entityResolver: ResolveFn<ProductDto> = route => {
26
+ const id = route.paramMap.get('id');
27
+ if (!id?.trim()) throw new HttpErrorResponse({ status: 404 });
28
+ return inject(ProductService)
29
+ .detail(id)
30
+ .pipe(
31
+ timeout(10_000),
32
+ map(entity => {
33
+ if (!entity || entity.id !== id) throw new HttpErrorResponse({ status: 404 });
34
+ return entity;
35
+ })
36
+ );
37
+ };
38
+ ```
39
+
40
+ <!-- @source features/product/pages/detail/detail.component.ts -->
41
+ ```ts
42
+ import { ChangeDetectionStrategy, Component, computed, inject } from '@angular/core';
43
+ import { toSignal } from '@angular/core/rxjs-interop';
44
+ import { ActivatedRoute, RouterLink } from '@angular/router';
45
+ import { map } from 'rxjs';
46
+ import { SdButton } from '@sdcorejs/angular/components/button';
47
+ import { SdSection } from '@sdcorejs/angular/components/section';
48
+ import { SdView } from '@sdcorejs/angular/components/view';
49
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
50
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
51
+ import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
52
+ import { PRODUCT_STATUS_OPTIONS, productStatusBadge, type ProductDto } from '../../services/product.model';
53
+
54
+ @Component({
55
+ selector: 'detail',
56
+ standalone: true,
57
+ changeDetection: ChangeDetectionStrategy.OnPush,
58
+ imports: [RouterLink, SdPageComponent, SdButton, SdSection, SdView, SdPermissionDirective, SdFormatNumberPipe],
59
+ template: `
60
+ @let product = entity();
61
+ <sd-page-detail [title]="'Chi tiết sản phẩm #' + product.code" [description]="product.name" [badges]="badges()" [backLink]="['../..']">
62
+ <sd-button
63
+ headerRight
64
+ *sdPermission="'PATTERN_PRODUCT_U_UPDATE'"
65
+ title="Cập nhật sản phẩm"
66
+ prefixIcon="edit"
67
+ type="fill"
68
+ color="primary"
69
+ autoId="product-update"
70
+ [routerLink]="['../update']" />
71
+ <div class="d-flex flex-column gap-16 py-16">
72
+ <sd-section title="Thông tin chung">
73
+ <div class="row p-8">
74
+ <div class="col-12 col-md-6 p-8"><sd-view label="Mã sản phẩm" [display]="product.code" /></div>
75
+ <div class="col-12 col-md-6 p-8"><sd-view label="Tên sản phẩm" [display]="product.name" /></div>
76
+ <div class="col-12 col-md-6 p-8"><sd-view label="Trạng thái" [display]="statusName()" /></div>
77
+ </div>
78
+ </sd-section>
79
+ <sd-section title="Giá bán">
80
+ <div class="row p-8">
81
+ <div class="col-12 col-md-6 p-8"><sd-view label="Giá bán (₫)" [display]="product.price | sdFormatNumber: 0" /></div>
82
+ <div class="col-12 col-md-6 p-8"><sd-view label="Đơn vị tính" [display]="product.unit" /></div>
83
+ </div>
84
+ </sd-section>
85
+ </div>
86
+ </sd-page-detail>
87
+ `,
88
+ })
89
+ export class DetailComponent {
90
+ /** Sản phẩm do resolver tải trước khi mở trang; đổi ID thì nhận bản ghi mới. */
91
+ protected readonly entity = toSignal(inject(ActivatedRoute).data.pipe(map(data => data['entity'] as ProductDto)), { requireSync: true });
92
+ protected readonly badges = computed(() => [productStatusBadge(this.entity().status)]);
93
+ protected readonly statusName = computed(() => PRODUCT_STATUS_OPTIONS.find(option => option.id === this.entity().status)?.name);
94
+ }
95
+ ```
96
+
97
+ Hồ sơ 360°: tab trong `sdSubheader`, tab ghi trên URL, mở tab nào mới tải tab đó:
98
+
99
+ <!-- @source features/customer/pages/profile/profile.component.ts -->
100
+ ```ts
101
+ import { ChangeDetectionStrategy, Component, computed, inject, linkedSignal, untracked } from '@angular/core';
102
+ import { toSignal } from '@angular/core/rxjs-interop';
103
+ import { ActivatedRoute, Router, RouterLink } from '@angular/router';
104
+ import { map } from 'rxjs';
105
+ import { SdButton } from '@sdcorejs/angular/components/button';
106
+ import { SdTab, SdTabGroup } from '@sdcorejs/angular/components/tab';
107
+ import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
108
+ import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
109
+ import { DebtsViewComponent } from '../../components/debts-view/debts-view.component';
110
+ import { DocumentsViewComponent } from '../../components/documents-view/documents-view.component';
111
+ import { GeneralInformationViewComponent } from '../../components/general-information-view/general-information-view.component';
112
+ import { OrdersViewComponent } from '../../components/orders-view/orders-view.component';
113
+ import { customerStatusBadge, customerTypeName, type CustomerDto } from '../../services/customer.model';
114
+
115
+ const TABS = [
116
+ { key: 'info', label: 'Thông tin' },
117
+ { key: 'orders', label: 'Đơn hàng' },
118
+ { key: 'debts', label: 'Công nợ' },
119
+ { key: 'documents', label: 'Tài liệu' },
120
+ ] as const;
121
+ type TabKey = (typeof TABS)[number]['key'];
122
+
123
+ /**
124
+ * Hồ sơ 360° (`:id/360`): thông tin chung và các quan hệ của khách hàng theo tab. Tab ghi trên URL (`?tab=`);
125
+ * mở tab nào mới tải tab đó, mỗi tab tự có trạng thái đang tải, rỗng và lỗi.
126
+ */
127
+ @Component({
128
+ selector: 'profile',
129
+ standalone: true,
130
+ imports: [
131
+ RouterLink,
132
+ SdPageComponent,
133
+ SdButton,
134
+ SdTabGroup,
135
+ SdTab,
136
+ SdPermissionDirective,
137
+ GeneralInformationViewComponent,
138
+ OrdersViewComponent,
139
+ DebtsViewComponent,
140
+ DocumentsViewComponent,
141
+ ],
142
+ changeDetection: ChangeDetectionStrategy.OnPush,
143
+ template: `
144
+ @let customer = entity();
145
+ <sd-page-detail
146
+ [title]="'Hồ sơ khách hàng #' + customer.code"
147
+ [description]="customer.name + ' · ' + typeName()"
148
+ [badges]="badges()"
149
+ [backLink]="['../..']">
150
+ <sd-button
151
+ headerRight
152
+ *sdPermission="'PATTERN_CUSTOMER_U_UPDATE'"
153
+ title="Cập nhật khách hàng"
154
+ prefixIcon="edit"
155
+ type="fill"
156
+ color="primary"
157
+ autoId="customer-profile-update"
158
+ [routerLink]="['../update']" />
159
+ <sd-tab-group sdSubheader [selectedIndex]="tabIndex()" (selectedIndexChange)="selectTab($event)">
160
+ @for (tab of tabs; track tab.key) {
161
+ <sd-tab [label]="tab.label" />
162
+ }
163
+ </sd-tab-group>
164
+ <div class="py-16">
165
+ @for (tab of tabs; track tab.key; let index = $index) {
166
+ @if (opened().has(tab.key)) {
167
+ <div [hidden]="tabIndex() !== index" [attr.data-customer-tab]="tab.key">
168
+ @switch (tab.key) {
169
+ @case ('info') {
170
+ <general-information-view [customer]="customer" />
171
+ }
172
+ @case ('orders') {
173
+ <orders-view [customerId]="customer.id" />
174
+ }
175
+ @case ('debts') {
176
+ <debts-view [customerId]="customer.id" />
177
+ }
178
+ @case ('documents') {
179
+ <documents-view [customerId]="customer.id" />
180
+ }
181
+ }
182
+ </div>
183
+ }
184
+ }
185
+ </div>
186
+ </sd-page-detail>
187
+ `,
188
+ })
189
+ export class ProfileComponent {
190
+ readonly #router = inject(Router);
191
+ readonly #route = inject(ActivatedRoute);
192
+ protected readonly tabs = TABS;
193
+ protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as CustomerDto)), { requireSync: true });
194
+ protected readonly badges = computed(() => [customerStatusBadge(this.entity().status)]);
195
+ protected readonly typeName = computed(() => customerTypeName(this.entity().type));
196
+ readonly #tabParam = toSignal(this.#route.queryParamMap.pipe(map(params => params.get('tab'))), { requireSync: true });
197
+ protected readonly tabIndex = computed(() =>
198
+ Math.max(
199
+ 0,
200
+ TABS.findIndex(tab => tab.key === this.#tabParam())
201
+ )
202
+ );
203
+ /** Tab đã mở ít nhất một lần: giữ lại khi chuyển tab, không tải lại. Đổi khách hàng thì bắt đầu lại. */
204
+ protected readonly opened = linkedSignal<CustomerDto, ReadonlySet<TabKey>>({
205
+ source: this.entity,
206
+ // untracked: đổi tab không được đặt lại các tab đã mở; chỉ đổi khách hàng mới bắt đầu lại.
207
+ computation: () => new Set<TabKey>([TABS[untracked(this.tabIndex)].key]),
208
+ });
209
+
210
+ protected selectTab(index: number): void {
211
+ const key = TABS[index]?.key ?? 'info';
212
+ this.opened.update(opened => new Set([...opened, key]));
213
+ void this.#router.navigate([], {
214
+ relativeTo: this.#route,
215
+ queryParams: { tab: key === 'info' ? null : key },
216
+ queryParamsHandling: 'merge',
217
+ replaceUrl: true,
218
+ });
219
+ }
220
+ }
221
+ ```
222
+
223
+ ## Quy tắc
224
+
225
+ - MUST đặt title "Chi tiết <entity> #<mã>", badge trạng thái cạnh title qua `[badges]` (tối đa hai: trạng thái trước, thuộc tính sau), mô tả ngắn ở dòng thứ hai. Không thay cả vùng trái bằng `headerLeft` chỉ để thêm nút ←: dùng `backLink` (E2).
226
+ - MUST tải bản ghi bằng resolver gọi `detail(id)` của service sở hữu entity; lỗi (404, 403, timeout) để navigation error handler của host xử lý, không mở trang với bản ghi rỗng.
227
+ - MUST nhận bản ghi mới khi đổi ID (`runGuardsAndResolvers: 'paramsChange'`, đọc `data` dạng signal).
228
+ - MUST đặt nút chính "Cập nhật <entity>" (`type="fill"`) ở `headerRight`; tối đa ba tác vụ cấp ngoài, từ tác vụ thứ ba gom vào Action Popover ([header-actions](header-actions.md)).
229
+ - MUST hiện tác vụ theo quyền (`*sdPermission`) và theo trạng thái nghiệp vụ (computed trong TS); quyền xem không suy ra quyền cập nhật.
230
+ - SHOULD chia thông tin theo `sd-section`; trong section dùng `sd-view` cho field ngắn hoặc `sd-section-item` cho dạng thuộc tính.
231
+ - SHOULD dùng `sdAside` cho thông tin phụ (quy trình duyệt, người phụ trách); dưới 1200px cột phụ xuống dưới thân.
232
+
233
+ ## Lỗi hay gặp
234
+
235
+ - Gọi API tải bản ghi trong `ngOnInit` của trang: trang mở trước khi có dữ liệu, lỗi 404 hiện thành trang trống.
236
+ - Hiện ID quan hệ thay vì tên: dùng pipe [relation](relation.md).
237
+ - Tải mọi tab của hồ sơ 360° ngay khi mở trang: chậm và tốn request cho tab người dùng không xem.