forjajs 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (558) hide show
  1. package/.claude/agents/context-engineer.md +25 -0
  2. package/.claude/agents/governance.md +32 -0
  3. package/.claude/agents/marketing.md +24 -0
  4. package/.claude/agents/orchestrator.md +31 -0
  5. package/.claude/agents/product.md +26 -0
  6. package/.claude/agents/sdd-architect.md +34 -0
  7. package/.claude/settings.json +41 -0
  8. package/.gemini-instructions.md +87 -0
  9. package/.github/copilot-instructions.md +87 -0
  10. package/.memoryrc.json +104 -0
  11. package/.openai-instructions.md +87 -0
  12. package/AGENTS.md +132 -0
  13. package/CHANGELOG.md +106 -0
  14. package/CONTRIBUTING.md +32 -0
  15. package/DOC-MAP.md +65 -0
  16. package/LICENSE +21 -0
  17. package/README.md +260 -0
  18. package/bin/create-memory-nest-kit.js +125 -0
  19. package/bin/forja.mjs +143 -0
  20. package/bin/init-project.js +612 -0
  21. package/boilerplates/01-api-rest/README.md +336 -0
  22. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
  23. package/boilerplates/02-saas-starter/.env.example +25 -0
  24. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
  25. package/boilerplates/02-saas-starter/INFO.md +252 -0
  26. package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
  27. package/boilerplates/02-saas-starter/README.md +305 -0
  28. package/boilerplates/02-saas-starter/START-HERE.md +259 -0
  29. package/boilerplates/02-saas-starter/backend/package.json +87 -0
  30. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
  31. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
  33. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
  34. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
  35. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
  36. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
  42. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
  46. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
  50. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
  54. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
  58. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
  59. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
  60. package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
  61. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
  62. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
  63. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
  64. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
  65. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
  66. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
  67. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
  68. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
  69. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
  70. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
  71. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
  73. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
  75. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
  77. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
  78. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
  79. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
  80. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
  81. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
  82. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
  83. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
  84. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
  85. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
  86. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
  87. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
  88. package/boilerplates/03-ecommerce-starter/README.md +465 -0
  89. package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
  98. package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
  99. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
  113. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
  114. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
  115. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
  116. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
  117. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
  118. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
  123. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
  126. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
  130. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
  134. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
  135. package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
  136. package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
  137. package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
  138. package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
  139. package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
  140. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
  141. package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
  142. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
  143. package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
  144. package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
  145. package/boilerplates/04-microservices-starter/.env.example +43 -0
  146. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
  147. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
  148. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
  149. package/boilerplates/04-microservices-starter/INDEX.md +377 -0
  150. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
  151. package/boilerplates/04-microservices-starter/README.md +466 -0
  152. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
  153. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
  154. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
  155. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
  156. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
  157. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
  158. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
  159. package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
  160. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
  161. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
  162. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
  163. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
  164. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
  165. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
  166. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
  167. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
  168. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
  169. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
  170. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
  171. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
  172. package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
  173. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
  174. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
  175. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
  176. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
  177. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
  178. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
  179. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
  180. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
  181. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
  182. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
  183. package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
  184. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
  185. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
  186. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
  187. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
  188. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
  189. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
  190. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
  191. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
  192. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
  193. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
  194. package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
  195. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
  196. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
  197. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
  198. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
  199. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
  200. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
  201. package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
  202. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
  203. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
  204. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
  205. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
  206. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
  207. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
  208. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
  209. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
  210. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
  211. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
  212. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
  213. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
  214. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
  215. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
  216. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
  217. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
  218. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
  219. package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
  220. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
  221. package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
  222. package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
  223. package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
  224. package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
  225. package/boilerplates/04-microservices-starter/package.json +21 -0
  226. package/boilerplates/05-monorepo-starter/.env.example +1 -0
  227. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
  228. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
  229. package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
  230. package/boilerplates/05-monorepo-starter/README.md +318 -0
  231. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
  232. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
  233. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
  234. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
  235. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
  236. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
  237. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
  238. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
  239. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
  240. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
  241. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
  242. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
  243. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
  244. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
  245. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
  246. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
  247. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
  248. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
  249. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
  250. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
  251. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
  252. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
  253. package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
  254. package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
  255. package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
  256. package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
  257. package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
  258. package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
  259. package/boilerplates/05-monorepo-starter/package.json +30 -0
  260. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
  261. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
  262. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
  263. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
  264. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
  265. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
  266. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
  267. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
  268. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
  269. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
  270. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
  271. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
  272. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
  273. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
  274. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
  275. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
  276. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
  277. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
  278. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
  279. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
  280. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
  281. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
  282. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
  283. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
  284. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
  285. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
  286. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
  287. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
  288. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
  289. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
  290. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
  291. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
  292. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
  293. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
  294. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
  295. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
  296. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
  297. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
  298. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
  299. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
  300. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
  301. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
  302. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
  303. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
  304. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
  305. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
  306. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
  307. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
  308. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
  309. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
  310. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
  311. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
  312. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
  313. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
  314. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
  315. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
  316. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
  317. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
  318. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
  319. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
  320. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
  321. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
  322. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
  323. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
  324. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
  325. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
  326. package/boilerplates/05-monorepo-starter/turbo.json +35 -0
  327. package/boilerplates/README.md +407 -0
  328. package/design-md/BRIEF-TEMPLATE.md +47 -0
  329. package/design-md/INDEX.md +35 -0
  330. package/design-md/MATRIX.md +24 -0
  331. package/design-md/PLAYBOOK.md +35 -0
  332. package/design-md/examples/agent-console-brief.md +48 -0
  333. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
  334. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
  335. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
  336. package/docs/agent-harnesses.md +122 -0
  337. package/docs/archive/CHECKLIST-FINAL.md +295 -0
  338. package/docs/archive/FASE2-SUMMARY.md +263 -0
  339. package/docs/archive/FASE3-PROGRESS.md +355 -0
  340. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
  341. package/docs/archive/INDICE-MASTER.md +282 -0
  342. package/docs/archive/PROJETO-COMPLETO.md +363 -0
  343. package/docs/archive/README-REFINAMENTO.md +293 -0
  344. package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
  345. package/docs/archive/REFINAMENTO-v1.0.md +565 -0
  346. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
  347. package/docs/archive/START-HERE.md +319 -0
  348. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
  349. package/docs/archive/examples/v1/AGENTS.md +10 -0
  350. package/docs/archive/examples/v1/README.md +36 -0
  351. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
  352. package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
  353. package/docs/archive/examples/v1/backend/package.json +42 -0
  354. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
  355. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
  356. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
  357. package/docs/archive/examples/v1/backend/src/main.ts +10 -0
  358. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
  359. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
  360. package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
  361. package/docs/archive/examples/v1/docs/.gitkeep +0 -0
  362. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
  363. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
  364. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
  365. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
  366. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
  367. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
  368. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
  369. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
  370. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
  371. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
  372. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
  373. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
  374. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
  375. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
  376. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
  377. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
  378. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
  379. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
  380. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
  381. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
  382. package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
  383. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
  384. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
  385. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
  386. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
  387. package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
  388. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
  389. package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
  390. package/docs/archive/examples/v2/.memoryrc.json +8 -0
  391. package/docs/archive/examples/v2/AGENTS.md +16 -0
  392. package/docs/archive/examples/v2/README.md +35 -0
  393. package/docs/archive/examples/v2/agents/README.md +3 -0
  394. package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
  395. package/docs/archive/examples/v2/agents/dba.md +4 -0
  396. package/docs/archive/examples/v2/agents/frontend.md +4 -0
  397. package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
  398. package/docs/archive/examples/v2/agents/reviewer.md +6 -0
  399. package/docs/archive/examples/v2/agents/security.md +4 -0
  400. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
  401. package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
  402. package/docs/archive/examples/v2/backend/package.json +42 -0
  403. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
  404. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
  405. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
  406. package/docs/archive/examples/v2/backend/src/main.ts +10 -0
  407. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
  408. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
  409. package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
  410. package/docs/archive/examples/v2/docs/.gitkeep +0 -0
  411. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
  412. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
  413. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
  414. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
  415. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
  416. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
  417. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
  418. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
  419. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
  420. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
  421. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
  422. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
  423. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
  424. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
  425. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
  426. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
  427. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
  428. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
  429. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
  430. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
  431. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
  432. package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
  433. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
  434. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
  435. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
  436. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
  437. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
  438. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
  439. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
  440. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
  441. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
  442. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
  443. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
  444. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
  445. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
  446. package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
  447. package/docs/archive/examples/v2/memory/README.md +8 -0
  448. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
  449. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
  450. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
  451. package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
  452. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
  453. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
  454. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
  455. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
  456. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
  457. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
  458. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
  459. package/docs/capacidades-externas.md +70 -0
  460. package/docs/cli-first-operacao.md +74 -0
  461. package/docs/dashboard.md +102 -0
  462. package/docs/dev-workflow.md +421 -0
  463. package/docs/examples.md +546 -0
  464. package/docs/fluxo.md +103 -0
  465. package/docs/glossary.md +453 -0
  466. package/docs/init-project.md +457 -0
  467. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
  468. package/docs/personas/architect/README.md +333 -0
  469. package/docs/personas/developer/README.md +371 -0
  470. package/docs/personas/executive/README.md +172 -0
  471. package/docs/personas/qa/README.md +350 -0
  472. package/docs/processo-projeto.md +138 -0
  473. package/docs/publishing.md +377 -0
  474. package/docs/quick-reference.md +409 -0
  475. package/docs/structure.md +360 -0
  476. package/docs/token-optimization.md +494 -0
  477. package/lib/context-builder.js +257 -0
  478. package/lib/core/registry.mjs +284 -0
  479. package/lib/generators/memory-generator.js +844 -0
  480. package/lib/generators/nest-generator.js +496 -0
  481. package/lib/generators/readme-generator.js +213 -0
  482. package/lib/templates/harness/code-intel.mjs +119 -0
  483. package/lib/templates/harness/mcp.json +10 -0
  484. package/lib/utils/file-helpers.js +40 -0
  485. package/lib/validators/structure-validator.js +253 -0
  486. package/lib/workspace.mjs +213 -0
  487. package/memory/00-global/mission.md +15 -0
  488. package/memory/00-global/shared-knowledge.md +8 -0
  489. package/memory/00-global/standards.md +47 -0
  490. package/memory/10-product/personas.md +21 -0
  491. package/memory/10-product/vision.md +27 -0
  492. package/memory/30-projects/README.md +15 -0
  493. package/memory/40-delivery/backlog.md +15 -0
  494. package/memory/40-delivery/current-sprint.md +21 -0
  495. package/memory/50-orchestration/gsd-harness.md +55 -0
  496. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
  497. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
  498. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
  499. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
  500. package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
  501. package/memory/90-decisions/0006-docs-por-persona.md +23 -0
  502. package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
  503. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
  504. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
  505. package/memory/90-decisions/0010-banco-postgres.md +30 -0
  506. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
  507. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
  508. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
  509. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
  510. package/memory/90-decisions/0019-workspace-separado.md +45 -0
  511. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
  512. package/memory/90-decisions/_template.md +28 -0
  513. package/package.json +107 -0
  514. package/prompts/context-engineer-agent.md +19 -0
  515. package/prompts/governance-agent.md +15 -0
  516. package/prompts/marketing-agent.md +13 -0
  517. package/prompts/orchestrator-agent.md +18 -0
  518. package/prompts/product-agent.md +13 -0
  519. package/prompts/sdd-architect-agent.md +20 -0
  520. package/scripts/agent-harness.mjs +578 -0
  521. package/scripts/agent-router.mjs +189 -0
  522. package/scripts/build-smart-context.js +87 -0
  523. package/scripts/check-standards.js +98 -0
  524. package/scripts/compress-memory.mjs +198 -0
  525. package/scripts/compress-project-memory.js +58 -0
  526. package/scripts/context-ops.mjs +463 -0
  527. package/scripts/dev.mjs +349 -0
  528. package/scripts/extract-global-knowledge.js +52 -0
  529. package/scripts/generate-dashboard.js +59 -0
  530. package/scripts/hook-session-start.mjs +70 -0
  531. package/scripts/hook-user-prompt.mjs +185 -0
  532. package/scripts/memory-schema.mjs +68 -0
  533. package/scripts/pre-commit.sh +102 -0
  534. package/scripts/query-universal-memory.js +50 -0
  535. package/scripts/spec-cli.mjs +193 -0
  536. package/scripts/sprint-manager.js +200 -0
  537. package/scripts/sync-universal-memory.js +278 -0
  538. package/scripts/token-benchmark.mjs +203 -0
  539. package/scripts/tools-doctor.mjs +77 -0
  540. package/specs/README.md +70 -0
  541. package/specs/_templates/plan.md +43 -0
  542. package/specs/_templates/spec.md +43 -0
  543. package/specs/_templates/tasks.md +32 -0
  544. package/specs/agent-dashboard/plan.md +165 -0
  545. package/specs/agent-dashboard/spec.md +89 -0
  546. package/specs/agent-dashboard/tasks.md +168 -0
  547. package/specs/cli-first-operacao/plan.md +53 -0
  548. package/specs/cli-first-operacao/spec.md +53 -0
  549. package/specs/cli-first-operacao/tasks.md +53 -0
  550. package/specs/dev-token-assets-db/plan.md +71 -0
  551. package/specs/dev-token-assets-db/spec.md +58 -0
  552. package/specs/dev-token-assets-db/tasks.md +58 -0
  553. package/specs/forja-core/spec.md +71 -0
  554. package/specs/harness-codegraph/spec.md +71 -0
  555. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
  556. package/specs/reestruturacao-forja-v2/plan.md +95 -0
  557. package/specs/reestruturacao-forja-v2/spec.md +70 -0
  558. package/specs/reestruturacao-forja-v2/tasks.md +113 -0
@@ -0,0 +1,124 @@
1
+ # Visão do Produto
2
+
3
+ ## Declaração de Visão
4
+ "Uma plataforma de e-commerce moderna que permite empreendedores criar lojas online profissionais com controle total de inventário, pagamentos e análise de vendas."
5
+
6
+ ## Personas Principais
7
+
8
+ ### 1. **Proprietário da Loja (Store Owner)**
9
+ - **Objetivo**: Vender produtos online de forma fácil e profissional
10
+ - **Desafios**: Gerenciar múltiplos produtos, rastrear pedidos, processar pagamentos
11
+ - **Necessidades**: Dashboard simples, relatórios de vendas, gerenciamento de catálogo
12
+
13
+ ### 2. **Cliente Final (Shopper)**
14
+ - **Objetivo**: Encontrar e comprar produtos de forma rápida e segura
15
+ - **Desafios**: Navegar catálogo grande, processar pagamento facilmente
16
+ - **Necessidades**: Busca/filtro, carrinho intuitivo, checkout rápido, rastreamento de pedido
17
+
18
+ ### 3. **Gerente de Inventário (Inventory Manager)**
19
+ - **Objetivo**: Manter stock atualizado e evitar overselling
20
+ - **Desafios**: Sincronização em tempo real entre vendas e estoque
21
+ - **Necessidades**: Alertas de low stock, relatórios de movimento
22
+
23
+ ## User Stories Críticas
24
+
25
+ ### US-001: Catálogo de Produtos
26
+ ```
27
+ Como cliente
28
+ Quero buscar, filtrar e visualizar produtos
29
+ Para encontrar o que desejo comprar facilmente
30
+ AC:
31
+ - Listar produtos com paginação
32
+ - Filtrar por categoria, preço, rating
33
+ - Busca por nome/descrição
34
+ - Tempo < 200ms
35
+ ```
36
+
37
+ ### US-002: Adicionar ao Carrinho
38
+ ```
39
+ Como cliente
40
+ Quero adicionar itens ao carrinho e modificar quantidades
41
+ Para revisar antes de checkout
42
+ AC:
43
+ - Adicionar item com quantidade
44
+ - Remover item
45
+ - Atualizar quantidade
46
+ - Carrinho persiste (localStorage ou session)
47
+ ```
48
+
49
+ ### US-003: Checkout e Pagamento
50
+ ```
51
+ Como cliente
52
+ Quero fazer checkout seguro e rápido
53
+ Para completar minha compra
54
+ AC:
55
+ - Revisar items e total
56
+ - Informações de entrega
57
+ - Processar pagamento (mock)
58
+ - Confirmação com número de pedido
59
+ ```
60
+
61
+ ### US-004: Rastreamento de Pedido
62
+ ```
63
+ Como cliente
64
+ Quero acompanhar meu pedido
65
+ Para saber quando chegar
66
+ AC:
67
+ - Ver status (pendente, processando, enviado, entregue)
68
+ - Ver histórico de mudanças
69
+ - Notificações de mudança de status
70
+ ```
71
+
72
+ ### US-005: Avaliações de Produtos
73
+ ```
74
+ Como cliente
75
+ Quero avaliar produtos que comprei
76
+ Para ajudar outros clientes
77
+ AC:
78
+ - 1-5 stars
79
+ - Texto opcional
80
+ - Mostrar media de ratings
81
+ ```
82
+
83
+ ## Requisitos Funcionais por Módulo
84
+
85
+ ### Catálogo (Products + Categories)
86
+ - CRUD de produtos (create, read, update, delete)
87
+ - Categorias hierárquicas
88
+ - Imagens de produto (URL/upload)
89
+ - Preços e promoções
90
+ - Stock disponível
91
+
92
+ ### Carrinho (Cart)
93
+ - Persistência de carrinho
94
+ - Cálculo de total com imposto (mock)
95
+ - Aplicação de cupons
96
+ - Validação de stock em checkout
97
+
98
+ ### Pedidos (Orders)
99
+ - Criação automática no checkout
100
+ - Status workflow: pending → processing → shipped → delivered
101
+ - Detalhes do cliente e endereço
102
+ - Histórico completo
103
+
104
+ ### Pagamentos (Payments)
105
+ - Mock Stripe: sim/não + transactionId
106
+ - Registro de tentativas
107
+ - Webhook simulado (future)
108
+
109
+ ### Inventário (Inventory)
110
+ - Reserva de stock no checkout
111
+ - Sincronização com produtos
112
+ - Alerts para reposição
113
+ - Relatórios de movimento
114
+
115
+ ### Cupons (Coupons)
116
+ - Código + desconto (% ou R$)
117
+ - Data de validade
118
+ - Uso máximo
119
+ - Aplicação em checkout
120
+
121
+ ### Avaliações (Reviews)
122
+ - Rating + texto
123
+ - Moderação (future)
124
+ - Média exibida em produto
@@ -0,0 +1,253 @@
1
+ # Backend - Arquitetura NestJS
2
+
3
+ ## Stack Técnico
4
+
5
+ ```
6
+ Runtime: Node.js 18+
7
+ Framework: NestJS 10+
8
+ Language: TypeScript (strict mode)
9
+ Database: PostgreSQL 14+
10
+ ORM: TypeORM
11
+ Cache: Redis
12
+ API Docs: Swagger/OpenAPI
13
+ Testing: Jest
14
+ ```
15
+
16
+ ## Estrutura de Diretórios
17
+
18
+ ```
19
+ backend/
20
+ ├── src/
21
+ │ ├── main.ts # Entry point
22
+ │ ├── app.module.ts # Root module
23
+ │ ├── config/
24
+ │ │ ├── database.ts # TypeORM config
25
+ │ │ ├── cache.ts # Redis config
26
+ │ │ └── payment.ts # Mock Stripe
27
+ │ ├── modules/
28
+ │ │ ├── products/
29
+ │ │ │ ├── product.controller.ts
30
+ │ │ │ ├── product.service.ts
31
+ │ │ │ ├── product.repository.ts
32
+ │ │ │ ├── product.entity.ts
33
+ │ │ │ ├── category.entity.ts
34
+ │ │ │ ├── product.module.ts
35
+ │ │ │ └── dto/
36
+ │ │ │ ├── create-product.dto.ts
37
+ │ │ │ └── update-product.dto.ts
38
+ │ │ ├── cart/
39
+ │ │ ├── orders/
40
+ │ │ ├── payments/
41
+ │ │ ├── inventory/
42
+ │ │ ├── coupons/
43
+ │ │ ├── reviews/
44
+ │ │ └── auth/ (mock)
45
+ │ ├── common/
46
+ │ │ ├── filters/
47
+ │ │ │ └── http-exception.filter.ts
48
+ │ │ ├── middleware/
49
+ │ │ │ ├── logging.middleware.ts
50
+ │ │ │ └── auth.middleware.ts
51
+ │ │ ├── decorators/
52
+ │ │ │ ├── current-user.decorator.ts
53
+ │ │ │ └── roles.decorator.ts
54
+ │ │ └── pipes/
55
+ │ │ └── validation.pipe.ts
56
+ │ ├── database/
57
+ │ │ └── migrations/
58
+ │ └── utils/
59
+ │ ├── logger.ts
60
+ │ └── helpers.ts
61
+ ├── test/
62
+ │ ├── products.e2e-spec.ts
63
+ │ ├── cart.e2e-spec.ts
64
+ │ ├── checkout.e2e-spec.ts
65
+ │ └── jest-e2e.json
66
+ ├── scripts/
67
+ │ ├── seed-db.mjs
68
+ │ └── setup-env.sh
69
+ ├── docker-compose.yml
70
+ ├── Dockerfile
71
+ ├── .env.example
72
+ ├── package.json
73
+ ├── tsconfig.json
74
+ ├── jest.config.js
75
+ └── README.md
76
+ ```
77
+
78
+ ## Fluxo de Requisição
79
+
80
+ ```
81
+ 1. Request entra em main.ts
82
+ 2. NestJS rota para o Controller apropriado
83
+ 3. Validation Pipe valida DTOs
84
+ 4. Controller injeta Service
85
+ 5. Service executa lógica e chama Repository
86
+ 6. Repository interage com PostgreSQL/Redis
87
+ 7. Resposta retorna por Service → Controller
88
+ 8. Exception Filter trata erros
89
+ 9. Response serializada + HTTP status
90
+ ```
91
+
92
+ ## Módulos Detalhados
93
+
94
+ ### Products Module
95
+ **Controllers**: ProductsController
96
+ **Services**: ProductsService, CategoriesService
97
+ **Entities**: Product, Category
98
+ **Endpoints**:
99
+ - `GET /api/products` - Listar com filtro/paginação
100
+ - `GET /api/products/:id` - Detalhes
101
+ - `POST /api/products` - Criar (admin)
102
+ - `PUT /api/products/:id` - Atualizar (admin)
103
+ - `DELETE /api/products/:id` - Deletar (admin)
104
+ - `GET /api/categories` - Listar categorias
105
+
106
+ ### Cart Module
107
+ **Services**: CartService (in-memory + Redis)
108
+ **Endpoints**:
109
+ - `POST /api/cart/add` - Adicionar item
110
+ - `DELETE /api/cart/items/:productId` - Remover item
111
+ - `PUT /api/cart/items/:productId` - Atualizar quantidade
112
+ - `GET /api/cart` - Ver carrinho
113
+ - `POST /api/cart/apply-coupon` - Aplicar cupom
114
+ - `POST /api/cart/validate` - Validar antes de checkout
115
+
116
+ ### Orders Module
117
+ **Controllers**: OrdersController
118
+ **Services**: OrdersService
119
+ **Entities**: Order, OrderItem, OrderStatus (enum)
120
+ **Endpoints**:
121
+ - `GET /api/orders` - Listar pedidos do user
122
+ - `GET /api/orders/:id` - Detalhes do pedido
123
+ - `POST /api/orders` - Criar (from checkout)
124
+ - `PUT /api/orders/:id/status` - Atualizar status (admin)
125
+
126
+ ### Payments Module
127
+ **Services**: PaymentsService (mock Stripe)
128
+ **Endpoints**:
129
+ - `POST /api/payments/process` - Processar pagamento
130
+ - `GET /api/payments/:transactionId` - Detalhes do pagamento
131
+
132
+ ### Inventory Module
133
+ **Services**: InventoryService
134
+ **Entities**: Inventory, StockMovement
135
+ **Endpoints**:
136
+ - `GET /api/inventory` - Stock de todos os produtos
137
+ - `POST /api/inventory/restock` - Reposição (admin)
138
+ - `PUT /api/inventory/:productId` - Atualizar stock (admin)
139
+
140
+ ### Coupons Module
141
+ **Services**: CouponsService
142
+ **Endpoints**:
143
+ - `POST /api/coupons` - Criar cupom (admin)
144
+ - `GET /api/coupons/:code/validate` - Validar cupom
145
+
146
+ ### Reviews Module
147
+ **Services**: ReviewsService
148
+ **Entities**: Review, Rating
149
+ **Endpoints**:
150
+ - `GET /api/products/:productId/reviews` - Listar reviews
151
+ - `POST /api/orders/:orderId/items/:itemId/review` - Criar review
152
+
153
+ ## Tratamento de Exceções
154
+
155
+ ```typescript
156
+ // Exemplo de fluxo
157
+ try {
158
+ const product = await productService.getProduct(id);
159
+ if (!product) throw new NotFoundException(`Product ${id} not found`);
160
+ } catch (error) {
161
+ if (error instanceof NotFoundException) {
162
+ // Exception Filter traduz para 404
163
+ }
164
+ if (error instanceof DatabaseError) {
165
+ // Traduz para 500 + log
166
+ }
167
+ }
168
+ ```
169
+
170
+ ## Injeção de Dependência
171
+
172
+ ```typescript
173
+ // Exemplo
174
+ @Injectable()
175
+ export class ProductService {
176
+ constructor(
177
+ @InjectRepository(Product)
178
+ private readonly productRepo: Repository<Product>,
179
+ private readonly cacheService: CacheService,
180
+ private readonly logger: LoggerService,
181
+ ) {}
182
+ }
183
+ ```
184
+
185
+ ## Validação e DTOs
186
+
187
+ ```typescript
188
+ // create-product.dto.ts
189
+ import { IsString, IsNumber, IsOptional, MinLength, Min } from 'class-validator';
190
+
191
+ export class CreateProductDTO {
192
+ @IsString()
193
+ @MinLength(3)
194
+ name: string;
195
+
196
+ @IsNumber()
197
+ @Min(0.01)
198
+ price: number;
199
+
200
+ @IsOptional()
201
+ @IsString()
202
+ description?: string;
203
+ }
204
+ ```
205
+
206
+ ## Middleware de Logging e Auth
207
+
208
+ ```typescript
209
+ // Middleware loga cada request com UUID
210
+ // Auth middleware valida JWT (mock para MVP)
211
+ // Exemplo:
212
+ GET /api/products?page=1&limit=20
213
+ ├─ Auth: OK (mock user)
214
+ ├─ Query: page=1, limit=20
215
+ └─ Response: 200, 2.5ms
216
+ ```
217
+
218
+ ## Cache Strategy
219
+
220
+ | Recurso | TTL | Estratégia |
221
+ |---------|-----|-----------|
222
+ | Produtos | 30min | Cache-aside com invalidação |
223
+ | Categorias | 1h | Cache completo, manual invalidation |
224
+ | Carrinho do user | 24h | Cache com user ID |
225
+ | Session JWT | 1h | Sem cache (stateless) |
226
+
227
+ ## Transações ACID
228
+
229
+ ```typescript
230
+ // Checkout usa transação para atomicidade
231
+ const queryRunner = dataSource.createQueryRunner();
232
+ await queryRunner.connect();
233
+ await queryRunner.startTransaction();
234
+ try {
235
+ await queryRunner.manager.save(Order);
236
+ await queryRunner.manager.update(Inventory, ...);
237
+ await queryRunner.commitTransaction();
238
+ } catch (error) {
239
+ await queryRunner.rollbackTransaction();
240
+ }
241
+ ```
242
+
243
+ ## Health Check
244
+
245
+ ```
246
+ GET /api/health
247
+ {
248
+ "status": "up",
249
+ "timestamp": "2024-01-15T10:30:00Z",
250
+ "database": "connected",
251
+ "cache": "connected"
252
+ }
253
+ ```
@@ -0,0 +1,319 @@
1
+ # Observabilidade - Arquitetura
2
+
3
+ ## 1. Logging Estruturado
4
+
5
+ ### Log Format (JSON)
6
+
7
+ ```json
8
+ {
9
+ "timestamp": "2024-01-15T10:35:30.123Z",
10
+ "level": "info|warn|error|debug",
11
+ "context": "ProductsController|ProductsService",
12
+ "message": "GET /api/products",
13
+ "method": "GET",
14
+ "path": "/api/products",
15
+ "statusCode": 200,
16
+ "duration": "45ms",
17
+ "userId": "user-uuid",
18
+ "requestId": "trace-id-uuid",
19
+ "query": { "page": 1, "limit": 20 },
20
+ "error": null
21
+ }
22
+ ```
23
+
24
+ ### Níveis de Log
25
+
26
+ - **DEBUG** - Informações para troubleshooting (desabilitado em prod)
27
+ - **INFO** - Operações normais do sistema
28
+ - **WARN** - Situações anormais (cupom inválido, stock baixo)
29
+ - **ERROR** - Erros (pagamento recusado, DB offline)
30
+
31
+ ### Exemplo de Implementação
32
+
33
+ ```typescript
34
+ // logger.service.ts
35
+ @Injectable()
36
+ export class LoggerService {
37
+ log(message: string, context?: string, data?: any) {
38
+ console.log(JSON.stringify({
39
+ timestamp: new Date().toISOString(),
40
+ level: 'info',
41
+ context,
42
+ message,
43
+ ...data,
44
+ }));
45
+ }
46
+
47
+ error(message: string, error?: Error, context?: string) {
48
+ console.error(JSON.stringify({
49
+ timestamp: new Date().toISOString(),
50
+ level: 'error',
51
+ context,
52
+ message,
53
+ errorMessage: error?.message,
54
+ stack: error?.stack,
55
+ }));
56
+ }
57
+ }
58
+ ```
59
+
60
+ ## 2. Health Checks
61
+
62
+ ### Endpoint de Health
63
+
64
+ ```
65
+ GET /api/health
66
+ Response: {
67
+ "status": "up|down",
68
+ "timestamp": "2024-01-15T10:35:30Z",
69
+ "checks": {
70
+ "database": { "status": "connected|disconnected" },
71
+ "redis": { "status": "connected|disconnected" },
72
+ "memory": { "usage": "45%" },
73
+ "uptime": "15h 23m"
74
+ }
75
+ }
76
+ ```
77
+
78
+ ### Verificação Periódica
79
+
80
+ ```bash
81
+ # Health check a cada 30 segundos
82
+ curl -X GET http://localhost:3000/api/health
83
+ ```
84
+
85
+ ### Uso em Produção
86
+
87
+ - Load Balancer: Usa `/api/health` para roteamento
88
+ - Kubernetes: LivenessProbe + ReadinessProbe
89
+ - Alertas: Se status != "up" por 2 min, dispara alerta
90
+
91
+ ## 3. Métricas (Prometheus - Future)
92
+
93
+ ### Métricas Importantes
94
+
95
+ ```
96
+ # Endpoint
97
+ GET /metrics
98
+
99
+ # Exemplos
100
+ ecommerce_http_requests_total{method="GET",endpoint="/api/products",status="200"} 1523
101
+ ecommerce_http_request_duration_seconds{endpoint="/api/products",method="GET"} 0.045
102
+ ecommerce_database_query_duration_seconds{query="SELECT products"} 0.032
103
+ ecommerce_cache_hits_total{cache="products"} 4521
104
+ ecommerce_cache_misses_total{cache="products"} 123
105
+ ecommerce_orders_total{status="completed"} 1024
106
+ ecommerce_orders_total{status="failed"} 12
107
+ ecommerce_payment_processing_duration_seconds 0.234
108
+ ```
109
+
110
+ ### Dashboard Recomendado (Grafana)
111
+
112
+ - Response time p50, p95, p99
113
+ - Taxa de erro (500s)
114
+ - Taxa de sucesso de pagamento
115
+ - Número de pedidos por hora
116
+ - Cache hit/miss ratio
117
+ - DB connections ativas
118
+ - CPU/Memory usage
119
+
120
+ ## 4. Tracing Distribuído (Jaeger - Future)
121
+
122
+ ```typescript
123
+ // Exemplo: Rastreiar fluxo de checkout
124
+ @Traced()
125
+ async checkout(orderId: string) {
126
+ // Cada span = uma operação
127
+ // Trace ID conecta todas as operações
128
+ }
129
+ ```
130
+
131
+ ### Exemplo de Trace
132
+
133
+ ```
134
+ Trace ID: abc123def456
135
+ ├─ Span: PaymentController.process (50ms)
136
+ │ ├─ Span: PaymentService.validate (10ms)
137
+ │ ├─ Span: PaymentService.callStripe (30ms)
138
+ │ └─ Span: PaymentService.savePayment (10ms)
139
+ ├─ Span: OrderService.create (25ms)
140
+ │ ├─ Span: OrderRepository.save (15ms)
141
+ │ └─ Span: InventoryService.reserve (10ms)
142
+ └─ Span: CacheService.invalidate (5ms)
143
+ Total: 80ms
144
+ ```
145
+
146
+ ## 5. Alerts e Notificações
147
+
148
+ ### Cenários de Alerta
149
+
150
+ ```yaml
151
+ Alerta Threshold Ação
152
+ ─────────────────────────────────────────────────────────
153
+ API Down 2 min Escalate + PagerDuty
154
+ High Error Rate > 5% Notify Slack
155
+ Payment Failure Rate > 15% Investigate
156
+ Database Connection Pool Full 95% Scale + Alert
157
+ Cache Miss Rate > 50% Investigate
158
+ Response Time P95 > 500ms Investigate
159
+ Disk Space > 90% Scale Volume
160
+ Memory Usage > 85% Restart if needed
161
+ ```
162
+
163
+ ### Integração de Alertas
164
+
165
+ ```typescript
166
+ // alert.service.ts
167
+ async notifySlack(message: string, severity: 'info'|'warn'|'error') {
168
+ const webhook = process.env.SLACK_WEBHOOK_URL;
169
+ await fetch(webhook, {
170
+ method: 'POST',
171
+ body: JSON.stringify({
172
+ text: message,
173
+ attachments: [
174
+ {
175
+ color: severity === 'error' ? 'danger' : 'warning',
176
+ timestamp: Math.floor(Date.now() / 1000),
177
+ }
178
+ ]
179
+ })
180
+ });
181
+ }
182
+ ```
183
+
184
+ ## 6. Audit Logs
185
+
186
+ ### Operações Críticas a Auditar
187
+
188
+ ```json
189
+ {
190
+ "timestamp": "2024-01-15T10:35:30Z",
191
+ "event": "payment_processed",
192
+ "userId": "user-uuid",
193
+ "orderId": "order-uuid",
194
+ "amount": 1299.99,
195
+ "status": "approved",
196
+ "ipAddress": "192.168.1.1",
197
+ "userAgent": "Mozilla/5.0..."
198
+ }
199
+ ```
200
+
201
+ ### Retenção
202
+
203
+ - Logs de ação: 90 dias
204
+ - Logs de erro: 1 ano
205
+ - Audit logs críticos: 7 anos (compliance)
206
+
207
+ ## 7. Performance Monitoring
208
+
209
+ ### Métricas por Endpoint
210
+
211
+ ```
212
+ GET /api/products
213
+ ├─ Requests: 1523/hora
214
+ ├─ P50: 45ms
215
+ ├─ P95: 120ms
216
+ ├─ P99: 250ms
217
+ ├─ Errors: 2 (0.13%)
218
+ └─ Cache Hit Rate: 87%
219
+
220
+ POST /api/payments/process
221
+ ├─ Requests: 45/hora
222
+ ├─ P50: 234ms
223
+ ├─ P95: 450ms
224
+ ├─ P99: 600ms
225
+ ├─ Errors: 7 (15.6% - normal, 10% taxa recusa)
226
+ └─ Success Rate: 90%
227
+ ```
228
+
229
+ ### SLA Targets
230
+
231
+ | Operação | P50 | P95 | P99 | SLA |
232
+ |----------|-----|-----|-----|-----|
233
+ | GET /products | 45ms | 120ms | 250ms | < 200ms p95 |
234
+ | GET /orders | 80ms | 200ms | 400ms | < 300ms p95 |
235
+ | POST /checkout | 234ms | 450ms | 600ms | < 500ms p95 |
236
+ | POST /payments | 234ms | 500ms | 800ms | < 500ms p95 |
237
+
238
+ ## 8. Centralização de Logs (Recomendado)
239
+
240
+ ### Stack Recomendado (ELK)
241
+
242
+ ```yaml
243
+ Aplicação → Elasticsearch ← Kibana
244
+ ↑ (Dashboard)
245
+ Filebeat/Logstash
246
+ ```
247
+
248
+ ### Alternativas
249
+
250
+ - Datadog
251
+ - New Relic
252
+ - Splunk
253
+ - AWS CloudWatch
254
+
255
+ ### Configuração Básica
256
+
257
+ ```bash
258
+ # Docker compose adicional
259
+ elasticsearch:
260
+ image: docker.elastic.co/elasticsearch/elasticsearch:8.0.0
261
+ environment:
262
+ - discovery.type=single-node
263
+
264
+ kibana:
265
+ image: docker.elastic.co/kibana/kibana:8.0.0
266
+ ports:
267
+ - "5601:5601"
268
+ ```
269
+
270
+ ## 9. Dashboards Recomendados
271
+
272
+ ### Dashboard de Negócio
273
+ - Total de vendas (hoje, esta semana, este mês)
274
+ - Número de pedidos
275
+ - Ticket médio
276
+ - Taxa de conversão
277
+ - Produtos mais vendidos
278
+
279
+ ### Dashboard Técnico
280
+ - Response times (p50, p95, p99)
281
+ - Taxa de erro
282
+ - DB queries lentas
283
+ - Cache hit/miss
284
+ - CPU/Memory/Disk
285
+
286
+ ### Dashboard de Pagamentos
287
+ - Sucesso vs. Falha
288
+ - Quantidade de transações
289
+ - Valor total processado
290
+ - Tempo médio de processamento
291
+ - Top motivos de recusa
292
+
293
+ ## 10. Monitoramento em Desenvolvimento
294
+
295
+ ```bash
296
+ # Ver logs em tempo real
297
+ docker-compose logs -f api
298
+
299
+ # Health check
300
+ watch -n 5 'curl -s http://localhost:3000/api/health | jq'
301
+
302
+ # Performance (top services)
303
+ npm run test:cov
304
+ ```
305
+
306
+ ## Checklist de Observabilidade para Produção
307
+
308
+ - [ ] Logs centralizados (ELK/Datadog/etc)
309
+ - [ ] Health checks a cada 30s
310
+ - [ ] Metrics exportadas (Prometheus)
311
+ - [ ] Alertas configurados
312
+ - [ ] Dashboards implementados (Grafana)
313
+ - [ ] Tracing distribuído (Jaeger)
314
+ - [ ] Audit logs retidos 7 anos
315
+ - [ ] SLAs monitorados
316
+ - [ ] Alertas no Slack/PagerDuty
317
+ - [ ] Retention policies definidas
318
+ - [ ] Backup de logs automático
319
+ - [ ] On-call rotation configurada