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,260 +1,260 @@
|
|
|
1
|
-
# Data - Esquemas e Modelos
|
|
2
|
-
|
|
3
|
-
## PostgreSQL Schema
|
|
4
|
-
|
|
5
|
-
### Entities e Relacionamentos
|
|
6
|
-
|
|
7
|
-
```sql
|
|
8
|
-
-- Categories (Categorias)
|
|
9
|
-
CREATE TABLE categories (
|
|
10
|
-
id UUID PRIMARY KEY,
|
|
11
|
-
name VARCHAR(100) NOT NULL,
|
|
12
|
-
slug VARCHAR(100) NOT NULL UNIQUE,
|
|
13
|
-
description TEXT,
|
|
14
|
-
parent_id UUID REFERENCES categories(id),
|
|
15
|
-
image_url VARCHAR(255),
|
|
16
|
-
display_order INT DEFAULT 0,
|
|
17
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
18
|
-
);
|
|
19
|
-
|
|
20
|
-
-- Products (Produtos)
|
|
21
|
-
CREATE TABLE products (
|
|
22
|
-
id UUID PRIMARY KEY,
|
|
23
|
-
name VARCHAR(255) NOT NULL,
|
|
24
|
-
description TEXT,
|
|
25
|
-
sku VARCHAR(50) NOT NULL UNIQUE,
|
|
26
|
-
price DECIMAL(10, 2) NOT NULL,
|
|
27
|
-
discount_percent INT DEFAULT 0,
|
|
28
|
-
category_id UUID NOT NULL REFERENCES categories(id),
|
|
29
|
-
image_url VARCHAR(255),
|
|
30
|
-
rating FLOAT DEFAULT 0,
|
|
31
|
-
review_count INT DEFAULT 0,
|
|
32
|
-
status VARCHAR(50) DEFAULT 'active', -- active, inactive, discontinued
|
|
33
|
-
created_at TIMESTAMP DEFAULT NOW(),
|
|
34
|
-
updated_at TIMESTAMP DEFAULT NOW()
|
|
35
|
-
);
|
|
36
|
-
|
|
37
|
-
-- Inventory (Estoque)
|
|
38
|
-
CREATE TABLE inventory (
|
|
39
|
-
id UUID PRIMARY KEY,
|
|
40
|
-
product_id UUID NOT NULL UNIQUE REFERENCES products(id) ON DELETE CASCADE,
|
|
41
|
-
stock INT DEFAULT 0,
|
|
42
|
-
reserved INT DEFAULT 0,
|
|
43
|
-
reorder_point INT DEFAULT 10,
|
|
44
|
-
reorder_quantity INT DEFAULT 100,
|
|
45
|
-
last_restock_date TIMESTAMP,
|
|
46
|
-
updated_at TIMESTAMP DEFAULT NOW()
|
|
47
|
-
);
|
|
48
|
-
|
|
49
|
-
-- Stock Movements (Movimentações de Estoque)
|
|
50
|
-
CREATE TABLE stock_movements (
|
|
51
|
-
id UUID PRIMARY KEY,
|
|
52
|
-
product_id UUID NOT NULL REFERENCES products(id),
|
|
53
|
-
movement_type VARCHAR(50), -- in, out, reserve, release
|
|
54
|
-
quantity INT NOT NULL,
|
|
55
|
-
order_id UUID,
|
|
56
|
-
reason VARCHAR(100), -- checkout, restock, adjustment, cancel
|
|
57
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
58
|
-
);
|
|
59
|
-
|
|
60
|
-
-- Coupons (Cupons)
|
|
61
|
-
CREATE TABLE coupons (
|
|
62
|
-
id UUID PRIMARY KEY,
|
|
63
|
-
code VARCHAR(50) NOT NULL UNIQUE,
|
|
64
|
-
discount_percent INT,
|
|
65
|
-
discount_amount DECIMAL(10, 2),
|
|
66
|
-
expires_at TIMESTAMP,
|
|
67
|
-
max_uses INT,
|
|
68
|
-
used_count INT DEFAULT 0,
|
|
69
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
70
|
-
);
|
|
71
|
-
|
|
72
|
-
-- Orders (Pedidos)
|
|
73
|
-
CREATE TABLE orders (
|
|
74
|
-
id UUID PRIMARY KEY,
|
|
75
|
-
user_id VARCHAR(100), -- Mock user
|
|
76
|
-
status VARCHAR(50) DEFAULT 'pending', -- pending, processing, shipped, delivered, canceled
|
|
77
|
-
subtotal DECIMAL(10, 2),
|
|
78
|
-
tax DECIMAL(10, 2),
|
|
79
|
-
discount_amount DECIMAL(10, 2) DEFAULT 0,
|
|
80
|
-
total_amount DECIMAL(10, 2),
|
|
81
|
-
coupon_id UUID REFERENCES coupons(id),
|
|
82
|
-
shipping_address JSONB,
|
|
83
|
-
billing_address JSONB,
|
|
84
|
-
payment_id UUID,
|
|
85
|
-
tracking_number VARCHAR(100),
|
|
86
|
-
created_at TIMESTAMP DEFAULT NOW(),
|
|
87
|
-
updated_at TIMESTAMP DEFAULT NOW()
|
|
88
|
-
);
|
|
89
|
-
|
|
90
|
-
-- Order Items (Itens do Pedido)
|
|
91
|
-
CREATE TABLE order_items (
|
|
92
|
-
id UUID PRIMARY KEY,
|
|
93
|
-
order_id UUID NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
|
|
94
|
-
product_id UUID NOT NULL REFERENCES products(id),
|
|
95
|
-
product_name VARCHAR(255),
|
|
96
|
-
product_price DECIMAL(10, 2),
|
|
97
|
-
quantity INT NOT NULL,
|
|
98
|
-
subtotal DECIMAL(10, 2),
|
|
99
|
-
discount_amount DECIMAL(10, 2) DEFAULT 0,
|
|
100
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
101
|
-
);
|
|
102
|
-
|
|
103
|
-
-- Payments (Pagamentos)
|
|
104
|
-
CREATE TABLE payments (
|
|
105
|
-
id UUID PRIMARY KEY,
|
|
106
|
-
order_id UUID NOT NULL REFERENCES orders(id),
|
|
107
|
-
amount DECIMAL(10, 2),
|
|
108
|
-
currency VARCHAR(3) DEFAULT 'BRL',
|
|
109
|
-
status VARCHAR(50), -- pending, approved, declined, refunded
|
|
110
|
-
method VARCHAR(50), -- credit_card, debit_card, pix
|
|
111
|
-
card_last4 VARCHAR(4),
|
|
112
|
-
stripe_transaction_id VARCHAR(255) UNIQUE,
|
|
113
|
-
fees DECIMAL(10, 2),
|
|
114
|
-
error_message TEXT,
|
|
115
|
-
created_at TIMESTAMP DEFAULT NOW(),
|
|
116
|
-
updated_at TIMESTAMP DEFAULT NOW()
|
|
117
|
-
);
|
|
118
|
-
|
|
119
|
-
-- Reviews (Avaliações)
|
|
120
|
-
CREATE TABLE reviews (
|
|
121
|
-
id UUID PRIMARY KEY,
|
|
122
|
-
product_id UUID NOT NULL REFERENCES products(id) ON DELETE CASCADE,
|
|
123
|
-
user_id VARCHAR(100),
|
|
124
|
-
rating INT, -- 1-5
|
|
125
|
-
comment TEXT,
|
|
126
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
127
|
-
);
|
|
128
|
-
|
|
129
|
-
-- Order Status History (Histórico de Status)
|
|
130
|
-
CREATE TABLE order_status_history (
|
|
131
|
-
id UUID PRIMARY KEY,
|
|
132
|
-
order_id UUID NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
|
|
133
|
-
status VARCHAR(50),
|
|
134
|
-
message VARCHAR(255),
|
|
135
|
-
created_at TIMESTAMP DEFAULT NOW()
|
|
136
|
-
);
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
### Índices
|
|
140
|
-
|
|
141
|
-
```sql
|
|
142
|
-
-- Performance Índices
|
|
143
|
-
CREATE INDEX idx_products_category ON products(category_id);
|
|
144
|
-
CREATE INDEX idx_products_status ON products(status);
|
|
145
|
-
CREATE INDEX idx_products_name ON products USING GIN (to_tsvector('english', name));
|
|
146
|
-
CREATE INDEX idx_inventory_product ON inventory(product_id);
|
|
147
|
-
CREATE INDEX idx_orders_user ON orders(user_id, created_at);
|
|
148
|
-
CREATE INDEX idx_orders_status ON orders(status);
|
|
149
|
-
CREATE INDEX idx_order_items_order ON order_items(order_id);
|
|
150
|
-
CREATE INDEX idx_reviews_product ON reviews(product_id);
|
|
151
|
-
CREATE INDEX idx_payments_order ON payments(order_id);
|
|
152
|
-
CREATE INDEX idx_payments_status ON payments(status);
|
|
153
|
-
CREATE INDEX idx_stock_movements_product ON stock_movements(product_id);
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
## Tipos de Dados
|
|
157
|
-
|
|
158
|
-
| Tipo | Uso | Exemplo |
|
|
159
|
-
|------|-----|---------|
|
|
160
|
-
| **UUID** | IDs únicos | product_id, order_id |
|
|
161
|
-
| **VARCHAR** | Strings curtas | name, sku, status |
|
|
162
|
-
| **TEXT** | Strings longas | description, comment |
|
|
163
|
-
| **DECIMAL(10, 2)** | Dinheiro | price, total (sempre 2 casas decimais) |
|
|
164
|
-
| **INT** | Contadores | quantity, stock, review_count |
|
|
165
|
-
| **FLOAT** | Ratings | rating (permite 4.5, etc) |
|
|
166
|
-
| **TIMESTAMP** | Datas/horas | created_at, updated_at |
|
|
167
|
-
| **JSONB** | Dados estruturados | shipping_address, billing_address |
|
|
168
|
-
| **BOOLEAN** | Verdadeiro/Falso | (future: is_published, etc) |
|
|
169
|
-
|
|
170
|
-
## Constraints Importantes
|
|
171
|
-
|
|
172
|
-
```sql
|
|
173
|
-
-- Preço sempre positivo
|
|
174
|
-
ALTER TABLE products ADD CONSTRAINT price_positive CHECK (price > 0);
|
|
175
|
-
|
|
176
|
-
-- Estoque não negativo
|
|
177
|
-
ALTER TABLE inventory ADD CONSTRAINT stock_non_negative CHECK (stock >= 0);
|
|
178
|
-
ALTER TABLE inventory ADD CONSTRAINT reserved_non_negative CHECK (reserved >= 0);
|
|
179
|
-
|
|
180
|
-
-- Quantidade de item > 0
|
|
181
|
-
ALTER TABLE order_items ADD CONSTRAINT qty_positive CHECK (quantity > 0);
|
|
182
|
-
|
|
183
|
-
-- Rating entre 1 e 5
|
|
184
|
-
ALTER TABLE reviews ADD CONSTRAINT rating_valid CHECK (rating >= 1 AND rating <= 5);
|
|
185
|
-
|
|
186
|
-
-- Desconto entre 0 e 100
|
|
187
|
-
ALTER TABLE products ADD CONSTRAINT discount_valid CHECK (discount_percent >= 0 AND discount_percent <= 100);
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
## Migrations (Future - TypeORM)
|
|
191
|
-
|
|
192
|
-
```bash
|
|
193
|
-
npm run migration:generate -- src/database/migrations/CreateProducts
|
|
194
|
-
npm run migration:run
|
|
195
|
-
```
|
|
196
|
-
|
|
197
|
-
## Backup Strategy
|
|
198
|
-
|
|
199
|
-
```bash
|
|
200
|
-
# Full backup
|
|
201
|
-
pg_dump -h localhost -U postgres -d ecommerce > backup.sql
|
|
202
|
-
|
|
203
|
-
# Restore
|
|
204
|
-
psql -h localhost -U postgres -d ecommerce < backup.sql
|
|
205
|
-
|
|
206
|
-
# Point-in-time recovery
|
|
207
|
-
# WAL archiving needed for PITR
|
|
208
|
-
```
|
|
209
|
-
|
|
210
|
-
## Performance Tips
|
|
211
|
-
|
|
212
|
-
1. **Indexes** - Criar índices em FKs e colunas consultadas frequentemente
|
|
213
|
-
2. **Connection Pooling** - Máximo 20 conexões PostgreSQL
|
|
214
|
-
3. **Query Optimization** - Usar EXPLAIN ANALYZE
|
|
215
|
-
4. **Partitioning** - Para tabelas muito grandes (future)
|
|
216
|
-
5. **Replication** - Standby PostgreSQL para failover (future)
|
|
217
|
-
|
|
218
|
-
## Monitoramento de Banco
|
|
219
|
-
|
|
220
|
-
```sql
|
|
221
|
-
-- Slow queries
|
|
222
|
-
SELECT query, mean_time FROM pg_stat_statements
|
|
223
|
-
WHERE mean_time > 100
|
|
224
|
-
ORDER BY mean_time DESC;
|
|
225
|
-
|
|
226
|
-
-- Tamanho das tabelas
|
|
227
|
-
SELECT schemaname, tablename, pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename))
|
|
228
|
-
FROM pg_tables
|
|
229
|
-
WHERE schemaname != 'pg_catalog'
|
|
230
|
-
ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;
|
|
231
|
-
|
|
232
|
-
-- Índices não utilizados
|
|
233
|
-
SELECT schemaname, tablename, indexname
|
|
234
|
-
FROM pg_stat_user_indexes
|
|
235
|
-
WHERE idx_scan = 0;
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
## SQLite (Alternativa Desenvolvimento)
|
|
239
|
-
|
|
240
|
-
Para desenvolvimento local sem Docker:
|
|
241
|
-
|
|
242
|
-
```sql
|
|
243
|
-
-- SQLite (mesmo schema, sintaxe ligeiramente diferente)
|
|
244
|
-
CREATE TABLE products (
|
|
245
|
-
id TEXT PRIMARY KEY,
|
|
246
|
-
name TEXT NOT NULL,
|
|
247
|
-
price REAL NOT NULL,
|
|
248
|
-
...
|
|
249
|
-
);
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
## Redis (Cache - Future)
|
|
253
|
-
|
|
254
|
-
```
|
|
255
|
-
Keys estrutura:
|
|
256
|
-
- product:${id} → JSON do produto (TTL 30min)
|
|
257
|
-
- category:${slug}:products → IDs de produtos (TTL 1h)
|
|
258
|
-
- cart:${userId} → JSON do carrinho (TTL 24h)
|
|
259
|
-
- inventory:${productId} → Stock info (TTL 5min)
|
|
260
|
-
```
|
|
1
|
+
# Data - Esquemas e Modelos
|
|
2
|
+
|
|
3
|
+
## PostgreSQL Schema
|
|
4
|
+
|
|
5
|
+
### Entities e Relacionamentos
|
|
6
|
+
|
|
7
|
+
```sql
|
|
8
|
+
-- Categories (Categorias)
|
|
9
|
+
CREATE TABLE categories (
|
|
10
|
+
id UUID PRIMARY KEY,
|
|
11
|
+
name VARCHAR(100) NOT NULL,
|
|
12
|
+
slug VARCHAR(100) NOT NULL UNIQUE,
|
|
13
|
+
description TEXT,
|
|
14
|
+
parent_id UUID REFERENCES categories(id),
|
|
15
|
+
image_url VARCHAR(255),
|
|
16
|
+
display_order INT DEFAULT 0,
|
|
17
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
18
|
+
);
|
|
19
|
+
|
|
20
|
+
-- Products (Produtos)
|
|
21
|
+
CREATE TABLE products (
|
|
22
|
+
id UUID PRIMARY KEY,
|
|
23
|
+
name VARCHAR(255) NOT NULL,
|
|
24
|
+
description TEXT,
|
|
25
|
+
sku VARCHAR(50) NOT NULL UNIQUE,
|
|
26
|
+
price DECIMAL(10, 2) NOT NULL,
|
|
27
|
+
discount_percent INT DEFAULT 0,
|
|
28
|
+
category_id UUID NOT NULL REFERENCES categories(id),
|
|
29
|
+
image_url VARCHAR(255),
|
|
30
|
+
rating FLOAT DEFAULT 0,
|
|
31
|
+
review_count INT DEFAULT 0,
|
|
32
|
+
status VARCHAR(50) DEFAULT 'active', -- active, inactive, discontinued
|
|
33
|
+
created_at TIMESTAMP DEFAULT NOW(),
|
|
34
|
+
updated_at TIMESTAMP DEFAULT NOW()
|
|
35
|
+
);
|
|
36
|
+
|
|
37
|
+
-- Inventory (Estoque)
|
|
38
|
+
CREATE TABLE inventory (
|
|
39
|
+
id UUID PRIMARY KEY,
|
|
40
|
+
product_id UUID NOT NULL UNIQUE REFERENCES products(id) ON DELETE CASCADE,
|
|
41
|
+
stock INT DEFAULT 0,
|
|
42
|
+
reserved INT DEFAULT 0,
|
|
43
|
+
reorder_point INT DEFAULT 10,
|
|
44
|
+
reorder_quantity INT DEFAULT 100,
|
|
45
|
+
last_restock_date TIMESTAMP,
|
|
46
|
+
updated_at TIMESTAMP DEFAULT NOW()
|
|
47
|
+
);
|
|
48
|
+
|
|
49
|
+
-- Stock Movements (Movimentações de Estoque)
|
|
50
|
+
CREATE TABLE stock_movements (
|
|
51
|
+
id UUID PRIMARY KEY,
|
|
52
|
+
product_id UUID NOT NULL REFERENCES products(id),
|
|
53
|
+
movement_type VARCHAR(50), -- in, out, reserve, release
|
|
54
|
+
quantity INT NOT NULL,
|
|
55
|
+
order_id UUID,
|
|
56
|
+
reason VARCHAR(100), -- checkout, restock, adjustment, cancel
|
|
57
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
58
|
+
);
|
|
59
|
+
|
|
60
|
+
-- Coupons (Cupons)
|
|
61
|
+
CREATE TABLE coupons (
|
|
62
|
+
id UUID PRIMARY KEY,
|
|
63
|
+
code VARCHAR(50) NOT NULL UNIQUE,
|
|
64
|
+
discount_percent INT,
|
|
65
|
+
discount_amount DECIMAL(10, 2),
|
|
66
|
+
expires_at TIMESTAMP,
|
|
67
|
+
max_uses INT,
|
|
68
|
+
used_count INT DEFAULT 0,
|
|
69
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
70
|
+
);
|
|
71
|
+
|
|
72
|
+
-- Orders (Pedidos)
|
|
73
|
+
CREATE TABLE orders (
|
|
74
|
+
id UUID PRIMARY KEY,
|
|
75
|
+
user_id VARCHAR(100), -- Mock user
|
|
76
|
+
status VARCHAR(50) DEFAULT 'pending', -- pending, processing, shipped, delivered, canceled
|
|
77
|
+
subtotal DECIMAL(10, 2),
|
|
78
|
+
tax DECIMAL(10, 2),
|
|
79
|
+
discount_amount DECIMAL(10, 2) DEFAULT 0,
|
|
80
|
+
total_amount DECIMAL(10, 2),
|
|
81
|
+
coupon_id UUID REFERENCES coupons(id),
|
|
82
|
+
shipping_address JSONB,
|
|
83
|
+
billing_address JSONB,
|
|
84
|
+
payment_id UUID,
|
|
85
|
+
tracking_number VARCHAR(100),
|
|
86
|
+
created_at TIMESTAMP DEFAULT NOW(),
|
|
87
|
+
updated_at TIMESTAMP DEFAULT NOW()
|
|
88
|
+
);
|
|
89
|
+
|
|
90
|
+
-- Order Items (Itens do Pedido)
|
|
91
|
+
CREATE TABLE order_items (
|
|
92
|
+
id UUID PRIMARY KEY,
|
|
93
|
+
order_id UUID NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
|
|
94
|
+
product_id UUID NOT NULL REFERENCES products(id),
|
|
95
|
+
product_name VARCHAR(255),
|
|
96
|
+
product_price DECIMAL(10, 2),
|
|
97
|
+
quantity INT NOT NULL,
|
|
98
|
+
subtotal DECIMAL(10, 2),
|
|
99
|
+
discount_amount DECIMAL(10, 2) DEFAULT 0,
|
|
100
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
101
|
+
);
|
|
102
|
+
|
|
103
|
+
-- Payments (Pagamentos)
|
|
104
|
+
CREATE TABLE payments (
|
|
105
|
+
id UUID PRIMARY KEY,
|
|
106
|
+
order_id UUID NOT NULL REFERENCES orders(id),
|
|
107
|
+
amount DECIMAL(10, 2),
|
|
108
|
+
currency VARCHAR(3) DEFAULT 'BRL',
|
|
109
|
+
status VARCHAR(50), -- pending, approved, declined, refunded
|
|
110
|
+
method VARCHAR(50), -- credit_card, debit_card, pix
|
|
111
|
+
card_last4 VARCHAR(4),
|
|
112
|
+
stripe_transaction_id VARCHAR(255) UNIQUE,
|
|
113
|
+
fees DECIMAL(10, 2),
|
|
114
|
+
error_message TEXT,
|
|
115
|
+
created_at TIMESTAMP DEFAULT NOW(),
|
|
116
|
+
updated_at TIMESTAMP DEFAULT NOW()
|
|
117
|
+
);
|
|
118
|
+
|
|
119
|
+
-- Reviews (Avaliações)
|
|
120
|
+
CREATE TABLE reviews (
|
|
121
|
+
id UUID PRIMARY KEY,
|
|
122
|
+
product_id UUID NOT NULL REFERENCES products(id) ON DELETE CASCADE,
|
|
123
|
+
user_id VARCHAR(100),
|
|
124
|
+
rating INT, -- 1-5
|
|
125
|
+
comment TEXT,
|
|
126
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
127
|
+
);
|
|
128
|
+
|
|
129
|
+
-- Order Status History (Histórico de Status)
|
|
130
|
+
CREATE TABLE order_status_history (
|
|
131
|
+
id UUID PRIMARY KEY,
|
|
132
|
+
order_id UUID NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
|
|
133
|
+
status VARCHAR(50),
|
|
134
|
+
message VARCHAR(255),
|
|
135
|
+
created_at TIMESTAMP DEFAULT NOW()
|
|
136
|
+
);
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Índices
|
|
140
|
+
|
|
141
|
+
```sql
|
|
142
|
+
-- Performance Índices
|
|
143
|
+
CREATE INDEX idx_products_category ON products(category_id);
|
|
144
|
+
CREATE INDEX idx_products_status ON products(status);
|
|
145
|
+
CREATE INDEX idx_products_name ON products USING GIN (to_tsvector('english', name));
|
|
146
|
+
CREATE INDEX idx_inventory_product ON inventory(product_id);
|
|
147
|
+
CREATE INDEX idx_orders_user ON orders(user_id, created_at);
|
|
148
|
+
CREATE INDEX idx_orders_status ON orders(status);
|
|
149
|
+
CREATE INDEX idx_order_items_order ON order_items(order_id);
|
|
150
|
+
CREATE INDEX idx_reviews_product ON reviews(product_id);
|
|
151
|
+
CREATE INDEX idx_payments_order ON payments(order_id);
|
|
152
|
+
CREATE INDEX idx_payments_status ON payments(status);
|
|
153
|
+
CREATE INDEX idx_stock_movements_product ON stock_movements(product_id);
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Tipos de Dados
|
|
157
|
+
|
|
158
|
+
| Tipo | Uso | Exemplo |
|
|
159
|
+
|------|-----|---------|
|
|
160
|
+
| **UUID** | IDs únicos | product_id, order_id |
|
|
161
|
+
| **VARCHAR** | Strings curtas | name, sku, status |
|
|
162
|
+
| **TEXT** | Strings longas | description, comment |
|
|
163
|
+
| **DECIMAL(10, 2)** | Dinheiro | price, total (sempre 2 casas decimais) |
|
|
164
|
+
| **INT** | Contadores | quantity, stock, review_count |
|
|
165
|
+
| **FLOAT** | Ratings | rating (permite 4.5, etc) |
|
|
166
|
+
| **TIMESTAMP** | Datas/horas | created_at, updated_at |
|
|
167
|
+
| **JSONB** | Dados estruturados | shipping_address, billing_address |
|
|
168
|
+
| **BOOLEAN** | Verdadeiro/Falso | (future: is_published, etc) |
|
|
169
|
+
|
|
170
|
+
## Constraints Importantes
|
|
171
|
+
|
|
172
|
+
```sql
|
|
173
|
+
-- Preço sempre positivo
|
|
174
|
+
ALTER TABLE products ADD CONSTRAINT price_positive CHECK (price > 0);
|
|
175
|
+
|
|
176
|
+
-- Estoque não negativo
|
|
177
|
+
ALTER TABLE inventory ADD CONSTRAINT stock_non_negative CHECK (stock >= 0);
|
|
178
|
+
ALTER TABLE inventory ADD CONSTRAINT reserved_non_negative CHECK (reserved >= 0);
|
|
179
|
+
|
|
180
|
+
-- Quantidade de item > 0
|
|
181
|
+
ALTER TABLE order_items ADD CONSTRAINT qty_positive CHECK (quantity > 0);
|
|
182
|
+
|
|
183
|
+
-- Rating entre 1 e 5
|
|
184
|
+
ALTER TABLE reviews ADD CONSTRAINT rating_valid CHECK (rating >= 1 AND rating <= 5);
|
|
185
|
+
|
|
186
|
+
-- Desconto entre 0 e 100
|
|
187
|
+
ALTER TABLE products ADD CONSTRAINT discount_valid CHECK (discount_percent >= 0 AND discount_percent <= 100);
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
## Migrations (Future - TypeORM)
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
npm run migration:generate -- src/database/migrations/CreateProducts
|
|
194
|
+
npm run migration:run
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
## Backup Strategy
|
|
198
|
+
|
|
199
|
+
```bash
|
|
200
|
+
# Full backup
|
|
201
|
+
pg_dump -h localhost -U postgres -d ecommerce > backup.sql
|
|
202
|
+
|
|
203
|
+
# Restore
|
|
204
|
+
psql -h localhost -U postgres -d ecommerce < backup.sql
|
|
205
|
+
|
|
206
|
+
# Point-in-time recovery
|
|
207
|
+
# WAL archiving needed for PITR
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
## Performance Tips
|
|
211
|
+
|
|
212
|
+
1. **Indexes** - Criar índices em FKs e colunas consultadas frequentemente
|
|
213
|
+
2. **Connection Pooling** - Máximo 20 conexões PostgreSQL
|
|
214
|
+
3. **Query Optimization** - Usar EXPLAIN ANALYZE
|
|
215
|
+
4. **Partitioning** - Para tabelas muito grandes (future)
|
|
216
|
+
5. **Replication** - Standby PostgreSQL para failover (future)
|
|
217
|
+
|
|
218
|
+
## Monitoramento de Banco
|
|
219
|
+
|
|
220
|
+
```sql
|
|
221
|
+
-- Slow queries
|
|
222
|
+
SELECT query, mean_time FROM pg_stat_statements
|
|
223
|
+
WHERE mean_time > 100
|
|
224
|
+
ORDER BY mean_time DESC;
|
|
225
|
+
|
|
226
|
+
-- Tamanho das tabelas
|
|
227
|
+
SELECT schemaname, tablename, pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename))
|
|
228
|
+
FROM pg_tables
|
|
229
|
+
WHERE schemaname != 'pg_catalog'
|
|
230
|
+
ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;
|
|
231
|
+
|
|
232
|
+
-- Índices não utilizados
|
|
233
|
+
SELECT schemaname, tablename, indexname
|
|
234
|
+
FROM pg_stat_user_indexes
|
|
235
|
+
WHERE idx_scan = 0;
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## SQLite (Alternativa Desenvolvimento)
|
|
239
|
+
|
|
240
|
+
Para desenvolvimento local sem Docker:
|
|
241
|
+
|
|
242
|
+
```sql
|
|
243
|
+
-- SQLite (mesmo schema, sintaxe ligeiramente diferente)
|
|
244
|
+
CREATE TABLE products (
|
|
245
|
+
id TEXT PRIMARY KEY,
|
|
246
|
+
name TEXT NOT NULL,
|
|
247
|
+
price REAL NOT NULL,
|
|
248
|
+
...
|
|
249
|
+
);
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
## Redis (Cache - Future)
|
|
253
|
+
|
|
254
|
+
```
|
|
255
|
+
Keys estrutura:
|
|
256
|
+
- product:${id} → JSON do produto (TTL 30min)
|
|
257
|
+
- category:${slug}:products → IDs de produtos (TTL 1h)
|
|
258
|
+
- cart:${userId} → JSON do carrinho (TTL 24h)
|
|
259
|
+
- inventory:${productId} → Stock info (TTL 5min)
|
|
260
|
+
```
|