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,25 +1,25 @@
|
|
|
1
|
-
# Missão do E-Commerce Starter
|
|
2
|
-
|
|
3
|
-
## Visão Executiva
|
|
4
|
-
Construir uma plataforma de e-commerce modular, escalável e pronta para produção que permita venda de produtos online com funcionalidades completas de catálogo, carrinho, checkout e gerenciamento de pedidos.
|
|
5
|
-
|
|
6
|
-
## Objetivos Estratégicos
|
|
7
|
-
1. **Catálogo Dinâmico** - Gerenciar produtos com categorias, descrições, preços e imagens
|
|
8
|
-
2. **Experiência de Compra** - Carrinho de compras fluido e checkout simplificado
|
|
9
|
-
3. **Processamento de Pagamentos** - Integração com gateway de pagamentos (mock Stripe)
|
|
10
|
-
4. **Gestão de Pedidos** - Rastreamento completo do lifecycle de pedidos
|
|
11
|
-
5. **Controle de Inventário** - Stock management em tempo real
|
|
12
|
-
6. **Análise de Produtos** - Sistema de avaliações e reviews
|
|
13
|
-
|
|
14
|
-
## Pilares Técnicos
|
|
15
|
-
- **Backend**: NestJS + PostgreSQL
|
|
16
|
-
- **Cache**: Redis para performance
|
|
17
|
-
- **Documentação**: Memory-driven architecture
|
|
18
|
-
- **Testing**: E2E coverage para fluxos críticos
|
|
19
|
-
- **Escalabilidade**: Pronto para microsserviços
|
|
20
|
-
|
|
21
|
-
## KPIs de Sucesso
|
|
22
|
-
- Tempo de resposta < 200ms para listagem de produtos
|
|
23
|
-
- Checkout completo em < 30 segundos
|
|
24
|
-
- 99.9% uptime
|
|
25
|
-
- Suporte a 10k+ produtos no catálogo
|
|
1
|
+
# Missão do E-Commerce Starter
|
|
2
|
+
|
|
3
|
+
## Visão Executiva
|
|
4
|
+
Construir uma plataforma de e-commerce modular, escalável e pronta para produção que permita venda de produtos online com funcionalidades completas de catálogo, carrinho, checkout e gerenciamento de pedidos.
|
|
5
|
+
|
|
6
|
+
## Objetivos Estratégicos
|
|
7
|
+
1. **Catálogo Dinâmico** - Gerenciar produtos com categorias, descrições, preços e imagens
|
|
8
|
+
2. **Experiência de Compra** - Carrinho de compras fluido e checkout simplificado
|
|
9
|
+
3. **Processamento de Pagamentos** - Integração com gateway de pagamentos (mock Stripe)
|
|
10
|
+
4. **Gestão de Pedidos** - Rastreamento completo do lifecycle de pedidos
|
|
11
|
+
5. **Controle de Inventário** - Stock management em tempo real
|
|
12
|
+
6. **Análise de Produtos** - Sistema de avaliações e reviews
|
|
13
|
+
|
|
14
|
+
## Pilares Técnicos
|
|
15
|
+
- **Backend**: NestJS + PostgreSQL
|
|
16
|
+
- **Cache**: Redis para performance
|
|
17
|
+
- **Documentação**: Memory-driven architecture
|
|
18
|
+
- **Testing**: E2E coverage para fluxos críticos
|
|
19
|
+
- **Escalabilidade**: Pronto para microsserviços
|
|
20
|
+
|
|
21
|
+
## KPIs de Sucesso
|
|
22
|
+
- Tempo de resposta < 200ms para listagem de produtos
|
|
23
|
+
- Checkout completo em < 30 segundos
|
|
24
|
+
- 99.9% uptime
|
|
25
|
+
- Suporte a 10k+ produtos no catálogo
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# Padrões Técnicos e Convenções
|
|
2
|
-
|
|
3
|
-
## Código
|
|
4
|
-
- **Linguagem**: TypeScript (strict mode)
|
|
5
|
-
- **Framework**: NestJS com arquitetura modular
|
|
6
|
-
- **Convenção de Nomes**:
|
|
7
|
-
- Classes: PascalCase (ProductService, CartController)
|
|
8
|
-
- Métodos: camelCase (getProducts, addToCart)
|
|
9
|
-
- Constantes: UPPER_SNAKE_CASE
|
|
10
|
-
- Variáveis: camelCase
|
|
11
|
-
- **Organização**: One file per class/interface
|
|
12
|
-
- **Imports**: Agrupar por externa → interna → relativa
|
|
13
|
-
|
|
14
|
-
## Banco de Dados
|
|
15
|
-
- **Database**: PostgreSQL
|
|
16
|
-
- **Migrations**: TypeORM CLI
|
|
17
|
-
- **Entities**: Uma entity por arquivo
|
|
18
|
-
- **Relacionamentos**: lazy loading onde apropriado
|
|
19
|
-
- **Índices**: Em campos frequentemente consultados (product_id, user_id)
|
|
20
|
-
|
|
21
|
-
## API
|
|
22
|
-
- **Versionamento**: `/api/v1` (future-ready)
|
|
23
|
-
- **Respostas**: JSON com estrutura consistente
|
|
24
|
-
- **Erros**: HTTP status codes semânticos + error codes internos
|
|
25
|
-
- **Paginação**: offset/limit padrão
|
|
26
|
-
- **Rate Limiting**: 100 requests/min por cliente
|
|
27
|
-
|
|
28
|
-
## Testes
|
|
29
|
-
- **Framework**: Jest
|
|
30
|
-
- **Coverage**: > 80% para módulos críticos
|
|
31
|
-
- **E2E**: Fluxos de checkout, pagamento, pedidos
|
|
32
|
-
- **Naming**: `*.spec.ts` (unitários), `*.e2e-spec.ts` (integração)
|
|
33
|
-
|
|
34
|
-
## Segurança
|
|
35
|
-
- **Auth**: JWT com refresh tokens
|
|
36
|
-
- **CORS**: Configurável por ambiente
|
|
37
|
-
- **Inputs**: Validação com class-validator + sanitização
|
|
38
|
-
- **Secrets**: Via .env (não em código)
|
|
39
|
-
- **HTTPS**: Obrigatório em produção
|
|
40
|
-
|
|
41
|
-
## Documentação
|
|
42
|
-
- **Memory**: 10 níveis por domínio
|
|
43
|
-
- **API Docs**: Swagger via NestJS decorators
|
|
44
|
-
- **README**: Setup, arquitetura, exemplos curl
|
|
45
|
-
- **Commits**: Semantic versioning (feat:, fix:, docs:)
|
|
1
|
+
# Padrões Técnicos e Convenções
|
|
2
|
+
|
|
3
|
+
## Código
|
|
4
|
+
- **Linguagem**: TypeScript (strict mode)
|
|
5
|
+
- **Framework**: NestJS com arquitetura modular
|
|
6
|
+
- **Convenção de Nomes**:
|
|
7
|
+
- Classes: PascalCase (ProductService, CartController)
|
|
8
|
+
- Métodos: camelCase (getProducts, addToCart)
|
|
9
|
+
- Constantes: UPPER_SNAKE_CASE
|
|
10
|
+
- Variáveis: camelCase
|
|
11
|
+
- **Organização**: One file per class/interface
|
|
12
|
+
- **Imports**: Agrupar por externa → interna → relativa
|
|
13
|
+
|
|
14
|
+
## Banco de Dados
|
|
15
|
+
- **Database**: PostgreSQL
|
|
16
|
+
- **Migrations**: TypeORM CLI
|
|
17
|
+
- **Entities**: Uma entity por arquivo
|
|
18
|
+
- **Relacionamentos**: lazy loading onde apropriado
|
|
19
|
+
- **Índices**: Em campos frequentemente consultados (product_id, user_id)
|
|
20
|
+
|
|
21
|
+
## API
|
|
22
|
+
- **Versionamento**: `/api/v1` (future-ready)
|
|
23
|
+
- **Respostas**: JSON com estrutura consistente
|
|
24
|
+
- **Erros**: HTTP status codes semânticos + error codes internos
|
|
25
|
+
- **Paginação**: offset/limit padrão
|
|
26
|
+
- **Rate Limiting**: 100 requests/min por cliente
|
|
27
|
+
|
|
28
|
+
## Testes
|
|
29
|
+
- **Framework**: Jest
|
|
30
|
+
- **Coverage**: > 80% para módulos críticos
|
|
31
|
+
- **E2E**: Fluxos de checkout, pagamento, pedidos
|
|
32
|
+
- **Naming**: `*.spec.ts` (unitários), `*.e2e-spec.ts` (integração)
|
|
33
|
+
|
|
34
|
+
## Segurança
|
|
35
|
+
- **Auth**: JWT com refresh tokens
|
|
36
|
+
- **CORS**: Configurável por ambiente
|
|
37
|
+
- **Inputs**: Validação com class-validator + sanitização
|
|
38
|
+
- **Secrets**: Via .env (não em código)
|
|
39
|
+
- **HTTPS**: Obrigatório em produção
|
|
40
|
+
|
|
41
|
+
## Documentação
|
|
42
|
+
- **Memory**: 10 níveis por domínio
|
|
43
|
+
- **API Docs**: Swagger via NestJS decorators
|
|
44
|
+
- **README**: Setup, arquitetura, exemplos curl
|
|
45
|
+
- **Commits**: Semantic versioning (feat:, fix:, docs:)
|
|
@@ -1,62 +1,62 @@
|
|
|
1
|
-
# Regras de Negócio
|
|
2
|
-
|
|
3
|
-
## Preços e Promoções
|
|
4
|
-
- Preço base é obrigatório (> 0)
|
|
5
|
-
- Promoções podem ser por cupom ou hardcoded em produto
|
|
6
|
-
- Desconto máximo: 100% (produto grátis permitido)
|
|
7
|
-
- Imposto: 15% calculado no checkout (simplificado)
|
|
8
|
-
- Total = (subtotal com desconto) * 1.15
|
|
9
|
-
|
|
10
|
-
## Carrinho
|
|
11
|
-
- Carrinho máximo: 100 itens
|
|
12
|
-
- Quantidade mínima por item: 1
|
|
13
|
-
- Quantidade máxima por item: 1000
|
|
14
|
-
- Carrinho vazio após 30 dias de inatividade (cookie)
|
|
15
|
-
- Um cupom por carrinho
|
|
16
|
-
|
|
17
|
-
## Pedidos
|
|
18
|
-
- Pedido = tudo ou nada (transação atômica)
|
|
19
|
-
- Se stock insuficiente → falha no checkout
|
|
20
|
-
- Número de pedido: UUID
|
|
21
|
-
- Apenas clientes autenticados podem fazer pedidos (para MVP, mock user)
|
|
22
|
-
- Histórico de pedido imutável
|
|
23
|
-
|
|
24
|
-
## Inventário
|
|
25
|
-
- Stock negativo NÃO permitido
|
|
26
|
-
- Reposição manual (input de gerente)
|
|
27
|
-
- Alerta quando < 5 unidades
|
|
28
|
-
- Reserva de stock ocorre no checkout (não em "add to cart")
|
|
29
|
-
|
|
30
|
-
## Pagamentos (Mock Stripe)
|
|
31
|
-
- Taxa simulada: 2.9% + R$0.30 por transação
|
|
32
|
-
- Lógica simples: 90% sucesso, 10% falha (aleatório)
|
|
33
|
-
- Transação bem-sucedida → order status = processing
|
|
34
|
-
- Transação falha → libera stock, order status = failed
|
|
35
|
-
|
|
36
|
-
## Avaliações
|
|
37
|
-
- Apenas comprador pode avaliar seu próprio pedido
|
|
38
|
-
- Uma avaliação por item de pedido
|
|
39
|
-
- Números de 1-5 (sem 0 ou decimais)
|
|
40
|
-
- Texto até 500 caracteres
|
|
41
|
-
- Não há exclusão (soft delete opcional)
|
|
42
|
-
|
|
43
|
-
## Segurança
|
|
44
|
-
- Sem autenticação real em MVP (mock JWT)
|
|
45
|
-
- Senhas não são armazenadas em MVP
|
|
46
|
-
- HTTPS obrigatório em produção
|
|
47
|
-
- Rate limiting: 100 req/min por IP
|
|
48
|
-
- Validação de input obrigatória
|
|
49
|
-
|
|
50
|
-
## Performance
|
|
51
|
-
- Produtos listados com paginação (padrão: 20 por página)
|
|
52
|
-
- Cache Redis para:
|
|
53
|
-
- Categorias (TTL 1h)
|
|
54
|
-
- Produtos top-sellers (TTL 30min)
|
|
55
|
-
- Carrinho (TTL 24h)
|
|
56
|
-
- Busca full-text em nome/descrição (ILIKE em PostgreSQL)
|
|
57
|
-
|
|
58
|
-
## Conformidade
|
|
59
|
-
- LGPD: Dados de cliente não são exportados (apenas em solicitação)
|
|
60
|
-
- Termos de serviço aceitos no checkout (mock)
|
|
61
|
-
- Política de privacidade disponível
|
|
62
|
-
- Cancelamento de conta = soft delete (dados retidos 90 dias)
|
|
1
|
+
# Regras de Negócio
|
|
2
|
+
|
|
3
|
+
## Preços e Promoções
|
|
4
|
+
- Preço base é obrigatório (> 0)
|
|
5
|
+
- Promoções podem ser por cupom ou hardcoded em produto
|
|
6
|
+
- Desconto máximo: 100% (produto grátis permitido)
|
|
7
|
+
- Imposto: 15% calculado no checkout (simplificado)
|
|
8
|
+
- Total = (subtotal com desconto) * 1.15
|
|
9
|
+
|
|
10
|
+
## Carrinho
|
|
11
|
+
- Carrinho máximo: 100 itens
|
|
12
|
+
- Quantidade mínima por item: 1
|
|
13
|
+
- Quantidade máxima por item: 1000
|
|
14
|
+
- Carrinho vazio após 30 dias de inatividade (cookie)
|
|
15
|
+
- Um cupom por carrinho
|
|
16
|
+
|
|
17
|
+
## Pedidos
|
|
18
|
+
- Pedido = tudo ou nada (transação atômica)
|
|
19
|
+
- Se stock insuficiente → falha no checkout
|
|
20
|
+
- Número de pedido: UUID
|
|
21
|
+
- Apenas clientes autenticados podem fazer pedidos (para MVP, mock user)
|
|
22
|
+
- Histórico de pedido imutável
|
|
23
|
+
|
|
24
|
+
## Inventário
|
|
25
|
+
- Stock negativo NÃO permitido
|
|
26
|
+
- Reposição manual (input de gerente)
|
|
27
|
+
- Alerta quando < 5 unidades
|
|
28
|
+
- Reserva de stock ocorre no checkout (não em "add to cart")
|
|
29
|
+
|
|
30
|
+
## Pagamentos (Mock Stripe)
|
|
31
|
+
- Taxa simulada: 2.9% + R$0.30 por transação
|
|
32
|
+
- Lógica simples: 90% sucesso, 10% falha (aleatório)
|
|
33
|
+
- Transação bem-sucedida → order status = processing
|
|
34
|
+
- Transação falha → libera stock, order status = failed
|
|
35
|
+
|
|
36
|
+
## Avaliações
|
|
37
|
+
- Apenas comprador pode avaliar seu próprio pedido
|
|
38
|
+
- Uma avaliação por item de pedido
|
|
39
|
+
- Números de 1-5 (sem 0 ou decimais)
|
|
40
|
+
- Texto até 500 caracteres
|
|
41
|
+
- Não há exclusão (soft delete opcional)
|
|
42
|
+
|
|
43
|
+
## Segurança
|
|
44
|
+
- Sem autenticação real em MVP (mock JWT)
|
|
45
|
+
- Senhas não são armazenadas em MVP
|
|
46
|
+
- HTTPS obrigatório em produção
|
|
47
|
+
- Rate limiting: 100 req/min por IP
|
|
48
|
+
- Validação de input obrigatória
|
|
49
|
+
|
|
50
|
+
## Performance
|
|
51
|
+
- Produtos listados com paginação (padrão: 20 por página)
|
|
52
|
+
- Cache Redis para:
|
|
53
|
+
- Categorias (TTL 1h)
|
|
54
|
+
- Produtos top-sellers (TTL 30min)
|
|
55
|
+
- Carrinho (TTL 24h)
|
|
56
|
+
- Busca full-text em nome/descrição (ILIKE em PostgreSQL)
|
|
57
|
+
|
|
58
|
+
## Conformidade
|
|
59
|
+
- LGPD: Dados de cliente não são exportados (apenas em solicitação)
|
|
60
|
+
- Termos de serviço aceitos no checkout (mock)
|
|
61
|
+
- Política de privacidade disponível
|
|
62
|
+
- Cancelamento de conta = soft delete (dados retidos 90 dias)
|
|
@@ -1,62 +1,62 @@
|
|
|
1
|
-
# Requisitos Não-Funcionais (NFRs)
|
|
2
|
-
|
|
3
|
-
## Performance
|
|
4
|
-
| Requisito | Target | Método |
|
|
5
|
-
|-----------|--------|--------|
|
|
6
|
-
| Listagem de produtos | < 200ms p95 | Índices + paginação + cache |
|
|
7
|
-
| Busca/filtro | < 300ms p95 | Full-text search + índices |
|
|
8
|
-
| Checkout (validate+process) | < 500ms p95 | Transações atômicas + otimização |
|
|
9
|
-
| Response time geral | < 100ms p50 | CDN para estáticos, cache em camadas |
|
|
10
|
-
|
|
11
|
-
## Escalabilidade
|
|
12
|
-
- **Throughput**: 1000 concurrent users
|
|
13
|
-
- **Armazenamento**: 10k+ produtos no catálogo
|
|
14
|
-
- **Conexões DB**: Connection pooling com 20 conexões
|
|
15
|
-
- **Cache**: Redis com 1GB limite inicial
|
|
16
|
-
- **Estratégia**: Pronto para sharding no futuro
|
|
17
|
-
|
|
18
|
-
## Disponibilidade
|
|
19
|
-
- **Uptime**: 99.9% (máximo 43 min/mês downtime)
|
|
20
|
-
- **RTO** (Recovery Time Objective): 15 minutos
|
|
21
|
-
- **RPO** (Recovery Point Objective): < 5 minutos (backups a cada 5min)
|
|
22
|
-
- **Health Check**: `/api/health` a cada 30s
|
|
23
|
-
|
|
24
|
-
## Segurança
|
|
25
|
-
- **Encryption**: TLS 1.3 em trânsito
|
|
26
|
-
- **Authentication**: JWT com expiry 1h, refresh token 30 dias
|
|
27
|
-
- **Authorization**: RBAC (user, admin)
|
|
28
|
-
- **Input Validation**: Todas as entradas (length, type, format)
|
|
29
|
-
- **SQL Injection**: TypeORM parameterizado (protected)
|
|
30
|
-
- **CORS**: Apenas origins registradas
|
|
31
|
-
- **CSRF**: Tokens no formulário (POST/PUT/DELETE)
|
|
32
|
-
- **Rate Limiting**: 100 req/min por IP
|
|
33
|
-
- **Secrets**: Variáveis de ambiente, nunca em código
|
|
34
|
-
|
|
35
|
-
## Manutenibilidade
|
|
36
|
-
- **Código**: TypeScript strict, 80%+ test coverage
|
|
37
|
-
- **Logs**: Estruturados (JSON), níveis (info, warn, error)
|
|
38
|
-
- **Observabilidade**: Health checks, metricas Prometheus (future)
|
|
39
|
-
- **Documentação**: Cobertura 100% de APIs via Swagger
|
|
40
|
-
- **CI/CD**: Testes automáticos antes de merge
|
|
41
|
-
|
|
42
|
-
## Compliance
|
|
43
|
-
- **LGPD**: Direito ao esquecimento, consentimento explícito
|
|
44
|
-
- **PCI-DSS**: Mock Stripe (dados reais fora do escopo MVP)
|
|
45
|
-
- **Auditoria**: Logs de operações críticas (pagamentos, exclusões)
|
|
46
|
-
- **Backup**: Daily backups, retention 30 dias
|
|
47
|
-
|
|
48
|
-
## Confiabilidade
|
|
49
|
-
- **Idempotência**: Operações críticas (pagamento, pedido) retentáveis
|
|
50
|
-
- **Graceful Degradation**: Cache falha → chama DB
|
|
51
|
-
- **Retry Logic**: Exponential backoff para chamadas externas
|
|
52
|
-
- **Falha em Cascata**: Circuit breaker para dependências externas (future)
|
|
53
|
-
|
|
54
|
-
## Compatibilidade
|
|
55
|
-
- **Browsers**: Chrome, Firefox, Safari, Edge (últimas 2 versões)
|
|
56
|
-
- **Mobile**: Responsivo (iOS Safari, Android Chrome)
|
|
57
|
-
- **APIs**: Versionada (/api/v1), backward compatible
|
|
58
|
-
|
|
59
|
-
## Disaster Recovery
|
|
60
|
-
- **Backup**: Daily full backup + hourly WAL
|
|
61
|
-
- **Replica**: Standby PostgreSQL para failover (future)
|
|
62
|
-
- **Testado**: DR drills mensais
|
|
1
|
+
# Requisitos Não-Funcionais (NFRs)
|
|
2
|
+
|
|
3
|
+
## Performance
|
|
4
|
+
| Requisito | Target | Método |
|
|
5
|
+
|-----------|--------|--------|
|
|
6
|
+
| Listagem de produtos | < 200ms p95 | Índices + paginação + cache |
|
|
7
|
+
| Busca/filtro | < 300ms p95 | Full-text search + índices |
|
|
8
|
+
| Checkout (validate+process) | < 500ms p95 | Transações atômicas + otimização |
|
|
9
|
+
| Response time geral | < 100ms p50 | CDN para estáticos, cache em camadas |
|
|
10
|
+
|
|
11
|
+
## Escalabilidade
|
|
12
|
+
- **Throughput**: 1000 concurrent users
|
|
13
|
+
- **Armazenamento**: 10k+ produtos no catálogo
|
|
14
|
+
- **Conexões DB**: Connection pooling com 20 conexões
|
|
15
|
+
- **Cache**: Redis com 1GB limite inicial
|
|
16
|
+
- **Estratégia**: Pronto para sharding no futuro
|
|
17
|
+
|
|
18
|
+
## Disponibilidade
|
|
19
|
+
- **Uptime**: 99.9% (máximo 43 min/mês downtime)
|
|
20
|
+
- **RTO** (Recovery Time Objective): 15 minutos
|
|
21
|
+
- **RPO** (Recovery Point Objective): < 5 minutos (backups a cada 5min)
|
|
22
|
+
- **Health Check**: `/api/health` a cada 30s
|
|
23
|
+
|
|
24
|
+
## Segurança
|
|
25
|
+
- **Encryption**: TLS 1.3 em trânsito
|
|
26
|
+
- **Authentication**: JWT com expiry 1h, refresh token 30 dias
|
|
27
|
+
- **Authorization**: RBAC (user, admin)
|
|
28
|
+
- **Input Validation**: Todas as entradas (length, type, format)
|
|
29
|
+
- **SQL Injection**: TypeORM parameterizado (protected)
|
|
30
|
+
- **CORS**: Apenas origins registradas
|
|
31
|
+
- **CSRF**: Tokens no formulário (POST/PUT/DELETE)
|
|
32
|
+
- **Rate Limiting**: 100 req/min por IP
|
|
33
|
+
- **Secrets**: Variáveis de ambiente, nunca em código
|
|
34
|
+
|
|
35
|
+
## Manutenibilidade
|
|
36
|
+
- **Código**: TypeScript strict, 80%+ test coverage
|
|
37
|
+
- **Logs**: Estruturados (JSON), níveis (info, warn, error)
|
|
38
|
+
- **Observabilidade**: Health checks, metricas Prometheus (future)
|
|
39
|
+
- **Documentação**: Cobertura 100% de APIs via Swagger
|
|
40
|
+
- **CI/CD**: Testes automáticos antes de merge
|
|
41
|
+
|
|
42
|
+
## Compliance
|
|
43
|
+
- **LGPD**: Direito ao esquecimento, consentimento explícito
|
|
44
|
+
- **PCI-DSS**: Mock Stripe (dados reais fora do escopo MVP)
|
|
45
|
+
- **Auditoria**: Logs de operações críticas (pagamentos, exclusões)
|
|
46
|
+
- **Backup**: Daily backups, retention 30 dias
|
|
47
|
+
|
|
48
|
+
## Confiabilidade
|
|
49
|
+
- **Idempotência**: Operações críticas (pagamento, pedido) retentáveis
|
|
50
|
+
- **Graceful Degradation**: Cache falha → chama DB
|
|
51
|
+
- **Retry Logic**: Exponential backoff para chamadas externas
|
|
52
|
+
- **Falha em Cascata**: Circuit breaker para dependências externas (future)
|
|
53
|
+
|
|
54
|
+
## Compatibilidade
|
|
55
|
+
- **Browsers**: Chrome, Firefox, Safari, Edge (últimas 2 versões)
|
|
56
|
+
- **Mobile**: Responsivo (iOS Safari, Android Chrome)
|
|
57
|
+
- **APIs**: Versionada (/api/v1), backward compatible
|
|
58
|
+
|
|
59
|
+
## Disaster Recovery
|
|
60
|
+
- **Backup**: Daily full backup + hourly WAL
|
|
61
|
+
- **Replica**: Standby PostgreSQL para failover (future)
|
|
62
|
+
- **Testado**: DR drills mensais
|
|
@@ -1,124 +1,124 @@
|
|
|
1
|
-
# Visão do Produto
|
|
2
|
-
|
|
3
|
-
## Declaração de Visão
|
|
4
|
-
"Uma plataforma de e-commerce moderna que permite empreendedores criar lojas online profissionais com controle total de inventário, pagamentos e análise de vendas."
|
|
5
|
-
|
|
6
|
-
## Personas Principais
|
|
7
|
-
|
|
8
|
-
### 1. **Proprietário da Loja (Store Owner)**
|
|
9
|
-
- **Objetivo**: Vender produtos online de forma fácil e profissional
|
|
10
|
-
- **Desafios**: Gerenciar múltiplos produtos, rastrear pedidos, processar pagamentos
|
|
11
|
-
- **Necessidades**: Dashboard simples, relatórios de vendas, gerenciamento de catálogo
|
|
12
|
-
|
|
13
|
-
### 2. **Cliente Final (Shopper)**
|
|
14
|
-
- **Objetivo**: Encontrar e comprar produtos de forma rápida e segura
|
|
15
|
-
- **Desafios**: Navegar catálogo grande, processar pagamento facilmente
|
|
16
|
-
- **Necessidades**: Busca/filtro, carrinho intuitivo, checkout rápido, rastreamento de pedido
|
|
17
|
-
|
|
18
|
-
### 3. **Gerente de Inventário (Inventory Manager)**
|
|
19
|
-
- **Objetivo**: Manter stock atualizado e evitar overselling
|
|
20
|
-
- **Desafios**: Sincronização em tempo real entre vendas e estoque
|
|
21
|
-
- **Necessidades**: Alertas de low stock, relatórios de movimento
|
|
22
|
-
|
|
23
|
-
## User Stories Críticas
|
|
24
|
-
|
|
25
|
-
### US-001: Catálogo de Produtos
|
|
26
|
-
```
|
|
27
|
-
Como cliente
|
|
28
|
-
Quero buscar, filtrar e visualizar produtos
|
|
29
|
-
Para encontrar o que desejo comprar facilmente
|
|
30
|
-
AC:
|
|
31
|
-
- Listar produtos com paginação
|
|
32
|
-
- Filtrar por categoria, preço, rating
|
|
33
|
-
- Busca por nome/descrição
|
|
34
|
-
- Tempo < 200ms
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
### US-002: Adicionar ao Carrinho
|
|
38
|
-
```
|
|
39
|
-
Como cliente
|
|
40
|
-
Quero adicionar itens ao carrinho e modificar quantidades
|
|
41
|
-
Para revisar antes de checkout
|
|
42
|
-
AC:
|
|
43
|
-
- Adicionar item com quantidade
|
|
44
|
-
- Remover item
|
|
45
|
-
- Atualizar quantidade
|
|
46
|
-
- Carrinho persiste (localStorage ou session)
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### US-003: Checkout e Pagamento
|
|
50
|
-
```
|
|
51
|
-
Como cliente
|
|
52
|
-
Quero fazer checkout seguro e rápido
|
|
53
|
-
Para completar minha compra
|
|
54
|
-
AC:
|
|
55
|
-
- Revisar items e total
|
|
56
|
-
- Informações de entrega
|
|
57
|
-
- Processar pagamento (mock)
|
|
58
|
-
- Confirmação com número de pedido
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### US-004: Rastreamento de Pedido
|
|
62
|
-
```
|
|
63
|
-
Como cliente
|
|
64
|
-
Quero acompanhar meu pedido
|
|
65
|
-
Para saber quando chegar
|
|
66
|
-
AC:
|
|
67
|
-
- Ver status (pendente, processando, enviado, entregue)
|
|
68
|
-
- Ver histórico de mudanças
|
|
69
|
-
- Notificações de mudança de status
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
### US-005: Avaliações de Produtos
|
|
73
|
-
```
|
|
74
|
-
Como cliente
|
|
75
|
-
Quero avaliar produtos que comprei
|
|
76
|
-
Para ajudar outros clientes
|
|
77
|
-
AC:
|
|
78
|
-
- 1-5 stars
|
|
79
|
-
- Texto opcional
|
|
80
|
-
- Mostrar media de ratings
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## Requisitos Funcionais por Módulo
|
|
84
|
-
|
|
85
|
-
### Catálogo (Products + Categories)
|
|
86
|
-
- CRUD de produtos (create, read, update, delete)
|
|
87
|
-
- Categorias hierárquicas
|
|
88
|
-
- Imagens de produto (URL/upload)
|
|
89
|
-
- Preços e promoções
|
|
90
|
-
- Stock disponível
|
|
91
|
-
|
|
92
|
-
### Carrinho (Cart)
|
|
93
|
-
- Persistência de carrinho
|
|
94
|
-
- Cálculo de total com imposto (mock)
|
|
95
|
-
- Aplicação de cupons
|
|
96
|
-
- Validação de stock em checkout
|
|
97
|
-
|
|
98
|
-
### Pedidos (Orders)
|
|
99
|
-
- Criação automática no checkout
|
|
100
|
-
- Status workflow: pending → processing → shipped → delivered
|
|
101
|
-
- Detalhes do cliente e endereço
|
|
102
|
-
- Histórico completo
|
|
103
|
-
|
|
104
|
-
### Pagamentos (Payments)
|
|
105
|
-
- Mock Stripe: sim/não + transactionId
|
|
106
|
-
- Registro de tentativas
|
|
107
|
-
- Webhook simulado (future)
|
|
108
|
-
|
|
109
|
-
### Inventário (Inventory)
|
|
110
|
-
- Reserva de stock no checkout
|
|
111
|
-
- Sincronização com produtos
|
|
112
|
-
- Alerts para reposição
|
|
113
|
-
- Relatórios de movimento
|
|
114
|
-
|
|
115
|
-
### Cupons (Coupons)
|
|
116
|
-
- Código + desconto (% ou R$)
|
|
117
|
-
- Data de validade
|
|
118
|
-
- Uso máximo
|
|
119
|
-
- Aplicação em checkout
|
|
120
|
-
|
|
121
|
-
### Avaliações (Reviews)
|
|
122
|
-
- Rating + texto
|
|
123
|
-
- Moderação (future)
|
|
124
|
-
- Média exibida em produto
|
|
1
|
+
# Visão do Produto
|
|
2
|
+
|
|
3
|
+
## Declaração de Visão
|
|
4
|
+
"Uma plataforma de e-commerce moderna que permite empreendedores criar lojas online profissionais com controle total de inventário, pagamentos e análise de vendas."
|
|
5
|
+
|
|
6
|
+
## Personas Principais
|
|
7
|
+
|
|
8
|
+
### 1. **Proprietário da Loja (Store Owner)**
|
|
9
|
+
- **Objetivo**: Vender produtos online de forma fácil e profissional
|
|
10
|
+
- **Desafios**: Gerenciar múltiplos produtos, rastrear pedidos, processar pagamentos
|
|
11
|
+
- **Necessidades**: Dashboard simples, relatórios de vendas, gerenciamento de catálogo
|
|
12
|
+
|
|
13
|
+
### 2. **Cliente Final (Shopper)**
|
|
14
|
+
- **Objetivo**: Encontrar e comprar produtos de forma rápida e segura
|
|
15
|
+
- **Desafios**: Navegar catálogo grande, processar pagamento facilmente
|
|
16
|
+
- **Necessidades**: Busca/filtro, carrinho intuitivo, checkout rápido, rastreamento de pedido
|
|
17
|
+
|
|
18
|
+
### 3. **Gerente de Inventário (Inventory Manager)**
|
|
19
|
+
- **Objetivo**: Manter stock atualizado e evitar overselling
|
|
20
|
+
- **Desafios**: Sincronização em tempo real entre vendas e estoque
|
|
21
|
+
- **Necessidades**: Alertas de low stock, relatórios de movimento
|
|
22
|
+
|
|
23
|
+
## User Stories Críticas
|
|
24
|
+
|
|
25
|
+
### US-001: Catálogo de Produtos
|
|
26
|
+
```
|
|
27
|
+
Como cliente
|
|
28
|
+
Quero buscar, filtrar e visualizar produtos
|
|
29
|
+
Para encontrar o que desejo comprar facilmente
|
|
30
|
+
AC:
|
|
31
|
+
- Listar produtos com paginação
|
|
32
|
+
- Filtrar por categoria, preço, rating
|
|
33
|
+
- Busca por nome/descrição
|
|
34
|
+
- Tempo < 200ms
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### US-002: Adicionar ao Carrinho
|
|
38
|
+
```
|
|
39
|
+
Como cliente
|
|
40
|
+
Quero adicionar itens ao carrinho e modificar quantidades
|
|
41
|
+
Para revisar antes de checkout
|
|
42
|
+
AC:
|
|
43
|
+
- Adicionar item com quantidade
|
|
44
|
+
- Remover item
|
|
45
|
+
- Atualizar quantidade
|
|
46
|
+
- Carrinho persiste (localStorage ou session)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### US-003: Checkout e Pagamento
|
|
50
|
+
```
|
|
51
|
+
Como cliente
|
|
52
|
+
Quero fazer checkout seguro e rápido
|
|
53
|
+
Para completar minha compra
|
|
54
|
+
AC:
|
|
55
|
+
- Revisar items e total
|
|
56
|
+
- Informações de entrega
|
|
57
|
+
- Processar pagamento (mock)
|
|
58
|
+
- Confirmação com número de pedido
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### US-004: Rastreamento de Pedido
|
|
62
|
+
```
|
|
63
|
+
Como cliente
|
|
64
|
+
Quero acompanhar meu pedido
|
|
65
|
+
Para saber quando chegar
|
|
66
|
+
AC:
|
|
67
|
+
- Ver status (pendente, processando, enviado, entregue)
|
|
68
|
+
- Ver histórico de mudanças
|
|
69
|
+
- Notificações de mudança de status
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### US-005: Avaliações de Produtos
|
|
73
|
+
```
|
|
74
|
+
Como cliente
|
|
75
|
+
Quero avaliar produtos que comprei
|
|
76
|
+
Para ajudar outros clientes
|
|
77
|
+
AC:
|
|
78
|
+
- 1-5 stars
|
|
79
|
+
- Texto opcional
|
|
80
|
+
- Mostrar media de ratings
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Requisitos Funcionais por Módulo
|
|
84
|
+
|
|
85
|
+
### Catálogo (Products + Categories)
|
|
86
|
+
- CRUD de produtos (create, read, update, delete)
|
|
87
|
+
- Categorias hierárquicas
|
|
88
|
+
- Imagens de produto (URL/upload)
|
|
89
|
+
- Preços e promoções
|
|
90
|
+
- Stock disponível
|
|
91
|
+
|
|
92
|
+
### Carrinho (Cart)
|
|
93
|
+
- Persistência de carrinho
|
|
94
|
+
- Cálculo de total com imposto (mock)
|
|
95
|
+
- Aplicação de cupons
|
|
96
|
+
- Validação de stock em checkout
|
|
97
|
+
|
|
98
|
+
### Pedidos (Orders)
|
|
99
|
+
- Criação automática no checkout
|
|
100
|
+
- Status workflow: pending → processing → shipped → delivered
|
|
101
|
+
- Detalhes do cliente e endereço
|
|
102
|
+
- Histórico completo
|
|
103
|
+
|
|
104
|
+
### Pagamentos (Payments)
|
|
105
|
+
- Mock Stripe: sim/não + transactionId
|
|
106
|
+
- Registro de tentativas
|
|
107
|
+
- Webhook simulado (future)
|
|
108
|
+
|
|
109
|
+
### Inventário (Inventory)
|
|
110
|
+
- Reserva de stock no checkout
|
|
111
|
+
- Sincronização com produtos
|
|
112
|
+
- Alerts para reposição
|
|
113
|
+
- Relatórios de movimento
|
|
114
|
+
|
|
115
|
+
### Cupons (Coupons)
|
|
116
|
+
- Código + desconto (% ou R$)
|
|
117
|
+
- Data de validade
|
|
118
|
+
- Uso máximo
|
|
119
|
+
- Aplicação em checkout
|
|
120
|
+
|
|
121
|
+
### Avaliações (Reviews)
|
|
122
|
+
- Rating + texto
|
|
123
|
+
- Moderação (future)
|
|
124
|
+
- Média exibida em produto
|