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,102 @@
|
|
|
1
|
+
# 📑 Index
|
|
2
|
+
|
|
3
|
+
## Memory Structure - Microservices Platform
|
|
4
|
+
|
|
5
|
+
### 00-global/
|
|
6
|
+
Contexto global e políticas transversais
|
|
7
|
+
- **mission.md** - Visão, princípios e objetivos
|
|
8
|
+
- **patterns.md** - Padrões arquiteturais (DB per service, API Gateway, Service Discovery, Circuit Breaker)
|
|
9
|
+
- **context-policy.md** - Headers, error formats, health checks
|
|
10
|
+
- **agent-contract.md** - Contrato entre serviços, responsabilidades, SLAs
|
|
11
|
+
|
|
12
|
+
### 10-product/
|
|
13
|
+
Contexto de negócio e produto
|
|
14
|
+
- **vision.md** - Visão de produto e roadmap
|
|
15
|
+
- **personas.md** - Personas de usuários
|
|
16
|
+
- **business-rules.md** - Regras de negócio por domínio
|
|
17
|
+
- **nfrs.md** - Non-functional requirements (performance, security, availability)
|
|
18
|
+
|
|
19
|
+
### 20-architecture/
|
|
20
|
+
Arquitetura técnica
|
|
21
|
+
- **overview.md** - Visão geral do sistema, diagrama de componentes
|
|
22
|
+
- **frontend-architecture.md** - Cliente (web/mobile)
|
|
23
|
+
- **backend-architecture.md** - Microserviços, API Gateway, service mesh
|
|
24
|
+
- **data-architecture.md** - Databases, caching, message queues
|
|
25
|
+
- **security-architecture.md** - Autenticação, autorização, encryption
|
|
26
|
+
- **observability-architecture.md** - Logging, tracing, metrics
|
|
27
|
+
|
|
28
|
+
### 30-domains/
|
|
29
|
+
Domínios de negócio isolados
|
|
30
|
+
|
|
31
|
+
#### 30-domains/auth-service/
|
|
32
|
+
- **context.md** - Bounded context de autenticação
|
|
33
|
+
- **api.md** - Endpoints, schemas, exemplos
|
|
34
|
+
|
|
35
|
+
#### 30-domains/user-service/
|
|
36
|
+
- **context.md** - Bounded context de gerenciamento de usuários
|
|
37
|
+
- **api.md** - Endpoints, schemas, exemplos
|
|
38
|
+
|
|
39
|
+
#### 30-domains/notification-service/
|
|
40
|
+
- **context.md** - Bounded context de notificações
|
|
41
|
+
- **api.md** - Endpoints, schemas, exemplos
|
|
42
|
+
|
|
43
|
+
### 40-delivery/
|
|
44
|
+
Plano de entrega
|
|
45
|
+
- **roadmap.md** - Fases de desenvolvimento
|
|
46
|
+
- **current-sprint.md** - Sprint atual (backlog, tasks)
|
|
47
|
+
- **backlog.md** - Product backlog priorizado
|
|
48
|
+
|
|
49
|
+
### 50-orchestration/
|
|
50
|
+
Orquestração de serviços
|
|
51
|
+
- **topology.md** - Visão física: ports, DNS, service registry
|
|
52
|
+
- **routing.md** - Regras de roteamento no API Gateway
|
|
53
|
+
- **handoff-protocol.md** - Protocolo de comunicação inter-service
|
|
54
|
+
- **parallel-playbook.md** - Execução paralela de operações
|
|
55
|
+
- **handoffs-directory.md** - Diretório de handoffs realizados
|
|
56
|
+
|
|
57
|
+
### 60-runs/
|
|
58
|
+
Logs de execução
|
|
59
|
+
- **execution-log.md** - Timeline de deployments e incidents
|
|
60
|
+
- **performance-baseline.md** - Benchmarks de performance
|
|
61
|
+
|
|
62
|
+
### 70-summaries/
|
|
63
|
+
Resumos para quick reference
|
|
64
|
+
- **global-summary.md** - Overview do sistema completo
|
|
65
|
+
- **domain-summaries/** - Resumos por serviço
|
|
66
|
+
|
|
67
|
+
### 80-data/
|
|
68
|
+
Documentação de dados
|
|
69
|
+
- **sqlite-schema.md** - Schema do SQLite (se usado localmente)
|
|
70
|
+
- **postgresql-schema.md** - Schema dos PostgreSQL de cada serviço
|
|
71
|
+
- **message-schema.md** - Schema dos eventos em RabbitMQ
|
|
72
|
+
|
|
73
|
+
### 90-decisions/
|
|
74
|
+
Arquitetura e decisões técnicas
|
|
75
|
+
- **adr-template.md** - Template de ADR (Architecture Decision Record)
|
|
76
|
+
- **adr-001-microservices.md** - Decisão: por que microserviços?
|
|
77
|
+
- **adr-002-nestjs-choice.md** - Decisão: por que NestJS?
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Quick Navigation
|
|
82
|
+
|
|
83
|
+
**Para iniciantes:**
|
|
84
|
+
1. Comece em `00-global/mission.md`
|
|
85
|
+
2. Entenda os padrões em `00-global/patterns.md`
|
|
86
|
+
3. Leia `20-architecture/overview.md`
|
|
87
|
+
4. Explore domínios em `30-domains/`
|
|
88
|
+
|
|
89
|
+
**Para implementação:**
|
|
90
|
+
1. Consulte `30-domains/<service>/api.md`
|
|
91
|
+
2. Verifique SLAs em `00-global/agent-contract.md`
|
|
92
|
+
3. Use `20-architecture/backend-architecture.md` para detalhes técnicos
|
|
93
|
+
4. Veja exemplos em `memory/EXEMPLOS-CODIGO.md`
|
|
94
|
+
|
|
95
|
+
**Para operações:**
|
|
96
|
+
1. Topologia: `50-orchestration/topology.md`
|
|
97
|
+
2. Roteamento: `50-orchestration/routing.md`
|
|
98
|
+
3. Protocolo: `50-orchestration/handoff-protocol.md`
|
|
99
|
+
4. Logs: `60-runs/execution-log.md`
|
|
100
|
+
|
|
101
|
+
**Para decisões técnicas:**
|
|
102
|
+
- Consulte `90-decisions/` para entender o "why" de cada decisão
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# 🎯 Mission
|
|
2
|
+
|
|
3
|
+
## Visão Geral
|
|
4
|
+
Construir uma plataforma de microserviços escalável, resiliente e independente que segue os princípios de **Domain-Driven Design** e **Service Autonomy**.
|
|
5
|
+
|
|
6
|
+
## Princípios Fundamentais
|
|
7
|
+
|
|
8
|
+
### 1. Autonomia de Serviço
|
|
9
|
+
- Cada microserviço é independente e autossuficiente
|
|
10
|
+
- Propriedade completa de dados (database per service)
|
|
11
|
+
- Deploy independente sem sincronização
|
|
12
|
+
- Comunicação via APIs bem definidas
|
|
13
|
+
|
|
14
|
+
### 2. Resiliência
|
|
15
|
+
- Circuit breakers para falhas de serviço
|
|
16
|
+
- Retry policies com exponential backoff
|
|
17
|
+
- Graceful degradation
|
|
18
|
+
- Health checks e liveness probes
|
|
19
|
+
|
|
20
|
+
### 3. Observabilidade
|
|
21
|
+
- Distributed tracing (OpenTelemetry ready)
|
|
22
|
+
- Centralized logging (ELK stack ready)
|
|
23
|
+
- Metrics & monitoring
|
|
24
|
+
- Correlation IDs em todas as requisições
|
|
25
|
+
|
|
26
|
+
### 4. Escalabilidade
|
|
27
|
+
- Horizontal scaling
|
|
28
|
+
- Load balancing via API Gateway
|
|
29
|
+
- Message queues para comunicação async
|
|
30
|
+
- Caching distribuído com Redis
|
|
31
|
+
|
|
32
|
+
## Objetivos de Curto Prazo
|
|
33
|
+
1. ✅ Setup Docker Compose com todos os serviços
|
|
34
|
+
2. ✅ Implementar API Gateway como ponto de entrada único
|
|
35
|
+
3. ✅ Configurar Service Discovery (DNS-based)
|
|
36
|
+
4. ✅ Integração com RabbitMQ para eventos assíncronos
|
|
37
|
+
5. ✅ Shared types package em TypeScript
|
|
38
|
+
|
|
39
|
+
## Success Criteria
|
|
40
|
+
- Cada serviço roda independentemente
|
|
41
|
+
- Comunicação cross-service via HTTP REST (síncrona) e RabbitMQ (assíncrona)
|
|
42
|
+
- API Gateway roteia requisições corretamente
|
|
43
|
+
- Services se recuperam de falhas gracefully
|
|
44
|
+
- Código é testável e documentado
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# 🏗️ Service Autonomy Patterns
|
|
2
|
+
|
|
3
|
+
## Pattern: Database per Service
|
|
4
|
+
Cada microserviço possui seu próprio database PostgreSQL.
|
|
5
|
+
|
|
6
|
+
```
|
|
7
|
+
┌─────────────────┐
|
|
8
|
+
│ auth-service │─────► auth_db (PostgreSQL)
|
|
9
|
+
└─────────────────┘
|
|
10
|
+
|
|
11
|
+
┌─────────────────┐
|
|
12
|
+
│ user-service │─────► users_db (PostgreSQL)
|
|
13
|
+
└─────────────────┘
|
|
14
|
+
|
|
15
|
+
┌──────────────────────────┐
|
|
16
|
+
│ notification-service │─────► No DB (stateless)
|
|
17
|
+
└──────────────────────────┘
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
**Benefícios:**
|
|
21
|
+
- Sem lock-in tecnológico
|
|
22
|
+
- Escalabilidade independente
|
|
23
|
+
- Migração de schema sem sincronização
|
|
24
|
+
- Isolamento de falhas
|
|
25
|
+
|
|
26
|
+
**Trade-offs:**
|
|
27
|
+
- Complexidade de transações distribuídas
|
|
28
|
+
- Eventual consistency
|
|
29
|
+
- Data synchronization via eventos
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Pattern: API Gateway
|
|
34
|
+
Ponto de entrada único que roteia requisições para os microserviços.
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
Client
|
|
38
|
+
│
|
|
39
|
+
├──► /auth/* ──► auth-service:3001
|
|
40
|
+
│
|
|
41
|
+
├──► /users/* ──► user-service:3002
|
|
42
|
+
│
|
|
43
|
+
└──► /notifications/* ──► notification-service:3003
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**Responsabilidades:**
|
|
47
|
+
- Roteamento de requisições
|
|
48
|
+
- Autenticação/Autorização
|
|
49
|
+
- Rate limiting
|
|
50
|
+
- Agregação de responses
|
|
51
|
+
- Error handling centralizado
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Pattern: Service Discovery
|
|
56
|
+
Services se registram e descobrem uns aos outros.
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
┌──────────────────┐
|
|
60
|
+
│ Service Registry │
|
|
61
|
+
│ (DNS / Consul) │
|
|
62
|
+
└──────────────────┘
|
|
63
|
+
▲
|
|
64
|
+
│ register/deregister
|
|
65
|
+
│
|
|
66
|
+
┌────┴────────────────────┐
|
|
67
|
+
│ auth-service │
|
|
68
|
+
│ user-service │
|
|
69
|
+
│ notification-service │
|
|
70
|
+
└─────────────────────────┘
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Pattern: Event-Driven Communication
|
|
76
|
+
Serviços se comunicam via RabbitMQ para operações assíncronas.
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
auth-service ────► [ RabbitMQ ] ────► user-service
|
|
80
|
+
│
|
|
81
|
+
└────────► notification-service
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
**Eventos comuns:**
|
|
85
|
+
- `user.created`
|
|
86
|
+
- `user.email_verified`
|
|
87
|
+
- `password.reset_requested`
|
|
88
|
+
- `notification.sent`
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Pattern: Circuit Breaker
|
|
93
|
+
Proteção contra chamadas cascata de falhas.
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
[CLOSED] ──failure──> [OPEN]
|
|
97
|
+
▲ │
|
|
98
|
+
│ │ timeout
|
|
99
|
+
│ [HALF_OPEN]
|
|
100
|
+
└──────success─────────┘
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
**Estados:**
|
|
104
|
+
- **CLOSED**: Normal operation
|
|
105
|
+
- **OPEN**: Falhas detectadas, rejeit requests
|
|
106
|
+
- **HALF_OPEN**: Testando se serviço recuperou
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# 👁️ Vision
|
|
2
|
+
|
|
3
|
+
## Visão de Produto (2024)
|
|
4
|
+
|
|
5
|
+
### O que é
|
|
6
|
+
Plataforma de microserviços moderna que permite:
|
|
7
|
+
- ✅ Escalabilidade independente de cada domínio
|
|
8
|
+
- ✅ Deploy contínuo sem sincronização global
|
|
9
|
+
- ✅ Isolamento de falhas (um serviço fora não derruba todo sistema)
|
|
10
|
+
- ✅ Escalabilidade de desenvolvimento (times independentes)
|
|
11
|
+
|
|
12
|
+
### Target Users
|
|
13
|
+
1. **Enterprise**: Aplicações mission-critical com alto tráfego
|
|
14
|
+
2. **Startups**: Arquitetura escalável desde o início
|
|
15
|
+
3. **DevOps Engineers**: Facilidade de deploy e monitoramento
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Roadmap
|
|
20
|
+
|
|
21
|
+
### Phase 1: Foundation (Semanas 1-2)
|
|
22
|
+
- [x] Setup Docker Compose
|
|
23
|
+
- [x] Auth Service com OAuth2
|
|
24
|
+
- [x] User Service com CRUD
|
|
25
|
+
- [x] Notification Service com email mock
|
|
26
|
+
- [x] API Gateway funcional
|
|
27
|
+
- [ ] Documentação inicial completa
|
|
28
|
+
|
|
29
|
+
### Phase 2: Resilience (Semanas 3-4)
|
|
30
|
+
- [ ] Circuit breaker pattern
|
|
31
|
+
- [ ] Retry policies
|
|
32
|
+
- [ ] Health checks avançados
|
|
33
|
+
- [ ] Graceful degradation
|
|
34
|
+
- [ ] Tests (unit + integration)
|
|
35
|
+
|
|
36
|
+
### Phase 3: Observability (Semanas 5-6)
|
|
37
|
+
- [ ] Distributed tracing com OpenTelemetry
|
|
38
|
+
- [ ] ELK Stack integration
|
|
39
|
+
- [ ] Prometheus metrics
|
|
40
|
+
- [ ] Grafana dashboards
|
|
41
|
+
- [ ] Centralized logging
|
|
42
|
+
|
|
43
|
+
### Phase 4: Production (Semanas 7-8)
|
|
44
|
+
- [ ] Kubernetes deployment
|
|
45
|
+
- [ ] Service mesh (Istio optional)
|
|
46
|
+
- [ ] Multi-tenancy support
|
|
47
|
+
- [ ] Rate limiting avançado
|
|
48
|
+
- [ ] Advanced caching strategies
|
|
49
|
+
|
|
50
|
+
### Phase 5: Optimization (Ongoing)
|
|
51
|
+
- [ ] Performance tuning
|
|
52
|
+
- [ ] Database indexing optimization
|
|
53
|
+
- [ ] Message queue optimization
|
|
54
|
+
- [ ] Cost optimization
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Key Metrics
|
|
59
|
+
|
|
60
|
+
### SLAs to Achieve
|
|
61
|
+
| Service | Availability | p99 Latency | Error Rate |
|
|
62
|
+
|---------|--------------|-------------|-----------|
|
|
63
|
+
| Auth | 99.9% | 100ms | < 0.1% |
|
|
64
|
+
| User | 99.5% | 200ms | < 0.5% |
|
|
65
|
+
| Notification | 99.0% | 500ms | < 1.0% |
|
|
66
|
+
|
|
67
|
+
### Performance Targets
|
|
68
|
+
- Throughput: 1000+ requests/sec (API Gateway)
|
|
69
|
+
- Message processing: 10,000+ msgs/min (RabbitMQ)
|
|
70
|
+
- Response time: p95 < 300ms
|
|
71
|
+
- Error rate: < 1%
|
|
72
|
+
|
|
73
|
+
### Capacity Planning
|
|
74
|
+
- Auth: 10K concurrent users
|
|
75
|
+
- User Service: 100K total users
|
|
76
|
+
- Notification Queue: 1M events/day
|
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
# 🏛️ Architecture Overview
|
|
2
|
+
|
|
3
|
+
## System Architecture Diagram
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
7
|
+
│ CLIENTS │
|
|
8
|
+
│ (Web, Mobile, Desktop) │
|
|
9
|
+
└──────────────────────────────┬──────────────────────────────────┘
|
|
10
|
+
│
|
|
11
|
+
┌──────────────▼──────────────┐
|
|
12
|
+
│ API GATEWAY │
|
|
13
|
+
│ (Port 3000, NestJS) │
|
|
14
|
+
│ - Routing │
|
|
15
|
+
│ - Auth & CORS │
|
|
16
|
+
│ - Rate Limiting │
|
|
17
|
+
│ - Error Handling │
|
|
18
|
+
└───┬──────────────────┬──────┘
|
|
19
|
+
│ │
|
|
20
|
+
┌───────────┼──────────────────┼───────────┐
|
|
21
|
+
│ │ │ │
|
|
22
|
+
▼ ▼ ▼ ▼
|
|
23
|
+
┌─────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐
|
|
24
|
+
│ AUTH │ │ USER │ │NOTIF. │ │ REDIS │
|
|
25
|
+
│SERVICE │ │ SERVICE │ │ SERVICE │ │ (Cache) │
|
|
26
|
+
│:3001 │ │ :3002 │ │ :3003 │ │ (Port 6379)│
|
|
27
|
+
└────┬────┘ └────┬─────┘ └────┬─────┘ └──────────────┘
|
|
28
|
+
│ │ │
|
|
29
|
+
│ │ │
|
|
30
|
+
┌────▼────┐ ┌───▼────┐ ┌─────▼──┐
|
|
31
|
+
│PostgreSQL│ │PostgreSQL│ │RabbitMQ │
|
|
32
|
+
│ :5432 │ │ :5432 │ │ :5672 │
|
|
33
|
+
│auth_db │ │users_db │ │(Events) │
|
|
34
|
+
└──────────┘ └──────────┘ └─────────┘
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Service Mesh Communication Flows
|
|
40
|
+
|
|
41
|
+
### Synchronous (REST/HTTP)
|
|
42
|
+
```
|
|
43
|
+
Client
|
|
44
|
+
│
|
|
45
|
+
├─ POST /auth/login
|
|
46
|
+
│ └─► API Gateway
|
|
47
|
+
│ └─► Auth Service (3001)
|
|
48
|
+
│ ├─ Validate credentials
|
|
49
|
+
│ ├─ Check password (bcrypt)
|
|
50
|
+
│ └─ Return JWT token
|
|
51
|
+
│
|
|
52
|
+
└─ GET /users/:id
|
|
53
|
+
└─► API Gateway
|
|
54
|
+
└─ Check Authorization header
|
|
55
|
+
└─► User Service (3002)
|
|
56
|
+
├─ Query database
|
|
57
|
+
└─ Return user data
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Asynchronous (Message Queue)
|
|
61
|
+
```
|
|
62
|
+
Auth Service
|
|
63
|
+
│
|
|
64
|
+
└─ publish: "user.created"
|
|
65
|
+
│
|
|
66
|
+
├─► RabbitMQ
|
|
67
|
+
│ ├─ Persist event
|
|
68
|
+
│ └─ Fan-out to consumers
|
|
69
|
+
│
|
|
70
|
+
├─► User Service consumes
|
|
71
|
+
│ └─ Create user profile
|
|
72
|
+
│
|
|
73
|
+
└─► Notification Service consumes
|
|
74
|
+
└─ Send welcome email
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Deployment Topology
|
|
80
|
+
|
|
81
|
+
### Local Development (Docker Compose)
|
|
82
|
+
```yaml
|
|
83
|
+
Services:
|
|
84
|
+
- api-gateway:3000 (NestJS)
|
|
85
|
+
- auth-service:3001 (NestJS + PostgreSQL:5432)
|
|
86
|
+
- user-service:3002 (NestJS + PostgreSQL:5432)
|
|
87
|
+
- notification-svc:3003 (NestJS)
|
|
88
|
+
- rabbitmq:5672 (Message Queue)
|
|
89
|
+
- redis:6379 (Cache)
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Production (Kubernetes Ready)
|
|
93
|
+
```
|
|
94
|
+
┌─────────────────────────────────────────────┐
|
|
95
|
+
│ Kubernetes Cluster │
|
|
96
|
+
├─────────────────────────────────────────────┤
|
|
97
|
+
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|
98
|
+
│ │ Auth Pod │ │ User Pod │ │ Notif Po │ │
|
|
99
|
+
│ │ x2 │ │ x2 │ │ x1 │ │
|
|
100
|
+
│ └──────────┘ └──────────┘ └──────────┘ │
|
|
101
|
+
│ │ │ │ │
|
|
102
|
+
│ ┌────▼──┐ ┌───▼────┐ ┌───▼────┐ │
|
|
103
|
+
│ │PG Pod │ │PG Pod │ │(None) │ │
|
|
104
|
+
│ └───────┘ └────────┘ └────────┘ │
|
|
105
|
+
│ │
|
|
106
|
+
│ ┌──────────────┐ ┌──────────┐ │
|
|
107
|
+
│ │ RabbitMQ Pod │ │ Redis Pod│ │
|
|
108
|
+
│ │ │ │ │ │
|
|
109
|
+
│ └──────────────┘ └──────────┘ │
|
|
110
|
+
│ │
|
|
111
|
+
│ ┌──────────────────────────────┐ │
|
|
112
|
+
│ │ API Gateway (Ingress) │ │
|
|
113
|
+
│ │ - Load Balancer │ │
|
|
114
|
+
│ │ - SSL Termination │ │
|
|
115
|
+
│ └──────────────────────────────┘ │
|
|
116
|
+
└─────────────────────────────────────────────┘
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Data Architecture
|
|
122
|
+
|
|
123
|
+
### Per-Service Database
|
|
124
|
+
```
|
|
125
|
+
auth-service:
|
|
126
|
+
└─ auth_db (PostgreSQL)
|
|
127
|
+
└─ users (email, password_hash, created_at)
|
|
128
|
+
└─ refresh_tokens (token, expires_at)
|
|
129
|
+
└─ sessions (user_id, device_info, created_at)
|
|
130
|
+
|
|
131
|
+
user-service:
|
|
132
|
+
└─ users_db (PostgreSQL)
|
|
133
|
+
└─ user_profiles (user_id, name, avatar_url, bio)
|
|
134
|
+
└─ user_settings (user_id, theme, notifications_enabled)
|
|
135
|
+
└─ email_verifications (user_id, code, verified_at)
|
|
136
|
+
|
|
137
|
+
notification-service:
|
|
138
|
+
└─ No persistent database
|
|
139
|
+
└─ Stateless (events from RabbitMQ)
|
|
140
|
+
└─ Uses Redis for: pending email queue, retry counts
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### Caching Strategy
|
|
144
|
+
```
|
|
145
|
+
Redis (Port 6379):
|
|
146
|
+
- Session tokens (TTL: 24h)
|
|
147
|
+
- User profiles (TTL: 1h)
|
|
148
|
+
- Auth tokens blacklist (TTL: expiration time)
|
|
149
|
+
- Rate limiting counters (TTL: 1m)
|
|
150
|
+
- Message deduplication IDs (TTL: 1h)
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Event Bus (RabbitMQ)
|
|
154
|
+
```
|
|
155
|
+
Exchanges:
|
|
156
|
+
- user.events (Fanout) - User lifecycle events
|
|
157
|
+
- auth.events (Fanout) - Auth events
|
|
158
|
+
- system.events (Topic) - System-wide events
|
|
159
|
+
|
|
160
|
+
Queues:
|
|
161
|
+
- user-service.user-events
|
|
162
|
+
- notification-service.user-events
|
|
163
|
+
- notification-service.auth-events
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## Security Architecture
|
|
169
|
+
|
|
170
|
+
### Authentication Flow
|
|
171
|
+
```
|
|
172
|
+
Client
|
|
173
|
+
│
|
|
174
|
+
├─ POST /auth/login (username, password)
|
|
175
|
+
│
|
|
176
|
+
├─ Auth Service validates
|
|
177
|
+
│ ├─ Username exists in database
|
|
178
|
+
│ ├─ Hash password with bcrypt
|
|
179
|
+
│ └─ Compare hashes
|
|
180
|
+
│
|
|
181
|
+
├─ Generate JWT tokens
|
|
182
|
+
│ ├─ Access token (15min expiry)
|
|
183
|
+
│ └─ Refresh token (7 days expiry)
|
|
184
|
+
│
|
|
185
|
+
├─ Store refresh token in Redis
|
|
186
|
+
│
|
|
187
|
+
└─ Return tokens to client
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### Authorization
|
|
191
|
+
```
|
|
192
|
+
Every Request:
|
|
193
|
+
│
|
|
194
|
+
├─ Extract Authorization header
|
|
195
|
+
│
|
|
196
|
+
├─ Verify JWT signature (RS256)
|
|
197
|
+
│
|
|
198
|
+
├─ Check token expiry
|
|
199
|
+
│
|
|
200
|
+
├─ Validate user permissions
|
|
201
|
+
│ ├─ From token claims
|
|
202
|
+
│ └─ From database (roles/permissions)
|
|
203
|
+
│
|
|
204
|
+
└─ Pass to downstream service
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## Observability Architecture
|
|
210
|
+
|
|
211
|
+
### Distributed Tracing
|
|
212
|
+
```
|
|
213
|
+
Request Entry (API Gateway)
|
|
214
|
+
│
|
|
215
|
+
├─ Generate X-Trace-Id
|
|
216
|
+
├─ Generate X-Span-Id
|
|
217
|
+
│
|
|
218
|
+
├─ Auth Service receives
|
|
219
|
+
│ ├─ Create span
|
|
220
|
+
│ ├─ Log operations
|
|
221
|
+
│ └─ Send to Jaeger
|
|
222
|
+
│
|
|
223
|
+
└─ User Service receives
|
|
224
|
+
├─ Create span (child of Auth span)
|
|
225
|
+
├─ Database queries
|
|
226
|
+
└─ Send to Jaeger
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
### Metrics
|
|
230
|
+
```
|
|
231
|
+
Prometheus targets:
|
|
232
|
+
- /metrics (port 9090)
|
|
233
|
+
- HTTP request latency
|
|
234
|
+
- Request count by endpoint
|
|
235
|
+
- Database query duration
|
|
236
|
+
- Message queue depth
|
|
237
|
+
- Cache hit/miss ratio
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
### Logging
|
|
241
|
+
```
|
|
242
|
+
Centralized (ELK Stack):
|
|
243
|
+
- Filebeat collects logs from each service
|
|
244
|
+
- Logstash parses and enriches
|
|
245
|
+
- Elasticsearch indexes
|
|
246
|
+
- Kibana visualizes
|
|
247
|
+
```
|