forjajs 2.0.2 → 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 -317
- package/README.pt-BR.md +345 -323
- 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/apps/server/src/main.d.ts +3 -2
- package/dist/apps/server/src/main.js +8 -6
- package/dist/bin/create-memory-nest-kit.js +17 -17
- package/dist/bin/forja.js +22 -5
- 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 +64 -0
- package/dist/lib/core/registry.js +65 -0
- package/dist/lib/core/release.d.ts +63 -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-git/src/index.d.ts +2 -0
- package/dist/packages/adapter-git/src/index.js +22 -1
- package/dist/packages/adapter-sqlite/src/index.js +12 -12
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/llm/src/index.d.ts +43 -0
- package/dist/packages/llm/src/index.js +108 -0
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -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-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/context-ops.js +29 -29
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- 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.d.ts +1 -0
- 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 -132
- 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 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- 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 -0
- 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 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- 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 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- 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 -140
- 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
|
@@ -1,185 +1,185 @@
|
|
|
1
|
-
# Database Schema
|
|
2
|
-
|
|
3
|
-
## Entities & Relationships
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
Organization (1) ──→ (Many) User
|
|
7
|
-
Organization (1) ──→ (1) Subscription
|
|
8
|
-
Organization (1) ──→ (Many) Invoice
|
|
9
|
-
Subscription (1) ──→ (Many) Invoice
|
|
10
|
-
User (1) ──→ (Many) Audit Log
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Entity: Organization
|
|
14
|
-
|
|
15
|
-
```sql
|
|
16
|
-
CREATE TABLE organizations (
|
|
17
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
18
|
-
tenantId UUID NOT NULL UNIQUE,
|
|
19
|
-
name VARCHAR(255) NOT NULL,
|
|
20
|
-
slug VARCHAR(255) NOT NULL UNIQUE,
|
|
21
|
-
ownerUserId UUID NOT NULL REFERENCES users(id),
|
|
22
|
-
plan VARCHAR(50) NOT NULL DEFAULT 'free',
|
|
23
|
-
stripeCustomerId VARCHAR(255),
|
|
24
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
25
|
-
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
26
|
-
deletedAt TIMESTAMP
|
|
27
|
-
);
|
|
28
|
-
|
|
29
|
-
CREATE INDEX idx_org_tenant ON organizations(tenantId);
|
|
30
|
-
CREATE INDEX idx_org_owner ON organizations(ownerUserId);
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Entity: User
|
|
34
|
-
|
|
35
|
-
```sql
|
|
36
|
-
CREATE TABLE users (
|
|
37
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
38
|
-
tenantId UUID NOT NULL,
|
|
39
|
-
email VARCHAR(255) NOT NULL,
|
|
40
|
-
passwordHash VARCHAR(255),
|
|
41
|
-
firstName VARCHAR(100),
|
|
42
|
-
lastName VARCHAR(100),
|
|
43
|
-
roles VARCHAR(50)[] DEFAULT ARRAY['member'],
|
|
44
|
-
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
45
|
-
emailVerifiedAt TIMESTAMP,
|
|
46
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
47
|
-
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
48
|
-
deletedAt TIMESTAMP,
|
|
49
|
-
CONSTRAINT fk_user_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
50
|
-
);
|
|
51
|
-
|
|
52
|
-
CREATE INDEX idx_user_tenant_email ON users(tenantId, email);
|
|
53
|
-
CREATE INDEX idx_user_tenant_status ON users(tenantId, status);
|
|
54
|
-
CREATE UNIQUE INDEX idx_user_unique_email ON users(tenantId, email) WHERE deletedAt IS NULL;
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
## Entity: Subscription
|
|
58
|
-
|
|
59
|
-
```sql
|
|
60
|
-
CREATE TABLE subscriptions (
|
|
61
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
62
|
-
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
63
|
-
tenantId UUID NOT NULL,
|
|
64
|
-
plan VARCHAR(50) NOT NULL,
|
|
65
|
-
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
66
|
-
currentPeriodStart TIMESTAMP NOT NULL,
|
|
67
|
-
currentPeriodEnd TIMESTAMP NOT NULL,
|
|
68
|
-
cancelAtPeriodEnd BOOLEAN DEFAULT FALSE,
|
|
69
|
-
cancelledAt TIMESTAMP,
|
|
70
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
71
|
-
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
72
|
-
CONSTRAINT fk_sub_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
73
|
-
);
|
|
74
|
-
|
|
75
|
-
CREATE INDEX idx_sub_org ON subscriptions(organizationId);
|
|
76
|
-
CREATE INDEX idx_sub_tenant ON subscriptions(tenantId);
|
|
77
|
-
CREATE INDEX idx_sub_status ON subscriptions(tenantId, status);
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
## Entity: Invoice
|
|
81
|
-
|
|
82
|
-
```sql
|
|
83
|
-
CREATE TABLE invoices (
|
|
84
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
85
|
-
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
86
|
-
tenantId UUID NOT NULL,
|
|
87
|
-
invoiceNumber VARCHAR(50) NOT NULL UNIQUE,
|
|
88
|
-
subscriptionId UUID REFERENCES subscriptions(id),
|
|
89
|
-
amount DECIMAL(10, 2) NOT NULL,
|
|
90
|
-
currency VARCHAR(3) NOT NULL DEFAULT 'USD',
|
|
91
|
-
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
92
|
-
description TEXT,
|
|
93
|
-
items JSONB,
|
|
94
|
-
issuedAt TIMESTAMP NOT NULL,
|
|
95
|
-
dueDate TIMESTAMP,
|
|
96
|
-
paidAt TIMESTAMP,
|
|
97
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
98
|
-
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
99
|
-
CONSTRAINT fk_invoice_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
100
|
-
);
|
|
101
|
-
|
|
102
|
-
CREATE INDEX idx_inv_org ON invoices(organizationId);
|
|
103
|
-
CREATE INDEX idx_inv_tenant ON invoices(tenantId);
|
|
104
|
-
CREATE INDEX idx_inv_status ON invoices(tenantId, status);
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
## Entity: Payment Transaction
|
|
108
|
-
|
|
109
|
-
```sql
|
|
110
|
-
CREATE TABLE transactions (
|
|
111
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
112
|
-
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
113
|
-
tenantId UUID NOT NULL,
|
|
114
|
-
invoiceId UUID REFERENCES invoices(id),
|
|
115
|
-
amount DECIMAL(10, 2) NOT NULL,
|
|
116
|
-
currency VARCHAR(3) NOT NULL,
|
|
117
|
-
type VARCHAR(50) NOT NULL,
|
|
118
|
-
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
119
|
-
paymentMethodId VARCHAR(255),
|
|
120
|
-
stripePaymentIntentId VARCHAR(255),
|
|
121
|
-
description TEXT,
|
|
122
|
-
failureReason TEXT,
|
|
123
|
-
retryCount INT DEFAULT 0,
|
|
124
|
-
nextRetryAt TIMESTAMP,
|
|
125
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
126
|
-
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
127
|
-
CONSTRAINT fk_txn_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
128
|
-
);
|
|
129
|
-
|
|
130
|
-
CREATE INDEX idx_txn_org ON transactions(organizationId);
|
|
131
|
-
CREATE INDEX idx_txn_tenant ON transactions(tenantId);
|
|
132
|
-
CREATE INDEX idx_txn_invoice ON transactions(invoiceId);
|
|
133
|
-
CREATE INDEX idx_txn_status ON transactions(tenantId, status);
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
## Entity: Audit Log
|
|
137
|
-
|
|
138
|
-
```sql
|
|
139
|
-
CREATE TABLE audit_logs (
|
|
140
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
141
|
-
tenantId UUID NOT NULL,
|
|
142
|
-
userId UUID REFERENCES users(id),
|
|
143
|
-
action VARCHAR(100) NOT NULL,
|
|
144
|
-
entity VARCHAR(100) NOT NULL,
|
|
145
|
-
entityId UUID,
|
|
146
|
-
changes JSONB,
|
|
147
|
-
ipAddress INET,
|
|
148
|
-
userAgent TEXT,
|
|
149
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
150
|
-
CONSTRAINT fk_audit_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
151
|
-
);
|
|
152
|
-
|
|
153
|
-
CREATE INDEX idx_audit_tenant ON audit_logs(tenantId);
|
|
154
|
-
CREATE INDEX idx_audit_user ON audit_logs(userId);
|
|
155
|
-
CREATE INDEX idx_audit_action ON audit_logs(action);
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
## Entity: API Key (Future)
|
|
159
|
-
|
|
160
|
-
```sql
|
|
161
|
-
CREATE TABLE api_keys (
|
|
162
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
163
|
-
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
164
|
-
tenantId UUID NOT NULL,
|
|
165
|
-
keyHash VARCHAR(255) NOT NULL UNIQUE,
|
|
166
|
-
name VARCHAR(255) NOT NULL,
|
|
167
|
-
lastUsedAt TIMESTAMP,
|
|
168
|
-
expiresAt TIMESTAMP,
|
|
169
|
-
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
170
|
-
revokedAt TIMESTAMP,
|
|
171
|
-
CONSTRAINT fk_apikey_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
172
|
-
);
|
|
173
|
-
|
|
174
|
-
CREATE INDEX idx_apikey_org ON api_keys(organizationId);
|
|
175
|
-
CREATE INDEX idx_apikey_hash ON api_keys(keyHash);
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
## Constraints & Rules
|
|
179
|
-
|
|
180
|
-
- Every table has `tenantId` for isolation
|
|
181
|
-
- Foreign keys enforce referential integrity
|
|
182
|
-
- Soft deletes with `deletedAt`
|
|
183
|
-
- Timestamps: `createdAt`, `updatedAt` on every table
|
|
184
|
-
- Indexes on every foreign key + filtering column
|
|
185
|
-
- Unique constraints on business keys (email, invoiceNumber, etc)
|
|
1
|
+
# Database Schema
|
|
2
|
+
|
|
3
|
+
## Entities & Relationships
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
Organization (1) ──→ (Many) User
|
|
7
|
+
Organization (1) ──→ (1) Subscription
|
|
8
|
+
Organization (1) ──→ (Many) Invoice
|
|
9
|
+
Subscription (1) ──→ (Many) Invoice
|
|
10
|
+
User (1) ──→ (Many) Audit Log
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Entity: Organization
|
|
14
|
+
|
|
15
|
+
```sql
|
|
16
|
+
CREATE TABLE organizations (
|
|
17
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
18
|
+
tenantId UUID NOT NULL UNIQUE,
|
|
19
|
+
name VARCHAR(255) NOT NULL,
|
|
20
|
+
slug VARCHAR(255) NOT NULL UNIQUE,
|
|
21
|
+
ownerUserId UUID NOT NULL REFERENCES users(id),
|
|
22
|
+
plan VARCHAR(50) NOT NULL DEFAULT 'free',
|
|
23
|
+
stripeCustomerId VARCHAR(255),
|
|
24
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
25
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
26
|
+
deletedAt TIMESTAMP
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
CREATE INDEX idx_org_tenant ON organizations(tenantId);
|
|
30
|
+
CREATE INDEX idx_org_owner ON organizations(ownerUserId);
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Entity: User
|
|
34
|
+
|
|
35
|
+
```sql
|
|
36
|
+
CREATE TABLE users (
|
|
37
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
38
|
+
tenantId UUID NOT NULL,
|
|
39
|
+
email VARCHAR(255) NOT NULL,
|
|
40
|
+
passwordHash VARCHAR(255),
|
|
41
|
+
firstName VARCHAR(100),
|
|
42
|
+
lastName VARCHAR(100),
|
|
43
|
+
roles VARCHAR(50)[] DEFAULT ARRAY['member'],
|
|
44
|
+
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
45
|
+
emailVerifiedAt TIMESTAMP,
|
|
46
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
47
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
48
|
+
deletedAt TIMESTAMP,
|
|
49
|
+
CONSTRAINT fk_user_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
50
|
+
);
|
|
51
|
+
|
|
52
|
+
CREATE INDEX idx_user_tenant_email ON users(tenantId, email);
|
|
53
|
+
CREATE INDEX idx_user_tenant_status ON users(tenantId, status);
|
|
54
|
+
CREATE UNIQUE INDEX idx_user_unique_email ON users(tenantId, email) WHERE deletedAt IS NULL;
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Entity: Subscription
|
|
58
|
+
|
|
59
|
+
```sql
|
|
60
|
+
CREATE TABLE subscriptions (
|
|
61
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
62
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
63
|
+
tenantId UUID NOT NULL,
|
|
64
|
+
plan VARCHAR(50) NOT NULL,
|
|
65
|
+
status VARCHAR(50) NOT NULL DEFAULT 'active',
|
|
66
|
+
currentPeriodStart TIMESTAMP NOT NULL,
|
|
67
|
+
currentPeriodEnd TIMESTAMP NOT NULL,
|
|
68
|
+
cancelAtPeriodEnd BOOLEAN DEFAULT FALSE,
|
|
69
|
+
cancelledAt TIMESTAMP,
|
|
70
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
71
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
72
|
+
CONSTRAINT fk_sub_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
73
|
+
);
|
|
74
|
+
|
|
75
|
+
CREATE INDEX idx_sub_org ON subscriptions(organizationId);
|
|
76
|
+
CREATE INDEX idx_sub_tenant ON subscriptions(tenantId);
|
|
77
|
+
CREATE INDEX idx_sub_status ON subscriptions(tenantId, status);
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Entity: Invoice
|
|
81
|
+
|
|
82
|
+
```sql
|
|
83
|
+
CREATE TABLE invoices (
|
|
84
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
85
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
86
|
+
tenantId UUID NOT NULL,
|
|
87
|
+
invoiceNumber VARCHAR(50) NOT NULL UNIQUE,
|
|
88
|
+
subscriptionId UUID REFERENCES subscriptions(id),
|
|
89
|
+
amount DECIMAL(10, 2) NOT NULL,
|
|
90
|
+
currency VARCHAR(3) NOT NULL DEFAULT 'USD',
|
|
91
|
+
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
92
|
+
description TEXT,
|
|
93
|
+
items JSONB,
|
|
94
|
+
issuedAt TIMESTAMP NOT NULL,
|
|
95
|
+
dueDate TIMESTAMP,
|
|
96
|
+
paidAt TIMESTAMP,
|
|
97
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
98
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
99
|
+
CONSTRAINT fk_invoice_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
100
|
+
);
|
|
101
|
+
|
|
102
|
+
CREATE INDEX idx_inv_org ON invoices(organizationId);
|
|
103
|
+
CREATE INDEX idx_inv_tenant ON invoices(tenantId);
|
|
104
|
+
CREATE INDEX idx_inv_status ON invoices(tenantId, status);
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Entity: Payment Transaction
|
|
108
|
+
|
|
109
|
+
```sql
|
|
110
|
+
CREATE TABLE transactions (
|
|
111
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
112
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
113
|
+
tenantId UUID NOT NULL,
|
|
114
|
+
invoiceId UUID REFERENCES invoices(id),
|
|
115
|
+
amount DECIMAL(10, 2) NOT NULL,
|
|
116
|
+
currency VARCHAR(3) NOT NULL,
|
|
117
|
+
type VARCHAR(50) NOT NULL,
|
|
118
|
+
status VARCHAR(50) NOT NULL DEFAULT 'pending',
|
|
119
|
+
paymentMethodId VARCHAR(255),
|
|
120
|
+
stripePaymentIntentId VARCHAR(255),
|
|
121
|
+
description TEXT,
|
|
122
|
+
failureReason TEXT,
|
|
123
|
+
retryCount INT DEFAULT 0,
|
|
124
|
+
nextRetryAt TIMESTAMP,
|
|
125
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
126
|
+
updatedAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
127
|
+
CONSTRAINT fk_txn_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
128
|
+
);
|
|
129
|
+
|
|
130
|
+
CREATE INDEX idx_txn_org ON transactions(organizationId);
|
|
131
|
+
CREATE INDEX idx_txn_tenant ON transactions(tenantId);
|
|
132
|
+
CREATE INDEX idx_txn_invoice ON transactions(invoiceId);
|
|
133
|
+
CREATE INDEX idx_txn_status ON transactions(tenantId, status);
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## Entity: Audit Log
|
|
137
|
+
|
|
138
|
+
```sql
|
|
139
|
+
CREATE TABLE audit_logs (
|
|
140
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
141
|
+
tenantId UUID NOT NULL,
|
|
142
|
+
userId UUID REFERENCES users(id),
|
|
143
|
+
action VARCHAR(100) NOT NULL,
|
|
144
|
+
entity VARCHAR(100) NOT NULL,
|
|
145
|
+
entityId UUID,
|
|
146
|
+
changes JSONB,
|
|
147
|
+
ipAddress INET,
|
|
148
|
+
userAgent TEXT,
|
|
149
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
150
|
+
CONSTRAINT fk_audit_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
151
|
+
);
|
|
152
|
+
|
|
153
|
+
CREATE INDEX idx_audit_tenant ON audit_logs(tenantId);
|
|
154
|
+
CREATE INDEX idx_audit_user ON audit_logs(userId);
|
|
155
|
+
CREATE INDEX idx_audit_action ON audit_logs(action);
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## Entity: API Key (Future)
|
|
159
|
+
|
|
160
|
+
```sql
|
|
161
|
+
CREATE TABLE api_keys (
|
|
162
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
163
|
+
organizationId UUID NOT NULL REFERENCES organizations(id),
|
|
164
|
+
tenantId UUID NOT NULL,
|
|
165
|
+
keyHash VARCHAR(255) NOT NULL UNIQUE,
|
|
166
|
+
name VARCHAR(255) NOT NULL,
|
|
167
|
+
lastUsedAt TIMESTAMP,
|
|
168
|
+
expiresAt TIMESTAMP,
|
|
169
|
+
createdAt TIMESTAMP NOT NULL DEFAULT NOW(),
|
|
170
|
+
revokedAt TIMESTAMP,
|
|
171
|
+
CONSTRAINT fk_apikey_tenant FOREIGN KEY (tenantId) REFERENCES organizations(tenantId)
|
|
172
|
+
);
|
|
173
|
+
|
|
174
|
+
CREATE INDEX idx_apikey_org ON api_keys(organizationId);
|
|
175
|
+
CREATE INDEX idx_apikey_hash ON api_keys(keyHash);
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## Constraints & Rules
|
|
179
|
+
|
|
180
|
+
- Every table has `tenantId` for isolation
|
|
181
|
+
- Foreign keys enforce referential integrity
|
|
182
|
+
- Soft deletes with `deletedAt`
|
|
183
|
+
- Timestamps: `createdAt`, `updatedAt` on every table
|
|
184
|
+
- Indexes on every foreign key + filtering column
|
|
185
|
+
- Unique constraints on business keys (email, invoiceNumber, etc)
|
|
@@ -1,75 +1,75 @@
|
|
|
1
|
-
# ADR Template - Architecture Decision Records
|
|
2
|
-
|
|
3
|
-
Use este template para documentar decisões arquiteturais importantes.
|
|
4
|
-
|
|
5
|
-
## ADR-YYYYMMDD-XXX: {Título da Decisão}
|
|
6
|
-
|
|
7
|
-
**Date**: YYYY-MM-DD
|
|
8
|
-
**Status**: Proposed | Accepted | Deprecated | Superseded by ADR-...
|
|
9
|
-
**Deciders**: [names]
|
|
10
|
-
|
|
11
|
-
## Context
|
|
12
|
-
|
|
13
|
-
Descreva o problema ou situação que motivou esta decisão.
|
|
14
|
-
|
|
15
|
-
**Background**:
|
|
16
|
-
- What is the issue?
|
|
17
|
-
- Why now?
|
|
18
|
-
- What constraints exist?
|
|
19
|
-
|
|
20
|
-
**Options Considered**:
|
|
21
|
-
1. Option A
|
|
22
|
-
2. Option B
|
|
23
|
-
3. Option C
|
|
24
|
-
|
|
25
|
-
## Decision
|
|
26
|
-
|
|
27
|
-
Declare qual opção foi escolhida e por quê.
|
|
28
|
-
|
|
29
|
-
## Consequences
|
|
30
|
-
|
|
31
|
-
### Positive
|
|
32
|
-
- Benefit 1
|
|
33
|
-
- Benefit 2
|
|
34
|
-
|
|
35
|
-
### Negative
|
|
36
|
-
- Risk 1
|
|
37
|
-
- Risk 2
|
|
38
|
-
|
|
39
|
-
### Neutral
|
|
40
|
-
- Other impact 1
|
|
41
|
-
|
|
42
|
-
## Rationale
|
|
43
|
-
|
|
44
|
-
Explique o raciocínio por trás dessa decisão em detalhes.
|
|
45
|
-
|
|
46
|
-
## Related ADRs
|
|
47
|
-
|
|
48
|
-
- ADR-YYYYMMDD-XXX (related decision)
|
|
49
|
-
- ADR-YYYYMMDD-YYY (conflicting/complementary decision)
|
|
50
|
-
|
|
51
|
-
## Examples
|
|
52
|
-
|
|
53
|
-
### Exemplo: Por que PostgreSQL?
|
|
54
|
-
|
|
55
|
-
**ADR-20240115-001: Database Choice**
|
|
56
|
-
|
|
57
|
-
**Context**
|
|
58
|
-
- Need relational data (users, orgs, subscriptions, invoices)
|
|
59
|
-
- Transactions required (ACID) for billing
|
|
60
|
-
- Multi-tenant architecture demands row-level security
|
|
61
|
-
- Cost considerations
|
|
62
|
-
|
|
63
|
-
**Decision**
|
|
64
|
-
PostgreSQL with row-level tenant isolation (tenantId column)
|
|
65
|
-
|
|
66
|
-
**Consequences**
|
|
67
|
-
- ✅ Strong ACID guarantees for billing
|
|
68
|
-
- ✅ Mature ecosystem, lots of examples
|
|
69
|
-
- ✅ Managed options (RDS, Heroku)
|
|
70
|
-
- ✅ Full-text search (future feature)
|
|
71
|
-
- ❌ Slightly higher latency vs NoSQL (acceptable)
|
|
72
|
-
- ❌ Vertical scaling limits (acceptable for MVP)
|
|
73
|
-
|
|
74
|
-
**Rationale**
|
|
75
|
-
Banking/billing requires ACID compliance. MongoDB would introduce risks for money operations. PostgreSQL is battle-tested in production SaaS platforms.
|
|
1
|
+
# ADR Template - Architecture Decision Records
|
|
2
|
+
|
|
3
|
+
Use este template para documentar decisões arquiteturais importantes.
|
|
4
|
+
|
|
5
|
+
## ADR-YYYYMMDD-XXX: {Título da Decisão}
|
|
6
|
+
|
|
7
|
+
**Date**: YYYY-MM-DD
|
|
8
|
+
**Status**: Proposed | Accepted | Deprecated | Superseded by ADR-...
|
|
9
|
+
**Deciders**: [names]
|
|
10
|
+
|
|
11
|
+
## Context
|
|
12
|
+
|
|
13
|
+
Descreva o problema ou situação que motivou esta decisão.
|
|
14
|
+
|
|
15
|
+
**Background**:
|
|
16
|
+
- What is the issue?
|
|
17
|
+
- Why now?
|
|
18
|
+
- What constraints exist?
|
|
19
|
+
|
|
20
|
+
**Options Considered**:
|
|
21
|
+
1. Option A
|
|
22
|
+
2. Option B
|
|
23
|
+
3. Option C
|
|
24
|
+
|
|
25
|
+
## Decision
|
|
26
|
+
|
|
27
|
+
Declare qual opção foi escolhida e por quê.
|
|
28
|
+
|
|
29
|
+
## Consequences
|
|
30
|
+
|
|
31
|
+
### Positive
|
|
32
|
+
- Benefit 1
|
|
33
|
+
- Benefit 2
|
|
34
|
+
|
|
35
|
+
### Negative
|
|
36
|
+
- Risk 1
|
|
37
|
+
- Risk 2
|
|
38
|
+
|
|
39
|
+
### Neutral
|
|
40
|
+
- Other impact 1
|
|
41
|
+
|
|
42
|
+
## Rationale
|
|
43
|
+
|
|
44
|
+
Explique o raciocínio por trás dessa decisão em detalhes.
|
|
45
|
+
|
|
46
|
+
## Related ADRs
|
|
47
|
+
|
|
48
|
+
- ADR-YYYYMMDD-XXX (related decision)
|
|
49
|
+
- ADR-YYYYMMDD-YYY (conflicting/complementary decision)
|
|
50
|
+
|
|
51
|
+
## Examples
|
|
52
|
+
|
|
53
|
+
### Exemplo: Por que PostgreSQL?
|
|
54
|
+
|
|
55
|
+
**ADR-20240115-001: Database Choice**
|
|
56
|
+
|
|
57
|
+
**Context**
|
|
58
|
+
- Need relational data (users, orgs, subscriptions, invoices)
|
|
59
|
+
- Transactions required (ACID) for billing
|
|
60
|
+
- Multi-tenant architecture demands row-level security
|
|
61
|
+
- Cost considerations
|
|
62
|
+
|
|
63
|
+
**Decision**
|
|
64
|
+
PostgreSQL with row-level tenant isolation (tenantId column)
|
|
65
|
+
|
|
66
|
+
**Consequences**
|
|
67
|
+
- ✅ Strong ACID guarantees for billing
|
|
68
|
+
- ✅ Mature ecosystem, lots of examples
|
|
69
|
+
- ✅ Managed options (RDS, Heroku)
|
|
70
|
+
- ✅ Full-text search (future feature)
|
|
71
|
+
- ❌ Slightly higher latency vs NoSQL (acceptable)
|
|
72
|
+
- ❌ Vertical scaling limits (acceptable for MVP)
|
|
73
|
+
|
|
74
|
+
**Rationale**
|
|
75
|
+
Banking/billing requires ACID compliance. MongoDB would introduce risks for money operations. PostgreSQL is battle-tested in production SaaS platforms.
|