@tailor-platform/erp-kit 0.6.0 → 0.8.0

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 (913) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +18 -14
  3. package/dist/cli.mjs +477 -139
  4. package/package.json +1 -1
  5. package/skills/erp-kit-app-1-requirements/SKILL.md +33 -17
  6. package/skills/erp-kit-app-2-requirements-review/SKILL.md +12 -0
  7. package/skills/erp-kit-app-3-plan/SKILL.md +18 -4
  8. package/skills/erp-kit-app-3-plan/references/resolver-extraction.md +1 -1
  9. package/skills/erp-kit-app-3-plan/references/screen-extraction.md +1 -1
  10. package/skills/erp-kit-app-4-plan-review/SKILL.md +12 -0
  11. package/skills/erp-kit-app-5-impl-backend/SKILL.md +17 -5
  12. package/skills/erp-kit-app-5-impl-backend/references/app-config.md +1 -1
  13. package/skills/erp-kit-app-5-impl-backend/references/module-wiring.md +37 -12
  14. package/skills/erp-kit-app-6-impl-frontend/SKILL.md +15 -1
  15. package/skills/erp-kit-app-6-impl-frontend/references/component.md +90 -0
  16. package/skills/erp-kit-app-6-impl-frontend/references/detail-view.md +255 -0
  17. package/skills/erp-kit-app-6-impl-frontend/references/pages.md +1 -5
  18. package/skills/erp-kit-app-7-impl-review/SKILL.md +16 -3
  19. package/skills/erp-kit-app-7-impl-review/references/module-wiring-parity.md +14 -8
  20. package/skills/erp-kit-app-shared/references/progress-protocol.md +77 -0
  21. package/skills/erp-kit-mock-scenario/SKILL.md +1 -1
  22. package/skills/erp-kit-module-1-requirements/SKILL.md +1 -1
  23. package/skills/erp-kit-module-3-plan/SKILL.md +3 -3
  24. package/skills/erp-kit-module-3-update-plan/SKILL.md +3 -3
  25. package/skills/erp-kit-module-5-impl/SKILL.md +1 -1
  26. package/skills/erp-kit-module-6-impl-review/SKILL.md +16 -19
  27. package/skills/erp-kit-module-shared/references/commands.md +68 -1
  28. package/src/commands/app/index.ts +2 -0
  29. package/src/commands/app/progress/git-context.ts +16 -0
  30. package/src/commands/app/progress/index.ts +45 -0
  31. package/src/commands/app/progress/log.ts +49 -0
  32. package/src/commands/app/progress/progress.test.ts +128 -0
  33. package/src/commands/app/progress/schema-cmd.ts +10 -0
  34. package/src/commands/check.test.ts +4 -4
  35. package/src/commands/index.ts +8 -2
  36. package/src/commands/init.test.ts +24 -8
  37. package/src/commands/init.ts +5 -12
  38. package/src/commands/lib/discovery.test.ts +5 -7
  39. package/src/commands/lib/discovery.ts +8 -8
  40. package/src/commands/lib/distribute.test.ts +1 -20
  41. package/src/commands/lib/distribute.ts +0 -14
  42. package/src/commands/lib/sync-check-source.test.ts +1 -1
  43. package/src/commands/lib/sync-check-source.ts +6 -1
  44. package/src/commands/lib/sync-check-tests.test.ts +43 -0
  45. package/src/commands/lib/sync-check-tests.ts +20 -2
  46. package/src/commands/sync-check.ts +3 -0
  47. package/src/commands/update.test.ts +1 -1
  48. package/src/generator/generate-app-code.test.ts +0 -6
  49. package/src/generator/generate-app-code.ts +3 -13
  50. package/src/generator/generate-code.test.ts +10 -40
  51. package/src/generator/generate-code.ts +6 -12
  52. package/src/generator/scaffold.ts +25 -4
  53. package/src/generator/stub-templates.test.ts +0 -7
  54. package/src/generator/stub-templates.ts +0 -14
  55. package/src/module.ts +4 -1
  56. package/src/modules/accounting/README.md +63 -0
  57. package/src/modules/accounting/command/activateBudget.generated.ts +6 -0
  58. package/src/modules/accounting/command/activateBudget.test.ts +119 -0
  59. package/src/modules/accounting/command/activateBudget.ts +77 -0
  60. package/src/modules/accounting/command/activateCostElement.generated.ts +6 -0
  61. package/src/modules/accounting/command/activateCostElement.test.ts +59 -0
  62. package/src/modules/accounting/command/activateCostElement.ts +41 -0
  63. package/src/modules/accounting/command/activateProfitCenter.generated.ts +6 -0
  64. package/src/modules/accounting/command/activateProfitCenter.test.ts +60 -0
  65. package/src/modules/accounting/command/activateProfitCenter.ts +38 -0
  66. package/src/modules/accounting/command/approveBudget.generated.ts +6 -0
  67. package/src/modules/accounting/command/approveBudget.test.ts +69 -0
  68. package/src/modules/accounting/command/approveBudget.ts +47 -0
  69. package/src/modules/accounting/command/assignCostCenterToHierarchyNode.generated.ts +6 -0
  70. package/src/modules/accounting/command/assignCostCenterToHierarchyNode.test.ts +112 -0
  71. package/src/modules/accounting/command/assignCostCenterToHierarchyNode.ts +67 -0
  72. package/src/modules/accounting/command/assignProfitCenterToHierarchyNode.generated.ts +6 -0
  73. package/src/modules/accounting/command/assignProfitCenterToHierarchyNode.test.ts +123 -0
  74. package/src/modules/accounting/command/assignProfitCenterToHierarchyNode.ts +71 -0
  75. package/src/modules/accounting/command/closeBudget.generated.ts +6 -0
  76. package/src/modules/accounting/command/closeBudget.test.ts +93 -0
  77. package/src/modules/accounting/command/closeBudget.ts +40 -0
  78. package/src/modules/accounting/command/closeInternalOrder.generated.ts +6 -0
  79. package/src/modules/accounting/command/closeInternalOrder.test.ts +74 -0
  80. package/src/modules/accounting/command/closeInternalOrder.ts +38 -0
  81. package/src/modules/accounting/command/consumeCommitment.generated.ts +6 -0
  82. package/src/modules/accounting/command/consumeCommitment.test.ts +123 -0
  83. package/src/modules/accounting/command/consumeCommitment.ts +62 -0
  84. package/src/modules/accounting/command/createAllocationCycle.generated.ts +6 -0
  85. package/src/modules/accounting/command/createAllocationCycle.test.ts +166 -0
  86. package/src/modules/accounting/command/createAllocationCycle.ts +68 -0
  87. package/src/modules/accounting/command/createAllocationRule.generated.ts +6 -0
  88. package/src/modules/accounting/command/createAllocationRule.test.ts +195 -0
  89. package/src/modules/accounting/command/createAllocationRule.ts +103 -0
  90. package/src/modules/accounting/command/createBudget.generated.ts +6 -0
  91. package/src/modules/accounting/command/createBudget.test.ts +159 -0
  92. package/src/modules/accounting/command/createBudget.ts +100 -0
  93. package/src/modules/accounting/command/createBudgetLineItem.generated.ts +6 -0
  94. package/src/modules/accounting/command/createBudgetLineItem.test.ts +178 -0
  95. package/src/modules/accounting/command/createBudgetLineItem.ts +104 -0
  96. package/src/modules/accounting/command/createCostCenter.generated.ts +6 -0
  97. package/src/modules/accounting/command/createCostCenter.test.ts +179 -0
  98. package/src/modules/accounting/command/createCostCenter.ts +112 -0
  99. package/src/modules/accounting/command/createCostCenterHierarchy.generated.ts +6 -0
  100. package/src/modules/accounting/command/createCostCenterHierarchy.test.ts +91 -0
  101. package/src/modules/accounting/command/createCostCenterHierarchy.ts +48 -0
  102. package/src/modules/accounting/command/createCostCenterHierarchyNode.generated.ts +6 -0
  103. package/src/modules/accounting/command/createCostCenterHierarchyNode.test.ts +171 -0
  104. package/src/modules/accounting/command/createCostCenterHierarchyNode.ts +117 -0
  105. package/src/modules/accounting/command/createCostElement.generated.ts +6 -0
  106. package/src/modules/accounting/command/createCostElement.test.ts +317 -0
  107. package/src/modules/accounting/command/createCostElement.ts +149 -0
  108. package/src/modules/accounting/command/createInternalOrder.generated.ts +6 -0
  109. package/src/modules/accounting/command/createInternalOrder.test.ts +206 -0
  110. package/src/modules/accounting/command/createInternalOrder.ts +104 -0
  111. package/src/modules/accounting/command/createPlanVersion.generated.ts +6 -0
  112. package/src/modules/accounting/command/createPlanVersion.test.ts +230 -0
  113. package/src/modules/accounting/command/createPlanVersion.ts +71 -0
  114. package/src/modules/accounting/command/createProfitCenter.generated.ts +6 -0
  115. package/src/modules/accounting/command/createProfitCenter.test.ts +227 -0
  116. package/src/modules/accounting/command/createProfitCenter.ts +81 -0
  117. package/src/modules/accounting/command/createProfitCenterHierarchy.generated.ts +6 -0
  118. package/src/modules/accounting/command/createProfitCenterHierarchy.test.ts +91 -0
  119. package/src/modules/accounting/command/createProfitCenterHierarchy.ts +46 -0
  120. package/src/modules/accounting/command/createProfitCenterHierarchyNode.generated.ts +6 -0
  121. package/src/modules/accounting/command/createProfitCenterHierarchyNode.test.ts +160 -0
  122. package/src/modules/accounting/command/createProfitCenterHierarchyNode.ts +109 -0
  123. package/src/modules/accounting/command/deactivateCostElement.generated.ts +6 -0
  124. package/src/modules/accounting/command/deactivateCostElement.test.ts +59 -0
  125. package/src/modules/accounting/command/deactivateCostElement.ts +41 -0
  126. package/src/modules/accounting/command/deactivateProfitCenter.generated.ts +6 -0
  127. package/src/modules/accounting/command/deactivateProfitCenter.test.ts +60 -0
  128. package/src/modules/accounting/command/deactivateProfitCenter.ts +42 -0
  129. package/src/modules/accounting/command/deleteAllocationCycle.generated.ts +6 -0
  130. package/src/modules/accounting/command/deleteAllocationCycle.test.ts +90 -0
  131. package/src/modules/accounting/command/deleteAllocationCycle.ts +39 -0
  132. package/src/modules/accounting/command/deleteAllocationRule.generated.ts +6 -0
  133. package/src/modules/accounting/command/deleteAllocationRule.test.ts +98 -0
  134. package/src/modules/accounting/command/deleteAllocationRule.ts +40 -0
  135. package/src/modules/accounting/command/deleteBudget.generated.ts +6 -0
  136. package/src/modules/accounting/command/deleteBudget.test.ts +90 -0
  137. package/src/modules/accounting/command/deleteBudget.ts +35 -0
  138. package/src/modules/accounting/command/deleteBudgetLineItem.generated.ts +6 -0
  139. package/src/modules/accounting/command/deleteBudgetLineItem.test.ts +85 -0
  140. package/src/modules/accounting/command/deleteBudgetLineItem.ts +50 -0
  141. package/src/modules/accounting/command/deleteCostCenter.generated.ts +6 -0
  142. package/src/modules/accounting/command/deleteCostCenter.test.ts +79 -0
  143. package/src/modules/accounting/command/deleteCostCenter.ts +67 -0
  144. package/src/modules/accounting/command/deleteCostCenterHierarchyNode.generated.ts +6 -0
  145. package/src/modules/accounting/command/deleteCostCenterHierarchyNode.test.ts +59 -0
  146. package/src/modules/accounting/command/deleteCostCenterHierarchyNode.ts +58 -0
  147. package/src/modules/accounting/command/deleteCostElement.generated.ts +6 -0
  148. package/src/modules/accounting/command/deleteCostElement.test.ts +58 -0
  149. package/src/modules/accounting/command/deleteCostElement.ts +33 -0
  150. package/src/modules/accounting/command/deleteInternalOrder.generated.ts +6 -0
  151. package/src/modules/accounting/command/deleteInternalOrder.test.ts +81 -0
  152. package/src/modules/accounting/command/deleteInternalOrder.ts +37 -0
  153. package/src/modules/accounting/command/deleteProfitCenter.generated.ts +6 -0
  154. package/src/modules/accounting/command/deleteProfitCenter.test.ts +68 -0
  155. package/src/modules/accounting/command/deleteProfitCenter.ts +39 -0
  156. package/src/modules/accounting/command/deleteProfitCenterHierarchyNode.generated.ts +6 -0
  157. package/src/modules/accounting/command/deleteProfitCenterHierarchyNode.test.ts +72 -0
  158. package/src/modules/accounting/command/deleteProfitCenterHierarchyNode.ts +61 -0
  159. package/src/modules/accounting/command/executeAllocationCycle.generated.ts +6 -0
  160. package/src/modules/accounting/command/executeAllocationCycle.test.ts +167 -0
  161. package/src/modules/accounting/command/executeAllocationCycle.ts +94 -0
  162. package/src/modules/accounting/command/finalizeVarianceReport.generated.ts +6 -0
  163. package/src/modules/accounting/command/finalizeVarianceReport.test.ts +60 -0
  164. package/src/modules/accounting/command/finalizeVarianceReport.ts +45 -0
  165. package/src/modules/accounting/command/generateVarianceReport.generated.ts +6 -0
  166. package/src/modules/accounting/command/generateVarianceReport.test.ts +386 -0
  167. package/src/modules/accounting/command/generateVarianceReport.ts +219 -0
  168. package/src/modules/accounting/command/invalidateAllocationCycle.generated.ts +6 -0
  169. package/src/modules/accounting/command/invalidateAllocationCycle.test.ts +84 -0
  170. package/src/modules/accounting/command/invalidateAllocationCycle.ts +45 -0
  171. package/src/modules/accounting/command/moveCostCenterHierarchyNode.generated.ts +6 -0
  172. package/src/modules/accounting/command/moveCostCenterHierarchyNode.test.ts +135 -0
  173. package/src/modules/accounting/command/moveCostCenterHierarchyNode.ts +81 -0
  174. package/src/modules/accounting/command/postAllocationCycle.generated.ts +6 -0
  175. package/src/modules/accounting/command/postAllocationCycle.test.ts +98 -0
  176. package/src/modules/accounting/command/postAllocationCycle.ts +65 -0
  177. package/src/modules/accounting/command/reactivateCostElement.generated.ts +6 -0
  178. package/src/modules/accounting/command/reactivateCostElement.test.ts +59 -0
  179. package/src/modules/accounting/command/reactivateCostElement.ts +41 -0
  180. package/src/modules/accounting/command/reactivateProfitCenter.generated.ts +6 -0
  181. package/src/modules/accounting/command/reactivateProfitCenter.test.ts +60 -0
  182. package/src/modules/accounting/command/reactivateProfitCenter.ts +42 -0
  183. package/src/modules/accounting/command/recordCommitment.generated.ts +6 -0
  184. package/src/modules/accounting/command/recordCommitment.test.ts +157 -0
  185. package/src/modules/accounting/command/recordCommitment.ts +113 -0
  186. package/src/modules/accounting/command/rejectBudget.generated.ts +6 -0
  187. package/src/modules/accounting/command/rejectBudget.test.ts +105 -0
  188. package/src/modules/accounting/command/rejectBudget.ts +51 -0
  189. package/src/modules/accounting/command/releaseCommitment.generated.ts +6 -0
  190. package/src/modules/accounting/command/releaseCommitment.test.ts +94 -0
  191. package/src/modules/accounting/command/releaseCommitment.ts +51 -0
  192. package/src/modules/accounting/command/releaseInternalOrder.generated.ts +6 -0
  193. package/src/modules/accounting/command/releaseInternalOrder.test.ts +74 -0
  194. package/src/modules/accounting/command/releaseInternalOrder.ts +38 -0
  195. package/src/modules/accounting/command/reverseAllocationCycle.generated.ts +6 -0
  196. package/src/modules/accounting/command/reverseAllocationCycle.test.ts +124 -0
  197. package/src/modules/accounting/command/reverseAllocationCycle.ts +63 -0
  198. package/src/modules/accounting/command/submitBudget.generated.ts +6 -0
  199. package/src/modules/accounting/command/submitBudget.test.ts +60 -0
  200. package/src/modules/accounting/command/submitBudget.ts +51 -0
  201. package/src/modules/accounting/command/technicallyCompleteInternalOrder.generated.ts +6 -0
  202. package/src/modules/accounting/command/technicallyCompleteInternalOrder.test.ts +74 -0
  203. package/src/modules/accounting/command/technicallyCompleteInternalOrder.ts +42 -0
  204. package/src/modules/accounting/command/updateAllocationCycle.generated.ts +6 -0
  205. package/src/modules/accounting/command/updateAllocationCycle.test.ts +112 -0
  206. package/src/modules/accounting/command/updateAllocationCycle.ts +41 -0
  207. package/src/modules/accounting/command/updateBudget.generated.ts +6 -0
  208. package/src/modules/accounting/command/updateBudget.test.ts +112 -0
  209. package/src/modules/accounting/command/updateBudget.ts +44 -0
  210. package/src/modules/accounting/command/updateCostCenter.generated.ts +6 -0
  211. package/src/modules/accounting/command/updateCostCenter.test.ts +105 -0
  212. package/src/modules/accounting/command/updateCostCenter.ts +79 -0
  213. package/src/modules/accounting/command/updateCostElement.generated.ts +6 -0
  214. package/src/modules/accounting/command/updateCostElement.test.ts +265 -0
  215. package/src/modules/accounting/command/updateCostElement.ts +158 -0
  216. package/src/modules/accounting/command/updateInternalOrder.generated.ts +6 -0
  217. package/src/modules/accounting/command/updateInternalOrder.test.ts +209 -0
  218. package/src/modules/accounting/command/updateInternalOrder.ts +88 -0
  219. package/src/modules/accounting/command/updateProfitCenter.generated.ts +6 -0
  220. package/src/modules/accounting/command/updateProfitCenter.test.ts +162 -0
  221. package/src/modules/accounting/command/updateProfitCenter.ts +73 -0
  222. package/src/modules/accounting/command/validateAllocationCycle.generated.ts +6 -0
  223. package/src/modules/accounting/command/validateAllocationCycle.test.ts +141 -0
  224. package/src/modules/accounting/command/validateAllocationCycle.ts +80 -0
  225. package/src/modules/accounting/db/allocationCycle.ts +59 -0
  226. package/src/modules/accounting/db/allocationResult.ts +58 -0
  227. package/src/modules/accounting/db/allocationRule.ts +48 -0
  228. package/src/modules/accounting/db/budget.ts +84 -0
  229. package/src/modules/accounting/db/budgetLineItem.ts +64 -0
  230. package/src/modules/accounting/db/commitment.ts +60 -0
  231. package/src/modules/accounting/db/costCenter.ts +73 -0
  232. package/src/modules/accounting/db/costCenterHierarchy.ts +37 -0
  233. package/src/modules/accounting/db/costCenterHierarchyNode.ts +48 -0
  234. package/src/modules/accounting/db/costElement.ts +56 -0
  235. package/src/modules/accounting/db/internalOrder.ts +69 -0
  236. package/src/modules/accounting/db/planVersion.ts +47 -0
  237. package/src/modules/accounting/db/profitCenter.ts +52 -0
  238. package/src/modules/accounting/db/profitCenterHierarchy.ts +36 -0
  239. package/src/modules/accounting/db/profitCenterHierarchyAssignment.ts +62 -0
  240. package/src/modules/accounting/db/profitCenterHierarchyNode.ts +48 -0
  241. package/src/modules/accounting/db/varianceReport.ts +54 -0
  242. package/src/modules/accounting/db/varianceReportLine.ts +62 -0
  243. package/src/modules/accounting/docs/commands/ActivateBudget.md +54 -0
  244. package/src/modules/accounting/docs/commands/ActivateCostElement.md +43 -0
  245. package/src/modules/accounting/docs/commands/ActivateProfitCenter.md +43 -0
  246. package/src/modules/accounting/docs/commands/ApproveBudget.md +46 -0
  247. package/src/modules/accounting/docs/commands/AssignCostCenterToHierarchyNode.md +46 -0
  248. package/src/modules/accounting/docs/commands/AssignProfitCenterToHierarchyNode.md +47 -0
  249. package/src/modules/accounting/docs/commands/CloseBudget.md +47 -0
  250. package/src/modules/accounting/docs/commands/CloseInternalOrder.md +45 -0
  251. package/src/modules/accounting/docs/commands/ConsumeCommitment.md +53 -0
  252. package/src/modules/accounting/docs/commands/CreateAllocationCycle.md +55 -0
  253. package/src/modules/accounting/docs/commands/CreateAllocationRule.md +60 -0
  254. package/src/modules/accounting/docs/commands/CreateBudget.md +65 -0
  255. package/src/modules/accounting/docs/commands/CreateBudgetLineItem.md +66 -0
  256. package/src/modules/accounting/docs/commands/CreateCostCenter.md +64 -0
  257. package/src/modules/accounting/docs/commands/CreateCostCenterHierarchy.md +45 -0
  258. package/src/modules/accounting/docs/commands/CreateCostCenterHierarchyNode.md +61 -0
  259. package/src/modules/accounting/docs/commands/CreateCostElement.md +91 -0
  260. package/src/modules/accounting/docs/commands/CreateInternalOrder.md +72 -0
  261. package/src/modules/accounting/docs/commands/CreatePlanVersion.md +59 -0
  262. package/src/modules/accounting/docs/commands/CreateProfitCenter.md +63 -0
  263. package/src/modules/accounting/docs/commands/CreateProfitCenterHierarchy.md +45 -0
  264. package/src/modules/accounting/docs/commands/CreateProfitCenterHierarchyNode.md +60 -0
  265. package/src/modules/accounting/docs/commands/DeactivateCostElement.md +43 -0
  266. package/src/modules/accounting/docs/commands/DeactivateProfitCenter.md +44 -0
  267. package/src/modules/accounting/docs/commands/DeleteAllocationCycle.md +46 -0
  268. package/src/modules/accounting/docs/commands/DeleteAllocationRule.md +45 -0
  269. package/src/modules/accounting/docs/commands/DeleteBudget.md +46 -0
  270. package/src/modules/accounting/docs/commands/DeleteBudgetLineItem.md +45 -0
  271. package/src/modules/accounting/docs/commands/DeleteCostCenter.md +50 -0
  272. package/src/modules/accounting/docs/commands/DeleteCostCenterHierarchyNode.md +45 -0
  273. package/src/modules/accounting/docs/commands/DeleteCostElement.md +43 -0
  274. package/src/modules/accounting/docs/commands/DeleteInternalOrder.md +45 -0
  275. package/src/modules/accounting/docs/commands/DeleteProfitCenter.md +46 -0
  276. package/src/modules/accounting/docs/commands/DeleteProfitCenterHierarchyNode.md +46 -0
  277. package/src/modules/accounting/docs/commands/ExecuteAllocationCycle.md +54 -0
  278. package/src/modules/accounting/docs/commands/FinalizeVarianceReport.md +44 -0
  279. package/src/modules/accounting/docs/commands/GenerateVarianceReport.md +83 -0
  280. package/src/modules/accounting/docs/commands/InvalidateAllocationCycle.md +45 -0
  281. package/src/modules/accounting/docs/commands/MoveCostCenterHierarchyNode.md +51 -0
  282. package/src/modules/accounting/docs/commands/PostAllocationCycle.md +58 -0
  283. package/src/modules/accounting/docs/commands/ReactivateCostElement.md +43 -0
  284. package/src/modules/accounting/docs/commands/ReactivateProfitCenter.md +43 -0
  285. package/src/modules/accounting/docs/commands/RecordCommitment.md +60 -0
  286. package/src/modules/accounting/docs/commands/RejectBudget.md +49 -0
  287. package/src/modules/accounting/docs/commands/ReleaseCommitment.md +45 -0
  288. package/src/modules/accounting/docs/commands/ReleaseInternalOrder.md +44 -0
  289. package/src/modules/accounting/docs/commands/ReverseAllocationCycle.md +55 -0
  290. package/src/modules/accounting/docs/commands/SubmitBudget.md +47 -0
  291. package/src/modules/accounting/docs/commands/TechnicallyCompleteInternalOrder.md +44 -0
  292. package/src/modules/accounting/docs/commands/UpdateAllocationCycle.md +45 -0
  293. package/src/modules/accounting/docs/commands/UpdateBudget.md +47 -0
  294. package/src/modules/accounting/docs/commands/UpdateCostCenter.md +50 -0
  295. package/src/modules/accounting/docs/commands/UpdateCostElement.md +82 -0
  296. package/src/modules/accounting/docs/commands/UpdateInternalOrder.md +62 -0
  297. package/src/modules/accounting/docs/commands/UpdateProfitCenter.md +56 -0
  298. package/src/modules/accounting/docs/commands/ValidateAllocationCycle.md +57 -0
  299. package/src/modules/accounting/docs/features/budget-management.md +147 -0
  300. package/src/modules/accounting/docs/features/cost-allocation.md +129 -0
  301. package/src/modules/accounting/docs/features/cost-center-management.md +118 -0
  302. package/src/modules/accounting/docs/features/cost-element-management.md +114 -0
  303. package/src/modules/accounting/docs/features/internal-order-management.md +111 -0
  304. package/src/modules/accounting/docs/features/profit-center-management.md +120 -0
  305. package/src/modules/accounting/docs/features/variance-analysis.md +130 -0
  306. package/src/modules/accounting/docs/models/AllocationCycle.md +81 -0
  307. package/src/modules/accounting/docs/models/AllocationResult.md +37 -0
  308. package/src/modules/accounting/docs/models/AllocationRule.md +41 -0
  309. package/src/modules/accounting/docs/models/Budget.md +77 -0
  310. package/src/modules/accounting/docs/models/BudgetLineItem.md +40 -0
  311. package/src/modules/accounting/docs/models/Commitment.md +45 -0
  312. package/src/modules/accounting/docs/models/CostCenter.md +51 -0
  313. package/src/modules/accounting/docs/models/CostCenterHierarchy.md +38 -0
  314. package/src/modules/accounting/docs/models/CostCenterHierarchyNode.md +41 -0
  315. package/src/modules/accounting/docs/models/CostElement.md +66 -0
  316. package/src/modules/accounting/docs/models/InternalOrder.md +67 -0
  317. package/src/modules/accounting/docs/models/PlanVersion.md +36 -0
  318. package/src/modules/accounting/docs/models/ProfitCenter.md +66 -0
  319. package/src/modules/accounting/docs/models/ProfitCenterHierarchy.md +36 -0
  320. package/src/modules/accounting/docs/models/ProfitCenterHierarchyAssignment.md +36 -0
  321. package/src/modules/accounting/docs/models/ProfitCenterHierarchyNode.md +39 -0
  322. package/src/modules/accounting/docs/models/VarianceReport.md +58 -0
  323. package/src/modules/accounting/docs/models/VarianceReportLine.md +43 -0
  324. package/src/modules/accounting/docs/queries/CalculateBudgetAvailability.md +64 -0
  325. package/src/modules/accounting/docs/queries/GetAllocationCycle.md +43 -0
  326. package/src/modules/accounting/docs/queries/GetBudget.md +42 -0
  327. package/src/modules/accounting/docs/queries/GetCostCenter.md +38 -0
  328. package/src/modules/accounting/docs/queries/GetCostCenterHierarchy.md +45 -0
  329. package/src/modules/accounting/docs/queries/GetCostElement.md +39 -0
  330. package/src/modules/accounting/docs/queries/GetInternalOrder.md +42 -0
  331. package/src/modules/accounting/docs/queries/GetProfitCenter.md +38 -0
  332. package/src/modules/accounting/docs/queries/GetProfitCenterHierarchy.md +46 -0
  333. package/src/modules/accounting/docs/queries/GetVarianceReport.md +45 -0
  334. package/src/modules/accounting/docs/queries/ListAllocationCycles.md +63 -0
  335. package/src/modules/accounting/docs/queries/ListBudgets.md +70 -0
  336. package/src/modules/accounting/docs/queries/ListCostCenters.md +55 -0
  337. package/src/modules/accounting/docs/queries/ListCostElements.md +63 -0
  338. package/src/modules/accounting/docs/queries/ListInternalOrders.md +62 -0
  339. package/src/modules/accounting/docs/queries/ListProfitCenters.md +49 -0
  340. package/src/modules/accounting/generated/enums.ts +110 -0
  341. package/src/modules/accounting/generated/kysely-tailordb.ts +302 -0
  342. package/src/modules/accounting/index.ts +2 -0
  343. package/src/modules/accounting/lib/_db_deps.ts +70 -0
  344. package/src/modules/accounting/lib/actualAmounts.ts +93 -0
  345. package/src/modules/accounting/lib/allocationPosting.ts +152 -0
  346. package/src/modules/accounting/lib/errors.generated.ts +432 -0
  347. package/src/modules/accounting/lib/permissions.generated.ts +61 -0
  348. package/src/modules/accounting/lib/types.ts +114 -0
  349. package/src/modules/accounting/module.ts +428 -0
  350. package/src/modules/accounting/permissions.ts +3 -0
  351. package/src/modules/accounting/query/calculateBudgetAvailability.generated.ts +5 -0
  352. package/src/modules/accounting/query/calculateBudgetAvailability.test.ts +229 -0
  353. package/src/modules/accounting/query/calculateBudgetAvailability.ts +147 -0
  354. package/src/modules/accounting/query/getAllocationCycle.generated.ts +5 -0
  355. package/src/modules/accounting/query/getAllocationCycle.test.ts +94 -0
  356. package/src/modules/accounting/query/getAllocationCycle.ts +37 -0
  357. package/src/modules/accounting/query/getBudget.generated.ts +5 -0
  358. package/src/modules/accounting/query/getBudget.test.ts +80 -0
  359. package/src/modules/accounting/query/getBudget.ts +31 -0
  360. package/src/modules/accounting/query/getCostCenter.generated.ts +5 -0
  361. package/src/modules/accounting/query/getCostCenter.test.ts +50 -0
  362. package/src/modules/accounting/query/getCostCenter.ts +33 -0
  363. package/src/modules/accounting/query/getCostCenterHierarchy.generated.ts +5 -0
  364. package/src/modules/accounting/query/getCostCenterHierarchy.test.ts +100 -0
  365. package/src/modules/accounting/query/getCostCenterHierarchy.ts +80 -0
  366. package/src/modules/accounting/query/getCostElement.generated.ts +5 -0
  367. package/src/modules/accounting/query/getCostElement.test.ts +57 -0
  368. package/src/modules/accounting/query/getCostElement.ts +21 -0
  369. package/src/modules/accounting/query/getInternalOrder.generated.ts +5 -0
  370. package/src/modules/accounting/query/getInternalOrder.test.ts +73 -0
  371. package/src/modules/accounting/query/getInternalOrder.ts +21 -0
  372. package/src/modules/accounting/query/getProfitCenter.generated.ts +5 -0
  373. package/src/modules/accounting/query/getProfitCenter.test.ts +65 -0
  374. package/src/modules/accounting/query/getProfitCenter.ts +31 -0
  375. package/src/modules/accounting/query/getProfitCenterHierarchy.generated.ts +5 -0
  376. package/src/modules/accounting/query/getProfitCenterHierarchy.test.ts +97 -0
  377. package/src/modules/accounting/query/getProfitCenterHierarchy.ts +87 -0
  378. package/src/modules/accounting/query/getVarianceReport.generated.ts +5 -0
  379. package/src/modules/accounting/query/getVarianceReport.test.ts +108 -0
  380. package/src/modules/accounting/query/getVarianceReport.ts +31 -0
  381. package/src/modules/accounting/query/listAllocationCycles.generated.ts +5 -0
  382. package/src/modules/accounting/query/listAllocationCycles.test.ts +152 -0
  383. package/src/modules/accounting/query/listAllocationCycles.ts +96 -0
  384. package/src/modules/accounting/query/listBudgets.generated.ts +5 -0
  385. package/src/modules/accounting/query/listBudgets.test.ts +150 -0
  386. package/src/modules/accounting/query/listBudgets.ts +85 -0
  387. package/src/modules/accounting/query/listCostCenters.generated.ts +5 -0
  388. package/src/modules/accounting/query/listCostCenters.test.ts +111 -0
  389. package/src/modules/accounting/query/listCostCenters.ts +71 -0
  390. package/src/modules/accounting/query/listCostElements.generated.ts +5 -0
  391. package/src/modules/accounting/query/listCostElements.test.ts +138 -0
  392. package/src/modules/accounting/query/listCostElements.ts +105 -0
  393. package/src/modules/accounting/query/listInternalOrders.generated.ts +5 -0
  394. package/src/modules/accounting/query/listInternalOrders.test.ts +129 -0
  395. package/src/modules/accounting/query/listInternalOrders.ts +94 -0
  396. package/src/modules/accounting/query/listProfitCenters.generated.ts +5 -0
  397. package/src/modules/accounting/query/listProfitCenters.test.ts +94 -0
  398. package/src/modules/accounting/query/listProfitCenters.ts +56 -0
  399. package/src/modules/accounting/seed/index.ts +19 -0
  400. package/src/modules/accounting/tailor.config.ts +13 -0
  401. package/src/modules/accounting/testing/commandTestUtils.ts +35 -0
  402. package/src/modules/accounting/testing/fixtures.ts +502 -0
  403. package/src/modules/audit/command/logAuditEvent.ts +43 -38
  404. package/src/modules/audit/command/updateAuditPolicy.ts +2 -2
  405. package/src/modules/audit/docs/commands/UpdateAuditPolicy.md +1 -1
  406. package/src/modules/audit/module.ts +4 -0
  407. package/src/modules/business-partner/command/updateContactPerson.ts +3 -4
  408. package/src/modules/business-partner/command/updatePartner.ts +13 -6
  409. package/src/modules/business-partner/command/updatePartnerAddress.ts +13 -6
  410. package/src/modules/business-partner/command/updatePartnerBankAccount.ts +3 -4
  411. package/src/modules/business-partner/command/updatePartnerIdentification.ts +3 -4
  412. package/src/modules/business-partner/docs/commands/UpdateContactPerson.md +3 -3
  413. package/src/modules/business-partner/docs/commands/UpdatePartner.md +2 -2
  414. package/src/modules/business-partner/docs/commands/UpdatePartnerAddress.md +2 -2
  415. package/src/modules/business-partner/docs/commands/UpdatePartnerIdentification.md +2 -2
  416. package/src/modules/coa-management/command/updateAccount.ts +3 -3
  417. package/src/modules/coa-management/command/updateAccountGroup.test.ts +22 -0
  418. package/src/modules/coa-management/command/updateAccountGroup.ts +30 -18
  419. package/src/modules/coa-management/command/updateChartOfAccounts.ts +3 -4
  420. package/src/modules/coa-management/docs/commands/UpdateAccountGroup.md +4 -3
  421. package/src/modules/finance-ledger/README.md +50 -0
  422. package/src/modules/finance-ledger/command/addJournalLine.generated.ts +6 -0
  423. package/src/modules/finance-ledger/command/addJournalLine.test.ts +438 -0
  424. package/src/modules/finance-ledger/command/addJournalLine.ts +122 -0
  425. package/src/modules/finance-ledger/command/approveAndLockPeriod.generated.ts +6 -0
  426. package/src/modules/finance-ledger/command/approveAndLockPeriod.test.ts +107 -0
  427. package/src/modules/finance-ledger/command/approveAndLockPeriod.ts +72 -0
  428. package/src/modules/finance-ledger/command/beginClose.generated.ts +6 -0
  429. package/src/modules/finance-ledger/command/beginClose.test.ts +106 -0
  430. package/src/modules/finance-ledger/command/beginClose.ts +58 -0
  431. package/src/modules/finance-ledger/command/closePeriod.generated.ts +6 -0
  432. package/src/modules/finance-ledger/command/closePeriod.test.ts +87 -0
  433. package/src/modules/finance-ledger/command/closePeriod.ts +44 -0
  434. package/src/modules/finance-ledger/command/createAccountingPeriod.generated.ts +6 -0
  435. package/src/modules/finance-ledger/command/createAccountingPeriod.test.ts +425 -0
  436. package/src/modules/finance-ledger/command/createAccountingPeriod.ts +133 -0
  437. package/src/modules/finance-ledger/command/createFiscalYear.generated.ts +6 -0
  438. package/src/modules/finance-ledger/command/createFiscalYear.test.ts +197 -0
  439. package/src/modules/finance-ledger/command/createFiscalYear.ts +70 -0
  440. package/src/modules/finance-ledger/command/createJournalEntry.generated.ts +6 -0
  441. package/src/modules/finance-ledger/command/createJournalEntry.test.ts +261 -0
  442. package/src/modules/finance-ledger/command/createJournalEntry.ts +121 -0
  443. package/src/modules/finance-ledger/command/deleteAccountingPeriod.generated.ts +6 -0
  444. package/src/modules/finance-ledger/command/deleteAccountingPeriod.test.ts +71 -0
  445. package/src/modules/finance-ledger/command/deleteAccountingPeriod.ts +55 -0
  446. package/src/modules/finance-ledger/command/deleteFiscalYear.generated.ts +6 -0
  447. package/src/modules/finance-ledger/command/deleteFiscalYear.test.ts +38 -0
  448. package/src/modules/finance-ledger/command/deleteFiscalYear.ts +34 -0
  449. package/src/modules/finance-ledger/command/deleteJournalEntry.generated.ts +6 -0
  450. package/src/modules/finance-ledger/command/deleteJournalEntry.test.ts +58 -0
  451. package/src/modules/finance-ledger/command/deleteJournalEntry.ts +43 -0
  452. package/src/modules/finance-ledger/command/executeYearEndClose.generated.ts +6 -0
  453. package/src/modules/finance-ledger/command/executeYearEndClose.test.ts +239 -0
  454. package/src/modules/finance-ledger/command/executeYearEndClose.ts +415 -0
  455. package/src/modules/finance-ledger/command/finalCloseAndLockPeriod.generated.ts +6 -0
  456. package/src/modules/finance-ledger/command/finalCloseAndLockPeriod.test.ts +102 -0
  457. package/src/modules/finance-ledger/command/finalCloseAndLockPeriod.ts +76 -0
  458. package/src/modules/finance-ledger/command/finalizeFinancialStatement.generated.ts +6 -0
  459. package/src/modules/finance-ledger/command/finalizeFinancialStatement.test.ts +73 -0
  460. package/src/modules/finance-ledger/command/finalizeFinancialStatement.ts +73 -0
  461. package/src/modules/finance-ledger/command/generateFinancialStatement.generated.ts +6 -0
  462. package/src/modules/finance-ledger/command/generateFinancialStatement.test.ts +311 -0
  463. package/src/modules/finance-ledger/command/generateFinancialStatement.ts +275 -0
  464. package/src/modules/finance-ledger/command/generatePreliminaryStatements.generated.ts +6 -0
  465. package/src/modules/finance-ledger/command/generatePreliminaryStatements.test.ts +152 -0
  466. package/src/modules/finance-ledger/command/generatePreliminaryStatements.ts +140 -0
  467. package/src/modules/finance-ledger/command/generateTrialBalance.generated.ts +6 -0
  468. package/src/modules/finance-ledger/command/generateTrialBalance.test.ts +439 -0
  469. package/src/modules/finance-ledger/command/generateTrialBalance.ts +268 -0
  470. package/src/modules/finance-ledger/command/initiatePeriodClose.generated.ts +6 -0
  471. package/src/modules/finance-ledger/command/initiatePeriodClose.test.ts +153 -0
  472. package/src/modules/finance-ledger/command/initiatePeriodClose.ts +84 -0
  473. package/src/modules/finance-ledger/command/openForAdvanceEntry.generated.ts +6 -0
  474. package/src/modules/finance-ledger/command/openForAdvanceEntry.test.ts +87 -0
  475. package/src/modules/finance-ledger/command/openForAdvanceEntry.ts +44 -0
  476. package/src/modules/finance-ledger/command/openPeriod.generated.ts +6 -0
  477. package/src/modules/finance-ledger/command/openPeriod.test.ts +90 -0
  478. package/src/modules/finance-ledger/command/openPeriod.ts +44 -0
  479. package/src/modules/finance-ledger/command/permanentlyClosePeriod.generated.ts +6 -0
  480. package/src/modules/finance-ledger/command/permanentlyClosePeriod.test.ts +87 -0
  481. package/src/modules/finance-ledger/command/permanentlyClosePeriod.ts +48 -0
  482. package/src/modules/finance-ledger/command/postAdjustingEntries.generated.ts +6 -0
  483. package/src/modules/finance-ledger/command/postAdjustingEntries.test.ts +392 -0
  484. package/src/modules/finance-ledger/command/postAdjustingEntries.ts +156 -0
  485. package/src/modules/finance-ledger/command/postJournalEntry.generated.ts +6 -0
  486. package/src/modules/finance-ledger/command/postJournalEntry.test.ts +346 -0
  487. package/src/modules/finance-ledger/command/postJournalEntry.ts +160 -0
  488. package/src/modules/finance-ledger/command/processInventoryHandoff.generated.ts +6 -0
  489. package/src/modules/finance-ledger/command/processInventoryHandoff.test.ts +211 -0
  490. package/src/modules/finance-ledger/command/processInventoryHandoff.ts +133 -0
  491. package/src/modules/finance-ledger/command/processManufacturingHandoff.generated.ts +6 -0
  492. package/src/modules/finance-ledger/command/processManufacturingHandoff.test.ts +221 -0
  493. package/src/modules/finance-ledger/command/processManufacturingHandoff.ts +133 -0
  494. package/src/modules/finance-ledger/command/processPurchaseHandoff.generated.ts +6 -0
  495. package/src/modules/finance-ledger/command/processPurchaseHandoff.test.ts +222 -0
  496. package/src/modules/finance-ledger/command/processPurchaseHandoff.ts +133 -0
  497. package/src/modules/finance-ledger/command/processSalesHandoff.generated.ts +6 -0
  498. package/src/modules/finance-ledger/command/processSalesHandoff.test.ts +257 -0
  499. package/src/modules/finance-ledger/command/processSalesHandoff.ts +135 -0
  500. package/src/modules/finance-ledger/command/regenerateFinancialStatement.generated.ts +6 -0
  501. package/src/modules/finance-ledger/command/regenerateFinancialStatement.test.ts +129 -0
  502. package/src/modules/finance-ledger/command/regenerateFinancialStatement.ts +186 -0
  503. package/src/modules/finance-ledger/command/removeJournalLine.generated.ts +6 -0
  504. package/src/modules/finance-ledger/command/removeJournalLine.test.ts +65 -0
  505. package/src/modules/finance-ledger/command/removeJournalLine.ts +39 -0
  506. package/src/modules/finance-ledger/command/reopenPeriod.generated.ts +6 -0
  507. package/src/modules/finance-ledger/command/reopenPeriod.test.ts +87 -0
  508. package/src/modules/finance-ledger/command/reopenPeriod.ts +44 -0
  509. package/src/modules/finance-ledger/command/reverseJournalEntry.generated.ts +6 -0
  510. package/src/modules/finance-ledger/command/reverseJournalEntry.test.ts +337 -0
  511. package/src/modules/finance-ledger/command/reverseJournalEntry.ts +140 -0
  512. package/src/modules/finance-ledger/command/revertSoftLock.generated.ts +6 -0
  513. package/src/modules/finance-ledger/command/revertSoftLock.test.ts +96 -0
  514. package/src/modules/finance-ledger/command/revertSoftLock.ts +67 -0
  515. package/src/modules/finance-ledger/command/updateFiscalYear.generated.ts +6 -0
  516. package/src/modules/finance-ledger/command/updateFiscalYear.test.ts +138 -0
  517. package/src/modules/finance-ledger/command/updateFiscalYear.ts +84 -0
  518. package/src/modules/finance-ledger/command/updateJournalEntry.generated.ts +6 -0
  519. package/src/modules/finance-ledger/command/updateJournalEntry.test.ts +178 -0
  520. package/src/modules/finance-ledger/command/updateJournalEntry.ts +78 -0
  521. package/src/modules/finance-ledger/command/updateJournalLine.generated.ts +6 -0
  522. package/src/modules/finance-ledger/command/updateJournalLine.test.ts +385 -0
  523. package/src/modules/finance-ledger/command/updateJournalLine.ts +154 -0
  524. package/src/modules/finance-ledger/command/verifySubledgerTransfers.generated.ts +6 -0
  525. package/src/modules/finance-ledger/command/verifySubledgerTransfers.test.ts +201 -0
  526. package/src/modules/finance-ledger/command/verifySubledgerTransfers.ts +113 -0
  527. package/src/modules/finance-ledger/command/verifyTrialBalance.generated.ts +6 -0
  528. package/src/modules/finance-ledger/command/verifyTrialBalance.test.ts +136 -0
  529. package/src/modules/finance-ledger/command/verifyTrialBalance.ts +97 -0
  530. package/src/modules/finance-ledger/db/accountingPeriod.ts +58 -0
  531. package/src/modules/finance-ledger/db/financialStatement.ts +92 -0
  532. package/src/modules/finance-ledger/db/financialStatementLineItem.ts +76 -0
  533. package/src/modules/finance-ledger/db/fiscalYear.ts +41 -0
  534. package/src/modules/finance-ledger/db/journalEntry.ts +101 -0
  535. package/src/modules/finance-ledger/db/journalLine.ts +64 -0
  536. package/src/modules/finance-ledger/db/periodClose.ts +97 -0
  537. package/src/modules/finance-ledger/db/trialBalance.ts +63 -0
  538. package/src/modules/finance-ledger/db/trialBalanceLine.ts +63 -0
  539. package/src/modules/finance-ledger/docs/commands/AddJournalLine.md +74 -0
  540. package/src/modules/finance-ledger/docs/commands/ApproveAndLockPeriod.md +53 -0
  541. package/src/modules/finance-ledger/docs/commands/BeginClose.md +47 -0
  542. package/src/modules/finance-ledger/docs/commands/ClosePeriod.md +45 -0
  543. package/src/modules/finance-ledger/docs/commands/CreateAccountingPeriod.md +69 -0
  544. package/src/modules/finance-ledger/docs/commands/CreateFiscalYear.md +56 -0
  545. package/src/modules/finance-ledger/docs/commands/CreateJournalEntry.md +63 -0
  546. package/src/modules/finance-ledger/docs/commands/DeleteAccountingPeriod.md +46 -0
  547. package/src/modules/finance-ledger/docs/commands/DeleteFiscalYear.md +40 -0
  548. package/src/modules/finance-ledger/docs/commands/DeleteJournalEntry.md +44 -0
  549. package/src/modules/finance-ledger/docs/commands/ExecuteYearEndClose.md +81 -0
  550. package/src/modules/finance-ledger/docs/commands/FinalCloseAndLockPeriod.md +49 -0
  551. package/src/modules/finance-ledger/docs/commands/FinalizeFinancialStatement.md +43 -0
  552. package/src/modules/finance-ledger/docs/commands/GenerateFinancialStatement.md +86 -0
  553. package/src/modules/finance-ledger/docs/commands/GeneratePreliminaryStatements.md +53 -0
  554. package/src/modules/finance-ledger/docs/commands/GenerateTrialBalance.md +75 -0
  555. package/src/modules/finance-ledger/docs/commands/InitiatePeriodClose.md +58 -0
  556. package/src/modules/finance-ledger/docs/commands/OpenForAdvanceEntry.md +44 -0
  557. package/src/modules/finance-ledger/docs/commands/OpenPeriod.md +45 -0
  558. package/src/modules/finance-ledger/docs/commands/PermanentlyClosePeriod.md +45 -0
  559. package/src/modules/finance-ledger/docs/commands/PostAdjustingEntries.md +61 -0
  560. package/src/modules/finance-ledger/docs/commands/PostJournalEntry.md +81 -0
  561. package/src/modules/finance-ledger/docs/commands/ProcessInventoryHandoff.md +72 -0
  562. package/src/modules/finance-ledger/docs/commands/ProcessManufacturingHandoff.md +68 -0
  563. package/src/modules/finance-ledger/docs/commands/ProcessPurchaseHandoff.md +68 -0
  564. package/src/modules/finance-ledger/docs/commands/ProcessSalesHandoff.md +71 -0
  565. package/src/modules/finance-ledger/docs/commands/RegenerateFinancialStatement.md +60 -0
  566. package/src/modules/finance-ledger/docs/commands/RemoveJournalLine.md +42 -0
  567. package/src/modules/finance-ledger/docs/commands/ReopenPeriod.md +45 -0
  568. package/src/modules/finance-ledger/docs/commands/ReverseJournalEntry.md +62 -0
  569. package/src/modules/finance-ledger/docs/commands/RevertSoftLock.md +49 -0
  570. package/src/modules/finance-ledger/docs/commands/UpdateFiscalYear.md +60 -0
  571. package/src/modules/finance-ledger/docs/commands/UpdateJournalEntry.md +47 -0
  572. package/src/modules/finance-ledger/docs/commands/UpdateJournalLine.md +61 -0
  573. package/src/modules/finance-ledger/docs/commands/VerifySubledgerTransfers.md +59 -0
  574. package/src/modules/finance-ledger/docs/commands/VerifyTrialBalance.md +53 -0
  575. package/src/modules/finance-ledger/docs/features/accounting-period-management.md +110 -0
  576. package/src/modules/finance-ledger/docs/features/financial-statement-generation.md +115 -0
  577. package/src/modules/finance-ledger/docs/features/journal-entry-management.md +138 -0
  578. package/src/modules/finance-ledger/docs/features/period-end-close.md +102 -0
  579. package/src/modules/finance-ledger/docs/features/subledger-integration.md +141 -0
  580. package/src/modules/finance-ledger/docs/features/trial-balance.md +99 -0
  581. package/src/modules/finance-ledger/docs/features/year-end-close.md +84 -0
  582. package/src/modules/finance-ledger/docs/models/AccountingPeriod.md +71 -0
  583. package/src/modules/finance-ledger/docs/models/FinancialStatement.md +76 -0
  584. package/src/modules/finance-ledger/docs/models/FinancialStatementLineItem.md +41 -0
  585. package/src/modules/finance-ledger/docs/models/FiscalYear.md +41 -0
  586. package/src/modules/finance-ledger/docs/models/JournalEntry.md +80 -0
  587. package/src/modules/finance-ledger/docs/models/JournalLine.md +47 -0
  588. package/src/modules/finance-ledger/docs/models/PeriodClose.md +83 -0
  589. package/src/modules/finance-ledger/docs/models/TrialBalance.md +56 -0
  590. package/src/modules/finance-ledger/docs/models/TrialBalanceLine.md +37 -0
  591. package/src/modules/finance-ledger/docs/queries/GetAccountingPeriod.md +35 -0
  592. package/src/modules/finance-ledger/docs/queries/GetFinancialStatement.md +38 -0
  593. package/src/modules/finance-ledger/docs/queries/GetFiscalYear.md +35 -0
  594. package/src/modules/finance-ledger/docs/queries/GetJournalEntry.md +37 -0
  595. package/src/modules/finance-ledger/docs/queries/GetPeriodByDate.md +38 -0
  596. package/src/modules/finance-ledger/docs/queries/GetPeriodClose.md +36 -0
  597. package/src/modules/finance-ledger/docs/queries/GetSubledgerTransferStatus.md +45 -0
  598. package/src/modules/finance-ledger/docs/queries/GetTrialBalance.md +38 -0
  599. package/src/modules/finance-ledger/docs/queries/ListAccountingPeriods.md +46 -0
  600. package/src/modules/finance-ledger/docs/queries/ListFinancialStatements.md +46 -0
  601. package/src/modules/finance-ledger/docs/queries/ListFiscalYears.md +42 -0
  602. package/src/modules/finance-ledger/docs/queries/ListJournalEntries.md +48 -0
  603. package/src/modules/finance-ledger/docs/queries/ListPeriodCloses.md +46 -0
  604. package/src/modules/finance-ledger/docs/queries/ListTrialBalances.md +51 -0
  605. package/src/modules/finance-ledger/generated/enums.ts +109 -0
  606. package/src/modules/finance-ledger/generated/kysely-tailordb.ts +202 -0
  607. package/src/modules/finance-ledger/index.ts +2 -0
  608. package/src/modules/finance-ledger/lib/_db_deps.ts +56 -0
  609. package/src/modules/finance-ledger/lib/errors.generated.ts +332 -0
  610. package/src/modules/finance-ledger/lib/permissions.generated.ts +41 -0
  611. package/src/modules/finance-ledger/lib/types.ts +66 -0
  612. package/src/modules/finance-ledger/module.ts +262 -0
  613. package/src/modules/finance-ledger/package.json +26 -0
  614. package/src/modules/finance-ledger/permissions.ts +3 -0
  615. package/src/modules/finance-ledger/query/getAccountingPeriod.generated.ts +5 -0
  616. package/src/modules/finance-ledger/query/getAccountingPeriod.test.ts +31 -0
  617. package/src/modules/finance-ledger/query/getAccountingPeriod.ts +21 -0
  618. package/src/modules/finance-ledger/query/getFinancialStatement.generated.ts +5 -0
  619. package/src/modules/finance-ledger/query/getFinancialStatement.test.ts +35 -0
  620. package/src/modules/finance-ledger/query/getFinancialStatement.ts +29 -0
  621. package/src/modules/finance-ledger/query/getFiscalYear.generated.ts +5 -0
  622. package/src/modules/finance-ledger/query/getFiscalYear.test.ts +31 -0
  623. package/src/modules/finance-ledger/query/getFiscalYear.ts +21 -0
  624. package/src/modules/finance-ledger/query/getJournalEntry.generated.ts +5 -0
  625. package/src/modules/finance-ledger/query/getJournalEntry.test.ts +35 -0
  626. package/src/modules/finance-ledger/query/getJournalEntry.ts +29 -0
  627. package/src/modules/finance-ledger/query/getPeriodByDate.generated.ts +5 -0
  628. package/src/modules/finance-ledger/query/getPeriodByDate.test.ts +53 -0
  629. package/src/modules/finance-ledger/query/getPeriodByDate.ts +27 -0
  630. package/src/modules/finance-ledger/query/getPeriodClose.generated.ts +5 -0
  631. package/src/modules/finance-ledger/query/getPeriodClose.test.ts +31 -0
  632. package/src/modules/finance-ledger/query/getPeriodClose.ts +21 -0
  633. package/src/modules/finance-ledger/query/getSubledgerTransferStatus.generated.ts +5 -0
  634. package/src/modules/finance-ledger/query/getSubledgerTransferStatus.test.ts +101 -0
  635. package/src/modules/finance-ledger/query/getSubledgerTransferStatus.ts +68 -0
  636. package/src/modules/finance-ledger/query/getTrialBalance.generated.ts +5 -0
  637. package/src/modules/finance-ledger/query/getTrialBalance.test.ts +33 -0
  638. package/src/modules/finance-ledger/query/getTrialBalance.ts +30 -0
  639. package/src/modules/finance-ledger/query/listAccountingPeriods.generated.ts +5 -0
  640. package/src/modules/finance-ledger/query/listAccountingPeriods.test.ts +81 -0
  641. package/src/modules/finance-ledger/query/listAccountingPeriods.ts +61 -0
  642. package/src/modules/finance-ledger/query/listFinancialStatements.generated.ts +5 -0
  643. package/src/modules/finance-ledger/query/listFinancialStatements.test.ts +76 -0
  644. package/src/modules/finance-ledger/query/listFinancialStatements.ts +62 -0
  645. package/src/modules/finance-ledger/query/listFiscalYears.generated.ts +5 -0
  646. package/src/modules/finance-ledger/query/listFiscalYears.test.ts +63 -0
  647. package/src/modules/finance-ledger/query/listFiscalYears.ts +45 -0
  648. package/src/modules/finance-ledger/query/listJournalEntries.generated.ts +5 -0
  649. package/src/modules/finance-ledger/query/listJournalEntries.test.ts +91 -0
  650. package/src/modules/finance-ledger/query/listJournalEntries.ts +64 -0
  651. package/src/modules/finance-ledger/query/listPeriodCloses.generated.ts +5 -0
  652. package/src/modules/finance-ledger/query/listPeriodCloses.test.ts +63 -0
  653. package/src/modules/finance-ledger/query/listPeriodCloses.ts +64 -0
  654. package/src/modules/finance-ledger/query/listTrialBalances.generated.ts +5 -0
  655. package/src/modules/finance-ledger/query/listTrialBalances.test.ts +78 -0
  656. package/src/modules/finance-ledger/query/listTrialBalances.ts +56 -0
  657. package/src/modules/finance-ledger/seed/index.ts +19 -0
  658. package/src/modules/finance-ledger/tailor.config.ts +13 -0
  659. package/src/modules/finance-ledger/tailor.d.ts +13 -0
  660. package/src/modules/finance-ledger/testing/commandTestUtils.ts +35 -0
  661. package/src/modules/finance-ledger/testing/fixtures.ts +382 -0
  662. package/src/modules/finance-ledger/tsconfig.json +16 -0
  663. package/src/modules/inventory/command/updateLot.test.ts +1 -1
  664. package/src/modules/inventory/command/updateLot.ts +2 -3
  665. package/src/modules/inventory/command/updateStockMovement.ts +2 -3
  666. package/src/modules/inventory/command/updateStorageLocation.ts +12 -17
  667. package/src/modules/inventory/command/updateValuationPolicy.ts +2 -3
  668. package/src/modules/inventory/command/updateWarehouse.ts +2 -3
  669. package/src/modules/inventory/docs/commands/UpdateLot.md +3 -3
  670. package/src/modules/inventory/docs/commands/UpdateStorageLocation.md +6 -6
  671. package/src/modules/inventory/docs/commands/UpdateWarehouse.md +2 -2
  672. package/src/modules/item-management/command/updateItem.test.ts +16 -12
  673. package/src/modules/item-management/command/updateItem.ts +47 -31
  674. package/src/modules/item-management/command/updateTaxonomyNode.test.ts +15 -16
  675. package/src/modules/item-management/command/updateTaxonomyNode.ts +42 -29
  676. package/src/modules/item-management/docs/commands/UpdateItem.md +7 -11
  677. package/src/modules/item-management/docs/commands/UpdateTaxonomyNode.md +10 -14
  678. package/src/modules/manufacturing/command/updateBillOfMaterial.ts +3 -4
  679. package/src/modules/manufacturing/command/updateProductionOrder.ts +3 -4
  680. package/src/modules/manufacturing/command/updateRouting.ts +3 -4
  681. package/src/modules/manufacturing/command/updateWorkCenter.test.ts +16 -7
  682. package/src/modules/manufacturing/command/updateWorkCenter.ts +41 -38
  683. package/src/modules/manufacturing/docs/commands/ActivateWorkCenter.md +2 -0
  684. package/src/modules/manufacturing/docs/commands/CompleteWorkOrder.md +2 -0
  685. package/src/modules/manufacturing/docs/commands/CreateBillOfMaterial.md +1 -0
  686. package/src/modules/manufacturing/docs/commands/ReviewManufacturingCostSummary.md +1 -0
  687. package/src/modules/manufacturing/docs/commands/UpdateWorkCenter.md +6 -5
  688. package/src/modules/manufacturing/docs/models/BillOfMaterialLine.md +42 -0
  689. package/src/modules/manufacturing/docs/models/CostVarianceLine.md +36 -0
  690. package/src/modules/manufacturing/docs/models/ManufacturingCostLine.md +37 -0
  691. package/src/modules/manufacturing/docs/models/ManufacturingCostSettlementRecord.md +34 -0
  692. package/src/modules/manufacturing/docs/models/ProductionOrderBomSnapshot.md +35 -0
  693. package/src/modules/manufacturing/docs/models/ProductionOrderCostBaseline.md +36 -0
  694. package/src/modules/manufacturing/docs/models/ProductionOrderMaterialRequirement.md +35 -0
  695. package/src/modules/manufacturing/docs/models/ProductionOrderRoutingSnapshot.md +34 -0
  696. package/src/modules/manufacturing/docs/models/RoutingOperation.md +40 -0
  697. package/src/modules/manufacturing/docs/models/WorkOrderExecutionEvent.md +38 -0
  698. package/src/modules/manufacturing/docs/queries/ExplodeBillOfMaterial.md +1 -0
  699. package/src/modules/manufacturing/docs/queries/ListWorkCentersBySite.md +1 -0
  700. package/src/modules/organization/command/updateCompany.test.ts +6 -6
  701. package/src/modules/organization/command/updateCompany.ts +3 -4
  702. package/src/modules/organization/command/updateDepartment.test.ts +7 -7
  703. package/src/modules/organization/command/updateDepartment.ts +13 -12
  704. package/src/modules/organization/command/updateSite.test.ts +10 -10
  705. package/src/modules/organization/command/updateSite.ts +3 -4
  706. package/src/modules/organization/docs/commands/UpdateCompany.md +6 -6
  707. package/src/modules/organization/docs/commands/UpdateDepartment.md +9 -10
  708. package/src/modules/organization/docs/commands/UpdateSite.md +12 -12
  709. package/src/modules/product-management/command/updateProduct.test.ts +17 -11
  710. package/src/modules/product-management/command/updateProduct.ts +45 -28
  711. package/src/modules/product-management/command/updateProductAttribute.test.ts +16 -21
  712. package/src/modules/product-management/command/updateProductAttribute.ts +40 -26
  713. package/src/modules/product-management/command/updateProductAttributeValue.ts +2 -3
  714. package/src/modules/product-management/command/updateProductCategory.test.ts +14 -19
  715. package/src/modules/product-management/command/updateProductCategory.ts +42 -26
  716. package/src/modules/product-management/docs/commands/UpdateProduct.md +16 -20
  717. package/src/modules/product-management/docs/commands/UpdateProductAttribute.md +10 -14
  718. package/src/modules/product-management/docs/commands/UpdateProductCategory.md +10 -14
  719. package/src/modules/purchase/command/updateGoodsReceipt.ts +2 -3
  720. package/src/modules/purchase/command/updatePurchaseBill.ts +2 -3
  721. package/src/modules/purchase/command/updatePurchaseOrder.ts +2 -3
  722. package/src/modules/purchase/command/updatePurchasePaymentTerm.ts +2 -3
  723. package/src/modules/purchase/command/updatePurchasePriceList.ts +2 -3
  724. package/src/modules/purchase/command/updatePurchasePriceRule.ts +2 -3
  725. package/src/modules/sales/command/updateChannel.test.ts +4 -4
  726. package/src/modules/sales/command/updateChannel.ts +2 -3
  727. package/src/modules/sales/command/updateListing.test.ts +2 -2
  728. package/src/modules/sales/command/updateListing.ts +2 -3
  729. package/src/modules/sales/command/updateSalesCreditNote.test.ts +2 -2
  730. package/src/modules/sales/command/updateSalesCreditNote.ts +2 -3
  731. package/src/modules/sales/command/updateSalesInvoice.test.ts +2 -2
  732. package/src/modules/sales/command/updateSalesInvoice.ts +2 -3
  733. package/src/modules/sales/command/updateSalesOrder.test.ts +3 -3
  734. package/src/modules/sales/command/updateSalesOrder.ts +2 -3
  735. package/src/modules/sales/command/updateSalesPaymentTerm.test.ts +2 -2
  736. package/src/modules/sales/command/updateSalesPaymentTerm.ts +2 -3
  737. package/src/modules/sales/command/updateSalesPriceList.test.ts +3 -3
  738. package/src/modules/sales/command/updateSalesPriceList.ts +2 -3
  739. package/src/modules/sales/command/updateSalesPriceRule.test.ts +3 -3
  740. package/src/modules/sales/command/updateSalesPriceRule.ts +2 -3
  741. package/src/modules/sales/command/updateShipment.test.ts +2 -2
  742. package/src/modules/sales/command/updateShipment.ts +2 -3
  743. package/src/modules/sales/docs/commands/UpdateChannel.md +4 -4
  744. package/src/modules/sales/docs/commands/UpdateListing.md +2 -2
  745. package/src/modules/sales/docs/commands/UpdateSalesCreditNote.md +2 -2
  746. package/src/modules/sales/docs/commands/UpdateSalesInvoice.md +2 -2
  747. package/src/modules/sales/docs/commands/UpdateSalesOrder.md +3 -3
  748. package/src/modules/sales/docs/commands/UpdateSalesPaymentTerm.md +2 -2
  749. package/src/modules/sales/docs/commands/UpdateSalesPriceList.md +3 -3
  750. package/src/modules/sales/docs/commands/UpdateSalesPriceRule.md +3 -3
  751. package/src/modules/sales/docs/commands/UpdateShipment.md +2 -2
  752. package/src/modules/user-management/README.md +2 -1
  753. package/src/modules/user-management/command/updateOwnProfile.generated.ts +6 -0
  754. package/src/modules/user-management/command/updateOwnProfile.test.ts +191 -0
  755. package/src/modules/user-management/command/updateOwnProfile.ts +82 -0
  756. package/src/modules/user-management/command/updateUser.generated.ts +6 -0
  757. package/src/modules/user-management/command/updateUser.test.ts +195 -0
  758. package/src/modules/user-management/command/updateUser.ts +76 -0
  759. package/src/modules/user-management/docs/commands/UpdateOwnProfile.md +68 -0
  760. package/src/modules/user-management/docs/commands/UpdateUser.md +67 -0
  761. package/src/modules/user-management/docs/features/user-account-management.md +28 -3
  762. package/src/modules/user-management/docs/models/User.md +2 -0
  763. package/src/modules/user-management/lib/errors.generated.ts +5 -0
  764. package/src/modules/user-management/lib/permissions.generated.ts +2 -0
  765. package/src/modules/user-management/module.ts +5 -0
  766. package/src/modules/user-management/seed/index.ts +19 -0
  767. package/src/progress/schema.test.ts +161 -0
  768. package/src/progress/schema.ts +316 -0
  769. package/templates/scaffold/app/backend/package.json +1 -3
  770. package/templates/scaffold/app/backend/seed/data/AuditEntry.jsonl +0 -0
  771. package/templates/scaffold/app/backend/seed/data/AuditEntry.schema.ts +20 -0
  772. package/templates/scaffold/app/backend/seed/data/AuditPolicy.jsonl +7 -0
  773. package/templates/scaffold/app/backend/seed/data/AuditPolicy.schema.ts +15 -0
  774. package/templates/scaffold/app/backend/seed/data/AuditableEntity.jsonl +4 -0
  775. package/templates/scaffold/app/backend/seed/data/AuditableEntity.schema.ts +20 -0
  776. package/templates/scaffold/app/backend/seed/data/ChangeDetail.jsonl +0 -0
  777. package/templates/scaffold/app/backend/seed/data/ChangeDetail.schema.ts +20 -0
  778. package/templates/scaffold/app/backend/seed/data/Company.jsonl +0 -0
  779. package/templates/scaffold/app/backend/seed/data/Company.schema.ts +15 -0
  780. package/templates/scaffold/app/backend/seed/data/Permission.jsonl +13 -0
  781. package/templates/scaffold/app/backend/seed/data/Permission.schema.ts +1 -1
  782. package/templates/scaffold/app/backend/seed/data/PolicyFieldRule.jsonl +0 -0
  783. package/templates/scaffold/app/backend/seed/data/PolicyFieldRule.schema.ts +20 -0
  784. package/templates/scaffold/app/backend/seed/data/Role.jsonl +1 -0
  785. package/templates/scaffold/app/backend/seed/data/Role.schema.ts +1 -1
  786. package/templates/scaffold/app/backend/seed/data/RolePermission.jsonl +13 -0
  787. package/templates/scaffold/app/backend/seed/data/RolePermission.schema.ts +1 -1
  788. package/templates/scaffold/app/backend/seed/data/User.jsonl +1 -1
  789. package/templates/scaffold/app/backend/seed/data/User.schema.ts +1 -1
  790. package/templates/scaffold/app/backend/seed/data/UserRole.jsonl +1 -0
  791. package/templates/scaffold/app/backend/seed/data/UserRole.schema.ts +1 -1
  792. package/templates/scaffold/app/backend/seed/data/_User.jsonl +1 -1
  793. package/templates/scaffold/app/backend/seed/exec.mjs +12 -0
  794. package/templates/scaffold/app/backend/src/executors/permissionCreated.ts +2 -2
  795. package/templates/scaffold/app/backend/src/executors/permissionDeleted.ts +2 -2
  796. package/templates/scaffold/app/backend/src/generated/kysely-tailordb.ts +62 -0
  797. package/templates/scaffold/app/backend/src/modules-db.ts +13 -0
  798. package/templates/scaffold/app/backend/src/modules.ts +3 -5
  799. package/templates/scaffold/app/backend/src/resolvers/assignPermissionToRole.ts +70 -0
  800. package/templates/scaffold/app/backend/src/resolvers/assignRoleToUser.ts +72 -0
  801. package/templates/scaffold/app/backend/src/resolvers/createRole.ts +92 -0
  802. package/templates/scaffold/app/backend/src/resolvers/createUser.ts +113 -13
  803. package/templates/scaffold/app/backend/src/resolvers/deactivateUser.ts +67 -0
  804. package/templates/scaffold/app/backend/src/resolvers/reactivateUser.ts +63 -0
  805. package/templates/scaffold/app/backend/src/resolvers/revokePermissionFromRole.ts +72 -0
  806. package/templates/scaffold/app/backend/src/resolvers/revokeRoleFromUser.ts +72 -0
  807. package/templates/scaffold/app/backend/src/resolvers/updateOwnProfile.ts +107 -0
  808. package/templates/scaffold/app/backend/src/resolvers/updateUserProfile.ts +107 -0
  809. package/templates/scaffold/app/backend/src/tests/stories/audit-log/user--view-audit-log-detail.test.ts +79 -0
  810. package/templates/scaffold/app/backend/src/tests/stories/audit-log/user--view-audit-log.test.ts +86 -0
  811. package/templates/scaffold/app/backend/src/tests/stories/role-management/user--assign-role-to-user.test.ts +103 -0
  812. package/templates/scaffold/app/backend/src/tests/stories/role-management/user--create-role.test.ts +61 -0
  813. package/templates/scaffold/app/backend/src/tests/stories/role-management/user--remove-role-from-user.test.ts +89 -0
  814. package/templates/scaffold/app/backend/src/tests/stories/role-management/user--update-role-permissions.test.ts +125 -0
  815. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--browse-user-list.test.ts +91 -0
  816. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--create-user-account.test.ts +97 -0
  817. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--toggle-user-status.test.ts +131 -0
  818. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--update-own-profile.test.ts +85 -0
  819. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--update-user-profile.test.ts +158 -0
  820. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--view-own-profile.test.ts +30 -0
  821. package/templates/scaffold/app/backend/src/tests/stories/user-lifecycle/user--view-user-detail.test.ts +98 -0
  822. package/templates/scaffold/app/backend/tailor.config.ts +6 -2
  823. package/templates/scaffold/app/backend/vitest.config.ts +4 -21
  824. package/templates/scaffold/app/docs/actors/user.md +11 -0
  825. package/templates/scaffold/app/docs/business-flow/audit-log/README.md +31 -0
  826. package/templates/scaffold/app/docs/business-flow/audit-log/story/user--view-audit-log-detail.md +35 -0
  827. package/templates/scaffold/app/docs/business-flow/audit-log/story/user--view-audit-log.md +44 -0
  828. package/templates/scaffold/app/docs/business-flow/role-management/README.md +33 -0
  829. package/templates/scaffold/app/docs/business-flow/role-management/story/user--assign-role-to-user.md +35 -0
  830. package/templates/scaffold/app/docs/business-flow/role-management/story/user--create-role.md +41 -0
  831. package/templates/scaffold/app/docs/business-flow/role-management/story/user--remove-role-from-user.md +33 -0
  832. package/templates/scaffold/app/docs/business-flow/role-management/story/user--update-role-permissions.md +41 -0
  833. package/templates/scaffold/app/docs/business-flow/user-lifecycle/README.md +48 -0
  834. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--browse-user-list.md +38 -0
  835. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--create-user-account.md +45 -0
  836. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--toggle-user-status.md +38 -0
  837. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--update-own-profile.md +36 -0
  838. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--update-user-profile.md +41 -0
  839. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--view-own-profile.md +30 -0
  840. package/templates/scaffold/app/docs/business-flow/user-lifecycle/story/user--view-user-detail.md +33 -0
  841. package/templates/scaffold/app/docs/resolver/assignPermissionToRole.md +16 -0
  842. package/templates/scaffold/app/docs/resolver/assignRoleToUser.md +17 -0
  843. package/templates/scaffold/app/docs/resolver/createRole.md +17 -0
  844. package/templates/scaffold/app/docs/resolver/createUser.md +23 -0
  845. package/templates/scaffold/app/docs/resolver/deactivateUser.md +17 -0
  846. package/templates/scaffold/app/docs/resolver/reactivateUser.md +16 -0
  847. package/templates/scaffold/app/docs/resolver/revokePermissionFromRole.md +17 -0
  848. package/templates/scaffold/app/docs/resolver/revokeRoleFromUser.md +17 -0
  849. package/templates/scaffold/app/docs/resolver/updateOwnProfile.md +20 -0
  850. package/templates/scaffold/app/docs/resolver/updateUserProfile.md +19 -0
  851. package/templates/scaffold/app/docs/screen/audit-entry-detail.md +30 -0
  852. package/templates/scaffold/app/docs/screen/audit-entry-list.md +25 -0
  853. package/templates/scaffold/app/docs/screen/my-profile-edit-form.md +22 -0
  854. package/templates/scaffold/app/docs/screen/my-profile.md +27 -0
  855. package/templates/scaffold/app/docs/screen/role-create-form.md +23 -0
  856. package/templates/scaffold/app/docs/screen/role-detail.md +27 -0
  857. package/templates/scaffold/app/docs/screen/role-edit-form.md +21 -0
  858. package/templates/scaffold/app/docs/screen/role-list.md +23 -0
  859. package/templates/scaffold/app/docs/screen/user-create-form.md +23 -0
  860. package/templates/scaffold/app/docs/screen/user-detail.md +33 -0
  861. package/templates/scaffold/app/docs/screen/user-edit-form.md +22 -0
  862. package/templates/scaffold/app/docs/screen/user-list.md +24 -0
  863. package/templates/scaffold/app/frontend/package.json +1 -1
  864. package/templates/scaffold/app/frontend/src/App.tsx +4 -0
  865. package/templates/scaffold/app/frontend/src/components/composed/error-fallback.tsx +1 -1
  866. package/templates/scaffold/app/frontend/src/graphql/generated/graphql-env.d.ts +59 -31
  867. package/templates/scaffold/app/frontend/src/graphql/generated/schema.graphql +1411 -688
  868. package/templates/scaffold/app/frontend/src/hooks/use-toast.ts +1 -1
  869. package/templates/scaffold/app/frontend/src/lib/permission-groups.ts +59 -0
  870. package/templates/scaffold/app/frontend/src/pages/user-management/audit/[id]/components/audit-entry-detail.tsx +102 -0
  871. package/templates/scaffold/app/frontend/src/pages/user-management/audit/[id]/page.tsx +65 -0
  872. package/templates/scaffold/app/frontend/src/pages/user-management/audit/components/audit-entries-table.tsx +90 -0
  873. package/templates/scaffold/app/frontend/src/pages/user-management/audit/page.tsx +52 -0
  874. package/templates/scaffold/app/frontend/src/pages/user-management/profile/edit/components/edit-profile-form.tsx +125 -0
  875. package/templates/scaffold/app/frontend/src/pages/user-management/profile/edit/page.tsx +19 -0
  876. package/templates/scaffold/app/frontend/src/pages/user-management/profile/page.tsx +41 -21
  877. package/templates/scaffold/app/frontend/src/pages/user-management/role/[id]/components/role-actions.tsx +26 -0
  878. package/templates/scaffold/app/frontend/src/pages/user-management/role/[id]/components/role-detail.tsx +69 -0
  879. package/templates/scaffold/app/frontend/src/pages/user-management/role/[id]/edit/components/edit-role-form.tsx +192 -0
  880. package/templates/scaffold/app/frontend/src/pages/user-management/role/[id]/edit/page.tsx +51 -0
  881. package/templates/scaffold/app/frontend/src/pages/user-management/role/[id]/page.tsx +56 -0
  882. package/templates/scaffold/app/frontend/src/pages/user-management/role/components/roles-table.tsx +85 -0
  883. package/templates/scaffold/app/frontend/src/pages/user-management/role/create/components/create-role-form.tsx +204 -0
  884. package/templates/scaffold/app/frontend/src/pages/user-management/role/create/page.tsx +19 -0
  885. package/templates/scaffold/app/frontend/src/pages/user-management/role/page.tsx +60 -0
  886. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/components/user-actions.tsx +216 -0
  887. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/components/user-detail.tsx +97 -33
  888. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/edit/components/edit-user-form.tsx +115 -0
  889. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/edit/page.tsx +51 -0
  890. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/page.tsx +8 -2
  891. package/templates/scaffold/app/frontend/src/pages/user-management/user/components/users-table.tsx +43 -42
  892. package/templates/scaffold/app/frontend/src/pages/user-management/user/create/components/create-user-form.tsx +120 -45
  893. package/templates/scaffold/app/frontend/src/pages/user-management/user/page.tsx +3 -4
  894. package/templates/scaffold/app/frontend/src/providers/graphql-provider.tsx +8 -1
  895. package/templates/scaffold/module/eslint.config.js +8 -0
  896. package/templates/scaffold/project/__dot__gitignore +1 -0
  897. package/templates/scaffold/project/__pnpm-workspace.yaml +3 -0
  898. package/templates/scaffold/project/apps/.gitkeep +0 -0
  899. package/templates/scaffold/project/modules/.gitkeep +0 -0
  900. package/templates/scaffold/project/package.json +15 -0
  901. package/templates/workflows/erp-kit-check.yml +10 -4
  902. package/src/generator/generate-stubs.ts +0 -35
  903. package/templates/scaffold/app/frontend/src/components/ui/badge.tsx +0 -39
  904. package/templates/scaffold/app/frontend/src/components/ui/button.tsx +0 -60
  905. package/templates/scaffold/app/frontend/src/components/ui/card.tsx +0 -75
  906. package/templates/scaffold/app/frontend/src/components/ui/input.tsx +0 -21
  907. package/templates/scaffold/app/frontend/src/components/ui/table.tsx +0 -90
  908. /package/src/modules/{supplier-portal → accounting/executor}/.gitkeep +0 -0
  909. /package/{templates/scaffold/app/docs/actors → src/modules/finance-ledger/command}/.gitkeep +0 -0
  910. /package/{templates/scaffold/app/docs/business-flow → src/modules/finance-ledger/db}/.gitkeep +0 -0
  911. /package/{templates/scaffold/app/docs/resolver → src/modules/finance-ledger/executor}/.gitkeep +0 -0
  912. /package/{templates/scaffold/app/docs/screen → src/modules/finance-ledger/query}/.gitkeep +0 -0
  913. /package/templates/{config → scaffold/project}/license.config.json +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tailor-platform/erp-kit",
3
- "version": "0.6.0",
3
+ "version": "0.8.0",
4
4
  "description": "Opinionated ERP toolkit for building business applications on Tailor Platform",
5
5
  "license": "MIT",
6
6
  "bin": {
@@ -7,6 +7,18 @@ description: Create Tier 1-2 documentation (requirements, actors, business-flow)
7
7
 
8
8
  Create Tier 1-2 documentation: Requirements, Actors, and Business Flows.
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## Workflow Phases
11
23
 
12
24
  ```
@@ -28,12 +40,12 @@ Focus on "what" the application should do, not "how" it will be implemented.
28
40
 
29
41
  Use AskUserQuestion to clarify undefined requirements. Focus on business-level scope and workflows — not platform capabilities like authentication.
30
42
 
31
- | Category | Example Questions |
32
- | ---------------- | ---------------------------------------------------------------------------- |
33
- | Scope | Which steps are MVP-essential? Any steps that can be deferred? |
34
- | Edge Cases | How far to handle cancellation, rejection, or mid-flow abandonment? |
35
- | Actor Boundaries | Are approver and executor separate? What is each actor's operational scope? |
36
- | Business Rules | Which steps are automated vs manual? What conditional branches exist? |
43
+ | Category | Example Questions |
44
+ | ---------------- | --------------------------------------------------------------------------- |
45
+ | Scope | Which steps are MVP-essential? Any steps that can be deferred? |
46
+ | Edge Cases | How far to handle cancellation, rejection, or mid-flow abandonment? |
47
+ | Actor Boundaries | Are approver and executor separate? What is each actor's operational scope? |
48
+ | Business Rules | Which steps are automated vs manual? What conditional branches exist? |
37
49
 
38
50
  Ask 3-4 questions at a time using multiSelect where appropriate.
39
51
 
@@ -44,13 +56,13 @@ Generate documentation using `erp-kit` CLI. `{APP_ROOT}` is the parent directory
44
56
  ```bash
45
57
  # Tier 1: Requirements + project structure
46
58
  # Creates {APP_ROOT}/{APP_NAME}/README.md
47
- erp-kit app init {APP_NAME} {APP_ROOT}
59
+ npx erp-kit app init {APP_NAME} {APP_ROOT}
48
60
 
49
61
  # Tier 2: Actors
50
- erp-kit app generate doc actors {ACTOR_NAME} -p {APP_ROOT}/{APP_NAME}
62
+ npx erp-kit app generate doc actors {ACTOR_NAME} -p {APP_ROOT}/{APP_NAME}
51
63
 
52
64
  # Tier 2: Business Flows
53
- erp-kit app generate doc business-flow {FLOW_NAME} -p {APP_ROOT}/{APP_NAME}
65
+ npx erp-kit app generate doc business-flow {FLOW_NAME} -p {APP_ROOT}/{APP_NAME}
54
66
  ```
55
67
 
56
68
  **Directory structure after init + generate:**
@@ -80,6 +92,7 @@ After creating business flows, extract and create story documentation.
80
92
 
81
93
  1. **Collect** all business flow docs: glob `<APP_ROOT>/docs/business-flow/*/README.md`
82
94
  2. **Dispatch story extraction agents** — one Agent per business flow (parallelize if possible). Each agent:
95
+
83
96
  - Reads the prompt template from [references/story-extraction.md](references/story-extraction.md)
84
97
  - Replace `{{APP_NAME}}` with the resolved app name
85
98
  - Replace `{{ACTOR_DOCS}}` with the actor doc file paths
@@ -90,7 +103,7 @@ After creating business flows, extract and create story documentation.
90
103
 
91
104
  ```bash
92
105
  # For each story identified
93
- erp-kit app generate doc story <flow>/<actor>--<story> -p {APP_ROOT}/{APP_NAME}
106
+ npx erp-kit app generate doc story <flow>/<actor>--<story> -p {APP_ROOT}/{APP_NAME}
94
107
  ```
95
108
 
96
109
  4. **Link stories** in business flow READMEs: replace `- TBD` placeholders in each flow's `## Stories` section with actual links:
@@ -102,18 +115,21 @@ erp-kit app generate doc story <flow>/<actor>--<story> -p {APP_ROOT}/{APP_NAME}
102
115
  ### Phase 4: Validate
103
116
 
104
117
  ```bash
105
- erp-kit app check -p {APP_ROOT}
118
+ # NOTE: -p takes {APP_ROOT} (parent directory), NOT {APP_ROOT}/{APP_NAME}.
119
+ # generate doc uses -p {APP_ROOT}/{APP_NAME}, but check uses -p {APP_ROOT}.
120
+ # Example: if app is at apps/user-management, use -p apps
121
+ npx erp-kit app check -p {APP_ROOT}
106
122
  ```
107
123
 
108
- See [schema-constraints.md](../erp-kit-app-shared/references/schema-constraints.md) for notes on expected "No matching files found" output.
124
+ **Expected passing output:** `✓ No violations found` for each doc type that has files. "No matching files found" appears for doc types not yet created (e.g., screens and resolvers at Tier 1-2) — this is normal and not an error.
109
125
 
110
126
  ## Schema Reference
111
127
 
112
- | Schema | Tier | Output Path |
113
- | ------------------- | ---- | ------------------------------------- |
114
- | `requirements.yml` | 1 | `README.md` |
115
- | `actors.yml` | 2 | `docs/actors/<name>.md` |
116
- | `business-flow.yml` | 2 | `docs/business-flow/<flow>/README.md` |
128
+ | Schema | Tier | Output Path |
129
+ | ------------------- | ---- | ---------------------------------------------------- |
130
+ | `requirements.yml` | 1 | `README.md` |
131
+ | `actors.yml` | 2 | `docs/actors/<name>.md` |
132
+ | `business-flow.yml` | 2 | `docs/business-flow/<flow>/README.md` |
117
133
  | `story.yml` | 2 | `docs/business-flow/<flow>/story/<actor>--<name>.md` |
118
134
 
119
135
  ## Next Step
@@ -7,6 +7,18 @@ description: Review requirements quality and documentation consistency for appli
7
7
 
8
8
  Review **requirements quality** and **documentation consistency** for an application's Tier 1-2 documentation.
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## When to Use
11
23
 
12
24
  - After writing application requirements and business flows (step 1)
@@ -7,6 +7,18 @@ description: Create Tier 3-4 documentation (screens, resolvers) by breaking down
7
7
 
8
8
  Convert Tier 2 business flows and stories into Tier 3 (screens) and Tier 4 (resolvers) documentation using parallel extraction agents.
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## When to Use
11
23
 
12
24
  - User has Tier 1-2 documentation and wants to plan Tier 3-4
@@ -40,7 +52,7 @@ Verify at least `STORY_DOCS` is non-empty. If no story docs exist, stop with: "N
40
52
  Collect module overview:
41
53
 
42
54
  ```bash
43
- erp-kit doc modules
55
+ npx erp-kit doc modules
44
56
  ```
45
57
 
46
58
  This returns each module's name, overview, command/query/model counts, and dependencies. Save the full output as `MODULE_OVERVIEW` — both agents receive it.
@@ -100,10 +112,10 @@ Scaffold using `erp-kit` CLI:
100
112
 
101
113
  ```bash
102
114
  # Tier 3: Screens
103
- erp-kit app generate doc screen <screen-name> -p {APP_ROOT}/{APP_NAME}
115
+ npx erp-kit app generate doc screen <screen-name> -p {APP_ROOT}/{APP_NAME}
104
116
 
105
117
  # Tier 4: Resolvers
106
- erp-kit app generate doc resolver <resolver-name> -p {APP_ROOT}/{APP_NAME}
118
+ npx erp-kit app generate doc resolver <resolver-name> -p {APP_ROOT}/{APP_NAME}
107
119
  ```
108
120
 
109
121
  Fill scaffolded docs with details from agent extraction results.
@@ -119,7 +131,9 @@ Read-only stories should have `None` under `## Resolvers`.
119
131
  ## Step 6: Validate
120
132
 
121
133
  ```bash
122
- erp-kit app check -p {APP_ROOT}
134
+ # NOTE: -p takes {APP_ROOT} (parent directory), NOT {APP_ROOT}/{APP_NAME}.
135
+ # generate doc uses -p {APP_ROOT}/{APP_NAME}, but check uses -p {APP_ROOT}.
136
+ npx erp-kit app check -p {APP_ROOT}
123
137
  ```
124
138
 
125
139
  ## Naming Conventions
@@ -16,7 +16,7 @@ The following modules are available in erp-kit. Use this to map resolvers to rea
16
16
  To inspect a specific module's commands in detail, run:
17
17
 
18
18
  ```bash
19
- erp-kit doc module <module-name> command <command-name>
19
+ npx erp-kit doc module <module-name> command <command-name>
20
20
  ```
21
21
 
22
22
  ## Instructions
@@ -16,7 +16,7 @@ The following modules are available in erp-kit. Use this to understand which ent
16
16
  To inspect a specific module's model (domain description, state transitions, invariants, commands), run:
17
17
 
18
18
  ```bash
19
- erp-kit doc module <module-name> model <model-name>
19
+ npx erp-kit doc module <module-name> model <model-name>
20
20
  ```
21
21
 
22
22
  ## Instructions
@@ -7,6 +7,18 @@ description: Review parity between Tier 2 (business flows, actors, stories) and
7
7
 
8
8
  Review **documentation consistency** across Tier 2 (business flows, actors, stories), Tier 3 (screens), and Tier 4 (resolvers) documentation.
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## When to Use
11
23
 
12
24
  - After writing Tier 3-4 documentation, check for gaps
@@ -7,6 +7,18 @@ description: Implement backend code for applications using erp-kit modules. Use
7
7
 
8
8
  Implement backend resolvers and application configuration for an application, driven by Tier 1-4 documentation (actors, business flows, stories, screens, resolvers).
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## When to Use
11
23
 
12
24
  - Implementing backend resolvers from resolver spec docs
@@ -55,17 +67,17 @@ Classify resolvers per [erp-kit-app-shared/references/resolver-classification.md
55
67
 
56
68
  When implementing in Phase 4, follow the patterns from the reference examples. Once all actual resolvers are implemented, delete the reference files that aren't needed by your app.
57
69
 
58
- ### Phase 2: Wire Modules (`src/modules.ts`)
70
+ ### Phase 2: Wire Modules (`src/modules.ts` + `src/modules-db.ts`)
59
71
 
60
- Create the module wiring file that composes all required erp-kit modules.
72
+ Create the module wiring files that compose all required erp-kit modules.
61
73
 
62
74
  **Read [module wiring reference](references/module-wiring.md) for the composition pattern.**
63
75
 
64
76
  Key points:
65
77
 
66
- - Use `defineXxxModule()` functions from `@tailor-platform/erp-kit/module`
78
+ - `modules.ts` — Use `defineXxxModule()` functions from `@tailor-platform/erp-kit/module` and export module objects for resolver use
79
+ - `modules-db.ts` — Destructure DB types into individual named exports for the DB scanner. This file must NOT be imported by resolvers.
67
80
  - Pass inter-module dependencies explicitly (e.g., item-management needs primitives' unit type and query)
68
- - Export `db`, `commands`, and `executors` for use in resolvers
69
81
 
70
82
  ### Phase 3: Configure Application (`tailor.config.ts`)
71
83
 
@@ -97,7 +109,7 @@ After resolvers are done, implement the story integration test stubs generated i
97
109
  > - `src/resolvers/<resolverName>.ts`
98
110
  > - `src/executors/<resolverName>.ts`
99
111
  >
100
- > **Shared-file guard:** `src/modules.ts` and `tailor.config.ts` are written in the sync barrier phase above. Resolver agents must NOT modify these files.
112
+ > **Shared-file guard:** `src/modules.ts`, `src/modules-db.ts`, and `tailor.config.ts` are written in the sync barrier phase above. Resolver agents must NOT modify these files.
101
113
 
102
114
  ### Phase 5: Generated Files
103
115
 
@@ -11,7 +11,7 @@ Key points:
11
11
  ## Auth configuration
12
12
 
13
13
  - Prefer stable default naming: auth `default`, IdP `default`, OAuth2 client `default`
14
- - `userProfile.type` must reference the `user` DB type from `modules.ts`
14
+ - `userProfile.type` must reference the `user` DB type from `modules-db`
15
15
  - `userProfile.usernameField`: stable unique field (e.g., `email`)
16
16
  - Include static website URL and localhost in CORS: `cors: ["http://localhost:5173", website.url]`
17
17
  - Frontend `VITE_TAILOR_CLIENT_ID` must come from `tailor-sdk oauth2client get default --json` — do not hardcode
@@ -1,17 +1,23 @@
1
1
  # Module Wiring
2
2
 
3
- `src/modules.ts` composes erp-kit modules and exports their parts for resolver use.
3
+ Module wiring is split across two files:
4
+
5
+ - `src/modules.ts` — composes erp-kit modules and exports module objects for resolver use
6
+ - `src/modules-db.ts` — destructures DB types into individual named exports for the DB scanner (`tailor.config.ts` db.files)
7
+
8
+ ### `src/modules.ts`
4
9
 
5
10
  ```ts
6
11
  import {
7
12
  definePrimitivesModule,
8
13
  defineUserManagementModule,
9
14
  defineItemManagementModule,
15
+ defineAuditModule,
10
16
  } from "@tailor-platform/erp-kit/module";
11
17
 
12
18
  const primitivesModules = definePrimitivesModule({});
13
19
 
14
- const umModules = defineUserManagementModule({
20
+ export const umModules = defineUserManagementModule({
15
21
  dbNamespace: "main-db",
16
22
  user: {
17
23
  fields: {
@@ -22,26 +28,45 @@ const umModules = defineUserManagementModule({
22
28
  });
23
29
 
24
30
  // Pass inter-module dependencies explicitly
25
- const imModules = defineItemManagementModule({
31
+ export const imModules = defineItemManagementModule({
26
32
  primitives: {
27
33
  db: { unit: primitivesModules.db.unit },
28
34
  queries: { getUnit: primitivesModules.queries.getUnit },
29
35
  },
30
36
  });
31
37
 
32
- // Destructure db into individual table exports (required for DB scanner)
33
- export const { db: primitivesDb, commands: primitivesCommands } = primitivesModules;
34
- export const { uomCategory, unit, currency, exchangeRate } = primitivesDb;
38
+ export const auditModules = defineAuditModule();
39
+
40
+ export const primitivesModulesExport = primitivesModules;
41
+ ```
42
+
43
+ ### `src/modules-db.ts`
44
+
45
+ ```ts
46
+ import { auditCompanyStub } from "@tailor-platform/erp-kit/module";
47
+ import { umModules, imModules, primitivesModulesExport, auditModules } from "./modules";
48
+
49
+ // Destructured for DB scanner (tailor.config.ts db.files).
50
+ // This file must NOT be imported by resolvers — property access prevents tree-shaking.
51
+
52
+ // user-management
53
+ export const { user, permission, role, userRole, rolePermission } = umModules.db;
54
+
55
+ // primitives
56
+ export const { uomCategory, unit, currency, exchangeRate } = primitivesModulesExport.db;
35
57
 
36
- export const { db: umDb, executors: umExecutors, commands: umCommands } = umModules;
37
- export const { user, permission, role, userRole, rolePermission, auditEvent } = umDb;
58
+ // item-management
59
+ export const { item, taxonomyNode, itemTaxonomyAssignment } = imModules.db;
38
60
 
39
- export const { db: imDb, commands: imCommands } = imModules;
40
- export const { item, taxonomyNode, itemTaxonomyAssignment } = imDb;
61
+ // audit
62
+ export const { auditableEntity, auditPolicy, policyFieldRule, auditEntry, changeDetail } =
63
+ auditModules.db;
64
+ export { auditCompanyStub as company };
41
65
  ```
42
66
 
43
67
  Key conventions:
44
68
 
45
- - Prefix exports to avoid collisions (`umCommands`, `imCommands`, `primitivesCommands`)
46
- - Every module's `db` must be destructured into individual table exports the DB scanner only picks up named exports
69
+ - Prefix exports to avoid collisions (`umModules`, `imModules`, `auditModules`)
70
+ - `modules-db.ts` must NOT be imported by resolvers it exists solely for the DB scanner
71
+ - Every module's `db` must be destructured into individual table exports in `modules-db.ts` — the DB scanner only picks up named exports
47
72
  - Extract individual executors for re-export in executor files
@@ -7,6 +7,18 @@ description: Implement frontend code for applications. Use after deploying the b
7
7
 
8
8
  Implement frontend pages for an application, driven by screen spec documentation and a deployed backend.
9
9
 
10
+ ## Progress Logging
11
+
12
+ Log to the audit trail at every checkpoint. See [erp-kit-app-shared/references/progress-protocol.md](../erp-kit-app-shared/references/progress-protocol.md) for the full protocol.
13
+
14
+ ```bash
15
+ npx erp-kit app progress log --json '<ProgressInput JSON>'
16
+ ```
17
+
18
+ Required checkpoints: `step.start` (on invocation), `decision` (on user choices), `agent.dispatch`/`agent.result` (on subagent lifecycle), `artifact.create` (on file writes), `validation` (on `erp-kit app check` or build commands), `step.complete` (on finish), `error` (on failures).
19
+
20
+ Bundle all conversation since the last checkpoint into the `conversation` array. Use your session ID as `sessionId`. Use the user's original prompt as `prompt`.
21
+
10
22
  ## When to Use
11
23
 
12
24
  - Implementing frontend pages from screen spec docs
@@ -64,6 +76,8 @@ Create pages driven by screen spec docs. Each screen type has a standard impleme
64
76
 
65
77
  **Read [pages reference](references/pages.md) for the full pattern catalog.**
66
78
 
79
+ **Read [app-shell UI cheat sheet](references/component.md)** for `@tailor-platform/app-shell` primitives (Layout, Button, Table, dialogs, Menu, Select, Combobox, Autocomplete, etc.).
80
+
67
81
  Page types and their file structure:
68
82
 
69
83
  | Screen Type | Files |
@@ -79,7 +93,7 @@ Key frontend patterns:
79
93
  - **gql.tada** — Type-safe GraphQL via `graphql()` from `@/graphql`
80
94
  - **React Hook Form + Zod** — Form validation with `zodResolver`
81
95
  - **urql** — `useQuery` for reads, `useMutation` for writes
82
- - **app-shell routing** — `Layout`, `Link`, `useParams`, `useNavigate` from `@tailor-platform/app-shell`
96
+ - **app-shell** — Routing: `Layout`, `Link`, `useParams`, `useNavigate`. UI: see [references/component.md](references/component.md) for primitives (`Button`, `Input`, `Table`, dialogs, menus, selects, etc.)
83
97
 
84
98
  ### Phase 4: Verify
85
99
 
@@ -0,0 +1,90 @@
1
+ # @tailor-platform/app-shell — UI cheat sheet
2
+
3
+ Import from `@tailor-platform/app-shell` instead of duplicating shadcn-style `components/ui` when possible. Details: [app-shell docs/components](https://raw.github.com/tailor-platform/app-shell/tree/main/docs/components).
4
+
5
+ ## Layout
6
+
7
+ - **`Layout`** — `title` / `actions` / `columns` still work; prefer **`Layout.Header`** (`title`, `actions`, children e.g. tabs) + **`Layout.Column`**.
8
+ - **`Layout.Column` `area`** — `"left" | "main" | "right"` for sidebar + main + rail; use `className` on `Layout` for gap (`columns` / `gap` deprecated).
9
+
10
+ ## ActionPanel
11
+
12
+ `actions={[{ key, label, icon, onClick, disabled?, loading? }]}` — icon + label rows; use `useNavigate` inside `onClick` for routing.
13
+
14
+ ## Routing helpers
15
+
16
+ `Link`, `useNavigate`, `useParams` — same package.
17
+
18
+ ## DescriptionCard
19
+
20
+ Detail screens: **`data`** + **`fields`** render a responsive key/value grid.
21
+
22
+ | Prop | Notes |
23
+ | --------------------- | ---------------------------------------------------------------------- |
24
+ | `data` | `Record<string, unknown>` — values (dot keys OK, e.g. `customer.name`) |
25
+ | `fields` | `FieldConfig[]` — each field or `{ type: "divider" }` |
26
+ | `columns` | `2` \| `3` (default) \| `4` |
27
+ | `className` / `style` | Card container |
28
+
29
+ **Field config** — `key`, `label`, optional `type`, `meta`, `emptyBehavior` (`"dash"` \| `"hide"`).
30
+
31
+ | `type` (default `text`) | Role / typical `meta` |
32
+ | ----------------------- | ------------------------------------------------------------- |
33
+ | **text** | `copyable`, `truncateLines` |
34
+ | **badge** | `badgeVariantMap: { [value]: variant }` |
35
+ | **money** | `currencyKey` — key in `data` for ISO currency code |
36
+ | **date** | `dateFormat`: `short` \| `medium` \| `long` \| `relative` |
37
+ | **link** | `hrefKey`, `external?` |
38
+ | **address** | Value = `{ street, city, state, zip, … }` object |
39
+ | **reference** | `referenceIdKey`, `referenceUrlPattern` e.g. `/invoices/{id}` |
40
+
41
+ ## Button / Link
42
+
43
+ Use **`render`**, not Radix `asChild`:
44
+
45
+ ```tsx
46
+ <Button render={<Link to="create" />}>Create</Button>
47
+ ```
48
+
49
+ Variants: `default` | `destructive` | `outline` | `secondary` | `ghost` | `link`. Sizes: `default` | `sm` | `lg` | `icon`.
50
+
51
+ ## Input
52
+
53
+ Native input props; works with RHF `FormControl` + spread `field`.
54
+
55
+ ## Table
56
+
57
+ ```tsx
58
+ <Table.Root>
59
+ <Table.Header>
60
+ <Table.Row>
61
+ <Table.Head />
62
+ </Table.Row>
63
+ </Table.Header>
64
+ <Table.Body>
65
+ <Table.Row>
66
+ <Table.Cell />
67
+ </Table.Row>
68
+ </Table.Body>
69
+ </Table.Root>
70
+ ```
71
+
72
+ Also `Footer`, `Caption`. Wrapper: `containerClassName`; inner table: `className`.
73
+
74
+ ## Dialog / Sheet / Tooltip
75
+
76
+ Compound `*.Root`, `*.Content`, etc. Triggers: **`render={<Button />}`** (or `Link` pattern as needed).
77
+
78
+ ## Menu
79
+
80
+ `Menu.Root` → `Trigger` → `Content` → `Item` / `Separator` / checkbox & radio items; nested: `SubmenuRoot` / `SubmenuTrigger`.
81
+
82
+ ## Select / Combobox / Autocomplete
83
+
84
+ | Component | Use case | Extras |
85
+ | ---------------- | ----------------------------------------- | -------------------------------- |
86
+ | **Select** | `items`, `placeholder`, `onValueChange` | `Select.Async` |
87
+ | **Combobox** | Searchable; `items`; multi / creatable | `Combobox.Async`, `onCreateItem` |
88
+ | **Autocomplete** | Typed string + suggestions (value = text) | `Autocomplete.Async` |
89
+
90
+ **`.Parts`** on each — low-level `Root`, `Trigger`, `Content`, …; hooks `useFilter`, `useAsync`, `useCreatable` for custom UIs.