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,63 @@
|
|
|
1
|
+
# Visão do Produto
|
|
2
|
+
|
|
3
|
+
## Elevator Pitch
|
|
4
|
+
|
|
5
|
+
**SaaS Starter** é uma plataforma de gestão de subscriptions SaaS com:
|
|
6
|
+
- Autenticação JWT + multi-tenant
|
|
7
|
+
- Planos flexíveis (free, pro, enterprise)
|
|
8
|
+
- Billing mock Stripe-like
|
|
9
|
+
- RBAC completo
|
|
10
|
+
- Pronto para produção
|
|
11
|
+
|
|
12
|
+
## Proposição de Valor
|
|
13
|
+
|
|
14
|
+
| Valor | Descrição |
|
|
15
|
+
|-------|-----------|
|
|
16
|
+
| **Time to Market** | Deploy em 1 semana, não 3 meses |
|
|
17
|
+
| **Segurança** | JWT + RBAC + Tenant isolation out-of-box |
|
|
18
|
+
| **Escalabilidade** | PostgreSQL + Redis, pronto para 100k+ users |
|
|
19
|
+
| **Developer Experience** | TypeScript + NestJS + tipos fortes |
|
|
20
|
+
| **Production Ready** | E2E tests, error handling, observability |
|
|
21
|
+
|
|
22
|
+
## Diferencial Competitivo
|
|
23
|
+
|
|
24
|
+
1. **Boilerplate vs Plataforma**: Fornecemos código customizável, não SaaS locked-in
|
|
25
|
+
2. **Multi-tenant First**: Desde o início, não retrofitted
|
|
26
|
+
3. **Agent-Ready**: Orquestração de agentes IA como cidadão de primeira classe
|
|
27
|
+
4. **Documentation as Code**: Memory levels vs wikis desatualizados
|
|
28
|
+
|
|
29
|
+
## 12-Month Vision
|
|
30
|
+
|
|
31
|
+
| Trimestre | Objetivo | Métricas |
|
|
32
|
+
|-----------|----------|---------|
|
|
33
|
+
| Q1 (Agora) | MVP multi-tenant com auth + subscriptions | 3 módulos, 80+ E2E tests |
|
|
34
|
+
| Q2 | Billing real (Stripe), webhooks | 0 payment fails, <1% churn |
|
|
35
|
+
| Q3 | Analytics & observability | Dashboards, <100ms p99 latency |
|
|
36
|
+
| Q4 | Compliance (SOC2, GDPR) | Audit trails, data export |
|
|
37
|
+
|
|
38
|
+
## Limites Declarados
|
|
39
|
+
|
|
40
|
+
**Este boilerplate NÃO inclui:**
|
|
41
|
+
- Frontend (React/Vue/etc — você escolhe)
|
|
42
|
+
- Email delivery (apenas templates)
|
|
43
|
+
- SMS (integração Twilio você faz)
|
|
44
|
+
- Storage (S3, apenas clients)
|
|
45
|
+
- Mobile SDK
|
|
46
|
+
|
|
47
|
+
**Por quê?** Manter scaffold enxuto, focado em backend SaaS core.
|
|
48
|
+
|
|
49
|
+
## Sucesso =
|
|
50
|
+
|
|
51
|
+
Um novo SaaS pode:
|
|
52
|
+
1. ✅ Clonar repo
|
|
53
|
+
2. ✅ `npm install && docker-compose up`
|
|
54
|
+
3. ✅ `npm run seed` (data de teste)
|
|
55
|
+
4. ✅ `npm test` (verde)
|
|
56
|
+
5. ✅ `npm run start:dev`
|
|
57
|
+
6. ✅ Fazer POST /api/auth/signup
|
|
58
|
+
7. ✅ Upgrade plan em /api/subscriptions
|
|
59
|
+
8. ✅ Ver mock payment em /api/billing
|
|
60
|
+
9. ✅ Deploy em staging
|
|
61
|
+
10. ✅ Customizar conforme necessário
|
|
62
|
+
|
|
63
|
+
Tudo em **< 2 horas**.
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
# Visão Geral da Arquitetura
|
|
2
|
+
|
|
3
|
+
## Diagrama da Arquitetura
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
7
|
+
│ Cliente Web/Mobile │
|
|
8
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
9
|
+
│
|
|
10
|
+
↓
|
|
11
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
12
|
+
│ API Gateway │
|
|
13
|
+
│ (Rate Limiter, CORS, Request Logging) │
|
|
14
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
15
|
+
│
|
|
16
|
+
↓
|
|
17
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
18
|
+
│ NestJS Application │
|
|
19
|
+
│ ┌──────────────────────────────────────────────────────────┐ │
|
|
20
|
+
│ │ Controllers │ Services │ Middleware │ Guards │ │
|
|
21
|
+
│ ├──────────────┴────────────┴──────────────┴──────────────┤ │
|
|
22
|
+
│ │ Modules: │ │
|
|
23
|
+
│ │ • Auth (JWT, Local strategy) │ │
|
|
24
|
+
│ │ • Users (RBAC, invites) │ │
|
|
25
|
+
│ │ • Organizations (Multi-tenant) │ │
|
|
26
|
+
│ │ • Subscriptions (Plans, upgrades) │ │
|
|
27
|
+
│ │ • Billing (Payments, invoices) │ │
|
|
28
|
+
│ └──────────────────────────────────────────────────────────┘ │
|
|
29
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
30
|
+
│ │
|
|
31
|
+
┌──────┴──────┬──────────────┬┴────────┐
|
|
32
|
+
↓ ↓ ↓ ↓
|
|
33
|
+
┌──────────┐ ┌─────────┐ ┌──────────┐ ┌────────┐
|
|
34
|
+
│PostgreSQL│ │ Redis │ │ Payment │ │ Email │
|
|
35
|
+
│ Database │ │ Cache │ │ Gateway │ │Service │
|
|
36
|
+
│ │ │ │ │ (Mock) │ │(Hooks) │
|
|
37
|
+
└──────────┘ └─────────┘ └──────────┘ └────────┘
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Stack Técnico
|
|
41
|
+
|
|
42
|
+
| Camada | Tecnologia | Versão |
|
|
43
|
+
|--------|-----------|--------|
|
|
44
|
+
| **Backend** | NestJS | 10+ |
|
|
45
|
+
| **Language** | TypeScript | 5.0+ |
|
|
46
|
+
| **Database** | PostgreSQL | 15+ |
|
|
47
|
+
| **Cache** | Redis | 7.0+ |
|
|
48
|
+
| **ORM** | TypeORM | 0.3+ |
|
|
49
|
+
| **Auth** | JWT | HS256 |
|
|
50
|
+
| **Testing** | Jest | 29+ |
|
|
51
|
+
| **API Docs** | Swagger/OpenAPI | 3.0 |
|
|
52
|
+
| **Runtime** | Node.js | 18+ LTS |
|
|
53
|
+
|
|
54
|
+
## Módulos Principais
|
|
55
|
+
|
|
56
|
+
### 1. Auth Module
|
|
57
|
+
- JWT strategy (access + refresh)
|
|
58
|
+
- Local strategy (username/password)
|
|
59
|
+
- Password hashing (bcrypt)
|
|
60
|
+
- Token validation & expiry
|
|
61
|
+
|
|
62
|
+
### 2. Users Module
|
|
63
|
+
- User CRUD (create, read, update, delete)
|
|
64
|
+
- RBAC (role assignment, permission checking)
|
|
65
|
+
- User invites (email link)
|
|
66
|
+
- Profile management
|
|
67
|
+
|
|
68
|
+
### 3. Organizations Module
|
|
69
|
+
- Org CRUD (create, read, update, delete)
|
|
70
|
+
- Org settings
|
|
71
|
+
- Multi-tenant isolation
|
|
72
|
+
- Org-level permissions
|
|
73
|
+
|
|
74
|
+
### 4. Subscriptions Module
|
|
75
|
+
- Subscription CRUD
|
|
76
|
+
- Plan management (free, pro, enterprise)
|
|
77
|
+
- Upgrade/downgrade logic
|
|
78
|
+
- Billing integration
|
|
79
|
+
|
|
80
|
+
### 5. Billing Module
|
|
81
|
+
- Payment processing (mock)
|
|
82
|
+
- Invoice generation
|
|
83
|
+
- Webhook handling
|
|
84
|
+
- Transaction history
|
|
85
|
+
|
|
86
|
+
## Fluxos Principais
|
|
87
|
+
|
|
88
|
+
### Signup Flow
|
|
89
|
+
```
|
|
90
|
+
1. POST /api/auth/signup { email, password, org_name }
|
|
91
|
+
2. Validar email único + força de senha
|
|
92
|
+
3. Hash password com bcrypt
|
|
93
|
+
4. Criar org + user (owner role)
|
|
94
|
+
5. Gerar JWT access token
|
|
95
|
+
6. Enviar email de confirmação (async)
|
|
96
|
+
7. Retornar token + user data
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Subscription Upgrade Flow
|
|
100
|
+
```
|
|
101
|
+
1. GET /api/subscriptions (validar tenant, auth)
|
|
102
|
+
2. POST /api/subscriptions/:id/upgrade { plan_id }
|
|
103
|
+
3. Validar transição de plano
|
|
104
|
+
4. Charge payment (mock)
|
|
105
|
+
5. Atualizar subscription
|
|
106
|
+
6. Gerar invoice
|
|
107
|
+
7. Registrar audit log
|
|
108
|
+
8. Enviar email de confirmação
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Billing Flow
|
|
112
|
+
```
|
|
113
|
+
1. POST /api/billing/charge { amount, currency }
|
|
114
|
+
2. Chamar payment gateway (Stripe mock)
|
|
115
|
+
3. Registrar transação
|
|
116
|
+
4. Gerar invoice
|
|
117
|
+
5. Enviar email de receipt
|
|
118
|
+
6. Webhook callback (async)
|
|
119
|
+
7. Atualizar subscription status se necessário
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Padrões Arquiteturais
|
|
123
|
+
|
|
124
|
+
### 1. Dependency Injection
|
|
125
|
+
- NestJS @Injectable()
|
|
126
|
+
- Constructor injection (explícito, type-safe)
|
|
127
|
+
- Service-to-service via providers
|
|
128
|
+
|
|
129
|
+
### 2. Middleware Pattern
|
|
130
|
+
- Tenant context middleware (set tenantId no request)
|
|
131
|
+
- Logging middleware
|
|
132
|
+
- Error handling middleware
|
|
133
|
+
|
|
134
|
+
### 3. Guard Pattern
|
|
135
|
+
- JwtAuthGuard (validar token)
|
|
136
|
+
- RolesGuard (verificar RBAC)
|
|
137
|
+
- TenantGuard (isolar tenant)
|
|
138
|
+
|
|
139
|
+
### 4. Service Pattern
|
|
140
|
+
- Business logic separado de HTTP
|
|
141
|
+
- Reutilizável por controllers/jobs
|
|
142
|
+
- Testável isoladamente
|
|
143
|
+
|
|
144
|
+
### 5. Repository Pattern
|
|
145
|
+
- Typeorm repositories para data access
|
|
146
|
+
- Abstração de queries
|
|
147
|
+
- Facilitado testes (mock repositories)
|
|
148
|
+
|
|
149
|
+
## Camadas
|
|
150
|
+
|
|
151
|
+
```
|
|
152
|
+
┌───────────────────────────────┐
|
|
153
|
+
│ HTTP Controllers │ (Request/Response)
|
|
154
|
+
├───────────────────────────────┤
|
|
155
|
+
│ Services │ (Business Logic)
|
|
156
|
+
├───────────────────────────────┤
|
|
157
|
+
│ Repositories │ (Data Access)
|
|
158
|
+
├───────────────────────────────┤
|
|
159
|
+
│ Database / Cache │ (Persistence)
|
|
160
|
+
└───────────────────────────────┘
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## Decisões Arquiteturais
|
|
164
|
+
|
|
165
|
+
### Por que PostgreSQL, não MongoDB?
|
|
166
|
+
- Relational: Users ↔ Organizations ↔ Subscriptions ↔ Invoices
|
|
167
|
+
- Transactions: ACID para billing (crítico)
|
|
168
|
+
- Compliance: Melhor para GDPR + audit trails
|
|
169
|
+
- Cost: Managed PostgreSQL (RDS, Heroku) é mais barato
|
|
170
|
+
|
|
171
|
+
### Por que Redis, não memcache?
|
|
172
|
+
- Data structures: Listas, sets (cache invalidation mais fácil)
|
|
173
|
+
- Persistence: Opcional, mas disponível
|
|
174
|
+
- Pub/Sub: Para notificações em tempo real (futura)
|
|
175
|
+
- Cost: Comparable, Redis tem mais features
|
|
176
|
+
|
|
177
|
+
### Por que TypeScript?
|
|
178
|
+
- Type safety: Detectar bugs em compile-time
|
|
179
|
+
- DX: Melhor IDE support, autocompletion
|
|
180
|
+
- Refactoring: Renomear símbolos com confiança
|
|
181
|
+
- Migration: JavaScript é subset de TypeScript
|
|
182
|
+
|
|
183
|
+
### Por que NestJS?
|
|
184
|
+
- Convention over configuration: Setup rápido
|
|
185
|
+
- Dependency injection: Integrado desde início
|
|
186
|
+
- Modular: Escalável conforme projeto cresce
|
|
187
|
+
- Testing: Built-in testing utilities
|
|
188
|
+
- Community: Stack MEAN maduro em produção
|
|
189
|
+
|
|
190
|
+
## Próximas Fases
|
|
191
|
+
|
|
192
|
+
### Phase 2: Internacionalização
|
|
193
|
+
- Multi-currency (USD, EUR, GBP, etc)
|
|
194
|
+
- Stripe real integration
|
|
195
|
+
- Webhooks para payment events
|
|
196
|
+
|
|
197
|
+
### Phase 3: Observability
|
|
198
|
+
- Prometheus metrics
|
|
199
|
+
- Grafana dashboards
|
|
200
|
+
- OpenTelemetry tracing
|
|
201
|
+
- Distributed logging (ELK stack)
|
|
202
|
+
|
|
203
|
+
### Phase 4: Compliance
|
|
204
|
+
- SOC2 audit trail
|
|
205
|
+
- GDPR data export
|
|
206
|
+
- User audit logs
|
|
207
|
+
- Rate limiting per endpoint
|
|
208
|
+
|
|
209
|
+
### Phase 5: Performance
|
|
210
|
+
- Database indexes optimization
|
|
211
|
+
- Query result caching
|
|
212
|
+
- Bulk operations
|
|
213
|
+
- Webhook batch processing
|
|
214
|
+
|
|
215
|
+
## Deployment Strategy
|
|
216
|
+
|
|
217
|
+
### Development Environment
|
|
218
|
+
- docker-compose com PostgreSQL + Redis
|
|
219
|
+
- Hot-reload NestJS
|
|
220
|
+
- Seed data automático
|
|
221
|
+
|
|
222
|
+
### Staging Environment
|
|
223
|
+
- AWS RDS PostgreSQL
|
|
224
|
+
- AWS ElastiCache Redis
|
|
225
|
+
- Docker containers em ECS
|
|
226
|
+
- Blue-green deployment
|
|
227
|
+
|
|
228
|
+
### Production Environment
|
|
229
|
+
- Multi-AZ RDS PostgreSQL
|
|
230
|
+
- Read replicas para scaling
|
|
231
|
+
- CloudFront para static assets (future)
|
|
232
|
+
- Auto-scaling groups
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
# Auth API Specification
|
|
2
|
+
|
|
3
|
+
## Endpoints
|
|
4
|
+
|
|
5
|
+
### 1. Signup
|
|
6
|
+
|
|
7
|
+
**POST** `/api/auth/signup`
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"email": "founder@example.com",
|
|
12
|
+
"password": "SecureP@ss123",
|
|
13
|
+
"organizationName": "My Startup"
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
**Response 201**:
|
|
18
|
+
```json
|
|
19
|
+
{
|
|
20
|
+
"data": {
|
|
21
|
+
"id": "user-uuid",
|
|
22
|
+
"email": "founder@example.com",
|
|
23
|
+
"organization": {
|
|
24
|
+
"id": "org-uuid",
|
|
25
|
+
"name": "My Startup",
|
|
26
|
+
"plan": "free"
|
|
27
|
+
},
|
|
28
|
+
"accessToken": "eyJhbGc...",
|
|
29
|
+
"refreshToken": "eyJhbGc..."
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**Error 400**: Email já existe
|
|
35
|
+
**Error 422**: Senha fraca
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
### 2. Login
|
|
40
|
+
|
|
41
|
+
**POST** `/api/auth/login`
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"email": "founder@example.com",
|
|
46
|
+
"password": "SecureP@ss123"
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**Response 200**:
|
|
51
|
+
```json
|
|
52
|
+
{
|
|
53
|
+
"data": {
|
|
54
|
+
"user": { "id", "email", "roles": ["owner"] },
|
|
55
|
+
"organization": { "id", "name", "plan" },
|
|
56
|
+
"accessToken": "eyJhbGc...",
|
|
57
|
+
"refreshToken": "eyJhbGc..."
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**Error 401**: Email ou senha inválida
|
|
63
|
+
**Error 429**: Too many attempts (rate limited)
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
### 3. Refresh Token
|
|
68
|
+
|
|
69
|
+
**POST** `/api/auth/refresh`
|
|
70
|
+
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"refreshToken": "eyJhbGc..."
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**Response 200**:
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"data": {
|
|
81
|
+
"accessToken": "eyJhbGc...",
|
|
82
|
+
"refreshToken": "eyJhbGc..." // new if rotated
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
**Error 401**: Refresh token inválido ou expirado
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
### 4. Logout
|
|
92
|
+
|
|
93
|
+
**POST** `/api/auth/logout`
|
|
94
|
+
|
|
95
|
+
Headers: `Authorization: Bearer {accessToken}`
|
|
96
|
+
|
|
97
|
+
**Response 200**:
|
|
98
|
+
```json
|
|
99
|
+
{
|
|
100
|
+
"message": "Logged out successfully"
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
### 5. Get Current User
|
|
107
|
+
|
|
108
|
+
**GET** `/api/auth/me`
|
|
109
|
+
|
|
110
|
+
Headers: `Authorization: Bearer {accessToken}`
|
|
111
|
+
|
|
112
|
+
**Response 200**:
|
|
113
|
+
```json
|
|
114
|
+
{
|
|
115
|
+
"data": {
|
|
116
|
+
"id": "user-uuid",
|
|
117
|
+
"email": "founder@example.com",
|
|
118
|
+
"roles": ["owner"],
|
|
119
|
+
"organization": {
|
|
120
|
+
"id": "org-uuid",
|
|
121
|
+
"name": "My Startup",
|
|
122
|
+
"plan": "free"
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Error Codes
|
|
131
|
+
|
|
132
|
+
| Code | Message | Meaning |
|
|
133
|
+
|------|---------|---------|
|
|
134
|
+
| AUTH_001 | Invalid credentials | Email ou senha incorreta |
|
|
135
|
+
| AUTH_002 | Email already exists | Email já cadastrado neste tenant |
|
|
136
|
+
| AUTH_003 | Weak password | Senha não atende requisitos |
|
|
137
|
+
| AUTH_004 | Invalid token | JWT inválido ou expirado |
|
|
138
|
+
| AUTH_005 | Token expired | Usar refresh endpoint |
|
|
139
|
+
| AUTH_006 | Account locked | 5 failed attempts, tente em 15 min |
|
|
140
|
+
| AUTH_007 | Email not verified | Confirmar email primeiro |
|
|
141
|
+
|
|
142
|
+
## Flow Examples
|
|
143
|
+
|
|
144
|
+
### Scenario: User Signup
|
|
145
|
+
```bash
|
|
146
|
+
curl -X POST http://localhost:3000/api/auth/signup \
|
|
147
|
+
-H "Content-Type: application/json" \
|
|
148
|
+
-d '{
|
|
149
|
+
"email": "founder@example.com",
|
|
150
|
+
"password": "SecureP@ss123",
|
|
151
|
+
"organizationName": "My Startup"
|
|
152
|
+
}'
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### Scenario: User Login
|
|
156
|
+
```bash
|
|
157
|
+
curl -X POST http://localhost:3000/api/auth/login \
|
|
158
|
+
-H "Content-Type: application/json" \
|
|
159
|
+
-d '{
|
|
160
|
+
"email": "founder@example.com",
|
|
161
|
+
"password": "SecureP@ss123"
|
|
162
|
+
}'
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### Scenario: Access Protected Route
|
|
166
|
+
```bash
|
|
167
|
+
curl -X GET http://localhost:3000/api/auth/me \
|
|
168
|
+
-H "Authorization: Bearer eyJhbGc..."
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### Scenario: Refresh Expired Token
|
|
172
|
+
```bash
|
|
173
|
+
curl -X POST http://localhost:3000/api/auth/refresh \
|
|
174
|
+
-H "Content-Type: application/json" \
|
|
175
|
+
-d '{
|
|
176
|
+
"refreshToken": "eyJhbGc..."
|
|
177
|
+
}'
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
## Implementation Notes
|
|
181
|
+
|
|
182
|
+
- Todos endpoints retornam `tenantId` no JWT payload
|
|
183
|
+
- Todas operações são isoladas por tenant
|
|
184
|
+
- Email é único por tenant, não globalmente
|
|
185
|
+
- Passwords são hashed com bcrypt (cost=12)
|
|
186
|
+
- Tokens são signed com HS256
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Auth Domain Context
|
|
2
|
+
|
|
3
|
+
## O que é Auth neste SaaS?
|
|
4
|
+
|
|
5
|
+
Autenticação & autorização stateless com JWT, permitindo:
|
|
6
|
+
1. Signup (criar org + user)
|
|
7
|
+
2. Login (JWT tokens)
|
|
8
|
+
3. Refresh (renovar access token)
|
|
9
|
+
4. Logout (invalidar token em Redis)
|
|
10
|
+
5. Password reset (email link)
|
|
11
|
+
|
|
12
|
+
## Fluxo de Autenticação
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
User abre app
|
|
16
|
+
↓
|
|
17
|
+
Frontend checa localStorage.accessToken
|
|
18
|
+
↓
|
|
19
|
+
[Token válido?] → SIM → Mostrar dashboard
|
|
20
|
+
↓ NÃO
|
|
21
|
+
[Token expirado?] → NÃO → Mostrar login
|
|
22
|
+
↓ SIM
|
|
23
|
+
POST /api/auth/refresh com refreshToken
|
|
24
|
+
↓
|
|
25
|
+
[Refresh válido?] → SIM → Novo accessToken
|
|
26
|
+
↓ NÃO
|
|
27
|
+
Limpar tokens, mostrar login
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Conceitos
|
|
31
|
+
|
|
32
|
+
### JWT Structure
|
|
33
|
+
```
|
|
34
|
+
Header.Payload.Signature
|
|
35
|
+
eyJhbGciOiJIUzI1NiJ9.
|
|
36
|
+
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.
|
|
37
|
+
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Payload contém:
|
|
41
|
+
- `sub` (subject): user ID
|
|
42
|
+
- `tenantId`: organization ID
|
|
43
|
+
- `roles`: ['owner', 'admin'] etc
|
|
44
|
+
- `iat`: issued at
|
|
45
|
+
- `exp`: expiry timestamp
|
|
46
|
+
|
|
47
|
+
### Strategies
|
|
48
|
+
|
|
49
|
+
**Local Strategy**:
|
|
50
|
+
- Username/email + password
|
|
51
|
+
- Usado em POST /api/auth/login
|
|
52
|
+
- Retorna JWT
|
|
53
|
+
|
|
54
|
+
**JWT Strategy**:
|
|
55
|
+
- Valida token em Authorization header
|
|
56
|
+
- Usado em @UseGuards(JwtAuthGuard)
|
|
57
|
+
- Extrai dados do token payload
|
|
58
|
+
|
|
59
|
+
## Regras & Invariantes
|
|
60
|
+
|
|
61
|
+
1. **Password validation**: Min 12 chars, 1 uppercase, 1 lowercase, 1 number, 1 symbol
|
|
62
|
+
2. **Email validation**: RFC 5322
|
|
63
|
+
3. **Unique constraint**: Email único por tenant (não global)
|
|
64
|
+
4. **Token signing**: Secret from process.env.JWT_SECRET
|
|
65
|
+
5. **Token expiry**: Access 15 min, Refresh 7 days
|
|
66
|
+
6. **Rate limiting**: 5 failed login attempts = 15 min lockout
|
|
67
|
+
7. **Tenant isolation**: User pode pertencer a múltiplas orgs (multi-tenant)
|
|
68
|
+
|
|
69
|
+
## Status Atual
|
|
70
|
+
|
|
71
|
+
- ✅ JWT strategy implementada
|
|
72
|
+
- ✅ Local strategy implementada
|
|
73
|
+
- ✅ User entity com password hash
|
|
74
|
+
- ✅ Signup endpoint
|
|
75
|
+
- ✅ Login endpoint
|
|
76
|
+
- ✅ Refresh endpoint
|
|
77
|
+
- 🚧 Password reset (future)
|
|
78
|
+
- 🚧 MFA (future)
|
|
79
|
+
|
|
80
|
+
## Próximos Steps
|
|
81
|
+
|
|
82
|
+
1. Implementar password reset flow
|
|
83
|
+
2. Adicionar rate limiting
|
|
84
|
+
3. Webhook para email de confirmação
|
|
85
|
+
4. Audit logging de eventos de auth
|