forjajs 2.0.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +50 -50
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +133 -133
- package/CHANGELOG.md +619 -555
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +64 -60
- package/LICENSE +21 -21
- package/README.md +404 -343
- package/README.pt-BR.md +374 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
- package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
- package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/apps/server/src/forja-nest.module.js +9 -4
- package/dist/apps/server/src/main.js +10 -1
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/code-context.js +6 -0
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/architecture-gate.d.ts +20 -0
- package/dist/lib/core/architecture-gate.js +60 -0
- package/dist/lib/core/drift-gate.d.ts +18 -0
- package/dist/lib/core/drift-gate.js +55 -0
- package/dist/lib/core/gates.d.ts +9 -2
- package/dist/lib/core/gates.js +13 -2
- package/dist/lib/core/health.js +15 -0
- package/dist/lib/core/incident-search.d.ts +19 -0
- package/dist/lib/core/incident-search.js +32 -0
- package/dist/lib/core/model-pricing.d.ts +31 -0
- package/dist/lib/core/model-pricing.js +74 -0
- package/dist/lib/core/registry.d.ts +194 -0
- package/dist/lib/core/registry.js +194 -0
- package/dist/lib/core/release.d.ts +194 -0
- package/dist/lib/core/risk-collect.d.ts +19 -0
- package/dist/lib/core/risk-collect.js +173 -0
- package/dist/lib/drift-sentinel.d.ts +59 -0
- package/dist/lib/drift-sentinel.js +126 -0
- package/dist/lib/generators/memory-generator.js +691 -691
- package/dist/lib/generators/nest-generator.js +412 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/workspace.js +29 -29
- package/dist/packages/adapter-git/src/index.d.ts +1 -1
- package/dist/packages/adapter-git/src/index.js +11 -6
- package/dist/packages/adapter-nest/src/index.d.ts +19 -0
- package/dist/packages/adapter-nest/src/index.js +26 -1
- package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
- package/dist/packages/adapter-sqlite/src/index.js +61 -12
- package/dist/packages/contracts/src/index.d.ts +33 -0
- package/dist/packages/contracts/src/index.js +13 -0
- package/dist/packages/core/src/index.d.ts +12 -0
- package/dist/packages/core/src/index.js +29 -0
- package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
- package/dist/packages/engineering/architecture/src/index.js +131 -0
- package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
- package/dist/packages/engineering/evidence/src/index.js +31 -0
- package/dist/packages/engineering/identity/src/index.d.ts +57 -0
- package/dist/packages/engineering/identity/src/index.js +88 -0
- package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
- package/dist/packages/engineering/monitoring/src/index.js +40 -0
- package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
- package/dist/packages/engineering/provenance/src/index.js +21 -0
- package/dist/packages/engineering/risk/src/index.d.ts +89 -0
- package/dist/packages/engineering/risk/src/index.js +120 -0
- package/dist/packages/graph/src/index.d.ts +23 -1
- package/dist/packages/graph/src/index.js +88 -15
- package/dist/packages/llm/src/index.js +27 -4
- package/dist/packages/mcp/src/index.js +27 -8
- package/dist/packages/orchestration/src/index.d.ts +11 -1
- package/dist/packages/orchestration/src/index.js +34 -7
- package/dist/packages/policy/src/index.d.ts +40 -0
- package/dist/packages/policy/src/index.js +39 -4
- package/dist/packages/runtime/src/index.js +3 -0
- package/dist/packages/sandbox/src/index.d.ts +47 -0
- package/dist/packages/sandbox/src/index.js +59 -0
- package/dist/packages/validator/src/index.d.ts +8 -0
- package/dist/packages/validator/src/index.js +21 -6
- package/dist/scripts/adr.d.ts +17 -0
- package/dist/scripts/adr.js +152 -0
- package/dist/scripts/agent-harness.js +72 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/agent.d.ts +27 -0
- package/dist/scripts/agent.js +249 -0
- package/dist/scripts/architecture.d.ts +16 -0
- package/dist/scripts/architecture.js +186 -0
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/cost-economy.d.ts +2 -0
- package/dist/scripts/cost-economy.js +79 -0
- package/dist/scripts/demo-autonomy.js +13 -6
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/drift-check.d.ts +17 -0
- package/dist/scripts/drift-check.js +63 -0
- package/dist/scripts/engineer.d.ts +20 -0
- package/dist/scripts/engineer.js +208 -0
- package/dist/scripts/evidence.d.ts +12 -0
- package/dist/scripts/evidence.js +55 -0
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/gates.d.ts +6 -2
- package/dist/scripts/gates.js +14 -4
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/incident.d.ts +19 -0
- package/dist/scripts/incident.js +103 -0
- package/dist/scripts/llm-fit.js +32 -3
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/provenance.d.ts +14 -0
- package/dist/scripts/provenance.js +114 -0
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/risk.d.ts +15 -0
- package/dist/scripts/risk.js +81 -0
- package/dist/scripts/simulate.d.ts +20 -0
- package/dist/scripts/simulate.js +150 -0
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +44 -44
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +20 -20
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
- package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
- package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -157
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/agent-identity-reputation/plan.md +133 -0
- package/specs/agent-identity-reputation/spec.md +125 -0
- package/specs/agent-identity-reputation/tasks.md +51 -0
- package/specs/agent-runtime-monitoring/plan.md +78 -0
- package/specs/agent-runtime-monitoring/spec.md +92 -0
- package/specs/agent-runtime-monitoring/tasks.md +39 -0
- package/specs/ai-code-provenance/plan.md +71 -0
- package/specs/ai-code-provenance/spec.md +97 -0
- package/specs/ai-code-provenance/tasks.md +39 -0
- package/specs/architecture-constitution/plan.md +110 -0
- package/specs/architecture-constitution/spec.md +114 -0
- package/specs/architecture-constitution/tasks.md +58 -0
- package/specs/change-risk-engine/plan.md +130 -0
- package/specs/change-risk-engine/spec.md +119 -0
- package/specs/change-risk-engine/tasks.md +72 -0
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/cost-aware-autonomy-budget/spec.md +102 -0
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/drift-sentinel/spec.md +117 -0
- package/specs/engineer-facade-extension/plan.md +71 -0
- package/specs/engineer-facade-extension/spec.md +98 -0
- package/specs/engineer-facade-extension/tasks.md +36 -0
- package/specs/engineering-evidence-ledger/plan.md +121 -0
- package/specs/engineering-evidence-ledger/spec.md +90 -0
- package/specs/engineering-evidence-ledger/tasks.md +54 -0
- package/specs/engineering-graph-extensions/plan.md +92 -0
- package/specs/engineering-graph-extensions/spec.md +101 -0
- package/specs/engineering-graph-extensions/tasks.md +60 -0
- package/specs/engineering-intelligence/spec.md +177 -0
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/learning-loop-incidents/plan.md +59 -0
- package/specs/learning-loop-incidents/spec.md +93 -0
- package/specs/learning-loop-incidents/tasks.md +36 -0
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/predictive-change-simulation/plan.md +109 -0
- package/specs/predictive-change-simulation/spec.md +107 -0
- package/specs/predictive-change-simulation/tasks.md +41 -0
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/spec.md +23 -23
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/smart-agent-routing/plan.md +55 -0
- package/specs/smart-agent-routing/spec.md +85 -0
- package/specs/smart-agent-routing/tasks.md +26 -0
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
|
@@ -1,141 +1,141 @@
|
|
|
1
|
-
# Política de Contexto & Gestão de Memória
|
|
2
|
-
|
|
3
|
-
## 1. Estrutura de Níveis
|
|
4
|
-
|
|
5
|
-
A memória está organizada em 10 níveis que crescem em especificidade:
|
|
6
|
-
|
|
7
|
-
| Nível | Escopo | Uso |
|
|
8
|
-
|-------|--------|-----|
|
|
9
|
-
| 00 | Global | Mission, patterns, policies |
|
|
10
|
-
| 10 | Product | Visão, personas, regras |
|
|
11
|
-
| 20 | Architecture | Decisões técnicas |
|
|
12
|
-
| 30 | Domains | Context por domínio de negócio |
|
|
13
|
-
| 40 | Delivery | Roadmap, sprints |
|
|
14
|
-
| 50 | Orchestration | Topologia de agents |
|
|
15
|
-
| 60 | Runs | Logs de execução |
|
|
16
|
-
| 70 | Summaries | Sínteses executivas |
|
|
17
|
-
| 80 | Data | Schemas, migrations |
|
|
18
|
-
| 90 | Decisions | ADRs (Architecture Decision Records) |
|
|
19
|
-
|
|
20
|
-
## 2. Fluxo de Leitura de Context
|
|
21
|
-
|
|
22
|
-
**Ordem de prioridade** para agente decidir ação:
|
|
23
|
-
1. Domínio específico (30-domains/X/)
|
|
24
|
-
2. Architecture decisão (20-architecture/)
|
|
25
|
-
3. Padrões globais (00-global/patterns.md)
|
|
26
|
-
4. Regras de produto (10-product/business-rules.md)
|
|
27
|
-
|
|
28
|
-
**Exemplo**: Para implementar "upgrade de subscription":
|
|
29
|
-
1. Ler `30-domains/subscriptions/context.md` (o que é upgrade aqui)
|
|
30
|
-
2. Ler `30-domains/billing/context.md` (impacto no billing)
|
|
31
|
-
3. Ler `20-architecture/backend.md` (padrão de implementação)
|
|
32
|
-
4. Aplicar padrão de service/controller de `patterns.md`
|
|
33
|
-
|
|
34
|
-
## 3. Gestão de Estado em Runs
|
|
35
|
-
|
|
36
|
-
Cada execução de agente registra:
|
|
37
|
-
|
|
38
|
-
```
|
|
39
|
-
60-runs/
|
|
40
|
-
├── 2024-01-15-auth-setup.md
|
|
41
|
-
├── 2024-01-15-subscription-endpoint.md
|
|
42
|
-
└── index.md (lista de todas as runs)
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
**Formato de run:**
|
|
46
|
-
```markdown
|
|
47
|
-
# Auth Setup - 2024-01-15 10:30:00
|
|
48
|
-
|
|
49
|
-
## Agente
|
|
50
|
-
Setup Agent
|
|
51
|
-
|
|
52
|
-
## Tarefa
|
|
53
|
-
Inicializar módulo de autenticação
|
|
54
|
-
|
|
55
|
-
## Output
|
|
56
|
-
- ✅ JWT config criado
|
|
57
|
-
- ✅ Local strategy implementada
|
|
58
|
-
- ✅ Login endpoint funcional
|
|
59
|
-
|
|
60
|
-
## Issues
|
|
61
|
-
- Nenhum
|
|
62
|
-
|
|
63
|
-
## Próximos passos
|
|
64
|
-
- Implementar refresh token
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## 4. Atualização de Summaries
|
|
68
|
-
|
|
69
|
-
**Global summary** (`70-summaries/global.md`):
|
|
70
|
-
- Atualizado diariamente
|
|
71
|
-
- Lista funcionalidades implementadas
|
|
72
|
-
- Identifica bloqueadores
|
|
73
|
-
|
|
74
|
-
**Domain summaries** (`70-summaries/{domain}.md`):
|
|
75
|
-
- Atualizado quando módulo completa feature
|
|
76
|
-
- Estado de cada endpoint
|
|
77
|
-
- Issues conhecidas
|
|
78
|
-
|
|
79
|
-
## 5. Versionamento de Memória
|
|
80
|
-
|
|
81
|
-
Quando política muda:
|
|
82
|
-
1. Criar ADR em `90-decisions/adr-YYYYMMDD-{titulo}.md`
|
|
83
|
-
2. Atualizar arquivo afetado com timestamp
|
|
84
|
-
3. Registrar em `90-decisions/index.md`
|
|
85
|
-
|
|
86
|
-
**Exemplo de ADR:**
|
|
87
|
-
```
|
|
88
|
-
# ADR-20240115-001: JWT expiry strategy
|
|
89
|
-
|
|
90
|
-
## Context
|
|
91
|
-
Tokens devem expirar, mas user experience deve ser suave
|
|
92
|
-
|
|
93
|
-
## Decision
|
|
94
|
-
- Access token: 15 minutos
|
|
95
|
-
- Refresh token: 7 dias
|
|
96
|
-
- Silent refresh em background
|
|
97
|
-
|
|
98
|
-
## Consequences
|
|
99
|
-
- Melhor segurança, mais chamadas à API
|
|
100
|
-
- Melhor UX com refresh automático
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
## 6. Quem Atualiza Cada Seção
|
|
104
|
-
|
|
105
|
-
| Seção | Quem |
|
|
106
|
-
|-------|-----|
|
|
107
|
-
| 00-global | Tech lead, architect |
|
|
108
|
-
| 10-product | Product manager, PO |
|
|
109
|
-
| 20-architecture | Tech lead |
|
|
110
|
-
| 30-domains | Agentes de domínio |
|
|
111
|
-
| 40-delivery | Scrum master, tech lead |
|
|
112
|
-
| 50-orchestration | Tech lead, setup agent |
|
|
113
|
-
| 60-runs | Cada agente após execução |
|
|
114
|
-
| 70-summaries | Summary agent (rotina diária) |
|
|
115
|
-
| 80-data | Data agent, migrations |
|
|
116
|
-
| 90-decisions | Tech lead, architect |
|
|
117
|
-
|
|
118
|
-
## 7. Context Freshness
|
|
119
|
-
|
|
120
|
-
**Staleness rules:**
|
|
121
|
-
- Padrões (00-global): OK até 3 meses sem atualização
|
|
122
|
-
- Domain context (30-domains): AVISO se > 1 sprint
|
|
123
|
-
- Runs (60-runs): OBRIGATÓRIO após cada execução
|
|
124
|
-
- Summaries: AVISO se > 1 dia
|
|
125
|
-
- Decisions: Nunca ficam obsoletos (imutáveis)
|
|
126
|
-
|
|
127
|
-
## 8. Limpeza de Contexto
|
|
128
|
-
|
|
129
|
-
Trimestral:
|
|
130
|
-
1. Arquivar runs antigas (60-runs → 60-runs/archive/)
|
|
131
|
-
2. Consolidar learnings em 70-summaries
|
|
132
|
-
3. Atualizar ADRs obsoletos
|
|
133
|
-
4. Verificar alinhamento de 10-product com 30-domains
|
|
134
|
-
|
|
135
|
-
## 9. Conflitos de Contexto
|
|
136
|
-
|
|
137
|
-
Se dois documentos dizem coisas diferentes:
|
|
138
|
-
1. Ordem de precedência: Decisão > Domain > Architecture > Pattern
|
|
139
|
-
2. ADR mais recente vence
|
|
140
|
-
3. Registrar conflito em `90-decisions/conflicts.md`
|
|
141
|
-
4. Resolver em pair programming ou architecture review
|
|
1
|
+
# Política de Contexto & Gestão de Memória
|
|
2
|
+
|
|
3
|
+
## 1. Estrutura de Níveis
|
|
4
|
+
|
|
5
|
+
A memória está organizada em 10 níveis que crescem em especificidade:
|
|
6
|
+
|
|
7
|
+
| Nível | Escopo | Uso |
|
|
8
|
+
|-------|--------|-----|
|
|
9
|
+
| 00 | Global | Mission, patterns, policies |
|
|
10
|
+
| 10 | Product | Visão, personas, regras |
|
|
11
|
+
| 20 | Architecture | Decisões técnicas |
|
|
12
|
+
| 30 | Domains | Context por domínio de negócio |
|
|
13
|
+
| 40 | Delivery | Roadmap, sprints |
|
|
14
|
+
| 50 | Orchestration | Topologia de agents |
|
|
15
|
+
| 60 | Runs | Logs de execução |
|
|
16
|
+
| 70 | Summaries | Sínteses executivas |
|
|
17
|
+
| 80 | Data | Schemas, migrations |
|
|
18
|
+
| 90 | Decisions | ADRs (Architecture Decision Records) |
|
|
19
|
+
|
|
20
|
+
## 2. Fluxo de Leitura de Context
|
|
21
|
+
|
|
22
|
+
**Ordem de prioridade** para agente decidir ação:
|
|
23
|
+
1. Domínio específico (30-domains/X/)
|
|
24
|
+
2. Architecture decisão (20-architecture/)
|
|
25
|
+
3. Padrões globais (00-global/patterns.md)
|
|
26
|
+
4. Regras de produto (10-product/business-rules.md)
|
|
27
|
+
|
|
28
|
+
**Exemplo**: Para implementar "upgrade de subscription":
|
|
29
|
+
1. Ler `30-domains/subscriptions/context.md` (o que é upgrade aqui)
|
|
30
|
+
2. Ler `30-domains/billing/context.md` (impacto no billing)
|
|
31
|
+
3. Ler `20-architecture/backend.md` (padrão de implementação)
|
|
32
|
+
4. Aplicar padrão de service/controller de `patterns.md`
|
|
33
|
+
|
|
34
|
+
## 3. Gestão de Estado em Runs
|
|
35
|
+
|
|
36
|
+
Cada execução de agente registra:
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
60-runs/
|
|
40
|
+
├── 2024-01-15-auth-setup.md
|
|
41
|
+
├── 2024-01-15-subscription-endpoint.md
|
|
42
|
+
└── index.md (lista de todas as runs)
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**Formato de run:**
|
|
46
|
+
```markdown
|
|
47
|
+
# Auth Setup - 2024-01-15 10:30:00
|
|
48
|
+
|
|
49
|
+
## Agente
|
|
50
|
+
Setup Agent
|
|
51
|
+
|
|
52
|
+
## Tarefa
|
|
53
|
+
Inicializar módulo de autenticação
|
|
54
|
+
|
|
55
|
+
## Output
|
|
56
|
+
- ✅ JWT config criado
|
|
57
|
+
- ✅ Local strategy implementada
|
|
58
|
+
- ✅ Login endpoint funcional
|
|
59
|
+
|
|
60
|
+
## Issues
|
|
61
|
+
- Nenhum
|
|
62
|
+
|
|
63
|
+
## Próximos passos
|
|
64
|
+
- Implementar refresh token
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## 4. Atualização de Summaries
|
|
68
|
+
|
|
69
|
+
**Global summary** (`70-summaries/global.md`):
|
|
70
|
+
- Atualizado diariamente
|
|
71
|
+
- Lista funcionalidades implementadas
|
|
72
|
+
- Identifica bloqueadores
|
|
73
|
+
|
|
74
|
+
**Domain summaries** (`70-summaries/{domain}.md`):
|
|
75
|
+
- Atualizado quando módulo completa feature
|
|
76
|
+
- Estado de cada endpoint
|
|
77
|
+
- Issues conhecidas
|
|
78
|
+
|
|
79
|
+
## 5. Versionamento de Memória
|
|
80
|
+
|
|
81
|
+
Quando política muda:
|
|
82
|
+
1. Criar ADR em `90-decisions/adr-YYYYMMDD-{titulo}.md`
|
|
83
|
+
2. Atualizar arquivo afetado com timestamp
|
|
84
|
+
3. Registrar em `90-decisions/index.md`
|
|
85
|
+
|
|
86
|
+
**Exemplo de ADR:**
|
|
87
|
+
```
|
|
88
|
+
# ADR-20240115-001: JWT expiry strategy
|
|
89
|
+
|
|
90
|
+
## Context
|
|
91
|
+
Tokens devem expirar, mas user experience deve ser suave
|
|
92
|
+
|
|
93
|
+
## Decision
|
|
94
|
+
- Access token: 15 minutos
|
|
95
|
+
- Refresh token: 7 dias
|
|
96
|
+
- Silent refresh em background
|
|
97
|
+
|
|
98
|
+
## Consequences
|
|
99
|
+
- Melhor segurança, mais chamadas à API
|
|
100
|
+
- Melhor UX com refresh automático
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## 6. Quem Atualiza Cada Seção
|
|
104
|
+
|
|
105
|
+
| Seção | Quem |
|
|
106
|
+
|-------|-----|
|
|
107
|
+
| 00-global | Tech lead, architect |
|
|
108
|
+
| 10-product | Product manager, PO |
|
|
109
|
+
| 20-architecture | Tech lead |
|
|
110
|
+
| 30-domains | Agentes de domínio |
|
|
111
|
+
| 40-delivery | Scrum master, tech lead |
|
|
112
|
+
| 50-orchestration | Tech lead, setup agent |
|
|
113
|
+
| 60-runs | Cada agente após execução |
|
|
114
|
+
| 70-summaries | Summary agent (rotina diária) |
|
|
115
|
+
| 80-data | Data agent, migrations |
|
|
116
|
+
| 90-decisions | Tech lead, architect |
|
|
117
|
+
|
|
118
|
+
## 7. Context Freshness
|
|
119
|
+
|
|
120
|
+
**Staleness rules:**
|
|
121
|
+
- Padrões (00-global): OK até 3 meses sem atualização
|
|
122
|
+
- Domain context (30-domains): AVISO se > 1 sprint
|
|
123
|
+
- Runs (60-runs): OBRIGATÓRIO após cada execução
|
|
124
|
+
- Summaries: AVISO se > 1 dia
|
|
125
|
+
- Decisions: Nunca ficam obsoletos (imutáveis)
|
|
126
|
+
|
|
127
|
+
## 8. Limpeza de Contexto
|
|
128
|
+
|
|
129
|
+
Trimestral:
|
|
130
|
+
1. Arquivar runs antigas (60-runs → 60-runs/archive/)
|
|
131
|
+
2. Consolidar learnings em 70-summaries
|
|
132
|
+
3. Atualizar ADRs obsoletos
|
|
133
|
+
4. Verificar alinhamento de 10-product com 30-domains
|
|
134
|
+
|
|
135
|
+
## 9. Conflitos de Contexto
|
|
136
|
+
|
|
137
|
+
Se dois documentos dizem coisas diferentes:
|
|
138
|
+
1. Ordem de precedência: Decisão > Domain > Architecture > Pattern
|
|
139
|
+
2. ADR mais recente vence
|
|
140
|
+
3. Registrar conflito em `90-decisions/conflicts.md`
|
|
141
|
+
4. Resolver em pair programming ou architecture review
|
|
@@ -1,133 +1,133 @@
|
|
|
1
|
-
# Índice de Memória - SaaS Starter
|
|
2
|
-
|
|
3
|
-
## Navegação Rápida
|
|
4
|
-
|
|
5
|
-
### 00-Global (Políticas & Princípios)
|
|
6
|
-
- **[mission.md](./mission.md)** — Visão, objetivos, papéis de agentes
|
|
7
|
-
- **[patterns.md](./patterns.md)** — Code patterns, conventions, testing
|
|
8
|
-
- **[context-policy.md](./context-policy.md)** — Gestão de níveis, freshness, limpeza
|
|
9
|
-
- **[agent-contract.md](./agent-contract.md)** — Ciclo de vida, responsabilidades, handoffs
|
|
10
|
-
- **[index.md](./index.md)** — Este arquivo
|
|
11
|
-
|
|
12
|
-
### 10-Product (Visão & Regras)
|
|
13
|
-
- **vision.md** — Proposta de valor, diferencial
|
|
14
|
-
- **personas.md** — Buyer persona, user scenarios
|
|
15
|
-
- **business-rules.md** — Rules engine, compliance
|
|
16
|
-
- **nfrs.md** — Performance, scalability, security requirements
|
|
17
|
-
|
|
18
|
-
### 20-Architecture (Decisões Técnicas)
|
|
19
|
-
- **overview.md** — Diagrama de arquitetura, stack
|
|
20
|
-
- **frontend.md** — Stack frontend, componentes, state
|
|
21
|
-
- **backend.md** — NestJS, modules, database strategy
|
|
22
|
-
- **data.md** — PostgreSQL schema, indexing strategy
|
|
23
|
-
- **security.md** — JWT, RBAC, encryption, PII
|
|
24
|
-
- **observability.md** — Logging, metrics, tracing
|
|
25
|
-
|
|
26
|
-
### 30-Domains (Domínios de Negócio)
|
|
27
|
-
- **auth/context.md** — O que é auth aqui, fluxo
|
|
28
|
-
- **auth/api.md** — Endpoints, contratos, errors
|
|
29
|
-
- **subscriptions/context.md** — Planos, transições, regras
|
|
30
|
-
- **subscriptions/api.md** — Endpoints de subscriptions
|
|
31
|
-
- **billing/context.md** — Pagamentos, invoices, refunds
|
|
32
|
-
- **billing/api.md** — Endpoints de billing
|
|
33
|
-
|
|
34
|
-
### 40-Delivery (Roadmap & Sprints)
|
|
35
|
-
- **roadmap.md** — 6+ months vision
|
|
36
|
-
- **sprint-atual.md** — Sprint atual, tasks, burndown
|
|
37
|
-
- **backlog.md** — Product backlog, priorização
|
|
38
|
-
|
|
39
|
-
### 50-Orchestration (Topologia de Agents)
|
|
40
|
-
- **topology.md** — Quais agents, quando, em que ordem
|
|
41
|
-
- **routing.md** — Como agentes se descobrem
|
|
42
|
-
- **handoff-protocol.md** — Formato, timing, escalation
|
|
43
|
-
- **playbook-paralelo.md** — Como executar 2+ agents em paralelo
|
|
44
|
-
- **handoffs/ directory** — Histórico de handoffs
|
|
45
|
-
|
|
46
|
-
### 60-Runs (Logs de Execução)
|
|
47
|
-
- **index.md** — Lista de todas as runs
|
|
48
|
-
- **YYYY-MM-DD-agent-task.md** — Run log individual
|
|
49
|
-
- **YYYY-MM-DD-ERROR.md** — Logs de erro
|
|
50
|
-
|
|
51
|
-
### 70-Summaries (Sínteses Executivas)
|
|
52
|
-
- **global.md** — Status geral, funcionalidades implementadas, bloqueadores
|
|
53
|
-
- **auth.md** — Status módulo auth, endpoints ready
|
|
54
|
-
- **subscriptions.md** — Status subscriptions, issues
|
|
55
|
-
- **billing.md** — Status billing, payment gateway
|
|
56
|
-
|
|
57
|
-
### 80-Data (Schemas & Migrations)
|
|
58
|
-
- **schema.md** — Entidades PostgreSQL, relationships
|
|
59
|
-
- **migrations/ directory** — Histórico de migrations
|
|
60
|
-
- **seeds/ directory** — Seed data
|
|
61
|
-
|
|
62
|
-
### 90-Decisions (ADRs - Architecture Decision Records)
|
|
63
|
-
- **adr-template.md** — Template para novas decisões
|
|
64
|
-
- **adr-YYYYMMDD-*.md** — Decisões arquiteturais
|
|
65
|
-
- **index.md** — Índice de ADRs
|
|
66
|
-
- **conflicts.md** — Conflitos e resoluções
|
|
67
|
-
|
|
68
|
-
## Fluxo de Leitura por Cenário
|
|
69
|
-
|
|
70
|
-
### Cenário 1: Novo agente começa tarefa
|
|
71
|
-
1. Ler level 30 (domain específico)
|
|
72
|
-
2. Ler level 20 (architecture)
|
|
73
|
-
3. Ler level 00 (patterns)
|
|
74
|
-
4. Verificar 40-delivery para status
|
|
75
|
-
5. Executar tarefa
|
|
76
|
-
6. Documentar em 60-runs
|
|
77
|
-
|
|
78
|
-
### Cenário 2: Debug de issue
|
|
79
|
-
1. Procurar em 60-runs (problema similar?)
|
|
80
|
-
2. Verificar ADR em 90-decisions (decisão relevante?)
|
|
81
|
-
3. Consultar domain context em 30-domains
|
|
82
|
-
4. Criar ADR se nova decisão necessária
|
|
83
|
-
|
|
84
|
-
### Cenário 3: Atualizar visão de produto
|
|
85
|
-
1. Editar 10-product/
|
|
86
|
-
2. Criar ADR em 90-decisions
|
|
87
|
-
3. Registrar em 70-summaries/global.md
|
|
88
|
-
|
|
89
|
-
### Cenário 4: Escalação de bloqueador
|
|
90
|
-
1. Documentar issue em 60-runs/ERROR.md
|
|
91
|
-
2. Registrar dependência em 40-delivery/backlog.md
|
|
92
|
-
3. Criar ADR se decisão necessária
|
|
93
|
-
4. Notificar responsável
|
|
94
|
-
|
|
95
|
-
## Queries Rápidas
|
|
96
|
-
|
|
97
|
-
**"Qual é o status do auth module?"**
|
|
98
|
-
→ Ler `70-summaries/auth.md`
|
|
99
|
-
|
|
100
|
-
**"Como implementar novo endpoint?"**
|
|
101
|
-
→ Ler `00-global/patterns.md` + `20-architecture/backend.md`
|
|
102
|
-
|
|
103
|
-
**"Qual é o próximo agente?"**
|
|
104
|
-
→ Ler `40-delivery/sprint-atual.md` + `50-orchestration/topology.md`
|
|
105
|
-
|
|
106
|
-
**"Por que escolhemos PostgreSQL?"**
|
|
107
|
-
→ Buscar ADR em `90-decisions/`
|
|
108
|
-
|
|
109
|
-
**"O que significa tenant isolation?"**
|
|
110
|
-
→ Ler `20-architecture/security.md` + `30-domains/auth/context.md`
|
|
111
|
-
|
|
112
|
-
**"Como fazer handoff?"**
|
|
113
|
-
→ Ler `50-orchestration/handoff-protocol.md` (template em `agent-contract.md`)
|
|
114
|
-
|
|
115
|
-
## Atualização Frequência
|
|
116
|
-
|
|
117
|
-
| Nível | Frequência | Responsável |
|
|
118
|
-
|-------|-----------|-------------|
|
|
119
|
-
| 00 | Trimestral | Tech lead |
|
|
120
|
-
| 10 | Mensal | Product |
|
|
121
|
-
| 20 | Conforme necessário | Tech lead |
|
|
122
|
-
| 30 | Cada agente concluindo | Agentes |
|
|
123
|
-
| 40 | Semanal | Scrum master |
|
|
124
|
-
| 50 | Cada handoff | Agente completando |
|
|
125
|
-
| 60 | Cada execução | Agente executando |
|
|
126
|
-
| 70 | Diário | Summary agent |
|
|
127
|
-
| 80 | Com migrations | Data agent |
|
|
128
|
-
| 90 | Decisões imutáveis | Tech lead |
|
|
129
|
-
|
|
130
|
-
## Last Updated
|
|
131
|
-
- **Date**: 2024-01-15
|
|
132
|
-
- **By**: SaaS Starter Scaffold
|
|
133
|
-
- **Next Review**: 2024-02-15
|
|
1
|
+
# Índice de Memória - SaaS Starter
|
|
2
|
+
|
|
3
|
+
## Navegação Rápida
|
|
4
|
+
|
|
5
|
+
### 00-Global (Políticas & Princípios)
|
|
6
|
+
- **[mission.md](./mission.md)** — Visão, objetivos, papéis de agentes
|
|
7
|
+
- **[patterns.md](./patterns.md)** — Code patterns, conventions, testing
|
|
8
|
+
- **[context-policy.md](./context-policy.md)** — Gestão de níveis, freshness, limpeza
|
|
9
|
+
- **[agent-contract.md](./agent-contract.md)** — Ciclo de vida, responsabilidades, handoffs
|
|
10
|
+
- **[index.md](./index.md)** — Este arquivo
|
|
11
|
+
|
|
12
|
+
### 10-Product (Visão & Regras)
|
|
13
|
+
- **vision.md** — Proposta de valor, diferencial
|
|
14
|
+
- **personas.md** — Buyer persona, user scenarios
|
|
15
|
+
- **business-rules.md** — Rules engine, compliance
|
|
16
|
+
- **nfrs.md** — Performance, scalability, security requirements
|
|
17
|
+
|
|
18
|
+
### 20-Architecture (Decisões Técnicas)
|
|
19
|
+
- **overview.md** — Diagrama de arquitetura, stack
|
|
20
|
+
- **frontend.md** — Stack frontend, componentes, state
|
|
21
|
+
- **backend.md** — NestJS, modules, database strategy
|
|
22
|
+
- **data.md** — PostgreSQL schema, indexing strategy
|
|
23
|
+
- **security.md** — JWT, RBAC, encryption, PII
|
|
24
|
+
- **observability.md** — Logging, metrics, tracing
|
|
25
|
+
|
|
26
|
+
### 30-Domains (Domínios de Negócio)
|
|
27
|
+
- **auth/context.md** — O que é auth aqui, fluxo
|
|
28
|
+
- **auth/api.md** — Endpoints, contratos, errors
|
|
29
|
+
- **subscriptions/context.md** — Planos, transições, regras
|
|
30
|
+
- **subscriptions/api.md** — Endpoints de subscriptions
|
|
31
|
+
- **billing/context.md** — Pagamentos, invoices, refunds
|
|
32
|
+
- **billing/api.md** — Endpoints de billing
|
|
33
|
+
|
|
34
|
+
### 40-Delivery (Roadmap & Sprints)
|
|
35
|
+
- **roadmap.md** — 6+ months vision
|
|
36
|
+
- **sprint-atual.md** — Sprint atual, tasks, burndown
|
|
37
|
+
- **backlog.md** — Product backlog, priorização
|
|
38
|
+
|
|
39
|
+
### 50-Orchestration (Topologia de Agents)
|
|
40
|
+
- **topology.md** — Quais agents, quando, em que ordem
|
|
41
|
+
- **routing.md** — Como agentes se descobrem
|
|
42
|
+
- **handoff-protocol.md** — Formato, timing, escalation
|
|
43
|
+
- **playbook-paralelo.md** — Como executar 2+ agents em paralelo
|
|
44
|
+
- **handoffs/ directory** — Histórico de handoffs
|
|
45
|
+
|
|
46
|
+
### 60-Runs (Logs de Execução)
|
|
47
|
+
- **index.md** — Lista de todas as runs
|
|
48
|
+
- **YYYY-MM-DD-agent-task.md** — Run log individual
|
|
49
|
+
- **YYYY-MM-DD-ERROR.md** — Logs de erro
|
|
50
|
+
|
|
51
|
+
### 70-Summaries (Sínteses Executivas)
|
|
52
|
+
- **global.md** — Status geral, funcionalidades implementadas, bloqueadores
|
|
53
|
+
- **auth.md** — Status módulo auth, endpoints ready
|
|
54
|
+
- **subscriptions.md** — Status subscriptions, issues
|
|
55
|
+
- **billing.md** — Status billing, payment gateway
|
|
56
|
+
|
|
57
|
+
### 80-Data (Schemas & Migrations)
|
|
58
|
+
- **schema.md** — Entidades PostgreSQL, relationships
|
|
59
|
+
- **migrations/ directory** — Histórico de migrations
|
|
60
|
+
- **seeds/ directory** — Seed data
|
|
61
|
+
|
|
62
|
+
### 90-Decisions (ADRs - Architecture Decision Records)
|
|
63
|
+
- **adr-template.md** — Template para novas decisões
|
|
64
|
+
- **adr-YYYYMMDD-*.md** — Decisões arquiteturais
|
|
65
|
+
- **index.md** — Índice de ADRs
|
|
66
|
+
- **conflicts.md** — Conflitos e resoluções
|
|
67
|
+
|
|
68
|
+
## Fluxo de Leitura por Cenário
|
|
69
|
+
|
|
70
|
+
### Cenário 1: Novo agente começa tarefa
|
|
71
|
+
1. Ler level 30 (domain específico)
|
|
72
|
+
2. Ler level 20 (architecture)
|
|
73
|
+
3. Ler level 00 (patterns)
|
|
74
|
+
4. Verificar 40-delivery para status
|
|
75
|
+
5. Executar tarefa
|
|
76
|
+
6. Documentar em 60-runs
|
|
77
|
+
|
|
78
|
+
### Cenário 2: Debug de issue
|
|
79
|
+
1. Procurar em 60-runs (problema similar?)
|
|
80
|
+
2. Verificar ADR em 90-decisions (decisão relevante?)
|
|
81
|
+
3. Consultar domain context em 30-domains
|
|
82
|
+
4. Criar ADR se nova decisão necessária
|
|
83
|
+
|
|
84
|
+
### Cenário 3: Atualizar visão de produto
|
|
85
|
+
1. Editar 10-product/
|
|
86
|
+
2. Criar ADR em 90-decisions
|
|
87
|
+
3. Registrar em 70-summaries/global.md
|
|
88
|
+
|
|
89
|
+
### Cenário 4: Escalação de bloqueador
|
|
90
|
+
1. Documentar issue em 60-runs/ERROR.md
|
|
91
|
+
2. Registrar dependência em 40-delivery/backlog.md
|
|
92
|
+
3. Criar ADR se decisão necessária
|
|
93
|
+
4. Notificar responsável
|
|
94
|
+
|
|
95
|
+
## Queries Rápidas
|
|
96
|
+
|
|
97
|
+
**"Qual é o status do auth module?"**
|
|
98
|
+
→ Ler `70-summaries/auth.md`
|
|
99
|
+
|
|
100
|
+
**"Como implementar novo endpoint?"**
|
|
101
|
+
→ Ler `00-global/patterns.md` + `20-architecture/backend.md`
|
|
102
|
+
|
|
103
|
+
**"Qual é o próximo agente?"**
|
|
104
|
+
→ Ler `40-delivery/sprint-atual.md` + `50-orchestration/topology.md`
|
|
105
|
+
|
|
106
|
+
**"Por que escolhemos PostgreSQL?"**
|
|
107
|
+
→ Buscar ADR em `90-decisions/`
|
|
108
|
+
|
|
109
|
+
**"O que significa tenant isolation?"**
|
|
110
|
+
→ Ler `20-architecture/security.md` + `30-domains/auth/context.md`
|
|
111
|
+
|
|
112
|
+
**"Como fazer handoff?"**
|
|
113
|
+
→ Ler `50-orchestration/handoff-protocol.md` (template em `agent-contract.md`)
|
|
114
|
+
|
|
115
|
+
## Atualização Frequência
|
|
116
|
+
|
|
117
|
+
| Nível | Frequência | Responsável |
|
|
118
|
+
|-------|-----------|-------------|
|
|
119
|
+
| 00 | Trimestral | Tech lead |
|
|
120
|
+
| 10 | Mensal | Product |
|
|
121
|
+
| 20 | Conforme necessário | Tech lead |
|
|
122
|
+
| 30 | Cada agente concluindo | Agentes |
|
|
123
|
+
| 40 | Semanal | Scrum master |
|
|
124
|
+
| 50 | Cada handoff | Agente completando |
|
|
125
|
+
| 60 | Cada execução | Agente executando |
|
|
126
|
+
| 70 | Diário | Summary agent |
|
|
127
|
+
| 80 | Com migrations | Data agent |
|
|
128
|
+
| 90 | Decisões imutáveis | Tech lead |
|
|
129
|
+
|
|
130
|
+
## Last Updated
|
|
131
|
+
- **Date**: 2024-01-15
|
|
132
|
+
- **By**: SaaS Starter Scaffold
|
|
133
|
+
- **Next Review**: 2024-02-15
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# Missão do Projeto SaaS Starter
|
|
2
|
-
|
|
3
|
-
## Visão Geral
|
|
4
|
-
|
|
5
|
-
Fornecer uma plataforma SaaS multi-tenant, escalável e pronta para produção que:
|
|
6
|
-
|
|
7
|
-
1. **Autenticação & Autorização**: JWT-based com RBAC (roles: owner, admin, member)
|
|
8
|
-
2. **Subscription Management**: Planos (free, pro, enterprise) com gerenciamento automático
|
|
9
|
-
3. **Billing & Payments**: Integração mock com sistemas de pagamento (Stripe-like)
|
|
10
|
-
4. **Multi-Tenancy**: Isolamento seguro de dados por organização
|
|
11
|
-
5. **Observabilidade**: Logs estruturados e métricas para decisões operacionais
|
|
12
|
-
|
|
13
|
-
## Princípios Fundamentais
|
|
14
|
-
|
|
15
|
-
| Princípio | Descrição |
|
|
16
|
-
|-----------|-----------|
|
|
17
|
-
| **Multi-Tenant First** | Cada organização é isolada em camada de data e contexto |
|
|
18
|
-
| **Security by Default** | JWT + Rate limiting + Input validation em todas as rotas |
|
|
19
|
-
| **Scalability Ready** | Arquitetura preparada para PostgreSQL + Redis |
|
|
20
|
-
| **Developer Experience** | NestJS + TypeScript com tipagem forte e injeção de dependências |
|
|
21
|
-
| **Testabilidade** | Testes E2E para fluxos críticos (auth, subscriptions, billing) |
|
|
22
|
-
|
|
23
|
-
## Objetivos Imediatos
|
|
24
|
-
|
|
25
|
-
1. Gerar scaffold completo com módulos SaaS funcionais
|
|
26
|
-
2. Fornecer exemplos de endpoints para Auth, Subscriptions e Billing
|
|
27
|
-
3. Documentar fluxos de signup, subscription upgrade, e pagamento
|
|
28
|
-
4. Incluir testes E2E para os fluxos críticos
|
|
29
|
-
5. Docker-compose com PostgreSQL + Redis preconfigurado
|
|
30
|
-
|
|
31
|
-
## Papéis de Agentes
|
|
32
|
-
|
|
33
|
-
| Agente | Responsabilidade |
|
|
34
|
-
|--------|-----------------|
|
|
35
|
-
| **Setup Agent** | Inicializar projeto, criar schemas, seedar dados |
|
|
36
|
-
| **Auth Agent** | Validar JWT, gerenciar permissões RBAC |
|
|
37
|
-
| **Subscription Agent** | Gerenciar planos e upgrades |
|
|
38
|
-
| **Billing Agent** | Processar pagamentos (mock) e gerar invoices |
|
|
39
|
-
| **Analytics Agent** | Rastrear eventos de negócio e métricas |
|
|
40
|
-
|
|
41
|
-
## Status
|
|
42
|
-
|
|
43
|
-
- ✅ Estrutura de memória criada
|
|
44
|
-
- ✅ Backend NestJS inicializado
|
|
45
|
-
- 🚀 Pronto para integração de agents
|
|
1
|
+
# Missão do Projeto SaaS Starter
|
|
2
|
+
|
|
3
|
+
## Visão Geral
|
|
4
|
+
|
|
5
|
+
Fornecer uma plataforma SaaS multi-tenant, escalável e pronta para produção que:
|
|
6
|
+
|
|
7
|
+
1. **Autenticação & Autorização**: JWT-based com RBAC (roles: owner, admin, member)
|
|
8
|
+
2. **Subscription Management**: Planos (free, pro, enterprise) com gerenciamento automático
|
|
9
|
+
3. **Billing & Payments**: Integração mock com sistemas de pagamento (Stripe-like)
|
|
10
|
+
4. **Multi-Tenancy**: Isolamento seguro de dados por organização
|
|
11
|
+
5. **Observabilidade**: Logs estruturados e métricas para decisões operacionais
|
|
12
|
+
|
|
13
|
+
## Princípios Fundamentais
|
|
14
|
+
|
|
15
|
+
| Princípio | Descrição |
|
|
16
|
+
|-----------|-----------|
|
|
17
|
+
| **Multi-Tenant First** | Cada organização é isolada em camada de data e contexto |
|
|
18
|
+
| **Security by Default** | JWT + Rate limiting + Input validation em todas as rotas |
|
|
19
|
+
| **Scalability Ready** | Arquitetura preparada para PostgreSQL + Redis |
|
|
20
|
+
| **Developer Experience** | NestJS + TypeScript com tipagem forte e injeção de dependências |
|
|
21
|
+
| **Testabilidade** | Testes E2E para fluxos críticos (auth, subscriptions, billing) |
|
|
22
|
+
|
|
23
|
+
## Objetivos Imediatos
|
|
24
|
+
|
|
25
|
+
1. Gerar scaffold completo com módulos SaaS funcionais
|
|
26
|
+
2. Fornecer exemplos de endpoints para Auth, Subscriptions e Billing
|
|
27
|
+
3. Documentar fluxos de signup, subscription upgrade, e pagamento
|
|
28
|
+
4. Incluir testes E2E para os fluxos críticos
|
|
29
|
+
5. Docker-compose com PostgreSQL + Redis preconfigurado
|
|
30
|
+
|
|
31
|
+
## Papéis de Agentes
|
|
32
|
+
|
|
33
|
+
| Agente | Responsabilidade |
|
|
34
|
+
|--------|-----------------|
|
|
35
|
+
| **Setup Agent** | Inicializar projeto, criar schemas, seedar dados |
|
|
36
|
+
| **Auth Agent** | Validar JWT, gerenciar permissões RBAC |
|
|
37
|
+
| **Subscription Agent** | Gerenciar planos e upgrades |
|
|
38
|
+
| **Billing Agent** | Processar pagamentos (mock) e gerar invoices |
|
|
39
|
+
| **Analytics Agent** | Rastrear eventos de negócio e métricas |
|
|
40
|
+
|
|
41
|
+
## Status
|
|
42
|
+
|
|
43
|
+
- ✅ Estrutura de memória criada
|
|
44
|
+
- ✅ Backend NestJS inicializado
|
|
45
|
+
- 🚀 Pronto para integração de agents
|