forjajs 1.1.6 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.json +7 -7
- package/CHANGELOG.md +62 -0
- package/README.en.md +33 -5
- package/README.md +35 -4
- package/boilerplates/06-clean-arch/README.md +48 -0
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
- package/boilerplates/06-clean-arch/backend/package.json +43 -0
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
- package/boilerplates/README.md +20 -0
- package/dist/bin/create-memory-nest-kit.d.ts +2 -0
- package/dist/bin/create-memory-nest-kit.js +110 -0
- package/dist/bin/forja.d.ts +13 -0
- package/dist/bin/forja.js +136 -0
- package/dist/bin/init-project.d.ts +2 -0
- package/dist/bin/init-project.js +516 -0
- package/dist/lib/audit.d.ts +67 -0
- package/dist/lib/audit.js +143 -0
- package/dist/lib/context-builder.d.ts +58 -0
- package/dist/lib/context-builder.js +233 -0
- package/dist/lib/core/checks.d.ts +91 -0
- package/dist/lib/core/checks.js +119 -0
- package/dist/lib/core/doc-graph.d.ts +60 -0
- package/dist/lib/core/doc-graph.js +235 -0
- package/dist/lib/core/health.d.ts +103 -0
- package/dist/lib/core/health.js +538 -0
- package/dist/lib/core/registry.d.ts +296 -0
- package/dist/lib/core/registry.js +317 -0
- package/dist/lib/core/release.d.ts +334 -0
- package/dist/lib/core/release.js +465 -0
- package/dist/lib/generators/memory-generator.d.ts +83 -0
- package/{lib → dist/lib}/generators/memory-generator.js +107 -178
- package/dist/lib/generators/nest-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/nest-generator.js +47 -71
- package/dist/lib/generators/readme-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/readme-generator.js +9 -14
- package/dist/lib/governance-report.d.ts +49 -0
- package/dist/lib/governance-report.js +170 -0
- package/dist/lib/templates/harness/code-intel.d.mts +2 -0
- package/dist/lib/templates/harness/code-intel.mjs +126 -0
- package/dist/lib/utils/file-helpers.d.ts +9 -0
- package/dist/lib/utils/file-helpers.js +34 -0
- package/dist/lib/validators/structure-validator.d.ts +48 -0
- package/dist/lib/validators/structure-validator.js +232 -0
- package/dist/lib/workspace.d.ts +40 -0
- package/dist/lib/workspace.js +174 -0
- package/dist/scripts/agent-harness.d.ts +2 -0
- package/dist/scripts/agent-harness.js +556 -0
- package/dist/scripts/agent-router.d.ts +30 -0
- package/dist/scripts/agent-router.js +208 -0
- package/dist/scripts/audit-query.d.ts +2 -0
- package/dist/scripts/audit-query.js +43 -0
- package/dist/scripts/audit-sync.d.ts +2 -0
- package/dist/scripts/audit-sync.js +19 -0
- package/dist/scripts/build-smart-context.d.ts +1 -0
- package/dist/scripts/build-smart-context.js +75 -0
- package/dist/scripts/check-standards.d.ts +1 -0
- package/dist/scripts/check-standards.js +87 -0
- package/dist/scripts/compress-memory.d.ts +16 -0
- package/dist/scripts/compress-memory.js +157 -0
- package/dist/scripts/compress-project-memory.d.ts +1 -0
- package/dist/scripts/compress-project-memory.js +48 -0
- package/dist/scripts/context-ops.d.ts +2 -0
- package/dist/scripts/context-ops.js +464 -0
- package/dist/scripts/dev.d.ts +96 -0
- package/dist/scripts/dev.js +312 -0
- package/dist/scripts/extract-global-knowledge.d.ts +1 -0
- package/dist/scripts/extract-global-knowledge.js +43 -0
- package/dist/scripts/generate-dashboard.d.ts +1 -0
- package/dist/scripts/generate-dashboard.js +48 -0
- package/dist/scripts/governance-dashboard.d.ts +2 -0
- package/dist/scripts/governance-dashboard.js +36 -0
- package/dist/scripts/hook-guard-paths.d.ts +17 -0
- package/dist/scripts/hook-guard-paths.js +68 -0
- package/dist/scripts/hook-post-edit.d.ts +20 -0
- package/dist/scripts/hook-post-edit.js +70 -0
- package/dist/scripts/hook-session-start.d.ts +17 -0
- package/dist/scripts/hook-session-start.js +108 -0
- package/dist/scripts/hook-user-prompt.d.ts +22 -0
- package/dist/scripts/hook-user-prompt.js +193 -0
- package/dist/scripts/memory-schema.d.ts +6 -0
- package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
- package/dist/scripts/query-universal-memory.d.ts +1 -0
- package/dist/scripts/query-universal-memory.js +44 -0
- package/dist/scripts/release-check.d.ts +14 -0
- package/dist/scripts/release-check.js +48 -0
- package/dist/scripts/spec-cli.d.ts +29 -0
- package/dist/scripts/spec-cli.js +261 -0
- package/dist/scripts/sprint-manager.d.ts +1 -0
- package/dist/scripts/sprint-manager.js +187 -0
- package/dist/scripts/sync-universal-memory.d.ts +1 -0
- package/dist/scripts/sync-universal-memory.js +277 -0
- package/dist/scripts/token-benchmark.d.ts +20 -0
- package/dist/scripts/token-benchmark.js +181 -0
- package/dist/scripts/tools-doctor.d.ts +20 -0
- package/dist/scripts/tools-doctor.js +120 -0
- package/docs/personas/architect/README.md +4 -4
- package/docs/personas/developer/README.md +3 -3
- package/docs/personas/qa/README.md +3 -3
- package/docs/quick-reference.md +9 -9
- package/docs/structure.md +3 -3
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
- package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
- package/memory/90-decisions/0028-governanca-visivel.md +84 -0
- package/package.json +60 -56
- package/specs/clean-arch-boilerplate/plan.md +137 -0
- package/specs/clean-arch-boilerplate/spec.md +121 -0
- package/specs/clean-arch-boilerplate/tasks.md +70 -0
- package/specs/coerencia-do-sistema/plan.md +155 -0
- package/specs/coerencia-do-sistema/spec.md +15 -14
- package/specs/coerencia-do-sistema/tasks.md +115 -0
- package/specs/governanca-visivel/plan.md +122 -0
- package/specs/governanca-visivel/spec.md +112 -0
- package/specs/governanca-visivel/tasks.md +60 -0
- package/specs/ts-migration/plan.md +199 -0
- package/specs/ts-migration/spec.md +119 -0
- package/specs/ts-migration/tasks.md +110 -0
- package/bin/create-memory-nest-kit.js +0 -125
- package/bin/forja.mjs +0 -143
- package/bin/init-project.js +0 -612
- package/lib/context-builder.js +0 -257
- package/lib/core/checks.mjs +0 -138
- package/lib/core/health.mjs +0 -475
- package/lib/core/registry.mjs +0 -289
- package/lib/core/release.mjs +0 -452
- package/lib/templates/harness/code-intel.mjs +0 -119
- package/lib/templates/harness/mcp.json +0 -10
- package/lib/utils/file-helpers.js +0 -40
- package/lib/validators/structure-validator.js +0 -253
- package/lib/workspace.mjs +0 -213
- package/scripts/agent-harness.mjs +0 -578
- package/scripts/agent-router.mjs +0 -189
- package/scripts/build-smart-context.js +0 -87
- package/scripts/check-standards.js +0 -98
- package/scripts/compress-memory.mjs +0 -198
- package/scripts/compress-project-memory.js +0 -58
- package/scripts/context-ops.mjs +0 -463
- package/scripts/dev.mjs +0 -349
- package/scripts/extract-global-knowledge.js +0 -52
- package/scripts/generate-dashboard.js +0 -59
- package/scripts/hook-guard-paths.mjs +0 -75
- package/scripts/hook-post-edit.mjs +0 -79
- package/scripts/hook-session-start.mjs +0 -104
- package/scripts/hook-user-prompt.mjs +0 -185
- package/scripts/pre-commit.sh +0 -102
- package/scripts/query-universal-memory.js +0 -50
- package/scripts/release-check.mjs +0 -56
- package/scripts/spec-cli.mjs +0 -260
- package/scripts/sprint-manager.js +0 -200
- package/scripts/sync-universal-memory.js +0 -286
- package/scripts/token-benchmark.mjs +0 -203
- package/scripts/tools-doctor.mjs +0 -132
package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { Column, Entity, PrimaryColumn } from 'typeorm';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* OrderOrmEntity — a forma de PERSISTÊNCIA, decorada com TypeORM. Vive só na infraestrutura.
|
|
5
|
+
*
|
|
6
|
+
* Repare: **não é** o `Order` do domínio. O agregado de domínio é TypeScript puro, sem `@Entity`. O
|
|
7
|
+
* mapper (no repositório) traduz entre os dois. É essa separação que mantém o ORM fora do domínio —
|
|
8
|
+
* trocar o TypeORM por outra coisa mexe só aqui.
|
|
9
|
+
*/
|
|
10
|
+
@Entity('orders')
|
|
11
|
+
export class OrderOrmEntity {
|
|
12
|
+
@PrimaryColumn('uuid')
|
|
13
|
+
id!: string;
|
|
14
|
+
|
|
15
|
+
@Column()
|
|
16
|
+
customerId!: string;
|
|
17
|
+
|
|
18
|
+
@Column()
|
|
19
|
+
status!: string;
|
|
20
|
+
|
|
21
|
+
/** Linhas serializadas — detalhe de persistência, não modelagem de domínio. */
|
|
22
|
+
@Column('jsonb')
|
|
23
|
+
lines!: Array<{ productId: string; unitPriceCents: number; quantity: number }>;
|
|
24
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { Injectable } from '@nestjs/common';
|
|
2
|
+
import { InjectRepository } from '@nestjs/typeorm';
|
|
3
|
+
import { Repository } from 'typeorm';
|
|
4
|
+
import { Order, OrderLine } from '../domain/order.entity';
|
|
5
|
+
import { Money } from '../domain/money.vo';
|
|
6
|
+
import { OrderStatus, OrderStatusValue } from '../domain/order-status.vo';
|
|
7
|
+
import { OrderRepository } from '../domain/order.repository';
|
|
8
|
+
import { OrderOrmEntity } from './order.orm-entity';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* O ADAPTER: implementa a porta `OrderRepository` do domínio usando TypeORM. É o único lugar que
|
|
12
|
+
* conhece o ORM. O **mapper** (toDomain/toOrm) traduz entre o agregado puro e a orm-entity — a
|
|
13
|
+
* fronteira que impede o TypeORM de vazar para dentro.
|
|
14
|
+
*/
|
|
15
|
+
@Injectable()
|
|
16
|
+
export class TypeOrmOrderRepository implements OrderRepository {
|
|
17
|
+
constructor(
|
|
18
|
+
@InjectRepository(OrderOrmEntity)
|
|
19
|
+
private readonly repo: Repository<OrderOrmEntity>,
|
|
20
|
+
) {}
|
|
21
|
+
|
|
22
|
+
async save(order: Order): Promise<void> {
|
|
23
|
+
await this.repo.save(this.toOrm(order));
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
async byId(id: string): Promise<Order | null> {
|
|
27
|
+
const row = await this.repo.findOne({ where: { id } });
|
|
28
|
+
return row ? this.toDomain(row) : null;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
private toOrm(order: Order): OrderOrmEntity {
|
|
32
|
+
const row = new OrderOrmEntity();
|
|
33
|
+
row.id = order.id;
|
|
34
|
+
row.customerId = order.customerId;
|
|
35
|
+
row.status = order.status.value;
|
|
36
|
+
row.lines = order.lines.map((l) => ({
|
|
37
|
+
productId: l.productId,
|
|
38
|
+
unitPriceCents: l.unitPrice.cents,
|
|
39
|
+
quantity: l.quantity,
|
|
40
|
+
}));
|
|
41
|
+
return row;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
private toDomain(row: OrderOrmEntity): Order {
|
|
45
|
+
const lines: OrderLine[] = row.lines.map((l) => ({
|
|
46
|
+
productId: l.productId,
|
|
47
|
+
unitPrice: Money.of(l.unitPriceCents),
|
|
48
|
+
quantity: l.quantity,
|
|
49
|
+
}));
|
|
50
|
+
return Order.rehydrate(
|
|
51
|
+
row.id,
|
|
52
|
+
row.customerId,
|
|
53
|
+
lines,
|
|
54
|
+
OrderStatus.from(row.status as OrderStatusValue),
|
|
55
|
+
);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { Module } from '@nestjs/common';
|
|
2
|
+
import { TypeOrmModule } from '@nestjs/typeorm';
|
|
3
|
+
import { ORDER_REPOSITORY } from './domain/order.repository';
|
|
4
|
+
import { OrderOrmEntity } from './infrastructure/order.orm-entity';
|
|
5
|
+
import { TypeOrmOrderRepository } from './infrastructure/typeorm-order.repository';
|
|
6
|
+
import { PlaceOrderUseCase } from './application/place-order.usecase';
|
|
7
|
+
import { ShipOrderUseCase } from './application/ship-order.usecase';
|
|
8
|
+
import { OrdersController } from './presentation/orders.controller';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* O módulo é onde a **inversão de dependência** acontece, numa linha:
|
|
12
|
+
*
|
|
13
|
+
* { provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository }
|
|
14
|
+
*
|
|
15
|
+
* O use-case pede o token `ORDER_REPOSITORY` (a porta do domínio); o Nest entrega o adapter TypeORM.
|
|
16
|
+
* Trocar de persistência = trocar o `useClass` aqui, e nada mais. O domínio e a aplicação não sabem
|
|
17
|
+
* que TypeORM existe.
|
|
18
|
+
*/
|
|
19
|
+
@Module({
|
|
20
|
+
imports: [TypeOrmModule.forFeature([OrderOrmEntity])],
|
|
21
|
+
controllers: [OrdersController],
|
|
22
|
+
providers: [
|
|
23
|
+
PlaceOrderUseCase,
|
|
24
|
+
ShipOrderUseCase,
|
|
25
|
+
{ provide: ORDER_REPOSITORY, useClass: TypeOrmOrderRepository },
|
|
26
|
+
],
|
|
27
|
+
})
|
|
28
|
+
export class OrdersModule {}
|
package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { BadRequestException, Body, Controller, Param, Post } from '@nestjs/common';
|
|
2
|
+
import { PlaceOrderUseCase } from '../application/place-order.usecase';
|
|
3
|
+
import { ShipOrderUseCase } from '../application/ship-order.usecase';
|
|
4
|
+
import { PlaceOrderHttpDto } from './orders.http.dto';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* O controller é FINO. Ele traduz HTTP↔use-case e converte falha de domínio em erro HTTP — nada
|
|
8
|
+
* mais. Zero regra de negócio aqui. Se você sentir vontade de colocar um `if` de regra no
|
|
9
|
+
* controller, ele pertence ao domínio.
|
|
10
|
+
*/
|
|
11
|
+
@Controller('orders')
|
|
12
|
+
export class OrdersController {
|
|
13
|
+
constructor(
|
|
14
|
+
private readonly placeOrder: PlaceOrderUseCase,
|
|
15
|
+
private readonly shipOrder: ShipOrderUseCase,
|
|
16
|
+
) {}
|
|
17
|
+
|
|
18
|
+
@Post()
|
|
19
|
+
async place(@Body() dto: PlaceOrderHttpDto) {
|
|
20
|
+
const result = await this.placeOrder.execute(dto);
|
|
21
|
+
if (result.isFailure) throw new BadRequestException(result.error);
|
|
22
|
+
return result.value;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
@Post(':id/ship')
|
|
26
|
+
async ship(@Param('id') id: string) {
|
|
27
|
+
const result = await this.shipOrder.execute({ orderId: id });
|
|
28
|
+
if (result.isFailure) throw new BadRequestException(result.error);
|
|
29
|
+
return { ok: true };
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { IsArray, IsInt, IsPositive, IsString, ValidateNested } from 'class-validator';
|
|
2
|
+
import { Type } from 'class-transformer';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* DTOs de HTTP — a forma do que chega pela borda. Validados com class-validator. São de
|
|
6
|
+
* PRESENTAÇÃO: o controller os traduz para o input do use-case. O domínio nunca vê estes tipos.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
class OrderItemDto {
|
|
10
|
+
@IsString()
|
|
11
|
+
productId!: string;
|
|
12
|
+
|
|
13
|
+
@IsInt()
|
|
14
|
+
@IsPositive()
|
|
15
|
+
unitPriceCents!: number;
|
|
16
|
+
|
|
17
|
+
@IsInt()
|
|
18
|
+
@IsPositive()
|
|
19
|
+
quantity!: number;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export class PlaceOrderHttpDto {
|
|
23
|
+
@IsString()
|
|
24
|
+
customerId!: string;
|
|
25
|
+
|
|
26
|
+
@IsArray()
|
|
27
|
+
@ValidateNested({ each: true })
|
|
28
|
+
@Type(() => OrderItemDto)
|
|
29
|
+
items!: OrderItemDto[];
|
|
30
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Column, Entity, PrimaryGeneratedColumn } from 'typeorm';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Product — CRUD puro, SEM regra de negócio. Aqui a orm-entity É o modelo: não há invariante para
|
|
5
|
+
* proteger, então separar domínio/persistência seria custo sem retorno. Uma classe, decorada.
|
|
6
|
+
*
|
|
7
|
+
* Este é o **caminho enxuto** (AC-4). Compare com `modules/orders/`: lá, quatro camadas porque há
|
|
8
|
+
* regra que se paga; aqui, uma, porque não há. Ver `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
9
|
+
*/
|
|
10
|
+
@Entity('products')
|
|
11
|
+
export class Product {
|
|
12
|
+
@PrimaryGeneratedColumn('uuid')
|
|
13
|
+
id!: string;
|
|
14
|
+
|
|
15
|
+
@Column()
|
|
16
|
+
name!: string;
|
|
17
|
+
|
|
18
|
+
@Column('int')
|
|
19
|
+
priceCents!: number;
|
|
20
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { Body, Controller, Get, Param, Post } from '@nestjs/common';
|
|
2
|
+
import { InjectRepository } from '@nestjs/typeorm';
|
|
3
|
+
import { Repository } from 'typeorm';
|
|
4
|
+
import { IsInt, IsPositive, IsString } from 'class-validator';
|
|
5
|
+
import { Product } from './product.entity';
|
|
6
|
+
|
|
7
|
+
class CreateProductDto {
|
|
8
|
+
@IsString()
|
|
9
|
+
name!: string;
|
|
10
|
+
|
|
11
|
+
@IsInt()
|
|
12
|
+
@IsPositive()
|
|
13
|
+
priceCents!: number;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* CRUD enxuto: o controller fala DIRETO com o repositório do TypeORM. Sem use-case, sem porta, sem
|
|
18
|
+
* mapper. Para dados sem invariante, essas camadas seriam só arquivos a mais para o dev e para o
|
|
19
|
+
* agente lerem — o oposto de economia de token.
|
|
20
|
+
*
|
|
21
|
+
* A regra de quando promover isto para o padrão de `orders/` está em `WHEN-CLEAN-WHEN-LEAN.md`.
|
|
22
|
+
*/
|
|
23
|
+
@Controller('products')
|
|
24
|
+
export class ProductsController {
|
|
25
|
+
constructor(
|
|
26
|
+
@InjectRepository(Product) private readonly repo: Repository<Product>,
|
|
27
|
+
) {}
|
|
28
|
+
|
|
29
|
+
@Post()
|
|
30
|
+
create(@Body() dto: CreateProductDto) {
|
|
31
|
+
return this.repo.save(this.repo.create(dto));
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
@Get()
|
|
35
|
+
list() {
|
|
36
|
+
return this.repo.find();
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
@Get(':id')
|
|
40
|
+
byId(@Param('id') id: string) {
|
|
41
|
+
return this.repo.findOne({ where: { id } });
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { Module } from '@nestjs/common';
|
|
2
|
+
import { TypeOrmModule } from '@nestjs/typeorm';
|
|
3
|
+
import { Product } from './product.entity';
|
|
4
|
+
import { ProductsController } from './products.controller';
|
|
5
|
+
|
|
6
|
+
/** CRUD enxuto: só o controller e a entity. Sem providers de porta/adapter — não há o que inverter. */
|
|
7
|
+
@Module({
|
|
8
|
+
imports: [TypeOrmModule.forFeature([Product])],
|
|
9
|
+
controllers: [ProductsController],
|
|
10
|
+
})
|
|
11
|
+
export class ProductsModule {}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Result<T> — sucesso ou falha de domínio, sem lançar exceção.
|
|
3
|
+
*
|
|
4
|
+
* O domínio devolve `Result` em vez de `throw` para que a regra de negócio seja um valor testável
|
|
5
|
+
* (o teste lê `.isFailure`, não captura exceção) e para que a camada de aplicação decida o que
|
|
6
|
+
* fazer com a falha. `throw` é reservado para o inesperado (bug), não para regra de negócio.
|
|
7
|
+
*/
|
|
8
|
+
export class Result<T> {
|
|
9
|
+
private constructor(
|
|
10
|
+
public readonly isSuccess: boolean,
|
|
11
|
+
private readonly _value?: T,
|
|
12
|
+
public readonly error?: string,
|
|
13
|
+
) {}
|
|
14
|
+
|
|
15
|
+
get isFailure(): boolean {
|
|
16
|
+
return !this.isSuccess;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Só chame após checar `isSuccess`. Falha aqui é bug, não regra. */
|
|
20
|
+
get value(): T {
|
|
21
|
+
if (!this.isSuccess) throw new Error(`Result sem valor: ${this.error}`);
|
|
22
|
+
return this._value as T;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
static ok<T>(value: T): Result<T> {
|
|
26
|
+
return new Result(true, value);
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
static fail<T>(error: string): Result<T> {
|
|
30
|
+
return new Result<T>(false, undefined, error);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { Order } from '../../src/modules/orders/domain/order.entity';
|
|
2
|
+
import { Money } from '../../src/modules/orders/domain/money.vo';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A prova concreta do isolamento (AC-8): estes testes exercem a **regra de negócio** instanciando
|
|
6
|
+
* SÓ o agregado de domínio — sem `Test.createTestingModule`, sem ORM, sem subir o Nest. Se um dia a
|
|
7
|
+
* invariante precisar do framework para ser testada, o domínio vazou e a arquitetura falhou.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
const line = (cents: number, qty: number) => ({
|
|
11
|
+
productId: 'p1',
|
|
12
|
+
unitPrice: Money.of(cents),
|
|
13
|
+
quantity: qty,
|
|
14
|
+
});
|
|
15
|
+
|
|
16
|
+
describe('Order (domínio, sem Nest)', () => {
|
|
17
|
+
it('não cria pedido sem itens', () => {
|
|
18
|
+
const r = Order.place('o1', 'c1', []);
|
|
19
|
+
expect(r.isFailure).toBe(true);
|
|
20
|
+
expect(r.error).toMatch(/ao menos um item/);
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
it('deriva o total das linhas', () => {
|
|
24
|
+
const order = Order.place('o1', 'c1', [line(1000, 2), line(500, 1)]).value;
|
|
25
|
+
expect(order.total.cents).toBe(2500);
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
it('NÃO envia sem pagamento — a invariante-chave', () => {
|
|
29
|
+
const order = Order.place('o1', 'c1', [line(1000, 1)]).value;
|
|
30
|
+
order.confirm();
|
|
31
|
+
// pula o pay() de propósito
|
|
32
|
+
const shipped = order.ship();
|
|
33
|
+
expect(shipped.isFailure).toBe(true);
|
|
34
|
+
expect(shipped.error).toMatch(/transição inválida/);
|
|
35
|
+
expect(order.status.value).toBe('CONFIRMED');
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('envia quando pago — o caminho feliz da máquina de estados', () => {
|
|
39
|
+
const order = Order.place('o1', 'c1', [line(1000, 1)]).value;
|
|
40
|
+
order.confirm();
|
|
41
|
+
order.pay();
|
|
42
|
+
const shipped = order.ship();
|
|
43
|
+
expect(shipped.isSuccess).toBe(true);
|
|
44
|
+
expect(order.status.value).toBe('SHIPPED');
|
|
45
|
+
});
|
|
46
|
+
});
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"module": "commonjs",
|
|
4
|
+
"target": "es2022",
|
|
5
|
+
"moduleResolution": "node",
|
|
6
|
+
"experimentalDecorators": true,
|
|
7
|
+
"emitDecoratorMetadata": true,
|
|
8
|
+
"declaration": false,
|
|
9
|
+
"strict": true,
|
|
10
|
+
"skipLibCheck": true,
|
|
11
|
+
"esModuleInterop": true,
|
|
12
|
+
"outDir": "./dist",
|
|
13
|
+
"baseUrl": "./"
|
|
14
|
+
},
|
|
15
|
+
"include": ["src/**/*", "test/**/*"]
|
|
16
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "1.0",
|
|
3
|
+
"type": "boilerplate",
|
|
4
|
+
"name": "06-clean-arch",
|
|
5
|
+
"title": "Clean Architecture Calibrada - DDD por camadas, sem cerimônia",
|
|
6
|
+
"path": "boilerplates/06-clean-arch",
|
|
7
|
+
"readme": "boilerplates/06-clean-arch/README.md",
|
|
8
|
+
"stack": [
|
|
9
|
+
"NestJS",
|
|
10
|
+
"TypeScript",
|
|
11
|
+
"TypeORM",
|
|
12
|
+
"Postgres"
|
|
13
|
+
],
|
|
14
|
+
"useCases": [
|
|
15
|
+
"Domínio com regra de negócio",
|
|
16
|
+
"DDD",
|
|
17
|
+
"Clean Architecture",
|
|
18
|
+
"Hexagonal"
|
|
19
|
+
],
|
|
20
|
+
"commands": [
|
|
21
|
+
"npm install",
|
|
22
|
+
"npm run start:dev",
|
|
23
|
+
"npm test",
|
|
24
|
+
"npm run test:e2e"
|
|
25
|
+
],
|
|
26
|
+
"gates": [
|
|
27
|
+
"npm test",
|
|
28
|
+
"npm run test:cov"
|
|
29
|
+
],
|
|
30
|
+
"tokenPolicy": {
|
|
31
|
+
"firstRead": [
|
|
32
|
+
"boilerplate.manifest.json",
|
|
33
|
+
"README.md",
|
|
34
|
+
"WHEN-CLEAN-WHEN-LEAN.md",
|
|
35
|
+
"memory/30-domains/orders/context.md"
|
|
36
|
+
],
|
|
37
|
+
"avoidLoadingByDefault": [
|
|
38
|
+
"node_modules",
|
|
39
|
+
"dist",
|
|
40
|
+
"coverage"
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Contexto: Orders (fatia rica)
|
|
2
|
+
|
|
3
|
+
> Leia **este arquivo antes do código**. Ele descreve o domínio na linguagem ubíqua. Você só precisa
|
|
4
|
+
> descer à implementação quando for *editar* — e aí sabe exatamente onde. Isso é a economia de token
|
|
5
|
+
> do boilerplate (ADR-0009): o resumo tipado do domínio, não a leitura da árvore inteira.
|
|
6
|
+
|
|
7
|
+
## Linguagem ubíqua
|
|
8
|
+
|
|
9
|
+
- **Order** (agregado) — um pedido de um cliente, com uma ou mais linhas.
|
|
10
|
+
- **OrderLine** — produto + preço unitário + quantidade.
|
|
11
|
+
- **OrderStatus** — máquina de estados: `DRAFT → CONFIRMED → PAID → SHIPPED`, e `CANCELLED` de
|
|
12
|
+
qualquer estado não-enviado.
|
|
13
|
+
- **Money** — value object em centavos; imutável, comparado por valor.
|
|
14
|
+
|
|
15
|
+
## Invariantes (moram em `domain/order.entity.ts`)
|
|
16
|
+
|
|
17
|
+
1. Um pedido **precisa de ao menos uma linha** para ser criado.
|
|
18
|
+
2. Toda quantidade é **positiva**.
|
|
19
|
+
3. O **total é derivado** das linhas — nunca setado de fora.
|
|
20
|
+
4. As transições de estado seguem a máquina; em especial: **não se envia sem pagamento** (`SHIPPED`
|
|
21
|
+
só a partir de `PAID`).
|
|
22
|
+
|
|
23
|
+
Se você vai mexer numa regra, ela está no agregado. Não procure no controller nem no service.
|
|
24
|
+
|
|
25
|
+
## Casos de uso (contratos em `application/`)
|
|
26
|
+
|
|
27
|
+
| Use-case | Input → Output | O que faz |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| `PlaceOrderUseCase` | `{ customerId, items[] }` → `{ orderId, totalCents }` | cria + confirma o pedido |
|
|
30
|
+
| `ShipOrderUseCase` | `{ orderId }` → `void` | envia — falha se não estiver pago |
|
|
31
|
+
|
|
32
|
+
A assinatura basta para saber o que a feature faz. O corpo só interessa ao editar.
|
|
33
|
+
|
|
34
|
+
## Onde as coisas ficam
|
|
35
|
+
|
|
36
|
+
- Regra nova → `domain/order.entity.ts` (e teste em `test/orders/place-order.spec.ts`, sem Nest).
|
|
37
|
+
- Caso de uso novo → `application/*.usecase.ts`.
|
|
38
|
+
- Persistência → `infrastructure/typeorm-order.repository.ts` (implementa a porta do domínio).
|
|
39
|
+
- Endpoint → `presentation/orders.controller.ts` (fino: traduz HTTP ↔ use-case).
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Contexto: Products (caminho enxuto)
|
|
2
|
+
|
|
3
|
+
> CRUD sem regra de negócio. **Uma camada.** Se você esperava as quatro camadas de `orders/`, leia o
|
|
4
|
+
> `WHEN-CLEAN-WHEN-LEAN.md` — a ausência delas aqui é decisão, não esquecimento.
|
|
5
|
+
|
|
6
|
+
## Linguagem ubíqua
|
|
7
|
+
|
|
8
|
+
- **Product** — nome + preço (centavos). Não há comportamento a proteger; o modelo é a tabela.
|
|
9
|
+
|
|
10
|
+
## Regras
|
|
11
|
+
|
|
12
|
+
Nenhuma além de validação de formato (nome string, preço inteiro positivo). Não há invariante, não
|
|
13
|
+
há transição de estado. Por isso o `controller` fala direto com o repositório do TypeORM.
|
|
14
|
+
|
|
15
|
+
## Quando isto vira `orders/`
|
|
16
|
+
|
|
17
|
+
No dia em que aparecer uma regra de verdade — por exemplo, *"não pode desativar um produto com pedido
|
|
18
|
+
em aberto"* — este contexto ganha um agregado de domínio e migra para o padrão de quatro camadas. Até
|
|
19
|
+
lá, promover seria pagar tokens adiantado por camadas vazias.
|
|
20
|
+
|
|
21
|
+
## Onde as coisas ficam
|
|
22
|
+
|
|
23
|
+
- Tudo em `modules/products/`: `product.entity.ts` (o modelo) e `products.controller.ts` (o CRUD).
|
package/boilerplates/README.md
CHANGED
|
@@ -119,6 +119,26 @@ node ../bin/init-project.js meu-projeto --template monorepo
|
|
|
119
119
|
|
|
120
120
|
---
|
|
121
121
|
|
|
122
|
+
### 🧱 6. Clean Architecture (Calibrada)
|
|
123
|
+
**Para**: Produtos com regra de negócio de verdade — DDD por camadas, sem cerimônia
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
node ../bin/init-project.js meu-projeto --template clean-arch
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**Inclui**:
|
|
130
|
+
- Fatia rica (Orders): domain / application / infrastructure / presentation, com inversão de dependência
|
|
131
|
+
- Caminho enxuto (Products): CRUD em 1 camada, lado a lado — a calibração visível
|
|
132
|
+
- Invariante de domínio testável **sem subir o Nest**
|
|
133
|
+
- Memória por bounded context (linguagem ubíqua) para leitura barata por agente
|
|
134
|
+
- `WHEN-CLEAN-WHEN-LEAN.md`: o critério de quando usar cada padrão
|
|
135
|
+
|
|
136
|
+
**Use quando**: há invariante de negócio ou máquina de estados. Para CRUD puro, prefira um dos flat acima.
|
|
137
|
+
|
|
138
|
+
[Abrir 📂](./06-clean-arch)
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
122
142
|
### 📊 6. Dashboard Admin
|
|
123
143
|
**Para**: Painel administrativo, gestão interna
|
|
124
144
|
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* create-memory-nest-kit v0.6.0
|
|
4
|
+
* Orquestrador de geração de projetos com memória hierárquica
|
|
5
|
+
*
|
|
6
|
+
* Refatoração modular:
|
|
7
|
+
* - lib/generators/memory-generator.js
|
|
8
|
+
* - lib/generators/nest-generator.js
|
|
9
|
+
* - lib/generators/readme-generator.js
|
|
10
|
+
* - lib/validators/structure-validator.js
|
|
11
|
+
* - lib/utils/file-helpers.js
|
|
12
|
+
*/
|
|
13
|
+
import path from 'node:path';
|
|
14
|
+
import process from 'node:process';
|
|
15
|
+
import { fileURLToPath } from 'node:url';
|
|
16
|
+
import { generateMemoryStructure } from '../lib/generators/memory-generator.js';
|
|
17
|
+
import { generateNestStructure } from '../lib/generators/nest-generator.js';
|
|
18
|
+
import { generateReadme } from '../lib/generators/readme-generator.js';
|
|
19
|
+
import { validateProjectStructure, printValidationReport } from '../lib/validators/structure-validator.js';
|
|
20
|
+
import { ensureDir, logSuccess, logError } from '../lib/utils/file-helpers.js';
|
|
21
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
22
|
+
const __dirname = path.dirname(__filename);
|
|
23
|
+
// Parse arguments
|
|
24
|
+
const args = process.argv.slice(2);
|
|
25
|
+
const showHelp = args.includes('--help') || args.includes('-h');
|
|
26
|
+
if (showHelp) {
|
|
27
|
+
console.log(`
|
|
28
|
+
create-memory-nest-kit v0.6.0
|
|
29
|
+
|
|
30
|
+
Uso:
|
|
31
|
+
create-memory-nest-kit [diretorio] [opcoes]
|
|
32
|
+
|
|
33
|
+
Opcoes:
|
|
34
|
+
--force Sobrescreve arquivos existentes
|
|
35
|
+
--only-memory Gera apenas estrutura de memoria/agents/skills
|
|
36
|
+
--no-gitkeep Nao cria .gitkeep em diretorios vazios
|
|
37
|
+
--no-validate Pula validacao apos geracao
|
|
38
|
+
-h, --help Mostra esta ajuda
|
|
39
|
+
|
|
40
|
+
Exemplos:
|
|
41
|
+
node bin/create-memory-nest-kit.js meu-projeto
|
|
42
|
+
node bin/create-memory-nest-kit.js meu-projeto --force
|
|
43
|
+
node bin/create-memory-nest-kit.js meu-projeto --only-memory
|
|
44
|
+
`);
|
|
45
|
+
process.exit(0);
|
|
46
|
+
}
|
|
47
|
+
const options = {
|
|
48
|
+
force: args.includes('--force'),
|
|
49
|
+
noGitkeep: args.includes('--no-gitkeep'),
|
|
50
|
+
onlyMemory: args.includes('--only-memory'),
|
|
51
|
+
noValidate: args.includes('--no-validate'),
|
|
52
|
+
};
|
|
53
|
+
const rawTarget = args.find((a) => !a.startsWith('-')) || '.';
|
|
54
|
+
const targetDir = path.resolve(process.cwd(), rawTarget);
|
|
55
|
+
const projectName = path.basename(targetDir);
|
|
56
|
+
/**
|
|
57
|
+
* Orquestrador principal
|
|
58
|
+
*/
|
|
59
|
+
async function run() {
|
|
60
|
+
try {
|
|
61
|
+
console.log(`\n📦 create-memory-nest-kit v0.6.0`);
|
|
62
|
+
console.log(`📁 Projeto: ${projectName}`);
|
|
63
|
+
console.log(`📍 Diretório: ${targetDir}\n`);
|
|
64
|
+
// Passo 1: Garantir diretório
|
|
65
|
+
console.log('🔨 Criando estrutura de diretórios...');
|
|
66
|
+
ensureDir(targetDir);
|
|
67
|
+
// Passo 2: Gerar memória
|
|
68
|
+
console.log('📚 Gerando estrutura de memória...');
|
|
69
|
+
const memoryResult = generateMemoryStructure(targetDir, options);
|
|
70
|
+
console.log(` ✅ ${memoryResult.filesWritten} arquivos | ${memoryResult.emptyDirsCreated} diretórios`);
|
|
71
|
+
// Passo 3: Gerar NestJS (se não for --only-memory)
|
|
72
|
+
if (!options.onlyMemory) {
|
|
73
|
+
console.log('🎭 Gerando backend NestJS...');
|
|
74
|
+
const nestResult = generateNestStructure(targetDir, projectName, options);
|
|
75
|
+
console.log(` ✅ ${nestResult.filesWritten} arquivos | ${nestResult.emptyDirsCreated} diretórios`);
|
|
76
|
+
}
|
|
77
|
+
// Passo 4: Gerar README
|
|
78
|
+
console.log('📖 Gerando README.md...');
|
|
79
|
+
const readmeResult = generateReadme(targetDir, projectName, options);
|
|
80
|
+
console.log(` ✅ ${Math.round(readmeResult.size / 1024)}KB`);
|
|
81
|
+
// Passo 5: Validar (se não for --no-validate)
|
|
82
|
+
if (!options.noValidate) {
|
|
83
|
+
console.log('\n🔍 Validando estrutura...');
|
|
84
|
+
const validation = validateProjectStructure(targetDir, { includeNest: !options.onlyMemory });
|
|
85
|
+
printValidationReport(validation);
|
|
86
|
+
if (!validation.isValid) {
|
|
87
|
+
logError('Falhas detectadas na validação');
|
|
88
|
+
process.exit(1);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
// Sucesso!
|
|
92
|
+
logSuccess(`Estrutura v0.6.0 criada com sucesso`);
|
|
93
|
+
console.log(`\n➡️ Próximos passos:`);
|
|
94
|
+
console.log(` 1) cd ${path.relative(process.cwd(), targetDir) || '.'}`);
|
|
95
|
+
console.log(` 2) node scripts/build-context-pack.mjs`);
|
|
96
|
+
if (!options.onlyMemory) {
|
|
97
|
+
console.log(` 3) cd backend && npm install`);
|
|
98
|
+
console.log(` 4) npm run start:dev`);
|
|
99
|
+
}
|
|
100
|
+
console.log('');
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
logError(error.message);
|
|
104
|
+
if (process.env.DEBUG) {
|
|
105
|
+
console.error(error.stack);
|
|
106
|
+
}
|
|
107
|
+
process.exit(1);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
run();
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* bin/forja.mjs — core executivo do Forja (ADR-0020).
|
|
4
|
+
*
|
|
5
|
+
* Ponto de entrada único dos comandos de processo:
|
|
6
|
+
* forja <comando> [args]
|
|
7
|
+
*
|
|
8
|
+
* Responsabilidades transversais:
|
|
9
|
+
* 1. Roteamento via lib/core/registry.mjs (declarativo).
|
|
10
|
+
* 2. Gates antes do alvo (workspace, ADR-0019).
|
|
11
|
+
* 3. Trilha de auditoria append-only em .context/forja-runs.jsonl.
|
|
12
|
+
*/
|
|
13
|
+
export {};
|