forjajs 2.0.4 → 3.0.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 (798) 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 +50 -50
  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 +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -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/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
@@ -1,609 +1,609 @@
1
- # 📚 API Examples - Microservices Starter
2
-
3
- Este arquivo contém exemplos práticos de como usar cada endpoint da plataforma.
4
-
5
- ## 🔐 Authentication Service
6
-
7
- ### 1. Register (Criar nova conta)
8
-
9
- ```bash
10
- curl -X POST http://localhost:3000/auth/register \
11
- -H "Content-Type: application/json" \
12
- -d '{
13
- "email": "newuser@example.com",
14
- "password": "SecurePass123!",
15
- "name": "New User"
16
- }'
17
- ```
18
-
19
- **Response (201):**
20
- ```json
21
- {
22
- "data": {
23
- "userId": "user-id-from-token",
24
- "email": "newuser@example.com",
25
- "tokens": {
26
- "accessToken": "eyJhbGc...",
27
- "refreshToken": "eyJhbGc...",
28
- "expiresIn": 900
29
- }
30
- },
31
- "meta": {
32
- "requestId": "req-123",
33
- "timestamp": "2024-01-15T10:30:00Z",
34
- "processingTime": 145
35
- }
36
- }
37
- ```
38
-
39
- ---
40
-
41
- ### 2. Login (Fazer login)
42
-
43
- ```bash
44
- curl -X POST http://localhost:3000/auth/login \
45
- -H "Content-Type: application/json" \
46
- -d '{
47
- "email": "test@example.com",
48
- "password": "TestPassword123!"
49
- }'
50
- ```
51
-
52
- **Response (200):**
53
- ```json
54
- {
55
- "data": {
56
- "userId": "550e8400-e29b-41d4-a716-446655440000",
57
- "tokens": {
58
- "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
59
- "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
60
- "expiresIn": 900
61
- }
62
- },
63
- "meta": {
64
- "requestId": "req-124",
65
- "timestamp": "2024-01-15T10:31:00Z",
66
- "processingTime": 89
67
- }
68
- }
69
- ```
70
-
71
- **Test Credentials:**
72
- - Email: `test@example.com`
73
- - Password: `TestPassword123!`
74
-
75
- ---
76
-
77
- ### 3. Refresh Token (Renovar token de acesso)
78
-
79
- ```bash
80
- curl -X POST http://localhost:3000/auth/refresh \
81
- -H "Authorization: Bearer <refreshToken>" \
82
- -H "Content-Type: application/json" \
83
- -d '{}'
84
- ```
85
-
86
- **Response (200):**
87
- ```json
88
- {
89
- "data": {
90
- "accessToken": "eyJhbGc...",
91
- "refreshToken": "eyJhbGc...",
92
- "expiresIn": 900
93
- },
94
- "meta": {
95
- "requestId": "req-125",
96
- "timestamp": "2024-01-15T10:32:00Z",
97
- "processingTime": 45
98
- }
99
- }
100
- ```
101
-
102
- ---
103
-
104
- ### 4. Verify Token (Validar token)
105
-
106
- ```bash
107
- curl -X GET http://localhost:3000/auth/verify \
108
- -H "Authorization: Bearer <accessToken>"
109
- ```
110
-
111
- **Response (200):**
112
- ```json
113
- {
114
- "data": {
115
- "valid": true,
116
- "message": "Token is valid"
117
- },
118
- "meta": {
119
- "requestId": "req-126",
120
- "timestamp": "2024-01-15T10:33:00Z",
121
- "processingTime": 12
122
- }
123
- }
124
- ```
125
-
126
- ---
127
-
128
- ### 5. Logout (Fazer logout)
129
-
130
- ```bash
131
- curl -X POST http://localhost:3000/auth/logout \
132
- -H "Authorization: Bearer <accessToken>" \
133
- -H "Content-Type: application/json" \
134
- -d '{
135
- "refreshToken": "<refreshToken>"
136
- }'
137
- ```
138
-
139
- **Response (200):**
140
- ```json
141
- {
142
- "data": {
143
- "message": "Successfully logged out"
144
- },
145
- "meta": {
146
- "requestId": "req-127",
147
- "timestamp": "2024-01-15T10:34:00Z",
148
- "processingTime": 35
149
- }
150
- }
151
- ```
152
-
153
- ---
154
-
155
- ## 👤 User Service
156
-
157
- ### 1. Create User Profile (Criar perfil de usuário)
158
-
159
- ```bash
160
- curl -X POST http://localhost:3000/users \
161
- -H "Authorization: Bearer <accessToken>" \
162
- -H "Content-Type: application/json" \
163
- -d '{
164
- "email": "user@example.com",
165
- "fullName": "John Doe",
166
- "avatar": "https://cdn.example.com/avatars/john.jpg"
167
- }'
168
- ```
169
-
170
- **Response (201):**
171
- ```json
172
- {
173
- "data": {
174
- "userId": "550e8400-e29b-41d4-a716-446655440000",
175
- "email": "user@example.com",
176
- "fullName": "John Doe",
177
- "emailVerified": false,
178
- "createdAt": "2024-01-15T10:36:00Z"
179
- },
180
- "meta": {
181
- "requestId": "req-202",
182
- "timestamp": "2024-01-15T10:36:00Z",
183
- "processingTime": 156
184
- }
185
- }
186
- ```
187
-
188
- ---
189
-
190
- ### 2. Get User Profile (Obter perfil de usuário)
191
-
192
- ```bash
193
- curl -X GET http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
194
- -H "Authorization: Bearer <accessToken>"
195
- ```
196
-
197
- **Response (200):**
198
- ```json
199
- {
200
- "data": {
201
- "userId": "550e8400-e29b-41d4-a716-446655440000",
202
- "email": "user@example.com",
203
- "fullName": "John Doe",
204
- "avatar": "https://cdn.example.com/avatars/john.jpg",
205
- "bio": "Software engineer and coffee enthusiast",
206
- "emailVerified": true,
207
- "emailVerifiedAt": "2024-01-10T12:00:00Z",
208
- "createdAt": "2024-01-15T10:30:00Z",
209
- "updatedAt": "2024-01-15T10:30:00Z",
210
- "settings": {
211
- "theme": "dark",
212
- "notificationsEnabled": true,
213
- "language": "en",
214
- "timeZone": "America/Sao_Paulo"
215
- }
216
- },
217
- "meta": {
218
- "requestId": "req-201",
219
- "timestamp": "2024-01-15T10:35:00Z",
220
- "processingTime": 45
221
- }
222
- }
223
- ```
224
-
225
- ---
226
-
227
- ### 3. Update User Profile (Atualizar perfil)
228
-
229
- ```bash
230
- curl -X PATCH http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
231
- -H "Authorization: Bearer <accessToken>" \
232
- -H "Content-Type: application/json" \
233
- -d '{
234
- "fullName": "John Smith",
235
- "bio": "Updated bio",
236
- "avatar": "https://cdn.example.com/avatars/new-john.jpg"
237
- }'
238
- ```
239
-
240
- **Response (200):**
241
- ```json
242
- {
243
- "data": {
244
- "userId": "550e8400-e29b-41d4-a716-446655440000",
245
- "email": "user@example.com",
246
- "fullName": "John Smith",
247
- "bio": "Updated bio",
248
- "avatar": "https://cdn.example.com/avatars/new-john.jpg",
249
- "updatedAt": "2024-01-15T10:37:00Z"
250
- },
251
- "meta": {
252
- "requestId": "req-203",
253
- "timestamp": "2024-01-15T10:37:00Z",
254
- "processingTime": 89
255
- }
256
- }
257
- ```
258
-
259
- ---
260
-
261
- ### 4. Update User Settings (Atualizar configurações)
262
-
263
- ```bash
264
- curl -X PATCH http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/settings \
265
- -H "Authorization: Bearer <accessToken>" \
266
- -H "Content-Type: application/json" \
267
- -d '{
268
- "theme": "light",
269
- "notificationsEnabled": false,
270
- "language": "pt",
271
- "timeZone": "America/Sao_Paulo"
272
- }'
273
- ```
274
-
275
- **Response (200):**
276
- ```json
277
- {
278
- "data": {
279
- "settings": {
280
- "theme": "light",
281
- "notificationsEnabled": false,
282
- "language": "pt",
283
- "timeZone": "America/Sao_Paulo"
284
- }
285
- },
286
- "meta": {
287
- "requestId": "req-204",
288
- "timestamp": "2024-01-15T10:38:00Z",
289
- "processingTime": 67
290
- }
291
- }
292
- ```
293
-
294
- ---
295
-
296
- ### 5. Request Email Verification (Solicitar verificação de email)
297
-
298
- ```bash
299
- curl -X POST http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/verify-email \
300
- -H "Authorization: Bearer <accessToken>" \
301
- -H "Content-Type: application/json" \
302
- -d '{}'
303
- ```
304
-
305
- **Response (200):**
306
- ```json
307
- {
308
- "data": {
309
- "message": "Verification code sent to user@example.com"
310
- },
311
- "meta": {
312
- "requestId": "req-205",
313
- "timestamp": "2024-01-15T10:39:00Z",
314
- "processingTime": 234
315
- }
316
- }
317
- ```
318
-
319
- ---
320
-
321
- ### 6. Confirm Email Verification (Confirmar verificação)
322
-
323
- ```bash
324
- curl -X POST http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/confirm-email \
325
- -H "Authorization: Bearer <accessToken>" \
326
- -H "Content-Type: application/json" \
327
- -d '{
328
- "code": "123456"
329
- }'
330
- ```
331
-
332
- **Response (200):**
333
- ```json
334
- {
335
- "data": {
336
- "emailVerified": true,
337
- "emailVerifiedAt": "2024-01-15T10:40:00Z"
338
- },
339
- "meta": {
340
- "requestId": "req-206",
341
- "timestamp": "2024-01-15T10:40:00Z",
342
- "processingTime": 78
343
- }
344
- }
345
- ```
346
-
347
- ---
348
-
349
- ### 7. Delete User Account (Deletar conta)
350
-
351
- ```bash
352
- curl -X DELETE http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
353
- -H "Authorization: Bearer <accessToken>"
354
- ```
355
-
356
- **Response (204 No Content)**
357
-
358
- ---
359
-
360
- ### 8. List Users (Listar usuários)
361
-
362
- ```bash
363
- curl -X GET "http://localhost:3000/users?limit=10&offset=0" \
364
- -H "Authorization: Bearer <accessToken>"
365
- ```
366
-
367
- **Response (200):**
368
- ```json
369
- {
370
- "data": {
371
- "data": [
372
- {
373
- "userId": "550e8400-e29b-41d4-a716-446655440000",
374
- "email": "john@example.com",
375
- "fullName": "John Doe",
376
- "avatar": "https://cdn.example.com/avatars/550e8400.jpg"
377
- }
378
- ],
379
- "pagination": {
380
- "limit": 10,
381
- "offset": 0,
382
- "total": 42
383
- }
384
- },
385
- "meta": {
386
- "requestId": "req-207",
387
- "timestamp": "2024-01-15T10:41:00Z",
388
- "processingTime": 145
389
- }
390
- }
391
- ```
392
-
393
- ---
394
-
395
- ## 📧 Notification Service
396
-
397
- ### 1. Send Email (Enviar email)
398
-
399
- ```bash
400
- curl -X POST http://localhost:3000/notifications/email \
401
- -H "Content-Type: application/json" \
402
- -d '{
403
- "userId": "550e8400-e29b-41d4-a716-446655440000",
404
- "recipient": "user@example.com",
405
- "subject": "Welcome to our platform!",
406
- "body": "Thanks for signing up...",
407
- "template": "welcome_email",
408
- "templateVars": {
409
- "name": "John",
410
- "activationLink": "https://example.com/activate/123"
411
- }
412
- }'
413
- ```
414
-
415
- **Response (202 Accepted):**
416
- ```json
417
- {
418
- "data": {
419
- "notificationId": "notif-550e8400",
420
- "status": "pending",
421
- "createdAt": "2024-01-15T10:45:00Z"
422
- },
423
- "meta": {
424
- "requestId": "req-301",
425
- "timestamp": "2024-01-15T10:45:00Z",
426
- "processingTime": 45
427
- }
428
- }
429
- ```
430
-
431
- ---
432
-
433
- ### 2. Send Push Notification (Enviar notificação push)
434
-
435
- ```bash
436
- curl -X POST http://localhost:3000/notifications/push \
437
- -H "Content-Type: application/json" \
438
- -d '{
439
- "userId": "550e8400-e29b-41d4-a716-446655440000",
440
- "title": "New message",
441
- "body": "You have a new message from John",
442
- "data": {
443
- "action": "open_messages",
444
- "sender_id": "user-123"
445
- }
446
- }'
447
- ```
448
-
449
- **Response (202 Accepted):**
450
- ```json
451
- {
452
- "data": {
453
- "notificationId": "notif-550e8401",
454
- "status": "pending"
455
- },
456
- "meta": {
457
- "requestId": "req-302",
458
- "timestamp": "2024-01-15T10:46:00Z",
459
- "processingTime": 23
460
- }
461
- }
462
- ```
463
-
464
- ---
465
-
466
- ### 3. Get Notification Status (Obter status da notificação)
467
-
468
- ```bash
469
- curl -X GET http://localhost:3000/notifications/notif-550e8400 \
470
- -H "Authorization: Bearer <accessToken>"
471
- ```
472
-
473
- **Response (200):**
474
- ```json
475
- {
476
- "data": {
477
- "notificationId": "notif-550e8400",
478
- "userId": "550e8400-e29b-41d4-a716-446655440000",
479
- "type": "email",
480
- "status": "sent",
481
- "recipient": "user@example.com",
482
- "subject": "Welcome to our platform!",
483
- "createdAt": "2024-01-15T10:45:00Z",
484
- "sentAt": "2024-01-15T10:45:05Z",
485
- "retries": 0
486
- },
487
- "meta": {
488
- "requestId": "req-303",
489
- "timestamp": "2024-01-15T10:47:00Z",
490
- "processingTime": 12
491
- }
492
- }
493
- ```
494
-
495
- ---
496
-
497
- ### 4. List Notifications (Listar notificações)
498
-
499
- ```bash
500
- curl -X GET "http://localhost:3000/notifications?userId=550e8400-e29b-41d4-a716-446655440000&limit=20&offset=0" \
501
- -H "Authorization: Bearer <accessToken>"
502
- ```
503
-
504
- **Response (200):**
505
- ```json
506
- {
507
- "data": {
508
- "data": [
509
- {
510
- "notificationId": "notif-550e8400",
511
- "type": "email",
512
- "status": "sent",
513
- "recipient": "user@example.com",
514
- "subject": "Welcome",
515
- "createdAt": "2024-01-15T10:45:00Z",
516
- "sentAt": "2024-01-15T10:45:05Z"
517
- }
518
- ],
519
- "pagination": {
520
- "limit": 20,
521
- "offset": 0,
522
- "total": 145
523
- }
524
- },
525
- "meta": {
526
- "requestId": "req-304",
527
- "timestamp": "2024-01-15T10:48:00Z",
528
- "processingTime": 87
529
- }
530
- }
531
- ```
532
-
533
- ---
534
-
535
- ### 5. Get Email Templates (Obter templates de email)
536
-
537
- ```bash
538
- curl -X GET http://localhost:3000/notifications/templates
539
- ```
540
-
541
- **Response (200):**
542
- ```json
543
- {
544
- "data": [
545
- {
546
- "templateId": "tpl-001",
547
- "name": "welcome_email",
548
- "type": "email",
549
- "subject": "Welcome {{name}}!",
550
- "body": "Thanks for signing up, {{name}}!"
551
- },
552
- {
553
- "templateId": "tpl-002",
554
- "name": "password_reset",
555
- "type": "email",
556
- "subject": "Reset your password",
557
- "body": "Click here to reset: {{resetLink}}"
558
- },
559
- {
560
- "templateId": "tpl-003",
561
- "name": "email_verification",
562
- "type": "email",
563
- "subject": "Verify your email",
564
- "body": "Your verification code is: {{code}}"
565
- }
566
- ],
567
- "meta": {
568
- "requestId": "req-305",
569
- "timestamp": "2024-01-15T10:49:00Z",
570
- "processingTime": 34
571
- }
572
- }
573
- ```
574
-
575
- ---
576
-
577
- ## 🏥 Health Checks
578
-
579
- ### API Gateway Health
580
-
581
- ```bash
582
- curl -X GET http://localhost:3000/gateway/health
583
- ```
584
-
585
- ---
586
-
587
- ### Service Health Checks
588
-
589
- ```bash
590
- # Auth Service
591
- curl -X GET http://localhost:3001/health
592
-
593
- # User Service
594
- curl -X GET http://localhost:3002/health
595
-
596
- # Notification Service
597
- curl -X GET http://localhost:3003/health
598
- ```
599
-
600
- ---
601
-
602
- ## 📝 Notes
603
-
604
- - Replace `<accessToken>` and `<refreshToken>` with actual tokens from login
605
- - All endpoints accept `X-Request-Id` header (auto-generated if missing)
606
- - Request IDs can be used for tracing in logs
607
- - Use test credentials for initial testing
608
- - Timestamps are in ISO8601 format (UTC)
609
- - Processing times in milliseconds
1
+ # 📚 API Examples - Microservices Starter
2
+
3
+ Este arquivo contém exemplos práticos de como usar cada endpoint da plataforma.
4
+
5
+ ## 🔐 Authentication Service
6
+
7
+ ### 1. Register (Criar nova conta)
8
+
9
+ ```bash
10
+ curl -X POST http://localhost:3000/auth/register \
11
+ -H "Content-Type: application/json" \
12
+ -d '{
13
+ "email": "newuser@example.com",
14
+ "password": "SecurePass123!",
15
+ "name": "New User"
16
+ }'
17
+ ```
18
+
19
+ **Response (201):**
20
+ ```json
21
+ {
22
+ "data": {
23
+ "userId": "user-id-from-token",
24
+ "email": "newuser@example.com",
25
+ "tokens": {
26
+ "accessToken": "eyJhbGc...",
27
+ "refreshToken": "eyJhbGc...",
28
+ "expiresIn": 900
29
+ }
30
+ },
31
+ "meta": {
32
+ "requestId": "req-123",
33
+ "timestamp": "2024-01-15T10:30:00Z",
34
+ "processingTime": 145
35
+ }
36
+ }
37
+ ```
38
+
39
+ ---
40
+
41
+ ### 2. Login (Fazer login)
42
+
43
+ ```bash
44
+ curl -X POST http://localhost:3000/auth/login \
45
+ -H "Content-Type: application/json" \
46
+ -d '{
47
+ "email": "test@example.com",
48
+ "password": "TestPassword123!"
49
+ }'
50
+ ```
51
+
52
+ **Response (200):**
53
+ ```json
54
+ {
55
+ "data": {
56
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
57
+ "tokens": {
58
+ "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
59
+ "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
60
+ "expiresIn": 900
61
+ }
62
+ },
63
+ "meta": {
64
+ "requestId": "req-124",
65
+ "timestamp": "2024-01-15T10:31:00Z",
66
+ "processingTime": 89
67
+ }
68
+ }
69
+ ```
70
+
71
+ **Test Credentials:**
72
+ - Email: `test@example.com`
73
+ - Password: `TestPassword123!`
74
+
75
+ ---
76
+
77
+ ### 3. Refresh Token (Renovar token de acesso)
78
+
79
+ ```bash
80
+ curl -X POST http://localhost:3000/auth/refresh \
81
+ -H "Authorization: Bearer <refreshToken>" \
82
+ -H "Content-Type: application/json" \
83
+ -d '{}'
84
+ ```
85
+
86
+ **Response (200):**
87
+ ```json
88
+ {
89
+ "data": {
90
+ "accessToken": "eyJhbGc...",
91
+ "refreshToken": "eyJhbGc...",
92
+ "expiresIn": 900
93
+ },
94
+ "meta": {
95
+ "requestId": "req-125",
96
+ "timestamp": "2024-01-15T10:32:00Z",
97
+ "processingTime": 45
98
+ }
99
+ }
100
+ ```
101
+
102
+ ---
103
+
104
+ ### 4. Verify Token (Validar token)
105
+
106
+ ```bash
107
+ curl -X GET http://localhost:3000/auth/verify \
108
+ -H "Authorization: Bearer <accessToken>"
109
+ ```
110
+
111
+ **Response (200):**
112
+ ```json
113
+ {
114
+ "data": {
115
+ "valid": true,
116
+ "message": "Token is valid"
117
+ },
118
+ "meta": {
119
+ "requestId": "req-126",
120
+ "timestamp": "2024-01-15T10:33:00Z",
121
+ "processingTime": 12
122
+ }
123
+ }
124
+ ```
125
+
126
+ ---
127
+
128
+ ### 5. Logout (Fazer logout)
129
+
130
+ ```bash
131
+ curl -X POST http://localhost:3000/auth/logout \
132
+ -H "Authorization: Bearer <accessToken>" \
133
+ -H "Content-Type: application/json" \
134
+ -d '{
135
+ "refreshToken": "<refreshToken>"
136
+ }'
137
+ ```
138
+
139
+ **Response (200):**
140
+ ```json
141
+ {
142
+ "data": {
143
+ "message": "Successfully logged out"
144
+ },
145
+ "meta": {
146
+ "requestId": "req-127",
147
+ "timestamp": "2024-01-15T10:34:00Z",
148
+ "processingTime": 35
149
+ }
150
+ }
151
+ ```
152
+
153
+ ---
154
+
155
+ ## 👤 User Service
156
+
157
+ ### 1. Create User Profile (Criar perfil de usuário)
158
+
159
+ ```bash
160
+ curl -X POST http://localhost:3000/users \
161
+ -H "Authorization: Bearer <accessToken>" \
162
+ -H "Content-Type: application/json" \
163
+ -d '{
164
+ "email": "user@example.com",
165
+ "fullName": "John Doe",
166
+ "avatar": "https://cdn.example.com/avatars/john.jpg"
167
+ }'
168
+ ```
169
+
170
+ **Response (201):**
171
+ ```json
172
+ {
173
+ "data": {
174
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
175
+ "email": "user@example.com",
176
+ "fullName": "John Doe",
177
+ "emailVerified": false,
178
+ "createdAt": "2024-01-15T10:36:00Z"
179
+ },
180
+ "meta": {
181
+ "requestId": "req-202",
182
+ "timestamp": "2024-01-15T10:36:00Z",
183
+ "processingTime": 156
184
+ }
185
+ }
186
+ ```
187
+
188
+ ---
189
+
190
+ ### 2. Get User Profile (Obter perfil de usuário)
191
+
192
+ ```bash
193
+ curl -X GET http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
194
+ -H "Authorization: Bearer <accessToken>"
195
+ ```
196
+
197
+ **Response (200):**
198
+ ```json
199
+ {
200
+ "data": {
201
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
202
+ "email": "user@example.com",
203
+ "fullName": "John Doe",
204
+ "avatar": "https://cdn.example.com/avatars/john.jpg",
205
+ "bio": "Software engineer and coffee enthusiast",
206
+ "emailVerified": true,
207
+ "emailVerifiedAt": "2024-01-10T12:00:00Z",
208
+ "createdAt": "2024-01-15T10:30:00Z",
209
+ "updatedAt": "2024-01-15T10:30:00Z",
210
+ "settings": {
211
+ "theme": "dark",
212
+ "notificationsEnabled": true,
213
+ "language": "en",
214
+ "timeZone": "America/Sao_Paulo"
215
+ }
216
+ },
217
+ "meta": {
218
+ "requestId": "req-201",
219
+ "timestamp": "2024-01-15T10:35:00Z",
220
+ "processingTime": 45
221
+ }
222
+ }
223
+ ```
224
+
225
+ ---
226
+
227
+ ### 3. Update User Profile (Atualizar perfil)
228
+
229
+ ```bash
230
+ curl -X PATCH http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
231
+ -H "Authorization: Bearer <accessToken>" \
232
+ -H "Content-Type: application/json" \
233
+ -d '{
234
+ "fullName": "John Smith",
235
+ "bio": "Updated bio",
236
+ "avatar": "https://cdn.example.com/avatars/new-john.jpg"
237
+ }'
238
+ ```
239
+
240
+ **Response (200):**
241
+ ```json
242
+ {
243
+ "data": {
244
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
245
+ "email": "user@example.com",
246
+ "fullName": "John Smith",
247
+ "bio": "Updated bio",
248
+ "avatar": "https://cdn.example.com/avatars/new-john.jpg",
249
+ "updatedAt": "2024-01-15T10:37:00Z"
250
+ },
251
+ "meta": {
252
+ "requestId": "req-203",
253
+ "timestamp": "2024-01-15T10:37:00Z",
254
+ "processingTime": 89
255
+ }
256
+ }
257
+ ```
258
+
259
+ ---
260
+
261
+ ### 4. Update User Settings (Atualizar configurações)
262
+
263
+ ```bash
264
+ curl -X PATCH http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/settings \
265
+ -H "Authorization: Bearer <accessToken>" \
266
+ -H "Content-Type: application/json" \
267
+ -d '{
268
+ "theme": "light",
269
+ "notificationsEnabled": false,
270
+ "language": "pt",
271
+ "timeZone": "America/Sao_Paulo"
272
+ }'
273
+ ```
274
+
275
+ **Response (200):**
276
+ ```json
277
+ {
278
+ "data": {
279
+ "settings": {
280
+ "theme": "light",
281
+ "notificationsEnabled": false,
282
+ "language": "pt",
283
+ "timeZone": "America/Sao_Paulo"
284
+ }
285
+ },
286
+ "meta": {
287
+ "requestId": "req-204",
288
+ "timestamp": "2024-01-15T10:38:00Z",
289
+ "processingTime": 67
290
+ }
291
+ }
292
+ ```
293
+
294
+ ---
295
+
296
+ ### 5. Request Email Verification (Solicitar verificação de email)
297
+
298
+ ```bash
299
+ curl -X POST http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/verify-email \
300
+ -H "Authorization: Bearer <accessToken>" \
301
+ -H "Content-Type: application/json" \
302
+ -d '{}'
303
+ ```
304
+
305
+ **Response (200):**
306
+ ```json
307
+ {
308
+ "data": {
309
+ "message": "Verification code sent to user@example.com"
310
+ },
311
+ "meta": {
312
+ "requestId": "req-205",
313
+ "timestamp": "2024-01-15T10:39:00Z",
314
+ "processingTime": 234
315
+ }
316
+ }
317
+ ```
318
+
319
+ ---
320
+
321
+ ### 6. Confirm Email Verification (Confirmar verificação)
322
+
323
+ ```bash
324
+ curl -X POST http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000/confirm-email \
325
+ -H "Authorization: Bearer <accessToken>" \
326
+ -H "Content-Type: application/json" \
327
+ -d '{
328
+ "code": "123456"
329
+ }'
330
+ ```
331
+
332
+ **Response (200):**
333
+ ```json
334
+ {
335
+ "data": {
336
+ "emailVerified": true,
337
+ "emailVerifiedAt": "2024-01-15T10:40:00Z"
338
+ },
339
+ "meta": {
340
+ "requestId": "req-206",
341
+ "timestamp": "2024-01-15T10:40:00Z",
342
+ "processingTime": 78
343
+ }
344
+ }
345
+ ```
346
+
347
+ ---
348
+
349
+ ### 7. Delete User Account (Deletar conta)
350
+
351
+ ```bash
352
+ curl -X DELETE http://localhost:3000/users/550e8400-e29b-41d4-a716-446655440000 \
353
+ -H "Authorization: Bearer <accessToken>"
354
+ ```
355
+
356
+ **Response (204 No Content)**
357
+
358
+ ---
359
+
360
+ ### 8. List Users (Listar usuários)
361
+
362
+ ```bash
363
+ curl -X GET "http://localhost:3000/users?limit=10&offset=0" \
364
+ -H "Authorization: Bearer <accessToken>"
365
+ ```
366
+
367
+ **Response (200):**
368
+ ```json
369
+ {
370
+ "data": {
371
+ "data": [
372
+ {
373
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
374
+ "email": "john@example.com",
375
+ "fullName": "John Doe",
376
+ "avatar": "https://cdn.example.com/avatars/550e8400.jpg"
377
+ }
378
+ ],
379
+ "pagination": {
380
+ "limit": 10,
381
+ "offset": 0,
382
+ "total": 42
383
+ }
384
+ },
385
+ "meta": {
386
+ "requestId": "req-207",
387
+ "timestamp": "2024-01-15T10:41:00Z",
388
+ "processingTime": 145
389
+ }
390
+ }
391
+ ```
392
+
393
+ ---
394
+
395
+ ## 📧 Notification Service
396
+
397
+ ### 1. Send Email (Enviar email)
398
+
399
+ ```bash
400
+ curl -X POST http://localhost:3000/notifications/email \
401
+ -H "Content-Type: application/json" \
402
+ -d '{
403
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
404
+ "recipient": "user@example.com",
405
+ "subject": "Welcome to our platform!",
406
+ "body": "Thanks for signing up...",
407
+ "template": "welcome_email",
408
+ "templateVars": {
409
+ "name": "John",
410
+ "activationLink": "https://example.com/activate/123"
411
+ }
412
+ }'
413
+ ```
414
+
415
+ **Response (202 Accepted):**
416
+ ```json
417
+ {
418
+ "data": {
419
+ "notificationId": "notif-550e8400",
420
+ "status": "pending",
421
+ "createdAt": "2024-01-15T10:45:00Z"
422
+ },
423
+ "meta": {
424
+ "requestId": "req-301",
425
+ "timestamp": "2024-01-15T10:45:00Z",
426
+ "processingTime": 45
427
+ }
428
+ }
429
+ ```
430
+
431
+ ---
432
+
433
+ ### 2. Send Push Notification (Enviar notificação push)
434
+
435
+ ```bash
436
+ curl -X POST http://localhost:3000/notifications/push \
437
+ -H "Content-Type: application/json" \
438
+ -d '{
439
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
440
+ "title": "New message",
441
+ "body": "You have a new message from John",
442
+ "data": {
443
+ "action": "open_messages",
444
+ "sender_id": "user-123"
445
+ }
446
+ }'
447
+ ```
448
+
449
+ **Response (202 Accepted):**
450
+ ```json
451
+ {
452
+ "data": {
453
+ "notificationId": "notif-550e8401",
454
+ "status": "pending"
455
+ },
456
+ "meta": {
457
+ "requestId": "req-302",
458
+ "timestamp": "2024-01-15T10:46:00Z",
459
+ "processingTime": 23
460
+ }
461
+ }
462
+ ```
463
+
464
+ ---
465
+
466
+ ### 3. Get Notification Status (Obter status da notificação)
467
+
468
+ ```bash
469
+ curl -X GET http://localhost:3000/notifications/notif-550e8400 \
470
+ -H "Authorization: Bearer <accessToken>"
471
+ ```
472
+
473
+ **Response (200):**
474
+ ```json
475
+ {
476
+ "data": {
477
+ "notificationId": "notif-550e8400",
478
+ "userId": "550e8400-e29b-41d4-a716-446655440000",
479
+ "type": "email",
480
+ "status": "sent",
481
+ "recipient": "user@example.com",
482
+ "subject": "Welcome to our platform!",
483
+ "createdAt": "2024-01-15T10:45:00Z",
484
+ "sentAt": "2024-01-15T10:45:05Z",
485
+ "retries": 0
486
+ },
487
+ "meta": {
488
+ "requestId": "req-303",
489
+ "timestamp": "2024-01-15T10:47:00Z",
490
+ "processingTime": 12
491
+ }
492
+ }
493
+ ```
494
+
495
+ ---
496
+
497
+ ### 4. List Notifications (Listar notificações)
498
+
499
+ ```bash
500
+ curl -X GET "http://localhost:3000/notifications?userId=550e8400-e29b-41d4-a716-446655440000&limit=20&offset=0" \
501
+ -H "Authorization: Bearer <accessToken>"
502
+ ```
503
+
504
+ **Response (200):**
505
+ ```json
506
+ {
507
+ "data": {
508
+ "data": [
509
+ {
510
+ "notificationId": "notif-550e8400",
511
+ "type": "email",
512
+ "status": "sent",
513
+ "recipient": "user@example.com",
514
+ "subject": "Welcome",
515
+ "createdAt": "2024-01-15T10:45:00Z",
516
+ "sentAt": "2024-01-15T10:45:05Z"
517
+ }
518
+ ],
519
+ "pagination": {
520
+ "limit": 20,
521
+ "offset": 0,
522
+ "total": 145
523
+ }
524
+ },
525
+ "meta": {
526
+ "requestId": "req-304",
527
+ "timestamp": "2024-01-15T10:48:00Z",
528
+ "processingTime": 87
529
+ }
530
+ }
531
+ ```
532
+
533
+ ---
534
+
535
+ ### 5. Get Email Templates (Obter templates de email)
536
+
537
+ ```bash
538
+ curl -X GET http://localhost:3000/notifications/templates
539
+ ```
540
+
541
+ **Response (200):**
542
+ ```json
543
+ {
544
+ "data": [
545
+ {
546
+ "templateId": "tpl-001",
547
+ "name": "welcome_email",
548
+ "type": "email",
549
+ "subject": "Welcome {{name}}!",
550
+ "body": "Thanks for signing up, {{name}}!"
551
+ },
552
+ {
553
+ "templateId": "tpl-002",
554
+ "name": "password_reset",
555
+ "type": "email",
556
+ "subject": "Reset your password",
557
+ "body": "Click here to reset: {{resetLink}}"
558
+ },
559
+ {
560
+ "templateId": "tpl-003",
561
+ "name": "email_verification",
562
+ "type": "email",
563
+ "subject": "Verify your email",
564
+ "body": "Your verification code is: {{code}}"
565
+ }
566
+ ],
567
+ "meta": {
568
+ "requestId": "req-305",
569
+ "timestamp": "2024-01-15T10:49:00Z",
570
+ "processingTime": 34
571
+ }
572
+ }
573
+ ```
574
+
575
+ ---
576
+
577
+ ## 🏥 Health Checks
578
+
579
+ ### API Gateway Health
580
+
581
+ ```bash
582
+ curl -X GET http://localhost:3000/gateway/health
583
+ ```
584
+
585
+ ---
586
+
587
+ ### Service Health Checks
588
+
589
+ ```bash
590
+ # Auth Service
591
+ curl -X GET http://localhost:3001/health
592
+
593
+ # User Service
594
+ curl -X GET http://localhost:3002/health
595
+
596
+ # Notification Service
597
+ curl -X GET http://localhost:3003/health
598
+ ```
599
+
600
+ ---
601
+
602
+ ## 📝 Notes
603
+
604
+ - Replace `<accessToken>` and `<refreshToken>` with actual tokens from login
605
+ - All endpoints accept `X-Request-Id` header (auto-generated if missing)
606
+ - Request IDs can be used for tracing in logs
607
+ - Use test credentials for initial testing
608
+ - Timestamps are in ISO8601 format (UTC)
609
+ - Processing times in milliseconds