@futdevpro/nts-dynamo 1.15.98 → 1.15.99

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 (367) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/logs/cicd-pipeline/output.log +2803 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.vscode/settings.json +10 -10
  19. package/HOWTO.md +15 -15
  20. package/LICENSE +21 -21
  21. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  22. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  23. package/_specifications/BACKLOG.md +92 -92
  24. package/_specifications/TODO.md +15 -15
  25. package/_specifications/agent.md +138 -138
  26. package/build/_models/control-models/endpoint-params.control-model.d.ts.map +1 -1
  27. package/build/_models/control-models/endpoint-params.control-model.js +8 -0
  28. package/build/_models/control-models/endpoint-params.control-model.js.map +1 -1
  29. package/eslint.config.js +3 -3
  30. package/nodemon.json +24 -24
  31. package/package.json +1 -1
  32. package/pnpm-workspace.yaml +5 -5
  33. package/scripts/run-coverage-tests.js +28 -28
  34. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  35. package/spec/support/helpers/ts-node-helper.js +93 -93
  36. package/spec/support/jasmine.coverage.json +24 -24
  37. package/spec/support/jasmine.json +24 -24
  38. package/src/_collections/archive.util.spec.ts +57 -57
  39. package/src/_collections/archive.util.ts +18 -18
  40. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  41. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  42. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  43. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  44. package/src/_collections/default-not-found-page.const.ts +22 -22
  45. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  46. package/src/_collections/default-socket-path.const.ts +2 -2
  47. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  48. package/src/_collections/get-environment-settings.util.ts +48 -48
  49. package/src/_collections/global-settings.const.ts +109 -109
  50. package/src/_collections/sample.env +21 -21
  51. package/src/_collections/star.controller.spec.ts +224 -224
  52. package/src/_collections/star.controller.ts +129 -129
  53. package/src/_enums/data-model-type.enum.ts +14 -14
  54. package/src/_enums/data-service-function.enum.ts +24 -24
  55. package/src/_enums/predefined-data-types.enum.ts +16 -16
  56. package/src/_enums/route-security.enum.ts +12 -12
  57. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  58. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  59. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  60. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  61. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  62. package/src/_models/control-models/app-params.control-model.ts +136 -136
  63. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  64. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  65. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -627
  66. package/src/_models/control-models/endpoint-params.control-model.ts +636 -627
  67. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  68. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  69. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  70. package/src/_models/control-models/system-control.control-model.ts +12 -12
  71. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  72. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  73. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  74. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  75. package/src/_models/interfaces/global-settings.interface.ts +259 -259
  76. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  77. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  78. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  79. package/src/_models/types/db-update.type.ts +100 -100
  80. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  81. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  82. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  83. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  84. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  85. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  87. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  90. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  91. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  92. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  93. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  94. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  95. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  96. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  97. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  98. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  99. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  100. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  101. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  102. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  103. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  104. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  105. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  106. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  107. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  108. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  109. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  111. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  112. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  119. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  120. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  121. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  122. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  123. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  124. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  125. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  126. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  127. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  128. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  129. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  130. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  131. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  132. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  133. package/src/_modules/ai/index.ts +23 -23
  134. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  135. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  136. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  137. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  138. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  139. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  140. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  141. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  142. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  143. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  144. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  145. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  146. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  147. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  148. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  149. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  150. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  151. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  152. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  153. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  154. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  155. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  156. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  157. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  158. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  159. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  160. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  161. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  162. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  163. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  164. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  165. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  166. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  167. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  168. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  169. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  170. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  171. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  172. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  173. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  174. package/src/_modules/custom-data/index.ts +9 -9
  175. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  176. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  177. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  178. package/src/_modules/data-readers/index.ts +11 -11
  179. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  180. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  181. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  182. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  183. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  184. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  185. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  186. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  187. package/src/_modules/defaults/index.ts +17 -17
  188. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  189. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  190. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  191. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  192. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  193. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  194. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  195. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  196. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  197. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  198. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  199. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  200. package/src/_modules/discord-assistant/index.ts +38 -38
  201. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  202. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  203. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  204. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  205. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  206. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  207. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  208. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  209. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  210. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  211. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  212. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  213. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  214. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  215. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  216. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  217. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  218. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  219. package/src/_modules/discord-bot/index.ts +36 -36
  220. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  221. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  222. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  223. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  224. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  225. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  226. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  227. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  228. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  229. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  230. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  231. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  232. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  233. package/src/_modules/local-vector-search/index.ts +16 -16
  234. package/src/_modules/logs/index.ts +11 -11
  235. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  236. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  237. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  238. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  239. package/src/_modules/mcp/index.ts +13 -13
  240. package/src/_modules/messaging/README.md +354 -354
  241. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  242. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  243. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  244. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  245. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  246. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  247. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  248. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  249. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  250. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  251. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  252. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  253. package/src/_modules/messaging/index.ts +30 -30
  254. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  255. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  256. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  257. package/src/_modules/mock/app-params.mock.ts +9 -9
  258. package/src/_modules/mock/app-server.mock.ts +188 -188
  259. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  260. package/src/_modules/mock/auth-service.mock.ts +28 -28
  261. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  262. package/src/_modules/mock/controller.mock.ts +16 -16
  263. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  264. package/src/_modules/mock/data-model.mock.ts +82 -82
  265. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  266. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  267. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  268. package/src/_modules/mock/email-service.mock.ts +20 -20
  269. package/src/_modules/mock/email-template.mock.html +14 -14
  270. package/src/_modules/mock/endpoint.mock.ts +91 -91
  271. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  272. package/src/_modules/mock/socket-client.mock.ts +45 -45
  273. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  274. package/src/_modules/mock/socket-server.mock.ts +46 -46
  275. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  276. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  277. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  278. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  279. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  280. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  281. package/src/_modules/oauth2/index.ts +17 -17
  282. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  283. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  284. package/src/_modules/scheduler/index.ts +8 -8
  285. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  286. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  287. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  288. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  289. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  290. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  291. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  292. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  293. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  294. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  295. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  296. package/src/_modules/scoped-config/index.ts +17 -17
  297. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  298. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  299. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  300. package/src/_modules/server/errors/errors.controller.ts +515 -515
  301. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  302. package/src/_modules/server/index.ts +30 -30
  303. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  304. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  305. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  306. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  307. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  308. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  309. package/src/_modules/server/server-status/server-status.controller.spec.ts +255 -255
  310. package/src/_modules/server/server-status/server-status.controller.ts +272 -272
  311. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  312. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  313. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  314. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  315. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  316. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  317. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  318. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  319. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  320. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  321. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  322. package/src/_modules/socket/app-extended.server.ts +630 -630
  323. package/src/_modules/socket/index.ts +42 -42
  324. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  325. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  326. package/src/_modules/test/index.ts +11 -11
  327. package/src/_modules/test/test.controller.spec.ts +72 -72
  328. package/src/_modules/test/test.controller.ts +115 -115
  329. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  330. package/src/_modules/usage/index.ts +15 -15
  331. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  332. package/src/_modules/usage/usage.controller.ts +126 -126
  333. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  334. package/src/_modules/usage/usage.data-service.ts +185 -185
  335. package/src/_services/base/api.service-base.spec.ts +125 -125
  336. package/src/_services/base/api.service-base.ts +74 -74
  337. package/src/_services/base/archive-data.service.spec.ts +209 -209
  338. package/src/_services/base/archive-data.service.ts +224 -224
  339. package/src/_services/base/data.service.spec.ts +729 -729
  340. package/src/_services/base/data.service.ts +2744 -2744
  341. package/src/_services/base/db.service.spec.ts +160 -160
  342. package/src/_services/base/db.service.ts +1592 -1592
  343. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  344. package/src/_services/base/singleton.service-base.ts +24 -24
  345. package/src/_services/base/singleton.service.spec.ts +114 -114
  346. package/src/_services/base/singleton.service.ts +38 -38
  347. package/src/_services/core/api.service.spec.ts +140 -140
  348. package/src/_services/core/auth.service.spec.ts +159 -159
  349. package/src/_services/core/auth.service.ts +174 -174
  350. package/src/_services/core/email.service.spec.ts +85 -85
  351. package/src/_services/core/email.service.ts +757 -757
  352. package/src/_services/core/global.service.spec.ts +292 -292
  353. package/src/_services/core/global.service.ts +487 -487
  354. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  355. package/src/_services/core/memory-guard.service.ts +481 -481
  356. package/src/_services/core/service-collection.service.spec.ts +46 -46
  357. package/src/_services/core/service-collection.service.ts +6 -6
  358. package/src/_services/route/controller.service.spec.ts +53 -53
  359. package/src/_services/route/controller.service.ts +148 -148
  360. package/src/_services/route/routing-module.service.spec.ts +98 -98
  361. package/src/_services/route/routing-module.service.ts +330 -330
  362. package/src/_services/server/app.server.ts +1941 -1941
  363. package/src/_services/shared.static-service.spec.ts +99 -99
  364. package/src/_services/shared.static-service.ts +78 -78
  365. package/src/index.ts +100 -100
  366. package/tsconfig.app.json +12 -12
  367. package/tsconfig.json +42 -42
package/.c8rc.json CHANGED
@@ -1,26 +1,26 @@
1
- {
2
- "reporter": [
3
- "html",
4
- "text",
5
- "lcov"
6
- ],
7
- "reports-dir": "./coverage",
8
- "include": [
9
- "src/**/*.ts"
10
- ],
11
- "exclude": [
12
- "src/**/*.spec.ts",
13
- "src/**/*.spec.js",
14
- "src/spec/**",
15
- "**/node_modules/**",
16
- "**/coverage/**",
17
- "**/*.d.ts",
18
- "**/*.const.ts",
19
- "**/*.enum.ts",
20
- "**/*.interface.ts",
21
- "**/*.type.ts",
22
- "**/index.ts"
23
- ],
24
- "all": true
25
- }
26
-
1
+ {
2
+ "reporter": [
3
+ "html",
4
+ "text",
5
+ "lcov"
6
+ ],
7
+ "reports-dir": "./coverage",
8
+ "include": [
9
+ "src/**/*.ts"
10
+ ],
11
+ "exclude": [
12
+ "src/**/*.spec.ts",
13
+ "src/**/*.spec.js",
14
+ "src/spec/**",
15
+ "**/node_modules/**",
16
+ "**/coverage/**",
17
+ "**/*.d.ts",
18
+ "**/*.const.ts",
19
+ "**/*.enum.ts",
20
+ "**/*.interface.ts",
21
+ "**/*.type.ts",
22
+ "**/index.ts"
23
+ ],
24
+ "all": true
25
+ }
26
+
@@ -1,8 +1,8 @@
1
- {
2
- "patterns": [
3
- {
4
- "name": "throw Error",
5
- "regex": "throw new DyFM_Error\\(\\{\\s*\\.\\.\\.this\\._getDefaultErrorSettings\\("
6
- }
7
- ]
1
+ {
2
+ "patterns": [
3
+ {
4
+ "name": "throw Error",
5
+ "regex": "throw new DyFM_Error\\(\\{\\s*\\.\\.\\.this\\._getDefaultErrorSettings\\("
6
+ }
7
+ ]
8
8
  }
@@ -1,30 +1,30 @@
1
- ---
2
- description: Apply if planning or reviewing operations
3
- alwaysApply: false
4
- ---
5
- # Global planning and execution policy
6
- - mindig amikor a user olyat vagy olyasmit, mond, hogy "ennek úgy kéne működnie, hogy ..." annak bele kell kerülni a specifikációba
7
- - minden nagyobb fejlesztés végén dokumentációt kell készíteni
8
-
9
- ## fejlesztési folyamat;
10
- Az alábbi folyamatot a user szoros közreműködésével fogjuk végezni
11
- - valamilyen hibából vagy feature request-ből indulunk ki
12
- - átnézzük az összes kapcsolódó elemet
13
- - mindig kérjük, hogy
14
- - "review the issue very carefully"
15
- - "be very very careful"
16
- - "plan comprehensive"
17
- - "always check exisitng solutions"
18
- - "always follow existing patterns very strictly"
19
- - tervezünk egy megoldást
20
- - implementáljuk a megoldást
21
- - leteszteltetjük a felhasználóval, úgy hogy futtassa az alkalmazást és a lehető legtöbb féle képpen triggereljük a subjct feature-t
22
- - ellenőriztetjük az érintett más funkcionalitásokat
23
- - ha van hiba akkor megpróbáljuk megoldani
24
- - a hibajavítások során figyelünk arra, hogy ha ugyan az a hiba újra előjön többször egymás után miközben javításokat végzünk, akkor az valamilyen nagyobb szintű hibára utal ami átfogóbb review-t és solution planning-et igényel. (ehhez hasonló párhuzamos session)
25
- - ha minden javítás kész, újból átfogó tesztet végeztetünk, majd ha ezen is átment, akkor push-oltatjuk a megoldást a user-el. figyelve az automata GIT build-ek eredményére (hátha újabb error jelentkezik, ezt a user fogja tudni visszajelezni)
26
- - dokumentációt készítünk a session-ről, amiben legyen benne a user kérése is (a legközelebbi "__documentations" folder-be)
27
- - menet közben ahogy a user-el egyeztetünk, kieshetnek újabb feature request-ek és specifikációs kérések amiket fontos hogy feljegyezzünk!
28
- - Amikor fázisonkénti fejlesztéseket hajtunk végre, mindig készítsünk dokumentációt az eredményekről, és update-eljük a soron következő-, már megtervezett fázisokat, amennyiben szükséges. (de csak miután a user elfogadta és véglegesítette a megoldást.)
29
-
30
-
1
+ ---
2
+ description: Apply if planning or reviewing operations
3
+ alwaysApply: false
4
+ ---
5
+ # Global planning and execution policy
6
+ - mindig amikor a user olyat vagy olyasmit, mond, hogy "ennek úgy kéne működnie, hogy ..." annak bele kell kerülni a specifikációba
7
+ - minden nagyobb fejlesztés végén dokumentációt kell készíteni
8
+
9
+ ## fejlesztési folyamat;
10
+ Az alábbi folyamatot a user szoros közreműködésével fogjuk végezni
11
+ - valamilyen hibából vagy feature request-ből indulunk ki
12
+ - átnézzük az összes kapcsolódó elemet
13
+ - mindig kérjük, hogy
14
+ - "review the issue very carefully"
15
+ - "be very very careful"
16
+ - "plan comprehensive"
17
+ - "always check exisitng solutions"
18
+ - "always follow existing patterns very strictly"
19
+ - tervezünk egy megoldást
20
+ - implementáljuk a megoldást
21
+ - leteszteltetjük a felhasználóval, úgy hogy futtassa az alkalmazást és a lehető legtöbb féle képpen triggereljük a subjct feature-t
22
+ - ellenőriztetjük az érintett más funkcionalitásokat
23
+ - ha van hiba akkor megpróbáljuk megoldani
24
+ - a hibajavítások során figyelünk arra, hogy ha ugyan az a hiba újra előjön többször egymás után miközben javításokat végzünk, akkor az valamilyen nagyobb szintű hibára utal ami átfogóbb review-t és solution planning-et igényel. (ehhez hasonló párhuzamos session)
25
+ - ha minden javítás kész, újból átfogó tesztet végeztetünk, majd ha ezen is átment, akkor push-oltatjuk a megoldást a user-el. figyelve az automata GIT build-ek eredményére (hátha újabb error jelentkezik, ezt a user fogja tudni visszajelezni)
26
+ - dokumentációt készítünk a session-ről, amiben legyen benne a user kérése is (a legközelebbi "__documentations" folder-be)
27
+ - menet közben ahogy a user-el egyeztetünk, kieshetnek újabb feature request-ek és specifikációs kérések amiket fontos hogy feljegyezzünk!
28
+ - Amikor fázisonkénti fejlesztéseket hajtunk végre, mindig készítsünk dokumentációt az eredményekről, és update-eljük a soron következő-, már megtervezett fázisokat, amennyiben szükséges. (de csak miután a user elfogadta és véglegesítette a megoldást.)
29
+
30
+
@@ -1,86 +1,86 @@
1
- ---
2
- description: when creating backend structure, backend module or backend folders.
3
- alwaysApply: false
4
- ---
5
- # Backend Project Structure [FDP-BE]
6
-
7
- ## Overview
8
- This document outlines the standard project structure for FDP backend applications.
9
-
10
- ## Directory Structure
11
-
12
- ```
13
- 📁 app/
14
- ├── 📁 _assets/
15
- ├── 📁 _collections/
16
- │ ├── 📁 email(*)/
17
- │ ├── 📁 consts(*)/
18
- │ ├── 📁 mocks(*)/
19
- │ └── 📁 utils(*)/
20
- ├── 📁 _enums/
21
- ├── 📁 _models/
22
- │ ├── 📁 control-models(*)/
23
- │ ├── 📁 data-models(*)/
24
- │ └── 📁 interfaces(*)/
25
- ├── 📁 _modules/
26
- │ ├── 📁 moduleName/
27
- │ │ ├── 📁 _collections/
28
- │ │ ├── 📁 _enums/
29
- │ │ ├── 📁 _models/
30
- │ │ └── 📁 _services/
31
- │ └── 📁 anotherModule/
32
- │ ├── 📁 _collections/
33
- │ ├── 📁 _enums/
34
- │ ├── 📁 _models/
35
- │ └── 📁 _services/
36
- └── 📁 _routes(**)
37
- ├── 📁 user/
38
- │ ├── 📁 user/
39
- │ │ ├── user.controller.ts
40
- │ │ └── user.data-service.ts
41
- │ ├── 📁 userData/
42
- │ │ ├── user-data.controller.ts
43
- │ │ └── user-data.data-service.ts
44
- │ └── 📁 userCarts/
45
- │ ├── user-carts.controller.ts
46
- │ └── user-carts.data-service.ts
47
- ├── 📁 products/
48
- └── 📁 server/
49
- ├── 📁 server-status/
50
- ├── 📁 error/
51
- ├── 📁 _socket-services/
52
- └── 📁 core-services/
53
- ├── 📁 api-services/
54
- └── 📁 email-services/
55
- ```
56
-
57
- ## Directory Guidelines
58
-
59
- ### Folder Creation Rules (*)
60
- - Create subfolders only when containing 3-5+ elements
61
- - For 3+ elements: Consider if it will grow to 5+
62
- - If likely to reach 5+: Create subfolder immediately
63
- - Otherwise: Keep files in the parent type folder
64
-
65
- ### Route Structure (**)
66
- - `_routes` structure must match API paths
67
- - Each route folder contains related controllers and services
68
-
69
- ### Module Structure (***)
70
- - `_modules` contains reusable, self-contained modules
71
- - Each module folder must contain the standard structure:
72
- - `_collections/` - module-specific collections
73
- - `_enums/` - module-specific enums
74
- - `_models/` - module-specific models (control-models, data-models, interfaces)
75
- - `_services/` - module-specific services
76
- - Module folders follow the same naming conventions as routes
77
- - Modules are organized in a flat structure within `_modules`
78
-
79
- ### Naming Convention
80
- - Prefix type-folders with "_" for better visual hierarchy
81
- - Only create type-folders when they contain content
82
- - All modules must be in the main modules folder
83
- - No nested module folders within modules
84
-
85
- ## Module Organization
1
+ ---
2
+ description: when creating backend structure, backend module or backend folders.
3
+ alwaysApply: false
4
+ ---
5
+ # Backend Project Structure [FDP-BE]
6
+
7
+ ## Overview
8
+ This document outlines the standard project structure for FDP backend applications.
9
+
10
+ ## Directory Structure
11
+
12
+ ```
13
+ 📁 app/
14
+ ├── 📁 _assets/
15
+ ├── 📁 _collections/
16
+ │ ├── 📁 email(*)/
17
+ │ ├── 📁 consts(*)/
18
+ │ ├── 📁 mocks(*)/
19
+ │ └── 📁 utils(*)/
20
+ ├── 📁 _enums/
21
+ ├── 📁 _models/
22
+ │ ├── 📁 control-models(*)/
23
+ │ ├── 📁 data-models(*)/
24
+ │ └── 📁 interfaces(*)/
25
+ ├── 📁 _modules/
26
+ │ ├── 📁 moduleName/
27
+ │ │ ├── 📁 _collections/
28
+ │ │ ├── 📁 _enums/
29
+ │ │ ├── 📁 _models/
30
+ │ │ └── 📁 _services/
31
+ │ └── 📁 anotherModule/
32
+ │ ├── 📁 _collections/
33
+ │ ├── 📁 _enums/
34
+ │ ├── 📁 _models/
35
+ │ └── 📁 _services/
36
+ └── 📁 _routes(**)
37
+ ├── 📁 user/
38
+ │ ├── 📁 user/
39
+ │ │ ├── user.controller.ts
40
+ │ │ └── user.data-service.ts
41
+ │ ├── 📁 userData/
42
+ │ │ ├── user-data.controller.ts
43
+ │ │ └── user-data.data-service.ts
44
+ │ └── 📁 userCarts/
45
+ │ ├── user-carts.controller.ts
46
+ │ └── user-carts.data-service.ts
47
+ ├── 📁 products/
48
+ └── 📁 server/
49
+ ├── 📁 server-status/
50
+ ├── 📁 error/
51
+ ├── 📁 _socket-services/
52
+ └── 📁 core-services/
53
+ ├── 📁 api-services/
54
+ └── 📁 email-services/
55
+ ```
56
+
57
+ ## Directory Guidelines
58
+
59
+ ### Folder Creation Rules (*)
60
+ - Create subfolders only when containing 3-5+ elements
61
+ - For 3+ elements: Consider if it will grow to 5+
62
+ - If likely to reach 5+: Create subfolder immediately
63
+ - Otherwise: Keep files in the parent type folder
64
+
65
+ ### Route Structure (**)
66
+ - `_routes` structure must match API paths
67
+ - Each route folder contains related controllers and services
68
+
69
+ ### Module Structure (***)
70
+ - `_modules` contains reusable, self-contained modules
71
+ - Each module folder must contain the standard structure:
72
+ - `_collections/` - module-specific collections
73
+ - `_enums/` - module-specific enums
74
+ - `_models/` - module-specific models (control-models, data-models, interfaces)
75
+ - `_services/` - module-specific services
76
+ - Module folders follow the same naming conventions as routes
77
+ - Modules are organized in a flat structure within `_modules`
78
+
79
+ ### Naming Convention
80
+ - Prefix type-folders with "_" for better visual hierarchy
81
+ - Only create type-folders when they contain content
82
+ - All modules must be in the main modules folder
83
+ - No nested module folders within modules
84
+
85
+ ## Module Organization
86
86
  Modules should be organized in a flat structure within the main modules folder. Each module follows the same internal structure with `_collections`, `_enums`, `_models`, and `_services` folders.
@@ -1,16 +1,16 @@
1
- ---
2
- description: when creating backend development
3
- alwaysApply: false
4
- ---
5
- # Backend Development Guidelines
6
-
7
- ## Project Structure
8
- - Follow the structure defined in [Backend Project Structure](backend-structure.md)
9
-
10
- ## Error Handling
11
- - Use try-catch blocks for ALL operations
12
- - Implement proper error logging
13
- - Use standardized error codes (see [Error Code Pattern](error_code_pattern.md))
14
- - Handle all edge cases
15
- - Validate all inputs
16
-
1
+ ---
2
+ description: when creating backend development
3
+ alwaysApply: false
4
+ ---
5
+ # Backend Development Guidelines
6
+
7
+ ## Project Structure
8
+ - Follow the structure defined in [Backend Project Structure](backend-structure.md)
9
+
10
+ ## Error Handling
11
+ - Use try-catch blocks for ALL operations
12
+ - Implement proper error logging
13
+ - Use standardized error codes (see [Error Code Pattern](error_code_pattern.md))
14
+ - Handle all edge cases
15
+ - Validate all inputs
16
+
@@ -1,87 +1,87 @@
1
- ---
2
- description: when creating frontend- structure, module, or new folders.
3
- alwaysApply: false
4
- ---
5
- # Frontend Project Structure [FDP-FE]
6
-
7
- ## Overview
8
- This document outlines the standard project structure for FDP frontend applications.
9
-
10
- ## Directory Structure
11
-
12
- ```
13
- 📁 app/
14
- ├── 📁 _collections/
15
- │ ├── 📁 consts(*)/
16
- │ ├── 📁 mocks(*)/
17
- │ └── 📁 utils(*)/
18
- ├── 📁 _components/
19
- │ ├── 📁 <core-component-1>/
20
- │ ├── 📁 <core-component-2>/
21
- │ └── 📁 <core-component-group-1(*)>/
22
- ├── 📁 _directives/
23
- ├── 📁 _enums/
24
- ├── 📁 _models/
25
- │ ├── 📁 control-models(*)/
26
- │ ├── 📁 data-models(*)/
27
- │ └── 📁 interfaces(*)/
28
- ├── 📁 _modules/
29
- │ ├── 📁 shared/
30
- │ │ ├── 📁 _collections/
31
- │ │ ├── 📁 _components/
32
- │ │ │ ├── 📁 s-<shared-component-1(**)>/
33
- │ │ │ └── 📁 s-<shared-component-2(**)>/
34
- │ │ ├── 📁 _directives/
35
- │ │ ├── 📁 _enums/
36
- │ │ ├── 📁 _models/
37
- │ │ ├── 📁 _pipes/
38
- │ │ └── 📁 _services/
39
- │ ├── 📁 shared-standalones/
40
- │ ├── 📁 <module-sample>/
41
- │ │ ├── 📁 _collections/
42
- │ │ ├── 📁 _components/
43
- │ │ │ ├── 📁 ms-<component-1(**)>/
44
- │ │ │ └── 📁 ms-<component-2(**)>/
45
- │ └── 📁 <other-module>/
46
- ├── 📁 _pipes/
47
- │ ├── 📁 <pipe-1>/
48
- │ └── 📁 <pipe-2>/
49
- └── 📁 _services/
50
- ├── 📁 api-services(*)/
51
- ├── 📁 control-services(*)/
52
- └── 📁 data-services(*)/
53
- ```
54
-
55
- ## Directory Guidelines
56
-
57
- ### Folder Creation Rules (*)
58
- - Create subfolders only when containing 3-5+ elements
59
- - For 3+ elements: Consider if it will grow to 5+
60
- - If likely to reach 5+: Create subfolder immediately
61
- - Otherwise: Keep files in the parent type folder
62
-
63
- ### Component Naming (**)
64
- - Prefix components with module identifier (2-3 letters)
65
- - Shared components: 's-'
66
- - Module-specific: 'ms-', 'om-', 'ad-', 'dod-', etc.
67
- - Helps with:
68
- - Easy navigation
69
- - Module identification
70
- - Preventing naming conflicts
71
-
72
- ### Type Folder Convention
73
- - Prefix type-folders with "_" (e.g., _components, _services)
74
- - Only create when containing content
75
- - Helps identify project layer visually
76
-
77
- ### Module Organization
78
- - All modules must be in the main _modules folder
79
- - No nested module folders within modules
80
- - Standard module structure includes:
81
- - _collections
82
- - _components
83
- - _directives
84
- - _enums
85
- - _models
86
- - _pipes
1
+ ---
2
+ description: when creating frontend- structure, module, or new folders.
3
+ alwaysApply: false
4
+ ---
5
+ # Frontend Project Structure [FDP-FE]
6
+
7
+ ## Overview
8
+ This document outlines the standard project structure for FDP frontend applications.
9
+
10
+ ## Directory Structure
11
+
12
+ ```
13
+ 📁 app/
14
+ ├── 📁 _collections/
15
+ │ ├── 📁 consts(*)/
16
+ │ ├── 📁 mocks(*)/
17
+ │ └── 📁 utils(*)/
18
+ ├── 📁 _components/
19
+ │ ├── 📁 <core-component-1>/
20
+ │ ├── 📁 <core-component-2>/
21
+ │ └── 📁 <core-component-group-1(*)>/
22
+ ├── 📁 _directives/
23
+ ├── 📁 _enums/
24
+ ├── 📁 _models/
25
+ │ ├── 📁 control-models(*)/
26
+ │ ├── 📁 data-models(*)/
27
+ │ └── 📁 interfaces(*)/
28
+ ├── 📁 _modules/
29
+ │ ├── 📁 shared/
30
+ │ │ ├── 📁 _collections/
31
+ │ │ ├── 📁 _components/
32
+ │ │ │ ├── 📁 s-<shared-component-1(**)>/
33
+ │ │ │ └── 📁 s-<shared-component-2(**)>/
34
+ │ │ ├── 📁 _directives/
35
+ │ │ ├── 📁 _enums/
36
+ │ │ ├── 📁 _models/
37
+ │ │ ├── 📁 _pipes/
38
+ │ │ └── 📁 _services/
39
+ │ ├── 📁 shared-standalones/
40
+ │ ├── 📁 <module-sample>/
41
+ │ │ ├── 📁 _collections/
42
+ │ │ ├── 📁 _components/
43
+ │ │ │ ├── 📁 ms-<component-1(**)>/
44
+ │ │ │ └── 📁 ms-<component-2(**)>/
45
+ │ └── 📁 <other-module>/
46
+ ├── 📁 _pipes/
47
+ │ ├── 📁 <pipe-1>/
48
+ │ └── 📁 <pipe-2>/
49
+ └── 📁 _services/
50
+ ├── 📁 api-services(*)/
51
+ ├── 📁 control-services(*)/
52
+ └── 📁 data-services(*)/
53
+ ```
54
+
55
+ ## Directory Guidelines
56
+
57
+ ### Folder Creation Rules (*)
58
+ - Create subfolders only when containing 3-5+ elements
59
+ - For 3+ elements: Consider if it will grow to 5+
60
+ - If likely to reach 5+: Create subfolder immediately
61
+ - Otherwise: Keep files in the parent type folder
62
+
63
+ ### Component Naming (**)
64
+ - Prefix components with module identifier (2-3 letters)
65
+ - Shared components: 's-'
66
+ - Module-specific: 'ms-', 'om-', 'ad-', 'dod-', etc.
67
+ - Helps with:
68
+ - Easy navigation
69
+ - Module identification
70
+ - Preventing naming conflicts
71
+
72
+ ### Type Folder Convention
73
+ - Prefix type-folders with "_" (e.g., _components, _services)
74
+ - Only create when containing content
75
+ - Helps identify project layer visually
76
+
77
+ ### Module Organization
78
+ - All modules must be in the main _modules folder
79
+ - No nested module folders within modules
80
+ - Standard module structure includes:
81
+ - _collections
82
+ - _components
83
+ - _directives
84
+ - _enums
85
+ - _models
86
+ - _pipes
87
87
  - _services
@@ -1,40 +1,40 @@
1
- ---
2
- description: when creating front-end implementations
3
- alwaysApply: false
4
- ---
5
- # FDP FronEnd development Guide
6
-
7
- ## Tech Stack
8
- - Use Angular latest version
9
- - Use Tailwind for SCSS Styles
10
- - Use the following tech stack: use Angular, Typescript, tailwind, DyNX_, DyFM_, DyNM_, FDP_, FDPNX_
11
-
12
- ## Angular
13
-
14
- ## Project Structure
15
- - Follow the structure defined in [Frontend Project Structure](frontend-structure.md)
16
-
17
- ### Components
18
- - After 4+ rows, always create separate HTML file
19
-
20
- ### Typescript
21
- - Use Signals
22
- - For Signal properties use "_$" postfix
23
- - For Subjects use "_S" postfix
24
- - For BehaviourSubjects use "_BS" postfix
25
- - For Observables use "$" postfix
26
- - Use async methods
27
- - ng methods as ngOnInit should never be a promise since they won't wait for async functions
28
- - Don't implement ngOnInit if not needed/used.
29
- - for any buttons we should use dynamo new button
30
- - For data handlings, use data handlers and data services across multiple components whenever we need to handle data.
31
-
32
- ### HTML
33
- - NEVER EVER use methods in HTML templates for getting data
34
- - Put empty lines between HTML elements in the same level
35
- - Use "@if" syntax in HTML instead of "*ngIf" for Angular
36
- - Use Tailwind classes and only create SCSS if needed, e.g. for animated elements
37
- - In HTML templates you should never ever use functions to display data or evaluate HTML tag rendering methods only allowed for event triggers! Use signal computed values or pipes for evaluations and pipings.
38
-
39
- ## Naming
1
+ ---
2
+ description: when creating front-end implementations
3
+ alwaysApply: false
4
+ ---
5
+ # FDP FronEnd development Guide
6
+
7
+ ## Tech Stack
8
+ - Use Angular latest version
9
+ - Use Tailwind for SCSS Styles
10
+ - Use the following tech stack: use Angular, Typescript, tailwind, DyNX_, DyFM_, DyNM_, FDP_, FDPNX_
11
+
12
+ ## Angular
13
+
14
+ ## Project Structure
15
+ - Follow the structure defined in [Frontend Project Structure](frontend-structure.md)
16
+
17
+ ### Components
18
+ - After 4+ rows, always create separate HTML file
19
+
20
+ ### Typescript
21
+ - Use Signals
22
+ - For Signal properties use "_$" postfix
23
+ - For Subjects use "_S" postfix
24
+ - For BehaviourSubjects use "_BS" postfix
25
+ - For Observables use "$" postfix
26
+ - Use async methods
27
+ - ng methods as ngOnInit should never be a promise since they won't wait for async functions
28
+ - Don't implement ngOnInit if not needed/used.
29
+ - for any buttons we should use dynamo new button
30
+ - For data handlings, use data handlers and data services across multiple components whenever we need to handle data.
31
+
32
+ ### HTML
33
+ - NEVER EVER use methods in HTML templates for getting data
34
+ - Put empty lines between HTML elements in the same level
35
+ - Use "@if" syntax in HTML instead of "*ngIf" for Angular
36
+ - Use Tailwind classes and only create SCSS if needed, e.g. for animated elements
37
+ - In HTML templates you should never ever use functions to display data or evaluate HTML tag rendering methods only allowed for event triggers! Use signal computed values or pipes for evaluations and pipings.
38
+
39
+ ## Naming
40
40
  - Read and follow [Naming](_ag_naming.mdc) conventions