forjajs 2.0.3 → 2.0.4
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 -25
- package/.claude/agents/governance.md +55 -55
- package/.claude/agents/marketing.md +24 -24
- package/.claude/agents/orchestrator.md +31 -31
- package/.claude/agents/product.md +26 -26
- package/.claude/agents/release-auditor.md +68 -59
- package/.claude/agents/sdd-architect.md +34 -34
- package/.claude/settings.json +76 -76
- package/.claude/skills/new-adr/SKILL.md +61 -61
- package/.claude/skills/new-command/SKILL.md +67 -67
- package/.gemini-instructions.md +87 -87
- package/.github/copilot-instructions.md +87 -87
- package/.memoryrc.json +104 -104
- package/.openai-instructions.md +87 -87
- package/AGENTS.md +134 -134
- package/CHANGELOG.md +566 -550
- package/CONTRIBUTING.md +32 -32
- package/DOC-MAP.md +65 -60
- package/LICENSE +21 -21
- package/README.md +358 -339
- package/README.pt-BR.md +345 -345
- package/boilerplates/01-api-rest/README.md +336 -336
- package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
- package/boilerplates/02-saas-starter/.env.example +25 -25
- package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
- package/boilerplates/02-saas-starter/INFO.md +252 -252
- package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
- package/boilerplates/02-saas-starter/README.md +305 -305
- package/boilerplates/02-saas-starter/START-HERE.md +259 -259
- package/boilerplates/02-saas-starter/backend/package.json +87 -87
- package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
- package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
- package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
- package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
- package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
- package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
- package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
- package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
- package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
- package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
- package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
- package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
- package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
- package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
- package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
- package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
- package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
- package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
- package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
- package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
- package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
- package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
- package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
- package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
- package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
- package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
- package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
- package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
- package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
- package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
- package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
- package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
- package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
- package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
- package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
- package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
- package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
- package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
- package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
- package/boilerplates/03-ecommerce-starter/README.md +465 -465
- package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
- package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
- package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
- package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
- package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
- package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
- package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
- package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
- package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
- package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
- package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
- package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
- package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
- package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
- package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
- package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
- package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
- package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
- package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
- package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
- package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
- package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
- package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
- package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
- package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
- package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
- package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
- package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
- package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
- package/boilerplates/04-microservices-starter/.env.example +43 -43
- package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
- package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
- package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
- package/boilerplates/04-microservices-starter/INDEX.md +377 -377
- package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
- package/boilerplates/04-microservices-starter/README.md +466 -466
- package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
- package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
- package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
- package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
- package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
- package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
- package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
- package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
- package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
- package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
- package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
- package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
- package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
- package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
- package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
- package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
- package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
- package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
- package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
- package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
- package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
- package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
- package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
- package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
- package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
- package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
- package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
- package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
- package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
- package/boilerplates/04-microservices-starter/package.json +21 -21
- package/boilerplates/05-monorepo-starter/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
- package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
- package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
- package/boilerplates/05-monorepo-starter/README.md +318 -318
- package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
- package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
- package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
- package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
- package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
- package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
- package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
- package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
- package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
- package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
- package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
- package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
- package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
- package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
- package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
- package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
- package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
- package/boilerplates/05-monorepo-starter/package.json +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
- package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
- package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
- package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
- package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
- package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
- package/boilerplates/05-monorepo-starter/turbo.json +35 -35
- package/boilerplates/06-clean-arch/README.md +48 -48
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
- package/boilerplates/06-clean-arch/backend/package.json +43 -43
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
- package/boilerplates/README.md +427 -427
- package/design-md/BRIEF-TEMPLATE.md +47 -47
- package/design-md/INDEX.md +35 -35
- package/design-md/MATRIX.md +24 -24
- package/design-md/PLAYBOOK.md +35 -35
- package/design-md/examples/agent-console-brief.md +48 -48
- package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +14 -2
- package/dist/bin/init-project.js +38 -38
- package/dist/lib/audit.js +7 -7
- package/dist/lib/context-builder.js +32 -32
- package/dist/lib/core/doc-graph.js +6 -4
- package/dist/lib/core/registry.d.ts +54 -0
- package/dist/lib/core/registry.js +55 -0
- package/dist/lib/core/release.d.ts +53 -0
- package/dist/lib/core/release.js +5 -1
- package/dist/lib/generators/memory-generator.js +700 -698
- package/dist/lib/generators/nest-generator.js +398 -398
- package/dist/lib/generators/readme-generator.js +180 -180
- package/dist/lib/governance-report.js +39 -39
- package/dist/lib/project-upgrade.js +1 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +63 -34
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/scripts/agent-harness.js +66 -64
- package/dist/scripts/agent-router.js +20 -20
- package/dist/scripts/build-smart-context.js +22 -22
- package/dist/scripts/compress-memory.js +8 -8
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.js +2 -2
- package/dist/scripts/demo-workspace.d.ts +6 -0
- package/dist/scripts/demo-workspace.js +101 -0
- package/dist/scripts/dev.js +13 -13
- package/dist/scripts/extract-global-knowledge.js +5 -5
- package/dist/scripts/generate-dashboard.js +11 -11
- package/dist/scripts/llm-fit.js +131 -0
- package/dist/scripts/memory-schema.js +48 -48
- package/dist/scripts/query-universal-memory.js +13 -13
- package/dist/scripts/sprint-manager.js +39 -39
- package/dist/scripts/sync-universal-memory.js +63 -50
- package/docs/2x/CLI-CAPABILITIES.md +35 -35
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
- package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
- package/docs/agent-harnesses.md +149 -149
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
- package/docs/archive/CHECKLIST-FINAL.md +295 -295
- package/docs/archive/FASE2-SUMMARY.md +263 -263
- package/docs/archive/FASE3-PROGRESS.md +355 -355
- package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
- package/docs/archive/INDICE-MASTER.md +282 -282
- package/docs/archive/PROJETO-COMPLETO.md +363 -363
- package/docs/archive/README-REFINAMENTO.md +293 -293
- package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
- package/docs/archive/REFINAMENTO-v1.0.md +565 -565
- package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
- package/docs/archive/START-HERE.md +319 -319
- package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
- package/docs/archive/examples/v1/AGENTS.md +10 -10
- package/docs/archive/examples/v1/README.md +36 -36
- package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v1/backend/package.json +42 -42
- package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v1/backend/src/main.ts +10 -10
- package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
- package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
- package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
- package/docs/archive/examples/v2/.memoryrc.json +8 -8
- package/docs/archive/examples/v2/AGENTS.md +16 -16
- package/docs/archive/examples/v2/README.md +35 -35
- package/docs/archive/examples/v2/agents/README.md +3 -3
- package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
- package/docs/archive/examples/v2/agents/dba.md +4 -4
- package/docs/archive/examples/v2/agents/frontend.md +4 -4
- package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
- package/docs/archive/examples/v2/agents/reviewer.md +6 -6
- package/docs/archive/examples/v2/agents/security.md +4 -4
- package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
- package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
- package/docs/archive/examples/v2/backend/package.json +42 -42
- package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
- package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
- package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
- package/docs/archive/examples/v2/backend/src/main.ts +10 -10
- package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
- package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
- package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
- package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
- package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
- package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
- package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
- package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
- package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
- package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
- package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
- package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
- package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
- package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
- package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
- package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
- package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
- package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
- package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
- package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
- package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
- package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
- package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
- package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
- package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
- package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
- package/docs/archive/examples/v2/memory/README.md +8 -8
- package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
- package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
- package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
- package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
- package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
- package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
- package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
- package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
- package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
- package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
- package/docs/capacidades-externas.md +86 -86
- package/docs/cli-first-operacao.md +74 -74
- package/docs/dev-workflow.md +421 -421
- package/docs/examples.md +546 -546
- package/docs/fluxo.md +103 -103
- package/docs/glossary.md +453 -453
- package/docs/init-project.md +457 -457
- package/docs/llm-fit-loop.md +41 -0
- package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
- package/docs/modos-de-operacao.md +52 -0
- package/docs/personas/architect/README.md +333 -333
- package/docs/personas/developer/README.md +371 -371
- package/docs/personas/executive/README.md +172 -172
- package/docs/personas/qa/README.md +350 -350
- package/docs/processo-projeto.md +138 -138
- package/docs/produto/factsheet-marketing.md +151 -0
- package/docs/produto/roteiro-demo.md +47 -0
- package/docs/publishing.md +377 -377
- package/docs/quick-reference.md +409 -409
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
- package/docs/structure.md +360 -360
- package/docs/token-optimization.md +502 -502
- package/docs/vision/FORJA-2.0-VISION.md +72 -72
- package/memory/00-global/mission.md +15 -15
- package/memory/00-global/shared-knowledge.md +8 -8
- package/memory/00-global/standards.md +47 -47
- package/memory/10-product/personas.md +21 -21
- package/memory/10-product/vision.md +27 -27
- package/memory/30-projects/README.md +15 -15
- package/memory/40-delivery/backlog.md +15 -15
- package/memory/40-delivery/current-sprint.md +23 -26
- package/memory/50-orchestration/gsd-harness.md +55 -55
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
- package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
- package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
- package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
- package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
- package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
- package/memory/90-decisions/0006-docs-por-persona.md +23 -23
- package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
- package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
- package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
- package/memory/90-decisions/0010-banco-postgres.md +30 -30
- package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
- package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
- package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
- package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
- package/memory/90-decisions/0019-workspace-separado.md +45 -45
- package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
- package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
- package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
- package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
- package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
- package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
- package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
- package/memory/90-decisions/0028-governanca-visivel.md +84 -84
- package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
- package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
- package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
- package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
- package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
- package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
- package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
- package/memory/90-decisions/_template.md +28 -28
- package/package.json +157 -150
- package/prompts/context-engineer-agent.md +19 -19
- package/prompts/governance-agent.md +16 -16
- package/prompts/marketing-agent.md +13 -13
- package/prompts/orchestrator-agent.md +18 -18
- package/prompts/product-agent.md +13 -13
- package/prompts/sdd-architect-agent.md +20 -20
- package/specs/README.md +70 -70
- package/specs/_templates/plan.md +43 -43
- package/specs/_templates/spec.md +43 -43
- package/specs/_templates/tasks.md +32 -32
- package/specs/clean-arch-boilerplate/plan.md +137 -137
- package/specs/clean-arch-boilerplate/spec.md +121 -121
- package/specs/clean-arch-boilerplate/tasks.md +70 -70
- package/specs/cli-first-operacao/plan.md +53 -53
- package/specs/cli-first-operacao/spec.md +53 -53
- package/specs/cli-first-operacao/tasks.md +53 -53
- package/specs/code-context/spec.md +56 -56
- package/specs/coerencia-do-sistema/plan.md +155 -155
- package/specs/coerencia-do-sistema/spec.md +123 -123
- package/specs/coerencia-do-sistema/tasks.md +115 -115
- package/specs/dev-token-assets-db/plan.md +71 -71
- package/specs/dev-token-assets-db/spec.md +58 -58
- package/specs/dev-token-assets-db/tasks.md +58 -58
- package/specs/doctor-do-nucleo/plan.md +165 -165
- package/specs/doctor-do-nucleo/spec.md +139 -139
- package/specs/doctor-do-nucleo/tasks.md +172 -172
- package/specs/forja-core/spec.md +71 -71
- package/specs/gates/spec.md +63 -63
- package/specs/governanca-visivel/plan.md +122 -122
- package/specs/governanca-visivel/spec.md +112 -112
- package/specs/governanca-visivel/tasks.md +60 -60
- package/specs/harness-codegraph/spec.md +71 -71
- package/specs/memory-audit/spec.md +54 -54
- package/specs/orchestrate/spec.md +108 -108
- package/specs/orchestration-coherent/spec.md +95 -95
- package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
- package/specs/project-smoke/spec.md +96 -96
- package/specs/project-upgrade/spec.md +58 -58
- package/specs/reestruturacao-forja-v2/plan.md +95 -95
- package/specs/reestruturacao-forja-v2/spec.md +74 -74
- package/specs/reestruturacao-forja-v2/tasks.md +113 -113
- package/specs/release-auditor-health/plan.md +88 -0
- package/specs/release-auditor-health/spec.md +82 -0
- package/specs/release-auditor-health/tasks.md +72 -0
- package/specs/release-gate/plan.md +174 -174
- package/specs/release-gate/spec.md +122 -122
- package/specs/release-gate/tasks.md +183 -183
- package/specs/ts-migration/plan.md +200 -200
- package/specs/ts-migration/spec.md +119 -119
- package/specs/ts-migration/tasks.md +110 -110
- package/dist/scripts/server-persistence-probe.d.ts +0 -1
- package/dist/scripts/server-persistence-probe.js +0 -52
- package/dist/scripts/server-persistence-probe.mjs +0 -52
- /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
|
@@ -1,512 +1,512 @@
|
|
|
1
|
-
# 🏗️ ARCHITECTURE.md
|
|
2
|
-
|
|
3
|
-
## System Architecture
|
|
4
|
-
|
|
5
|
-
### High-Level Overview
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
┌─────────────────────────────────────────────────────────────────────┐
|
|
9
|
-
│ EXTERNAL CLIENTS │
|
|
10
|
-
│ (Web Browser, Mobile App, Desktop CLI) │
|
|
11
|
-
└──────────────────────────────────┬──────────────────────────────────┘
|
|
12
|
-
│
|
|
13
|
-
┌──────────────▼──────────────┐
|
|
14
|
-
│ API GATEWAY (Port 3000) │
|
|
15
|
-
│ ┌────────────────────────┐ │
|
|
16
|
-
│ │ - Route Dispatcher │ │
|
|
17
|
-
│ │ - CORS Enabled │ │
|
|
18
|
-
│ │ - Request Logging │ │
|
|
19
|
-
│ │ - Error Aggregation │ │
|
|
20
|
-
│ └────────────────────────┘ │
|
|
21
|
-
└────┬─────────────────┬─────┘
|
|
22
|
-
│ │
|
|
23
|
-
┌────────────────▼────┐ ┌────────▼──────────┐
|
|
24
|
-
│ AUTH SERVICE │ │ USER SERVICE │
|
|
25
|
-
│ (Port 3001) │ │ (Port 3002) │
|
|
26
|
-
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
27
|
-
│ │ Controllers │ │ │ │ Controllers ││
|
|
28
|
-
│ │ - register │ │ │ │ - getProfile ││
|
|
29
|
-
│ │ - login │ │ │ │ - updateProfile││
|
|
30
|
-
│ │ - refresh │ │ │ │ - deleteUser ││
|
|
31
|
-
│ │ - logout │ │ │ │ - listUsers ││
|
|
32
|
-
│ └─────────────────┘ │ │ └────────────────┘│
|
|
33
|
-
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
34
|
-
│ │ Services │ │ │ │ Services ││
|
|
35
|
-
│ │ - Auth Logic │ │ │ │ - Profile Mgmt ││
|
|
36
|
-
│ │ - JWT Tokens │ │ │ │ - Email Verify ││
|
|
37
|
-
│ │ - Password Hash │ │ │ │ - Settings ││
|
|
38
|
-
│ └─────────────────┘ │ │ └────────────────┘│
|
|
39
|
-
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
40
|
-
│ │ Persistence │ │ │ │ Persistence ││
|
|
41
|
-
│ │ - In-memory map │ │ │ │ - In-memory map││
|
|
42
|
-
│ │ (can be DB) │ │ │ │ (can be DB) ││
|
|
43
|
-
│ └─────────────────┘ │ │ └────────────────┘│
|
|
44
|
-
└────────┬──────────┘ └────────┬───────────┘
|
|
45
|
-
│ │
|
|
46
|
-
┌────────▼──────────┐ ┌────────▼──────────┐
|
|
47
|
-
│ PostgreSQL (Auth) │ │PostgreSQL (Users) │
|
|
48
|
-
│ Port: 5432 │ │ Port: 5433 │
|
|
49
|
-
│ DB: auth_db │ │ DB: users_db │
|
|
50
|
-
└───────────────────┘ └───────────────────┘
|
|
51
|
-
│ │
|
|
52
|
-
┌────────▼────────────────────┐
|
|
53
|
-
│ NOTIFICATION SERVICE │
|
|
54
|
-
│ (Port 3003) │
|
|
55
|
-
│ ┌──────────────────────────┐│
|
|
56
|
-
│ │ Controllers ││
|
|
57
|
-
│ │ - sendEmail ││
|
|
58
|
-
│ │ - sendPush ││
|
|
59
|
-
│ │ - getStatus ││
|
|
60
|
-
│ │ - listNotifications ││
|
|
61
|
-
│ └──────────────────────────┘│
|
|
62
|
-
│ ┌──────────────────────────┐│
|
|
63
|
-
│ │ Services ││
|
|
64
|
-
│ │ - Email Sending ││
|
|
65
|
-
│ │ - Push Notifications ││
|
|
66
|
-
│ │ - Event Consumption ││
|
|
67
|
-
│ │ - Retry Logic ││
|
|
68
|
-
│ └──────────────────────────┘│
|
|
69
|
-
└────┬──────────────┬──────────┘
|
|
70
|
-
│ │
|
|
71
|
-
┌────────▼──────┐ ┌────▼───────────┐
|
|
72
|
-
│ RabbitMQ │ │ Redis Cache │
|
|
73
|
-
│ (Port 5672) │ │ (Port 6379) │
|
|
74
|
-
│ - user.events │ │ - Sessions │
|
|
75
|
-
│ - auth.events │ │ - Token cache │
|
|
76
|
-
│ - sys.events │ │ - Rate limits │
|
|
77
|
-
└───────────────┘ └────────────────┘
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## Service Boundaries
|
|
83
|
-
|
|
84
|
-
### Auth Service (Bounded Context)
|
|
85
|
-
**Responsibility:** Authentication and authorization
|
|
86
|
-
|
|
87
|
-
- ✅ User registration & login
|
|
88
|
-
- ✅ Password hashing (bcrypt)
|
|
89
|
-
- ✅ JWT token generation
|
|
90
|
-
- ✅ Token refresh
|
|
91
|
-
- ✅ Token validation
|
|
92
|
-
- ✅ Session management
|
|
93
|
-
- ❌ User profile data
|
|
94
|
-
- ❌ Notification sending
|
|
95
|
-
|
|
96
|
-
**Database:** PostgreSQL (auth_db)
|
|
97
|
-
- Users table
|
|
98
|
-
- Refresh tokens table
|
|
99
|
-
- Sessions table
|
|
100
|
-
|
|
101
|
-
**External Dependencies:**
|
|
102
|
-
- Redis for token blacklist
|
|
103
|
-
- RabbitMQ for event publishing
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
107
|
-
### User Service (Bounded Context)
|
|
108
|
-
**Responsibility:** User profiles and settings
|
|
109
|
-
|
|
110
|
-
- ✅ User profile CRUD
|
|
111
|
-
- ✅ Profile settings management
|
|
112
|
-
- ✅ Email verification
|
|
113
|
-
- ✅ User search/listing
|
|
114
|
-
- ❌ Authentication
|
|
115
|
-
- ❌ Sending notifications directly
|
|
116
|
-
|
|
117
|
-
**Database:** PostgreSQL (users_db)
|
|
118
|
-
- User profiles table
|
|
119
|
-
- User settings table
|
|
120
|
-
- Email verification table
|
|
121
|
-
|
|
122
|
-
**External Dependencies:**
|
|
123
|
-
- Auth Service (via API Gateway)
|
|
124
|
-
- RabbitMQ for events
|
|
125
|
-
|
|
126
|
-
---
|
|
127
|
-
|
|
128
|
-
### Notification Service (Bounded Context)
|
|
129
|
-
**Responsibility:** Multi-channel notifications
|
|
130
|
-
|
|
131
|
-
- ✅ Email sending
|
|
132
|
-
- ✅ Push notifications
|
|
133
|
-
- ✅ Event-driven processing
|
|
134
|
-
- ✅ Retry logic
|
|
135
|
-
- ✅ Status tracking
|
|
136
|
-
- ❌ User authentication
|
|
137
|
-
- ❌ Storing user data
|
|
138
|
-
|
|
139
|
-
**Storage:** Redis only (no database)
|
|
140
|
-
- Notification cache
|
|
141
|
-
- Retry counters
|
|
142
|
-
- Delivery tracking
|
|
143
|
-
|
|
144
|
-
**External Dependencies:**
|
|
145
|
-
- RabbitMQ for event consumption
|
|
146
|
-
- Redis for caching
|
|
147
|
-
- Email/Push providers
|
|
148
|
-
|
|
149
|
-
---
|
|
150
|
-
|
|
151
|
-
## Communication Patterns
|
|
152
|
-
|
|
153
|
-
### Synchronous (HTTP REST)
|
|
154
|
-
|
|
155
|
-
```
|
|
156
|
-
Client
|
|
157
|
-
│
|
|
158
|
-
├─ POST /auth/login
|
|
159
|
-
│ └─► API Gateway
|
|
160
|
-
│ └─► Auth Service
|
|
161
|
-
│
|
|
162
|
-
├─ GET /users/:id
|
|
163
|
-
│ └─► API Gateway
|
|
164
|
-
│ └─► User Service
|
|
165
|
-
│
|
|
166
|
-
└─ POST /notifications/email
|
|
167
|
-
└─► API Gateway
|
|
168
|
-
└─► Notification Service
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
**Characteristics:**
|
|
172
|
-
- Request-response model
|
|
173
|
-
- Immediate feedback
|
|
174
|
-
- Timeout: 5 seconds (default)
|
|
175
|
-
- Retry: Circuit breaker protected
|
|
176
|
-
|
|
177
|
-
### Asynchronous (Message Queue)
|
|
178
|
-
|
|
179
|
-
```
|
|
180
|
-
Auth Service publishes:
|
|
181
|
-
user.registered
|
|
182
|
-
│
|
|
183
|
-
├─► User Service consumer
|
|
184
|
-
│ └─ Create profile
|
|
185
|
-
│
|
|
186
|
-
└─► Notification consumer
|
|
187
|
-
└─ Send welcome email
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
**Characteristics:**
|
|
191
|
-
- Fire-and-forget
|
|
192
|
-
- Loose coupling
|
|
193
|
-
- Guaranteed delivery
|
|
194
|
-
- Retry on failure
|
|
195
|
-
- Event ordering per stream
|
|
196
|
-
|
|
197
|
-
---
|
|
198
|
-
|
|
199
|
-
## Data Architecture
|
|
200
|
-
|
|
201
|
-
### Database Per Service
|
|
202
|
-
|
|
203
|
-
```
|
|
204
|
-
Auth DB (auth_db):
|
|
205
|
-
├── users
|
|
206
|
-
│ ├─ id (PK)
|
|
207
|
-
│ ├─ email (UNIQUE)
|
|
208
|
-
│ ├─ password_hash (bcrypt)
|
|
209
|
-
│ ├─ status (active/disabled)
|
|
210
|
-
│ └─ created_at, updated_at
|
|
211
|
-
│
|
|
212
|
-
└── refresh_tokens
|
|
213
|
-
├─ id (PK)
|
|
214
|
-
├─ user_id (FK)
|
|
215
|
-
├─ token
|
|
216
|
-
├─ expires_at
|
|
217
|
-
└─ device_id (optional)
|
|
218
|
-
|
|
219
|
-
User DB (users_db):
|
|
220
|
-
├── user_profiles
|
|
221
|
-
│ ├─ user_id (PK, FK → auth_db)
|
|
222
|
-
│ ├─ email
|
|
223
|
-
│ ├─ full_name
|
|
224
|
-
│ ├─ avatar_url
|
|
225
|
-
│ ├─ bio
|
|
226
|
-
│ ├─ email_verified
|
|
227
|
-
│ └─ created_at, updated_at
|
|
228
|
-
│
|
|
229
|
-
└── user_settings
|
|
230
|
-
├─ user_id (PK, FK)
|
|
231
|
-
├─ theme
|
|
232
|
-
├─ notifications_enabled
|
|
233
|
-
├─ language
|
|
234
|
-
└─ timezone
|
|
235
|
-
|
|
236
|
-
Notification Service (Redis):
|
|
237
|
-
└── (Stateless - reads from RabbitMQ events)
|
|
238
|
-
├─ notification:{id} → JSON
|
|
239
|
-
├─ notification:pending → Queue
|
|
240
|
-
└─ notification:retry_count → Counter
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
**Rationale:**
|
|
244
|
-
- Independent scaling
|
|
245
|
-
- Technology flexibility
|
|
246
|
-
- Deployment isolation
|
|
247
|
-
- Eventual consistency
|
|
248
|
-
|
|
249
|
-
### Caching Strategy
|
|
250
|
-
|
|
251
|
-
```
|
|
252
|
-
Redis:
|
|
253
|
-
├── sessions:{sessionId} (TTL: 24h)
|
|
254
|
-
├── user_profile:{userId} (TTL: 1h)
|
|
255
|
-
├── auth_token_blacklist: (TTL: token expiry)
|
|
256
|
-
├── rate_limit:{ip} (TTL: 1m)
|
|
257
|
-
└── notification:pending (TTL: varies)
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
---
|
|
261
|
-
|
|
262
|
-
## Request Flow Example
|
|
263
|
-
|
|
264
|
-
### Example: User Login & Profile Update
|
|
265
|
-
|
|
266
|
-
```
|
|
267
|
-
1. Client POST /auth/login
|
|
268
|
-
│
|
|
269
|
-
├─► API Gateway receives request
|
|
270
|
-
│ ├─ Generate request ID
|
|
271
|
-
│ ├─ Extract headers
|
|
272
|
-
│ └─ Route to /auth/login
|
|
273
|
-
│
|
|
274
|
-
├─► Auth Service:
|
|
275
|
-
│ ├─ Validate email/password
|
|
276
|
-
│ ├─ Hash comparison
|
|
277
|
-
│ ├─ Generate JWT tokens
|
|
278
|
-
│ ├─ Store refresh token in Redis
|
|
279
|
-
│ └─ Return tokens
|
|
280
|
-
│
|
|
281
|
-
├─► API Gateway aggregates response
|
|
282
|
-
│ └─ Return to client
|
|
283
|
-
│
|
|
284
|
-
├─ Client stores tokens
|
|
285
|
-
│
|
|
286
|
-
└─► Client GET /users/:userId
|
|
287
|
-
├─► API Gateway
|
|
288
|
-
│ ├─ Extract authorization header
|
|
289
|
-
│ ├─ Pass JWT to User Service
|
|
290
|
-
│ │
|
|
291
|
-
│ ├─► User Service:
|
|
292
|
-
│ │ ├─ Verify JWT (via Auth Service or JWT library)
|
|
293
|
-
│ │ ├─ Query user_profiles table
|
|
294
|
-
│ │ ├─ Check Redis cache
|
|
295
|
-
│ │ └─ Return profile
|
|
296
|
-
│ │
|
|
297
|
-
│ └─ Aggregate response
|
|
298
|
-
│
|
|
299
|
-
└─ Return profile to client
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
---
|
|
303
|
-
|
|
304
|
-
## Error Handling Architecture
|
|
305
|
-
|
|
306
|
-
### Error Response Flow
|
|
307
|
-
|
|
308
|
-
```
|
|
309
|
-
Service receives invalid request
|
|
310
|
-
│
|
|
311
|
-
├─ Validate input
|
|
312
|
-
│
|
|
313
|
-
├─ If invalid:
|
|
314
|
-
│ ├─ Return 400 Bad Request
|
|
315
|
-
│ └─ Include error code & message
|
|
316
|
-
│
|
|
317
|
-
├─ Check authorization
|
|
318
|
-
│ ├─ If unauthorized:
|
|
319
|
-
│ │ ├─ Return 401/403
|
|
320
|
-
│ │ └─ Include error details
|
|
321
|
-
│
|
|
322
|
-
├─ Call downstream service
|
|
323
|
-
│ ├─ If service unavailable:
|
|
324
|
-
│ │ ├─ Circuit breaker opens
|
|
325
|
-
│ │ ├─ Return 503 Service Unavailable
|
|
326
|
-
│ │ └─ Retry after timeout
|
|
327
|
-
│
|
|
328
|
-
└─ If server error:
|
|
329
|
-
├─ Log error
|
|
330
|
-
├─ Return 500
|
|
331
|
-
└─ Include request ID for tracking
|
|
332
|
-
```
|
|
333
|
-
|
|
334
|
-
### Error Codes
|
|
335
|
-
|
|
336
|
-
```
|
|
337
|
-
Authentication:
|
|
338
|
-
- INVALID_CREDENTIALS (401)
|
|
339
|
-
- INVALID_TOKEN (401)
|
|
340
|
-
- EMAIL_ALREADY_EXISTS (409)
|
|
341
|
-
|
|
342
|
-
Authorization:
|
|
343
|
-
- UNAUTHORIZED_UPDATE (403)
|
|
344
|
-
- INSUFFICIENT_PERMISSIONS (403)
|
|
345
|
-
|
|
346
|
-
Resource:
|
|
347
|
-
- USER_NOT_FOUND (404)
|
|
348
|
-
- NOTIFICATION_NOT_FOUND (404)
|
|
349
|
-
|
|
350
|
-
Validation:
|
|
351
|
-
- INVALID_EMAIL (400)
|
|
352
|
-
- INVALID_PASSWORD (400)
|
|
353
|
-
|
|
354
|
-
Rate Limiting:
|
|
355
|
-
- TOO_MANY_ATTEMPTS (429)
|
|
356
|
-
- RATE_LIMIT_EXCEEDED (429)
|
|
357
|
-
|
|
358
|
-
Server:
|
|
359
|
-
- SERVICE_UNAVAILABLE (503)
|
|
360
|
-
- INTERNAL_ERROR (500)
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
---
|
|
364
|
-
|
|
365
|
-
## Scalability Considerations
|
|
366
|
-
|
|
367
|
-
### Horizontal Scaling
|
|
368
|
-
|
|
369
|
-
```
|
|
370
|
-
Production Setup:
|
|
371
|
-
┌──────────────────────────────────┐
|
|
372
|
-
│ Load Balancer │
|
|
373
|
-
└────┬──────────────────────────┬──┘
|
|
374
|
-
│ │
|
|
375
|
-
┌────▼──────────┐ ┌────────▼────┐
|
|
376
|
-
│ API GW (pod1) │ │ API GW (pod2)│
|
|
377
|
-
└────┬─────┬────┘ └────┬─────┬───┘
|
|
378
|
-
│ │ │ │
|
|
379
|
-
┌──▼──┐ ┌──▼──┐ ┌─────▼─┐ ┌───▼──┐
|
|
380
|
-
│Auth1│ │Auth2│ ... │User1 │ │User2 │ ...
|
|
381
|
-
└─────┘ └─────┘ └───────┘ └──────┘
|
|
382
|
-
```
|
|
383
|
-
|
|
384
|
-
**Scaling Rules:**
|
|
385
|
-
- API Gateway: 1-3 replicas
|
|
386
|
-
- Auth Service: 1-2 replicas
|
|
387
|
-
- User Service: 1-2 replicas
|
|
388
|
-
- Notification Service: 1 replica (or N for throughput)
|
|
389
|
-
|
|
390
|
-
**Database Scaling:**
|
|
391
|
-
- Read replicas for User DB
|
|
392
|
-
- Connection pooling (PgBouncer)
|
|
393
|
-
- Vertical scaling for Auth DB
|
|
394
|
-
|
|
395
|
-
**Message Queue:**
|
|
396
|
-
- RabbitMQ in cluster mode
|
|
397
|
-
- Multiple consumer instances
|
|
398
|
-
|
|
399
|
-
---
|
|
400
|
-
|
|
401
|
-
## Deployment Topology
|
|
402
|
-
|
|
403
|
-
### Local Development
|
|
404
|
-
```
|
|
405
|
-
Docker Compose:
|
|
406
|
-
- Single Docker network
|
|
407
|
-
- All services connected
|
|
408
|
-
- Shared databases
|
|
409
|
-
- Health checks enabled
|
|
410
|
-
```
|
|
411
|
-
|
|
412
|
-
### Production (Kubernetes)
|
|
413
|
-
```
|
|
414
|
-
Namespace: microservices
|
|
415
|
-
├── api-gateway deployment (1-3 replicas)
|
|
416
|
-
├── auth-service statefulset (1-3 replicas)
|
|
417
|
-
├── user-service statefulset (1-3 replicas)
|
|
418
|
-
├── notification-service deployment (1-N replicas)
|
|
419
|
-
├── postgres-auth statefulset
|
|
420
|
-
├── postgres-user statefulset
|
|
421
|
-
├── rabbitmq statefulset (cluster)
|
|
422
|
-
└── redis deployment (with persistence)
|
|
423
|
-
```
|
|
424
|
-
|
|
425
|
-
---
|
|
426
|
-
|
|
427
|
-
## Monitoring & Observability
|
|
428
|
-
|
|
429
|
-
### Logging
|
|
430
|
-
```
|
|
431
|
-
Each service logs:
|
|
432
|
-
- Request entry/exit
|
|
433
|
-
- Service calls
|
|
434
|
-
- Database queries
|
|
435
|
-
- Errors with stack traces
|
|
436
|
-
- Performance metrics
|
|
437
|
-
|
|
438
|
-
Format: JSON for easy parsing
|
|
439
|
-
{"timestamp": "...", "level": "INFO", "service": "auth-service", ...}
|
|
440
|
-
```
|
|
441
|
-
|
|
442
|
-
### Tracing
|
|
443
|
-
```
|
|
444
|
-
X-Trace-Id: Generated at API Gateway
|
|
445
|
-
X-Span-Id: Generated per service
|
|
446
|
-
X-Parent-Span-Id: Propagated through calls
|
|
447
|
-
|
|
448
|
-
Example flow:
|
|
449
|
-
API Gateway → Auth Service
|
|
450
|
-
X-Trace-Id: trace-001
|
|
451
|
-
├─ X-Span-Id: span-gateway-001
|
|
452
|
-
└─ X-Span-Id: span-auth-001 (parent: span-gateway-001)
|
|
453
|
-
```
|
|
454
|
-
|
|
455
|
-
### Metrics
|
|
456
|
-
```
|
|
457
|
-
Prometheus targets:
|
|
458
|
-
- HTTP request count
|
|
459
|
-
- HTTP request duration
|
|
460
|
-
- Database query duration
|
|
461
|
-
- Message queue depth
|
|
462
|
-
- Cache hit/miss ratio
|
|
463
|
-
```
|
|
464
|
-
|
|
465
|
-
---
|
|
466
|
-
|
|
467
|
-
## Security Architecture
|
|
468
|
-
|
|
469
|
-
### Authentication & Authorization
|
|
470
|
-
```
|
|
471
|
-
1. Client sends credentials → Auth Service
|
|
472
|
-
2. Auth Service validates → Issues JWT
|
|
473
|
-
3. JWT stored in headers (Authorization: Bearer ...)
|
|
474
|
-
4. API Gateway verifies JWT signature
|
|
475
|
-
5. Each service validates token expiry
|
|
476
|
-
|
|
477
|
-
Token Structure:
|
|
478
|
-
{
|
|
479
|
-
"userId": "...",
|
|
480
|
-
"email": "...",
|
|
481
|
-
"iat": 1234567890,
|
|
482
|
-
"exp": 1234568790,
|
|
483
|
-
"type": "access"
|
|
484
|
-
}
|
|
485
|
-
```
|
|
486
|
-
|
|
487
|
-
### Data Protection
|
|
488
|
-
```
|
|
489
|
-
- Passwords: bcrypt (cost: 12)
|
|
490
|
-
- In-transit: HTTPS (TLS 1.3)
|
|
491
|
-
- Tokens: JWT with RS256 signature
|
|
492
|
-
- Sensitive data: Encrypted at rest
|
|
493
|
-
```
|
|
494
|
-
|
|
495
|
-
### Network Security
|
|
496
|
-
```
|
|
497
|
-
- Services isolated to private network
|
|
498
|
-
- API Gateway only public endpoint
|
|
499
|
-
- Rate limiting per IP/user
|
|
500
|
-
- Request validation on all endpoints
|
|
501
|
-
```
|
|
502
|
-
|
|
503
|
-
---
|
|
504
|
-
|
|
505
|
-
## Conclusion
|
|
506
|
-
|
|
507
|
-
This architecture provides:
|
|
508
|
-
- **Scalability**: Services scale independently
|
|
509
|
-
- **Resilience**: Failures isolated per service
|
|
510
|
-
- **Flexibility**: Different tech stacks per service
|
|
511
|
-
- **Maintainability**: Clear service boundaries
|
|
512
|
-
- **Observability**: Tracing and logging built-in
|
|
1
|
+
# 🏗️ ARCHITECTURE.md
|
|
2
|
+
|
|
3
|
+
## System Architecture
|
|
4
|
+
|
|
5
|
+
### High-Level Overview
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
┌─────────────────────────────────────────────────────────────────────┐
|
|
9
|
+
│ EXTERNAL CLIENTS │
|
|
10
|
+
│ (Web Browser, Mobile App, Desktop CLI) │
|
|
11
|
+
└──────────────────────────────────┬──────────────────────────────────┘
|
|
12
|
+
│
|
|
13
|
+
┌──────────────▼──────────────┐
|
|
14
|
+
│ API GATEWAY (Port 3000) │
|
|
15
|
+
│ ┌────────────────────────┐ │
|
|
16
|
+
│ │ - Route Dispatcher │ │
|
|
17
|
+
│ │ - CORS Enabled │ │
|
|
18
|
+
│ │ - Request Logging │ │
|
|
19
|
+
│ │ - Error Aggregation │ │
|
|
20
|
+
│ └────────────────────────┘ │
|
|
21
|
+
└────┬─────────────────┬─────┘
|
|
22
|
+
│ │
|
|
23
|
+
┌────────────────▼────┐ ┌────────▼──────────┐
|
|
24
|
+
│ AUTH SERVICE │ │ USER SERVICE │
|
|
25
|
+
│ (Port 3001) │ │ (Port 3002) │
|
|
26
|
+
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
27
|
+
│ │ Controllers │ │ │ │ Controllers ││
|
|
28
|
+
│ │ - register │ │ │ │ - getProfile ││
|
|
29
|
+
│ │ - login │ │ │ │ - updateProfile││
|
|
30
|
+
│ │ - refresh │ │ │ │ - deleteUser ││
|
|
31
|
+
│ │ - logout │ │ │ │ - listUsers ││
|
|
32
|
+
│ └─────────────────┘ │ │ └────────────────┘│
|
|
33
|
+
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
34
|
+
│ │ Services │ │ │ │ Services ││
|
|
35
|
+
│ │ - Auth Logic │ │ │ │ - Profile Mgmt ││
|
|
36
|
+
│ │ - JWT Tokens │ │ │ │ - Email Verify ││
|
|
37
|
+
│ │ - Password Hash │ │ │ │ - Settings ││
|
|
38
|
+
│ └─────────────────┘ │ │ └────────────────┘│
|
|
39
|
+
│ ┌─────────────────┐ │ │ ┌────────────────┐│
|
|
40
|
+
│ │ Persistence │ │ │ │ Persistence ││
|
|
41
|
+
│ │ - In-memory map │ │ │ │ - In-memory map││
|
|
42
|
+
│ │ (can be DB) │ │ │ │ (can be DB) ││
|
|
43
|
+
│ └─────────────────┘ │ │ └────────────────┘│
|
|
44
|
+
└────────┬──────────┘ └────────┬───────────┘
|
|
45
|
+
│ │
|
|
46
|
+
┌────────▼──────────┐ ┌────────▼──────────┐
|
|
47
|
+
│ PostgreSQL (Auth) │ │PostgreSQL (Users) │
|
|
48
|
+
│ Port: 5432 │ │ Port: 5433 │
|
|
49
|
+
│ DB: auth_db │ │ DB: users_db │
|
|
50
|
+
└───────────────────┘ └───────────────────┘
|
|
51
|
+
│ │
|
|
52
|
+
┌────────▼────────────────────┐
|
|
53
|
+
│ NOTIFICATION SERVICE │
|
|
54
|
+
│ (Port 3003) │
|
|
55
|
+
│ ┌──────────────────────────┐│
|
|
56
|
+
│ │ Controllers ││
|
|
57
|
+
│ │ - sendEmail ││
|
|
58
|
+
│ │ - sendPush ││
|
|
59
|
+
│ │ - getStatus ││
|
|
60
|
+
│ │ - listNotifications ││
|
|
61
|
+
│ └──────────────────────────┘│
|
|
62
|
+
│ ┌──────────────────────────┐│
|
|
63
|
+
│ │ Services ││
|
|
64
|
+
│ │ - Email Sending ││
|
|
65
|
+
│ │ - Push Notifications ││
|
|
66
|
+
│ │ - Event Consumption ││
|
|
67
|
+
│ │ - Retry Logic ││
|
|
68
|
+
│ └──────────────────────────┘│
|
|
69
|
+
└────┬──────────────┬──────────┘
|
|
70
|
+
│ │
|
|
71
|
+
┌────────▼──────┐ ┌────▼───────────┐
|
|
72
|
+
│ RabbitMQ │ │ Redis Cache │
|
|
73
|
+
│ (Port 5672) │ │ (Port 6379) │
|
|
74
|
+
│ - user.events │ │ - Sessions │
|
|
75
|
+
│ - auth.events │ │ - Token cache │
|
|
76
|
+
│ - sys.events │ │ - Rate limits │
|
|
77
|
+
└───────────────┘ └────────────────┘
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Service Boundaries
|
|
83
|
+
|
|
84
|
+
### Auth Service (Bounded Context)
|
|
85
|
+
**Responsibility:** Authentication and authorization
|
|
86
|
+
|
|
87
|
+
- ✅ User registration & login
|
|
88
|
+
- ✅ Password hashing (bcrypt)
|
|
89
|
+
- ✅ JWT token generation
|
|
90
|
+
- ✅ Token refresh
|
|
91
|
+
- ✅ Token validation
|
|
92
|
+
- ✅ Session management
|
|
93
|
+
- ❌ User profile data
|
|
94
|
+
- ❌ Notification sending
|
|
95
|
+
|
|
96
|
+
**Database:** PostgreSQL (auth_db)
|
|
97
|
+
- Users table
|
|
98
|
+
- Refresh tokens table
|
|
99
|
+
- Sessions table
|
|
100
|
+
|
|
101
|
+
**External Dependencies:**
|
|
102
|
+
- Redis for token blacklist
|
|
103
|
+
- RabbitMQ for event publishing
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
### User Service (Bounded Context)
|
|
108
|
+
**Responsibility:** User profiles and settings
|
|
109
|
+
|
|
110
|
+
- ✅ User profile CRUD
|
|
111
|
+
- ✅ Profile settings management
|
|
112
|
+
- ✅ Email verification
|
|
113
|
+
- ✅ User search/listing
|
|
114
|
+
- ❌ Authentication
|
|
115
|
+
- ❌ Sending notifications directly
|
|
116
|
+
|
|
117
|
+
**Database:** PostgreSQL (users_db)
|
|
118
|
+
- User profiles table
|
|
119
|
+
- User settings table
|
|
120
|
+
- Email verification table
|
|
121
|
+
|
|
122
|
+
**External Dependencies:**
|
|
123
|
+
- Auth Service (via API Gateway)
|
|
124
|
+
- RabbitMQ for events
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
### Notification Service (Bounded Context)
|
|
129
|
+
**Responsibility:** Multi-channel notifications
|
|
130
|
+
|
|
131
|
+
- ✅ Email sending
|
|
132
|
+
- ✅ Push notifications
|
|
133
|
+
- ✅ Event-driven processing
|
|
134
|
+
- ✅ Retry logic
|
|
135
|
+
- ✅ Status tracking
|
|
136
|
+
- ❌ User authentication
|
|
137
|
+
- ❌ Storing user data
|
|
138
|
+
|
|
139
|
+
**Storage:** Redis only (no database)
|
|
140
|
+
- Notification cache
|
|
141
|
+
- Retry counters
|
|
142
|
+
- Delivery tracking
|
|
143
|
+
|
|
144
|
+
**External Dependencies:**
|
|
145
|
+
- RabbitMQ for event consumption
|
|
146
|
+
- Redis for caching
|
|
147
|
+
- Email/Push providers
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## Communication Patterns
|
|
152
|
+
|
|
153
|
+
### Synchronous (HTTP REST)
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
Client
|
|
157
|
+
│
|
|
158
|
+
├─ POST /auth/login
|
|
159
|
+
│ └─► API Gateway
|
|
160
|
+
│ └─► Auth Service
|
|
161
|
+
│
|
|
162
|
+
├─ GET /users/:id
|
|
163
|
+
│ └─► API Gateway
|
|
164
|
+
│ └─► User Service
|
|
165
|
+
│
|
|
166
|
+
└─ POST /notifications/email
|
|
167
|
+
└─► API Gateway
|
|
168
|
+
└─► Notification Service
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
**Characteristics:**
|
|
172
|
+
- Request-response model
|
|
173
|
+
- Immediate feedback
|
|
174
|
+
- Timeout: 5 seconds (default)
|
|
175
|
+
- Retry: Circuit breaker protected
|
|
176
|
+
|
|
177
|
+
### Asynchronous (Message Queue)
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
Auth Service publishes:
|
|
181
|
+
user.registered
|
|
182
|
+
│
|
|
183
|
+
├─► User Service consumer
|
|
184
|
+
│ └─ Create profile
|
|
185
|
+
│
|
|
186
|
+
└─► Notification consumer
|
|
187
|
+
└─ Send welcome email
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
**Characteristics:**
|
|
191
|
+
- Fire-and-forget
|
|
192
|
+
- Loose coupling
|
|
193
|
+
- Guaranteed delivery
|
|
194
|
+
- Retry on failure
|
|
195
|
+
- Event ordering per stream
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## Data Architecture
|
|
200
|
+
|
|
201
|
+
### Database Per Service
|
|
202
|
+
|
|
203
|
+
```
|
|
204
|
+
Auth DB (auth_db):
|
|
205
|
+
├── users
|
|
206
|
+
│ ├─ id (PK)
|
|
207
|
+
│ ├─ email (UNIQUE)
|
|
208
|
+
│ ├─ password_hash (bcrypt)
|
|
209
|
+
│ ├─ status (active/disabled)
|
|
210
|
+
│ └─ created_at, updated_at
|
|
211
|
+
│
|
|
212
|
+
└── refresh_tokens
|
|
213
|
+
├─ id (PK)
|
|
214
|
+
├─ user_id (FK)
|
|
215
|
+
├─ token
|
|
216
|
+
├─ expires_at
|
|
217
|
+
└─ device_id (optional)
|
|
218
|
+
|
|
219
|
+
User DB (users_db):
|
|
220
|
+
├── user_profiles
|
|
221
|
+
│ ├─ user_id (PK, FK → auth_db)
|
|
222
|
+
│ ├─ email
|
|
223
|
+
│ ├─ full_name
|
|
224
|
+
│ ├─ avatar_url
|
|
225
|
+
│ ├─ bio
|
|
226
|
+
│ ├─ email_verified
|
|
227
|
+
│ └─ created_at, updated_at
|
|
228
|
+
│
|
|
229
|
+
└── user_settings
|
|
230
|
+
├─ user_id (PK, FK)
|
|
231
|
+
├─ theme
|
|
232
|
+
├─ notifications_enabled
|
|
233
|
+
├─ language
|
|
234
|
+
└─ timezone
|
|
235
|
+
|
|
236
|
+
Notification Service (Redis):
|
|
237
|
+
└── (Stateless - reads from RabbitMQ events)
|
|
238
|
+
├─ notification:{id} → JSON
|
|
239
|
+
├─ notification:pending → Queue
|
|
240
|
+
└─ notification:retry_count → Counter
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
**Rationale:**
|
|
244
|
+
- Independent scaling
|
|
245
|
+
- Technology flexibility
|
|
246
|
+
- Deployment isolation
|
|
247
|
+
- Eventual consistency
|
|
248
|
+
|
|
249
|
+
### Caching Strategy
|
|
250
|
+
|
|
251
|
+
```
|
|
252
|
+
Redis:
|
|
253
|
+
├── sessions:{sessionId} (TTL: 24h)
|
|
254
|
+
├── user_profile:{userId} (TTL: 1h)
|
|
255
|
+
├── auth_token_blacklist: (TTL: token expiry)
|
|
256
|
+
├── rate_limit:{ip} (TTL: 1m)
|
|
257
|
+
└── notification:pending (TTL: varies)
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
262
|
+
## Request Flow Example
|
|
263
|
+
|
|
264
|
+
### Example: User Login & Profile Update
|
|
265
|
+
|
|
266
|
+
```
|
|
267
|
+
1. Client POST /auth/login
|
|
268
|
+
│
|
|
269
|
+
├─► API Gateway receives request
|
|
270
|
+
│ ├─ Generate request ID
|
|
271
|
+
│ ├─ Extract headers
|
|
272
|
+
│ └─ Route to /auth/login
|
|
273
|
+
│
|
|
274
|
+
├─► Auth Service:
|
|
275
|
+
│ ├─ Validate email/password
|
|
276
|
+
│ ├─ Hash comparison
|
|
277
|
+
│ ├─ Generate JWT tokens
|
|
278
|
+
│ ├─ Store refresh token in Redis
|
|
279
|
+
│ └─ Return tokens
|
|
280
|
+
│
|
|
281
|
+
├─► API Gateway aggregates response
|
|
282
|
+
│ └─ Return to client
|
|
283
|
+
│
|
|
284
|
+
├─ Client stores tokens
|
|
285
|
+
│
|
|
286
|
+
└─► Client GET /users/:userId
|
|
287
|
+
├─► API Gateway
|
|
288
|
+
│ ├─ Extract authorization header
|
|
289
|
+
│ ├─ Pass JWT to User Service
|
|
290
|
+
│ │
|
|
291
|
+
│ ├─► User Service:
|
|
292
|
+
│ │ ├─ Verify JWT (via Auth Service or JWT library)
|
|
293
|
+
│ │ ├─ Query user_profiles table
|
|
294
|
+
│ │ ├─ Check Redis cache
|
|
295
|
+
│ │ └─ Return profile
|
|
296
|
+
│ │
|
|
297
|
+
│ └─ Aggregate response
|
|
298
|
+
│
|
|
299
|
+
└─ Return profile to client
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
---
|
|
303
|
+
|
|
304
|
+
## Error Handling Architecture
|
|
305
|
+
|
|
306
|
+
### Error Response Flow
|
|
307
|
+
|
|
308
|
+
```
|
|
309
|
+
Service receives invalid request
|
|
310
|
+
│
|
|
311
|
+
├─ Validate input
|
|
312
|
+
│
|
|
313
|
+
├─ If invalid:
|
|
314
|
+
│ ├─ Return 400 Bad Request
|
|
315
|
+
│ └─ Include error code & message
|
|
316
|
+
│
|
|
317
|
+
├─ Check authorization
|
|
318
|
+
│ ├─ If unauthorized:
|
|
319
|
+
│ │ ├─ Return 401/403
|
|
320
|
+
│ │ └─ Include error details
|
|
321
|
+
│
|
|
322
|
+
├─ Call downstream service
|
|
323
|
+
│ ├─ If service unavailable:
|
|
324
|
+
│ │ ├─ Circuit breaker opens
|
|
325
|
+
│ │ ├─ Return 503 Service Unavailable
|
|
326
|
+
│ │ └─ Retry after timeout
|
|
327
|
+
│
|
|
328
|
+
└─ If server error:
|
|
329
|
+
├─ Log error
|
|
330
|
+
├─ Return 500
|
|
331
|
+
└─ Include request ID for tracking
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
### Error Codes
|
|
335
|
+
|
|
336
|
+
```
|
|
337
|
+
Authentication:
|
|
338
|
+
- INVALID_CREDENTIALS (401)
|
|
339
|
+
- INVALID_TOKEN (401)
|
|
340
|
+
- EMAIL_ALREADY_EXISTS (409)
|
|
341
|
+
|
|
342
|
+
Authorization:
|
|
343
|
+
- UNAUTHORIZED_UPDATE (403)
|
|
344
|
+
- INSUFFICIENT_PERMISSIONS (403)
|
|
345
|
+
|
|
346
|
+
Resource:
|
|
347
|
+
- USER_NOT_FOUND (404)
|
|
348
|
+
- NOTIFICATION_NOT_FOUND (404)
|
|
349
|
+
|
|
350
|
+
Validation:
|
|
351
|
+
- INVALID_EMAIL (400)
|
|
352
|
+
- INVALID_PASSWORD (400)
|
|
353
|
+
|
|
354
|
+
Rate Limiting:
|
|
355
|
+
- TOO_MANY_ATTEMPTS (429)
|
|
356
|
+
- RATE_LIMIT_EXCEEDED (429)
|
|
357
|
+
|
|
358
|
+
Server:
|
|
359
|
+
- SERVICE_UNAVAILABLE (503)
|
|
360
|
+
- INTERNAL_ERROR (500)
|
|
361
|
+
```
|
|
362
|
+
|
|
363
|
+
---
|
|
364
|
+
|
|
365
|
+
## Scalability Considerations
|
|
366
|
+
|
|
367
|
+
### Horizontal Scaling
|
|
368
|
+
|
|
369
|
+
```
|
|
370
|
+
Production Setup:
|
|
371
|
+
┌──────────────────────────────────┐
|
|
372
|
+
│ Load Balancer │
|
|
373
|
+
└────┬──────────────────────────┬──┘
|
|
374
|
+
│ │
|
|
375
|
+
┌────▼──────────┐ ┌────────▼────┐
|
|
376
|
+
│ API GW (pod1) │ │ API GW (pod2)│
|
|
377
|
+
└────┬─────┬────┘ └────┬─────┬───┘
|
|
378
|
+
│ │ │ │
|
|
379
|
+
┌──▼──┐ ┌──▼──┐ ┌─────▼─┐ ┌───▼──┐
|
|
380
|
+
│Auth1│ │Auth2│ ... │User1 │ │User2 │ ...
|
|
381
|
+
└─────┘ └─────┘ └───────┘ └──────┘
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
**Scaling Rules:**
|
|
385
|
+
- API Gateway: 1-3 replicas
|
|
386
|
+
- Auth Service: 1-2 replicas
|
|
387
|
+
- User Service: 1-2 replicas
|
|
388
|
+
- Notification Service: 1 replica (or N for throughput)
|
|
389
|
+
|
|
390
|
+
**Database Scaling:**
|
|
391
|
+
- Read replicas for User DB
|
|
392
|
+
- Connection pooling (PgBouncer)
|
|
393
|
+
- Vertical scaling for Auth DB
|
|
394
|
+
|
|
395
|
+
**Message Queue:**
|
|
396
|
+
- RabbitMQ in cluster mode
|
|
397
|
+
- Multiple consumer instances
|
|
398
|
+
|
|
399
|
+
---
|
|
400
|
+
|
|
401
|
+
## Deployment Topology
|
|
402
|
+
|
|
403
|
+
### Local Development
|
|
404
|
+
```
|
|
405
|
+
Docker Compose:
|
|
406
|
+
- Single Docker network
|
|
407
|
+
- All services connected
|
|
408
|
+
- Shared databases
|
|
409
|
+
- Health checks enabled
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
### Production (Kubernetes)
|
|
413
|
+
```
|
|
414
|
+
Namespace: microservices
|
|
415
|
+
├── api-gateway deployment (1-3 replicas)
|
|
416
|
+
├── auth-service statefulset (1-3 replicas)
|
|
417
|
+
├── user-service statefulset (1-3 replicas)
|
|
418
|
+
├── notification-service deployment (1-N replicas)
|
|
419
|
+
├── postgres-auth statefulset
|
|
420
|
+
├── postgres-user statefulset
|
|
421
|
+
├── rabbitmq statefulset (cluster)
|
|
422
|
+
└── redis deployment (with persistence)
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
## Monitoring & Observability
|
|
428
|
+
|
|
429
|
+
### Logging
|
|
430
|
+
```
|
|
431
|
+
Each service logs:
|
|
432
|
+
- Request entry/exit
|
|
433
|
+
- Service calls
|
|
434
|
+
- Database queries
|
|
435
|
+
- Errors with stack traces
|
|
436
|
+
- Performance metrics
|
|
437
|
+
|
|
438
|
+
Format: JSON for easy parsing
|
|
439
|
+
{"timestamp": "...", "level": "INFO", "service": "auth-service", ...}
|
|
440
|
+
```
|
|
441
|
+
|
|
442
|
+
### Tracing
|
|
443
|
+
```
|
|
444
|
+
X-Trace-Id: Generated at API Gateway
|
|
445
|
+
X-Span-Id: Generated per service
|
|
446
|
+
X-Parent-Span-Id: Propagated through calls
|
|
447
|
+
|
|
448
|
+
Example flow:
|
|
449
|
+
API Gateway → Auth Service
|
|
450
|
+
X-Trace-Id: trace-001
|
|
451
|
+
├─ X-Span-Id: span-gateway-001
|
|
452
|
+
└─ X-Span-Id: span-auth-001 (parent: span-gateway-001)
|
|
453
|
+
```
|
|
454
|
+
|
|
455
|
+
### Metrics
|
|
456
|
+
```
|
|
457
|
+
Prometheus targets:
|
|
458
|
+
- HTTP request count
|
|
459
|
+
- HTTP request duration
|
|
460
|
+
- Database query duration
|
|
461
|
+
- Message queue depth
|
|
462
|
+
- Cache hit/miss ratio
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
---
|
|
466
|
+
|
|
467
|
+
## Security Architecture
|
|
468
|
+
|
|
469
|
+
### Authentication & Authorization
|
|
470
|
+
```
|
|
471
|
+
1. Client sends credentials → Auth Service
|
|
472
|
+
2. Auth Service validates → Issues JWT
|
|
473
|
+
3. JWT stored in headers (Authorization: Bearer ...)
|
|
474
|
+
4. API Gateway verifies JWT signature
|
|
475
|
+
5. Each service validates token expiry
|
|
476
|
+
|
|
477
|
+
Token Structure:
|
|
478
|
+
{
|
|
479
|
+
"userId": "...",
|
|
480
|
+
"email": "...",
|
|
481
|
+
"iat": 1234567890,
|
|
482
|
+
"exp": 1234568790,
|
|
483
|
+
"type": "access"
|
|
484
|
+
}
|
|
485
|
+
```
|
|
486
|
+
|
|
487
|
+
### Data Protection
|
|
488
|
+
```
|
|
489
|
+
- Passwords: bcrypt (cost: 12)
|
|
490
|
+
- In-transit: HTTPS (TLS 1.3)
|
|
491
|
+
- Tokens: JWT with RS256 signature
|
|
492
|
+
- Sensitive data: Encrypted at rest
|
|
493
|
+
```
|
|
494
|
+
|
|
495
|
+
### Network Security
|
|
496
|
+
```
|
|
497
|
+
- Services isolated to private network
|
|
498
|
+
- API Gateway only public endpoint
|
|
499
|
+
- Rate limiting per IP/user
|
|
500
|
+
- Request validation on all endpoints
|
|
501
|
+
```
|
|
502
|
+
|
|
503
|
+
---
|
|
504
|
+
|
|
505
|
+
## Conclusion
|
|
506
|
+
|
|
507
|
+
This architecture provides:
|
|
508
|
+
- **Scalability**: Services scale independently
|
|
509
|
+
- **Resilience**: Failures isolated per service
|
|
510
|
+
- **Flexibility**: Different tech stacks per service
|
|
511
|
+
- **Maintainability**: Clear service boundaries
|
|
512
|
+
- **Observability**: Tracing and logging built-in
|