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,22 +1,22 @@
|
|
|
1
|
-
# Product Vision
|
|
2
|
-
|
|
3
|
-
## Core Value Proposition
|
|
4
|
-
A modern, scalable e-commerce platform built with a full-stack monorepo enabling rapid feature development and seamless collaboration between frontend and backend teams.
|
|
5
|
-
|
|
6
|
-
## Primary Features
|
|
7
|
-
1. **User Management** — Registration, authentication, profiles
|
|
8
|
-
2. **Product Catalog** — Browse, search, filter products
|
|
9
|
-
3. **Shopping Cart** — Add/remove items, cart persistence
|
|
10
|
-
4. **Orders** — Create orders, order history, tracking
|
|
11
|
-
5. **Dashboard** — Admin dashboard for analytics
|
|
12
|
-
|
|
13
|
-
## User Journey
|
|
14
|
-
```
|
|
15
|
-
Homepage → Browse Products → Add to Cart → Checkout → Order Confirmation → Dashboard
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
## Success Metrics
|
|
19
|
-
- Time to first feature deployment
|
|
20
|
-
- Type safety coverage (% of code with TS)
|
|
21
|
-
- Build time (Turborepo cache efficiency)
|
|
22
|
-
- Developer satisfaction (easy to add new features)
|
|
1
|
+
# Product Vision
|
|
2
|
+
|
|
3
|
+
## Core Value Proposition
|
|
4
|
+
A modern, scalable e-commerce platform built with a full-stack monorepo enabling rapid feature development and seamless collaboration between frontend and backend teams.
|
|
5
|
+
|
|
6
|
+
## Primary Features
|
|
7
|
+
1. **User Management** — Registration, authentication, profiles
|
|
8
|
+
2. **Product Catalog** — Browse, search, filter products
|
|
9
|
+
3. **Shopping Cart** — Add/remove items, cart persistence
|
|
10
|
+
4. **Orders** — Create orders, order history, tracking
|
|
11
|
+
5. **Dashboard** — Admin dashboard for analytics
|
|
12
|
+
|
|
13
|
+
## User Journey
|
|
14
|
+
```
|
|
15
|
+
Homepage → Browse Products → Add to Cart → Checkout → Order Confirmation → Dashboard
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Success Metrics
|
|
19
|
+
- Time to first feature deployment
|
|
20
|
+
- Type safety coverage (% of code with TS)
|
|
21
|
+
- Build time (Turborepo cache efficiency)
|
|
22
|
+
- Developer satisfaction (easy to add new features)
|
|
@@ -1,85 +1,85 @@
|
|
|
1
|
-
# Backend Architecture (NestJS)
|
|
2
|
-
|
|
3
|
-
## Directory Structure
|
|
4
|
-
```
|
|
5
|
-
apps/backend/
|
|
6
|
-
├── src/
|
|
7
|
-
│ ├── main.ts # Entry point
|
|
8
|
-
│ ├── app.module.ts # Root module
|
|
9
|
-
│ ├── common/
|
|
10
|
-
│ │ ├── guards/ # JWT, role guards
|
|
11
|
-
│ │ ├── interceptors/ # Response formatting
|
|
12
|
-
│ │ └── pipes/ # Validation pipes
|
|
13
|
-
│ ├── modules/
|
|
14
|
-
│ │ ├── users/
|
|
15
|
-
│ │ │ ├── users.controller.ts
|
|
16
|
-
│ │ │ ├── users.service.ts
|
|
17
|
-
│ │ │ ├── users.module.ts
|
|
18
|
-
│ │ │ ├── entities/user.entity.ts
|
|
19
|
-
│ │ │ └── dto/
|
|
20
|
-
│ │ ├── products/
|
|
21
|
-
│ │ │ └── (similar structure)
|
|
22
|
-
│ │ └── orders/
|
|
23
|
-
│ │ └── (similar structure)
|
|
24
|
-
│ ├── database/
|
|
25
|
-
│ │ ├── migrations/ # TypeORM migrations
|
|
26
|
-
│ │ └── config/ # Connection config
|
|
27
|
-
│ └── config/ # App configuration
|
|
28
|
-
├── test/
|
|
29
|
-
│ ├── unit/ # Unit tests
|
|
30
|
-
│ └── integration/ # Integration tests
|
|
31
|
-
├── .env.example
|
|
32
|
-
├── ormconfig.ts # TypeORM config
|
|
33
|
-
├── tsconfig.json
|
|
34
|
-
└── package.json
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Module Pattern
|
|
38
|
-
```typescript
|
|
39
|
-
// users.module.ts
|
|
40
|
-
@Module({
|
|
41
|
-
imports: [TypeOrmModule.forFeature([User])],
|
|
42
|
-
controllers: [UsersController],
|
|
43
|
-
providers: [UsersService],
|
|
44
|
-
})
|
|
45
|
-
export class UsersModule {}
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
## Key Features
|
|
49
|
-
- **JWT Authentication**: Passport + JWT strategy
|
|
50
|
-
- **TypeORM**: Strongly-typed ORM
|
|
51
|
-
- **Validation**: class-validator DTOs
|
|
52
|
-
- **Error Handling**: Global exception filter
|
|
53
|
-
- **Logging**: Built-in NestJS logger
|
|
54
|
-
|
|
55
|
-
## API Endpoints
|
|
56
|
-
|
|
57
|
-
### Users
|
|
58
|
-
- `POST /api/users/register` — Create user
|
|
59
|
-
- `POST /api/users/login` — Login
|
|
60
|
-
- `GET /api/users/:id` — Get user profile
|
|
61
|
-
|
|
62
|
-
### Products
|
|
63
|
-
- `GET /api/products` — List products (paginated)
|
|
64
|
-
- `GET /api/products/:id` — Get product details
|
|
65
|
-
- `POST /api/products` — Create (admin only)
|
|
66
|
-
|
|
67
|
-
### Orders
|
|
68
|
-
- `POST /api/orders` — Create order
|
|
69
|
-
- `GET /api/orders/:id` — Get order details
|
|
70
|
-
- `GET /api/orders` — List user's orders
|
|
71
|
-
|
|
72
|
-
## Response Format
|
|
73
|
-
```json
|
|
74
|
-
{
|
|
75
|
-
"success": true,
|
|
76
|
-
"data": { ... },
|
|
77
|
-
"message": "Success"
|
|
78
|
-
}
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
## Error Handling
|
|
82
|
-
```typescript
|
|
83
|
-
throw new NotFoundException('Product not found');
|
|
84
|
-
// Response: { statusCode: 404, message: 'Product not found' }
|
|
85
|
-
```
|
|
1
|
+
# Backend Architecture (NestJS)
|
|
2
|
+
|
|
3
|
+
## Directory Structure
|
|
4
|
+
```
|
|
5
|
+
apps/backend/
|
|
6
|
+
├── src/
|
|
7
|
+
│ ├── main.ts # Entry point
|
|
8
|
+
│ ├── app.module.ts # Root module
|
|
9
|
+
│ ├── common/
|
|
10
|
+
│ │ ├── guards/ # JWT, role guards
|
|
11
|
+
│ │ ├── interceptors/ # Response formatting
|
|
12
|
+
│ │ └── pipes/ # Validation pipes
|
|
13
|
+
│ ├── modules/
|
|
14
|
+
│ │ ├── users/
|
|
15
|
+
│ │ │ ├── users.controller.ts
|
|
16
|
+
│ │ │ ├── users.service.ts
|
|
17
|
+
│ │ │ ├── users.module.ts
|
|
18
|
+
│ │ │ ├── entities/user.entity.ts
|
|
19
|
+
│ │ │ └── dto/
|
|
20
|
+
│ │ ├── products/
|
|
21
|
+
│ │ │ └── (similar structure)
|
|
22
|
+
│ │ └── orders/
|
|
23
|
+
│ │ └── (similar structure)
|
|
24
|
+
│ ├── database/
|
|
25
|
+
│ │ ├── migrations/ # TypeORM migrations
|
|
26
|
+
│ │ └── config/ # Connection config
|
|
27
|
+
│ └── config/ # App configuration
|
|
28
|
+
├── test/
|
|
29
|
+
│ ├── unit/ # Unit tests
|
|
30
|
+
│ └── integration/ # Integration tests
|
|
31
|
+
├── .env.example
|
|
32
|
+
├── ormconfig.ts # TypeORM config
|
|
33
|
+
├── tsconfig.json
|
|
34
|
+
└── package.json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Module Pattern
|
|
38
|
+
```typescript
|
|
39
|
+
// users.module.ts
|
|
40
|
+
@Module({
|
|
41
|
+
imports: [TypeOrmModule.forFeature([User])],
|
|
42
|
+
controllers: [UsersController],
|
|
43
|
+
providers: [UsersService],
|
|
44
|
+
})
|
|
45
|
+
export class UsersModule {}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## Key Features
|
|
49
|
+
- **JWT Authentication**: Passport + JWT strategy
|
|
50
|
+
- **TypeORM**: Strongly-typed ORM
|
|
51
|
+
- **Validation**: class-validator DTOs
|
|
52
|
+
- **Error Handling**: Global exception filter
|
|
53
|
+
- **Logging**: Built-in NestJS logger
|
|
54
|
+
|
|
55
|
+
## API Endpoints
|
|
56
|
+
|
|
57
|
+
### Users
|
|
58
|
+
- `POST /api/users/register` — Create user
|
|
59
|
+
- `POST /api/users/login` — Login
|
|
60
|
+
- `GET /api/users/:id` — Get user profile
|
|
61
|
+
|
|
62
|
+
### Products
|
|
63
|
+
- `GET /api/products` — List products (paginated)
|
|
64
|
+
- `GET /api/products/:id` — Get product details
|
|
65
|
+
- `POST /api/products` — Create (admin only)
|
|
66
|
+
|
|
67
|
+
### Orders
|
|
68
|
+
- `POST /api/orders` — Create order
|
|
69
|
+
- `GET /api/orders/:id` — Get order details
|
|
70
|
+
- `GET /api/orders` — List user's orders
|
|
71
|
+
|
|
72
|
+
## Response Format
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"success": true,
|
|
76
|
+
"data": { ... },
|
|
77
|
+
"message": "Success"
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Error Handling
|
|
82
|
+
```typescript
|
|
83
|
+
throw new NotFoundException('Product not found');
|
|
84
|
+
// Response: { statusCode: 404, message: 'Product not found' }
|
|
85
|
+
```
|
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
# Data Architecture
|
|
2
|
-
|
|
3
|
-
## Database Schema
|
|
4
|
-
|
|
5
|
-
### Users Table
|
|
6
|
-
```sql
|
|
7
|
-
CREATE TABLE users (
|
|
8
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
9
|
-
email VARCHAR(255) UNIQUE NOT NULL,
|
|
10
|
-
password_hash VARCHAR(255) NOT NULL,
|
|
11
|
-
first_name VARCHAR(100),
|
|
12
|
-
last_name VARCHAR(100),
|
|
13
|
-
role ENUM('user', 'admin') DEFAULT 'user',
|
|
14
|
-
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
15
|
-
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
16
|
-
);
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
### Products Table
|
|
20
|
-
```sql
|
|
21
|
-
CREATE TABLE products (
|
|
22
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
23
|
-
sku VARCHAR(50) UNIQUE NOT NULL,
|
|
24
|
-
name VARCHAR(255) NOT NULL,
|
|
25
|
-
description TEXT,
|
|
26
|
-
price DECIMAL(10, 2) NOT NULL,
|
|
27
|
-
stock_quantity INT DEFAULT 0,
|
|
28
|
-
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
29
|
-
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
30
|
-
);
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### Orders Table
|
|
34
|
-
```sql
|
|
35
|
-
CREATE TABLE orders (
|
|
36
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
37
|
-
user_id UUID NOT NULL REFERENCES users(id),
|
|
38
|
-
status ENUM('pending', 'processing', 'shipped', 'delivered') DEFAULT 'pending',
|
|
39
|
-
total_amount DECIMAL(10, 2) NOT NULL,
|
|
40
|
-
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
41
|
-
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
42
|
-
);
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Order Items Table
|
|
46
|
-
```sql
|
|
47
|
-
CREATE TABLE order_items (
|
|
48
|
-
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
49
|
-
order_id UUID NOT NULL REFERENCES orders(id),
|
|
50
|
-
product_id UUID NOT NULL REFERENCES products(id),
|
|
51
|
-
quantity INT NOT NULL,
|
|
52
|
-
unit_price DECIMAL(10, 2) NOT NULL,
|
|
53
|
-
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
54
|
-
);
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
## Indexes
|
|
58
|
-
- `users.email` — UNIQUE (fast login)
|
|
59
|
-
- `products.sku` — UNIQUE (fast lookup)
|
|
60
|
-
- `orders.user_id` — (fast order history)
|
|
61
|
-
- `order_items.order_id` — (fast order details)
|
|
62
|
-
|
|
63
|
-
## Caching Strategy
|
|
64
|
-
- Redis TTL: 5 minutes for product catalog
|
|
65
|
-
- Cache invalidation: On product create/update
|
|
66
|
-
- Session tokens: Cached with expiry
|
|
1
|
+
# Data Architecture
|
|
2
|
+
|
|
3
|
+
## Database Schema
|
|
4
|
+
|
|
5
|
+
### Users Table
|
|
6
|
+
```sql
|
|
7
|
+
CREATE TABLE users (
|
|
8
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
9
|
+
email VARCHAR(255) UNIQUE NOT NULL,
|
|
10
|
+
password_hash VARCHAR(255) NOT NULL,
|
|
11
|
+
first_name VARCHAR(100),
|
|
12
|
+
last_name VARCHAR(100),
|
|
13
|
+
role ENUM('user', 'admin') DEFAULT 'user',
|
|
14
|
+
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
15
|
+
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
16
|
+
);
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Products Table
|
|
20
|
+
```sql
|
|
21
|
+
CREATE TABLE products (
|
|
22
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
23
|
+
sku VARCHAR(50) UNIQUE NOT NULL,
|
|
24
|
+
name VARCHAR(255) NOT NULL,
|
|
25
|
+
description TEXT,
|
|
26
|
+
price DECIMAL(10, 2) NOT NULL,
|
|
27
|
+
stock_quantity INT DEFAULT 0,
|
|
28
|
+
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
29
|
+
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
30
|
+
);
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Orders Table
|
|
34
|
+
```sql
|
|
35
|
+
CREATE TABLE orders (
|
|
36
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
37
|
+
user_id UUID NOT NULL REFERENCES users(id),
|
|
38
|
+
status ENUM('pending', 'processing', 'shipped', 'delivered') DEFAULT 'pending',
|
|
39
|
+
total_amount DECIMAL(10, 2) NOT NULL,
|
|
40
|
+
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
41
|
+
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
42
|
+
);
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Order Items Table
|
|
46
|
+
```sql
|
|
47
|
+
CREATE TABLE order_items (
|
|
48
|
+
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
49
|
+
order_id UUID NOT NULL REFERENCES orders(id),
|
|
50
|
+
product_id UUID NOT NULL REFERENCES products(id),
|
|
51
|
+
quantity INT NOT NULL,
|
|
52
|
+
unit_price DECIMAL(10, 2) NOT NULL,
|
|
53
|
+
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
54
|
+
);
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Indexes
|
|
58
|
+
- `users.email` — UNIQUE (fast login)
|
|
59
|
+
- `products.sku` — UNIQUE (fast lookup)
|
|
60
|
+
- `orders.user_id` — (fast order history)
|
|
61
|
+
- `order_items.order_id` — (fast order details)
|
|
62
|
+
|
|
63
|
+
## Caching Strategy
|
|
64
|
+
- Redis TTL: 5 minutes for product catalog
|
|
65
|
+
- Cache invalidation: On product create/update
|
|
66
|
+
- Session tokens: Cached with expiry
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
# Frontend Architecture (Next.js)
|
|
2
|
-
|
|
3
|
-
## Directory Structure
|
|
4
|
-
```
|
|
5
|
-
apps/frontend/
|
|
6
|
-
├── app/ # Next.js 14 App Router
|
|
7
|
-
│ ├── layout.tsx # Root layout
|
|
8
|
-
│ ├── page.tsx # Home page
|
|
9
|
-
│ ├── products/ # Products page
|
|
10
|
-
│ └── dashboard/ # Admin dashboard
|
|
11
|
-
├── components/
|
|
12
|
-
│ ├── ui/ # Reusable UI components
|
|
13
|
-
│ ├── features/ # Feature-specific components
|
|
14
|
-
│ └── layout/ # Header, footer, sidebar
|
|
15
|
-
├── lib/
|
|
16
|
-
│ ├── api-client.ts # Axios instance
|
|
17
|
-
│ ├── hooks/ # Custom React hooks
|
|
18
|
-
│ └── utils/ # Helper functions
|
|
19
|
-
├── public/ # Static assets
|
|
20
|
-
├── styles/ # Global CSS
|
|
21
|
-
├── .env.local # Local environment variables
|
|
22
|
-
├── next.config.js # Next.js config
|
|
23
|
-
├── tsconfig.json # TypeScript config
|
|
24
|
-
└── package.json
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## Key Features
|
|
28
|
-
- **Server Components**: Use by default for performance
|
|
29
|
-
- **API Routes**: Not used (Backend is separate NestJS)
|
|
30
|
-
- **Image Optimization**: Next.js Image component
|
|
31
|
-
- **Styling**: Tailwind CSS + CSS Modules
|
|
32
|
-
|
|
33
|
-
## API Communication
|
|
34
|
-
```typescript
|
|
35
|
-
// lib/api-client.ts
|
|
36
|
-
export const apiClient = axios.create({
|
|
37
|
-
baseURL: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3001/api',
|
|
38
|
-
});
|
|
39
|
-
|
|
40
|
-
// Auto-attach JWT token to requests
|
|
41
|
-
apiClient.interceptors.request.use((config) => {
|
|
42
|
-
const token = localStorage.getItem('jwt');
|
|
43
|
-
if (token) {
|
|
44
|
-
config.headers.Authorization = `Bearer ${token}`;
|
|
45
|
-
}
|
|
46
|
-
return config;
|
|
47
|
-
});
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
## Pages
|
|
51
|
-
1. **Home** (`/`) — Landing page with featured products
|
|
52
|
-
2. **Products** (`/products`) — Product catalog with filtering
|
|
53
|
-
3. **Dashboard** (`/dashboard`) — Admin analytics (admin-only)
|
|
54
|
-
|
|
55
|
-
## State Management
|
|
56
|
-
- React Context for auth state
|
|
57
|
-
- useQuery (React Query) for API data fetching
|
|
58
|
-
- localStorage for JWT token persistence
|
|
1
|
+
# Frontend Architecture (Next.js)
|
|
2
|
+
|
|
3
|
+
## Directory Structure
|
|
4
|
+
```
|
|
5
|
+
apps/frontend/
|
|
6
|
+
├── app/ # Next.js 14 App Router
|
|
7
|
+
│ ├── layout.tsx # Root layout
|
|
8
|
+
│ ├── page.tsx # Home page
|
|
9
|
+
│ ├── products/ # Products page
|
|
10
|
+
│ └── dashboard/ # Admin dashboard
|
|
11
|
+
├── components/
|
|
12
|
+
│ ├── ui/ # Reusable UI components
|
|
13
|
+
│ ├── features/ # Feature-specific components
|
|
14
|
+
│ └── layout/ # Header, footer, sidebar
|
|
15
|
+
├── lib/
|
|
16
|
+
│ ├── api-client.ts # Axios instance
|
|
17
|
+
│ ├── hooks/ # Custom React hooks
|
|
18
|
+
│ └── utils/ # Helper functions
|
|
19
|
+
├── public/ # Static assets
|
|
20
|
+
├── styles/ # Global CSS
|
|
21
|
+
├── .env.local # Local environment variables
|
|
22
|
+
├── next.config.js # Next.js config
|
|
23
|
+
├── tsconfig.json # TypeScript config
|
|
24
|
+
└── package.json
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Key Features
|
|
28
|
+
- **Server Components**: Use by default for performance
|
|
29
|
+
- **API Routes**: Not used (Backend is separate NestJS)
|
|
30
|
+
- **Image Optimization**: Next.js Image component
|
|
31
|
+
- **Styling**: Tailwind CSS + CSS Modules
|
|
32
|
+
|
|
33
|
+
## API Communication
|
|
34
|
+
```typescript
|
|
35
|
+
// lib/api-client.ts
|
|
36
|
+
export const apiClient = axios.create({
|
|
37
|
+
baseURL: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3001/api',
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
// Auto-attach JWT token to requests
|
|
41
|
+
apiClient.interceptors.request.use((config) => {
|
|
42
|
+
const token = localStorage.getItem('jwt');
|
|
43
|
+
if (token) {
|
|
44
|
+
config.headers.Authorization = `Bearer ${token}`;
|
|
45
|
+
}
|
|
46
|
+
return config;
|
|
47
|
+
});
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Pages
|
|
51
|
+
1. **Home** (`/`) — Landing page with featured products
|
|
52
|
+
2. **Products** (`/products`) — Product catalog with filtering
|
|
53
|
+
3. **Dashboard** (`/dashboard`) — Admin analytics (admin-only)
|
|
54
|
+
|
|
55
|
+
## State Management
|
|
56
|
+
- React Context for auth state
|
|
57
|
+
- useQuery (React Query) for API data fetching
|
|
58
|
+
- localStorage for JWT token persistence
|
|
@@ -1,86 +1,86 @@
|
|
|
1
|
-
# Architecture Overview
|
|
2
|
-
|
|
3
|
-
## Tech Stack
|
|
4
|
-
|
|
5
|
-
### Frontend
|
|
6
|
-
- **Framework**: Next.js 14+ (React 18+)
|
|
7
|
-
- **Language**: TypeScript
|
|
8
|
-
- **Styling**: Tailwind CSS
|
|
9
|
-
- **State**: React hooks + Context API
|
|
10
|
-
- **HTTP Client**: Axios
|
|
11
|
-
- **UI Components**: shadcn/ui
|
|
12
|
-
|
|
13
|
-
### Backend
|
|
14
|
-
- **Framework**: NestJS 10+
|
|
15
|
-
- **Language**: TypeScript
|
|
16
|
-
- **ORM**: TypeORM
|
|
17
|
-
- **Database**: PostgreSQL
|
|
18
|
-
- **Cache**: Redis
|
|
19
|
-
- **Auth**: JWT + Passport
|
|
20
|
-
|
|
21
|
-
### Shared
|
|
22
|
-
- **Shared Types**: TypeScript interfaces (no dependencies)
|
|
23
|
-
- **Shared Utils**: Helpers, validators, constants
|
|
24
|
-
|
|
25
|
-
### DevOps
|
|
26
|
-
- **Build System**: Turborepo
|
|
27
|
-
- **Containerization**: Docker
|
|
28
|
-
- **Orchestration**: Docker Compose
|
|
29
|
-
- **CI/CD**: GitHub Actions ready
|
|
30
|
-
|
|
31
|
-
## Architecture Diagram
|
|
32
|
-
```
|
|
33
|
-
┌─────────────────┐
|
|
34
|
-
│ Browser │
|
|
35
|
-
└────────┬────────┘
|
|
36
|
-
│ HTTP/HTTPS
|
|
37
|
-
┌────────▼────────────────────────┐
|
|
38
|
-
│ Next.js Frontend (Port 3000) │
|
|
39
|
-
├──────────────────────────────────┤
|
|
40
|
-
│ • Pages (App Router) │
|
|
41
|
-
│ • Components │
|
|
42
|
-
│ • API Client │
|
|
43
|
-
│ • Auth (JWT in localStorage) │
|
|
44
|
-
└────────┬────────────────────────┘
|
|
45
|
-
│ API calls
|
|
46
|
-
┌────────▼────────────────────────┐
|
|
47
|
-
│ NestJS Backend (Port 3001) │
|
|
48
|
-
├──────────────────────────────────┤
|
|
49
|
-
│ • Controllers │
|
|
50
|
-
│ • Services (business logic) │
|
|
51
|
-
│ • Guards (JWT validation) │
|
|
52
|
-
│ • TypeORM Entities │
|
|
53
|
-
└────────┬────────────────────────┘
|
|
54
|
-
│ SQL
|
|
55
|
-
┌────────▼────────────────────────┐
|
|
56
|
-
│ PostgreSQL (Port 5432) │
|
|
57
|
-
│ + Redis (Port 6379) │
|
|
58
|
-
└─────────────────────────────────┘
|
|
59
|
-
|
|
60
|
-
Shared:
|
|
61
|
-
┌─────────────────────────────────┐
|
|
62
|
-
│ shared-types (API contracts) │
|
|
63
|
-
│ shared-utils (utilities) │
|
|
64
|
-
└─────────────────────────────────┘
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## Monorepo Structure
|
|
68
|
-
```
|
|
69
|
-
packages/
|
|
70
|
-
├── apps/
|
|
71
|
-
│ ├── frontend/ # Next.js 14
|
|
72
|
-
│ └── backend/ # NestJS 10
|
|
73
|
-
└── packages/
|
|
74
|
-
├── shared-types/ # DTOs, interfaces
|
|
75
|
-
└── shared-utils/ # Helpers, constants
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
## Build Pipeline
|
|
79
|
-
```
|
|
80
|
-
npm run build
|
|
81
|
-
├── shared-types (no dependencies)
|
|
82
|
-
├── shared-utils (depends on shared-types)
|
|
83
|
-
├── frontend (depends on shared-types, shared-utils)
|
|
84
|
-
└── backend (depends on shared-types, shared-utils)
|
|
85
|
-
```
|
|
86
|
-
Turborepo executes in parallel where possible.
|
|
1
|
+
# Architecture Overview
|
|
2
|
+
|
|
3
|
+
## Tech Stack
|
|
4
|
+
|
|
5
|
+
### Frontend
|
|
6
|
+
- **Framework**: Next.js 14+ (React 18+)
|
|
7
|
+
- **Language**: TypeScript
|
|
8
|
+
- **Styling**: Tailwind CSS
|
|
9
|
+
- **State**: React hooks + Context API
|
|
10
|
+
- **HTTP Client**: Axios
|
|
11
|
+
- **UI Components**: shadcn/ui
|
|
12
|
+
|
|
13
|
+
### Backend
|
|
14
|
+
- **Framework**: NestJS 10+
|
|
15
|
+
- **Language**: TypeScript
|
|
16
|
+
- **ORM**: TypeORM
|
|
17
|
+
- **Database**: PostgreSQL
|
|
18
|
+
- **Cache**: Redis
|
|
19
|
+
- **Auth**: JWT + Passport
|
|
20
|
+
|
|
21
|
+
### Shared
|
|
22
|
+
- **Shared Types**: TypeScript interfaces (no dependencies)
|
|
23
|
+
- **Shared Utils**: Helpers, validators, constants
|
|
24
|
+
|
|
25
|
+
### DevOps
|
|
26
|
+
- **Build System**: Turborepo
|
|
27
|
+
- **Containerization**: Docker
|
|
28
|
+
- **Orchestration**: Docker Compose
|
|
29
|
+
- **CI/CD**: GitHub Actions ready
|
|
30
|
+
|
|
31
|
+
## Architecture Diagram
|
|
32
|
+
```
|
|
33
|
+
┌─────────────────┐
|
|
34
|
+
│ Browser │
|
|
35
|
+
└────────┬────────┘
|
|
36
|
+
│ HTTP/HTTPS
|
|
37
|
+
┌────────▼────────────────────────┐
|
|
38
|
+
│ Next.js Frontend (Port 3000) │
|
|
39
|
+
├──────────────────────────────────┤
|
|
40
|
+
│ • Pages (App Router) │
|
|
41
|
+
│ • Components │
|
|
42
|
+
│ • API Client │
|
|
43
|
+
│ • Auth (JWT in localStorage) │
|
|
44
|
+
└────────┬────────────────────────┘
|
|
45
|
+
│ API calls
|
|
46
|
+
┌────────▼────────────────────────┐
|
|
47
|
+
│ NestJS Backend (Port 3001) │
|
|
48
|
+
├──────────────────────────────────┤
|
|
49
|
+
│ • Controllers │
|
|
50
|
+
│ • Services (business logic) │
|
|
51
|
+
│ • Guards (JWT validation) │
|
|
52
|
+
│ • TypeORM Entities │
|
|
53
|
+
└────────┬────────────────────────┘
|
|
54
|
+
│ SQL
|
|
55
|
+
┌────────▼────────────────────────┐
|
|
56
|
+
│ PostgreSQL (Port 5432) │
|
|
57
|
+
│ + Redis (Port 6379) │
|
|
58
|
+
└─────────────────────────────────┘
|
|
59
|
+
|
|
60
|
+
Shared:
|
|
61
|
+
┌─────────────────────────────────┐
|
|
62
|
+
│ shared-types (API contracts) │
|
|
63
|
+
│ shared-utils (utilities) │
|
|
64
|
+
└─────────────────────────────────┘
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Monorepo Structure
|
|
68
|
+
```
|
|
69
|
+
packages/
|
|
70
|
+
├── apps/
|
|
71
|
+
│ ├── frontend/ # Next.js 14
|
|
72
|
+
│ └── backend/ # NestJS 10
|
|
73
|
+
└── packages/
|
|
74
|
+
├── shared-types/ # DTOs, interfaces
|
|
75
|
+
└── shared-utils/ # Helpers, constants
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Build Pipeline
|
|
79
|
+
```
|
|
80
|
+
npm run build
|
|
81
|
+
├── shared-types (no dependencies)
|
|
82
|
+
├── shared-utils (depends on shared-types)
|
|
83
|
+
├── frontend (depends on shared-types, shared-utils)
|
|
84
|
+
└── backend (depends on shared-types, shared-utils)
|
|
85
|
+
```
|
|
86
|
+
Turborepo executes in parallel where possible.
|