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,240 @@
|
|
|
1
|
+
# Regras de Negócio
|
|
2
|
+
|
|
3
|
+
## 1. Subscription Plans
|
|
4
|
+
|
|
5
|
+
### Planos Padrão
|
|
6
|
+
|
|
7
|
+
| Plan | Price/mo | Users | API Calls | Storage | Support |
|
|
8
|
+
|------|----------|-------|-----------|---------|---------|
|
|
9
|
+
| **Free** | $0 | 1 | 1k/mo | 1GB | Community |
|
|
10
|
+
| **Pro** | $99 | 5 | 100k/mo | 100GB | Email |
|
|
11
|
+
| **Enterprise** | Custom | Unlimited | Unlimited | Unlimited | Dedicated |
|
|
12
|
+
|
|
13
|
+
### Regras de Transição
|
|
14
|
+
|
|
15
|
+
**Upgrade:**
|
|
16
|
+
- Free → Pro: Imediato, prorated charge
|
|
17
|
+
- Pro → Enterprise: Requer aprovação
|
|
18
|
+
- Any → Any: Sem penalty
|
|
19
|
+
|
|
20
|
+
**Downgrade:**
|
|
21
|
+
- Pro → Free: Imediato, credit note
|
|
22
|
+
- Downgrade gera refund pro-rata
|
|
23
|
+
- Cannot downgrade mid-commitment (annual plans)
|
|
24
|
+
|
|
25
|
+
**Effective Date:**
|
|
26
|
+
- Upgrade: Imediato
|
|
27
|
+
- Downgrade: Fim da billing cycle
|
|
28
|
+
- Já-paid: Pro-rata adjustment
|
|
29
|
+
|
|
30
|
+
### Limits & Quotas
|
|
31
|
+
|
|
32
|
+
- Free: 1k API calls/mo (soft), 1GB storage (hard)
|
|
33
|
+
- Pro: 100k API calls/mo (soft), 100GB storage (hard)
|
|
34
|
+
- Enterprise: Unlimited
|
|
35
|
+
- Rate limiting: 100 req/sec per tenant
|
|
36
|
+
|
|
37
|
+
**What happens at limit?**
|
|
38
|
+
- Soft limit: Warning email, continue working
|
|
39
|
+
- Hard limit: 429 Too Many Requests, suggest upgrade
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 2. Billing
|
|
44
|
+
|
|
45
|
+
### Invoice Schedule
|
|
46
|
+
|
|
47
|
+
- Monthly subscription: Charge first day of month
|
|
48
|
+
- Annual subscription: Charge on anniversary
|
|
49
|
+
- Pro-rata charges: Immediate
|
|
50
|
+
- Failed charge: Retry 3x over 14 days, then cancel
|
|
51
|
+
|
|
52
|
+
### Payment Terms
|
|
53
|
+
|
|
54
|
+
- Credit card: Charge immediately
|
|
55
|
+
- Annual discount: 20% (e.g., Pro $1188/year = $99/mo)
|
|
56
|
+
- No long-term contracts (SaaS, not enterprise software)
|
|
57
|
+
- Money-back guarantee: 14 days
|
|
58
|
+
|
|
59
|
+
### Refund Policy
|
|
60
|
+
|
|
61
|
+
- Within 14 days: Full refund
|
|
62
|
+
- After 14 days: Pro-rata refund (unused balance)
|
|
63
|
+
- Chargeback: Suspend account immediately
|
|
64
|
+
- Refund issued within 5-7 business days
|
|
65
|
+
|
|
66
|
+
### Tax
|
|
67
|
+
|
|
68
|
+
- US: Sales tax calculated by state (Stripe does this)
|
|
69
|
+
- EU: VAT applied, reverse charge for B2B
|
|
70
|
+
- Exempt: Non-profits (certificate required)
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 3. Users & Roles
|
|
75
|
+
|
|
76
|
+
### RBAC Matrix
|
|
77
|
+
|
|
78
|
+
| Action | Owner | Admin | Member |
|
|
79
|
+
|--------|-------|-------|--------|
|
|
80
|
+
| Create org | ✅ | ❌ | ❌ |
|
|
81
|
+
| Delete org | ✅ | ❌ | ❌ |
|
|
82
|
+
| Change plan | ✅ | ❌ | ❌ |
|
|
83
|
+
| Invite user | ✅ | ✅ | ❌ |
|
|
84
|
+
| Remove user | ✅ | ✅ | ❌ |
|
|
85
|
+
| Change role | ✅ | ❌ | ❌ |
|
|
86
|
+
| View billing | ✅ | ✅ | ❌ |
|
|
87
|
+
| Use API | ✅ | ✅ | ✅ |
|
|
88
|
+
|
|
89
|
+
### User Lifecycle
|
|
90
|
+
|
|
91
|
+
```
|
|
92
|
+
Invite → Pending → Accepted → Active → Removed/Suspended
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**Rules:**
|
|
96
|
+
- Owner is permanent, cannot be removed
|
|
97
|
+
- Min 1 owner per org, max 3 (governance)
|
|
98
|
+
- Invitation expires in 7 days
|
|
99
|
+
- Removed user: Access revoked immediately, no refund
|
|
100
|
+
- Suspended user: Access disabled, but data retained
|
|
101
|
+
|
|
102
|
+
### Seat Usage
|
|
103
|
+
|
|
104
|
+
- Free: 1 user
|
|
105
|
+
- Pro: 5 seats included, $10 per additional
|
|
106
|
+
- Enterprise: Unlimited
|
|
107
|
+
|
|
108
|
+
**Calculation:**
|
|
109
|
+
```
|
|
110
|
+
Monthly bill = Subscription + (Overage seats × $10)
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 4. Multi-Tenancy
|
|
116
|
+
|
|
117
|
+
### Organization Isolation
|
|
118
|
+
|
|
119
|
+
Every request must include:
|
|
120
|
+
- `Authorization: Bearer {jwt}`
|
|
121
|
+
- JWT contains `tenantId`
|
|
122
|
+
- Query filters by `tenantId` automatically
|
|
123
|
+
- Cross-tenant queries: FORBIDDEN
|
|
124
|
+
|
|
125
|
+
### Tenant Context Rules
|
|
126
|
+
|
|
127
|
+
1. **Mandatory**: Every endpoint must validate tenant
|
|
128
|
+
2. **Implicit**: Service methods receive tenantId via middleware
|
|
129
|
+
3. **Defensive**: Never trust client-provided tenantId
|
|
130
|
+
4. **Logged**: All tenant access in audit log
|
|
131
|
+
|
|
132
|
+
### Data Segregation
|
|
133
|
+
|
|
134
|
+
- Separate database per tenant: NO (security/ops complexity)
|
|
135
|
+
- Row-level security: YES (tenant_id on every table)
|
|
136
|
+
- Index on tenant_id: MANDATORY
|
|
137
|
+
- Soft-deletes: YES (audit + recovery)
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 5. Security
|
|
142
|
+
|
|
143
|
+
### Password Rules
|
|
144
|
+
|
|
145
|
+
- Minimum 12 characters
|
|
146
|
+
- At least: uppercase + lowercase + number + symbol
|
|
147
|
+
- Cannot contain username or email
|
|
148
|
+
- Expire: Never (stateless auth)
|
|
149
|
+
- History: Not enforced (JWT, not sessions)
|
|
150
|
+
|
|
151
|
+
### JWT Strategy
|
|
152
|
+
|
|
153
|
+
- Algorithm: HS256
|
|
154
|
+
- Access token: 15 min expiry
|
|
155
|
+
- Refresh token: 7 days expiry
|
|
156
|
+
- Signing secret: From env, rotated quarterly
|
|
157
|
+
- No sensitive data in payload (only id, tenantId, roles)
|
|
158
|
+
|
|
159
|
+
### Session Handling
|
|
160
|
+
|
|
161
|
+
- Stateless (no session store)
|
|
162
|
+
- Token blacklisting on logout: Cache in Redis, TTL 7 days
|
|
163
|
+
- Concurrent sessions: Unlimited per user
|
|
164
|
+
- Device limit: Not enforced (SaaS, not mobile app)
|
|
165
|
+
|
|
166
|
+
### IP Whitelisting
|
|
167
|
+
|
|
168
|
+
- Enterprise only
|
|
169
|
+
- Configure in org settings
|
|
170
|
+
- Bypass: Fail-open (if misconfigured, not fail-closed)
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## 6. Compliance & Data Protection
|
|
175
|
+
|
|
176
|
+
### GDPR
|
|
177
|
+
|
|
178
|
+
- Right to access: Export user data in 24h
|
|
179
|
+
- Right to delete: Hard-delete after 30 day retention
|
|
180
|
+
- Right to portability: JSON export of all data
|
|
181
|
+
- Consent: Recorded at signup, audit logged
|
|
182
|
+
- DPA required: For EU customers
|
|
183
|
+
|
|
184
|
+
### Data Retention
|
|
185
|
+
|
|
186
|
+
- Active org: Keep indefinitely
|
|
187
|
+
- Deleted org: Soft-delete, purge after 1 year
|
|
188
|
+
- Logs: 90 days (audit), 7 days (debug)
|
|
189
|
+
- Backups: 30 day retention
|
|
190
|
+
|
|
191
|
+
### PII Handling
|
|
192
|
+
|
|
193
|
+
- Never log passwords, API keys, tokens
|
|
194
|
+
- Redact in error messages (e.g., "invalid ***")
|
|
195
|
+
- Encrypt at rest: Not mandatory (assume secure infrastructure)
|
|
196
|
+
- Encrypt in transit: TLS 1.3, mandatory
|
|
197
|
+
- No personal data in CDN
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 7. Cancellation & Churn Prevention
|
|
202
|
+
|
|
203
|
+
### Cancellation Policy
|
|
204
|
+
|
|
205
|
+
- Self-service: Cancel anytime, effective end of billing cycle
|
|
206
|
+
- Data: Accessible for 30 days, then deleted
|
|
207
|
+
- Reactivation: Can reactivate within 30 days (restore data)
|
|
208
|
+
- Appeal: No manual intervention
|
|
209
|
+
|
|
210
|
+
### Churn Prevention
|
|
211
|
+
|
|
212
|
+
- 7 days before expiry: Reminder email
|
|
213
|
+
- Failed payment: Retry 3x, then notification
|
|
214
|
+
- Downgrade trigger: Send "Why?" survey
|
|
215
|
+
- Win-back: No special offers (preserve pricing integrity)
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## 8. Terms & Policies
|
|
220
|
+
|
|
221
|
+
### Service Level Agreement (SLA)
|
|
222
|
+
|
|
223
|
+
- Uptime: 99.9% (monitoring by Pingdom)
|
|
224
|
+
- Support: Max 24h response time (Pro tier)
|
|
225
|
+
- Incident: Public status page
|
|
226
|
+
- Breach: Service credit 10% of monthly fee
|
|
227
|
+
|
|
228
|
+
### Acceptable Use Policy
|
|
229
|
+
|
|
230
|
+
- Prohibited: Spam, malware, illegal content, scraping
|
|
231
|
+
- Enforcement: Suspension without notice
|
|
232
|
+
- Appeal: Customer support, 48h review period
|
|
233
|
+
- Serious breach: Permanent termination
|
|
234
|
+
|
|
235
|
+
### Change Management
|
|
236
|
+
|
|
237
|
+
- Price changes: 30 days notice
|
|
238
|
+
- Feature deprecation: 6 months notice
|
|
239
|
+
- Service terms: 30 days notice
|
|
240
|
+
- Backwards compatibility: Guaranteed for API v1
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
# NFRs - Non-Functional Requirements
|
|
2
|
+
|
|
3
|
+
## 1. Performance
|
|
4
|
+
|
|
5
|
+
### Response Times (p99)
|
|
6
|
+
|
|
7
|
+
| Endpoint | Target |
|
|
8
|
+
|----------|--------|
|
|
9
|
+
| /api/auth/login | < 200ms |
|
|
10
|
+
| /api/subscriptions | < 150ms |
|
|
11
|
+
| /api/billing | < 300ms |
|
|
12
|
+
| /api/users | < 100ms |
|
|
13
|
+
| Health check | < 50ms |
|
|
14
|
+
|
|
15
|
+
### Database Query Performance
|
|
16
|
+
|
|
17
|
+
- Simple queries: < 50ms
|
|
18
|
+
- Complex queries (joins): < 200ms
|
|
19
|
+
- Aggregations: < 1s
|
|
20
|
+
- Indexes: On every foreign key + filtering column
|
|
21
|
+
|
|
22
|
+
### Throughput
|
|
23
|
+
|
|
24
|
+
- 1000 concurrent users: No degradation
|
|
25
|
+
- 10k requests/min: No errors
|
|
26
|
+
- Database connections: Pool of 20 (adjust per load test)
|
|
27
|
+
- Cache hit rate: > 80% for subscription data
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 2. Scalability
|
|
32
|
+
|
|
33
|
+
### Horizontal Scaling
|
|
34
|
+
|
|
35
|
+
- Stateless API: Deploy multiple instances
|
|
36
|
+
- Load balancer: Round-robin or sticky sessions
|
|
37
|
+
- Cache layer: Redis for session/subscription data
|
|
38
|
+
- Database: Single PostgreSQL, upgrade to RDS eventually
|
|
39
|
+
|
|
40
|
+
### Database Scaling Strategy
|
|
41
|
+
|
|
42
|
+
**Phase 1** (0-100k users): Single PostgreSQL instance
|
|
43
|
+
**Phase 2** (100k-1M users): RDS Multi-AZ + read replicas
|
|
44
|
+
**Phase 3** (1M+ users): Sharding by tenant_id
|
|
45
|
+
|
|
46
|
+
### Vertical Scaling Limits
|
|
47
|
+
|
|
48
|
+
- Memory: Start with 2GB, monitor
|
|
49
|
+
- CPU: Start with 2 cores, scale to 8
|
|
50
|
+
- Disk: Start with 100GB, add SSD
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 3. Reliability & Availability
|
|
55
|
+
|
|
56
|
+
### Uptime Target
|
|
57
|
+
|
|
58
|
+
- Production: 99.9% SLA (43 min downtime/month)
|
|
59
|
+
- Staging: 95% (no SLA)
|
|
60
|
+
- Development: No guarantee
|
|
61
|
+
|
|
62
|
+
### Fault Tolerance
|
|
63
|
+
|
|
64
|
+
- Database failure: Immediate alert, manual failover
|
|
65
|
+
- API failure: Health check detects in 30s, auto-restart
|
|
66
|
+
- Payment gateway failure: Retry logic + fallback to mock
|
|
67
|
+
- Cache failure: Graceful degradation, no cache needed
|
|
68
|
+
|
|
69
|
+
### Error Recovery
|
|
70
|
+
|
|
71
|
+
- Transient errors (500): Retry 3x with exponential backoff
|
|
72
|
+
- Permanent errors (400): Fail immediately, log for debugging
|
|
73
|
+
- Timeout: 30s default, 60s for webhooks
|
|
74
|
+
|
|
75
|
+
### Data Durability
|
|
76
|
+
|
|
77
|
+
- Database backups: Daily, retained 30 days
|
|
78
|
+
- WAL archiving: Enabled
|
|
79
|
+
- Recovery: Restore to 24h ago in <30min
|
|
80
|
+
- RPO (Recovery Point Objective): 1 day
|
|
81
|
+
- RTO (Recovery Time Objective): 30 minutes
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 4. Security
|
|
86
|
+
|
|
87
|
+
### Threat Vectors & Mitigations
|
|
88
|
+
|
|
89
|
+
| Threat | Mitigation | Implemented |
|
|
90
|
+
|--------|-----------|-----------|
|
|
91
|
+
| SQL Injection | Parameterized queries (Typeorm ORM) | ✅ |
|
|
92
|
+
| XSS | CSP headers, input validation | 🚧 |
|
|
93
|
+
| CSRF | JWT (stateless), no session cookies | ✅ |
|
|
94
|
+
| Brute force | Rate limiting 100 req/sec | 🚧 |
|
|
95
|
+
| Man-in-the-middle | TLS 1.3, HSTS | 🚧 |
|
|
96
|
+
| Privilege escalation | RBAC, JWT validation | ✅ |
|
|
97
|
+
| Data breach | Encryption in transit, PII redaction | ✅ |
|
|
98
|
+
| Denial of service | Rate limiting, query timeouts | 🚧 |
|
|
99
|
+
|
|
100
|
+
### Cryptography
|
|
101
|
+
|
|
102
|
+
- Password hashing: bcrypt, cost=12
|
|
103
|
+
- JWT signing: HS256, secret from env
|
|
104
|
+
- Token rotation: No (JWT is stateless)
|
|
105
|
+
- API keys: SHA-256 hash in database
|
|
106
|
+
- Secrets in env: Never in code or git
|
|
107
|
+
|
|
108
|
+
### Authentication & Authorization
|
|
109
|
+
|
|
110
|
+
- Multi-factor auth: Not in MVP (hook for future)
|
|
111
|
+
- Session timeout: 15 min (access token)
|
|
112
|
+
- Password reset: Email link, 24h expiry
|
|
113
|
+
- Account lockout: After 5 failed attempts (15 min)
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 5. Maintainability
|
|
118
|
+
|
|
119
|
+
### Code Quality
|
|
120
|
+
|
|
121
|
+
- Language: TypeScript strict mode (no `any`)
|
|
122
|
+
- Linting: ESLint + Prettier, enforced in CI
|
|
123
|
+
- Testing: Unit (50%+), E2E (30%+), Coverage >60%
|
|
124
|
+
- Code reviews: Every PR requires 1 approval
|
|
125
|
+
- Documentation: JSDoc on public methods
|
|
126
|
+
|
|
127
|
+
### Deployment
|
|
128
|
+
|
|
129
|
+
- CI/CD: GitHub Actions
|
|
130
|
+
- Deployment: Blue-green or canary
|
|
131
|
+
- Rollback: Automatic on health check failure
|
|
132
|
+
- Configuration: 12-factor app (env vars only)
|
|
133
|
+
|
|
134
|
+
### Observability
|
|
135
|
+
|
|
136
|
+
- Logging: JSON, structured logging with levels
|
|
137
|
+
- Metrics: Prometheus scrape endpoint
|
|
138
|
+
- Tracing: OpenTelemetry hooks (not mandatory)
|
|
139
|
+
- Monitoring: Alert on >1% error rate
|
|
140
|
+
|
|
141
|
+
### Version Control
|
|
142
|
+
|
|
143
|
+
- Git flow: main (prod) ← staging ← feature branches
|
|
144
|
+
- Commit messages: Conventional commits
|
|
145
|
+
- Tags: Semantic versioning (v1.0.0)
|
|
146
|
+
- Release notes: Changelog per version
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## 6. Compliance
|
|
151
|
+
|
|
152
|
+
### Regulatory
|
|
153
|
+
|
|
154
|
+
- GDPR: Compliant (data export, deletion, consent)
|
|
155
|
+
- CCPA: Compliant (opt-out, data requests)
|
|
156
|
+
- SOC2 Type I: Audit trail, access controls
|
|
157
|
+
- HIPAA: Not required for MVP
|
|
158
|
+
|
|
159
|
+
### Data Protection
|
|
160
|
+
|
|
161
|
+
- Data at rest: Application-level encryption (not DB encryption)
|
|
162
|
+
- Data in transit: TLS 1.3 mandatory
|
|
163
|
+
- PII classification: Email, password, name
|
|
164
|
+
- Retention: 90 days for logs, 1 year for deleted orgs
|
|
165
|
+
|
|
166
|
+
### Audit & Logging
|
|
167
|
+
|
|
168
|
+
- User actions: Logged (create, update, delete)
|
|
169
|
+
- Admin actions: Logged with timestamp + user
|
|
170
|
+
- Failed auth: Logged but rate-limited (prevent log spam)
|
|
171
|
+
- Access patterns: No personal data, just metrics
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 7. Usability
|
|
176
|
+
|
|
177
|
+
### Developer Experience
|
|
178
|
+
|
|
179
|
+
- Setup time: < 10 minutes
|
|
180
|
+
- Deploy time: < 5 minutes
|
|
181
|
+
- Learning curve: Existing NestJS developers +1 day
|
|
182
|
+
- Error messages: Clear, actionable, no stack traces in production
|
|
183
|
+
|
|
184
|
+
### API Usability
|
|
185
|
+
|
|
186
|
+
- Consistency: RESTful with HTTP verbs
|
|
187
|
+
- Discoverability: Swagger/OpenAPI docs
|
|
188
|
+
- Error handling: Standard HTTP status codes + error codes
|
|
189
|
+
- Pagination: Limit + offset, max 100 items
|
|
190
|
+
- Filtering: Query params, escapable
|
|
191
|
+
|
|
192
|
+
### Documentation
|
|
193
|
+
|
|
194
|
+
- README: Quick start, examples, architecture
|
|
195
|
+
- API docs: Swagger endpoint at /api/docs
|
|
196
|
+
- Patterns: memory/00-global/patterns.md
|
|
197
|
+
- Examples: Postman collection provided
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 8. Cost Optimization
|
|
202
|
+
|
|
203
|
+
### Infrastructure
|
|
204
|
+
|
|
205
|
+
- Database: PostgreSQL (cheaper than DynamoDB)
|
|
206
|
+
- Cache: Redis (cheaper than ElastiCache for small scale)
|
|
207
|
+
- CDN: Not needed (API only)
|
|
208
|
+
- Monitoring: Open-source tools (Prometheus, Grafana)
|
|
209
|
+
|
|
210
|
+
### Development
|
|
211
|
+
|
|
212
|
+
- No vendor lock-in (can migrate to AWS/GCP/Azure)
|
|
213
|
+
- OSS stack: NestJS, Typeorm, Jest (no expensive licenses)
|
|
214
|
+
- Cost tracking: Budget alerts in cloud provider
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## 9. Cross-Cutting Concerns
|
|
219
|
+
|
|
220
|
+
### Monitoring & Alerting
|
|
221
|
+
|
|
222
|
+
- CPU > 80%: Scale up
|
|
223
|
+
- Memory > 85%: Investigate leak
|
|
224
|
+
- Error rate > 1%: Page on-call
|
|
225
|
+
- Database connections > 18/20: Page on-call
|
|
226
|
+
- Response time p99 > 1s: Investigate
|
|
227
|
+
|
|
228
|
+
### Incident Response
|
|
229
|
+
|
|
230
|
+
- Severity 1 (total outage): 15 min response
|
|
231
|
+
- Severity 2 (partial outage): 1 hour response
|
|
232
|
+
- Severity 3 (degradation): 4 hours response
|
|
233
|
+
- Severity 4 (minor issue): Next business day
|
|
234
|
+
|
|
235
|
+
### SLA Remedies
|
|
236
|
+
|
|
237
|
+
- 99.5-99.9%: 10% credit
|
|
238
|
+
- 99-99.5%: 25% credit
|
|
239
|
+
- <99%: 50% credit (or full refund)
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
# Personas
|
|
2
|
+
|
|
3
|
+
## 1. Sarah — SaaS Founder
|
|
4
|
+
|
|
5
|
+
**Perfil**
|
|
6
|
+
- Age: 32, Tech co-founder
|
|
7
|
+
- Background: Full-stack engineer, 2 startups anteriores
|
|
8
|
+
- Pain: "Não quero gastar 6 meses em infrastructure"
|
|
9
|
+
- Goal: Lançar em produção em 4 semanas
|
|
10
|
+
|
|
11
|
+
**Needs**
|
|
12
|
+
- Autenticação que funciona out-of-box
|
|
13
|
+
- Subscriptions com planos escaláveis
|
|
14
|
+
- Multi-tenant architecture
|
|
15
|
+
- Documentação clara
|
|
16
|
+
- TypeScript (evitar bugs)
|
|
17
|
+
|
|
18
|
+
**Success Metric**
|
|
19
|
+
- Implementou 3 planos
|
|
20
|
+
- 10 clientes beta
|
|
21
|
+
- Churn < 5%
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 2. Dev — Backend Engineer
|
|
26
|
+
|
|
27
|
+
**Perfil**
|
|
28
|
+
- Age: 28, Senior backend engineer
|
|
29
|
+
- Background: 5 anos Node.js + NestJS
|
|
30
|
+
- Pain: "Não quero ver mais boilerplates ruins"
|
|
31
|
+
- Goal: Código limpo, patterns claros, fácil manutenção
|
|
32
|
+
|
|
33
|
+
**Needs**
|
|
34
|
+
- Patterns SOLID applicados
|
|
35
|
+
- Dependency injection funcionando
|
|
36
|
+
- Tests E2E que fazem sentido
|
|
37
|
+
- Modular, fácil de estender
|
|
38
|
+
- Memory/context bem documentada
|
|
39
|
+
|
|
40
|
+
**Success Metric**
|
|
41
|
+
- Adicionou 2 novos domínios (messaging, analytics)
|
|
42
|
+
- 0 bugs em produção
|
|
43
|
+
- Contribui PRs de volta
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 3. Ops — DevOps Engineer
|
|
48
|
+
|
|
49
|
+
**Perfil**
|
|
50
|
+
- Age: 31, Platform engineer
|
|
51
|
+
- Background: Kubernetes, Terraform, observability
|
|
52
|
+
- Pain: "Quero infra como código, não setup manual"
|
|
53
|
+
- Goal: Deploy automatizado, observável, resiliente
|
|
54
|
+
|
|
55
|
+
**Needs**
|
|
56
|
+
- Docker-compose funcional
|
|
57
|
+
- Env vars documentadas
|
|
58
|
+
- Health checks implementados
|
|
59
|
+
- Logging estruturado (JSON)
|
|
60
|
+
- Prometheus metrics
|
|
61
|
+
- Error tracking hooks
|
|
62
|
+
|
|
63
|
+
**Success Metric**
|
|
64
|
+
- Deploy em <5 mins
|
|
65
|
+
- Uptime > 99.9%
|
|
66
|
+
- Issue detection < 5min from error
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## 4. PM — Product Manager
|
|
71
|
+
|
|
72
|
+
**Perfil**
|
|
73
|
+
- Age: 29, Fintech PM
|
|
74
|
+
- Background: Produto, não técnico
|
|
75
|
+
- Pain: "Não entendo o código, mas preciso trackear features"
|
|
76
|
+
- Goal: Dashboard de features, roadmap claro, metrics
|
|
77
|
+
|
|
78
|
+
**Needs**
|
|
79
|
+
- Memory/roadmap.md atualizado
|
|
80
|
+
- Métricas de negócio (MRR, churn)
|
|
81
|
+
- Feature flags (on/off sem deploy)
|
|
82
|
+
- User behavior tracking
|
|
83
|
+
- Relatórios automáticos
|
|
84
|
+
|
|
85
|
+
**Success Metric**
|
|
86
|
+
- Roadmap 3 meses planejado
|
|
87
|
+
- Decision-making em <1 dia
|
|
88
|
+
- Feature adoption tracking
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 5. Compliance — Security Officer
|
|
93
|
+
|
|
94
|
+
**Perfil**
|
|
95
|
+
- Age: 45, Compliance officer
|
|
96
|
+
- Background: Banking, healthcare
|
|
97
|
+
- Pain: "Preciso de audit trails e GDPR compliance"
|
|
98
|
+
- Goal: Segurança, compliance, sem falsos positivos
|
|
99
|
+
|
|
100
|
+
**Needs**
|
|
101
|
+
- JWT + MFA ready (hooks)
|
|
102
|
+
- Tenant isolation garantida
|
|
103
|
+
- Audit logging completo
|
|
104
|
+
- Data export (GDPR)
|
|
105
|
+
- Encryption at rest (hooks)
|
|
106
|
+
- PII redaction em logs
|
|
107
|
+
|
|
108
|
+
**Success Metric**
|
|
109
|
+
- SOC2 readiness check: ✅
|
|
110
|
+
- 0 security issues em audit
|
|
111
|
+
- Compliance dashboard
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## User Journey Map: Sarah (Founder)
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
Day 0: Descobre SaaS Starter
|
|
119
|
+
→ Lê README
|
|
120
|
+
→ Vê que tem auth + subscriptions
|
|
121
|
+
→ Decision: "Vou tentar"
|
|
122
|
+
|
|
123
|
+
Day 1: Setup
|
|
124
|
+
→ Clone repo
|
|
125
|
+
→ docker-compose up
|
|
126
|
+
→ npm run seed
|
|
127
|
+
→ Tests passam ✅
|
|
128
|
+
→ Decision: "Funciona!"
|
|
129
|
+
|
|
130
|
+
Days 2-3: Customização
|
|
131
|
+
→ Estuda patterns.md
|
|
132
|
+
→ Adiciona 3º plano customizado
|
|
133
|
+
→ Cria 2 novos endpoints
|
|
134
|
+
→ Tests continuam passando ✅
|
|
135
|
+
→ Decision: "Posso fazer"
|
|
136
|
+
|
|
137
|
+
Days 4-7: Integração
|
|
138
|
+
→ Integra frontend
|
|
139
|
+
→ Testa flow signup → upgrade
|
|
140
|
+
→ Deploy em staging
|
|
141
|
+
→ QA aprova
|
|
142
|
+
→ Decision: "Produção amanhã"
|
|
143
|
+
|
|
144
|
+
Week 2: Produção
|
|
145
|
+
→ Deploy em prod
|
|
146
|
+
→ 5 clientes criados
|
|
147
|
+
→ Monitor metrics
|
|
148
|
+
→ 1 bug encontrado, fix in 30min
|
|
149
|
+
→ Success: "É rápido e fácil"
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## Feature Prioritization (por persona)
|
|
155
|
+
|
|
156
|
+
| Feature | Sarah | Dev | Ops | PM | Compliance |
|
|
157
|
+
|---------|-------|-----|-----|----|----|
|
|
158
|
+
| JWT Auth | 🔴 | 🟡 | 🟢 | 🟢 | 🔴 |
|
|
159
|
+
| Subscriptions | 🔴 | 🟡 | 🟢 | 🔴 | 🟢 |
|
|
160
|
+
| Mock Billing | 🔴 | 🟢 | 🟢 | 🟡 | 🟡 |
|
|
161
|
+
| Multi-tenant | 🟡 | 🔴 | 🟢 | 🟡 | 🔴 |
|
|
162
|
+
| E2E Tests | 🟡 | 🟡 | 🟢 | 🟢 | 🟢 |
|
|
163
|
+
| Observability | 🟢 | 🟡 | 🔴 | 🟢 | 🟡 |
|
|
164
|
+
| Memory/Docs | 🟡 | 🔴 | 🟢 | 🔴 | 🟢 |
|
|
165
|
+
|
|
166
|
+
🔴 = Critical | 🟡 = Important | 🟢 = Nice to have
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## Usage Scenarios
|
|
171
|
+
|
|
172
|
+
### Scenario 1: SaaS Founder Launch
|
|
173
|
+
```
|
|
174
|
+
Week 1: Setup + customize plans
|
|
175
|
+
Week 2: Frontend integration
|
|
176
|
+
Week 3: QA + staging
|
|
177
|
+
Week 4: Production launch
|
|
178
|
+
→ 4 weeks to first revenue
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### Scenario 2: Enterprise Team
|
|
182
|
+
```
|
|
183
|
+
Day 1: Setup
|
|
184
|
+
Day 2-5: Architecture review + customization
|
|
185
|
+
Week 2-4: Integration with existing systems
|
|
186
|
+
→ 3 weeks to production-ready
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
### Scenario 3: Freelancer/Agency
|
|
190
|
+
```
|
|
191
|
+
Day 1: Understand patterns
|
|
192
|
+
Days 2-5: Extend for client
|
|
193
|
+
Week 2: Deploy for client
|
|
194
|
+
→ Invoice client, 40 hours billable
|
|
195
|
+
```
|