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,81 @@
|
|
|
1
|
+
# Product Backlog
|
|
2
|
+
|
|
3
|
+
## P0 - Critical (Sprint 1-2)
|
|
4
|
+
|
|
5
|
+
- [ ] **Setup**: PostgreSQL + Redis docker-compose
|
|
6
|
+
- [ ] **Auth**: JWT login/signup/refresh
|
|
7
|
+
- [ ] **Organizations**: Multi-tenant isolation
|
|
8
|
+
- [ ] **Users**: RBAC (owner, admin, member)
|
|
9
|
+
- [ ] **Subscriptions**: CRUD endpoints, plan validation
|
|
10
|
+
- [ ] **Billing**: Mock Stripe, invoice generation
|
|
11
|
+
- [ ] **Testing**: E2E tests for core flows
|
|
12
|
+
- [ ] **Documentation**: README, patterns, API docs
|
|
13
|
+
|
|
14
|
+
## P1 - High (Sprint 3-4)
|
|
15
|
+
|
|
16
|
+
- [ ] **Subscriptions**: Annual plans with 20% discount
|
|
17
|
+
- [ ] **Billing**: Retry logic for failed payments
|
|
18
|
+
- [ ] **Email**: Integration hooks for confirmation emails
|
|
19
|
+
- [ ] **Observability**: Structured JSON logging
|
|
20
|
+
- [ ] **Rate limiting**: Per-tenant + per-endpoint
|
|
21
|
+
- [ ] **Error handling**: Standardized error responses
|
|
22
|
+
- [ ] **Dashboard**: Metrics for MRR, churn, ARR
|
|
23
|
+
- [ ] **Database**: Indexes on all queries
|
|
24
|
+
|
|
25
|
+
## P2 - Medium (Q2)
|
|
26
|
+
|
|
27
|
+
- [ ] **Stripe**: Real payment integration
|
|
28
|
+
- [ ] **Webhooks**: Payment event handlers
|
|
29
|
+
- [ ] **Compliance**: GDPR data export
|
|
30
|
+
- [ ] **Audit**: Audit logging for user actions
|
|
31
|
+
- [ ] **Analytics**: Event tracking infrastructure
|
|
32
|
+
- [ ] **Performance**: Query optimization, caching
|
|
33
|
+
- [ ] **Monitoring**: Prometheus + Grafana
|
|
34
|
+
- [ ] **Tracing**: OpenTelemetry integration
|
|
35
|
+
|
|
36
|
+
## P3 - Low (Q3-Q4)
|
|
37
|
+
|
|
38
|
+
- [ ] **Multi-currency**: USD, EUR, GBP support
|
|
39
|
+
- [ ] **Tax**: Sales tax, VAT calculation
|
|
40
|
+
- [ ] **PDF**: Invoice PDF generation
|
|
41
|
+
- [ ] **MFA**: Multi-factor authentication
|
|
42
|
+
- [ ] **SSO**: SAML/OAuth integration
|
|
43
|
+
- [ ] **Mobile**: SDK for mobile apps
|
|
44
|
+
- [ ] **Internationalization**: i18n for UI
|
|
45
|
+
- [ ] **Performance**: Load testing, CDN
|
|
46
|
+
|
|
47
|
+
## Dependencies
|
|
48
|
+
|
|
49
|
+
- Setup must complete before Auth
|
|
50
|
+
- Auth must complete before Subscriptions
|
|
51
|
+
- Subscriptions must complete before Billing
|
|
52
|
+
- Core modules must complete before Analytics
|
|
53
|
+
|
|
54
|
+
## Known Issues
|
|
55
|
+
|
|
56
|
+
| Issue | Priority | Status |
|
|
57
|
+
|-------|----------|--------|
|
|
58
|
+
| None yet | - | - |
|
|
59
|
+
|
|
60
|
+
## Technical Debt
|
|
61
|
+
|
|
62
|
+
| Item | Sprint | Est. Hours |
|
|
63
|
+
|------|--------|-----------|
|
|
64
|
+
| Add integration tests | Sprint 3 | 4 |
|
|
65
|
+
| Refactor service layer | Sprint 4 | 6 |
|
|
66
|
+
| Database index optimization | Sprint 4 | 3 |
|
|
67
|
+
|
|
68
|
+
## Capacity Planning
|
|
69
|
+
|
|
70
|
+
- Team size: 1-3 engineers
|
|
71
|
+
- Velocity: 5-8 points/sprint
|
|
72
|
+
- Sprints per quarter: 12
|
|
73
|
+
- Total Q1 capacity: 60-96 points
|
|
74
|
+
|
|
75
|
+
## Prioritization Framework
|
|
76
|
+
|
|
77
|
+
1. **Frequency**: High-frequency features first (auth used every request)
|
|
78
|
+
2. **Risk**: High-risk features early (multi-tenant isolation)
|
|
79
|
+
3. **Dependencies**: Blockers before blocked
|
|
80
|
+
4. **Business value**: Revenue-impacting features (subscriptions, billing)
|
|
81
|
+
5. **Technical quality**: Testing, docs, patterns (for maintainability)
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Roadmap 12 Meses
|
|
2
|
+
|
|
3
|
+
## Q1 2024 - MVP (Agora)
|
|
4
|
+
|
|
5
|
+
### Sprint 1-2: Foundation
|
|
6
|
+
- ✅ Setup Agent: Environment + schemas
|
|
7
|
+
- ✅ Auth Agent: JWT + login/signup
|
|
8
|
+
- ✅ Organizations Agent: Multi-tenant structure
|
|
9
|
+
- **Target**: 2 semanas
|
|
10
|
+
|
|
11
|
+
### Sprint 3: Subscriptions
|
|
12
|
+
- ✅ Subscriptions Agent: CRUD + plan management
|
|
13
|
+
- ✅ Billing Agent: Mock Stripe + invoices
|
|
14
|
+
- **Target**: 1 semana
|
|
15
|
+
|
|
16
|
+
### Sprint 4: Polish & Testing
|
|
17
|
+
- ✅ E2E tests (auth, subscriptions, billing)
|
|
18
|
+
- ✅ Documentation (README, patterns)
|
|
19
|
+
- ✅ Docker compose ready
|
|
20
|
+
- **Target**: 1 semana
|
|
21
|
+
|
|
22
|
+
**Q1 Goal**: Scaffold completo, tudo funcionando, documentado.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Q2 2024 - Real Payments & Analytics
|
|
27
|
+
|
|
28
|
+
### Sprint 5-6: Real Stripe Integration
|
|
29
|
+
- Real Stripe API integration
|
|
30
|
+
- Webhook handlers
|
|
31
|
+
- Refund processing
|
|
32
|
+
- Tax calculation (US states)
|
|
33
|
+
|
|
34
|
+
### Sprint 7: Analytics
|
|
35
|
+
- Event tracking infrastructure
|
|
36
|
+
- Churn monitoring
|
|
37
|
+
- MRR/ARR dashboard
|
|
38
|
+
- Usage analytics
|
|
39
|
+
|
|
40
|
+
**Q2 Goal**: Production payment processing, observability.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Q3 2024 - Scale & Compliance
|
|
45
|
+
|
|
46
|
+
### Sprint 9-10: Observability
|
|
47
|
+
- Prometheus metrics
|
|
48
|
+
- Grafana dashboards
|
|
49
|
+
- Distributed tracing (OpenTelemetry)
|
|
50
|
+
- Error tracking (Sentry)
|
|
51
|
+
|
|
52
|
+
### Sprint 11: Compliance
|
|
53
|
+
- SOC2 readiness
|
|
54
|
+
- GDPR data export
|
|
55
|
+
- Audit logging
|
|
56
|
+
- Rate limiting per endpoint
|
|
57
|
+
|
|
58
|
+
**Q3 Goal**: Enterprise-ready, auditable, observable.
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Q4 2024 - Internationalization
|
|
63
|
+
|
|
64
|
+
### Sprint 13-14: Multi-Currency
|
|
65
|
+
- Multi-currency support
|
|
66
|
+
- Exchange rate handling
|
|
67
|
+
- Localized pricing
|
|
68
|
+
- Regional compliance (EU VAT, etc)
|
|
69
|
+
|
|
70
|
+
### Sprint 15: Performance
|
|
71
|
+
- Database query optimization
|
|
72
|
+
- Caching strategy refinement
|
|
73
|
+
- Bulk operations
|
|
74
|
+
- Load testing
|
|
75
|
+
|
|
76
|
+
**Q4 Goal**: Global scale, optimized performance.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Known Risks & Mitigations
|
|
81
|
+
|
|
82
|
+
| Risk | Probability | Impact | Mitigation |
|
|
83
|
+
|------|-------------|--------|-----------|
|
|
84
|
+
| Payment gateway changes | Low | High | Abstract payment layer, easy swap |
|
|
85
|
+
| Scale issues in month 3 | Medium | Medium | Load testing in Q2, caching strategy |
|
|
86
|
+
| Compliance complexity | High | Medium | Legal review early, audit trails |
|
|
87
|
+
| Team onboarding | Medium | Medium | Comprehensive docs, pattern examples |
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Success Metrics
|
|
92
|
+
|
|
93
|
+
- **Velocity**: 5 points/sprint (stabilize Q2)
|
|
94
|
+
- **Quality**: >80% test coverage, <1% bug escape
|
|
95
|
+
- **Deployment**: <30 min per release
|
|
96
|
+
- **Documentation**: 100% API endpoints documented
|
|
97
|
+
- **Time to MVP**: <4 weeks for new SaaS using this kit
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Sprint Atual - Sprint 1
|
|
2
|
+
|
|
3
|
+
**Duration**: 2024-01-15 to 2024-01-26
|
|
4
|
+
**Goal**: Foundation complete, all modules created and tested
|
|
5
|
+
|
|
6
|
+
## Tasks
|
|
7
|
+
|
|
8
|
+
### Setup Agent
|
|
9
|
+
- [ ] PostgreSQL container running (docker-compose)
|
|
10
|
+
- [ ] Migrations created
|
|
11
|
+
- [ ] Seed data generated
|
|
12
|
+
- [ ] Redis cache ready
|
|
13
|
+
- [ ] Environment variables documented (.env.example)
|
|
14
|
+
|
|
15
|
+
### Auth Agent
|
|
16
|
+
- [ ] User entity with password hash
|
|
17
|
+
- [ ] JWT strategy implemented
|
|
18
|
+
- [ ] Local strategy implemented
|
|
19
|
+
- [ ] Login endpoint working
|
|
20
|
+
- [ ] Signup endpoint with org creation
|
|
21
|
+
- [ ] Refresh token endpoint
|
|
22
|
+
- [ ] E2E tests passing
|
|
23
|
+
|
|
24
|
+
### Organizations Agent
|
|
25
|
+
- [ ] Organization entity
|
|
26
|
+
- [ ] Multi-tenant context middleware
|
|
27
|
+
- [ ] Tenant isolation verified
|
|
28
|
+
- [ ] Organization CRUD endpoints
|
|
29
|
+
- [ ] Tests for tenant isolation
|
|
30
|
+
|
|
31
|
+
### Users Agent
|
|
32
|
+
- [ ] User entity with roles
|
|
33
|
+
- [ ] RBAC matrix implemented
|
|
34
|
+
- [ ] Invite user endpoint
|
|
35
|
+
- [ ] Remove user endpoint
|
|
36
|
+
- [ ] Tests for RBAC
|
|
37
|
+
|
|
38
|
+
### Documentation
|
|
39
|
+
- [ ] README.md with quick start
|
|
40
|
+
- [ ] QUICK_START.md guide
|
|
41
|
+
- [ ] .env.example configured
|
|
42
|
+
- [ ] Patterns documented (copy from memory/00-global/patterns.md)
|
|
43
|
+
|
|
44
|
+
## Blockers
|
|
45
|
+
|
|
46
|
+
None currently.
|
|
47
|
+
|
|
48
|
+
## Velocity
|
|
49
|
+
|
|
50
|
+
Target: 8 story points
|
|
51
|
+
Completed: 0 (sprint just started)
|
|
52
|
+
|
|
53
|
+
## Decisions Made
|
|
54
|
+
|
|
55
|
+
- JWT expiry: 15 min access, 7 days refresh (see ADR if created)
|
|
56
|
+
- Password hash: bcrypt cost=12
|
|
57
|
+
- Database: PostgreSQL (see ADR in 90-decisions/)
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# Topologia de Agentes
|
|
2
|
+
|
|
3
|
+
## Sequência de Execução
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
Setup Agent (0 deps)
|
|
7
|
+
↓
|
|
8
|
+
├→ Auth Agent
|
|
9
|
+
│ ↓
|
|
10
|
+
│ ├→ Subscriptions Agent
|
|
11
|
+
│ │ ↓
|
|
12
|
+
│ │ └→ Billing Agent
|
|
13
|
+
│ │
|
|
14
|
+
│ └→ Users Agent (RBAC)
|
|
15
|
+
│
|
|
16
|
+
├→ Organizations Agent (Multi-tenant)
|
|
17
|
+
│
|
|
18
|
+
└→ Analytics Agent (não-blocking, last)
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Agentes & Timeline
|
|
22
|
+
|
|
23
|
+
| # | Agent | Deps | Duration | Output |
|
|
24
|
+
|---|-------|------|----------|--------|
|
|
25
|
+
| 1 | Setup | - | 2h | ENV + DB ready |
|
|
26
|
+
| 2 | Auth | Setup | 4h | JWT auth working |
|
|
27
|
+
| 3 | Organizations | Setup | 2h | Multi-tenant isolation |
|
|
28
|
+
| 4 | Users | Auth + Orgs | 3h | RBAC matrix |
|
|
29
|
+
| 5 | Subscriptions | Auth + Users | 3h | Plans + CRUD |
|
|
30
|
+
| 6 | Billing | Subscriptions | 3h | Mock Stripe |
|
|
31
|
+
| 7 | Analytics | All (optional) | 2h | Event tracking |
|
|
32
|
+
|
|
33
|
+
**Total sequential**: 19 hours
|
|
34
|
+
**With parallelization**: 11 hours (Auth + Orgs parallel, then rest)
|
|
35
|
+
|
|
36
|
+
## Parallelização Possível
|
|
37
|
+
|
|
38
|
+
### Wave 1 (Start)
|
|
39
|
+
- Setup Agent (blocking, must complete first)
|
|
40
|
+
|
|
41
|
+
### Wave 2 (After Setup)
|
|
42
|
+
- Auth Agent (parallel)
|
|
43
|
+
- Organizations Agent (parallel)
|
|
44
|
+
|
|
45
|
+
### Wave 3 (After Wave 2)
|
|
46
|
+
- Users Agent (depends on Auth + Orgs)
|
|
47
|
+
- Subscriptions Agent (depends on Auth)
|
|
48
|
+
|
|
49
|
+
### Wave 4 (After Wave 3)
|
|
50
|
+
- Billing Agent (depends on Subscriptions)
|
|
51
|
+
|
|
52
|
+
### Wave 5 (Optional)
|
|
53
|
+
- Analytics Agent (optional, non-blocking)
|
|
54
|
+
|
|
55
|
+
## Decisões & Handoffs
|
|
56
|
+
|
|
57
|
+
Cada agente cria handoff document (`memory/50-orchestration/handoffs/`) após completar:
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
handoffs/
|
|
61
|
+
├── 2024-01-15-setup-auth.md (Setup → Auth)
|
|
62
|
+
├── 2024-01-15-auth-subscriptions.md (Auth → Subscriptions)
|
|
63
|
+
├── 2024-01-15-subscriptions-billing.md (Subscriptions → Billing)
|
|
64
|
+
└── ...
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Critérios de Sucesso
|
|
68
|
+
|
|
69
|
+
Agente completa quando:
|
|
70
|
+
1. ✅ Todos endpoints implementados
|
|
71
|
+
2. ✅ Testes E2E passando
|
|
72
|
+
3. ✅ Zero breaking changes
|
|
73
|
+
4. ✅ Documentação atualizada (memory/30-domains/)
|
|
74
|
+
5. ✅ Run log criado (memory/60-runs/)
|
|
75
|
+
6. ✅ Handoff document criado
|
|
76
|
+
|
|
77
|
+
## Escalation Path
|
|
78
|
+
|
|
79
|
+
Se agente falha:
|
|
80
|
+
1. Registrar em memory/60-runs/{date}-ERROR.md
|
|
81
|
+
2. Criar issue no backlog como bloqueador
|
|
82
|
+
3. Revisar com tech lead
|
|
83
|
+
4. Retry com contexto de erro (ADR)
|
|
84
|
+
5. Se persiste: manual investigation
|
|
85
|
+
|
|
86
|
+
## Monitoring
|
|
87
|
+
|
|
88
|
+
- Agentes com timeout: >4 horas sem handoff
|
|
89
|
+
- Quality gate: Coverage <60% ou testes falhando
|
|
90
|
+
- Performance: E2E tests >30s = investigate
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Índice de Execuções (Runs)
|
|
2
|
+
|
|
3
|
+
Histórico de execuções de agentes, testes e deployments.
|
|
4
|
+
|
|
5
|
+
## Runs Completas
|
|
6
|
+
|
|
7
|
+
- TBD (nenhuma execução ainda)
|
|
8
|
+
|
|
9
|
+
## Runs em Andamento
|
|
10
|
+
|
|
11
|
+
- TBD
|
|
12
|
+
|
|
13
|
+
## Runs Falhadas
|
|
14
|
+
|
|
15
|
+
- TBD
|
|
16
|
+
|
|
17
|
+
## Como Adicionar Run
|
|
18
|
+
|
|
19
|
+
Cada agente, após completar tarefa, cria arquivo: `YYYY-MM-DD-agent-task.md`
|
|
20
|
+
|
|
21
|
+
```markdown
|
|
22
|
+
# Auth Setup - 2024-01-15 14:30:00
|
|
23
|
+
|
|
24
|
+
## Agente
|
|
25
|
+
Auth Agent
|
|
26
|
+
|
|
27
|
+
## Tarefa
|
|
28
|
+
Implementar JWT + login/signup
|
|
29
|
+
|
|
30
|
+
## Status
|
|
31
|
+
✅ COMPLETA
|
|
32
|
+
|
|
33
|
+
## Saída
|
|
34
|
+
- POST /api/auth/signup
|
|
35
|
+
- POST /api/auth/login
|
|
36
|
+
- POST /api/auth/refresh
|
|
37
|
+
- GET /api/auth/me
|
|
38
|
+
- E2E tests: 12 passing
|
|
39
|
+
|
|
40
|
+
## Issues Encontrados
|
|
41
|
+
- None
|
|
42
|
+
|
|
43
|
+
## Próximo Agente
|
|
44
|
+
Subscriptions Agent
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Métricas de Execução
|
|
48
|
+
|
|
49
|
+
| Métrica | Q1 Target |
|
|
50
|
+
|---------|-----------|
|
|
51
|
+
| Sprint velocity | 5-8 pts/sprint |
|
|
52
|
+
| Test coverage | >60% |
|
|
53
|
+
| Deployment time | <30 min |
|
|
54
|
+
| Failed runs | 0 |
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Sumário Executivo Global
|
|
2
|
+
|
|
3
|
+
**Data**: 2024-01-15
|
|
4
|
+
**Status**: 🚀 Scaffold criado, pronto para desenvolvimento
|
|
5
|
+
|
|
6
|
+
## Funcionalidades Implementadas
|
|
7
|
+
|
|
8
|
+
- ✅ Estrutura de memória (10 níveis)
|
|
9
|
+
- ✅ Padrões & convenções documentados
|
|
10
|
+
- ✅ Contrato de agentes definido
|
|
11
|
+
- ✅ Roadmap 12 meses
|
|
12
|
+
- ✅ Domain contexts (auth, subscriptions, billing)
|
|
13
|
+
- ✅ API specifications documentadas
|
|
14
|
+
|
|
15
|
+
## Funcionalidades Pendentes
|
|
16
|
+
|
|
17
|
+
- 🚧 Backend NestJS (módulos)
|
|
18
|
+
- 🚧 Testes E2E
|
|
19
|
+
- 🚧 Docker-compose funcional
|
|
20
|
+
- 🚧 Implementação de agents
|
|
21
|
+
|
|
22
|
+
## Métricas
|
|
23
|
+
|
|
24
|
+
| Métrica | Alvo | Atual | Status |
|
|
25
|
+
|---------|------|-------|--------|
|
|
26
|
+
| Memory docs | 100% | 100% | ✅ |
|
|
27
|
+
| API endpoints spec | 18 | 0 | 🚧 |
|
|
28
|
+
| Test coverage | 60% | - | 🚧 |
|
|
29
|
+
| E2E tests | 15+ | 0 | 🚧 |
|
|
30
|
+
| Deployment | <30min | - | 🚧 |
|
|
31
|
+
|
|
32
|
+
## Bloqueadores
|
|
33
|
+
|
|
34
|
+
- None (all items on track)
|
|
35
|
+
|
|
36
|
+
## Próximos Steps
|
|
37
|
+
|
|
38
|
+
1. **Próximo Agente**: Setup Agent
|
|
39
|
+
2. **Próxima Tarefa**: PostgreSQL + Redis docker-compose
|
|
40
|
+
3. **Próximo Milestone**: Sprint 1 (1-2 semanas)
|
|
41
|
+
|
|
42
|
+
## Time & Recursos
|
|
43
|
+
|
|
44
|
+
- **Dedicação**: 1-3 engineers
|
|
45
|
+
- **Stack**: TypeScript, NestJS, PostgreSQL, Redis
|
|
46
|
+
- **Infrastructure**: Docker-compose (dev), AWS RDS (prod)
|
|
47
|
+
|
|
48
|
+
## Risk Assessment
|
|
49
|
+
|
|
50
|
+
🟢 **BAIXO RISCO** - Arquitetura clara, padrões bem definidos, dependências resolvidas.
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
# Database Schema
|
|
2
|
+
|
|
3
|
+
## Entities & Relationships
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
Organization (1) ──→ (Many) User
|
|
7
|
+
Organization (1) ──→ (1) Subscription
|
|
8
|
+
Organization (1) ──→ (Many) Invoice
|
|
9
|
+
Subscription (1) ──→ (Many) Invoice
|
|
10
|
+
User (1) ──→ (Many) Audit Log
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Entity: Organization
|
|
14
|
+
|
|
15
|
+
```sql
|
|
16
|
+
CREATE TABLE organizations (
|
|
17
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
18
|
+
tenantId UUID NOT NULL UNIQUE,
|
|
19
|
+
name VARCHAR(255) NOT NULL,
|
|
20
|
+
slug VARCHAR(255) NOT NULL UNIQUE,
|
|
21
|
+
ownerUserId UUID NOT NULL REFERENCES users(id),
|
|
22
|
+
plan VARCHAR(50) NOT NULL DEFAULT 'free',
|
|
23
|
+
stripeCustomerId VARCHAR(255),
|
|
24
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
25
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
26
|
+
deletedAt TIMESTAMP
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE INDEX idx_org_tenant ON organizations(tenantId);
|
|
30
|
+
CREATE INDEX idx_org_owner ON organizations(ownerUserId);
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Entity: User
|
|
34
|
+
|
|
35
|
+
```sql
|
|
36
|
+
CREATE TABLE users (
|
|
37
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
38
|
+
tenantId UUID NOT NULL,
|
|
39
|
+
email VARCHAR(255) NOT NULL,
|
|
40
|
+
passwordHash VARCHAR(255),
|
|
41
|
+
firstName VARCHAR(100),
|
|
42
|
+
lastName VARCHAR(100),
|
|
43
|
+
roles VARCHAR(50)[] DEFAULT ARRAY['member'],
|
|
44
|
+
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
45
|
+
emailVerifiedAt TIMESTAMP,
|
|
46
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
47
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
48
|
+
deletedAt TIMESTAMP,
|
|
49
|
+
CONSTRAINT fk_user_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
50
|
+
);
|
|
51
|
+
|
|
52
|
+
CREATE INDEX idx_user_tenant_email ON users(tenantId, email);
|
|
53
|
+
CREATE INDEX idx_user_tenant_status ON users(tenantId, status);
|
|
54
|
+
CREATE UNIQUE INDEX idx_user_unique_email ON users(tenantId, email) WHERE deletedAt IS NULL;
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Entity: Subscription
|
|
58
|
+
|
|
59
|
+
```sql
|
|
60
|
+
CREATE TABLE subscriptions (
|
|
61
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
62
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
63
|
+
tenantId UUID NOT NULL,
|
|
64
|
+
plan VARCHAR(50) NOT NULL,
|
|
65
|
+
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
66
|
+
currentPeriodStart TIMESTAMP NOT NULL,
|
|
67
|
+
currentPeriodEnd TIMESTAMP NOT NULL,
|
|
68
|
+
cancelAtPeriodEnd BOOLEAN DEFAULT FALSE,
|
|
69
|
+
cancelledAt TIMESTAMP,
|
|
70
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
71
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
72
|
+
CONSTRAINT fk_sub_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
73
|
+
);
|
|
74
|
+
|
|
75
|
+
CREATE INDEX idx_sub_org ON subscriptions(organizationId);
|
|
76
|
+
CREATE INDEX idx_sub_tenant ON subscriptions(tenantId);
|
|
77
|
+
CREATE INDEX idx_sub_status ON subscriptions(tenantId, status);
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Entity: Invoice
|
|
81
|
+
|
|
82
|
+
```sql
|
|
83
|
+
CREATE TABLE invoices (
|
|
84
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
85
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
86
|
+
tenantId UUID NOT NULL,
|
|
87
|
+
invoiceNumber VARCHAR(50) NOT NULL UNIQUE,
|
|
88
|
+
subscriptionId UUID REFERENCES subscriptions(id),
|
|
89
|
+
amount DECIMAL(10, 2) NOT NULL,
|
|
90
|
+
currency VARCHAR(3) NOT NULL DEFAULT 'USD',
|
|
91
|
+
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
92
|
+
description TEXT,
|
|
93
|
+
items JSONB,
|
|
94
|
+
issuedAt TIMESTAMP NOT NULL,
|
|
95
|
+
dueDate TIMESTAMP,
|
|
96
|
+
paidAt TIMESTAMP,
|
|
97
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
98
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
99
|
+
CONSTRAINT fk_invoice_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
100
|
+
);
|
|
101
|
+
|
|
102
|
+
CREATE INDEX idx_inv_org ON invoices(organizationId);
|
|
103
|
+
CREATE INDEX idx_inv_tenant ON invoices(tenantId);
|
|
104
|
+
CREATE INDEX idx_inv_status ON invoices(tenantId, status);
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Entity: Payment Transaction
|
|
108
|
+
|
|
109
|
+
```sql
|
|
110
|
+
CREATE TABLE transactions (
|
|
111
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
112
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
113
|
+
tenantId UUID NOT NULL,
|
|
114
|
+
invoiceId UUID REFERENCES invoices(id),
|
|
115
|
+
amount DECIMAL(10, 2) NOT NULL,
|
|
116
|
+
currency VARCHAR(3) NOT NULL,
|
|
117
|
+
type VARCHAR(50) NOT NULL,
|
|
118
|
+
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
119
|
+
paymentMethodId VARCHAR(255),
|
|
120
|
+
stripePaymentIntentId VARCHAR(255),
|
|
121
|
+
description TEXT,
|
|
122
|
+
failureReason TEXT,
|
|
123
|
+
retryCount INT DEFAULT 0,
|
|
124
|
+
nextRetryAt TIMESTAMP,
|
|
125
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
126
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
127
|
+
CONSTRAINT fk_txn_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
128
|
+
);
|
|
129
|
+
|
|
130
|
+
CREATE INDEX idx_txn_org ON transactions(organizationId);
|
|
131
|
+
CREATE INDEX idx_txn_tenant ON transactions(tenantId);
|
|
132
|
+
CREATE INDEX idx_txn_invoice ON transactions(invoiceId);
|
|
133
|
+
CREATE INDEX idx_txn_status ON transactions(tenantId, status);
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## Entity: Audit Log
|
|
137
|
+
|
|
138
|
+
```sql
|
|
139
|
+
CREATE TABLE audit_logs (
|
|
140
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
141
|
+
tenantId UUID NOT NULL,
|
|
142
|
+
userId UUID REFERENCES users(id),
|
|
143
|
+
action VARCHAR(100) NOT NULL,
|
|
144
|
+
entity VARCHAR(100) NOT NULL,
|
|
145
|
+
entityId UUID,
|
|
146
|
+
changes JSONB,
|
|
147
|
+
ipAddress INET,
|
|
148
|
+
userAgent TEXT,
|
|
149
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
150
|
+
CONSTRAINT fk_audit_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
151
|
+
);
|
|
152
|
+
|
|
153
|
+
CREATE INDEX idx_audit_tenant ON audit_logs(tenantId);
|
|
154
|
+
CREATE INDEX idx_audit_user ON audit_logs(userId);
|
|
155
|
+
CREATE INDEX idx_audit_action ON audit_logs(action);
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## Entity: API Key (Future)
|
|
159
|
+
|
|
160
|
+
```sql
|
|
161
|
+
CREATE TABLE api_keys (
|
|
162
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
163
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
164
|
+
tenantId UUID NOT NULL,
|
|
165
|
+
keyHash VARCHAR(255) NOT NULL UNIQUE,
|
|
166
|
+
name VARCHAR(255) NOT NULL,
|
|
167
|
+
lastUsedAt TIMESTAMP,
|
|
168
|
+
expiresAt TIMESTAMP,
|
|
169
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
170
|
+
revokedAt TIMESTAMP,
|
|
171
|
+
CONSTRAINT fk_apikey_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
172
|
+
);
|
|
173
|
+
|
|
174
|
+
CREATE INDEX idx_apikey_org ON api_keys(organizationId);
|
|
175
|
+
CREATE INDEX idx_apikey_hash ON api_keys(keyHash);
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## Constraints & Rules
|
|
179
|
+
|
|
180
|
+
- Every table has `tenantId` for isolation
|
|
181
|
+
- Foreign keys enforce referential integrity
|
|
182
|
+
- Soft deletes with `deletedAt`
|
|
183
|
+
- Timestamps: `createdAt`, `updatedAt` on every table
|
|
184
|
+
- Indexes on every foreign key + filtering column
|
|
185
|
+
- Unique constraints on business keys (email, invoiceNumber, etc)
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# ADR Template - Architecture Decision Records
|
|
2
|
+
|
|
3
|
+
Use este template para documentar decisões arquiteturais importantes.
|
|
4
|
+
|
|
5
|
+
## ADR-YYYYMMDD-XXX: {Título da Decisão}
|
|
6
|
+
|
|
7
|
+
**Date**: YYYY-MM-DD
|
|
8
|
+
**Status**: Proposed | Accepted | Deprecated | Superseded by ADR-...
|
|
9
|
+
**Deciders**: [names]
|
|
10
|
+
|
|
11
|
+
## Context
|
|
12
|
+
|
|
13
|
+
Descreva o problema ou situação que motivou esta decisão.
|
|
14
|
+
|
|
15
|
+
**Background**:
|
|
16
|
+
- What is the issue?
|
|
17
|
+
- Why now?
|
|
18
|
+
- What constraints exist?
|
|
19
|
+
|
|
20
|
+
**Options Considered**:
|
|
21
|
+
1. Option A
|
|
22
|
+
2. Option B
|
|
23
|
+
3. Option C
|
|
24
|
+
|
|
25
|
+
## Decision
|
|
26
|
+
|
|
27
|
+
Declare qual opção foi escolhida e por quê.
|
|
28
|
+
|
|
29
|
+
## Consequences
|
|
30
|
+
|
|
31
|
+
### Positive
|
|
32
|
+
- Benefit 1
|
|
33
|
+
- Benefit 2
|
|
34
|
+
|
|
35
|
+
### Negative
|
|
36
|
+
- Risk 1
|
|
37
|
+
- Risk 2
|
|
38
|
+
|
|
39
|
+
### Neutral
|
|
40
|
+
- Other impact 1
|
|
41
|
+
|
|
42
|
+
## Rationale
|
|
43
|
+
|
|
44
|
+
Explique o raciocínio por trás dessa decisão em detalhes.
|
|
45
|
+
|
|
46
|
+
## Related ADRs
|
|
47
|
+
|
|
48
|
+
- ADR-YYYYMMDD-XXX (related decision)
|
|
49
|
+
- ADR-YYYYMMDD-YYY (conflicting/complementary decision)
|
|
50
|
+
|
|
51
|
+
## Examples
|
|
52
|
+
|
|
53
|
+
### Exemplo: Por que PostgreSQL?
|
|
54
|
+
|
|
55
|
+
**ADR-20240115-001: Database Choice**
|
|
56
|
+
|
|
57
|
+
**Context**
|
|
58
|
+
- Need relational data (users, orgs, subscriptions, invoices)
|
|
59
|
+
- Transactions required (ACID) for billing
|
|
60
|
+
- Multi-tenant architecture demands row-level security
|
|
61
|
+
- Cost considerations
|
|
62
|
+
|
|
63
|
+
**Decision**
|
|
64
|
+
PostgreSQL with row-level tenant isolation (tenantId column)
|
|
65
|
+
|
|
66
|
+
**Consequences**
|
|
67
|
+
- ✅ Strong ACID guarantees for billing
|
|
68
|
+
- ✅ Mature ecosystem, lots of examples
|
|
69
|
+
- ✅ Managed options (RDS, Heroku)
|
|
70
|
+
- ✅ Full-text search (future feature)
|
|
71
|
+
- ❌ Slightly higher latency vs NoSQL (acceptable)
|
|
72
|
+
- ❌ Vertical scaling limits (acceptable for MVP)
|
|
73
|
+
|
|
74
|
+
**Rationale**
|
|
75
|
+
Banking/billing requires ACID compliance. MongoDB would introduce risks for money operations. PostgreSQL is battle-tested in production SaaS platforms.
|