Koncepció EUPL 1.2

d3i

A D3I domain-specifikus nyelv interpretere és kódgenerátora: a Domain-Driven Design modellt formálisan értelmezi, ellenőrzi (linter), és .NET, TypeScript, Protobuf/gRPC vagy JSON kimenetté alakítja — VS Code támogatással.

.NET

## A projektről

A **d3i (DDD Interpreter)** a **D3I** domain-specifikus nyelv értelmezésére, ellenőrzésére és átalakítására szolgáló eszköz. A Domain-Driven Design (DDD) elemeit közvetlenül a D3I nyelven lehet leírni, ahol a domain elemek elsőrendű fogalmakként jelennek meg — a
  leírás (modell + dokumentáció) az **elsődleges igazságforrás**, amelyből a technikai implementáció automatikusan előállítható.

## Toolchain

A d3i egy teljes feldolgozási láncot ad:

1. **Nyelvtan (ANTLR)** — a D3I szintaxis formális definíciója.
  2. **Interpreter** — a forrás elemzése és a domain-modell felépítése.
  3. **Elemmodell** — a DDD elemek tipizált, bejárható reprezentációja (visitor-minta).
  4. **Linter (SemanticChecker)** — szintaktikai és szemantikai konzisztencia-ellenőrzés.
  5. **Emitterek** — a modellből cél-reprezentációk generálása.

## Támogatott DDD-elemek

Entitások · value object-ek · aggregátumok és aggregate root · view-k (CQRS-projekciók) · bounded context-ek · repository-k · service-ek · interfészek · események · Anti-Corruption Layer (ACL).

## Emitterek (kimenetek)

- **.NET / C#** — kódstruktúra és interfészek.
  - **TypeScript** — típusok és interfészek.
  - **Protobuf / gRPC** — szerződés-definíciók szolgáltatások közti kommunikációhoz.
  - **JSON** — gépileg feldolgozható modell-reprezentáció és dokumentáció.

Új célnyelv egy új emitter megírásával adható hozzá.

## Dekorátorok

A modell elemei dekorátorokkal bővíthetők (pl. `@id`, `@required`, `@post`, `@status(404)`), amelyek meta-információt adnak a generálásnak — a dekorátorok köre szabadon bővíthető.

## Szerkesztő-támogatás

A projekt **VS Code extension**-t (`d3i Language Support`) és **Language Servert (LSP)** is tartalmaz, így a D3I fájlok szerkesztése nyelvi támogatást (kiemelés, ellenőrzés) kap.

## Használat (CLI)

A `.d3i` fájl megírása után az interpreter parancssorból futtatható; a kimenet a választott emittertől függ (lásd a repó `tests/` és `example` fájljait).

## Példa (D3I, részlet)

```d3i
  domain WebShop {
      context Main {
          aggreagte Customer {
              valueobject Address {
                  @required
                  countryCode:string
                  city:string
              }
              root entity Customer {
                  @id
                  id:string
                  @required
                  name: string
                  address:Address
              }
          }
          interface PublicIF {
              @post
              createOrder( customerId:string ) : @status(200) Order
          }
      }
  }
  ```