@the-bearded-bear/claude-craft 3.4.0 → 3.5.0-next.0f69fca

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 (544) hide show
  1. package/Dev/i18n/de/Common/skills/documentation/SKILL.md +1 -1
  2. package/Dev/i18n/de/Common/skills/git-workflow/SKILL.md +1 -1
  3. package/Dev/i18n/de/Common/skills/kiss-dry-yagni/SKILL.md +1 -1
  4. package/Dev/i18n/de/Common/skills/security/SKILL.md +1 -1
  5. package/Dev/i18n/de/Common/skills/solid-principles/SKILL.md +1 -1
  6. package/Dev/i18n/de/Common/skills/testing/SKILL.md +1 -1
  7. package/Dev/i18n/de/Common/skills/workflow-analysis/SKILL.md +1 -1
  8. package/Dev/i18n/de/Common/templates/CLAUDE.md.template +56 -39
  9. package/Dev/i18n/de/Flutter/skills/architecture/SKILL.md +1 -1
  10. package/Dev/i18n/de/Flutter/skills/coding-standards/SKILL.md +1 -1
  11. package/Dev/i18n/de/Flutter/skills/performance/SKILL.md +1 -1
  12. package/Dev/i18n/de/Flutter/skills/quality-tools/SKILL.md +1 -1
  13. package/Dev/i18n/de/Flutter/skills/security-flutter/SKILL.md +1 -1
  14. package/Dev/i18n/de/Flutter/skills/state-management/SKILL.md +1 -1
  15. package/Dev/i18n/de/Flutter/skills/testing-flutter/SKILL.md +1 -1
  16. package/Dev/i18n/de/Flutter/skills/tooling/SKILL.md +1 -1
  17. package/Dev/i18n/de/Python/skills/architecture/SKILL.md +1 -1
  18. package/Dev/i18n/de/Python/skills/coding-standards/SKILL.md +1 -1
  19. package/Dev/i18n/de/Python/skills/testing-python/SKILL.md +1 -1
  20. package/Dev/i18n/de/Python/skills/tooling/SKILL.md +1 -1
  21. package/Dev/i18n/de/React/skills/architecture/SKILL.md +1 -1
  22. package/Dev/i18n/de/React/skills/coding-standards/SKILL.md +1 -1
  23. package/Dev/i18n/de/React/skills/quality-tools/SKILL.md +1 -1
  24. package/Dev/i18n/de/React/skills/security-react/SKILL.md +1 -1
  25. package/Dev/i18n/de/React/skills/testing-react/SKILL.md +1 -1
  26. package/Dev/i18n/de/React/skills/tooling/SKILL.md +1 -1
  27. package/Dev/i18n/de/ReactNative/skills/architecture/SKILL.md +1 -1
  28. package/Dev/i18n/de/ReactNative/skills/coding-standards/SKILL.md +1 -1
  29. package/Dev/i18n/de/ReactNative/skills/navigation/SKILL.md +1 -1
  30. package/Dev/i18n/de/ReactNative/skills/performance/SKILL.md +1 -1
  31. package/Dev/i18n/de/ReactNative/skills/quality-tools/SKILL.md +1 -1
  32. package/Dev/i18n/de/ReactNative/skills/security-reactnative/SKILL.md +1 -1
  33. package/Dev/i18n/de/ReactNative/skills/state-management/SKILL.md +1 -1
  34. package/Dev/i18n/de/ReactNative/skills/testing-reactnative/SKILL.md +1 -1
  35. package/Dev/i18n/de/ReactNative/skills/tooling/SKILL.md +1 -1
  36. package/Dev/i18n/de/Symfony/skills/aggregates/SKILL.md +1 -1
  37. package/Dev/i18n/de/Symfony/skills/architecture-clean-ddd/SKILL.md +1 -1
  38. package/Dev/i18n/de/Symfony/skills/async/SKILL.md +1 -1
  39. package/Dev/i18n/de/Symfony/skills/coding-standards/SKILL.md +1 -1
  40. package/Dev/i18n/de/Symfony/skills/cqrs/SKILL.md +1 -1
  41. package/Dev/i18n/de/Symfony/skills/ddd-patterns/SKILL.md +1 -1
  42. package/Dev/i18n/de/Symfony/skills/docker-hadolint/SKILL.md +1 -1
  43. package/Dev/i18n/de/Symfony/skills/doctrine-extensions/SKILL.md +1 -1
  44. package/Dev/i18n/de/Symfony/skills/domain-events/SKILL.md +1 -1
  45. package/Dev/i18n/de/Symfony/skills/i18n/SKILL.md +1 -1
  46. package/Dev/i18n/de/Symfony/skills/multitenant/SKILL.md +1 -1
  47. package/Dev/i18n/de/Symfony/skills/performance/SKILL.md +1 -1
  48. package/Dev/i18n/de/Symfony/skills/quality-tools/SKILL.md +1 -1
  49. package/Dev/i18n/de/Symfony/skills/security-symfony/SKILL.md +1 -1
  50. package/Dev/i18n/de/Symfony/skills/testing-symfony/SKILL.md +1 -1
  51. package/Dev/i18n/de/Symfony/skills/value-objects/SKILL.md +1 -1
  52. package/Dev/i18n/en/Common/skills/documentation/SKILL.md +1 -1
  53. package/Dev/i18n/en/Common/skills/git-workflow/SKILL.md +1 -1
  54. package/Dev/i18n/en/Common/skills/kiss-dry-yagni/SKILL.md +1 -1
  55. package/Dev/i18n/en/Common/skills/security/SKILL.md +1 -1
  56. package/Dev/i18n/en/Common/skills/solid-principles/SKILL.md +1 -1
  57. package/Dev/i18n/en/Common/skills/testing/SKILL.md +1 -1
  58. package/Dev/i18n/en/Common/skills/workflow-analysis/SKILL.md +1 -1
  59. package/Dev/i18n/en/Flutter/skills/architecture/SKILL.md +1 -1
  60. package/Dev/i18n/en/Flutter/skills/coding-standards/SKILL.md +1 -1
  61. package/Dev/i18n/en/Flutter/skills/performance/SKILL.md +1 -1
  62. package/Dev/i18n/en/Flutter/skills/quality-tools/SKILL.md +1 -1
  63. package/Dev/i18n/en/Flutter/skills/security-flutter/SKILL.md +1 -1
  64. package/Dev/i18n/en/Flutter/skills/state-management/SKILL.md +1 -1
  65. package/Dev/i18n/en/Flutter/skills/testing-flutter/SKILL.md +1 -1
  66. package/Dev/i18n/en/Flutter/skills/tooling/SKILL.md +1 -1
  67. package/Dev/i18n/en/Python/rules/08-quality-tools.md +572 -0
  68. package/Dev/i18n/en/Python/rules/11-security-python.md +596 -0
  69. package/Dev/i18n/en/Python/skills/architecture/SKILL.md +1 -1
  70. package/Dev/i18n/en/Python/skills/coding-standards/SKILL.md +1 -1
  71. package/Dev/i18n/en/Python/skills/testing-python/SKILL.md +1 -1
  72. package/Dev/i18n/en/Python/skills/tooling/SKILL.md +1 -1
  73. package/Dev/i18n/en/React/skills/architecture/SKILL.md +1 -1
  74. package/Dev/i18n/en/React/skills/coding-standards/SKILL.md +1 -1
  75. package/Dev/i18n/en/React/skills/quality-tools/SKILL.md +1 -1
  76. package/Dev/i18n/en/React/skills/security-react/SKILL.md +1 -1
  77. package/Dev/i18n/en/React/skills/testing-react/SKILL.md +1 -1
  78. package/Dev/i18n/en/React/skills/tooling/SKILL.md +1 -1
  79. package/Dev/i18n/en/ReactNative/skills/architecture/SKILL.md +1 -1
  80. package/Dev/i18n/en/ReactNative/skills/coding-standards/SKILL.md +1 -1
  81. package/Dev/i18n/en/ReactNative/skills/navigation/SKILL.md +1 -1
  82. package/Dev/i18n/en/ReactNative/skills/performance/SKILL.md +1 -1
  83. package/Dev/i18n/en/ReactNative/skills/quality-tools/SKILL.md +1 -1
  84. package/Dev/i18n/en/ReactNative/skills/security-reactnative/SKILL.md +1 -1
  85. package/Dev/i18n/en/ReactNative/skills/state-management/SKILL.md +1 -1
  86. package/Dev/i18n/en/ReactNative/skills/testing-reactnative/SKILL.md +1 -1
  87. package/Dev/i18n/en/ReactNative/skills/tooling/SKILL.md +1 -1
  88. package/Dev/i18n/en/Symfony/skills/aggregates/SKILL.md +1 -1
  89. package/Dev/i18n/en/Symfony/skills/architecture-clean-ddd/SKILL.md +1 -1
  90. package/Dev/i18n/en/Symfony/skills/async/SKILL.md +1 -1
  91. package/Dev/i18n/en/Symfony/skills/coding-standards/SKILL.md +1 -1
  92. package/Dev/i18n/en/Symfony/skills/cqrs/SKILL.md +1 -1
  93. package/Dev/i18n/en/Symfony/skills/ddd-patterns/SKILL.md +1 -1
  94. package/Dev/i18n/en/Symfony/skills/docker-hadolint/SKILL.md +1 -1
  95. package/Dev/i18n/en/Symfony/skills/doctrine-extensions/SKILL.md +1 -1
  96. package/Dev/i18n/en/Symfony/skills/domain-events/SKILL.md +1 -1
  97. package/Dev/i18n/en/Symfony/skills/i18n/SKILL.md +1 -1
  98. package/Dev/i18n/en/Symfony/skills/multitenant/SKILL.md +1 -1
  99. package/Dev/i18n/en/Symfony/skills/performance/SKILL.md +1 -1
  100. package/Dev/i18n/en/Symfony/skills/quality-tools/SKILL.md +1 -1
  101. package/Dev/i18n/en/Symfony/skills/security-symfony/SKILL.md +1 -1
  102. package/Dev/i18n/en/Symfony/skills/testing-symfony/SKILL.md +1 -1
  103. package/Dev/i18n/en/Symfony/skills/value-objects/SKILL.md +1 -1
  104. package/Dev/i18n/es/Common/skills/documentation/SKILL.md +1 -1
  105. package/Dev/i18n/es/Common/skills/git-workflow/SKILL.md +1 -1
  106. package/Dev/i18n/es/Common/skills/kiss-dry-yagni/SKILL.md +1 -1
  107. package/Dev/i18n/es/Common/skills/security/SKILL.md +1 -1
  108. package/Dev/i18n/es/Common/skills/solid-principles/SKILL.md +1 -1
  109. package/Dev/i18n/es/Common/skills/testing/SKILL.md +1 -1
  110. package/Dev/i18n/es/Common/skills/workflow-analysis/SKILL.md +1 -1
  111. package/Dev/i18n/es/Common/templates/CLAUDE.md.template +57 -40
  112. package/Dev/i18n/es/Flutter/skills/architecture/SKILL.md +1 -1
  113. package/Dev/i18n/es/Flutter/skills/coding-standards/SKILL.md +1 -1
  114. package/Dev/i18n/es/Flutter/skills/performance/SKILL.md +1 -1
  115. package/Dev/i18n/es/Flutter/skills/quality-tools/SKILL.md +1 -1
  116. package/Dev/i18n/es/Flutter/skills/security-flutter/SKILL.md +1 -1
  117. package/Dev/i18n/es/Flutter/skills/state-management/SKILL.md +1 -1
  118. package/Dev/i18n/es/Flutter/skills/testing-flutter/SKILL.md +1 -1
  119. package/Dev/i18n/es/Flutter/skills/tooling/SKILL.md +1 -1
  120. package/Dev/i18n/es/Python/skills/architecture/SKILL.md +1 -1
  121. package/Dev/i18n/es/Python/skills/coding-standards/SKILL.md +1 -1
  122. package/Dev/i18n/es/Python/skills/testing-python/SKILL.md +1 -1
  123. package/Dev/i18n/es/Python/skills/tooling/SKILL.md +1 -1
  124. package/Dev/i18n/es/React/skills/architecture/SKILL.md +1 -1
  125. package/Dev/i18n/es/React/skills/coding-standards/SKILL.md +1 -1
  126. package/Dev/i18n/es/React/skills/quality-tools/SKILL.md +1 -1
  127. package/Dev/i18n/es/React/skills/security-react/SKILL.md +1 -1
  128. package/Dev/i18n/es/React/skills/testing-react/SKILL.md +1 -1
  129. package/Dev/i18n/es/React/skills/tooling/SKILL.md +1 -1
  130. package/Dev/i18n/es/ReactNative/skills/architecture/SKILL.md +1 -1
  131. package/Dev/i18n/es/ReactNative/skills/coding-standards/SKILL.md +1 -1
  132. package/Dev/i18n/es/ReactNative/skills/navigation/SKILL.md +1 -1
  133. package/Dev/i18n/es/ReactNative/skills/performance/SKILL.md +1 -1
  134. package/Dev/i18n/es/ReactNative/skills/quality-tools/SKILL.md +1 -1
  135. package/Dev/i18n/es/ReactNative/skills/security-reactnative/SKILL.md +1 -1
  136. package/Dev/i18n/es/ReactNative/skills/state-management/SKILL.md +1 -1
  137. package/Dev/i18n/es/ReactNative/skills/testing-reactnative/SKILL.md +1 -1
  138. package/Dev/i18n/es/ReactNative/skills/tooling/SKILL.md +1 -1
  139. package/Dev/i18n/es/Symfony/skills/aggregates/SKILL.md +1 -1
  140. package/Dev/i18n/es/Symfony/skills/architecture-clean-ddd/SKILL.md +1 -1
  141. package/Dev/i18n/es/Symfony/skills/async/SKILL.md +1 -1
  142. package/Dev/i18n/es/Symfony/skills/coding-standards/SKILL.md +1 -1
  143. package/Dev/i18n/es/Symfony/skills/cqrs/SKILL.md +1 -1
  144. package/Dev/i18n/es/Symfony/skills/ddd-patterns/SKILL.md +1 -1
  145. package/Dev/i18n/es/Symfony/skills/docker-hadolint/SKILL.md +1 -1
  146. package/Dev/i18n/es/Symfony/skills/doctrine-extensions/SKILL.md +1 -1
  147. package/Dev/i18n/es/Symfony/skills/domain-events/SKILL.md +1 -1
  148. package/Dev/i18n/es/Symfony/skills/i18n/SKILL.md +1 -1
  149. package/Dev/i18n/es/Symfony/skills/multitenant/SKILL.md +1 -1
  150. package/Dev/i18n/es/Symfony/skills/performance/SKILL.md +1 -1
  151. package/Dev/i18n/es/Symfony/skills/quality-tools/SKILL.md +1 -1
  152. package/Dev/i18n/es/Symfony/skills/security-symfony/SKILL.md +1 -1
  153. package/Dev/i18n/es/Symfony/skills/testing-symfony/SKILL.md +1 -1
  154. package/Dev/i18n/es/Symfony/skills/value-objects/SKILL.md +1 -1
  155. package/Dev/i18n/fr/Common/skills/documentation/SKILL.md +1 -1
  156. package/Dev/i18n/fr/Common/skills/git-workflow/SKILL.md +1 -1
  157. package/Dev/i18n/fr/Common/skills/kiss-dry-yagni/SKILL.md +1 -1
  158. package/Dev/i18n/fr/Common/skills/security/SKILL.md +1 -1
  159. package/Dev/i18n/fr/Common/skills/solid-principles/SKILL.md +1 -1
  160. package/Dev/i18n/fr/Common/skills/testing/SKILL.md +1 -1
  161. package/Dev/i18n/fr/Common/skills/workflow-analysis/SKILL.md +1 -1
  162. package/Dev/i18n/fr/Common/templates/CLAUDE.md.template +56 -39
  163. package/Dev/i18n/fr/Flutter/skills/architecture/SKILL.md +1 -1
  164. package/Dev/i18n/fr/Flutter/skills/coding-standards/SKILL.md +1 -1
  165. package/Dev/i18n/fr/Flutter/skills/performance/SKILL.md +1 -1
  166. package/Dev/i18n/fr/Flutter/skills/quality-tools/SKILL.md +1 -1
  167. package/Dev/i18n/fr/Flutter/skills/security-flutter/SKILL.md +1 -1
  168. package/Dev/i18n/fr/Flutter/skills/state-management/SKILL.md +1 -1
  169. package/Dev/i18n/fr/Flutter/skills/testing-flutter/SKILL.md +1 -1
  170. package/Dev/i18n/fr/Flutter/skills/tooling/SKILL.md +1 -1
  171. package/Dev/i18n/fr/Python/skills/architecture/SKILL.md +1 -1
  172. package/Dev/i18n/fr/Python/skills/coding-standards/SKILL.md +1 -1
  173. package/Dev/i18n/fr/Python/skills/testing-python/SKILL.md +1 -1
  174. package/Dev/i18n/fr/Python/skills/tooling/SKILL.md +1 -1
  175. package/Dev/i18n/fr/React/skills/architecture/SKILL.md +1 -1
  176. package/Dev/i18n/fr/React/skills/coding-standards/SKILL.md +1 -1
  177. package/Dev/i18n/fr/React/skills/quality-tools/SKILL.md +1 -1
  178. package/Dev/i18n/fr/React/skills/security-react/SKILL.md +1 -1
  179. package/Dev/i18n/fr/React/skills/testing-react/SKILL.md +1 -1
  180. package/Dev/i18n/fr/React/skills/tooling/SKILL.md +1 -1
  181. package/Dev/i18n/fr/ReactNative/skills/architecture/SKILL.md +1 -1
  182. package/Dev/i18n/fr/ReactNative/skills/coding-standards/SKILL.md +1 -1
  183. package/Dev/i18n/fr/ReactNative/skills/navigation/SKILL.md +1 -1
  184. package/Dev/i18n/fr/ReactNative/skills/performance/SKILL.md +1 -1
  185. package/Dev/i18n/fr/ReactNative/skills/quality-tools/SKILL.md +1 -1
  186. package/Dev/i18n/fr/ReactNative/skills/security-reactnative/SKILL.md +1 -1
  187. package/Dev/i18n/fr/ReactNative/skills/state-management/SKILL.md +1 -1
  188. package/Dev/i18n/fr/ReactNative/skills/testing-reactnative/SKILL.md +1 -1
  189. package/Dev/i18n/fr/ReactNative/skills/tooling/SKILL.md +1 -1
  190. package/Dev/i18n/fr/Symfony/skills/aggregates/SKILL.md +1 -1
  191. package/Dev/i18n/fr/Symfony/skills/architecture-clean-ddd/SKILL.md +1 -1
  192. package/Dev/i18n/fr/Symfony/skills/async/SKILL.md +1 -1
  193. package/Dev/i18n/fr/Symfony/skills/coding-standards/SKILL.md +1 -1
  194. package/Dev/i18n/fr/Symfony/skills/cqrs/SKILL.md +1 -1
  195. package/Dev/i18n/fr/Symfony/skills/ddd-patterns/SKILL.md +1 -1
  196. package/Dev/i18n/fr/Symfony/skills/docker-hadolint/SKILL.md +1 -1
  197. package/Dev/i18n/fr/Symfony/skills/doctrine-extensions/SKILL.md +1 -1
  198. package/Dev/i18n/fr/Symfony/skills/domain-events/SKILL.md +1 -1
  199. package/Dev/i18n/fr/Symfony/skills/i18n/SKILL.md +1 -1
  200. package/Dev/i18n/fr/Symfony/skills/multitenant/SKILL.md +1 -1
  201. package/Dev/i18n/fr/Symfony/skills/performance/SKILL.md +1 -1
  202. package/Dev/i18n/fr/Symfony/skills/quality-tools/SKILL.md +1 -1
  203. package/Dev/i18n/fr/Symfony/skills/security-symfony/SKILL.md +1 -1
  204. package/Dev/i18n/fr/Symfony/skills/testing-symfony/SKILL.md +1 -1
  205. package/Dev/i18n/fr/Symfony/skills/value-objects/SKILL.md +1 -1
  206. package/Dev/i18n/pt/Common/skills/documentation/SKILL.md +1 -1
  207. package/Dev/i18n/pt/Common/skills/git-workflow/SKILL.md +1 -1
  208. package/Dev/i18n/pt/Common/skills/kiss-dry-yagni/SKILL.md +1 -1
  209. package/Dev/i18n/pt/Common/skills/security/SKILL.md +1 -1
  210. package/Dev/i18n/pt/Common/skills/solid-principles/SKILL.md +1 -1
  211. package/Dev/i18n/pt/Common/skills/testing/SKILL.md +1 -1
  212. package/Dev/i18n/pt/Common/skills/workflow-analysis/SKILL.md +1 -1
  213. package/Dev/i18n/pt/Common/templates/CLAUDE.md.template +56 -39
  214. package/Dev/i18n/pt/Flutter/skills/architecture/SKILL.md +1 -1
  215. package/Dev/i18n/pt/Flutter/skills/coding-standards/SKILL.md +1 -1
  216. package/Dev/i18n/pt/Flutter/skills/performance/SKILL.md +1 -1
  217. package/Dev/i18n/pt/Flutter/skills/quality-tools/SKILL.md +1 -1
  218. package/Dev/i18n/pt/Flutter/skills/security-flutter/SKILL.md +1 -1
  219. package/Dev/i18n/pt/Flutter/skills/state-management/SKILL.md +1 -1
  220. package/Dev/i18n/pt/Flutter/skills/tooling/SKILL.md +1 -1
  221. package/Dev/i18n/pt/Python/skills/architecture/SKILL.md +1 -1
  222. package/Dev/i18n/pt/Python/skills/coding-standards/SKILL.md +1 -1
  223. package/Dev/i18n/pt/Python/skills/testing-python/SKILL.md +1 -1
  224. package/Dev/i18n/pt/Python/skills/tooling/SKILL.md +1 -1
  225. package/Dev/i18n/pt/React/skills/architecture/SKILL.md +1 -1
  226. package/Dev/i18n/pt/React/skills/coding-standards/SKILL.md +1 -1
  227. package/Dev/i18n/pt/React/skills/quality-tools/SKILL.md +1 -1
  228. package/Dev/i18n/pt/React/skills/security-react/SKILL.md +1 -1
  229. package/Dev/i18n/pt/React/skills/testing-react/SKILL.md +1 -1
  230. package/Dev/i18n/pt/React/skills/tooling/SKILL.md +1 -1
  231. package/Dev/i18n/pt/ReactNative/skills/architecture/SKILL.md +1 -1
  232. package/Dev/i18n/pt/ReactNative/skills/coding-standards/SKILL.md +1 -1
  233. package/Dev/i18n/pt/ReactNative/skills/navigation/SKILL.md +1 -1
  234. package/Dev/i18n/pt/ReactNative/skills/performance/SKILL.md +1 -1
  235. package/Dev/i18n/pt/ReactNative/skills/quality-tools/SKILL.md +1 -1
  236. package/Dev/i18n/pt/ReactNative/skills/security-reactnative/SKILL.md +1 -1
  237. package/Dev/i18n/pt/ReactNative/skills/state-management/SKILL.md +1 -1
  238. package/Dev/i18n/pt/ReactNative/skills/testing-reactnative/SKILL.md +1 -1
  239. package/Dev/i18n/pt/ReactNative/skills/tooling/SKILL.md +1 -1
  240. package/Dev/i18n/pt/Symfony/skills/aggregates/SKILL.md +1 -1
  241. package/Dev/i18n/pt/Symfony/skills/architecture-clean-ddd/SKILL.md +1 -1
  242. package/Dev/i18n/pt/Symfony/skills/async/SKILL.md +1 -1
  243. package/Dev/i18n/pt/Symfony/skills/coding-standards/SKILL.md +1 -1
  244. package/Dev/i18n/pt/Symfony/skills/cqrs/SKILL.md +1 -1
  245. package/Dev/i18n/pt/Symfony/skills/ddd-patterns/SKILL.md +1 -1
  246. package/Dev/i18n/pt/Symfony/skills/docker-hadolint/SKILL.md +1 -1
  247. package/Dev/i18n/pt/Symfony/skills/doctrine-extensions/SKILL.md +1 -1
  248. package/Dev/i18n/pt/Symfony/skills/domain-events/SKILL.md +1 -1
  249. package/Dev/i18n/pt/Symfony/skills/i18n/SKILL.md +1 -1
  250. package/Dev/i18n/pt/Symfony/skills/multitenant/SKILL.md +1 -1
  251. package/Dev/i18n/pt/Symfony/skills/performance/SKILL.md +1 -1
  252. package/Dev/i18n/pt/Symfony/skills/quality-tools/SKILL.md +1 -1
  253. package/Dev/i18n/pt/Symfony/skills/security-symfony/SKILL.md +1 -1
  254. package/Dev/i18n/pt/Symfony/skills/testing-symfony/SKILL.md +1 -1
  255. package/Dev/i18n/pt/Symfony/skills/value-objects/SKILL.md +1 -1
  256. package/Dev/scripts/install-angular-rules.sh +284 -203
  257. package/Dev/scripts/install-common-rules.sh +16 -2
  258. package/Dev/scripts/install-csharp-rules.sh +217 -193
  259. package/Dev/scripts/install-flutter-rules.sh +288 -206
  260. package/Dev/scripts/install-laravel-rules.sh +298 -209
  261. package/Dev/scripts/install-php-rules.sh +220 -206
  262. package/Dev/scripts/install-python-rules.sh +199 -200
  263. package/Dev/scripts/install-react-rules.sh +253 -204
  264. package/Dev/scripts/install-reactnative-rules.sh +275 -207
  265. package/Dev/scripts/install-symfony-rules.sh +356 -635
  266. package/Dev/scripts/install-vuejs-rules.sh +291 -300
  267. package/Dev/scripts/migrate-project.sh +3 -4
  268. package/Dev/scripts/tcl-common.sh +329 -0
  269. package/Project/i18n/de/commands/decompose-tasks.md +2 -2
  270. package/Project/i18n/de/commands/generate-backlog.md +6 -6
  271. package/Project/i18n/en/commands/decompose-tasks.md +2 -2
  272. package/Project/i18n/en/commands/generate-backlog.md +6 -6
  273. package/Project/i18n/es/commands/decompose-tasks.md +2 -2
  274. package/Project/i18n/es/commands/generate-backlog.md +6 -6
  275. package/Project/i18n/fr/commands/decompose-tasks.md +2 -2
  276. package/Project/i18n/fr/commands/generate-backlog.md +7 -7
  277. package/Project/i18n/pt/commands/decompose-tasks.md +2 -2
  278. package/Project/i18n/pt/commands/generate-backlog.md +6 -6
  279. package/README.md +30 -4
  280. package/package.json +1 -1
  281. package/Dev/i18n/de/Common/skills/documentation/REFERENCE.md +0 -555
  282. package/Dev/i18n/de/Common/skills/git-workflow/REFERENCE.md +0 -541
  283. package/Dev/i18n/de/Common/skills/kiss-dry-yagni/REFERENCE.md +0 -417
  284. package/Dev/i18n/de/Common/skills/security/REFERENCE.md +0 -540
  285. package/Dev/i18n/de/Common/skills/solid-principles/REFERENCE.md +0 -396
  286. package/Dev/i18n/de/Common/skills/testing/REFERENCE.md +0 -463
  287. package/Dev/i18n/de/Common/skills/workflow-analysis/REFERENCE.md +0 -226
  288. package/Dev/i18n/de/Flutter/skills/architecture/REFERENCE.md +0 -455
  289. package/Dev/i18n/de/Flutter/skills/coding-standards/REFERENCE.md +0 -247
  290. package/Dev/i18n/de/Flutter/skills/performance/REFERENCE.md +0 -230
  291. package/Dev/i18n/de/Flutter/skills/quality-tools/REFERENCE.md +0 -239
  292. package/Dev/i18n/de/Flutter/skills/security-flutter/REFERENCE.md +0 -247
  293. package/Dev/i18n/de/Flutter/skills/state-management/REFERENCE.md +0 -0
  294. package/Dev/i18n/de/Flutter/skills/testing-flutter/REFERENCE.md +0 -0
  295. package/Dev/i18n/de/Flutter/skills/tooling/REFERENCE.md +0 -542
  296. package/Dev/i18n/de/Python/skills/architecture/REFERENCE.md +0 -444
  297. package/Dev/i18n/de/Python/skills/coding-standards/REFERENCE.md +0 -572
  298. package/Dev/i18n/de/Python/skills/testing-python/REFERENCE.md +0 -387
  299. package/Dev/i18n/de/Python/skills/tooling/REFERENCE.md +0 -351
  300. package/Dev/i18n/de/React/skills/architecture/REFERENCE.md +0 -490
  301. package/Dev/i18n/de/React/skills/coding-standards/REFERENCE.md +0 -500
  302. package/Dev/i18n/de/React/skills/quality-tools/REFERENCE.md +0 -758
  303. package/Dev/i18n/de/React/skills/security-react/REFERENCE.md +0 -793
  304. package/Dev/i18n/de/React/skills/testing-react/REFERENCE.md +0 -999
  305. package/Dev/i18n/de/React/skills/tooling/REFERENCE.md +0 -777
  306. package/Dev/i18n/de/ReactNative/skills/architecture/REFERENCE.md +0 -1253
  307. package/Dev/i18n/de/ReactNative/skills/coding-standards/REFERENCE.md +0 -1230
  308. package/Dev/i18n/de/ReactNative/skills/navigation/REFERENCE.md +0 -601
  309. package/Dev/i18n/de/ReactNative/skills/performance/REFERENCE.md +0 -727
  310. package/Dev/i18n/de/ReactNative/skills/quality-tools/REFERENCE.md +0 -122
  311. package/Dev/i18n/de/ReactNative/skills/security-reactnative/REFERENCE.md +0 -719
  312. package/Dev/i18n/de/ReactNative/skills/state-management/REFERENCE.md +0 -607
  313. package/Dev/i18n/de/ReactNative/skills/testing-reactnative/REFERENCE.md +0 -386
  314. package/Dev/i18n/de/ReactNative/skills/tooling/REFERENCE.md +0 -281
  315. package/Dev/i18n/de/Symfony/skills/aggregates/REFERENCE.md +0 -115
  316. package/Dev/i18n/de/Symfony/skills/architecture-clean-ddd/REFERENCE.md +0 -813
  317. package/Dev/i18n/de/Symfony/skills/async/REFERENCE.md +0 -190
  318. package/Dev/i18n/de/Symfony/skills/coding-standards/REFERENCE.md +0 -402
  319. package/Dev/i18n/de/Symfony/skills/cqrs/REFERENCE.md +0 -426
  320. package/Dev/i18n/de/Symfony/skills/ddd-patterns/REFERENCE.md +0 -1220
  321. package/Dev/i18n/de/Symfony/skills/docker-hadolint/REFERENCE.md +0 -772
  322. package/Dev/i18n/de/Symfony/skills/doctrine-extensions/REFERENCE.md +0 -927
  323. package/Dev/i18n/de/Symfony/skills/domain-events/REFERENCE.md +0 -129
  324. package/Dev/i18n/de/Symfony/skills/i18n/REFERENCE.md +0 -185
  325. package/Dev/i18n/de/Symfony/skills/multitenant/REFERENCE.md +0 -432
  326. package/Dev/i18n/de/Symfony/skills/performance/REFERENCE.md +0 -888
  327. package/Dev/i18n/de/Symfony/skills/quality-tools/REFERENCE.md +0 -982
  328. package/Dev/i18n/de/Symfony/skills/security-symfony/REFERENCE.md +0 -353
  329. package/Dev/i18n/de/Symfony/skills/testing-symfony/REFERENCE.md +0 -452
  330. package/Dev/i18n/de/Symfony/skills/value-objects/REFERENCE.md +0 -536
  331. package/Dev/i18n/de/Symfony/templates/aggregate-examples.md +0 -1128
  332. package/Dev/i18n/de/Symfony/templates/domain-event-examples.md +0 -1091
  333. package/Dev/i18n/de/Symfony/templates/value-object-examples.md +0 -1129
  334. package/Dev/i18n/en/Common/skills/documentation/REFERENCE.md +0 -555
  335. package/Dev/i18n/en/Common/skills/git-workflow/REFERENCE.md +0 -541
  336. package/Dev/i18n/en/Common/skills/kiss-dry-yagni/REFERENCE.md +0 -417
  337. package/Dev/i18n/en/Common/skills/security/REFERENCE.md +0 -540
  338. package/Dev/i18n/en/Common/skills/solid-principles/REFERENCE.md +0 -396
  339. package/Dev/i18n/en/Common/skills/testing/REFERENCE.md +0 -463
  340. package/Dev/i18n/en/Common/skills/workflow-analysis/REFERENCE.md +0 -226
  341. package/Dev/i18n/en/Flutter/skills/architecture/REFERENCE.md +0 -455
  342. package/Dev/i18n/en/Flutter/skills/coding-standards/REFERENCE.md +0 -247
  343. package/Dev/i18n/en/Flutter/skills/performance/REFERENCE.md +0 -230
  344. package/Dev/i18n/en/Flutter/skills/quality-tools/REFERENCE.md +0 -239
  345. package/Dev/i18n/en/Flutter/skills/security-flutter/REFERENCE.md +0 -247
  346. package/Dev/i18n/en/Flutter/skills/state-management/REFERENCE.md +0 -0
  347. package/Dev/i18n/en/Flutter/skills/testing-flutter/REFERENCE.md +0 -0
  348. package/Dev/i18n/en/Flutter/skills/tooling/REFERENCE.md +0 -542
  349. package/Dev/i18n/en/Python/skills/architecture/REFERENCE.md +0 -444
  350. package/Dev/i18n/en/Python/skills/coding-standards/REFERENCE.md +0 -572
  351. package/Dev/i18n/en/Python/skills/testing-python/REFERENCE.md +0 -387
  352. package/Dev/i18n/en/Python/skills/tooling/REFERENCE.md +0 -351
  353. package/Dev/i18n/en/React/skills/architecture/REFERENCE.md +0 -651
  354. package/Dev/i18n/en/React/skills/coding-standards/REFERENCE.md +0 -716
  355. package/Dev/i18n/en/React/skills/quality-tools/REFERENCE.md +0 -758
  356. package/Dev/i18n/en/React/skills/security-react/REFERENCE.md +0 -793
  357. package/Dev/i18n/en/React/skills/testing-react/REFERENCE.md +0 -999
  358. package/Dev/i18n/en/React/skills/tooling/REFERENCE.md +0 -777
  359. package/Dev/i18n/en/ReactNative/skills/architecture/REFERENCE.md +0 -1253
  360. package/Dev/i18n/en/ReactNative/skills/coding-standards/REFERENCE.md +0 -1230
  361. package/Dev/i18n/en/ReactNative/skills/navigation/REFERENCE.md +0 -601
  362. package/Dev/i18n/en/ReactNative/skills/performance/REFERENCE.md +0 -727
  363. package/Dev/i18n/en/ReactNative/skills/quality-tools/REFERENCE.md +0 -122
  364. package/Dev/i18n/en/ReactNative/skills/security-reactnative/REFERENCE.md +0 -719
  365. package/Dev/i18n/en/ReactNative/skills/state-management/REFERENCE.md +0 -607
  366. package/Dev/i18n/en/ReactNative/skills/testing-reactnative/REFERENCE.md +0 -386
  367. package/Dev/i18n/en/ReactNative/skills/tooling/REFERENCE.md +0 -281
  368. package/Dev/i18n/en/Symfony/skills/aggregates/REFERENCE.md +0 -115
  369. package/Dev/i18n/en/Symfony/skills/architecture-clean-ddd/REFERENCE.md +0 -979
  370. package/Dev/i18n/en/Symfony/skills/async/REFERENCE.md +0 -190
  371. package/Dev/i18n/en/Symfony/skills/coding-standards/REFERENCE.md +0 -402
  372. package/Dev/i18n/en/Symfony/skills/cqrs/REFERENCE.md +0 -426
  373. package/Dev/i18n/en/Symfony/skills/ddd-patterns/REFERENCE.md +0 -1220
  374. package/Dev/i18n/en/Symfony/skills/docker-hadolint/REFERENCE.md +0 -767
  375. package/Dev/i18n/en/Symfony/skills/doctrine-extensions/REFERENCE.md +0 -927
  376. package/Dev/i18n/en/Symfony/skills/domain-events/REFERENCE.md +0 -129
  377. package/Dev/i18n/en/Symfony/skills/i18n/REFERENCE.md +0 -185
  378. package/Dev/i18n/en/Symfony/skills/multitenant/REFERENCE.md +0 -432
  379. package/Dev/i18n/en/Symfony/skills/performance/REFERENCE.md +0 -888
  380. package/Dev/i18n/en/Symfony/skills/quality-tools/REFERENCE.md +0 -982
  381. package/Dev/i18n/en/Symfony/skills/security-symfony/REFERENCE.md +0 -1055
  382. package/Dev/i18n/en/Symfony/skills/testing-symfony/REFERENCE.md +0 -1121
  383. package/Dev/i18n/en/Symfony/skills/value-objects/REFERENCE.md +0 -536
  384. package/Dev/i18n/en/Symfony/templates/aggregate-examples.md +0 -1128
  385. package/Dev/i18n/en/Symfony/templates/domain-event-examples.md +0 -1091
  386. package/Dev/i18n/en/Symfony/templates/value-object-examples.md +0 -1129
  387. package/Dev/i18n/es/Common/skills/documentation/REFERENCE.md +0 -555
  388. package/Dev/i18n/es/Common/skills/git-workflow/REFERENCE.md +0 -541
  389. package/Dev/i18n/es/Common/skills/kiss-dry-yagni/REFERENCE.md +0 -417
  390. package/Dev/i18n/es/Common/skills/security/REFERENCE.md +0 -540
  391. package/Dev/i18n/es/Common/skills/solid-principles/REFERENCE.md +0 -396
  392. package/Dev/i18n/es/Common/skills/testing/REFERENCE.md +0 -463
  393. package/Dev/i18n/es/Common/skills/workflow-analysis/REFERENCE.md +0 -226
  394. package/Dev/i18n/es/Flutter/skills/architecture/REFERENCE.md +0 -455
  395. package/Dev/i18n/es/Flutter/skills/coding-standards/REFERENCE.md +0 -247
  396. package/Dev/i18n/es/Flutter/skills/performance/REFERENCE.md +0 -230
  397. package/Dev/i18n/es/Flutter/skills/quality-tools/REFERENCE.md +0 -239
  398. package/Dev/i18n/es/Flutter/skills/security-flutter/REFERENCE.md +0 -247
  399. package/Dev/i18n/es/Flutter/skills/state-management/REFERENCE.md +0 -0
  400. package/Dev/i18n/es/Flutter/skills/testing-flutter/REFERENCE.md +0 -0
  401. package/Dev/i18n/es/Flutter/skills/tooling/REFERENCE.md +0 -542
  402. package/Dev/i18n/es/Python/skills/architecture/REFERENCE.md +0 -445
  403. package/Dev/i18n/es/Python/skills/coding-standards/REFERENCE.md +0 -572
  404. package/Dev/i18n/es/Python/skills/testing-python/REFERENCE.md +0 -387
  405. package/Dev/i18n/es/Python/skills/tooling/REFERENCE.md +0 -351
  406. package/Dev/i18n/es/React/skills/architecture/REFERENCE.md +0 -583
  407. package/Dev/i18n/es/React/skills/coding-standards/REFERENCE.md +0 -716
  408. package/Dev/i18n/es/React/skills/quality-tools/REFERENCE.md +0 -758
  409. package/Dev/i18n/es/React/skills/security-react/REFERENCE.md +0 -793
  410. package/Dev/i18n/es/React/skills/testing-react/REFERENCE.md +0 -999
  411. package/Dev/i18n/es/React/skills/tooling/REFERENCE.md +0 -777
  412. package/Dev/i18n/es/ReactNative/skills/architecture/REFERENCE.md +0 -1253
  413. package/Dev/i18n/es/ReactNative/skills/coding-standards/REFERENCE.md +0 -1230
  414. package/Dev/i18n/es/ReactNative/skills/navigation/REFERENCE.md +0 -601
  415. package/Dev/i18n/es/ReactNative/skills/performance/REFERENCE.md +0 -727
  416. package/Dev/i18n/es/ReactNative/skills/quality-tools/REFERENCE.md +0 -122
  417. package/Dev/i18n/es/ReactNative/skills/security-reactnative/REFERENCE.md +0 -719
  418. package/Dev/i18n/es/ReactNative/skills/state-management/REFERENCE.md +0 -607
  419. package/Dev/i18n/es/ReactNative/skills/testing-reactnative/REFERENCE.md +0 -386
  420. package/Dev/i18n/es/ReactNative/skills/tooling/REFERENCE.md +0 -281
  421. package/Dev/i18n/es/Symfony/skills/aggregates/REFERENCE.md +0 -115
  422. package/Dev/i18n/es/Symfony/skills/architecture-clean-ddd/REFERENCE.md +0 -270
  423. package/Dev/i18n/es/Symfony/skills/async/REFERENCE.md +0 -190
  424. package/Dev/i18n/es/Symfony/skills/coding-standards/REFERENCE.md +0 -402
  425. package/Dev/i18n/es/Symfony/skills/cqrs/REFERENCE.md +0 -426
  426. package/Dev/i18n/es/Symfony/skills/ddd-patterns/REFERENCE.md +0 -1220
  427. package/Dev/i18n/es/Symfony/skills/docker-hadolint/REFERENCE.md +0 -265
  428. package/Dev/i18n/es/Symfony/skills/doctrine-extensions/REFERENCE.md +0 -927
  429. package/Dev/i18n/es/Symfony/skills/domain-events/REFERENCE.md +0 -129
  430. package/Dev/i18n/es/Symfony/skills/i18n/REFERENCE.md +0 -185
  431. package/Dev/i18n/es/Symfony/skills/multitenant/REFERENCE.md +0 -432
  432. package/Dev/i18n/es/Symfony/skills/performance/REFERENCE.md +0 -888
  433. package/Dev/i18n/es/Symfony/skills/quality-tools/REFERENCE.md +0 -982
  434. package/Dev/i18n/es/Symfony/skills/security-symfony/REFERENCE.md +0 -1055
  435. package/Dev/i18n/es/Symfony/skills/testing-symfony/REFERENCE.md +0 -370
  436. package/Dev/i18n/es/Symfony/skills/value-objects/REFERENCE.md +0 -536
  437. package/Dev/i18n/es/Symfony/templates/aggregate-examples.md +0 -1128
  438. package/Dev/i18n/es/Symfony/templates/domain-event-examples.md +0 -375
  439. package/Dev/i18n/es/Symfony/templates/value-object-examples.md +0 -626
  440. package/Dev/i18n/fr/Common/skills/documentation/REFERENCE.md +0 -555
  441. package/Dev/i18n/fr/Common/skills/git-workflow/REFERENCE.md +0 -541
  442. package/Dev/i18n/fr/Common/skills/kiss-dry-yagni/REFERENCE.md +0 -417
  443. package/Dev/i18n/fr/Common/skills/security/REFERENCE.md +0 -540
  444. package/Dev/i18n/fr/Common/skills/solid-principles/REFERENCE.md +0 -396
  445. package/Dev/i18n/fr/Common/skills/testing/REFERENCE.md +0 -463
  446. package/Dev/i18n/fr/Common/skills/workflow-analysis/REFERENCE.md +0 -226
  447. package/Dev/i18n/fr/Flutter/skills/architecture/REFERENCE.md +0 -1763
  448. package/Dev/i18n/fr/Flutter/skills/coding-standards/REFERENCE.md +0 -1147
  449. package/Dev/i18n/fr/Flutter/skills/performance/REFERENCE.md +0 -230
  450. package/Dev/i18n/fr/Flutter/skills/quality-tools/REFERENCE.md +0 -239
  451. package/Dev/i18n/fr/Flutter/skills/security-flutter/REFERENCE.md +0 -247
  452. package/Dev/i18n/fr/Flutter/skills/state-management/REFERENCE.md +0 -408
  453. package/Dev/i18n/fr/Flutter/skills/testing-flutter/REFERENCE.md +0 -692
  454. package/Dev/i18n/fr/Flutter/skills/tooling/REFERENCE.md +0 -542
  455. package/Dev/i18n/fr/Python/skills/architecture/REFERENCE.md +0 -1383
  456. package/Dev/i18n/fr/Python/skills/coding-standards/REFERENCE.md +0 -934
  457. package/Dev/i18n/fr/Python/skills/testing-python/REFERENCE.md +0 -778
  458. package/Dev/i18n/fr/Python/skills/tooling/REFERENCE.md +0 -730
  459. package/Dev/i18n/fr/React/skills/architecture/REFERENCE.md +0 -1005
  460. package/Dev/i18n/fr/React/skills/coding-standards/REFERENCE.md +0 -995
  461. package/Dev/i18n/fr/React/skills/quality-tools/REFERENCE.md +0 -758
  462. package/Dev/i18n/fr/React/skills/security-react/REFERENCE.md +0 -793
  463. package/Dev/i18n/fr/React/skills/testing-react/REFERENCE.md +0 -999
  464. package/Dev/i18n/fr/React/skills/tooling/REFERENCE.md +0 -777
  465. package/Dev/i18n/fr/ReactNative/skills/architecture/REFERENCE.md +0 -1253
  466. package/Dev/i18n/fr/ReactNative/skills/coding-standards/REFERENCE.md +0 -1230
  467. package/Dev/i18n/fr/ReactNative/skills/navigation/REFERENCE.md +0 -601
  468. package/Dev/i18n/fr/ReactNative/skills/performance/REFERENCE.md +0 -727
  469. package/Dev/i18n/fr/ReactNative/skills/quality-tools/REFERENCE.md +0 -122
  470. package/Dev/i18n/fr/ReactNative/skills/security-reactnative/REFERENCE.md +0 -719
  471. package/Dev/i18n/fr/ReactNative/skills/state-management/REFERENCE.md +0 -607
  472. package/Dev/i18n/fr/ReactNative/skills/testing-reactnative/REFERENCE.md +0 -386
  473. package/Dev/i18n/fr/ReactNative/skills/tooling/REFERENCE.md +0 -281
  474. package/Dev/i18n/fr/Symfony/skills/aggregates/REFERENCE.md +0 -115
  475. package/Dev/i18n/fr/Symfony/skills/architecture-clean-ddd/REFERENCE.md +0 -979
  476. package/Dev/i18n/fr/Symfony/skills/async/REFERENCE.md +0 -190
  477. package/Dev/i18n/fr/Symfony/skills/coding-standards/REFERENCE.md +0 -402
  478. package/Dev/i18n/fr/Symfony/skills/cqrs/REFERENCE.md +0 -426
  479. package/Dev/i18n/fr/Symfony/skills/ddd-patterns/REFERENCE.md +0 -1220
  480. package/Dev/i18n/fr/Symfony/skills/docker-hadolint/REFERENCE.md +0 -767
  481. package/Dev/i18n/fr/Symfony/skills/doctrine-extensions/REFERENCE.md +0 -927
  482. package/Dev/i18n/fr/Symfony/skills/domain-events/REFERENCE.md +0 -129
  483. package/Dev/i18n/fr/Symfony/skills/i18n/REFERENCE.md +0 -185
  484. package/Dev/i18n/fr/Symfony/skills/multitenant/REFERENCE.md +0 -432
  485. package/Dev/i18n/fr/Symfony/skills/performance/REFERENCE.md +0 -888
  486. package/Dev/i18n/fr/Symfony/skills/quality-tools/REFERENCE.md +0 -982
  487. package/Dev/i18n/fr/Symfony/skills/security-symfony/REFERENCE.md +0 -1055
  488. package/Dev/i18n/fr/Symfony/skills/testing-symfony/REFERENCE.md +0 -1121
  489. package/Dev/i18n/fr/Symfony/skills/value-objects/REFERENCE.md +0 -536
  490. package/Dev/i18n/fr/Symfony/templates/aggregate-examples.md +0 -1128
  491. package/Dev/i18n/fr/Symfony/templates/domain-event-examples.md +0 -1091
  492. package/Dev/i18n/fr/Symfony/templates/value-object-examples.md +0 -1129
  493. package/Dev/i18n/pt/Common/skills/documentation/REFERENCE.md +0 -555
  494. package/Dev/i18n/pt/Common/skills/git-workflow/REFERENCE.md +0 -541
  495. package/Dev/i18n/pt/Common/skills/kiss-dry-yagni/REFERENCE.md +0 -417
  496. package/Dev/i18n/pt/Common/skills/security/REFERENCE.md +0 -540
  497. package/Dev/i18n/pt/Common/skills/solid-principles/REFERENCE.md +0 -396
  498. package/Dev/i18n/pt/Common/skills/testing/REFERENCE.md +0 -463
  499. package/Dev/i18n/pt/Common/skills/workflow-analysis/REFERENCE.md +0 -226
  500. package/Dev/i18n/pt/Flutter/skills/architecture/REFERENCE.md +0 -455
  501. package/Dev/i18n/pt/Flutter/skills/coding-standards/REFERENCE.md +0 -247
  502. package/Dev/i18n/pt/Flutter/skills/performance/REFERENCE.md +0 -230
  503. package/Dev/i18n/pt/Flutter/skills/quality-tools/REFERENCE.md +0 -239
  504. package/Dev/i18n/pt/Flutter/skills/security-flutter/REFERENCE.md +0 -247
  505. package/Dev/i18n/pt/Flutter/skills/state-management/REFERENCE.md +0 -408
  506. package/Dev/i18n/pt/Flutter/skills/tooling/REFERENCE.md +0 -542
  507. package/Dev/i18n/pt/Python/skills/architecture/REFERENCE.md +0 -444
  508. package/Dev/i18n/pt/Python/skills/coding-standards/REFERENCE.md +0 -572
  509. package/Dev/i18n/pt/Python/skills/testing-python/REFERENCE.md +0 -387
  510. package/Dev/i18n/pt/Python/skills/tooling/REFERENCE.md +0 -351
  511. package/Dev/i18n/pt/React/skills/architecture/REFERENCE.md +0 -651
  512. package/Dev/i18n/pt/React/skills/coding-standards/REFERENCE.md +0 -716
  513. package/Dev/i18n/pt/React/skills/quality-tools/REFERENCE.md +0 -758
  514. package/Dev/i18n/pt/React/skills/security-react/REFERENCE.md +0 -793
  515. package/Dev/i18n/pt/React/skills/testing-react/REFERENCE.md +0 -999
  516. package/Dev/i18n/pt/React/skills/tooling/REFERENCE.md +0 -777
  517. package/Dev/i18n/pt/ReactNative/skills/architecture/REFERENCE.md +0 -200
  518. package/Dev/i18n/pt/ReactNative/skills/coding-standards/REFERENCE.md +0 -1230
  519. package/Dev/i18n/pt/ReactNative/skills/navigation/REFERENCE.md +0 -601
  520. package/Dev/i18n/pt/ReactNative/skills/performance/REFERENCE.md +0 -727
  521. package/Dev/i18n/pt/ReactNative/skills/quality-tools/REFERENCE.md +0 -122
  522. package/Dev/i18n/pt/ReactNative/skills/security-reactnative/REFERENCE.md +0 -719
  523. package/Dev/i18n/pt/ReactNative/skills/state-management/REFERENCE.md +0 -566
  524. package/Dev/i18n/pt/ReactNative/skills/testing-reactnative/REFERENCE.md +0 -386
  525. package/Dev/i18n/pt/ReactNative/skills/tooling/REFERENCE.md +0 -281
  526. package/Dev/i18n/pt/Symfony/skills/aggregates/REFERENCE.md +0 -115
  527. package/Dev/i18n/pt/Symfony/skills/architecture-clean-ddd/REFERENCE.md +0 -979
  528. package/Dev/i18n/pt/Symfony/skills/async/REFERENCE.md +0 -190
  529. package/Dev/i18n/pt/Symfony/skills/coding-standards/REFERENCE.md +0 -402
  530. package/Dev/i18n/pt/Symfony/skills/cqrs/REFERENCE.md +0 -426
  531. package/Dev/i18n/pt/Symfony/skills/ddd-patterns/REFERENCE.md +0 -1220
  532. package/Dev/i18n/pt/Symfony/skills/docker-hadolint/REFERENCE.md +0 -767
  533. package/Dev/i18n/pt/Symfony/skills/doctrine-extensions/REFERENCE.md +0 -927
  534. package/Dev/i18n/pt/Symfony/skills/domain-events/REFERENCE.md +0 -129
  535. package/Dev/i18n/pt/Symfony/skills/i18n/REFERENCE.md +0 -185
  536. package/Dev/i18n/pt/Symfony/skills/multitenant/REFERENCE.md +0 -432
  537. package/Dev/i18n/pt/Symfony/skills/performance/REFERENCE.md +0 -888
  538. package/Dev/i18n/pt/Symfony/skills/quality-tools/REFERENCE.md +0 -982
  539. package/Dev/i18n/pt/Symfony/skills/security-symfony/REFERENCE.md +0 -1055
  540. package/Dev/i18n/pt/Symfony/skills/testing-symfony/REFERENCE.md +0 -1121
  541. package/Dev/i18n/pt/Symfony/skills/value-objects/REFERENCE.md +0 -536
  542. package/Dev/i18n/pt/Symfony/templates/aggregate-examples.md +0 -1128
  543. package/Dev/i18n/pt/Symfony/templates/domain-event-examples.md +0 -1091
  544. package/Dev/i18n/pt/Symfony/templates/value-object-examples.md +0 -1129
@@ -1,888 +0,0 @@
1
- # Performance & Optimization - Atoll Tourisme
2
-
3
- ## Overview
4
-
5
- L'optimisation des performances est **OBLIGATOIRE** pour garantir une expérience utilisateur fluide.
6
-
7
- **Objectifs:**
8
- - ✅ Temps de réponse < 200ms (pages)
9
- - ✅ Temps de réponse < 100ms (API)
10
- - ✅ Cache Redis pour requêtes fréquentes
11
- - ✅ Symfony Messenger pour tâches asynchrones
12
- - ✅ Pagination systématique
13
- - ✅ Lazy loading Doctrine
14
- - ✅ Prévention N+1 queries
15
-
16
- > **Références:**
17
- > - `01-symfony-best-practices.md` - Cache Symfony
18
- > - `06-docker-hadolint.md` - Docker optimisé
19
- > - `07-testing-tdd-bdd.md` - Tests de performance
20
-
21
- ---
22
-
23
- ## Table des matières
24
-
25
- 1. [Cache Redis](#cache-redis)
26
- 2. [Symfony Messenger - Async](#symfony-messenger---async)
27
- 3. [Pagination](#pagination)
28
- 4. [Doctrine Optimizations](#doctrine-optimizations)
29
- 5. [N+1 Query Prevention](#n1-query-prevention)
30
- 6. [Lazy Loading](#lazy-loading)
31
- 7. [HTTP Cache](#http-cache)
32
- 8. [Métriques et monitoring](#métriques-et-monitoring)
33
-
34
- ---
35
-
36
- ## Cache Redis
37
-
38
- ### Configuration Redis
39
-
40
- ```yaml
41
- # config/packages/cache.yaml
42
-
43
- framework:
44
- cache:
45
- app: cache.adapter.redis
46
- default_redis_provider: '%env(REDIS_URL)%'
47
-
48
- pools:
49
- # ✅ Cache séjours (données rarement modifiées)
50
- cache.sejours:
51
- adapter: cache.adapter.redis
52
- default_lifetime: 3600 # 1 heure
53
- tags: true
54
-
55
- # ✅ Cache statistiques (recalculées régulièrement)
56
- cache.statistics:
57
- adapter: cache.adapter.redis
58
- default_lifetime: 300 # 5 minutes
59
- tags: true
60
-
61
- # ✅ Cache API externe (éviter rate limiting)
62
- cache.external_api:
63
- adapter: cache.adapter.redis
64
- default_lifetime: 7200 # 2 heures
65
- ```
66
-
67
- ```bash
68
- # .env
69
- REDIS_URL=redis://redis:6379/0
70
- ```
71
-
72
- ### Usage du cache
73
-
74
- ```php
75
- <?php
76
-
77
- namespace App\Domain\Catalog\Repository;
78
-
79
- use Symfony\Contracts\Cache\CacheInterface;
80
- use Symfony\Contracts\Cache\ItemInterface;
81
-
82
- final readonly class CachedSejourRepository implements SejourRepositoryInterface
83
- {
84
- public function __construct(
85
- private SejourRepositoryInterface $decorated,
86
- private CacheInterface $sejoursCache,
87
- ) {}
88
-
89
- public function findById(SejourId $id): Sejour
90
- {
91
- // ✅ Cache par ID
92
- return $this->sejoursCache->get(
93
- 'sejour_' . $id->getValue(),
94
- function (ItemInterface $item) use ($id): Sejour {
95
- // ✅ TTL: 1 heure
96
- $item->expiresAfter(3600);
97
-
98
- // ✅ Tags pour invalidation ciblée
99
- $item->tag(['sejours', 'sejour_' . $id->getValue()]);
100
-
101
- // ✅ Calcul uniquement si cache miss
102
- return $this->decorated->findById($id);
103
- }
104
- );
105
- }
106
-
107
- public function findAvailable(\DateTimeImmutable $dateDebut): array
108
- {
109
- $cacheKey = sprintf(
110
- 'sejours_available_%s',
111
- $dateDebut->format('Y-m-d')
112
- );
113
-
114
- return $this->sejoursCache->get(
115
- $cacheKey,
116
- function (ItemInterface $item) use ($dateDebut): array {
117
- $item->expiresAfter(300); // 5 minutes (données changeantes)
118
- $item->tag(['sejours', 'sejours_available']);
119
-
120
- return $this->decorated->findAvailable($dateDebut);
121
- }
122
- );
123
- }
124
-
125
- public function save(Sejour $sejour): void
126
- {
127
- $this->decorated->save($sejour);
128
-
129
- // ✅ Invalidation du cache après modification
130
- $this->sejoursCache->invalidateTags([
131
- 'sejours',
132
- 'sejour_' . $sejour->getId()->getValue(),
133
- ]);
134
- }
135
- }
136
- ```
137
-
138
- ### Cache warming
139
-
140
- ```php
141
- <?php
142
-
143
- namespace App\Infrastructure\Cache\Warmer;
144
-
145
- use Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterface;
146
-
147
- final readonly class SejourCacheWarmer implements CacheWarmerInterface
148
- {
149
- public function __construct(
150
- private SejourRepositoryInterface $sejourRepository,
151
- private CacheInterface $sejoursCache,
152
- ) {}
153
-
154
- public function isOptional(): bool
155
- {
156
- return true;
157
- }
158
-
159
- public function warmUp(string $cacheDir, ?string $buildDir = null): array
160
- {
161
- // ✅ Précharge les séjours actifs en cache
162
- $sejours = $this->sejourRepository->findActive();
163
-
164
- foreach ($sejours as $sejour) {
165
- $this->sejoursCache->get(
166
- 'sejour_' . $sejour->getId()->getValue(),
167
- fn() => $sejour
168
- );
169
- }
170
-
171
- return [];
172
- }
173
- }
174
- ```
175
-
176
- ---
177
-
178
- ## Symfony Messenger - Async
179
-
180
- ### Configuration Messenger
181
-
182
- ```yaml
183
- # config/packages/messenger.yaml
184
-
185
- framework:
186
- messenger:
187
- failure_transport: failed
188
-
189
- transports:
190
- # ✅ Transport async pour emails
191
- async_emails:
192
- dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
193
- options:
194
- queue_name: emails
195
- retry_strategy:
196
- max_retries: 3
197
- delay: 1000 # 1 seconde
198
- multiplier: 2 # Backoff exponentiel
199
- max_delay: 10000 # Max 10 secondes
200
-
201
- # ✅ Transport async pour statistiques
202
- async_statistics:
203
- dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
204
- options:
205
- queue_name: statistics
206
- retry_strategy:
207
- max_retries: 5
208
-
209
- # ✅ Failed messages (pour retry manuel)
210
- failed: 'doctrine://default?queue_name=failed'
211
-
212
- routing:
213
- # ✅ Emails asynchrones
214
- 'App\Infrastructure\Notification\Message\SendReservationConfirmationEmail': async_emails
215
-
216
- # ✅ Statistiques asynchrones
217
- 'App\Application\Statistics\Message\UpdateMonthlyStatistics': async_statistics
218
-
219
- # ✅ Domain Events synchrones par défaut
220
- 'App\Domain\*\Event\*': sync
221
- ```
222
-
223
- ```bash
224
- # .env
225
- MESSENGER_TRANSPORT_DSN=redis://redis:6379/messages
226
- ```
227
-
228
- ### Message asynchrone pour emails
229
-
230
- ```php
231
- <?php
232
-
233
- namespace App\Infrastructure\Notification\Message;
234
-
235
- use App\Domain\Reservation\ValueObject\ReservationId;
236
-
237
- // ✅ Message simple (DTO)
238
- final readonly class SendReservationConfirmationEmail
239
- {
240
- public function __construct(
241
- public ReservationId $reservationId,
242
- ) {}
243
- }
244
- ```
245
-
246
- ### Handler asynchrone
247
-
248
- ```php
249
- <?php
250
-
251
- namespace App\Infrastructure\Notification\MessageHandler;
252
-
253
- use Symfony\Component\Messenger\Attribute\AsMessageHandler;
254
-
255
- // ✅ Handler traité de manière asynchrone
256
- #[AsMessageHandler]
257
- final readonly class SendReservationConfirmationEmailHandler
258
- {
259
- public function __construct(
260
- private ReservationRepositoryInterface $reservationRepository,
261
- private MailerInterface $mailer,
262
- ) {}
263
-
264
- public function __invoke(SendReservationConfirmationEmail $message): void
265
- {
266
- $reservation = $this->reservationRepository->findById($message->reservationId);
267
-
268
- // ✅ Envoi email (traité en arrière-plan)
269
- $email = (new Email())
270
- ->to((string) $reservation->getClientEmail())
271
- ->subject('Confirmation de réservation')
272
- ->htmlTemplate('emails/confirmation_client.html.twig')
273
- ->context(['reservation' => $reservation]);
274
-
275
- $this->mailer->send($email);
276
- }
277
- }
278
- ```
279
-
280
- ### Dispatch du message
281
-
282
- ```php
283
- <?php
284
-
285
- namespace App\Application\Reservation\UseCase;
286
-
287
- use Symfony\Component\Messenger\MessageBusInterface;
288
-
289
- final readonly class CreateReservationUseCase
290
- {
291
- public function __construct(
292
- private ReservationRepositoryInterface $repository,
293
- private MessageBusInterface $messageBus,
294
- ) {}
295
-
296
- public function execute(CreateReservationCommand $command): ReservationId
297
- {
298
- // 1. Créer la réservation
299
- $reservation = Reservation::create(/* ... */);
300
- $this->repository->save($reservation);
301
-
302
- // 2. ✅ Dispatch message asynchrone (non bloquant)
303
- $this->messageBus->dispatch(
304
- new SendReservationConfirmationEmail($reservation->getId())
305
- );
306
-
307
- // 3. Retour immédiat (email envoyé en arrière-plan)
308
- return $reservation->getId();
309
- }
310
- }
311
- ```
312
-
313
- ### Worker Messenger
314
-
315
- ```bash
316
- # Consommer les messages (en arrière-plan)
317
- make console CMD="messenger:consume async_emails async_statistics -vv"
318
-
319
- # ✅ Production: Supervisord
320
- # /etc/supervisor/conf.d/messenger-worker.conf
321
- [program:messenger-consume]
322
- command=php /app/bin/console messenger:consume async_emails async_statistics --time-limit=3600
323
- numprocs=2
324
- autostart=true
325
- autorestart=true
326
- ```
327
-
328
- ---
329
-
330
- ## Pagination
331
-
332
- ### Pagination Doctrine
333
-
334
- ```php
335
- <?php
336
-
337
- namespace App\Domain\Reservation\Repository;
338
-
339
- use Doctrine\ORM\Tools\Pagination\Paginator;
340
-
341
- interface ReservationRepositoryInterface
342
- {
343
- /**
344
- * @return Paginator<Reservation>
345
- */
346
- public function findPaginated(int $page = 1, int $limit = 20): Paginator;
347
- }
348
- ```
349
-
350
- ```php
351
- <?php
352
-
353
- namespace App\Infrastructure\Persistence\Doctrine\Repository;
354
-
355
- use Doctrine\ORM\Tools\Pagination\Paginator;
356
-
357
- final class DoctrineReservationRepository implements ReservationRepositoryInterface
358
- {
359
- public function findPaginated(int $page = 1, int $limit = 20): Paginator
360
- {
361
- $query = $this->createQueryBuilder('r')
362
- ->orderBy('r.createdAt', 'DESC')
363
- ->setFirstResult(($page - 1) * $limit) // ✅ Offset
364
- ->setMaxResults($limit) // ✅ Limit
365
- ->getQuery();
366
-
367
- // ✅ Paginator Doctrine (gère le COUNT automatiquement)
368
- return new Paginator($query, fetchJoinCollection: true);
369
- }
370
- }
371
- ```
372
-
373
- ### Controller avec pagination
374
-
375
- ```php
376
- <?php
377
-
378
- namespace App\Presentation\Controller\Admin;
379
-
380
- use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
381
-
382
- final class ReservationController extends AbstractController
383
- {
384
- #[Route('/admin/reservations', name: 'admin_reservations')]
385
- public function list(Request $request, ReservationRepositoryInterface $repository): Response
386
- {
387
- // ✅ Page depuis query string (?page=2)
388
- $page = max(1, (int) $request->query->get('page', 1));
389
- $limit = 20;
390
-
391
- $paginator = $repository->findPaginated($page, $limit);
392
-
393
- return $this->render('admin/reservations/list.html.twig', [
394
- 'reservations' => $paginator,
395
- 'page' => $page,
396
- 'limit' => $limit,
397
- 'total' => count($paginator), // ✅ Total items
398
- 'pages' => (int) ceil(count($paginator) / $limit), // ✅ Total pages
399
- ]);
400
- }
401
- }
402
- ```
403
-
404
- ### Template pagination
405
-
406
- ```twig
407
- {# templates/admin/reservations/list.html.twig #}
408
-
409
- <table>
410
- <thead>
411
- <tr>
412
- <th>ID</th>
413
- <th>Client</th>
414
- <th>Montant</th>
415
- <th>Statut</th>
416
- </tr>
417
- </thead>
418
- <tbody>
419
- {% for reservation in reservations %}
420
- <tr>
421
- <td>{{ reservation.id }}</td>
422
- <td>{{ reservation.clientEmail }}</td>
423
- <td>{{ reservation.montantTotal.amountEuros }}€</td>
424
- <td>{{ reservation.statut.value }}</td>
425
- </tr>
426
- {% endfor %}
427
- </tbody>
428
- </table>
429
-
430
- {# ✅ Pagination links #}
431
- <nav>
432
- <ul class="pagination">
433
- {% if page > 1 %}
434
- <li><a href="{{ path('admin_reservations', {page: page - 1}) }}">Précédent</a></li>
435
- {% endif %}
436
-
437
- {% for p in 1..pages %}
438
- <li class="{{ p == page ? 'active' : '' }}">
439
- <a href="{{ path('admin_reservations', {page: p}) }}">{{ p }}</a>
440
- </li>
441
- {% endfor %}
442
-
443
- {% if page < pages %}
444
- <li><a href="{{ path('admin_reservations', {page: page + 1}) }}">Suivant</a></li>
445
- {% endif %}
446
- </ul>
447
- </nav>
448
- ```
449
-
450
- ---
451
-
452
- ## Doctrine Optimizations
453
-
454
- ### Fetch JOIN pour éviter N+1
455
-
456
- ```php
457
- <?php
458
-
459
- // ❌ LENT: N+1 queries
460
- $reservations = $this->createQueryBuilder('r')
461
- ->getQuery()
462
- ->getResult();
463
-
464
- foreach ($reservations as $reservation) {
465
- // ✅ Chaque accès = 1 query supplémentaire!
466
- echo $reservation->getSejour()->getTitre(); // +1 query
467
- foreach ($reservation->getParticipants() as $participant) { // +1 query par reservation
468
- echo $participant->getNom();
469
- }
470
- }
471
- // Total: 1 + N + (N * M) queries
472
-
473
- // ✅ RAPIDE: Fetch JOIN (1 seule query)
474
- $reservations = $this->createQueryBuilder('r')
475
- ->leftJoin('r.sejour', 's')
476
- ->addSelect('s') // ✅ Charge sejour en même temps
477
- ->leftJoin('r.participants', 'p')
478
- ->addSelect('p') // ✅ Charge participants en même temps
479
- ->getQuery()
480
- ->getResult();
481
-
482
- foreach ($reservations as $reservation) {
483
- // ✅ Pas de query supplémentaire (déjà en mémoire)
484
- echo $reservation->getSejour()->getTitre();
485
- foreach ($reservation->getParticipants() as $participant) {
486
- echo $participant->getNom();
487
- }
488
- }
489
- // Total: 1 query
490
- ```
491
-
492
- ### Partial Objects (DTO)
493
-
494
- ```php
495
- <?php
496
-
497
- // ❌ LENT: Charge toute l'entité
498
- $reservations = $this->createQueryBuilder('r')
499
- ->getQuery()
500
- ->getResult(); // Hydrate tous les champs
501
-
502
- // ✅ RAPIDE: Charge uniquement les champs nécessaires
503
- $results = $this->createQueryBuilder('r')
504
- ->select('r.id', 'r.montantTotal', 's.titre')
505
- ->leftJoin('r.sejour', 's')
506
- ->getQuery()
507
- ->getArrayResult(); // ✅ Array, pas d'objet Doctrine
508
-
509
- // Ou avec un DTO
510
- $results = $this->createQueryBuilder('r')
511
- ->select('NEW App\Application\Reservation\DTO\ReservationListDTO(r.id, r.montantTotal, s.titre)')
512
- ->leftJoin('r.sejour', 's')
513
- ->getQuery()
514
- ->getResult();
515
- ```
516
-
517
- ### Batch Processing
518
-
519
- ```php
520
- <?php
521
-
522
- // ❌ LENT: Tout en mémoire
523
- $reservations = $this->repository->findAll(); // ⚠️ 10,000 réservations!
524
-
525
- foreach ($reservations as $reservation) {
526
- $reservation->updateStatistics();
527
- $this->entityManager->persist($reservation);
528
- }
529
-
530
- $this->entityManager->flush(); // ⚠️ Out of memory!
531
-
532
- // ✅ RAPIDE: Batch processing
533
- $batchSize = 100;
534
- $i = 0;
535
-
536
- $query = $this->entityManager->createQuery('SELECT r FROM App\Entity\Reservation r');
537
-
538
- foreach ($query->toIterable() as $reservation) {
539
- $reservation->updateStatistics();
540
- $this->entityManager->persist($reservation);
541
-
542
- if (($i % $batchSize) === 0) {
543
- // ✅ Flush + clear tous les 100 items
544
- $this->entityManager->flush();
545
- $this->entityManager->clear(); // ✅ Libère la mémoire
546
- }
547
-
548
- ++$i;
549
- }
550
-
551
- // Flush final
552
- $this->entityManager->flush();
553
- $this->entityManager->clear();
554
- ```
555
-
556
- ---
557
-
558
- ## N+1 Query Prevention
559
-
560
- ### Doctrine Extension pour logging
561
-
562
- ```yaml
563
- # config/packages/dev/doctrine.yaml
564
-
565
- doctrine:
566
- dbal:
567
- logging: true # ✅ Active le logging SQL en dev
568
- profiling: true
569
-
570
- # ✅ Utiliser la Symfony Profiler toolbar pour voir les queries
571
- ```
572
-
573
- ### Détection N+1 avec tests
574
-
575
- ```php
576
- <?php
577
-
578
- namespace App\Tests\Performance;
579
-
580
- use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
581
-
582
- final class ReservationPerformanceTest extends KernelTestCase
583
- {
584
- /**
585
- * @test
586
- */
587
- public function it_does_not_generate_n_plus_1_queries_when_listing_reservations(): void
588
- {
589
- // Given: 10 réservations avec participants
590
- $this->loadFixtures(10);
591
-
592
- // ✅ Commence à compter les queries
593
- $this->enableQueryLogger();
594
-
595
- // When: Liste les réservations
596
- $repository = $this->getContainer()->get(ReservationRepositoryInterface::class);
597
- $reservations = $repository->findAll();
598
-
599
- foreach ($reservations as $reservation) {
600
- // Accès aux relations
601
- $reservation->getSejour()->getTitre();
602
- foreach ($reservation->getParticipants() as $participant) {
603
- $participant->getNom();
604
- }
605
- }
606
-
607
- // Then: ✅ Maximum 3 queries (reservation + sejour + participants)
608
- $queryCount = $this->getQueryCount();
609
- self::assertLessThanOrEqual(
610
- 3,
611
- $queryCount,
612
- "Expected max 3 queries, got {$queryCount} (N+1 detected!)"
613
- );
614
- }
615
- }
616
- ```
617
-
618
- ---
619
-
620
- ## Lazy Loading
621
-
622
- ### Configuration Doctrine Lazy Loading
623
-
624
- ```yaml
625
- # config/packages/doctrine.yaml
626
-
627
- doctrine:
628
- orm:
629
- # ✅ Lazy loading par défaut (proxies)
630
- auto_generate_proxy_classes: true
631
- proxy_dir: '%kernel.cache_dir%/doctrine/orm/Proxies'
632
- ```
633
-
634
- ### Usage Lazy Loading
635
-
636
- ```php
637
- <?php
638
-
639
- namespace App\Domain\Reservation\Entity;
640
-
641
- use Doctrine\ORM\Mapping as ORM;
642
-
643
- #[ORM\Entity]
644
- class Reservation
645
- {
646
- // ✅ Lazy loading par défaut (fetch="LAZY")
647
- #[ORM\ManyToOne(targetEntity: Sejour::class, fetch: 'LAZY')]
648
- private Sejour $sejour;
649
-
650
- // ✅ Eager loading si toujours nécessaire
651
- #[ORM\ManyToOne(targetEntity: Client::class, fetch: 'EAGER')]
652
- private Client $client;
653
-
654
- // ✅ Extra lazy pour collections (COUNT sans charger tous)
655
- #[ORM\OneToMany(targetEntity: Participant::class, fetch: 'EXTRA_LAZY')]
656
- private Collection $participants;
657
-
658
- public function getParticipantCount(): int
659
- {
660
- // ✅ SELECT COUNT sans charger tous les participants
661
- return $this->participants->count();
662
- }
663
- }
664
- ```
665
-
666
- ---
667
-
668
- ## HTTP Cache
669
-
670
- ### Configuration HTTP Cache
671
-
672
- ```yaml
673
- # config/packages/framework.yaml
674
-
675
- framework:
676
- http_cache:
677
- enabled: true
678
-
679
- # ✅ ESI (Edge Side Includes) pour fragments cachés
680
- esi: { enabled: true }
681
- fragments: { path: /_fragment }
682
- ```
683
-
684
- ### Controller avec cache HTTP
685
-
686
- ```php
687
- <?php
688
-
689
- namespace App\Presentation\Controller;
690
-
691
- use Symfony\Component\HttpFoundation\Response;
692
-
693
- final class SejourController extends AbstractController
694
- {
695
- #[Route('/sejours/{id}', name: 'sejour_show')]
696
- public function show(Sejour $sejour): Response
697
- {
698
- $response = $this->render('sejour/show.html.twig', [
699
- 'sejour' => $sejour,
700
- ]);
701
-
702
- // ✅ Cache HTTP public (CDN)
703
- $response->setPublic();
704
-
705
- // ✅ Max age: 1 heure
706
- $response->setMaxAge(3600);
707
-
708
- // ✅ ETag pour validation cache
709
- $response->setEtag(md5($sejour->getUpdatedAt()->getTimestamp()));
710
-
711
- // ✅ Last-Modified
712
- $response->setLastModified($sejour->getUpdatedAt());
713
-
714
- // ✅ Validation: retourne 304 Not Modified si cache valide
715
- if ($response->isNotModified($this->container->get('request_stack')->getCurrentRequest())) {
716
- return $response;
717
- }
718
-
719
- return $response;
720
- }
721
- }
722
- ```
723
-
724
- ### ESI pour fragments
725
-
726
- ```twig
727
- {# templates/sejour/show.html.twig #}
728
-
729
- <div class="sejour">
730
- <h1>{{ sejour.titre }}</h1>
731
-
732
- {# ✅ Fragment caché indépendamment (5 minutes) #}
733
- {{ render_esi(controller('App\\Controller\\SejourController::availabilityWidget', {
734
- 'sejourId': sejour.id
735
- })) }}
736
- </div>
737
- ```
738
-
739
- ```php
740
- <?php
741
-
742
- public function availabilityWidget(string $sejourId): Response
743
- {
744
- $response = $this->render('sejour/_availability_widget.html.twig', [
745
- 'availability' => $this->getAvailability($sejourId),
746
- ]);
747
-
748
- // ✅ Cache fragment: 5 minutes
749
- $response->setPublic();
750
- $response->setMaxAge(300);
751
-
752
- return $response;
753
- }
754
- ```
755
-
756
- ---
757
-
758
- ## Métriques et monitoring
759
-
760
- ### Blackfire.io (profiling)
761
-
762
- ```yaml
763
- # config/packages/blackfire.yaml
764
-
765
- blackfire:
766
- server_id: '%env(BLACKFIRE_SERVER_ID)%'
767
- server_token: '%env(BLACKFIRE_SERVER_TOKEN)%'
768
- ```
769
-
770
- ```bash
771
- # Profiling d'une requête
772
- blackfire curl http://localhost:8080/reservations
773
-
774
- # Profiling d'une commande
775
- blackfire run php bin/console app:update-statistics
776
- ```
777
-
778
- ### Symfony Profiler
779
-
780
- ```bash
781
- # ✅ Actif en dev automatiquement
782
- # Accès: http://localhost:8080/_profiler
783
-
784
- # Vérifier:
785
- # - Database queries (détecte N+1)
786
- # - Cache hits/misses
787
- # - Temps d'exécution
788
- # - Mémoire utilisée
789
- ```
790
-
791
- ### Monitoring production
792
-
793
- ```php
794
- <?php
795
-
796
- namespace App\Infrastructure\Monitoring;
797
-
798
- use Symfony\Component\HttpKernel\Event\TerminateEvent;
799
- use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
800
- use Psr\Log\LoggerInterface;
801
-
802
- #[AsEventListener]
803
- final readonly class PerformanceMonitor
804
- {
805
- public function __construct(
806
- private LoggerInterface $performanceLogger,
807
- ) {}
808
-
809
- public function __invoke(TerminateEvent $event): void
810
- {
811
- $request = $event->getRequest();
812
- $response = $event->getResponse();
813
-
814
- $duration = microtime(true) - $request->server->get('REQUEST_TIME_FLOAT');
815
-
816
- // ✅ Log performances
817
- $this->performanceLogger->info('Request completed', [
818
- 'route' => $request->attributes->get('_route'),
819
- 'method' => $request->getMethod(),
820
- 'status_code' => $response->getStatusCode(),
821
- 'duration_ms' => round($duration * 1000, 2),
822
- 'memory_mb' => round(memory_get_peak_usage(true) / 1024 / 1024, 2),
823
- ]);
824
-
825
- // ✅ Alerte si trop lent
826
- if ($duration > 0.5) { // 500ms
827
- $this->performanceLogger->warning('Slow request detected', [
828
- 'route' => $request->attributes->get('_route'),
829
- 'duration_ms' => round($duration * 1000, 2),
830
- ]);
831
- }
832
- }
833
- }
834
- ```
835
-
836
- ---
837
-
838
- ## Checklist performance
839
-
840
- ### Before chaque commit
841
-
842
- - [ ] **N+1 Queries:** Pas de queries dans les boucles
843
- - [ ] **Fetch JOIN:** Relations nécessaires chargées en 1 query
844
- - [ ] **Pagination:** Listes paginées (max 50 items/page)
845
- - [ ] **Lazy Loading:** Extra lazy sur collections
846
- - [ ] **Cache:** Données rarement modifiées en cache Redis
847
- - [ ] **Async:** Emails et tâches lourdes via Messenger
848
-
849
- ### Métriques cibles
850
-
851
- | Métrique | Cible | Limite |
852
- |----------|-------|--------|
853
- | Page load | < 200ms | < 500ms |
854
- | API response | < 100ms | < 200ms |
855
- | Database queries par page | < 10 | < 20 |
856
- | Cache hit ratio | > 80% | > 60% |
857
- | Memory usage | < 50MB | < 128MB |
858
-
859
- ### Outils de validation
860
-
861
- ```bash
862
- # Profiling Blackfire
863
- blackfire curl http://localhost:8080/reservations
864
-
865
- # Test N+1 queries
866
- make test-integration
867
-
868
- # Cache hit ratio
869
- docker-compose exec redis redis-cli info stats | grep keyspace
870
-
871
- # Slow query log
872
- docker-compose exec postgres psql -U atoll -c "SELECT * FROM pg_stat_statements ORDER BY total_time DESC LIMIT 10"
873
- ```
874
-
875
- ---
876
-
877
- ## Ressources
878
-
879
- - **Symfony Performance:** https://symfony.com/doc/current/performance.html
880
- - **Doctrine Performance:** https://www.doctrine-project.org/projects/doctrine-orm/en/latest/reference/improving-performance.html
881
- - **Redis:** https://redis.io/documentation
882
- - **Blackfire.io:** https://blackfire.io/docs/introduction
883
-
884
- ---
885
-
886
- **Date de dernière mise à jour:** 2025-01-26
887
- **Version:** 1.0.0
888
- **Auteur:** The Bearded CTO