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,318 +1,318 @@
|
|
|
1
|
-
# Monorepo Starter
|
|
2
|
-
|
|
3
|
-
A production-ready full-stack monorepo template with **Next.js 14** frontend, **NestJS 10** backend, and shared TypeScript packages managed with **Turborepo**.
|
|
4
|
-
|
|
5
|
-
## ๐ฏ Features
|
|
6
|
-
|
|
7
|
-
- โ
**Monorepo Structure** โ Single repository with frontend, backend, and shared packages
|
|
8
|
-
- โ
**Type-Safe APIs** โ Shared TypeScript types across frontend and backend
|
|
9
|
-
- โ
**Fast Builds** โ Turborepo with intelligent caching
|
|
10
|
-
- โ
**Zero-Friction Dev** โ One command to start everything (`npm run dev`)
|
|
11
|
-
- โ
**Production Ready** โ Docker support, environment config, error handling
|
|
12
|
-
- โ
**Scalable** โ Easy to add new packages and domains
|
|
13
|
-
|
|
14
|
-
## ๐ฆ Packages
|
|
15
|
-
|
|
16
|
-
### Apps
|
|
17
|
-
- **frontend** โ Next.js 14 + React 18 + Tailwind CSS
|
|
18
|
-
- Pages: Home, Products, Dashboard
|
|
19
|
-
- API client with JWT auth
|
|
20
|
-
- Server Components by default
|
|
21
|
-
|
|
22
|
-
- **backend** โ NestJS 10 + TypeORM + PostgreSQL
|
|
23
|
-
- Modules: Users, Products, Orders
|
|
24
|
-
- JWT authentication with Passport
|
|
25
|
-
- Global error handling
|
|
26
|
-
|
|
27
|
-
### Shared
|
|
28
|
-
- **shared-types** โ TypeScript interfaces for API contracts
|
|
29
|
-
- API DTOs (requests/responses)
|
|
30
|
-
- Domain entities
|
|
31
|
-
- Error types
|
|
32
|
-
|
|
33
|
-
- **shared-utils** โ Common utilities and helpers
|
|
34
|
-
- Validators (email, password, etc.)
|
|
35
|
-
- String utils (slugify, formatPrice, etc.)
|
|
36
|
-
- Math utils (calculations)
|
|
37
|
-
- Constants
|
|
38
|
-
|
|
39
|
-
## ๐ Quick Start
|
|
40
|
-
|
|
41
|
-
### Prerequisites
|
|
42
|
-
- Node.js 18+
|
|
43
|
-
- npm 9+
|
|
44
|
-
- Docker & Docker Compose (for database/redis)
|
|
45
|
-
|
|
46
|
-
### 1. Clone and Install
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
cd boilerplates/05-monorepo-starter
|
|
50
|
-
npm install
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
### 2. Setup Database
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
# Start PostgreSQL and Redis
|
|
57
|
-
docker-compose up -d
|
|
58
|
-
|
|
59
|
-
# Create .env file in backend
|
|
60
|
-
cp packages/apps/backend/.env.example packages/apps/backend/.env
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
### 3. Run Development Mode
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
# Start frontend + backend + watch mode (from root)
|
|
67
|
-
npm run dev
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
- Frontend: http://localhost:3000
|
|
71
|
-
- Backend: http://localhost:3001/api
|
|
72
|
-
- Health check: http://localhost:3001/api/health
|
|
73
|
-
|
|
74
|
-
## ๐ Project Structure
|
|
75
|
-
|
|
76
|
-
```
|
|
77
|
-
monorepo/
|
|
78
|
-
โโโ packages/
|
|
79
|
-
โ โโโ apps/
|
|
80
|
-
โ โ โโโ frontend/ # Next.js 14
|
|
81
|
-
โ โ โ โโโ app/ # App Router pages
|
|
82
|
-
โ โ โ โโโ components/ # React components
|
|
83
|
-
โ โ โ โโโ lib/ # API client, hooks
|
|
84
|
-
โ โ โ โโโ styles/ # Tailwind CSS
|
|
85
|
-
โ โ โโโ backend/ # NestJS 10
|
|
86
|
-
โ โ โโโ src/
|
|
87
|
-
โ โ โโโ modules/ # Users, Products, Orders
|
|
88
|
-
โ โ โโโ common/ # Guards, pipes, exceptions
|
|
89
|
-
โ โโโ packages/
|
|
90
|
-
โ โโโ shared-types/ # DTO & domain interfaces
|
|
91
|
-
โ โโโ shared-utils/ # Utilities & helpers
|
|
92
|
-
โโโ turbo.json # Turborepo configuration
|
|
93
|
-
โโโ tsconfig.json # Base TypeScript config
|
|
94
|
-
โโโ package.json # Workspace root
|
|
95
|
-
โโโ docker-compose.yml # PostgreSQL + Redis
|
|
96
|
-
โโโ Dockerfile # Multi-stage production build
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
## ๐ง Commands
|
|
100
|
-
|
|
101
|
-
### Root Level
|
|
102
|
-
```bash
|
|
103
|
-
npm run dev # Start frontend + backend (watch mode)
|
|
104
|
-
npm run build # Build all packages
|
|
105
|
-
npm run test # Run tests
|
|
106
|
-
npm run lint # Lint all packages
|
|
107
|
-
npm run type-check # TypeScript type checking
|
|
108
|
-
npm run clean # Remove build artifacts
|
|
109
|
-
npm run format # Format code with Prettier
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
### Frontend
|
|
113
|
-
```bash
|
|
114
|
-
cd packages/apps/frontend
|
|
115
|
-
npm run dev # Start Next.js dev server
|
|
116
|
-
npm run build # Build for production
|
|
117
|
-
npm run start # Start production server
|
|
118
|
-
npm run lint # Lint code
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
### Backend
|
|
122
|
-
```bash
|
|
123
|
-
cd packages/apps/backend
|
|
124
|
-
npm run dev # Start NestJS dev server (watch)
|
|
125
|
-
npm run build # Build for production
|
|
126
|
-
npm run start # Start production server
|
|
127
|
-
npm run test # Run tests
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
### Shared Packages
|
|
131
|
-
```bash
|
|
132
|
-
cd packages/packages/shared-types
|
|
133
|
-
npm run build # Build TypeScript types
|
|
134
|
-
npm run type-check # Check types
|
|
135
|
-
|
|
136
|
-
cd packages/packages/shared-utils
|
|
137
|
-
npm run build # Build utilities
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
## ๐ Authentication
|
|
141
|
-
|
|
142
|
-
### JWT Flow
|
|
143
|
-
1. User registers โ Backend generates password hash
|
|
144
|
-
2. User logs in โ Backend returns JWT token
|
|
145
|
-
3. Frontend stores token in localStorage
|
|
146
|
-
4. Frontend sends token in `Authorization: Bearer <token>` header
|
|
147
|
-
5. Backend JwtGuard validates token on protected routes
|
|
148
|
-
|
|
149
|
-
### Environment Variables
|
|
150
|
-
Create `.env` files:
|
|
151
|
-
|
|
152
|
-
**Frontend** (`packages/apps/frontend/.env.local`):
|
|
153
|
-
```
|
|
154
|
-
NEXT_PUBLIC_API_URL=http://localhost:3001/api
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
**Backend** (`packages/apps/backend/.env`):
|
|
158
|
-
```
|
|
159
|
-
NODE_ENV=development
|
|
160
|
-
PORT=3001
|
|
161
|
-
DB_HOST=localhost
|
|
162
|
-
DB_PORT=5432
|
|
163
|
-
DB_USER=postgres
|
|
164
|
-
DB_PASSWORD=postgres
|
|
165
|
-
DB_NAME=monorepo
|
|
166
|
-
JWT_SECRET=super-secret-key-change-in-production
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
## ๐ก API Endpoints
|
|
170
|
-
|
|
171
|
-
### Users
|
|
172
|
-
- `POST /api/users/register` โ Create account
|
|
173
|
-
- `POST /api/users/login` โ Login
|
|
174
|
-
- `GET /api/users/:id` โ Get profile (auth required)
|
|
175
|
-
|
|
176
|
-
### Products
|
|
177
|
-
- `GET /api/products` โ List products (paginated)
|
|
178
|
-
- `GET /api/products/:id` โ Get product details
|
|
179
|
-
- `POST /api/products` โ Create (auth required)
|
|
180
|
-
- `PUT /api/products/:id` โ Update (auth required)
|
|
181
|
-
- `DELETE /api/products/:id` โ Delete (auth required)
|
|
182
|
-
|
|
183
|
-
### Orders
|
|
184
|
-
- `POST /api/orders` โ Create order (auth required)
|
|
185
|
-
- `GET /api/orders` โ List user's orders (auth required)
|
|
186
|
-
- `GET /api/orders/:id` โ Get order details (auth required)
|
|
187
|
-
- `PATCH /api/orders/:id/status` โ Update status (auth required)
|
|
188
|
-
- `DELETE /api/orders/:id` โ Cancel order (auth required)
|
|
189
|
-
|
|
190
|
-
## ๐๏ธ Adding New Features
|
|
191
|
-
|
|
192
|
-
### Add a New Shared Type
|
|
193
|
-
```typescript
|
|
194
|
-
// packages/packages/shared-types/src/api/my-feature.ts
|
|
195
|
-
export interface MyFeatureRequest { ... }
|
|
196
|
-
export interface MyFeatureResponse { ... }
|
|
197
|
-
|
|
198
|
-
// packages/packages/shared-types/src/index.ts (add export)
|
|
199
|
-
export * from './api/my-feature';
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
### Add a New Backend Module
|
|
203
|
-
```bash
|
|
204
|
-
# Create module structure
|
|
205
|
-
mkdir -p packages/apps/backend/src/modules/my-module/{entities,dto}
|
|
206
|
-
|
|
207
|
-
# Create entity, service, controller, module
|
|
208
|
-
# Import in AppModule
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
### Add a New Frontend Page
|
|
212
|
-
```bash
|
|
213
|
-
# Create page directory
|
|
214
|
-
mkdir -p packages/apps/frontend/app/my-page
|
|
215
|
-
|
|
216
|
-
# Create page.tsx with 'use client' for interactivity
|
|
217
|
-
```
|
|
218
|
-
|
|
219
|
-
## ๐ณ Docker
|
|
220
|
-
|
|
221
|
-
### Run with Docker Compose
|
|
222
|
-
```bash
|
|
223
|
-
# Start services (postgres + redis)
|
|
224
|
-
docker-compose up -d
|
|
225
|
-
|
|
226
|
-
# Stop services
|
|
227
|
-
docker-compose down
|
|
228
|
-
|
|
229
|
-
# View logs
|
|
230
|
-
docker-compose logs -f
|
|
231
|
-
```
|
|
232
|
-
|
|
233
|
-
### Build Docker Image
|
|
234
|
-
```bash
|
|
235
|
-
docker build -t monorepo-starter .
|
|
236
|
-
docker run -p 3000:3000 -p 3001:3001 monorepo-starter
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
## ๐งช Testing
|
|
240
|
-
|
|
241
|
-
```bash
|
|
242
|
-
# Run all tests
|
|
243
|
-
npm run test
|
|
244
|
-
|
|
245
|
-
# Watch mode
|
|
246
|
-
npm run test:watch
|
|
247
|
-
|
|
248
|
-
# Specific package
|
|
249
|
-
npm run test --workspace=backend
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
## ๐ข Production Deployment
|
|
253
|
-
|
|
254
|
-
1. Set environment variables in production
|
|
255
|
-
2. Build: `npm run build`
|
|
256
|
-
3. Start: `npm run start`
|
|
257
|
-
4. Or use Docker: `docker build -t my-app . && docker run my-app`
|
|
258
|
-
|
|
259
|
-
## ๐ Tech Stack
|
|
260
|
-
|
|
261
|
-
| Layer | Technology | Version |
|
|
262
|
-
|-------|-----------|---------|
|
|
263
|
-
| **Frontend** | Next.js | 14+ |
|
|
264
|
-
| **Frontend UI** | React | 18+ |
|
|
265
|
-
| **Styling** | Tailwind CSS | 3+ |
|
|
266
|
-
| **Backend** | NestJS | 10+ |
|
|
267
|
-
| **Database ORM** | TypeORM | 0.3+ |
|
|
268
|
-
| **Database** | PostgreSQL | 16+ |
|
|
269
|
-
| **Cache** | Redis | 7+ |
|
|
270
|
-
| **Auth** | JWT + Passport | - |
|
|
271
|
-
| **Language** | TypeScript | 5.3+ |
|
|
272
|
-
| **Build** | Turborepo | 1.10+ |
|
|
273
|
-
| **Package Manager** | npm | 9+ |
|
|
274
|
-
|
|
275
|
-
## ๐ Documentation
|
|
276
|
-
|
|
277
|
-
- See `DEVELOPMENT.md` for detailed development guide
|
|
278
|
-
- See `memory/` for architecture decisions and domain documentation
|
|
279
|
-
- See individual `README.md` in each package
|
|
280
|
-
|
|
281
|
-
## ๐ค Contributing
|
|
282
|
-
|
|
283
|
-
1. Create feature branch
|
|
284
|
-
2. Make changes
|
|
285
|
-
3. Run tests and linting: `npm run test && npm run lint`
|
|
286
|
-
4. Type-check: `npm run type-check`
|
|
287
|
-
5. Create pull request
|
|
288
|
-
|
|
289
|
-
## ๐ License
|
|
290
|
-
|
|
291
|
-
MIT - Feel free to use this template for your projects!
|
|
292
|
-
|
|
293
|
-
## ๐ Troubleshooting
|
|
294
|
-
|
|
295
|
-
**Port already in use?**
|
|
296
|
-
```bash
|
|
297
|
-
# Change ports in .env files or run on different ports
|
|
298
|
-
PORT=3002 npm run dev
|
|
299
|
-
```
|
|
300
|
-
|
|
301
|
-
**TypeScript errors?**
|
|
302
|
-
```bash
|
|
303
|
-
# Rebuild types from shared packages
|
|
304
|
-
npm run build --workspace=shared-types
|
|
305
|
-
npm run build --workspace=shared-utils
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
**Database connection errors?**
|
|
309
|
-
```bash
|
|
310
|
-
# Ensure PostgreSQL is running
|
|
311
|
-
docker-compose up -d postgres
|
|
312
|
-
|
|
313
|
-
# Check connection string in .env
|
|
314
|
-
```
|
|
315
|
-
|
|
316
|
-
---
|
|
317
|
-
|
|
318
|
-
**Happy coding! ๐**
|
|
1
|
+
# Monorepo Starter
|
|
2
|
+
|
|
3
|
+
A production-ready full-stack monorepo template with **Next.js 14** frontend, **NestJS 10** backend, and shared TypeScript packages managed with **Turborepo**.
|
|
4
|
+
|
|
5
|
+
## ๐ฏ Features
|
|
6
|
+
|
|
7
|
+
- โ
**Monorepo Structure** โ Single repository with frontend, backend, and shared packages
|
|
8
|
+
- โ
**Type-Safe APIs** โ Shared TypeScript types across frontend and backend
|
|
9
|
+
- โ
**Fast Builds** โ Turborepo with intelligent caching
|
|
10
|
+
- โ
**Zero-Friction Dev** โ One command to start everything (`npm run dev`)
|
|
11
|
+
- โ
**Production Ready** โ Docker support, environment config, error handling
|
|
12
|
+
- โ
**Scalable** โ Easy to add new packages and domains
|
|
13
|
+
|
|
14
|
+
## ๐ฆ Packages
|
|
15
|
+
|
|
16
|
+
### Apps
|
|
17
|
+
- **frontend** โ Next.js 14 + React 18 + Tailwind CSS
|
|
18
|
+
- Pages: Home, Products, Dashboard
|
|
19
|
+
- API client with JWT auth
|
|
20
|
+
- Server Components by default
|
|
21
|
+
|
|
22
|
+
- **backend** โ NestJS 10 + TypeORM + PostgreSQL
|
|
23
|
+
- Modules: Users, Products, Orders
|
|
24
|
+
- JWT authentication with Passport
|
|
25
|
+
- Global error handling
|
|
26
|
+
|
|
27
|
+
### Shared
|
|
28
|
+
- **shared-types** โ TypeScript interfaces for API contracts
|
|
29
|
+
- API DTOs (requests/responses)
|
|
30
|
+
- Domain entities
|
|
31
|
+
- Error types
|
|
32
|
+
|
|
33
|
+
- **shared-utils** โ Common utilities and helpers
|
|
34
|
+
- Validators (email, password, etc.)
|
|
35
|
+
- String utils (slugify, formatPrice, etc.)
|
|
36
|
+
- Math utils (calculations)
|
|
37
|
+
- Constants
|
|
38
|
+
|
|
39
|
+
## ๐ Quick Start
|
|
40
|
+
|
|
41
|
+
### Prerequisites
|
|
42
|
+
- Node.js 18+
|
|
43
|
+
- npm 9+
|
|
44
|
+
- Docker & Docker Compose (for database/redis)
|
|
45
|
+
|
|
46
|
+
### 1. Clone and Install
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
cd boilerplates/05-monorepo-starter
|
|
50
|
+
npm install
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### 2. Setup Database
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# Start PostgreSQL and Redis
|
|
57
|
+
docker-compose up -d
|
|
58
|
+
|
|
59
|
+
# Create .env file in backend
|
|
60
|
+
cp packages/apps/backend/.env.example packages/apps/backend/.env
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### 3. Run Development Mode
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# Start frontend + backend + watch mode (from root)
|
|
67
|
+
npm run dev
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
- Frontend: http://localhost:3000
|
|
71
|
+
- Backend: http://localhost:3001/api
|
|
72
|
+
- Health check: http://localhost:3001/api/health
|
|
73
|
+
|
|
74
|
+
## ๐ Project Structure
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
monorepo/
|
|
78
|
+
โโโ packages/
|
|
79
|
+
โ โโโ apps/
|
|
80
|
+
โ โ โโโ frontend/ # Next.js 14
|
|
81
|
+
โ โ โ โโโ app/ # App Router pages
|
|
82
|
+
โ โ โ โโโ components/ # React components
|
|
83
|
+
โ โ โ โโโ lib/ # API client, hooks
|
|
84
|
+
โ โ โ โโโ styles/ # Tailwind CSS
|
|
85
|
+
โ โ โโโ backend/ # NestJS 10
|
|
86
|
+
โ โ โโโ src/
|
|
87
|
+
โ โ โโโ modules/ # Users, Products, Orders
|
|
88
|
+
โ โ โโโ common/ # Guards, pipes, exceptions
|
|
89
|
+
โ โโโ packages/
|
|
90
|
+
โ โโโ shared-types/ # DTO & domain interfaces
|
|
91
|
+
โ โโโ shared-utils/ # Utilities & helpers
|
|
92
|
+
โโโ turbo.json # Turborepo configuration
|
|
93
|
+
โโโ tsconfig.json # Base TypeScript config
|
|
94
|
+
โโโ package.json # Workspace root
|
|
95
|
+
โโโ docker-compose.yml # PostgreSQL + Redis
|
|
96
|
+
โโโ Dockerfile # Multi-stage production build
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## ๐ง Commands
|
|
100
|
+
|
|
101
|
+
### Root Level
|
|
102
|
+
```bash
|
|
103
|
+
npm run dev # Start frontend + backend (watch mode)
|
|
104
|
+
npm run build # Build all packages
|
|
105
|
+
npm run test # Run tests
|
|
106
|
+
npm run lint # Lint all packages
|
|
107
|
+
npm run type-check # TypeScript type checking
|
|
108
|
+
npm run clean # Remove build artifacts
|
|
109
|
+
npm run format # Format code with Prettier
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Frontend
|
|
113
|
+
```bash
|
|
114
|
+
cd packages/apps/frontend
|
|
115
|
+
npm run dev # Start Next.js dev server
|
|
116
|
+
npm run build # Build for production
|
|
117
|
+
npm run start # Start production server
|
|
118
|
+
npm run lint # Lint code
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### Backend
|
|
122
|
+
```bash
|
|
123
|
+
cd packages/apps/backend
|
|
124
|
+
npm run dev # Start NestJS dev server (watch)
|
|
125
|
+
npm run build # Build for production
|
|
126
|
+
npm run start # Start production server
|
|
127
|
+
npm run test # Run tests
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### Shared Packages
|
|
131
|
+
```bash
|
|
132
|
+
cd packages/packages/shared-types
|
|
133
|
+
npm run build # Build TypeScript types
|
|
134
|
+
npm run type-check # Check types
|
|
135
|
+
|
|
136
|
+
cd packages/packages/shared-utils
|
|
137
|
+
npm run build # Build utilities
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
## ๐ Authentication
|
|
141
|
+
|
|
142
|
+
### JWT Flow
|
|
143
|
+
1. User registers โ Backend generates password hash
|
|
144
|
+
2. User logs in โ Backend returns JWT token
|
|
145
|
+
3. Frontend stores token in localStorage
|
|
146
|
+
4. Frontend sends token in `Authorization: Bearer <token>` header
|
|
147
|
+
5. Backend JwtGuard validates token on protected routes
|
|
148
|
+
|
|
149
|
+
### Environment Variables
|
|
150
|
+
Create `.env` files:
|
|
151
|
+
|
|
152
|
+
**Frontend** (`packages/apps/frontend/.env.local`):
|
|
153
|
+
```
|
|
154
|
+
NEXT_PUBLIC_API_URL=http://localhost:3001/api
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
**Backend** (`packages/apps/backend/.env`):
|
|
158
|
+
```
|
|
159
|
+
NODE_ENV=development
|
|
160
|
+
PORT=3001
|
|
161
|
+
DB_HOST=localhost
|
|
162
|
+
DB_PORT=5432
|
|
163
|
+
DB_USER=postgres
|
|
164
|
+
DB_PASSWORD=postgres
|
|
165
|
+
DB_NAME=monorepo
|
|
166
|
+
JWT_SECRET=super-secret-key-change-in-production
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## ๐ก API Endpoints
|
|
170
|
+
|
|
171
|
+
### Users
|
|
172
|
+
- `POST /api/users/register` โ Create account
|
|
173
|
+
- `POST /api/users/login` โ Login
|
|
174
|
+
- `GET /api/users/:id` โ Get profile (auth required)
|
|
175
|
+
|
|
176
|
+
### Products
|
|
177
|
+
- `GET /api/products` โ List products (paginated)
|
|
178
|
+
- `GET /api/products/:id` โ Get product details
|
|
179
|
+
- `POST /api/products` โ Create (auth required)
|
|
180
|
+
- `PUT /api/products/:id` โ Update (auth required)
|
|
181
|
+
- `DELETE /api/products/:id` โ Delete (auth required)
|
|
182
|
+
|
|
183
|
+
### Orders
|
|
184
|
+
- `POST /api/orders` โ Create order (auth required)
|
|
185
|
+
- `GET /api/orders` โ List user's orders (auth required)
|
|
186
|
+
- `GET /api/orders/:id` โ Get order details (auth required)
|
|
187
|
+
- `PATCH /api/orders/:id/status` โ Update status (auth required)
|
|
188
|
+
- `DELETE /api/orders/:id` โ Cancel order (auth required)
|
|
189
|
+
|
|
190
|
+
## ๐๏ธ Adding New Features
|
|
191
|
+
|
|
192
|
+
### Add a New Shared Type
|
|
193
|
+
```typescript
|
|
194
|
+
// packages/packages/shared-types/src/api/my-feature.ts
|
|
195
|
+
export interface MyFeatureRequest { ... }
|
|
196
|
+
export interface MyFeatureResponse { ... }
|
|
197
|
+
|
|
198
|
+
// packages/packages/shared-types/src/index.ts (add export)
|
|
199
|
+
export * from './api/my-feature';
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
### Add a New Backend Module
|
|
203
|
+
```bash
|
|
204
|
+
# Create module structure
|
|
205
|
+
mkdir -p packages/apps/backend/src/modules/my-module/{entities,dto}
|
|
206
|
+
|
|
207
|
+
# Create entity, service, controller, module
|
|
208
|
+
# Import in AppModule
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Add a New Frontend Page
|
|
212
|
+
```bash
|
|
213
|
+
# Create page directory
|
|
214
|
+
mkdir -p packages/apps/frontend/app/my-page
|
|
215
|
+
|
|
216
|
+
# Create page.tsx with 'use client' for interactivity
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
## ๐ณ Docker
|
|
220
|
+
|
|
221
|
+
### Run with Docker Compose
|
|
222
|
+
```bash
|
|
223
|
+
# Start services (postgres + redis)
|
|
224
|
+
docker-compose up -d
|
|
225
|
+
|
|
226
|
+
# Stop services
|
|
227
|
+
docker-compose down
|
|
228
|
+
|
|
229
|
+
# View logs
|
|
230
|
+
docker-compose logs -f
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
### Build Docker Image
|
|
234
|
+
```bash
|
|
235
|
+
docker build -t monorepo-starter .
|
|
236
|
+
docker run -p 3000:3000 -p 3001:3001 monorepo-starter
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
## ๐งช Testing
|
|
240
|
+
|
|
241
|
+
```bash
|
|
242
|
+
# Run all tests
|
|
243
|
+
npm run test
|
|
244
|
+
|
|
245
|
+
# Watch mode
|
|
246
|
+
npm run test:watch
|
|
247
|
+
|
|
248
|
+
# Specific package
|
|
249
|
+
npm run test --workspace=backend
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
## ๐ข Production Deployment
|
|
253
|
+
|
|
254
|
+
1. Set environment variables in production
|
|
255
|
+
2. Build: `npm run build`
|
|
256
|
+
3. Start: `npm run start`
|
|
257
|
+
4. Or use Docker: `docker build -t my-app . && docker run my-app`
|
|
258
|
+
|
|
259
|
+
## ๐ Tech Stack
|
|
260
|
+
|
|
261
|
+
| Layer | Technology | Version |
|
|
262
|
+
|-------|-----------|---------|
|
|
263
|
+
| **Frontend** | Next.js | 14+ |
|
|
264
|
+
| **Frontend UI** | React | 18+ |
|
|
265
|
+
| **Styling** | Tailwind CSS | 3+ |
|
|
266
|
+
| **Backend** | NestJS | 10+ |
|
|
267
|
+
| **Database ORM** | TypeORM | 0.3+ |
|
|
268
|
+
| **Database** | PostgreSQL | 16+ |
|
|
269
|
+
| **Cache** | Redis | 7+ |
|
|
270
|
+
| **Auth** | JWT + Passport | - |
|
|
271
|
+
| **Language** | TypeScript | 5.3+ |
|
|
272
|
+
| **Build** | Turborepo | 1.10+ |
|
|
273
|
+
| **Package Manager** | npm | 9+ |
|
|
274
|
+
|
|
275
|
+
## ๐ Documentation
|
|
276
|
+
|
|
277
|
+
- See `DEVELOPMENT.md` for detailed development guide
|
|
278
|
+
- See `memory/` for architecture decisions and domain documentation
|
|
279
|
+
- See individual `README.md` in each package
|
|
280
|
+
|
|
281
|
+
## ๐ค Contributing
|
|
282
|
+
|
|
283
|
+
1. Create feature branch
|
|
284
|
+
2. Make changes
|
|
285
|
+
3. Run tests and linting: `npm run test && npm run lint`
|
|
286
|
+
4. Type-check: `npm run type-check`
|
|
287
|
+
5. Create pull request
|
|
288
|
+
|
|
289
|
+
## ๐ License
|
|
290
|
+
|
|
291
|
+
MIT - Feel free to use this template for your projects!
|
|
292
|
+
|
|
293
|
+
## ๐ Troubleshooting
|
|
294
|
+
|
|
295
|
+
**Port already in use?**
|
|
296
|
+
```bash
|
|
297
|
+
# Change ports in .env files or run on different ports
|
|
298
|
+
PORT=3002 npm run dev
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
**TypeScript errors?**
|
|
302
|
+
```bash
|
|
303
|
+
# Rebuild types from shared packages
|
|
304
|
+
npm run build --workspace=shared-types
|
|
305
|
+
npm run build --workspace=shared-utils
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
**Database connection errors?**
|
|
309
|
+
```bash
|
|
310
|
+
# Ensure PostgreSQL is running
|
|
311
|
+
docker-compose up -d postgres
|
|
312
|
+
|
|
313
|
+
# Check connection string in .env
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
---
|
|
317
|
+
|
|
318
|
+
**Happy coding! ๐**
|