python-fastapi-programmer:ddd-class-diagram

Files (2)

• SKILL.md
• diagram-template.md · references/

SKILL.md (first lines)

# DDD Class Diagram 생성

Domain Book의 도메인 모델 정의를 Mermaid erDiagram으로 변환합니다.

## 실행 흐름

1. **입력 읽기**: `ai-context/domain-books/{domain}/domain-model.md` 파일 읽기
2. **다이어그램 생성**: Mermaid erDiagram 문법으로 변환
3. **출력 저장**: `docs/DDD_CLASS_DIAGRAM.md`에 저장

## 필수 포함 항목

### Entity 정의
- **PK**: Primary Key (UUID 기본)
- **FK**: Foreign Key (관계 명시)
- **NOT NULL**: 필수 필드 표시
- **UNIQUE**: 유니크 제약 조건
- **DEFAULT**: 기본값
- **INDEX**: 인덱스 전략

### Enum 정의
- 모든 Enum 값 나열
- 각 값의 의미 주석 포함

### 관계 (Relationships)
- 1:1, 1:N, N:M 관계 명시
- FK 위치 명확히 표시

### Cascade 규칙
- ON DELETE (CASCADE, SET NULL, RESTRICT)
- ON UPDATE 정책

### 기타
- Fetch 전략 (EAGER/LAZY) — 주석으로 표시
- Orphan Removal 정책
- 복합 인덱스 전략

## 출력 형식

```markdown
# DDD Class Diagram

## Entity Relationship Diagram

\```mermaid
erDiagram
    USER {
        uuid id PK "NOT NULL"
        string email "NOT NULL, UNIQUE, INDEX"
        string password_hash "NOT NULL"
        string nickname "NOT NULL"
        boolean is_active "DEFAULT true"
        datetime created_at "NOT NULL"
        datetime updated_at "NOT NULL"
        datetime deleted_at "NULLABLE"
    }

    ORDER {
        uuid id PK "NOT NULL"
        uuid user_id FK "NOT NULL, INDEX"
        string status "NOT NULL, DEFAULT 'PENDING'"
    }

    USER ||--o{ ORDER : "places"
\```

## Enum Definitions

| Enum | Values | Description |
|------|--------|-------------|
| OrderStatus | PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED | 주문 상태 |

## Cascade Rules

| Parent | Child | ON DELETE | ON UPDATE |
|--------|-------|-----------|-----------|
| USER | ORDER | CASCADE | CASCADE |

## Index Strategy

| Table | Columns | Type | Purpose |
|-------|---------|------|---------|
| users | email | UNIQUE | 로그인 조회 |
| orders | user_id, created_at | COMPOSITE | 사용자별 주문 목록 |
```

## 참고

- [diagram-template.md](references/diagram-template.md) — 전체 예시 템플릿

From ureca-corp/claude, MIT.

More from ureca-corp/claude