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,31 @@
1
+ import { Test, TestingModule } from '@nestjs/testing';
2
+ import { INestApplication } from '@nestjs/common';
3
+ import * as request from 'supertest';
4
+ import { AppModule } from '../src/app.module';
5
+
6
+ describe('Health (e2e)', () => {
7
+ let app: INestApplication;
8
+
9
+ beforeAll(async () => {
10
+ const moduleFixture: TestingModule = await Test.createTestingModule({
11
+ imports: [AppModule],
12
+ }).compile();
13
+
14
+ app = moduleFixture.createNestApplication();
15
+ await app.init();
16
+ });
17
+
18
+ afterAll(async () => {
19
+ await app.close();
20
+ });
21
+
22
+ it('GET /api/health should return status up', () => {
23
+ return request(app.getHttpServer())
24
+ .get('/api/health')
25
+ .expect(200)
26
+ .expect((res) => {
27
+ expect(res.body).toHaveProperty('status');
28
+ expect(res.body.status).toBe('up');
29
+ });
30
+ });
31
+ });
@@ -0,0 +1,12 @@
1
+ module.exports = {
2
+ moduleFileExtensions: ['js', 'json', 'ts'],
3
+ rootDir: '.',
4
+ testEnvironment: 'node',
5
+ testRegex: '.e2e-spec.ts$',
6
+ transform: {
7
+ '^.+\\.(t|j)s$': 'ts-jest',
8
+ },
9
+ moduleNameMapper: {
10
+ '^@/(.*)$': '<rootDir>/src/$1',
11
+ },
12
+ };
@@ -0,0 +1,23 @@
1
+ {
2
+ "compilerOptions": {
3
+ "module": "commonjs",
4
+ "target": "ES2020",
5
+ "lib": ["ES2020"],
6
+ "declaration": true,
7
+ "outDir": "./dist",
8
+ "rootDir": "./src",
9
+ "strict": true,
10
+ "esModuleInterop": true,
11
+ "skipLibCheck": true,
12
+ "forceConsistentCasingInFileNames": true,
13
+ "resolveJsonModule": true,
14
+ "allowSyntheticDefaultImports": true,
15
+ "moduleResolution": "node",
16
+ "baseUrl": ".",
17
+ "paths": {
18
+ "@/*": ["src/*"]
19
+ }
20
+ },
21
+ "include": ["src/**/*"],
22
+ "exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
23
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "schemaVersion": "1.0",
3
+ "type": "boilerplate",
4
+ "name": "03-ecommerce-starter",
5
+ "title": "E-Commerce Starter - Boilerplate Completo",
6
+ "path": "boilerplates/03-ecommerce-starter",
7
+ "readme": "boilerplates/03-ecommerce-starter/README.md",
8
+ "stack": [
9
+ "NestJS",
10
+ "React",
11
+ "Docker",
12
+ "JWT",
13
+ "Postgres"
14
+ ],
15
+ "useCases": [
16
+ "E-Commerce",
17
+ "Admin",
18
+ "Auth"
19
+ ],
20
+ "commands": [
21
+ "npm install",
22
+ "npm run start:dev",
23
+ "docker compose up -d",
24
+ "npm test"
25
+ ],
26
+ "gates": [
27
+ "npm run spec:check",
28
+ "npm test",
29
+ "npm run project:check"
30
+ ],
31
+ "tokenPolicy": {
32
+ "firstRead": [
33
+ "boilerplate.manifest.json",
34
+ "README.md"
35
+ ],
36
+ "avoidLoadingByDefault": [
37
+ "node_modules",
38
+ "dist",
39
+ "coverage"
40
+ ]
41
+ }
42
+ }
@@ -0,0 +1,128 @@
1
+ # E-Commerce Starter Boilerplate
2
+
3
+ Este é o boilerplate de e-commerce completo gerado pelo `create-memory-nest-kit`.
4
+
5
+ ## Estrutura
6
+
7
+ ```
8
+ 03-ecommerce-starter/
9
+ ├── README.md # Documentação principal
10
+ ├── FLOW_EXEMPLOS.md # Exemplos de API com curl
11
+ ├── .gitignore # Git ignore
12
+ │
13
+ ├── memory/ # 10 níveis de contexto (estrutura-padrão)
14
+ │ ├── 00-global/ # Missão, padrões, contexto
15
+ │ ├── 10-product/ # Visão, personas, regras
16
+ │ ├── 20-architecture/ # Design técnico
17
+ │ ├── 30-domains/ # Contexto por domínio
18
+ │ │ ├── catalog/ # Produtos e categorias
19
+ │ │ ├── orders/ # Pedidos
20
+ │ │ ├── payments/ # Pagamentos
21
+ │ │ └── inventory/ # Estoque
22
+ │ ├── 40-delivery/ # Roadmap (futuro)
23
+ │ ├── 50-orchestration/ # Agentes, handoffs (futuro)
24
+ │ ├── 60-runs/ # Logs de execução (futuro)
25
+ │ ├── 70-summaries/ # Resumos (futuro)
26
+ │ ├── 80-data/ # Schemas PostgreSQL
27
+ │ └── 90-decisions/ # ADRs
28
+ │
29
+ ├── backend/ # Aplicação NestJS
30
+ │ ├── src/
31
+ │ │ ├── main.ts
32
+ │ │ ├── app.module.ts
33
+ │ │ └── modules/
34
+ │ │ ├── products/ # Catálogo
35
+ │ │ ├── cart/ # Carrinho
36
+ │ │ ├── orders/ # Pedidos
37
+ │ │ ├── payments/ # Pagamentos
38
+ │ │ ├── inventory/ # Inventário
39
+ │ │ ├── coupons/ # Cupons
40
+ │ │ ├── reviews/ # Avaliações
41
+ │ │ └── auth/ # Autenticação (mock)
42
+ │ ├── test/
43
+ │ ├── docker-compose.yml
44
+ │ ├── Dockerfile
45
+ │ ├── package.json
46
+ │ ├── tsconfig.json
47
+ │ ├── jest.config.js
48
+ │ └── .env.example
49
+ │
50
+ ├── agents/ # Agentes AI (futuro)
51
+ ├── skills/ # Skills customizadas (futuro)
52
+ └── prompts/ # Prompts para agentes (futuro)
53
+ ```
54
+
55
+ ## Quick Start
56
+
57
+ ```bash
58
+ cd backend
59
+ docker-compose up -d
60
+ cp .env.example .env
61
+ npm install
62
+ npm run start:dev
63
+ ```
64
+
65
+ Acesse: http://localhost:3000/docs
66
+
67
+ ## Documentação
68
+
69
+ Consulte `memory/` para detalhes completos:
70
+
71
+ - **Visão** → `memory/10-product/vision.md`
72
+ - **Arquitetura** → `memory/20-architecture/overview.md`
73
+ - **Domínios** → `memory/30-domains/*/context.md`
74
+ - **API Exemplos** → `FLOW_EXEMPLOS.md`
75
+
76
+ ## Endpoints Principais
77
+
78
+ ```bash
79
+ # Produtos
80
+ GET /api/products
81
+ GET /api/products/:id
82
+ POST /api/products (admin)
83
+
84
+ # Carrinho
85
+ POST /api/cart/add
86
+ GET /api/cart
87
+ POST /api/cart/apply-coupon
88
+
89
+ # Checkout
90
+ POST /api/payments/process
91
+
92
+ # Pedidos
93
+ GET /api/orders
94
+ GET /api/orders/:id
95
+ PUT /api/orders/:id/status (admin)
96
+ ```
97
+
98
+ ## Stack
99
+
100
+ - **Runtime**: Node.js 18+
101
+ - **Framework**: NestJS 10
102
+ - **Language**: TypeScript
103
+ - **DB**: PostgreSQL 14
104
+ - **Cache**: Redis (future)
105
+ - **API Docs**: Swagger/OpenAPI
106
+
107
+ ## Testes
108
+
109
+ ```bash
110
+ npm run test # Unitários
111
+ npm run test:e2e # E2E
112
+ npm run test:cov # Coverage
113
+ ```
114
+
115
+ ## Deploy
116
+
117
+ ```bash
118
+ docker build -t ecommerce-api:1.0 .
119
+ docker run -p 3000:3000 --env-file .env ecommerce-api:1.0
120
+ ```
121
+
122
+ ## Autores
123
+
124
+ Criado com ❤️ pelo `create-memory-nest-kit` CLI
125
+
126
+ ---
127
+
128
+ **Nota**: Este é um boilerplate educacional. Para produção, adicionar autenticação real, PCI compliance, e integração com Stripe real.
@@ -0,0 +1,53 @@
1
+ # Contrato de Agentes (Agent Contract)
2
+
3
+ ## Princípios
4
+ 1. **Responsabilidade Única**: Cada agente tem um domínio/skill claro
5
+ 2. **Comunicação Explícita**: Via memory/, handoffs com timestamp
6
+ 3. **Falha Graceful**: Sempre reportar status, não falhar silenciosamente
7
+ 4. **Rastreabilidade**: Toda ação registrada em 60-runs/
8
+
9
+ ## Agentes Definidos
10
+
11
+ ### Orchestrator (orquestrador)
12
+ - **Responsabilidade**: Coordenação, routing, handoffs
13
+ - **Entrada**: Requisições de novos features, bugs
14
+ - **Saída**: Handoff estruturado em 50-orchestration/handoffs/
15
+ - **SLA**: Responde em < 5min
16
+
17
+ ### Backend-NestJS
18
+ - **Responsabilidade**: API REST, domain logic, persistência
19
+ - **Input**: Requisições do Orchestrator
20
+ - **Output**: Código em `backend/src/`, testes, migrations
21
+ - **Constraints**: TypeScript strict, testes obrigatórios
22
+
23
+ ### Frontend (future)
24
+ - **Responsabilidade**: UI/UX, integração com backend
25
+ - **Input**: API contracts do backend
26
+ - **Output**: React/Vue components, stories
27
+
28
+ ### DBA (future)
29
+ - **Responsabilidade**: Schemas, migrations, performance
30
+ - **Input**: Entidades do backend
31
+ - **Output**: Migrations, índices, queries otimizadas
32
+
33
+ ### Security
34
+ - **Responsabilidade**: Validação, autenticação, compliance
35
+ - **Input**: Code review, arquitetura
36
+ - **Output**: Recomendações, fixes
37
+
38
+ ## Handoff Format
39
+ ```
40
+ memory/50-orchestration/handoffs/[ISO8601-slug].md
41
+ ---
42
+ From: Orchestrator
43
+ To: Backend-NestJS
44
+ Status: pending | in-progress | completed
45
+ Task: [Breve descrição]
46
+ Context: [Link para memory/]
47
+ Artifacts: [Arquivos gerados]
48
+ ```
49
+
50
+ ## Escalação
51
+ - Bug crítico → Backend-NestJS direct
52
+ - Decisão arquitetural → Security + Backend-NestJS (ADR em 90-decisions)
53
+ - Feature complexa → Orchestrator → decomposição em subtasks
@@ -0,0 +1,55 @@
1
+ # Índice de Contexto Global
2
+
3
+ ## Navegação Rápida
4
+
5
+ ### 📋 Estratégia (00-global)
6
+ - [Mission](mission.md) - Visão e KPIs
7
+ - [Standards](standards.md) - Padrões técnicos
8
+ - [Context Policy](context-policy.md) - Como estruturamos conhecimento
9
+ - [Agent Contract](agent-contract.md) - Acordos entre agentes
10
+ - [Context Index](context-index.md) - Este arquivo
11
+
12
+ ### 🎯 Produto (10-product)
13
+ - [Vision](../10-product/vision.md) - Personas, user stories
14
+ - [Business Rules](../10-product/business-rules.md) - Regras de negócio
15
+ - [NFRs](../10-product/nfrs.md) - Performance, segurança, compliance
16
+
17
+ ### 🏗️ Arquitetura (20-architecture)
18
+ - [Overview](../20-architecture/overview.md) - Componentes, fluxo
19
+ - [Backend](../20-architecture/backend.md) - NestJS, módulos
20
+ - [Data](../20-architecture/data.md) - Schemas PostgreSQL
21
+ - [Security](../20-architecture/security.md) - Autenticação, autorização
22
+ - [Observability](../20-architecture/observability.md) - Logs, metricas
23
+
24
+ ### 🎪 Domínios (30-domains)
25
+ - [Catalog](../30-domains/catalog/) - Produtos e categorias
26
+ - [Orders](../30-domains/orders/) - Pedidos e status
27
+ - [Payments](../30-domains/payments/) - Mock Stripe
28
+ - [Inventory](../30-domains/inventory/) - Stock management
29
+
30
+ ### 📊 Entrega (40-delivery, 50-orchestration, etc)
31
+ - [Roadmap](../40-delivery/roadmap.md) - Timeline
32
+ - [Current Sprint](../40-delivery/current-sprint.md) - Backlog atual
33
+ - [Orchestration](../50-orchestration/topology.md) - Topologia de agentes
34
+ - [Handoffs](../50-orchestration/handoffs/) - Histórico de trocas
35
+
36
+ ### 📈 Relatórios (70-summaries)
37
+ - [Global Summary](../70-summaries/global.md) - Estado geral
38
+ - [Domain Summaries](../70-summaries/domains/) - Por bounded domain
39
+
40
+ ### 🛠️ Data (80-data)
41
+ - [SQLite Schema](../80-data/sqlite.md) - Se aplicável
42
+
43
+ ### 🤔 Decisões (90-decisions)
44
+ - [ADR Template](../90-decisions/ADR-TEMPLATE.md)
45
+ - ADRs específicas conforme necessário
46
+
47
+ ## Como Usar Este Índice
48
+ 1. Começar aqui para entender estrutura
49
+ 2. Ir para 00-global/context-policy.md para entender como estruturamos
50
+ 3. Consultar domínios específicos em 30-domains/
51
+ 4. Trackear progresso em 40-delivery/
52
+ 5. Escalações arquiteturais → 90-decisions/
53
+
54
+ ## Última Atualização
55
+ 2024-01-XX por create-memory-nest-kit CLI
@@ -0,0 +1,31 @@
1
+ # Política de Contexto e Comunicação
2
+
3
+ ## Estrutura de Contexto
4
+ - **0-global**: Estratégia, padrões, contrato de agentes
5
+ - **10-product**: Requisitos, personas, regras de negócio
6
+ - **20-architecture**: Design técnico, componentes, fluxos
7
+ - **30-domains**: Contexto por bounded domain (catalog, orders, payments, inventory)
8
+ - **40-delivery**: Roadmap, sprints, backlog
9
+ - **50-orchestration**: Roteamento entre agentes, handoffs, parallelização
10
+ - **60-runs**: Logs de execução, timestamp, status
11
+ - **70-summaries**: Resumos executivos e técnicos
12
+ - **80-data**: Schemas, SQLite docs
13
+ - **90-decisions**: ADRs (Architecture Decision Records)
14
+
15
+ ## Fluxo de Comunicação
16
+ 1. **Orquestrador** lê missão + padrões
17
+ 2. **Agentes de negócio** consultam 10-product + 30-domains
18
+ 3. **Agentes técnicos** consultam 20-architecture + padrões
19
+ 4. **Após execução** → append em 50-orchestration/handoffs/ com timestamp
20
+ 5. **Consolidação** → update em 70-summaries/
21
+
22
+ ## Critério de Atualização
23
+ - Mudanças de requisito → 10-product
24
+ - Mudanças arquiteturais → 20-architecture + 90-decisions (ADR)
25
+ - Novos domínios → 30-domains/<novo>/
26
+ - Decisões → 90-decisions/ADR-XXX.md (ISO 8601 + slug)
27
+
28
+ ## Retenção
29
+ - Runs: Últimas 30 dias em 60-runs/
30
+ - Handoffs: Permanente em 50-orchestration/handoffs/
31
+ - Summaries: Sempre consolidados (1 global + 1 por domínio)
@@ -0,0 +1,25 @@
1
+ # Missão do E-Commerce Starter
2
+
3
+ ## Visão Executiva
4
+ Construir uma plataforma de e-commerce modular, escalável e pronta para produção que permita venda de produtos online com funcionalidades completas de catálogo, carrinho, checkout e gerenciamento de pedidos.
5
+
6
+ ## Objetivos Estratégicos
7
+ 1. **Catálogo Dinâmico** - Gerenciar produtos com categorias, descrições, preços e imagens
8
+ 2. **Experiência de Compra** - Carrinho de compras fluido e checkout simplificado
9
+ 3. **Processamento de Pagamentos** - Integração com gateway de pagamentos (mock Stripe)
10
+ 4. **Gestão de Pedidos** - Rastreamento completo do lifecycle de pedidos
11
+ 5. **Controle de Inventário** - Stock management em tempo real
12
+ 6. **Análise de Produtos** - Sistema de avaliações e reviews
13
+
14
+ ## Pilares Técnicos
15
+ - **Backend**: NestJS + PostgreSQL
16
+ - **Cache**: Redis para performance
17
+ - **Documentação**: Memory-driven architecture
18
+ - **Testing**: E2E coverage para fluxos críticos
19
+ - **Escalabilidade**: Pronto para microsserviços
20
+
21
+ ## KPIs de Sucesso
22
+ - Tempo de resposta < 200ms para listagem de produtos
23
+ - Checkout completo em < 30 segundos
24
+ - 99.9% uptime
25
+ - Suporte a 10k+ produtos no catálogo
@@ -0,0 +1,45 @@
1
+ # Padrões Técnicos e Convenções
2
+
3
+ ## Código
4
+ - **Linguagem**: TypeScript (strict mode)
5
+ - **Framework**: NestJS com arquitetura modular
6
+ - **Convenção de Nomes**:
7
+ - Classes: PascalCase (ProductService, CartController)
8
+ - Métodos: camelCase (getProducts, addToCart)
9
+ - Constantes: UPPER_SNAKE_CASE
10
+ - Variáveis: camelCase
11
+ - **Organização**: One file per class/interface
12
+ - **Imports**: Agrupar por externa → interna → relativa
13
+
14
+ ## Banco de Dados
15
+ - **Database**: PostgreSQL
16
+ - **Migrations**: TypeORM CLI
17
+ - **Entities**: Uma entity por arquivo
18
+ - **Relacionamentos**: lazy loading onde apropriado
19
+ - **Índices**: Em campos frequentemente consultados (product_id, user_id)
20
+
21
+ ## API
22
+ - **Versionamento**: `/api/v1` (future-ready)
23
+ - **Respostas**: JSON com estrutura consistente
24
+ - **Erros**: HTTP status codes semânticos + error codes internos
25
+ - **Paginação**: offset/limit padrão
26
+ - **Rate Limiting**: 100 requests/min por cliente
27
+
28
+ ## Testes
29
+ - **Framework**: Jest
30
+ - **Coverage**: > 80% para módulos críticos
31
+ - **E2E**: Fluxos de checkout, pagamento, pedidos
32
+ - **Naming**: `*.spec.ts` (unitários), `*.e2e-spec.ts` (integração)
33
+
34
+ ## Segurança
35
+ - **Auth**: JWT com refresh tokens
36
+ - **CORS**: Configurável por ambiente
37
+ - **Inputs**: Validação com class-validator + sanitização
38
+ - **Secrets**: Via .env (não em código)
39
+ - **HTTPS**: Obrigatório em produção
40
+
41
+ ## Documentação
42
+ - **Memory**: 10 níveis por domínio
43
+ - **API Docs**: Swagger via NestJS decorators
44
+ - **README**: Setup, arquitetura, exemplos curl
45
+ - **Commits**: Semantic versioning (feat:, fix:, docs:)
@@ -0,0 +1,62 @@
1
+ # Regras de Negócio
2
+
3
+ ## Preços e Promoções
4
+ - Preço base é obrigatório (> 0)
5
+ - Promoções podem ser por cupom ou hardcoded em produto
6
+ - Desconto máximo: 100% (produto grátis permitido)
7
+ - Imposto: 15% calculado no checkout (simplificado)
8
+ - Total = (subtotal com desconto) * 1.15
9
+
10
+ ## Carrinho
11
+ - Carrinho máximo: 100 itens
12
+ - Quantidade mínima por item: 1
13
+ - Quantidade máxima por item: 1000
14
+ - Carrinho vazio após 30 dias de inatividade (cookie)
15
+ - Um cupom por carrinho
16
+
17
+ ## Pedidos
18
+ - Pedido = tudo ou nada (transação atômica)
19
+ - Se stock insuficiente → falha no checkout
20
+ - Número de pedido: UUID
21
+ - Apenas clientes autenticados podem fazer pedidos (para MVP, mock user)
22
+ - Histórico de pedido imutável
23
+
24
+ ## Inventário
25
+ - Stock negativo NÃO permitido
26
+ - Reposição manual (input de gerente)
27
+ - Alerta quando < 5 unidades
28
+ - Reserva de stock ocorre no checkout (não em "add to cart")
29
+
30
+ ## Pagamentos (Mock Stripe)
31
+ - Taxa simulada: 2.9% + R$0.30 por transação
32
+ - Lógica simples: 90% sucesso, 10% falha (aleatório)
33
+ - Transação bem-sucedida → order status = processing
34
+ - Transação falha → libera stock, order status = failed
35
+
36
+ ## Avaliações
37
+ - Apenas comprador pode avaliar seu próprio pedido
38
+ - Uma avaliação por item de pedido
39
+ - Números de 1-5 (sem 0 ou decimais)
40
+ - Texto até 500 caracteres
41
+ - Não há exclusão (soft delete opcional)
42
+
43
+ ## Segurança
44
+ - Sem autenticação real em MVP (mock JWT)
45
+ - Senhas não são armazenadas em MVP
46
+ - HTTPS obrigatório em produção
47
+ - Rate limiting: 100 req/min por IP
48
+ - Validação de input obrigatória
49
+
50
+ ## Performance
51
+ - Produtos listados com paginação (padrão: 20 por página)
52
+ - Cache Redis para:
53
+ - Categorias (TTL 1h)
54
+ - Produtos top-sellers (TTL 30min)
55
+ - Carrinho (TTL 24h)
56
+ - Busca full-text em nome/descrição (ILIKE em PostgreSQL)
57
+
58
+ ## Conformidade
59
+ - LGPD: Dados de cliente não são exportados (apenas em solicitação)
60
+ - Termos de serviço aceitos no checkout (mock)
61
+ - Política de privacidade disponível
62
+ - Cancelamento de conta = soft delete (dados retidos 90 dias)
@@ -0,0 +1,62 @@
1
+ # Requisitos Não-Funcionais (NFRs)
2
+
3
+ ## Performance
4
+ | Requisito | Target | Método |
5
+ |-----------|--------|--------|
6
+ | Listagem de produtos | < 200ms p95 | Índices + paginação + cache |
7
+ | Busca/filtro | < 300ms p95 | Full-text search + índices |
8
+ | Checkout (validate+process) | < 500ms p95 | Transações atômicas + otimização |
9
+ | Response time geral | < 100ms p50 | CDN para estáticos, cache em camadas |
10
+
11
+ ## Escalabilidade
12
+ - **Throughput**: 1000 concurrent users
13
+ - **Armazenamento**: 10k+ produtos no catálogo
14
+ - **Conexões DB**: Connection pooling com 20 conexões
15
+ - **Cache**: Redis com 1GB limite inicial
16
+ - **Estratégia**: Pronto para sharding no futuro
17
+
18
+ ## Disponibilidade
19
+ - **Uptime**: 99.9% (máximo 43 min/mês downtime)
20
+ - **RTO** (Recovery Time Objective): 15 minutos
21
+ - **RPO** (Recovery Point Objective): < 5 minutos (backups a cada 5min)
22
+ - **Health Check**: `/api/health` a cada 30s
23
+
24
+ ## Segurança
25
+ - **Encryption**: TLS 1.3 em trânsito
26
+ - **Authentication**: JWT com expiry 1h, refresh token 30 dias
27
+ - **Authorization**: RBAC (user, admin)
28
+ - **Input Validation**: Todas as entradas (length, type, format)
29
+ - **SQL Injection**: TypeORM parameterizado (protected)
30
+ - **CORS**: Apenas origins registradas
31
+ - **CSRF**: Tokens no formulário (POST/PUT/DELETE)
32
+ - **Rate Limiting**: 100 req/min por IP
33
+ - **Secrets**: Variáveis de ambiente, nunca em código
34
+
35
+ ## Manutenibilidade
36
+ - **Código**: TypeScript strict, 80%+ test coverage
37
+ - **Logs**: Estruturados (JSON), níveis (info, warn, error)
38
+ - **Observabilidade**: Health checks, metricas Prometheus (future)
39
+ - **Documentação**: Cobertura 100% de APIs via Swagger
40
+ - **CI/CD**: Testes automáticos antes de merge
41
+
42
+ ## Compliance
43
+ - **LGPD**: Direito ao esquecimento, consentimento explícito
44
+ - **PCI-DSS**: Mock Stripe (dados reais fora do escopo MVP)
45
+ - **Auditoria**: Logs de operações críticas (pagamentos, exclusões)
46
+ - **Backup**: Daily backups, retention 30 dias
47
+
48
+ ## Confiabilidade
49
+ - **Idempotência**: Operações críticas (pagamento, pedido) retentáveis
50
+ - **Graceful Degradation**: Cache falha → chama DB
51
+ - **Retry Logic**: Exponential backoff para chamadas externas
52
+ - **Falha em Cascata**: Circuit breaker para dependências externas (future)
53
+
54
+ ## Compatibilidade
55
+ - **Browsers**: Chrome, Firefox, Safari, Edge (últimas 2 versões)
56
+ - **Mobile**: Responsivo (iOS Safari, Android Chrome)
57
+ - **APIs**: Versionada (/api/v1), backward compatible
58
+
59
+ ## Disaster Recovery
60
+ - **Backup**: Daily full backup + hourly WAL
61
+ - **Replica**: Standby PostgreSQL para failover (future)
62
+ - **Testado**: DR drills mensais