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,262 @@
1
+ # Billing API Specification
2
+
3
+ ## Endpoints
4
+
5
+ ### 1. Process Payment
6
+
7
+ **POST** `/api/billing/charge`
8
+
9
+ Headers: `Authorization: Bearer {token}`, Content-Type: `application/json`
10
+
11
+ ```json
12
+ {
13
+ "amount": 99.00,
14
+ "currency": "usd",
15
+ "description": "Pro Plan Upgrade",
16
+ "paymentMethodId": "pm_1234567890"
17
+ }
18
+ ```
19
+
20
+ **Response 200**:
21
+ ```json
22
+ {
23
+ "data": {
24
+ "paymentIntentId": "pi_1234567890",
25
+ "status": "succeeded",
26
+ "amount": 99.00,
27
+ "currency": "usd",
28
+ "invoiceId": "inv_xyz",
29
+ "invoiceNumber": "INV-2024-001",
30
+ "receipt": "https://..."
31
+ }
32
+ }
33
+ ```
34
+
35
+ **Error 402**: Payment failed
36
+ **Error 400**: Invalid payment method
37
+
38
+ ---
39
+
40
+ ### 2. Get Invoices
41
+
42
+ **GET** `/api/billing/invoices`
43
+
44
+ Headers: `Authorization: Bearer {token}`
45
+
46
+ **Query params**:
47
+ - `status`: "paid", "pending", "failed" (optional)
48
+ - `limit`: 50 (default)
49
+ - `offset`: 0 (default)
50
+
51
+ **Response 200**:
52
+ ```json
53
+ {
54
+ "data": [
55
+ {
56
+ "id": "inv_xyz",
57
+ "invoiceNumber": "INV-2024-001",
58
+ "amount": 99.00,
59
+ "status": "paid",
60
+ "issuedAt": "2024-01-01T00:00:00Z",
61
+ "paidAt": "2024-01-01T10:30:00Z",
62
+ "receipt": "https://..."
63
+ }
64
+ ],
65
+ "pagination": {
66
+ "total": 12,
67
+ "limit": 50,
68
+ "offset": 0
69
+ }
70
+ }
71
+ ```
72
+
73
+ ---
74
+
75
+ ### 3. Get Invoice Details
76
+
77
+ **GET** `/api/billing/invoices/:id`
78
+
79
+ **Response 200**:
80
+ ```json
81
+ {
82
+ "data": {
83
+ "id": "inv_xyz",
84
+ "invoiceNumber": "INV-2024-001",
85
+ "organizationId": "org-uuid",
86
+ "amount": 99.00,
87
+ "currency": "usd",
88
+ "status": "paid",
89
+ "items": [
90
+ {
91
+ "description": "Pro Plan",
92
+ "quantity": 1,
93
+ "unitPrice": 99.00,
94
+ "amount": 99.00
95
+ }
96
+ ],
97
+ "issuedAt": "2024-01-01T00:00:00Z",
98
+ "dueDate": "2024-01-15T00:00:00Z",
99
+ "paidAt": "2024-01-01T10:30:00Z"
100
+ }
101
+ }
102
+ ```
103
+
104
+ ---
105
+
106
+ ### 4. Get Invoice PDF
107
+
108
+ **GET** `/api/billing/invoices/:id/pdf`
109
+
110
+ **Response 200**: PDF file (application/pdf)
111
+
112
+ ---
113
+
114
+ ### 5. Create Refund
115
+
116
+ **POST** `/api/billing/invoices/:id/refund`
117
+
118
+ ```json
119
+ {
120
+ "reason": "duplicate_charge",
121
+ "amount": 99.00
122
+ }
123
+ ```
124
+
125
+ **Response 201**:
126
+ ```json
127
+ {
128
+ "data": {
129
+ "refundId": "ref_123",
130
+ "originalInvoiceId": "inv_xyz",
131
+ "amount": 99.00,
132
+ "status": "processing",
133
+ "estimatedDate": "2024-01-08T00:00:00Z"
134
+ }
135
+ }
136
+ ```
137
+
138
+ ---
139
+
140
+ ### 6. Get Payment Methods
141
+
142
+ **GET** `/api/billing/payment-methods`
143
+
144
+ **Response 200**:
145
+ ```json
146
+ {
147
+ "data": [
148
+ {
149
+ "id": "pm_1234567890",
150
+ "type": "card",
151
+ "card": {
152
+ "brand": "visa",
153
+ "last4": "4242",
154
+ "expMonth": 12,
155
+ "expYear": 2025
156
+ },
157
+ "default": true
158
+ }
159
+ ]
160
+ }
161
+ ```
162
+
163
+ ---
164
+
165
+ ### 7. Add Payment Method
166
+
167
+ **POST** `/api/billing/payment-methods`
168
+
169
+ ```json
170
+ {
171
+ "paymentMethodId": "pm_token_from_stripe"
172
+ }
173
+ ```
174
+
175
+ **Response 201**:
176
+ ```json
177
+ {
178
+ "data": {
179
+ "id": "pm_1234567890",
180
+ "type": "card",
181
+ "default": false
182
+ }
183
+ }
184
+ ```
185
+
186
+ ---
187
+
188
+ ### 8. Get Transactions
189
+
190
+ **GET** `/api/billing/transactions`
191
+
192
+ **Response 200**:
193
+ ```json
194
+ {
195
+ "data": [
196
+ {
197
+ "id": "txn_123",
198
+ "amount": 99.00,
199
+ "type": "charge",
200
+ "status": "succeeded",
201
+ "relatedInvoiceId": "inv_xyz",
202
+ "createdAt": "2024-01-01T10:30:00Z"
203
+ }
204
+ ]
205
+ }
206
+ ```
207
+
208
+ ---
209
+
210
+ ## Error Codes
211
+
212
+ | Code | Message | Meaning |
213
+ |------|---------|---------|
214
+ | BIL_001 | Payment failed | Card declined, insufficient funds |
215
+ | BIL_002 | Invalid payment method | Payment method not found ou expirado |
216
+ | BIL_003 | Invoice not found | Invoice não existe |
217
+ | BIL_004 | Refund failed | Não pode fazer refund (expired, etc) |
218
+ | BIL_005 | Insufficient permissions | Apenas owner/admin pode gerenciar billing |
219
+
220
+ ## Flow Examples
221
+
222
+ ### Scenario: Charge for Upgrade
223
+ ```bash
224
+ curl -X POST http://localhost:3000/api/billing/charge \
225
+ -H "Authorization: Bearer eyJhbGc..." \
226
+ -H "Content-Type: application/json" \
227
+ -d '{
228
+ "amount": 99.00,
229
+ "currency": "usd",
230
+ "description": "Pro Plan Upgrade",
231
+ "paymentMethodId": "pm_1234567890"
232
+ }'
233
+ ```
234
+
235
+ ### Scenario: List Invoices
236
+ ```bash
237
+ curl -X GET http://localhost:3000/api/billing/invoices \
238
+ -H "Authorization: Bearer eyJhbGc..."
239
+ ```
240
+
241
+ ### Scenario: Get Invoice PDF
242
+ ```bash
243
+ curl -X GET http://localhost:3000/api/billing/invoices/inv_xyz/pdf \
244
+ -H "Authorization: Bearer eyJhbGc..." \
245
+ -o invoice.pdf
246
+ ```
247
+
248
+ ### Scenario: Request Refund
249
+ ```bash
250
+ curl -X POST http://localhost:3000/api/billing/invoices/inv_xyz/refund \
251
+ -H "Authorization: Bearer eyJhbGc..." \
252
+ -H "Content-Type: application/json" \
253
+ -d '{ "reason": "duplicate_charge", "amount": 99.00 }'
254
+ ```
255
+
256
+ ## Implementation Notes
257
+
258
+ - Todas operações isoladas por tenant
259
+ - Payment gateway é mock para MVP (90% success, 10% fail)
260
+ - Invoices geradas automaticamente após sucesso
261
+ - Refund processa em background (async)
262
+ - Retry logic para pagamentos falhados: 3 tentativas em 14 dias
@@ -0,0 +1,137 @@
1
+ # Billing Domain Context
2
+
3
+ ## O que é Billing neste SaaS?
4
+
5
+ Billing cuida de:
6
+ 1. Processar pagamentos (mock Stripe para MVP)
7
+ 2. Gerar invoices
8
+ 3. Registrar transações
9
+ 4. Retry policy para falhas
10
+ 5. Webhooks para eventos de billing
11
+
12
+ ## Fluxo de Pagamento
13
+
14
+ ```
15
+ Usuário faz upgrade
16
+ ↓
17
+ Billing Agent recebe request
18
+ ↓
19
+ Validar payment method (card)
20
+ ↓
21
+ Chamar payment gateway (mock Stripe)
22
+ ↓
23
+ [Sucesso?]
24
+ SIM → Criar invoice, registrar transação
25
+ Enviar email de receipt
26
+ Webhook callback
27
+ NÃO → Retry logic (3 tentativas em 14 dias)
28
+ Notificar usuário
29
+ Tentar method alternativo
30
+ ```
31
+
32
+ ## Payment Gateway Mock
33
+
34
+ Para MVP, simulamos Stripe com:
35
+ - Status: "succeeded" (90%) ou "failed" (10%)
36
+ - Transações em banco de dados
37
+ - Invoice generation automática
38
+
39
+ ```typescript
40
+ // Mock Stripe response
41
+ {
42
+ "id": "pi_1234567890",
43
+ "amount": 9900,
44
+ "currency": "usd",
45
+ "status": "succeeded",
46
+ "payment_method": {
47
+ "type": "card",
48
+ "card": { "last4": "4242", "brand": "visa" }
49
+ },
50
+ "created": 1705330200
51
+ }
52
+ ```
53
+
54
+ ## Invoice Structure
55
+
56
+ ```json
57
+ {
58
+ "id": "inv_xyz",
59
+ "organizationId": "org-uuid",
60
+ "invoiceNumber": "INV-2024-001",
61
+ "amount": 99.00,
62
+ "currency": "usd",
63
+ "status": "paid",
64
+ "description": "Pro Plan - January 2024",
65
+ "items": [
66
+ {
67
+ "description": "Pro Plan",
68
+ "quantity": 1,
69
+ "unitPrice": 99.00,
70
+ "amount": 99.00
71
+ },
72
+ {
73
+ "description": "Additional User (4 seats)",
74
+ "quantity": 4,
75
+ "unitPrice": 10.00,
76
+ "amount": 40.00
77
+ }
78
+ ],
79
+ "issuedAt": "2024-01-01T00:00:00Z",
80
+ "dueDate": "2024-01-15T00:00:00Z",
81
+ "paidAt": "2024-01-01T10:30:00Z"
82
+ }
83
+ ```
84
+
85
+ ## Regras de Negócio
86
+
87
+ 1. **Retry Policy**:
88
+ - 1ª tentativa: Imediato
89
+ - 2ª tentativa: 3 dias depois
90
+ - 3ª tentativa: 10 dias depois
91
+ - Após 3 falhas: Suspender acc, enviar notificação
92
+
93
+ 2. **Invoice Generation**:
94
+ - Automático após pagamento bem-sucedido
95
+ - Inclui subscription + add-ons (extra seats)
96
+ - PDF gerado async (futura)
97
+
98
+ 3. **Refund Policy**:
99
+ - Dentro de 14 dias: Full refund
100
+ - Após 14 dias: Pro-rata refund
101
+ - Processado em 5-7 dias
102
+
103
+ 4. **Tax Calculation** (Futura):
104
+ - US: Sales tax por estado
105
+ - EU: VAT aplicado
106
+ - B2B: Reverse charge
107
+
108
+ 5. **Currency Handling**:
109
+ - MVP: USD apenas
110
+ - Futuro: Multi-currency com taxa de câmbio
111
+
112
+ ## Métricas Importantes
113
+
114
+ - **Failed payment rate**: % de pagamentos rejeitados
115
+ - **Churn via failed payment**: % de cancelamentos por payment failure
116
+ - **Refund rate**: % de refunds vs total transactions
117
+ - **Invoice delivery**: % enviados < 1 min
118
+
119
+ ## Status Atual
120
+
121
+ - ✅ Invoice entity
122
+ - ✅ Payment mock (Stripe-like)
123
+ - ✅ Transaction history
124
+ - ✅ Invoice generation
125
+ - 🚧 PDF generation
126
+ - 🚧 Real Stripe integration
127
+ - 🚧 Webhook handling
128
+ - 🚧 Tax calculation
129
+ - 🚧 Multi-currency
130
+
131
+ ## Próximos Steps
132
+
133
+ 1. Implementar real Stripe integration
134
+ 2. Adicionar webhook handlers
135
+ 3. Gerar PDFs de invoices
136
+ 4. Implementar tax calculation
137
+ 5. Adicionar refund endpoints
@@ -0,0 +1,176 @@
1
+ # Subscriptions API Specification
2
+
3
+ ## Endpoints
4
+
5
+ ### 1. Get Subscription
6
+
7
+ **GET** `/api/subscriptions`
8
+
9
+ Headers: `Authorization: Bearer {token}`
10
+
11
+ **Response 200**:
12
+ ```json
13
+ {
14
+ "data": {
15
+ "id": "sub-uuid",
16
+ "organizationId": "org-uuid",
17
+ "plan": "pro",
18
+ "status": "active",
19
+ "currentPeriodStart": "2024-01-01T00:00:00Z",
20
+ "currentPeriodEnd": "2024-02-01T00:00:00Z",
21
+ "cancellationScheduledAt": null,
22
+ "createdAt": "2024-01-01T10:00:00Z"
23
+ }
24
+ }
25
+ ```
26
+
27
+ ---
28
+
29
+ ### 2. Create Subscription
30
+
31
+ **POST** `/api/subscriptions`
32
+
33
+ Headers: `Authorization: Bearer {token}`, Content-Type: `application/json`
34
+
35
+ ```json
36
+ {
37
+ "plan": "pro"
38
+ }
39
+ ```
40
+
41
+ **Response 201**:
42
+ ```json
43
+ {
44
+ "data": {
45
+ "id": "sub-uuid",
46
+ "plan": "pro",
47
+ "status": "active",
48
+ "currentPeriodStart": "2024-01-01T00:00:00Z",
49
+ "currentPeriodEnd": "2024-02-01T00:00:00Z"
50
+ }
51
+ }
52
+ ```
53
+
54
+ ---
55
+
56
+ ### 3. Upgrade/Downgrade Plan
57
+
58
+ **POST** `/api/subscriptions/:id/upgrade`
59
+
60
+ ```json
61
+ {
62
+ "newPlan": "enterprise"
63
+ }
64
+ ```
65
+
66
+ **Response 200**:
67
+ ```json
68
+ {
69
+ "data": {
70
+ "id": "sub-uuid",
71
+ "plan": "enterprise",
72
+ "status": "active",
73
+ "upgradedAt": "2024-01-15T14:30:00Z",
74
+ "prorateCharge": 45.67
75
+ }
76
+ }
77
+ ```
78
+
79
+ **Error 400**: Transição de plano inválida
80
+
81
+ ---
82
+
83
+ ### 4. Cancel Subscription
84
+
85
+ **POST** `/api/subscriptions/:id/cancel`
86
+
87
+ ```json
88
+ {
89
+ "reason": "Too expensive",
90
+ "immediate": false
91
+ }
92
+ ```
93
+
94
+ **Response 200**:
95
+ ```json
96
+ {
97
+ "data": {
98
+ "id": "sub-uuid",
99
+ "status": "scheduled_for_cancellation",
100
+ "cancellationScheduledAt": "2024-02-01T00:00:00Z"
101
+ }
102
+ }
103
+ ```
104
+
105
+ ---
106
+
107
+ ### 5. Get Usage Metrics
108
+
109
+ **GET** `/api/subscriptions/usage`
110
+
111
+ **Response 200**:
112
+ ```json
113
+ {
114
+ "data": {
115
+ "subscriptionId": "sub-uuid",
116
+ "plan": "pro",
117
+ "apiCallsThisMonth": 45234,
118
+ "apiCallsLimit": 100000,
119
+ "storageUsed": 24.5,
120
+ "storageLimitGB": 100,
121
+ "seatsUsed": 3,
122
+ "seatsIncluded": 5,
123
+ "percentageUtilization": 45.2
124
+ }
125
+ }
126
+ ```
127
+
128
+ ---
129
+
130
+ ## Error Codes
131
+
132
+ | Code | Message | Meaning |
133
+ |------|---------|---------|
134
+ | SUB_001 | Invalid plan transition | Downgrade mid-year ou outro erro |
135
+ | SUB_002 | Subscription not found | Org não tem subscription |
136
+ | SUB_003 | Plan not found | Plano não existe |
137
+ | SUB_004 | Approval required | Upgrade para Enterprise precisa aprovação |
138
+ | SUB_005 | Quota exceeded | Hard limit atingido |
139
+
140
+ ## Flow Examples
141
+
142
+ ### Scenario: Get Current Subscription
143
+ ```bash
144
+ curl -X GET http://localhost:3000/api/subscriptions \
145
+ -H "Authorization: Bearer eyJhbGc..."
146
+ ```
147
+
148
+ ### Scenario: Upgrade to Pro
149
+ ```bash
150
+ curl -X POST http://localhost:3000/api/subscriptions/{id}/upgrade \
151
+ -H "Authorization: Bearer eyJhbGc..." \
152
+ -H "Content-Type: application/json" \
153
+ -d '{ "newPlan": "pro" }'
154
+ ```
155
+
156
+ ### Scenario: Check Usage
157
+ ```bash
158
+ curl -X GET http://localhost:3000/api/subscriptions/usage \
159
+ -H "Authorization: Bearer eyJhbGc..."
160
+ ```
161
+
162
+ ### Scenario: Cancel Subscription
163
+ ```bash
164
+ curl -X POST http://localhost:3000/api/subscriptions/{id}/cancel \
165
+ -H "Authorization: Bearer eyJhbGc..." \
166
+ -H "Content-Type: application/json" \
167
+ -d '{ "reason": "Too expensive", "immediate": false }'
168
+ ```
169
+
170
+ ## Implementation Notes
171
+
172
+ - Todas operações isoladas por tenant
173
+ - Upgrade cobra pro-rata via Billing Agent
174
+ - Usage tracking é informativo (soft limits)
175
+ - Downgrade efetiva no fim do ciclo
176
+ - Cancellation pode ser imediata ou agendada
@@ -0,0 +1,100 @@
1
+ # Subscriptions Domain Context
2
+
3
+ ## O que é Subscription neste SaaS?
4
+
5
+ Um subscription representa um plano escolhido por uma organização, com:
6
+ 1. Escolha de plano (free, pro, enterprise)
7
+ 2. Tracking de limite de uso (API calls, storage)
8
+ 3. Upgrade/downgrade com proration
9
+ 4. Eventos de billing vinculados
10
+
11
+ ## Planos
12
+
13
+ ### Free
14
+ - **Price**: $0/mês
15
+ - **API calls**: 1.000/mês
16
+ - **Storage**: 1GB
17
+ - **Users**: 1
18
+ - **Support**: Community
19
+
20
+ ### Pro
21
+ - **Price**: $99/mês (ou $1.188/ano = 20% off)
22
+ - **API calls**: 100.000/mês
23
+ - **Storage**: 100GB
24
+ - **Users**: 5 (+ $10/user adicional)
25
+ - **Support**: Email 24h
26
+
27
+ ### Enterprise
28
+ - **Price**: Custom
29
+ - **API calls**: Unlimited
30
+ - **Storage**: Unlimited
31
+ - **Users**: Unlimited
32
+ - **Support**: Dedicated account manager
33
+
34
+ ## Fluxo de Upgrade
35
+
36
+ ```
37
+ Usuário em Free
38
+ ↓ (seleciona Pro)
39
+ Validar transição possível?
40
+ ↓ SIM
41
+ Chamar Billing Agent (cobrar cartão)
42
+ ↓ (sucesso)
43
+ Atualizar subscription.plan = 'pro'
44
+ Registrar audit log
45
+ ↓
46
+ Enviar email confirmação
47
+ ```
48
+
49
+ ## Regras de Negócio
50
+
51
+ 1. **Transições válidas**:
52
+ - Free → Pro: Imediato, charged pro-rata
53
+ - Free → Enterprise: Requires approval
54
+ - Pro → Free: Imediato, credit note gerado
55
+ - Pro → Enterprise: Requer aprovação
56
+
57
+ 2. **Pro-rata charging**:
58
+ ```
59
+ Days remaining in month = 30 - current_day
60
+ Daily rate = Plan price / 30
61
+ Pro-rata charge = daily_rate * days_remaining
62
+ ```
63
+
64
+ 3. **Effective dates**:
65
+ - Upgrade: Imediato
66
+ - Downgrade: Fim do ciclo de billing
67
+
68
+ 4. **Quotas & Limits**:
69
+ - Free: 1k API calls (soft limit, aviso)
70
+ - Pro: 100k API calls (soft limit, aviso)
71
+ - Hard limits triggerem bloqueio e sugestão de upgrade
72
+
73
+ 5. **Annual subscriptions**:
74
+ - 20% desconto (Pro = $1.188/ano)
75
+ - Renova em anniversary date
76
+ - Cannot downgrade mid-year
77
+
78
+ ## Métricas Importantes
79
+
80
+ - **MRR** (Monthly Recurring Revenue): Soma de subscriptions ativas × preço
81
+ - **ARR** (Annual Recurring Revenue): MRR × 12
82
+ - **Churn rate**: (Orgs canceladas / Orgs ativas) × 100
83
+ - **Net Retention**: (MRR fim mês - (Downgrade + Churn) + Upgrades) / MRR início
84
+ - **ARPU** (Average Revenue Per User): MRR / Total users
85
+
86
+ ## Status Atual
87
+
88
+ - ✅ Subscription entity criada
89
+ - ✅ CRUD endpoints
90
+ - ✅ Plan validation
91
+ - ✅ Upgrade logic
92
+ - 🚧 Annual subscriptions (future)
93
+ - 🚧 Bulk seats billing (future)
94
+
95
+ ## Próximos Steps
96
+
97
+ 1. Implementar annual subscriptions
98
+ 2. Adicionar feature flags por plano
99
+ 3. Criar dashboard de uso (consumo de API calls)
100
+ 4. Webhooks para mudanças de subscription