feat(exporter): Prisma ORM exporter 추가

[L33gn21]

개요

5번째 ORM 백엔드로 Prisma를 추가합니다 (기존: SeaORM / SQLAlchemy / SQLModel / JPA).
TableDef 스키마를 datasource, generator, enum 블록(전역 dedup), model 블록을
포함한 단일 schema.prisma 파일로 변환합니다.

실행:

vespertide export --orm prisma

설계상 특이사항

1. 왜 Prisma만 별도 config (PrismaConfig)를 가지는가

Prisma는 단일 스키마 언어입니다. datasource db { provider, url, relationMode }와
generator client { provider, output }이 모델과 같은 파일 안에 있어야 합니다.
나머지 ORM 백엔드(SeaORM / SQLAlchemy / SQLModel / JPA)는 모델 단위 코드만
생성하므로 이런 메타 정보가 필요 없습니다. 즉, Prisma만 "모델 외 입력"(provider,
client output 경로, relation mode)을 받아야 하기 때문에 vespertide-config에
PrismaConfig를 새로 추가했습니다. 필드 세 개(provider / client_output /
relation_mode)와 postgresql 기본값을 가집니다.

2. 왜 export.rs에 if matches!(orm, OrmArg::Prisma) { return cmd_export_prisma(...) } 분기가 있는가

기존 export 파이프라인은 모델 N개 → 파일 N개 전제입니다:
walk_models → 모델별 render_entity_with_schema → 파일별 write → mod chain.
Prisma는 모델 N개 → 파일 1개이며 위 파이프라인이 만족시킬 수 없는 두 가지
요구가 있습니다:

• 모든 테이블에 걸친 enum 전역 dedup (두 테이블이 같은 enum을 참조해도 enum
  블록은 파일에 한 번만 등장해야 함)
• datasource/generator 헤더가 파일 맨 위에 1회만 출력되어야 함

그래서 cmd_export가 진입 즉시 cmd_export_prisma로 분기하고,
PrismaExporterWithConfig::render_schema(&all_tables)에서 스키마 전체를 한 번에
조립합니다. Orm::Prisma는 인터페이스 일관성 + 분기 안 자체 clean 호출을 위해
clean_export_dir / build_output_path에 prisma 확장자로 함께 등록만 해
두었습니다.

테스트 설계

명세는 crates/vespertide-exporter/src/prisma/TESTING.md에 있습니다. 3-layer 구조:

• Layer 1 — FK 없는 단일 엔티티 렌더링. render_entity(table)로 검증.
• Layer 2 — schema 컨텍스트가 필요한 관계 포함 케이스.
  render_entity_with_schema(table, schema)로 검증. TableConstraint::ForeignKey가
  하나라도 있는 TableDef는 무조건 Layer 2.
• Layer 3 — edge case (예약어, 특수문자).

설계 규칙:

• 모든 출력 검증은 insta::assert_snapshot! 사용. assert!(result.contains(...))
  방식은 금지 — 회귀 감지 정확도 확보 및 출력 전체를 고정.
• 구조가 동일한 케이스(컬럼 타입 × nullable, default 값 변형, on_delete/on_update,
  singularize 등)는 #[rstest] 파라미터화로 작성.
• 반복되는 ColumnDef 생성은 로컬 헬퍼(col, col_null, col_with_default,
  col_with_comment, pk, uniq, idx, fk, table, render_schema_all)로
  분리하여 케이스 본문을 짧게 유지.

테스트 65개 / 스냅샷 54개가 커버하는 범위:

Layer	항목
1-1 컬럼 타입 × nullable	25개 타입 (Simple + Complex, enum 포함) × {nullable=true, nullable=false}
1-2 PK	단일 autoinc / 단일 no-autoinc / composite / 없음
1-3 unique	단일 named / 단일 unnamed / composite named / composite unnamed
1-4 index	단일 named / 단일 unnamed / composite
1-5 default	bool, now(), CURRENT_TIMESTAMP, gen_random_uuid(), uuid_generate_v4(), 임의 함수, 문자열 리터럴, 정수 리터럴, fallback 키워드
1-6 enum	screaming_snake match, mapped, integer, nullable, enum default, 다중 컬럼 dedup
1-7 description / comment	있음 / 없음 / multiline / 컬럼 comment multiline
1-8 @@Map	항상 출력
2 관계	has-many, has-one (unique FK), nullable FK, 같은 테이블로의 다중 FK, 자기참조, on_delete/on_update (6 action), composite FK 무시, 복수형→단수형 back-relation (posts/categories/boxes/users)
3 edge	예약어 테이블명 (select, order, model, ...), 예약어 컬럼명 (default, unique, ...), description 안의 newline/quote/brace, default 값 안의 quote

Test plan

• cargo build -p vespertide-exporter — 정상
• cargo test -p vespertide-exporter --lib prisma:: — 65 passed
• cargo test -p vespertide-exporter orm:: — 207 passed (Prisma dispatch 스냅샷 포함)
• 리뷰어: examples/app/에 cargo run -p vespertide-cli -- export --orm prisma 실행해 동작 확인
• 리뷰어 (선택): 생성된 출력에 npx prisma format / npx prisma validate 통과 여부 확인

🤖 Generated with Claude Code

[owjs3901]

차음부터 model Items로 쓰는 방식을 어떨까요?

[L33gn21]

복수형 → 단수형 변환 로직은 제거했습니다.

일반적으로 DB는 snake_case, Prisma는 PascalCase를 사용하는데,
이 부분도 통일해서 @@Map() 사용을 없애는 방향이 좋을까요?

[owjs3901]

불필요한 MD파일은 생성을 지양합니다

[L33gn21]

제거했습니다

[yyuneu]

@owjs3901 리뷰 감사합니다. 지적해주신 부분 모두 반영했습니다:

• 복수형 → 단수형 변환 로직 제거
• 불필요한 TESTING.md 제거

네이밍 관련해서 PascalCase + @@map으로 실제 snake_case 테이블명을 매핑하는 게 prisma validate에서도 표준적이라 판단해 현행(@@map 유지)으로 정리한 것 같습니다. 다른 방향을 원하시면 말씀해주세요.

[owjs3901]

@yyuneu snapshot이 업데이트 되지 않은 것 같습니다

[yyuneu]

@yyuneu snapshot이 업데이트 되지 않은 것 같습니다

확인 했습니다.

다만 제가 현재 이 브랜치에 직접 push할 수 있는 권한이 없어서, 원 작성지(@L33gn21 )에게 연락해서 권한을 받거나 직접 CI를 돌려달라고 요청하는 중입니다. 확인되는 대로 바로 반영하겠습니다.

[yyuneu]

@owjs3901

• 복수형 → 단수형 변환 로직 제거
• 불필요한 TESTING.md 제거
• 네이밍 관련해서 PascalCase + @@Map으로 실제 snake_case 테이블명을 매핑하는 게 prisma validate에서도 표준적이라 판단해 현행(@@Map 유지)으로 정리한 것 같습니다.

해당 코드 관련 해서 테스트 코드 삽입 했고, 아웃풋도 스냅샷이랑 동일히게 코드 작성 끝났다고 하는데, 혹시 다른 부분이 있어서 스냅샷이 반영 안된 것 같다고 하신건가요? 다른 모듈에서 사이드 이펙트나, 스냅샷 갱신이 누락된 부분이 있는건가요?

확인하진 부분 구체적인 포인트 조금만 더 알려주시면 빠르게 파악해서 반영 하겠습니다.

[owjs3901]

죄송합니다, 제가 과거 커밋을 본것 같습니다.
관련하여 개선안 전달드립니다.

clientOutput 옵션의 경우 이미 modelsDir이 존재하는 것으로 보이며 겹치는 것 같습니다.

provider 옵션의 경우 기본적으로 model만 관리하는 vespertide의 측면에서 부적절하다고 느낍니다.

relationMode의 경우 enum이어야 할 것 같습니다.
또한 관련 설명에 대해서 조금 더 자세한 설명을 부탁드립니다.

감사합니다.

@yyuneu