forjajs 2.0.3 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (701) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -339
  21. package/README.pt-BR.md +345 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,465 +1,465 @@
1
- # E-Commerce Starter - Boilerplate Completo
2
-
3
- Uma plataforma de e-commerce modular, escalável e pronta para produção construída com **NestJS** + **PostgreSQL** + **Redis**.
4
-
5
- ## 🎯 Características Principais
6
-
7
- ✅ **Catálogo de Produtos** - Produtos, categorias, filtros e busca
8
- ✅ **Carrinho de Compras** - Gerenciamento de itens com persistência
9
- ✅ **Checkout Simplificado** - Fluxo completo de compra
10
- ✅ **Mock Stripe** - Processamento de pagamentos simulado (90% sucesso)
11
- ✅ **Gerenciamento de Pedidos** - Rastreamento completo com status
12
- ✅ **Controle de Inventário** - Stock management em tempo real
13
- ✅ **Cupons de Desconto** - Aplicação de descontos
14
- ✅ **Avaliações de Produtos** - Rating e reviews de clientes
15
- ✅ **Documentação Memory** - 10 níveis de contexto estruturado
16
- ✅ **API Swagger** - Documentação interativa completa
17
-
18
- ## 🚀 Quick Start
19
-
20
- ### Pré-requisitos
21
- - Node.js 18+
22
- - Docker + Docker Compose
23
- - PostgreSQL 14+ (ou via Docker)
24
- - Redis (ou via Docker)
25
-
26
- ### 1️⃣ Clonar e Instalar
27
-
28
- ```bash
29
- cd boilerplates/03-ecommerce-starter/backend
30
- npm install
31
- ```
32
-
33
- ### 2️⃣ Setup com Docker
34
-
35
- ```bash
36
- docker-compose up -d
37
- ```
38
-
39
- Isto inicia:
40
- - **PostgreSQL** em localhost:5432
41
- - **Redis** em localhost:6379
42
- - **API** em localhost:3000
43
-
44
- ### 3️⃣ Configurar .env
45
-
46
- ```bash
47
- cp .env.example .env
48
- ```
49
-
50
- ### 4️⃣ Rodar Migrations (Futuro)
51
-
52
- ```bash
53
- npm run migration:run
54
- ```
55
-
56
- ### 5️⃣ Seed Database (Opcional)
57
-
58
- ```bash
59
- npm run seed
60
- ```
61
-
62
- ### 6️⃣ Iniciar Dev Server
63
-
64
- ```bash
65
- npm run start:dev
66
- ```
67
-
68
- ### 7️⃣ Acessar Documentação
69
-
70
- - **Swagger UI**: http://localhost:3000/docs
71
- - **Health Check**: http://localhost:3000/api/health
72
-
73
- ## 📚 Arquitetura
74
-
75
- ```
76
- ┌─────────────────────────────────────────┐
77
- │ Frontend (React/Vue) │
78
- │ Catálogo | Carrinho | Checkout │
79
- └────────────┬────────────────────────────┘
80
- │ REST API (JSON)
81
- ┌────────────▼────────────────────────────┐
82
- │ NestJS Backend (Port 3000) │
83
- │ ┌─────────────────────────────────┐ │
84
- │ │ Products | Cart | Orders │ │
85
- │ │ Payments | Inventory | Coupons │ │
86
- │ │ Reviews | Auth │ │
87
- │ └─────────────────────────────────┘ │
88
- └────────┬──────────┬──────────┬──────────┘
89
- │ │ │
90
- PostgreSQL Redis Stripe
91
- (Dados) (Cache) (Mock)
92
- ```
93
-
94
- ## 🔌 API Endpoints
95
-
96
- ### 📦 Produtos
97
-
98
- ```bash
99
- # Listar produtos (com paginação/filtro)
100
- GET /api/products?page=1&limit=20&category=electronics&minPrice=10&maxPrice=1000
101
-
102
- # Detalhes do produto
103
- GET /api/products/:productId
104
-
105
- # Criar produto (admin)
106
- POST /api/products
107
- Content-Type: application/json
108
- {
109
- "name": "Laptop",
110
- "price": 1299.99,
111
- "categoryId": "uuid",
112
- "sku": "LAPTOP-001"
113
- }
114
-
115
- # Atualizar produto (admin)
116
- PUT /api/products/:productId
117
-
118
- # Deletar produto (admin)
119
- DELETE /api/products/:productId
120
-
121
- # Listar categorias
122
- GET /api/categories
123
- ```
124
-
125
- ### 🛒 Carrinho
126
-
127
- ```bash
128
- # Adicionar ao carrinho
129
- POST /api/cart/add
130
- {
131
- "productId": "uuid",
132
- "quantity": 2
133
- }
134
-
135
- # Ver carrinho
136
- GET /api/cart
137
-
138
- # Remover item
139
- DELETE /api/cart/items/:productId
140
-
141
- # Atualizar quantidade
142
- PUT /api/cart/items/:productId
143
- {
144
- "quantity": 3
145
- }
146
-
147
- # Aplicar cupom
148
- POST /api/cart/apply-coupon
149
- {
150
- "code": "SUMMER10"
151
- }
152
- ```
153
-
154
- ### 💳 Checkout e Pagamentos
155
-
156
- ```bash
157
- # Validar carrinho antes de checkout
158
- POST /api/cart/validate
159
- {
160
- "shippingInfo": {
161
- "street": "Rua A",
162
- "number": "123",
163
- "city": "São Paulo",
164
- "state": "SP",
165
- "zip": "01234-567"
166
- }
167
- }
168
-
169
- # Processar pagamento (cria pedido automaticamente)
170
- POST /api/payments/process
171
- {
172
- "amount": 1299.99,
173
- "method": "credit_card",
174
- "card": {
175
- "number": "4111111111111111",
176
- "expiry": "12/25",
177
- "cvc": "123"
178
- }
179
- }
180
-
181
- Response (Success - 90%):
182
- {
183
- "status": "approved",
184
- "transactionId": "stripe-uuid",
185
- "orderId": "order-uuid"
186
- }
187
-
188
- Response (Failure - 10%):
189
- {
190
- "status": "declined",
191
- "errorCode": "card_declined",
192
- "message": "Cartão recusado"
193
- }
194
- ```
195
-
196
- ### 📋 Pedidos
197
-
198
- ```bash
199
- # Listar pedidos do usuário
200
- GET /api/orders?page=1&status=processing
201
-
202
- # Detalhes do pedido
203
- GET /api/orders/:orderId
204
-
205
- # Cancelar pedido
206
- POST /api/orders/:orderId/cancel
207
-
208
- # Atualizar status (admin)
209
- PUT /api/orders/:orderId/status
210
- {
211
- "status": "shipped",
212
- "trackingNumber": "BR123456789"
213
- }
214
- ```
215
-
216
- ### 📊 Inventário
217
-
218
- ```bash
219
- # Ver estoque de um produto
220
- GET /api/inventory/:productId
221
-
222
- # Listar estoque de todos (admin)
223
- GET /api/inventory?status=low-stock
224
-
225
- # Reposição (admin)
226
- POST /api/inventory/restock
227
- {
228
- "productId": "uuid",
229
- "quantity": 100
230
- }
231
- ```
232
-
233
- ### 🎁 Cupons
234
-
235
- ```bash
236
- # Validar cupom
237
- GET /api/coupons/:code/validate
238
-
239
- # Criar cupom (admin)
240
- POST /api/coupons
241
- {
242
- "code": "SUMMER10",
243
- "discount_percent": 10,
244
- "expiresAt": "2024-12-31T23:59:59Z"
245
- }
246
- ```
247
-
248
- ### ⭐ Avaliações
249
-
250
- ```bash
251
- # Listar reviews de um produto
252
- GET /api/products/:productId/reviews
253
-
254
- # Criar review (usuário autenticado)
255
- POST /api/orders/:orderId/items/:itemId/review
256
- {
257
- "rating": 5,
258
- "comment": "Produto excelente!"
259
- }
260
- ```
261
-
262
- ## 🧪 Testes
263
-
264
- ```bash
265
- # Testes unitários
266
- npm run test
267
-
268
- # Testes E2E
269
- npm run test:e2e
270
-
271
- # Coverage
272
- npm run test:cov
273
- ```
274
-
275
- ## 🏗️ Estrutura do Projeto
276
-
277
- ```
278
- backend/
279
- ├── src/
280
- │ ├── main.ts # Entry point
281
- │ ├── app.module.ts # Root module
282
- │ ├── modules/
283
- │ │ ├── products/ # Catálogo
284
- │ │ ├── cart/ # Carrinho
285
- │ │ ├── orders/ # Pedidos
286
- │ │ ├── payments/ # Pagamentos
287
- │ │ ├── inventory/ # Estoque
288
- │ │ ├── coupons/ # Cupons
289
- │ │ ├── reviews/ # Avaliações
290
- │ │ └── auth/ # Autenticação (mock)
291
- │ ├── common/
292
- │ │ ├── filters/
293
- │ │ ├── middleware/
294
- │ │ └── decorators/
295
- │ └── config/
296
- ├── test/ # E2E tests
297
- ├── docker-compose.yml
298
- ├── Dockerfile
299
- ├── package.json
300
- ├── tsconfig.json
301
- ├── jest.config.js
302
- └── .env.example
303
-
304
- memory/ # 10 níveis de contexto
305
- ├── 00-global/ # Missão, padrões
306
- ├── 10-product/ # Requisitos, personas
307
- ├── 20-architecture/ # Design técnico
308
- ├── 30-domains/ # Contexto por módulo
309
- ├── 40-delivery/ # Roadmap
310
- ├── 50-orchestration/ # Agentes, handoffs
311
- ├── 60-runs/ # Logs de execução
312
- ├── 70-summaries/ # Resumos
313
- ├── 80-data/ # Schemas
314
- └── 90-decisions/ # ADRs
315
- ```
316
-
317
- ## 📖 Documentação
318
-
319
- Consulte os arquivos de memory para detalhes:
320
-
321
- - **[Visão do Produto](memory/10-product/vision.md)** - Personas, user stories
322
- - **[Arquitetura](memory/20-architecture/overview.md)** - Design técnico
323
- - **[Catálogo](memory/30-domains/catalog/context.md)** - Domínio de produtos
324
- - **[Pedidos](memory/30-domains/orders/context.md)** - Domínio de orders
325
- - **[Pagamentos](memory/30-domains/payments/context.md)** - Mock Stripe
326
- - **[Inventário](memory/30-domains/inventory/context.md)** - Stock management
327
- - **[Regras de Negócio](memory/10-product/business-rules.md)** - Regras do sistema
328
-
329
- ## 🔒 Segurança
330
-
331
- ✅ **Validação de entrada** - class-validator em todos os DTOs
332
- ✅ **Sanitização** - TypeORM parameterizado (sem SQL injection)
333
- ✅ **JWT** - Token-based auth (mock para MVP)
334
- ✅ **HTTPS** - Obrigatório em produção
335
- ✅ **CORS** - Configurável por ambiente
336
- ✅ **Rate Limiting** - 100 req/min por IP
337
- ✅ **Secrets** - Via .env (nunca em código)
338
-
339
- ## ⚡ Performance
340
-
341
- | Métrica | Target | Implementação |
342
- |---------|--------|---------------|
343
- | Listar produtos | < 200ms | Índices + Paginação + Cache |
344
- | Busca/filtro | < 300ms | Full-text search |
345
- | Checkout | < 500ms | Transações atômicas |
346
- | Uptime | 99.9% | Health checks + Redis |
347
-
348
- ## 🐳 Docker Compose
349
-
350
- ```bash
351
- # Iniciar todos os serviços
352
- docker-compose up -d
353
-
354
- # Ver logs
355
- docker-compose logs -f api
356
-
357
- # Parar serviços
358
- docker-compose down
359
-
360
- # Remover volumes
361
- docker-compose down -v
362
- ```
363
-
364
- ## 🚢 Deploy em Produção
365
-
366
- ### Build
367
-
368
- ```bash
369
- docker build -t ecommerce-api:1.0 .
370
- ```
371
-
372
- ### Run
373
-
374
- ```bash
375
- docker run -p 3000:3000 \
376
- -e NODE_ENV=production \
377
- -e DB_HOST=db.example.com \
378
- -e DB_USERNAME=prod_user \
379
- -e DB_PASSWORD=*** \
380
- ecommerce-api:1.0
381
- ```
382
-
383
- ### Variáveis Críticas em Produção
384
-
385
- ```bash
386
- NODE_ENV=production
387
- DB_HOST=remote-postgres
388
- DB_PASSWORD=complex-password
389
- JWT_SECRET=very-secure-key
390
- CORS_ORIGIN=https://yourshop.com
391
- ```
392
-
393
- ## 📊 Métricas de Sucesso
394
-
395
- - ✅ Tempo de resposta < 200ms p95
396
- - ✅ 99.9% uptime
397
- - ✅ Suporte a 1000+ concurrent users
398
- - ✅ 10k+ produtos no catálogo
399
- - ✅ > 80% test coverage
400
-
401
- ## 🔄 CI/CD (Future)
402
-
403
- Recomendado:
404
- - **GitHub Actions** - Testes automáticos
405
- - **Docker Registry** - Build e push de imagens
406
- - **Kubernetes** - Orquestração de containers
407
-
408
- ## 📝 Logs
409
-
410
- Logs estruturados em JSON:
411
-
412
- ```json
413
- {
414
- "timestamp": "2024-01-15T10:30:00.000Z",
415
- "level": "info",
416
- "context": "ProductsController",
417
- "message": "GET /api/products",
418
- "duration": "45ms",
419
- "userId": "user-uuid"
420
- }
421
- ```
422
-
423
- ## 🐛 Troubleshooting
424
-
425
- ### Erro de Conexão com PostgreSQL
426
- ```bash
427
- # Verificar container
428
- docker ps
429
-
430
- # Logs
431
- docker-compose logs postgres
432
- ```
433
-
434
- ### Porta 3000 em Uso
435
- ```bash
436
- # Trocar porta em docker-compose.yml
437
- ports:
438
- - "3001:3000"
439
- ```
440
-
441
- ### Build Falhando
442
- ```bash
443
- # Limpar dependências
444
- rm -rf node_modules
445
- npm install
446
-
447
- # Rebuildar
448
- npm run build
449
- ```
450
-
451
- ## 📞 Suporte e Contribuição
452
-
453
- - 📧 Issues via GitHub
454
- - 🤝 Pull requests bem-vindos
455
- - 📚 Contribuições na documentação
456
-
457
- ## 📄 Licença
458
-
459
- MIT License - veja LICENSE para detalhes
460
-
461
- ---
462
-
463
- **Feito com ❤️ para e-commerce moderno**
464
-
465
- Última atualização: 2024-01-XX
1
+ # E-Commerce Starter - Boilerplate Completo
2
+
3
+ Uma plataforma de e-commerce modular, escalável e pronta para produção construída com **NestJS** + **PostgreSQL** + **Redis**.
4
+
5
+ ## 🎯 Características Principais
6
+
7
+ ✅ **Catálogo de Produtos** - Produtos, categorias, filtros e busca
8
+ ✅ **Carrinho de Compras** - Gerenciamento de itens com persistência
9
+ ✅ **Checkout Simplificado** - Fluxo completo de compra
10
+ ✅ **Mock Stripe** - Processamento de pagamentos simulado (90% sucesso)
11
+ ✅ **Gerenciamento de Pedidos** - Rastreamento completo com status
12
+ ✅ **Controle de Inventário** - Stock management em tempo real
13
+ ✅ **Cupons de Desconto** - Aplicação de descontos
14
+ ✅ **Avaliações de Produtos** - Rating e reviews de clientes
15
+ ✅ **Documentação Memory** - 10 níveis de contexto estruturado
16
+ ✅ **API Swagger** - Documentação interativa completa
17
+
18
+ ## 🚀 Quick Start
19
+
20
+ ### Pré-requisitos
21
+ - Node.js 18+
22
+ - Docker + Docker Compose
23
+ - PostgreSQL 14+ (ou via Docker)
24
+ - Redis (ou via Docker)
25
+
26
+ ### 1️⃣ Clonar e Instalar
27
+
28
+ ```bash
29
+ cd boilerplates/03-ecommerce-starter/backend
30
+ npm install
31
+ ```
32
+
33
+ ### 2️⃣ Setup com Docker
34
+
35
+ ```bash
36
+ docker-compose up -d
37
+ ```
38
+
39
+ Isto inicia:
40
+ - **PostgreSQL** em localhost:5432
41
+ - **Redis** em localhost:6379
42
+ - **API** em localhost:3000
43
+
44
+ ### 3️⃣ Configurar .env
45
+
46
+ ```bash
47
+ cp .env.example .env
48
+ ```
49
+
50
+ ### 4️⃣ Rodar Migrations (Futuro)
51
+
52
+ ```bash
53
+ npm run migration:run
54
+ ```
55
+
56
+ ### 5️⃣ Seed Database (Opcional)
57
+
58
+ ```bash
59
+ npm run seed
60
+ ```
61
+
62
+ ### 6️⃣ Iniciar Dev Server
63
+
64
+ ```bash
65
+ npm run start:dev
66
+ ```
67
+
68
+ ### 7️⃣ Acessar Documentação
69
+
70
+ - **Swagger UI**: http://localhost:3000/docs
71
+ - **Health Check**: http://localhost:3000/api/health
72
+
73
+ ## 📚 Arquitetura
74
+
75
+ ```
76
+ ┌─────────────────────────────────────────┐
77
+ │ Frontend (React/Vue) │
78
+ │ Catálogo | Carrinho | Checkout │
79
+ └────────────┬────────────────────────────┘
80
+ │ REST API (JSON)
81
+ ┌────────────▼────────────────────────────┐
82
+ │ NestJS Backend (Port 3000) │
83
+ │ ┌─────────────────────────────────┐ │
84
+ │ │ Products | Cart | Orders │ │
85
+ │ │ Payments | Inventory | Coupons │ │
86
+ │ │ Reviews | Auth │ │
87
+ │ └─────────────────────────────────┘ │
88
+ └────────┬──────────┬──────────┬──────────┘
89
+ │ │ │
90
+ PostgreSQL Redis Stripe
91
+ (Dados) (Cache) (Mock)
92
+ ```
93
+
94
+ ## 🔌 API Endpoints
95
+
96
+ ### 📦 Produtos
97
+
98
+ ```bash
99
+ # Listar produtos (com paginação/filtro)
100
+ GET /api/products?page=1&limit=20&category=electronics&minPrice=10&maxPrice=1000
101
+
102
+ # Detalhes do produto
103
+ GET /api/products/:productId
104
+
105
+ # Criar produto (admin)
106
+ POST /api/products
107
+ Content-Type: application/json
108
+ {
109
+ "name": "Laptop",
110
+ "price": 1299.99,
111
+ "categoryId": "uuid",
112
+ "sku": "LAPTOP-001"
113
+ }
114
+
115
+ # Atualizar produto (admin)
116
+ PUT /api/products/:productId
117
+
118
+ # Deletar produto (admin)
119
+ DELETE /api/products/:productId
120
+
121
+ # Listar categorias
122
+ GET /api/categories
123
+ ```
124
+
125
+ ### 🛒 Carrinho
126
+
127
+ ```bash
128
+ # Adicionar ao carrinho
129
+ POST /api/cart/add
130
+ {
131
+ "productId": "uuid",
132
+ "quantity": 2
133
+ }
134
+
135
+ # Ver carrinho
136
+ GET /api/cart
137
+
138
+ # Remover item
139
+ DELETE /api/cart/items/:productId
140
+
141
+ # Atualizar quantidade
142
+ PUT /api/cart/items/:productId
143
+ {
144
+ "quantity": 3
145
+ }
146
+
147
+ # Aplicar cupom
148
+ POST /api/cart/apply-coupon
149
+ {
150
+ "code": "SUMMER10"
151
+ }
152
+ ```
153
+
154
+ ### 💳 Checkout e Pagamentos
155
+
156
+ ```bash
157
+ # Validar carrinho antes de checkout
158
+ POST /api/cart/validate
159
+ {
160
+ "shippingInfo": {
161
+ "street": "Rua A",
162
+ "number": "123",
163
+ "city": "São Paulo",
164
+ "state": "SP",
165
+ "zip": "01234-567"
166
+ }
167
+ }
168
+
169
+ # Processar pagamento (cria pedido automaticamente)
170
+ POST /api/payments/process
171
+ {
172
+ "amount": 1299.99,
173
+ "method": "credit_card",
174
+ "card": {
175
+ "number": "4111111111111111",
176
+ "expiry": "12/25",
177
+ "cvc": "123"
178
+ }
179
+ }
180
+
181
+ Response (Success - 90%):
182
+ {
183
+ "status": "approved",
184
+ "transactionId": "stripe-uuid",
185
+ "orderId": "order-uuid"
186
+ }
187
+
188
+ Response (Failure - 10%):
189
+ {
190
+ "status": "declined",
191
+ "errorCode": "card_declined",
192
+ "message": "Cartão recusado"
193
+ }
194
+ ```
195
+
196
+ ### 📋 Pedidos
197
+
198
+ ```bash
199
+ # Listar pedidos do usuário
200
+ GET /api/orders?page=1&status=processing
201
+
202
+ # Detalhes do pedido
203
+ GET /api/orders/:orderId
204
+
205
+ # Cancelar pedido
206
+ POST /api/orders/:orderId/cancel
207
+
208
+ # Atualizar status (admin)
209
+ PUT /api/orders/:orderId/status
210
+ {
211
+ "status": "shipped",
212
+ "trackingNumber": "BR123456789"
213
+ }
214
+ ```
215
+
216
+ ### 📊 Inventário
217
+
218
+ ```bash
219
+ # Ver estoque de um produto
220
+ GET /api/inventory/:productId
221
+
222
+ # Listar estoque de todos (admin)
223
+ GET /api/inventory?status=low-stock
224
+
225
+ # Reposição (admin)
226
+ POST /api/inventory/restock
227
+ {
228
+ "productId": "uuid",
229
+ "quantity": 100
230
+ }
231
+ ```
232
+
233
+ ### 🎁 Cupons
234
+
235
+ ```bash
236
+ # Validar cupom
237
+ GET /api/coupons/:code/validate
238
+
239
+ # Criar cupom (admin)
240
+ POST /api/coupons
241
+ {
242
+ "code": "SUMMER10",
243
+ "discount_percent": 10,
244
+ "expiresAt": "2024-12-31T23:59:59Z"
245
+ }
246
+ ```
247
+
248
+ ### ⭐ Avaliações
249
+
250
+ ```bash
251
+ # Listar reviews de um produto
252
+ GET /api/products/:productId/reviews
253
+
254
+ # Criar review (usuário autenticado)
255
+ POST /api/orders/:orderId/items/:itemId/review
256
+ {
257
+ "rating": 5,
258
+ "comment": "Produto excelente!"
259
+ }
260
+ ```
261
+
262
+ ## 🧪 Testes
263
+
264
+ ```bash
265
+ # Testes unitários
266
+ npm run test
267
+
268
+ # Testes E2E
269
+ npm run test:e2e
270
+
271
+ # Coverage
272
+ npm run test:cov
273
+ ```
274
+
275
+ ## 🏗️ Estrutura do Projeto
276
+
277
+ ```
278
+ backend/
279
+ ├── src/
280
+ │ ├── main.ts # Entry point
281
+ │ ├── app.module.ts # Root module
282
+ │ ├── modules/
283
+ │ │ ├── products/ # Catálogo
284
+ │ │ ├── cart/ # Carrinho
285
+ │ │ ├── orders/ # Pedidos
286
+ │ │ ├── payments/ # Pagamentos
287
+ │ │ ├── inventory/ # Estoque
288
+ │ │ ├── coupons/ # Cupons
289
+ │ │ ├── reviews/ # Avaliações
290
+ │ │ └── auth/ # Autenticação (mock)
291
+ │ ├── common/
292
+ │ │ ├── filters/
293
+ │ │ ├── middleware/
294
+ │ │ └── decorators/
295
+ │ └── config/
296
+ ├── test/ # E2E tests
297
+ ├── docker-compose.yml
298
+ ├── Dockerfile
299
+ ├── package.json
300
+ ├── tsconfig.json
301
+ ├── jest.config.js
302
+ └── .env.example
303
+
304
+ memory/ # 10 níveis de contexto
305
+ ├── 00-global/ # Missão, padrões
306
+ ├── 10-product/ # Requisitos, personas
307
+ ├── 20-architecture/ # Design técnico
308
+ ├── 30-domains/ # Contexto por módulo
309
+ ├── 40-delivery/ # Roadmap
310
+ ├── 50-orchestration/ # Agentes, handoffs
311
+ ├── 60-runs/ # Logs de execução
312
+ ├── 70-summaries/ # Resumos
313
+ ├── 80-data/ # Schemas
314
+ └── 90-decisions/ # ADRs
315
+ ```
316
+
317
+ ## 📖 Documentação
318
+
319
+ Consulte os arquivos de memory para detalhes:
320
+
321
+ - **[Visão do Produto](memory/10-product/vision.md)** - Personas, user stories
322
+ - **[Arquitetura](memory/20-architecture/overview.md)** - Design técnico
323
+ - **[Catálogo](memory/30-domains/catalog/context.md)** - Domínio de produtos
324
+ - **[Pedidos](memory/30-domains/orders/context.md)** - Domínio de orders
325
+ - **[Pagamentos](memory/30-domains/payments/context.md)** - Mock Stripe
326
+ - **[Inventário](memory/30-domains/inventory/context.md)** - Stock management
327
+ - **[Regras de Negócio](memory/10-product/business-rules.md)** - Regras do sistema
328
+
329
+ ## 🔒 Segurança
330
+
331
+ ✅ **Validação de entrada** - class-validator em todos os DTOs
332
+ ✅ **Sanitização** - TypeORM parameterizado (sem SQL injection)
333
+ ✅ **JWT** - Token-based auth (mock para MVP)
334
+ ✅ **HTTPS** - Obrigatório em produção
335
+ ✅ **CORS** - Configurável por ambiente
336
+ ✅ **Rate Limiting** - 100 req/min por IP
337
+ ✅ **Secrets** - Via .env (nunca em código)
338
+
339
+ ## ⚡ Performance
340
+
341
+ | Métrica | Target | Implementação |
342
+ |---------|--------|---------------|
343
+ | Listar produtos | < 200ms | Índices + Paginação + Cache |
344
+ | Busca/filtro | < 300ms | Full-text search |
345
+ | Checkout | < 500ms | Transações atômicas |
346
+ | Uptime | 99.9% | Health checks + Redis |
347
+
348
+ ## 🐳 Docker Compose
349
+
350
+ ```bash
351
+ # Iniciar todos os serviços
352
+ docker-compose up -d
353
+
354
+ # Ver logs
355
+ docker-compose logs -f api
356
+
357
+ # Parar serviços
358
+ docker-compose down
359
+
360
+ # Remover volumes
361
+ docker-compose down -v
362
+ ```
363
+
364
+ ## 🚢 Deploy em Produção
365
+
366
+ ### Build
367
+
368
+ ```bash
369
+ docker build -t ecommerce-api:1.0 .
370
+ ```
371
+
372
+ ### Run
373
+
374
+ ```bash
375
+ docker run -p 3000:3000 \
376
+ -e NODE_ENV=production \
377
+ -e DB_HOST=db.example.com \
378
+ -e DB_USERNAME=prod_user \
379
+ -e DB_PASSWORD=*** \
380
+ ecommerce-api:1.0
381
+ ```
382
+
383
+ ### Variáveis Críticas em Produção
384
+
385
+ ```bash
386
+ NODE_ENV=production
387
+ DB_HOST=remote-postgres
388
+ DB_PASSWORD=complex-password
389
+ JWT_SECRET=very-secure-key
390
+ CORS_ORIGIN=https://yourshop.com
391
+ ```
392
+
393
+ ## 📊 Métricas de Sucesso
394
+
395
+ - ✅ Tempo de resposta < 200ms p95
396
+ - ✅ 99.9% uptime
397
+ - ✅ Suporte a 1000+ concurrent users
398
+ - ✅ 10k+ produtos no catálogo
399
+ - ✅ > 80% test coverage
400
+
401
+ ## 🔄 CI/CD (Future)
402
+
403
+ Recomendado:
404
+ - **GitHub Actions** - Testes automáticos
405
+ - **Docker Registry** - Build e push de imagens
406
+ - **Kubernetes** - Orquestração de containers
407
+
408
+ ## 📝 Logs
409
+
410
+ Logs estruturados em JSON:
411
+
412
+ ```json
413
+ {
414
+ "timestamp": "2024-01-15T10:30:00.000Z",
415
+ "level": "info",
416
+ "context": "ProductsController",
417
+ "message": "GET /api/products",
418
+ "duration": "45ms",
419
+ "userId": "user-uuid"
420
+ }
421
+ ```
422
+
423
+ ## 🐛 Troubleshooting
424
+
425
+ ### Erro de Conexão com PostgreSQL
426
+ ```bash
427
+ # Verificar container
428
+ docker ps
429
+
430
+ # Logs
431
+ docker-compose logs postgres
432
+ ```
433
+
434
+ ### Porta 3000 em Uso
435
+ ```bash
436
+ # Trocar porta em docker-compose.yml
437
+ ports:
438
+ - "3001:3000"
439
+ ```
440
+
441
+ ### Build Falhando
442
+ ```bash
443
+ # Limpar dependências
444
+ rm -rf node_modules
445
+ npm install
446
+
447
+ # Rebuildar
448
+ npm run build
449
+ ```
450
+
451
+ ## 📞 Suporte e Contribuição
452
+
453
+ - 📧 Issues via GitHub
454
+ - 🤝 Pull requests bem-vindos
455
+ - 📚 Contribuições na documentação
456
+
457
+ ## 📄 Licença
458
+
459
+ MIT License - veja LICENSE para detalhes
460
+
461
+ ---
462
+
463
+ **Feito com ❤️ para e-commerce moderno**
464
+
465
+ Última atualização: 2024-01-XX