AI-Driven Application
Development Methodology

## Meta
schema-version: 1.0
content-version: 1.0.0
domain-context-version: "1.0.0"

## Stack
stack:
  language: java                  # java | go | typescript
  framework: spring-boot-3x
  build: maven

## Architecture Style
architecture:
  style: hexagonal
  layer-order: [domain, application, adapter]

## Modules
modules:
  - name: order-service
    bcs: [Order]
    type: service

## BC Communication
bc-communication:
  - from: Order
    to: Notification
    style: async-event
    technology: kafka

## Shared Kernel
shared-kernel:
  location: common-module
  contents: [Money, AuditInfo, DomainEvent]

## Persistence
persistence:
  command-side: jpa               # jpa | jdbc  — Aggregate 쓰기 전략
  query-side: jooq                # none | jooq — 복잡한 조인/집계 읽기 전략
                                  # none: JPA Projection 사용
                                  # jooq: schema.sql → codegen → DSL Query
  cqrs: true                      # query-side != none 이면 true
  migration: flyway               # flyway | liquibase | none
  databases:
    - bc: Order
      datasource: order_db
      tables:
        - name: orders
          aggregate: Order
          mapping: entity         # entity(JPA) | jdbc-row(JDBC)
        - name: order_items
          aggregate: OrderItem
          mapping: entity
    - bc: Catalog
      datasource: catalog_db
      tables:
        - name: products
          aggregate: Product
          mapping: entity
  shared-tables: []               # BC 간 공유 테이블 (원칙상 금지, 예외 명시용)
  erd: erd.mmd                    # Mermaid ERD 파일 경로 (선택)

## NFR (선택)
nfr:
  - id: NFR-001
    category: performance
    requirement: "주문 API p99 < 200ms"
    implementation: AUTO          # AUTO | TODO | MANUAL

## Meta
domain-context-version: "1.0.0"
arch-decisions-version: "1.0.0"

## Wave Plan
waves:
  - wave: 0
    bcs: [common-module, Catalog]
    reason: "외부 의존 없음"

  - wave: 1
    bcs: [Order]
    depends-on: [Catalog]
    communication: sync-acl

  - wave: 2
    bcs: [Notification]
    depends-on: [Order]
    communication: async-event
    trigger-event: OrderPlaced

## Cycle Check
cycle-detected: false

## Wave Gate Conditions
wave-gate:
  - compile-pass: true
  - port-binding: true
  - domain-test-pass: true
  - no-cycle: true

erDiagram
  %% A-ADM: arch-decisions.md ## Persistence 섹션을 기반으로 /gen-schema 스킬이 자동 생성
  %% schema-version: 1.0 | domain-context-version: "1.0.0"

  customers ||--o{ orders : places
  orders    ||--o{ order_items : contains
  products  ||--o{ order_items : included_in

  customers {
    uuid   id          PK
    string email       "UNIQUE NOT NULL"
    string name        "NOT NULL"
    string phone
    timestamptz created_at
  }

  orders {
    uuid        id          PK
    uuid        customer_id FK
    varchar20   status      "PENDING|CONFIRMED|CANCELLED"
    numeric12_2 total_amount
    timestamptz placed_at
  }

  order_items {
    uuid        id         PK
    uuid        order_id   FK
    uuid        product_id FK
    integer     quantity   "NOT NULL CHECK > 0"
    numeric12_2 unit_price
  }

  products {
    uuid        id    PK
    string      name  "NOT NULL"
    numeric12_2 price
    boolean     active
  }