forjajs 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +25 -0
- package/.claude/agents/governance.md +32 -0
- package/.claude/agents/marketing.md +24 -0
- package/.claude/agents/orchestrator.md +31 -0
- package/.claude/agents/product.md +26 -0
- package/.claude/agents/sdd-architect.md +34 -0
- package/.claude/settings.json +41 -0
- package/.gemini-instructions.md +87 -0
- package/.github/copilot-instructions.md +87 -0
- package/.memoryrc.json +104 -0
- package/.openai-instructions.md +87 -0
- package/AGENTS.md +132 -0
- package/CHANGELOG.md +106 -0
- package/CONTRIBUTING.md +32 -0
- package/DOC-MAP.md +65 -0
- package/LICENSE +21 -0
- package/README.md +260 -0
- package/bin/create-memory-nest-kit.js +125 -0
- package/bin/forja.mjs +143 -0
- package/bin/init-project.js +612 -0
- package/boilerplates/01-api-rest/README.md +336 -0
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
- package/boilerplates/02-saas-starter/.env.example +25 -0
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
- package/boilerplates/02-saas-starter/INFO.md +252 -0
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
- package/boilerplates/02-saas-starter/README.md +305 -0
- package/boilerplates/02-saas-starter/START-HERE.md +259 -0
- package/boilerplates/02-saas-starter/backend/package.json +87 -0
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
- package/boilerplates/03-ecommerce-starter/README.md +465 -0
- package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
- package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
- package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
- package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
- package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/.env.example +43 -0
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
- package/boilerplates/04-microservices-starter/INDEX.md +377 -0
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
- package/boilerplates/04-microservices-starter/README.md +466 -0
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
- package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
- package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/04-microservices-starter/package.json +21 -0
- package/boilerplates/05-monorepo-starter/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
- package/boilerplates/05-monorepo-starter/README.md +318 -0
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
- package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
- package/boilerplates/05-monorepo-starter/package.json +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
- package/boilerplates/05-monorepo-starter/turbo.json +35 -0
- package/boilerplates/README.md +407 -0
- package/design-md/BRIEF-TEMPLATE.md +47 -0
- package/design-md/INDEX.md +35 -0
- package/design-md/MATRIX.md +24 -0
- package/design-md/PLAYBOOK.md +35 -0
- package/design-md/examples/agent-console-brief.md +48 -0
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
- package/docs/agent-harnesses.md +122 -0
- package/docs/archive/CHECKLIST-FINAL.md +295 -0
- package/docs/archive/FASE2-SUMMARY.md +263 -0
- package/docs/archive/FASE3-PROGRESS.md +355 -0
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
- package/docs/archive/INDICE-MASTER.md +282 -0
- package/docs/archive/PROJETO-COMPLETO.md +363 -0
- package/docs/archive/README-REFINAMENTO.md +293 -0
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
- package/docs/archive/REFINAMENTO-v1.0.md +565 -0
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
- package/docs/archive/START-HERE.md +319 -0
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
- package/docs/archive/examples/v1/AGENTS.md +10 -0
- package/docs/archive/examples/v1/README.md +36 -0
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v1/backend/package.json +42 -0
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v1/backend/src/main.ts +10 -0
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v1/docs/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
- package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/.memoryrc.json +8 -0
- package/docs/archive/examples/v2/AGENTS.md +16 -0
- package/docs/archive/examples/v2/README.md +35 -0
- package/docs/archive/examples/v2/agents/README.md +3 -0
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
- package/docs/archive/examples/v2/agents/dba.md +4 -0
- package/docs/archive/examples/v2/agents/frontend.md +4 -0
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
- package/docs/archive/examples/v2/agents/reviewer.md +6 -0
- package/docs/archive/examples/v2/agents/security.md +4 -0
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
- package/docs/archive/examples/v2/backend/package.json +42 -0
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
- package/docs/archive/examples/v2/backend/src/main.ts +10 -0
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
- package/docs/archive/examples/v2/docs/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
- package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
- package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
- package/docs/archive/examples/v2/memory/README.md +8 -0
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
- package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
- package/docs/capacidades-externas.md +70 -0
- package/docs/cli-first-operacao.md +74 -0
- package/docs/dashboard.md +102 -0
- package/docs/dev-workflow.md +421 -0
- package/docs/examples.md +546 -0
- package/docs/fluxo.md +103 -0
- package/docs/glossary.md +453 -0
- package/docs/init-project.md +457 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
- package/docs/personas/architect/README.md +333 -0
- package/docs/personas/developer/README.md +371 -0
- package/docs/personas/executive/README.md +172 -0
- package/docs/personas/qa/README.md +350 -0
- package/docs/processo-projeto.md +138 -0
- package/docs/publishing.md +377 -0
- package/docs/quick-reference.md +409 -0
- package/docs/structure.md +360 -0
- package/docs/token-optimization.md +494 -0
- package/lib/context-builder.js +257 -0
- package/lib/core/registry.mjs +284 -0
- package/lib/generators/memory-generator.js +844 -0
- package/lib/generators/nest-generator.js +496 -0
- package/lib/generators/readme-generator.js +213 -0
- package/lib/templates/harness/code-intel.mjs +119 -0
- package/lib/templates/harness/mcp.json +10 -0
- package/lib/utils/file-helpers.js +40 -0
- package/lib/validators/structure-validator.js +253 -0
- package/lib/workspace.mjs +213 -0
- package/memory/00-global/mission.md +15 -0
- package/memory/00-global/shared-knowledge.md +8 -0
- package/memory/00-global/standards.md +47 -0
- package/memory/10-product/personas.md +21 -0
- package/memory/10-product/vision.md +27 -0
- package/memory/30-projects/README.md +15 -0
- package/memory/40-delivery/backlog.md +15 -0
- package/memory/40-delivery/current-sprint.md +21 -0
- package/memory/50-orchestration/gsd-harness.md +55 -0
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
- package/memory/90-decisions/0006-docs-por-persona.md +23 -0
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
- package/memory/90-decisions/0010-banco-postgres.md +30 -0
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
- package/memory/90-decisions/0019-workspace-separado.md +45 -0
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
- package/memory/90-decisions/_template.md +28 -0
- package/package.json +107 -0
- package/prompts/context-engineer-agent.md +19 -0
- package/prompts/governance-agent.md +15 -0
- package/prompts/marketing-agent.md +13 -0
- package/prompts/orchestrator-agent.md +18 -0
- package/prompts/product-agent.md +13 -0
- package/prompts/sdd-architect-agent.md +20 -0
- package/scripts/agent-harness.mjs +578 -0
- package/scripts/agent-router.mjs +189 -0
- package/scripts/build-smart-context.js +87 -0
- package/scripts/check-standards.js +98 -0
- package/scripts/compress-memory.mjs +198 -0
- package/scripts/compress-project-memory.js +58 -0
- package/scripts/context-ops.mjs +463 -0
- package/scripts/dev.mjs +349 -0
- package/scripts/extract-global-knowledge.js +52 -0
- package/scripts/generate-dashboard.js +59 -0
- package/scripts/hook-session-start.mjs +70 -0
- package/scripts/hook-user-prompt.mjs +185 -0
- package/scripts/memory-schema.mjs +68 -0
- package/scripts/pre-commit.sh +102 -0
- package/scripts/query-universal-memory.js +50 -0
- package/scripts/spec-cli.mjs +193 -0
- package/scripts/sprint-manager.js +200 -0
- package/scripts/sync-universal-memory.js +278 -0
- package/scripts/token-benchmark.mjs +203 -0
- package/scripts/tools-doctor.mjs +77 -0
- package/specs/README.md +70 -0
- package/specs/_templates/plan.md +43 -0
- package/specs/_templates/spec.md +43 -0
- package/specs/_templates/tasks.md +32 -0
- package/specs/agent-dashboard/plan.md +165 -0
- package/specs/agent-dashboard/spec.md +89 -0
- package/specs/agent-dashboard/tasks.md +168 -0
- package/specs/cli-first-operacao/plan.md +53 -0
- package/specs/cli-first-operacao/spec.md +53 -0
- package/specs/cli-first-operacao/tasks.md +53 -0
- package/specs/dev-token-assets-db/plan.md +71 -0
- package/specs/dev-token-assets-db/spec.md +58 -0
- package/specs/dev-token-assets-db/tasks.md +58 -0
- package/specs/forja-core/spec.md +71 -0
- package/specs/harness-codegraph/spec.md +71 -0
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
- package/specs/reestruturacao-forja-v2/plan.md +95 -0
- package/specs/reestruturacao-forja-v2/spec.md +70 -0
- package/specs/reestruturacao-forja-v2/tasks.md +113 -0
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { Test, TestingModule } from '@nestjs/testing';
|
|
2
|
+
import { INestApplication } from '@nestjs/common';
|
|
3
|
+
import * as request from 'supertest';
|
|
4
|
+
import { AppModule } from '../src/app.module';
|
|
5
|
+
|
|
6
|
+
describe('Health (e2e)', () => {
|
|
7
|
+
let app: INestApplication;
|
|
8
|
+
|
|
9
|
+
beforeAll(async () => {
|
|
10
|
+
const moduleFixture: TestingModule = await Test.createTestingModule({
|
|
11
|
+
imports: [AppModule],
|
|
12
|
+
}).compile();
|
|
13
|
+
|
|
14
|
+
app = moduleFixture.createNestApplication();
|
|
15
|
+
await app.init();
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
afterAll(async () => {
|
|
19
|
+
await app.close();
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
it('GET /api/health should return status up', () => {
|
|
23
|
+
return request(app.getHttpServer())
|
|
24
|
+
.get('/api/health')
|
|
25
|
+
.expect(200)
|
|
26
|
+
.expect((res) => {
|
|
27
|
+
expect(res.body).toHaveProperty('status');
|
|
28
|
+
expect(res.body.status).toBe('up');
|
|
29
|
+
});
|
|
30
|
+
});
|
|
31
|
+
});
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"module": "commonjs",
|
|
4
|
+
"target": "ES2020",
|
|
5
|
+
"lib": ["ES2020"],
|
|
6
|
+
"declaration": true,
|
|
7
|
+
"outDir": "./dist",
|
|
8
|
+
"rootDir": "./src",
|
|
9
|
+
"strict": true,
|
|
10
|
+
"esModuleInterop": true,
|
|
11
|
+
"skipLibCheck": true,
|
|
12
|
+
"forceConsistentCasingInFileNames": true,
|
|
13
|
+
"resolveJsonModule": true,
|
|
14
|
+
"allowSyntheticDefaultImports": true,
|
|
15
|
+
"moduleResolution": "node",
|
|
16
|
+
"baseUrl": ".",
|
|
17
|
+
"paths": {
|
|
18
|
+
"@/*": ["src/*"]
|
|
19
|
+
}
|
|
20
|
+
},
|
|
21
|
+
"include": ["src/**/*"],
|
|
22
|
+
"exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
|
|
23
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "1.0",
|
|
3
|
+
"type": "boilerplate",
|
|
4
|
+
"name": "03-ecommerce-starter",
|
|
5
|
+
"title": "E-Commerce Starter - Boilerplate Completo",
|
|
6
|
+
"path": "boilerplates/03-ecommerce-starter",
|
|
7
|
+
"readme": "boilerplates/03-ecommerce-starter/README.md",
|
|
8
|
+
"stack": [
|
|
9
|
+
"NestJS",
|
|
10
|
+
"React",
|
|
11
|
+
"Docker",
|
|
12
|
+
"JWT",
|
|
13
|
+
"Postgres"
|
|
14
|
+
],
|
|
15
|
+
"useCases": [
|
|
16
|
+
"E-Commerce",
|
|
17
|
+
"Admin",
|
|
18
|
+
"Auth"
|
|
19
|
+
],
|
|
20
|
+
"commands": [
|
|
21
|
+
"npm install",
|
|
22
|
+
"npm run start:dev",
|
|
23
|
+
"docker compose up -d",
|
|
24
|
+
"npm test"
|
|
25
|
+
],
|
|
26
|
+
"gates": [
|
|
27
|
+
"npm run spec:check",
|
|
28
|
+
"npm test",
|
|
29
|
+
"npm run project:check"
|
|
30
|
+
],
|
|
31
|
+
"tokenPolicy": {
|
|
32
|
+
"firstRead": [
|
|
33
|
+
"boilerplate.manifest.json",
|
|
34
|
+
"README.md"
|
|
35
|
+
],
|
|
36
|
+
"avoidLoadingByDefault": [
|
|
37
|
+
"node_modules",
|
|
38
|
+
"dist",
|
|
39
|
+
"coverage"
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# E-Commerce Starter Boilerplate
|
|
2
|
+
|
|
3
|
+
Este é o boilerplate de e-commerce completo gerado pelo `create-memory-nest-kit`.
|
|
4
|
+
|
|
5
|
+
## Estrutura
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
03-ecommerce-starter/
|
|
9
|
+
├── README.md # Documentação principal
|
|
10
|
+
├── FLOW_EXEMPLOS.md # Exemplos de API com curl
|
|
11
|
+
├── .gitignore # Git ignore
|
|
12
|
+
│
|
|
13
|
+
├── memory/ # 10 níveis de contexto (estrutura-padrão)
|
|
14
|
+
│ ├── 00-global/ # Missão, padrões, contexto
|
|
15
|
+
│ ├── 10-product/ # Visão, personas, regras
|
|
16
|
+
│ ├── 20-architecture/ # Design técnico
|
|
17
|
+
│ ├── 30-domains/ # Contexto por domínio
|
|
18
|
+
│ │ ├── catalog/ # Produtos e categorias
|
|
19
|
+
│ │ ├── orders/ # Pedidos
|
|
20
|
+
│ │ ├── payments/ # Pagamentos
|
|
21
|
+
│ │ └── inventory/ # Estoque
|
|
22
|
+
│ ├── 40-delivery/ # Roadmap (futuro)
|
|
23
|
+
│ ├── 50-orchestration/ # Agentes, handoffs (futuro)
|
|
24
|
+
│ ├── 60-runs/ # Logs de execução (futuro)
|
|
25
|
+
│ ├── 70-summaries/ # Resumos (futuro)
|
|
26
|
+
│ ├── 80-data/ # Schemas PostgreSQL
|
|
27
|
+
│ └── 90-decisions/ # ADRs
|
|
28
|
+
│
|
|
29
|
+
├── backend/ # Aplicação NestJS
|
|
30
|
+
│ ├── src/
|
|
31
|
+
│ │ ├── main.ts
|
|
32
|
+
│ │ ├── app.module.ts
|
|
33
|
+
│ │ └── modules/
|
|
34
|
+
│ │ ├── products/ # Catálogo
|
|
35
|
+
│ │ ├── cart/ # Carrinho
|
|
36
|
+
│ │ ├── orders/ # Pedidos
|
|
37
|
+
│ │ ├── payments/ # Pagamentos
|
|
38
|
+
│ │ ├── inventory/ # Inventário
|
|
39
|
+
│ │ ├── coupons/ # Cupons
|
|
40
|
+
│ │ ├── reviews/ # Avaliações
|
|
41
|
+
│ │ └── auth/ # Autenticação (mock)
|
|
42
|
+
│ ├── test/
|
|
43
|
+
│ ├── docker-compose.yml
|
|
44
|
+
│ ├── Dockerfile
|
|
45
|
+
│ ├── package.json
|
|
46
|
+
│ ├── tsconfig.json
|
|
47
|
+
│ ├── jest.config.js
|
|
48
|
+
│ └── .env.example
|
|
49
|
+
│
|
|
50
|
+
├── agents/ # Agentes AI (futuro)
|
|
51
|
+
├── skills/ # Skills customizadas (futuro)
|
|
52
|
+
└── prompts/ # Prompts para agentes (futuro)
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Quick Start
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
cd backend
|
|
59
|
+
docker-compose up -d
|
|
60
|
+
cp .env.example .env
|
|
61
|
+
npm install
|
|
62
|
+
npm run start:dev
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Acesse: http://localhost:3000/docs
|
|
66
|
+
|
|
67
|
+
## Documentação
|
|
68
|
+
|
|
69
|
+
Consulte `memory/` para detalhes completos:
|
|
70
|
+
|
|
71
|
+
- **Visão** → `memory/10-product/vision.md`
|
|
72
|
+
- **Arquitetura** → `memory/20-architecture/overview.md`
|
|
73
|
+
- **Domínios** → `memory/30-domains/*/context.md`
|
|
74
|
+
- **API Exemplos** → `FLOW_EXEMPLOS.md`
|
|
75
|
+
|
|
76
|
+
## Endpoints Principais
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# Produtos
|
|
80
|
+
GET /api/products
|
|
81
|
+
GET /api/products/:id
|
|
82
|
+
POST /api/products (admin)
|
|
83
|
+
|
|
84
|
+
# Carrinho
|
|
85
|
+
POST /api/cart/add
|
|
86
|
+
GET /api/cart
|
|
87
|
+
POST /api/cart/apply-coupon
|
|
88
|
+
|
|
89
|
+
# Checkout
|
|
90
|
+
POST /api/payments/process
|
|
91
|
+
|
|
92
|
+
# Pedidos
|
|
93
|
+
GET /api/orders
|
|
94
|
+
GET /api/orders/:id
|
|
95
|
+
PUT /api/orders/:id/status (admin)
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Stack
|
|
99
|
+
|
|
100
|
+
- **Runtime**: Node.js 18+
|
|
101
|
+
- **Framework**: NestJS 10
|
|
102
|
+
- **Language**: TypeScript
|
|
103
|
+
- **DB**: PostgreSQL 14
|
|
104
|
+
- **Cache**: Redis (future)
|
|
105
|
+
- **API Docs**: Swagger/OpenAPI
|
|
106
|
+
|
|
107
|
+
## Testes
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
npm run test # Unitários
|
|
111
|
+
npm run test:e2e # E2E
|
|
112
|
+
npm run test:cov # Coverage
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Deploy
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
docker build -t ecommerce-api:1.0 .
|
|
119
|
+
docker run -p 3000:3000 --env-file .env ecommerce-api:1.0
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Autores
|
|
123
|
+
|
|
124
|
+
Criado com ❤️ pelo `create-memory-nest-kit` CLI
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
**Nota**: Este é um boilerplate educacional. Para produção, adicionar autenticação real, PCI compliance, e integração com Stripe real.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Contrato de Agentes (Agent Contract)
|
|
2
|
+
|
|
3
|
+
## Princípios
|
|
4
|
+
1. **Responsabilidade Única**: Cada agente tem um domínio/skill claro
|
|
5
|
+
2. **Comunicação Explícita**: Via memory/, handoffs com timestamp
|
|
6
|
+
3. **Falha Graceful**: Sempre reportar status, não falhar silenciosamente
|
|
7
|
+
4. **Rastreabilidade**: Toda ação registrada em 60-runs/
|
|
8
|
+
|
|
9
|
+
## Agentes Definidos
|
|
10
|
+
|
|
11
|
+
### Orchestrator (orquestrador)
|
|
12
|
+
- **Responsabilidade**: Coordenação, routing, handoffs
|
|
13
|
+
- **Entrada**: Requisições de novos features, bugs
|
|
14
|
+
- **Saída**: Handoff estruturado em 50-orchestration/handoffs/
|
|
15
|
+
- **SLA**: Responde em < 5min
|
|
16
|
+
|
|
17
|
+
### Backend-NestJS
|
|
18
|
+
- **Responsabilidade**: API REST, domain logic, persistência
|
|
19
|
+
- **Input**: Requisições do Orchestrator
|
|
20
|
+
- **Output**: Código em `backend/src/`, testes, migrations
|
|
21
|
+
- **Constraints**: TypeScript strict, testes obrigatórios
|
|
22
|
+
|
|
23
|
+
### Frontend (future)
|
|
24
|
+
- **Responsabilidade**: UI/UX, integração com backend
|
|
25
|
+
- **Input**: API contracts do backend
|
|
26
|
+
- **Output**: React/Vue components, stories
|
|
27
|
+
|
|
28
|
+
### DBA (future)
|
|
29
|
+
- **Responsabilidade**: Schemas, migrations, performance
|
|
30
|
+
- **Input**: Entidades do backend
|
|
31
|
+
- **Output**: Migrations, índices, queries otimizadas
|
|
32
|
+
|
|
33
|
+
### Security
|
|
34
|
+
- **Responsabilidade**: Validação, autenticação, compliance
|
|
35
|
+
- **Input**: Code review, arquitetura
|
|
36
|
+
- **Output**: Recomendações, fixes
|
|
37
|
+
|
|
38
|
+
## Handoff Format
|
|
39
|
+
```
|
|
40
|
+
memory/50-orchestration/handoffs/[ISO8601-slug].md
|
|
41
|
+
---
|
|
42
|
+
From: Orchestrator
|
|
43
|
+
To: Backend-NestJS
|
|
44
|
+
Status: pending | in-progress | completed
|
|
45
|
+
Task: [Breve descrição]
|
|
46
|
+
Context: [Link para memory/]
|
|
47
|
+
Artifacts: [Arquivos gerados]
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Escalação
|
|
51
|
+
- Bug crítico → Backend-NestJS direct
|
|
52
|
+
- Decisão arquitetural → Security + Backend-NestJS (ADR em 90-decisions)
|
|
53
|
+
- Feature complexa → Orchestrator → decomposição em subtasks
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Índice de Contexto Global
|
|
2
|
+
|
|
3
|
+
## Navegação Rápida
|
|
4
|
+
|
|
5
|
+
### 📋 Estratégia (00-global)
|
|
6
|
+
- [Mission](mission.md) - Visão e KPIs
|
|
7
|
+
- [Standards](standards.md) - Padrões técnicos
|
|
8
|
+
- [Context Policy](context-policy.md) - Como estruturamos conhecimento
|
|
9
|
+
- [Agent Contract](agent-contract.md) - Acordos entre agentes
|
|
10
|
+
- [Context Index](context-index.md) - Este arquivo
|
|
11
|
+
|
|
12
|
+
### 🎯 Produto (10-product)
|
|
13
|
+
- [Vision](../10-product/vision.md) - Personas, user stories
|
|
14
|
+
- [Business Rules](../10-product/business-rules.md) - Regras de negócio
|
|
15
|
+
- [NFRs](../10-product/nfrs.md) - Performance, segurança, compliance
|
|
16
|
+
|
|
17
|
+
### 🏗️ Arquitetura (20-architecture)
|
|
18
|
+
- [Overview](../20-architecture/overview.md) - Componentes, fluxo
|
|
19
|
+
- [Backend](../20-architecture/backend.md) - NestJS, módulos
|
|
20
|
+
- [Data](../20-architecture/data.md) - Schemas PostgreSQL
|
|
21
|
+
- [Security](../20-architecture/security.md) - Autenticação, autorização
|
|
22
|
+
- [Observability](../20-architecture/observability.md) - Logs, metricas
|
|
23
|
+
|
|
24
|
+
### 🎪 Domínios (30-domains)
|
|
25
|
+
- [Catalog](../30-domains/catalog/) - Produtos e categorias
|
|
26
|
+
- [Orders](../30-domains/orders/) - Pedidos e status
|
|
27
|
+
- [Payments](../30-domains/payments/) - Mock Stripe
|
|
28
|
+
- [Inventory](../30-domains/inventory/) - Stock management
|
|
29
|
+
|
|
30
|
+
### 📊 Entrega (40-delivery, 50-orchestration, etc)
|
|
31
|
+
- [Roadmap](../40-delivery/roadmap.md) - Timeline
|
|
32
|
+
- [Current Sprint](../40-delivery/current-sprint.md) - Backlog atual
|
|
33
|
+
- [Orchestration](../50-orchestration/topology.md) - Topologia de agentes
|
|
34
|
+
- [Handoffs](../50-orchestration/handoffs/) - Histórico de trocas
|
|
35
|
+
|
|
36
|
+
### 📈 Relatórios (70-summaries)
|
|
37
|
+
- [Global Summary](../70-summaries/global.md) - Estado geral
|
|
38
|
+
- [Domain Summaries](../70-summaries/domains/) - Por bounded domain
|
|
39
|
+
|
|
40
|
+
### 🛠️ Data (80-data)
|
|
41
|
+
- [SQLite Schema](../80-data/sqlite.md) - Se aplicável
|
|
42
|
+
|
|
43
|
+
### 🤔 Decisões (90-decisions)
|
|
44
|
+
- [ADR Template](../90-decisions/ADR-TEMPLATE.md)
|
|
45
|
+
- ADRs específicas conforme necessário
|
|
46
|
+
|
|
47
|
+
## Como Usar Este Índice
|
|
48
|
+
1. Começar aqui para entender estrutura
|
|
49
|
+
2. Ir para 00-global/context-policy.md para entender como estruturamos
|
|
50
|
+
3. Consultar domínios específicos em 30-domains/
|
|
51
|
+
4. Trackear progresso em 40-delivery/
|
|
52
|
+
5. Escalações arquiteturais → 90-decisions/
|
|
53
|
+
|
|
54
|
+
## Última Atualização
|
|
55
|
+
2024-01-XX por create-memory-nest-kit CLI
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Política de Contexto e Comunicação
|
|
2
|
+
|
|
3
|
+
## Estrutura de Contexto
|
|
4
|
+
- **0-global**: Estratégia, padrões, contrato de agentes
|
|
5
|
+
- **10-product**: Requisitos, personas, regras de negócio
|
|
6
|
+
- **20-architecture**: Design técnico, componentes, fluxos
|
|
7
|
+
- **30-domains**: Contexto por bounded domain (catalog, orders, payments, inventory)
|
|
8
|
+
- **40-delivery**: Roadmap, sprints, backlog
|
|
9
|
+
- **50-orchestration**: Roteamento entre agentes, handoffs, parallelização
|
|
10
|
+
- **60-runs**: Logs de execução, timestamp, status
|
|
11
|
+
- **70-summaries**: Resumos executivos e técnicos
|
|
12
|
+
- **80-data**: Schemas, SQLite docs
|
|
13
|
+
- **90-decisions**: ADRs (Architecture Decision Records)
|
|
14
|
+
|
|
15
|
+
## Fluxo de Comunicação
|
|
16
|
+
1. **Orquestrador** lê missão + padrões
|
|
17
|
+
2. **Agentes de negócio** consultam 10-product + 30-domains
|
|
18
|
+
3. **Agentes técnicos** consultam 20-architecture + padrões
|
|
19
|
+
4. **Após execução** → append em 50-orchestration/handoffs/ com timestamp
|
|
20
|
+
5. **Consolidação** → update em 70-summaries/
|
|
21
|
+
|
|
22
|
+
## Critério de Atualização
|
|
23
|
+
- Mudanças de requisito → 10-product
|
|
24
|
+
- Mudanças arquiteturais → 20-architecture + 90-decisions (ADR)
|
|
25
|
+
- Novos domínios → 30-domains/<novo>/
|
|
26
|
+
- Decisões → 90-decisions/ADR-XXX.md (ISO 8601 + slug)
|
|
27
|
+
|
|
28
|
+
## Retenção
|
|
29
|
+
- Runs: Últimas 30 dias em 60-runs/
|
|
30
|
+
- Handoffs: Permanente em 50-orchestration/handoffs/
|
|
31
|
+
- Summaries: Sempre consolidados (1 global + 1 por domínio)
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Missão do E-Commerce Starter
|
|
2
|
+
|
|
3
|
+
## Visão Executiva
|
|
4
|
+
Construir uma plataforma de e-commerce modular, escalável e pronta para produção que permita venda de produtos online com funcionalidades completas de catálogo, carrinho, checkout e gerenciamento de pedidos.
|
|
5
|
+
|
|
6
|
+
## Objetivos Estratégicos
|
|
7
|
+
1. **Catálogo Dinâmico** - Gerenciar produtos com categorias, descrições, preços e imagens
|
|
8
|
+
2. **Experiência de Compra** - Carrinho de compras fluido e checkout simplificado
|
|
9
|
+
3. **Processamento de Pagamentos** - Integração com gateway de pagamentos (mock Stripe)
|
|
10
|
+
4. **Gestão de Pedidos** - Rastreamento completo do lifecycle de pedidos
|
|
11
|
+
5. **Controle de Inventário** - Stock management em tempo real
|
|
12
|
+
6. **Análise de Produtos** - Sistema de avaliações e reviews
|
|
13
|
+
|
|
14
|
+
## Pilares Técnicos
|
|
15
|
+
- **Backend**: NestJS + PostgreSQL
|
|
16
|
+
- **Cache**: Redis para performance
|
|
17
|
+
- **Documentação**: Memory-driven architecture
|
|
18
|
+
- **Testing**: E2E coverage para fluxos críticos
|
|
19
|
+
- **Escalabilidade**: Pronto para microsserviços
|
|
20
|
+
|
|
21
|
+
## KPIs de Sucesso
|
|
22
|
+
- Tempo de resposta < 200ms para listagem de produtos
|
|
23
|
+
- Checkout completo em < 30 segundos
|
|
24
|
+
- 99.9% uptime
|
|
25
|
+
- Suporte a 10k+ produtos no catálogo
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Padrões Técnicos e Convenções
|
|
2
|
+
|
|
3
|
+
## Código
|
|
4
|
+
- **Linguagem**: TypeScript (strict mode)
|
|
5
|
+
- **Framework**: NestJS com arquitetura modular
|
|
6
|
+
- **Convenção de Nomes**:
|
|
7
|
+
- Classes: PascalCase (ProductService, CartController)
|
|
8
|
+
- Métodos: camelCase (getProducts, addToCart)
|
|
9
|
+
- Constantes: UPPER_SNAKE_CASE
|
|
10
|
+
- Variáveis: camelCase
|
|
11
|
+
- **Organização**: One file per class/interface
|
|
12
|
+
- **Imports**: Agrupar por externa → interna → relativa
|
|
13
|
+
|
|
14
|
+
## Banco de Dados
|
|
15
|
+
- **Database**: PostgreSQL
|
|
16
|
+
- **Migrations**: TypeORM CLI
|
|
17
|
+
- **Entities**: Uma entity por arquivo
|
|
18
|
+
- **Relacionamentos**: lazy loading onde apropriado
|
|
19
|
+
- **Índices**: Em campos frequentemente consultados (product_id, user_id)
|
|
20
|
+
|
|
21
|
+
## API
|
|
22
|
+
- **Versionamento**: `/api/v1` (future-ready)
|
|
23
|
+
- **Respostas**: JSON com estrutura consistente
|
|
24
|
+
- **Erros**: HTTP status codes semânticos + error codes internos
|
|
25
|
+
- **Paginação**: offset/limit padrão
|
|
26
|
+
- **Rate Limiting**: 100 requests/min por cliente
|
|
27
|
+
|
|
28
|
+
## Testes
|
|
29
|
+
- **Framework**: Jest
|
|
30
|
+
- **Coverage**: > 80% para módulos críticos
|
|
31
|
+
- **E2E**: Fluxos de checkout, pagamento, pedidos
|
|
32
|
+
- **Naming**: `*.spec.ts` (unitários), `*.e2e-spec.ts` (integração)
|
|
33
|
+
|
|
34
|
+
## Segurança
|
|
35
|
+
- **Auth**: JWT com refresh tokens
|
|
36
|
+
- **CORS**: Configurável por ambiente
|
|
37
|
+
- **Inputs**: Validação com class-validator + sanitização
|
|
38
|
+
- **Secrets**: Via .env (não em código)
|
|
39
|
+
- **HTTPS**: Obrigatório em produção
|
|
40
|
+
|
|
41
|
+
## Documentação
|
|
42
|
+
- **Memory**: 10 níveis por domínio
|
|
43
|
+
- **API Docs**: Swagger via NestJS decorators
|
|
44
|
+
- **README**: Setup, arquitetura, exemplos curl
|
|
45
|
+
- **Commits**: Semantic versioning (feat:, fix:, docs:)
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Regras de Negócio
|
|
2
|
+
|
|
3
|
+
## Preços e Promoções
|
|
4
|
+
- Preço base é obrigatório (> 0)
|
|
5
|
+
- Promoções podem ser por cupom ou hardcoded em produto
|
|
6
|
+
- Desconto máximo: 100% (produto grátis permitido)
|
|
7
|
+
- Imposto: 15% calculado no checkout (simplificado)
|
|
8
|
+
- Total = (subtotal com desconto) * 1.15
|
|
9
|
+
|
|
10
|
+
## Carrinho
|
|
11
|
+
- Carrinho máximo: 100 itens
|
|
12
|
+
- Quantidade mínima por item: 1
|
|
13
|
+
- Quantidade máxima por item: 1000
|
|
14
|
+
- Carrinho vazio após 30 dias de inatividade (cookie)
|
|
15
|
+
- Um cupom por carrinho
|
|
16
|
+
|
|
17
|
+
## Pedidos
|
|
18
|
+
- Pedido = tudo ou nada (transação atômica)
|
|
19
|
+
- Se stock insuficiente → falha no checkout
|
|
20
|
+
- Número de pedido: UUID
|
|
21
|
+
- Apenas clientes autenticados podem fazer pedidos (para MVP, mock user)
|
|
22
|
+
- Histórico de pedido imutável
|
|
23
|
+
|
|
24
|
+
## Inventário
|
|
25
|
+
- Stock negativo NÃO permitido
|
|
26
|
+
- Reposição manual (input de gerente)
|
|
27
|
+
- Alerta quando < 5 unidades
|
|
28
|
+
- Reserva de stock ocorre no checkout (não em "add to cart")
|
|
29
|
+
|
|
30
|
+
## Pagamentos (Mock Stripe)
|
|
31
|
+
- Taxa simulada: 2.9% + R$0.30 por transação
|
|
32
|
+
- Lógica simples: 90% sucesso, 10% falha (aleatório)
|
|
33
|
+
- Transação bem-sucedida → order status = processing
|
|
34
|
+
- Transação falha → libera stock, order status = failed
|
|
35
|
+
|
|
36
|
+
## Avaliações
|
|
37
|
+
- Apenas comprador pode avaliar seu próprio pedido
|
|
38
|
+
- Uma avaliação por item de pedido
|
|
39
|
+
- Números de 1-5 (sem 0 ou decimais)
|
|
40
|
+
- Texto até 500 caracteres
|
|
41
|
+
- Não há exclusão (soft delete opcional)
|
|
42
|
+
|
|
43
|
+
## Segurança
|
|
44
|
+
- Sem autenticação real em MVP (mock JWT)
|
|
45
|
+
- Senhas não são armazenadas em MVP
|
|
46
|
+
- HTTPS obrigatório em produção
|
|
47
|
+
- Rate limiting: 100 req/min por IP
|
|
48
|
+
- Validação de input obrigatória
|
|
49
|
+
|
|
50
|
+
## Performance
|
|
51
|
+
- Produtos listados com paginação (padrão: 20 por página)
|
|
52
|
+
- Cache Redis para:
|
|
53
|
+
- Categorias (TTL 1h)
|
|
54
|
+
- Produtos top-sellers (TTL 30min)
|
|
55
|
+
- Carrinho (TTL 24h)
|
|
56
|
+
- Busca full-text em nome/descrição (ILIKE em PostgreSQL)
|
|
57
|
+
|
|
58
|
+
## Conformidade
|
|
59
|
+
- LGPD: Dados de cliente não são exportados (apenas em solicitação)
|
|
60
|
+
- Termos de serviço aceitos no checkout (mock)
|
|
61
|
+
- Política de privacidade disponível
|
|
62
|
+
- Cancelamento de conta = soft delete (dados retidos 90 dias)
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Requisitos Não-Funcionais (NFRs)
|
|
2
|
+
|
|
3
|
+
## Performance
|
|
4
|
+
| Requisito | Target | Método |
|
|
5
|
+
|-----------|--------|--------|
|
|
6
|
+
| Listagem de produtos | < 200ms p95 | Índices + paginação + cache |
|
|
7
|
+
| Busca/filtro | < 300ms p95 | Full-text search + índices |
|
|
8
|
+
| Checkout (validate+process) | < 500ms p95 | Transações atômicas + otimização |
|
|
9
|
+
| Response time geral | < 100ms p50 | CDN para estáticos, cache em camadas |
|
|
10
|
+
|
|
11
|
+
## Escalabilidade
|
|
12
|
+
- **Throughput**: 1000 concurrent users
|
|
13
|
+
- **Armazenamento**: 10k+ produtos no catálogo
|
|
14
|
+
- **Conexões DB**: Connection pooling com 20 conexões
|
|
15
|
+
- **Cache**: Redis com 1GB limite inicial
|
|
16
|
+
- **Estratégia**: Pronto para sharding no futuro
|
|
17
|
+
|
|
18
|
+
## Disponibilidade
|
|
19
|
+
- **Uptime**: 99.9% (máximo 43 min/mês downtime)
|
|
20
|
+
- **RTO** (Recovery Time Objective): 15 minutos
|
|
21
|
+
- **RPO** (Recovery Point Objective): < 5 minutos (backups a cada 5min)
|
|
22
|
+
- **Health Check**: `/api/health` a cada 30s
|
|
23
|
+
|
|
24
|
+
## Segurança
|
|
25
|
+
- **Encryption**: TLS 1.3 em trânsito
|
|
26
|
+
- **Authentication**: JWT com expiry 1h, refresh token 30 dias
|
|
27
|
+
- **Authorization**: RBAC (user, admin)
|
|
28
|
+
- **Input Validation**: Todas as entradas (length, type, format)
|
|
29
|
+
- **SQL Injection**: TypeORM parameterizado (protected)
|
|
30
|
+
- **CORS**: Apenas origins registradas
|
|
31
|
+
- **CSRF**: Tokens no formulário (POST/PUT/DELETE)
|
|
32
|
+
- **Rate Limiting**: 100 req/min por IP
|
|
33
|
+
- **Secrets**: Variáveis de ambiente, nunca em código
|
|
34
|
+
|
|
35
|
+
## Manutenibilidade
|
|
36
|
+
- **Código**: TypeScript strict, 80%+ test coverage
|
|
37
|
+
- **Logs**: Estruturados (JSON), níveis (info, warn, error)
|
|
38
|
+
- **Observabilidade**: Health checks, metricas Prometheus (future)
|
|
39
|
+
- **Documentação**: Cobertura 100% de APIs via Swagger
|
|
40
|
+
- **CI/CD**: Testes automáticos antes de merge
|
|
41
|
+
|
|
42
|
+
## Compliance
|
|
43
|
+
- **LGPD**: Direito ao esquecimento, consentimento explícito
|
|
44
|
+
- **PCI-DSS**: Mock Stripe (dados reais fora do escopo MVP)
|
|
45
|
+
- **Auditoria**: Logs de operações críticas (pagamentos, exclusões)
|
|
46
|
+
- **Backup**: Daily backups, retention 30 dias
|
|
47
|
+
|
|
48
|
+
## Confiabilidade
|
|
49
|
+
- **Idempotência**: Operações críticas (pagamento, pedido) retentáveis
|
|
50
|
+
- **Graceful Degradation**: Cache falha → chama DB
|
|
51
|
+
- **Retry Logic**: Exponential backoff para chamadas externas
|
|
52
|
+
- **Falha em Cascata**: Circuit breaker para dependências externas (future)
|
|
53
|
+
|
|
54
|
+
## Compatibilidade
|
|
55
|
+
- **Browsers**: Chrome, Firefox, Safari, Edge (últimas 2 versões)
|
|
56
|
+
- **Mobile**: Responsivo (iOS Safari, Android Chrome)
|
|
57
|
+
- **APIs**: Versionada (/api/v1), backward compatible
|
|
58
|
+
|
|
59
|
+
## Disaster Recovery
|
|
60
|
+
- **Backup**: Daily full backup + hourly WAL
|
|
61
|
+
- **Replica**: Standby PostgreSQL para failover (future)
|
|
62
|
+
- **Testado**: DR drills mensais
|