Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
-- 채팅 이미지·주문 카드 메시지. 새 컬럼은 모두 nullable이고 enum은 끝에 덧붙여 기존 TEXT·HTML 메시지는 그대로다(백필 없음).
-- AlterTable
ALTER TABLE `store_conversation_message` ADD COLUMN `image_url` VARCHAR(2048) NULL,
ADD COLUMN `order_card_order_id` BIGINT UNSIGNED NULL,
ADD COLUMN `order_card_order_number` VARCHAR(30) NULL,
ADD COLUMN `order_card_pickup_at` DATETIME(3) NULL,
ADD COLUMN `order_card_product_name` VARCHAR(200) NULL,
ADD COLUMN `order_card_thumbnail_url` VARCHAR(2048) NULL,
MODIFY `body_format` ENUM('TEXT', 'HTML', 'IMAGE', 'ORDER_CARD') NOT NULL DEFAULT 'TEXT';
11 changes: 11 additions & 0 deletions prisma/schema.prisma
Original file line number Diff line number Diff line change
Expand Up @@ -177,6 +177,8 @@ enum ConversationSenderType {
enum ConversationBodyFormat {
TEXT
HTML
IMAGE
ORDER_CARD
}

enum ReviewMediaType {
Expand Down Expand Up @@ -1858,8 +1860,17 @@ model StoreConversationMessage {
sender_account_id BigInt? @db.UnsignedBigInt

body_format ConversationBodyFormat @default(TEXT)
// IMAGE·ORDER_CARD는 목록 미리보기·푸시에 쓰는 대체 문구를 담는다
body_text String? @db.Text
body_html String? @db.Text
image_url String? @db.VarChar(2048)

// 주문 카드는 보낸 시점 값으로 남긴다. 주문이 바뀌거나 지워져도 대화 이력이 그대로 보이게 FK를 두지 않는다
order_card_order_id BigInt? @db.UnsignedBigInt
order_card_order_number String? @db.VarChar(30)
order_card_product_name String? @db.VarChar(200)
order_card_thumbnail_url String? @db.VarChar(2048)
order_card_pickup_at DateTime? @db.DateTime(3)

created_at DateTime @default(now()) @db.DateTime(3)
deleted_at DateTime? @db.DateTime(3)
Expand Down
8 changes: 8 additions & 0 deletions src/common/errors/error-catalog.ts
Original file line number Diff line number Diff line change
Expand Up @@ -660,6 +660,14 @@ export const ERROR_CATALOG = {
status: HttpStatus.BAD_REQUEST,
message: '본문 형식이 올바르지 않습니다.',
},
IMAGE_URL_REQUIRED: {
status: HttpStatus.BAD_REQUEST,
message: '보낼 사진을 첨부해 주세요.',
},
ORDER_INQUIRY_NOT_AVAILABLE: {
status: HttpStatus.BAD_REQUEST,
message: '입금이 확인된 뒤 문의할 수 있어요.',
},
// ── 관리자
ADMIN_ONLY: {
status: HttpStatus.FORBIDDEN,
Expand Down
5 changes: 5 additions & 0 deletions src/features/conversation/constants/conversation.constants.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,8 @@ export const DEFAULT_GREETING_TEMPLATE =
export const MAX_INQUIRY_BODY_TEXT_LENGTH = 2000;
// store.greeting_message VARCHAR(500)과 동일 상한
export const MAX_CONVERSATION_BODY_HTML_LENGTH = 100000;

// 이미지 메시지 대체 문구. 목록 미리보기·판매자 푸시가 본문 대신 이 값을 쓴다.
export const CONVERSATION_IMAGE_ALT_TEXT = '사진을 보냈습니다.';
// image_url VARCHAR(2048)과 동일 상한
export const MAX_CONVERSATION_IMAGE_URL_LENGTH = 2048;
38 changes: 37 additions & 1 deletion src/features/conversation/conversation-inquiry.graphql
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ extend type Query {
문의 채팅 진입 컨텍스트(구매자). 매장 프로필·상담시간·치환 완료 인사말·질문 칩을
한 번에 내려준다. 아직 대화가 없어도 조회 가능하며 그 경우 conversationId는 null.
로그인 필수.
숨김 매장은 그 매장에 진행 중인 주문이 있는 구매자만 조회할 수 있다(아니면 STORE_NOT_FOUND). 문의 전송도 같다.
"""
storeInquiryContext(storeId: ID!): StoreInquiryContext!
}
Expand All @@ -20,6 +21,29 @@ extend type Mutation {
로그인 필수.
"""
sendConversationFaqMessage(input: SendConversationFaqMessageInput!): ConversationMessagesPayload!
"""
채팅 이미지 업로드용 Presigned URL 발급(구매자). uploadUrl로 PUT한 뒤 publicUrl을 sendConversationImageMessage에 넣는다.
JPEG·PNG·WebP, 1바이트 이상 10MB 이하(아니면 INVALID_CONTENT_TYPE·INVALID_CONTENT_LENGTH·FILE_TOO_LARGE).
로그인 필수.
"""
createConversationImageUploadUrl(
"""파일 MIME 타입(image/jpeg·image/png·image/webp)."""
contentType: String!
"""파일 크기(바이트, 1 이상 10MB 이하)."""
contentLength: Int!
): UploadUrl!
"""
구매자 이미지 메시지 전송(메시지당 1장). 대화가 없으면 sendConversationMessage처럼 생성하고 인사말을 먼저 저장한다.
imageUrl이 이 계정에 createConversationImageUploadUrl로 발급된 URL이 아니면 INVALID_IMAGE_URL, 공백이면
IMAGE_URL_REQUIRED다. 로그인 필수.
"""
sendConversationImageMessage(input: SendConversationImageMessageInput!): ConversationMessagesPayload!
"""
주문 카드 전송(구매자). 주문의 매장과의 대화에 보낸 시점의 주문 스냅샷을 카드로 남긴다(대화가 없으면 생성).
본인 주문이 아니면 ORDER_NOT_FOUND, 입금 확인 전(판매자가 볼 수 없는) 주문이면 ORDER_INQUIRY_NOT_AVAILABLE,
매장이 숨김이고 그 매장에 진행 중인 주문이 없으면 STORE_NOT_FOUND다. 로그인 필수.
"""
sendConversationOrderCard(orderId: ID!): ConversationMessagesPayload!
}

"""문의 채팅 진입 컨텍스트"""
Expand Down Expand Up @@ -66,10 +90,14 @@ type ConversationMessage {
senderType: ConversationSenderType!
"""본문 형식. 읽어야 할 본문 필드를 가리킨다."""
bodyFormat: ConversationBodyFormat!
"""평문 본문. bodyFormat이 TEXT면 이 값을 쓴다."""
"""평문 본문. bodyFormat이 TEXT면 이 값을 쓴다. IMAGE·ORDER_CARD는 대체 문구가 들어 있다."""
bodyText: String
"""서식 본문. bodyFormat이 HTML이면 이 값을 쓴다."""
bodyHtml: String
"""이미지 URL. bodyFormat이 IMAGE면 채워진다."""
imageUrl: String
"""주문 카드. bodyFormat이 ORDER_CARD면 채워진다."""
orderCard: ConversationOrderCard
"""발송 시각. 메시지 스트림 정렬은 id 기준이다."""
createdAt: DateTime!
}
Expand All @@ -90,6 +118,14 @@ input SendConversationMessageInput {
bodyText: String!
}

"""구매자 이미지 메시지 전송 입력"""
input SendConversationImageMessageInput {
"""문의할 매장 ID. 대화방이 없으면 이 호출에서 생성된다."""
storeId: ID!
"""createConversationImageUploadUrl이 이 계정에 발급한 publicUrl."""
imageUrl: String!
}

"""질문 칩(FAQ) 전송 입력"""
input SendConversationFaqMessageInput {
"""문의할 매장 ID. 대화방이 없으면 이 호출에서 생성된다."""
Expand Down
17 changes: 16 additions & 1 deletion src/features/conversation/conversation-seller.graphql
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ extend type Query {
extend type Mutation {
"""
판매자 메시지를 발송한다. 판매자 로그인 필수. SELLER 계정이 아니면 FORBIDDEN, 매장을 보유하지 않으면 NOT_FOUND.
bodyFormat은 TEXT·HTML·IMAGE이고 ORDER_CARD는 INVALID_BODY_FORMAT이다(주문 카드는 구매자만 보낸다).
"""
sellerSendConversationMessage(
input: SellerSendConversationMessageInput!
Expand Down Expand Up @@ -118,6 +119,14 @@ type SellerConversationMessage {
"""
bodyHtml: String
"""
이미지 URL. bodyFormat이 IMAGE면 채워진다(bodyText에는 대체 문구 '사진을 보냈습니다.').
"""
imageUrl: String
"""
주문 카드. bodyFormat이 ORDER_CARD(구매자가 보낸 카드)면 채워진다. orderId로 주문 상세를 연다.
"""
orderCard: ConversationOrderCard
"""
발송 시각.
"""
createdAt: DateTime!
Expand Down Expand Up @@ -152,7 +161,8 @@ type SellerConversationMessageConnection {
input SellerSendConversationMessageInput {
conversationId: ID!
"""
본문 형식. 이 값에 해당하는 본문 필드가 필수다(다른 쪽을 함께 넘기면 그대로 저장된다).
본문 형식. 이 값에 해당하는 본문 필드가 필수다(TEXT·HTML은 다른 쪽을 함께 넘기면 그대로 저장된다).
IMAGE는 imageUrl만 저장하고 본문은 대체 문구로 채운다. ORDER_CARD는 INVALID_BODY_FORMAT이다.
"""
bodyFormat: ConversationBodyFormat!
"""
Expand All @@ -163,4 +173,9 @@ input SellerSendConversationMessageInput {
서식 본문(최대 100000자). bodyFormat이 HTML이면 필수.
"""
bodyHtml: String
"""
이미지 URL. bodyFormat이 IMAGE면 필수(없으면 IMAGE_URL_REQUIRED)이고 sellerCreateUploadUrl(CONVERSATION_IMAGE)로
이 계정에 발급된 publicUrl이어야 한다(아니면 INVALID_IMAGE_URL). 다른 형식에서는 무시한다.
"""
imageUrl: String
}
5 changes: 3 additions & 2 deletions src/features/conversation/conversation.module.ts
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,14 @@ import { ConversationEventsService } from '@/features/conversation/services/conv
import { ConversationInquiryService } from '@/features/conversation/services/conversation-inquiry.service';
import { SellerConversationService } from '@/features/conversation/services/conversation-seller.service';
import { ConversationSubscriptionService } from '@/features/conversation/services/conversation-subscription.service';
import { OrderModule } from '@/features/order';
import { OutboxModule } from '@/features/outbox';
import { StoreModule } from '@/features/store';

@Module({
// 판매자 컨텍스트·catalog 읽기 포트(StoreModule), 감사 기록(AuditLogModule), 구매자 상태 판정(AuthModule),
// 구매자 메시지 이벤트 발행(OutboxModule)
imports: [StoreModule, AuditLogModule, AuthModule, OutboxModule],
// 구매자 메시지 이벤트 발행(OutboxModule), 주문 카드 원천·숨김 매장 문의 판정(OrderModule)
imports: [StoreModule, AuditLogModule, AuthModule, OutboxModule, OrderModule],
providers: [
ConversationRepository,
ConversationEventsService,
Expand Down
24 changes: 24 additions & 0 deletions src/features/conversation/conversation.types.graphql
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,28 @@ enum ConversationBodyFormat {
서버 측 sanitize는 아직 적용돼 있지 않다.
"""
HTML
"""
이미지 1장. imageUrl을 그리고, bodyText에는 대체 문구('사진을 보냈습니다.')가 있다.
"""
IMAGE
"""
주문 카드(구매자만 보낸다). orderCard를 그리고, bodyText에는 대체 문구('주문 문의: {상품명} ({주문번호})')가 있다.
"""
ORDER_CARD
}

"""
채팅 주문 카드. 구매자가 보낸 시점의 주문 스냅샷이라 이후 주문이 바뀌거나 지워져도 그대로 보인다.
판매자 앱은 orderId로 주문 상세를 연다.
"""
type ConversationOrderCard {
orderId: ID!
"""주문번호."""
orderNumber: String!
"""상품명(주문 시점 스냅샷)."""
productName: String!
"""썸네일. 커스텀 주문이면 커스텀 대표 이미지(3D 윗면·슬롯형 합성), 아니면 상품 대표 이미지. 둘 다 없으면 null."""
thumbnailUrl: String
"""보낸 시점의 픽업 일시."""
pickupAt: DateTime!
}
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,26 @@ describe('SellerSendConversationMessageInput', () => {
expect(await validate(dto)).toHaveLength(0);
});

// ORDER_CARD는 DTO를 통과시켜 service가 INVALID_BODY_FORMAT으로 거절한다
it.each(['IMAGE', 'ORDER_CARD'])('%s 형식 통과', async (bodyFormat) => {
const dto = build({
conversationId: '1',
bodyFormat,
imageUrl: 'https://example.com/a.jpg',
});
expect(await validate(dto)).toHaveLength(0);
});

it('문자열이 아닌 imageUrl 거절', async () => {
const dto = build({
conversationId: '1',
bodyFormat: 'IMAGE',
imageUrl: 1,
});
const errors = await validate(dto);
expect(errors[0].property).toBe('imageUrl');
});

it('알 수 없는 bodyFormat 거절', async () => {
const dto = build({
conversationId: '1',
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,16 @@
import { IsIn, IsOptional, IsString } from 'class-validator';

const BODY_FORMATS = ['TEXT', 'HTML'] as const;
type ConversationBodyFormat = (typeof BODY_FORMATS)[number];
import { ConversationBodyFormat } from '@/generated/prisma/client';

/** bodyFormat에 따라 bodyText/bodyHtml 중 하나가 필수라는 invariant는 service에서 검증한다(class-validator로 표현하기 어렵다). */
/**
* 형식별 필수 필드·판매자가 보낼 수 없는 형식(ORDER_CARD)은 service가 판정한다. DTO는 SDL enum 전체를 받아야
* ORDER_CARD가 VALIDATION_FAILED가 아니라 INVALID_BODY_FORMAT으로 거절된다.
*/
export class SellerSendConversationMessageInput {
@IsString()
conversationId!: string;

@IsIn(BODY_FORMATS)
@IsIn(Object.values(ConversationBodyFormat))
bodyFormat!: ConversationBodyFormat;

@IsOptional()
Expand All @@ -18,4 +20,8 @@ export class SellerSendConversationMessageInput {
@IsOptional()
@IsString()
bodyHtml?: string;

@IsOptional()
@IsString()
imageUrl?: string;
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
import 'reflect-metadata';

import { plainToInstance } from 'class-transformer';
import { validate } from 'class-validator';

import { SendConversationImageMessageInput } from '@/features/conversation/dto/inputs/send-conversation-image-message.input';

function build(plain: object): SendConversationImageMessageInput {
return plainToInstance(SendConversationImageMessageInput, plain);
}

describe('SendConversationImageMessageInput', () => {
it('storeId·imageUrl 정상 조합 허용', async () => {
const dto = build({ storeId: '1', imageUrl: 'https://example.com/a.jpg' });
expect(await validate(dto)).toHaveLength(0);
});

it.each([
['storeId 누락', { imageUrl: 'https://example.com/a.jpg' }, 'storeId'],
['imageUrl 빈 문자열', { storeId: '1', imageUrl: '' }, 'imageUrl'],
])('%s 거절', async (_label, plain, property) => {
const errors = await validate(build(plain));
expect(errors.map((e) => e.property)).toEqual([property]);
});
});
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import { IsNotEmpty, IsString } from 'class-validator';

export class SendConversationImageMessageInput {
@IsString()
@IsNotEmpty()
storeId!: string;

@IsString()
@IsNotEmpty()
imageUrl!: string;
}
26 changes: 26 additions & 0 deletions src/features/conversation/repositories/conversation.repository.ts
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,34 @@ import {
} from '@/generated/prisma/client';
import { activeWhere, PrismaService } from '@/prisma';

export interface ConversationOrderCardSnapshot {
orderId: bigint;
orderNumber: string;
productName: string;
thumbnailUrl: string | null;
pickupAt: Date;
}

export interface ConversationMessageEntry {
senderType: ConversationSenderType;
senderAccountId: bigint | null;
bodyFormat: ConversationBodyFormat;
bodyText: string | null;
bodyHtml: string | null;
imageUrl?: string;
orderCard?: ConversationOrderCardSnapshot;
}

function orderCardColumns(card: ConversationOrderCardSnapshot | undefined) {
return card
? {
order_card_order_id: card.orderId,
order_card_order_number: card.orderNumber,
order_card_product_name: card.productName,
order_card_thumbnail_url: card.thumbnailUrl,
order_card_pickup_at: card.pickupAt,
}
: {};
}

@Injectable()
Expand Down Expand Up @@ -539,6 +561,8 @@ export class ConversationRepository {
body_format: entry.bodyFormat,
body_text: entry.bodyText,
body_html: entry.bodyHtml,
image_url: entry.imageUrl ?? null,
...orderCardColumns(entry.orderCard),
created_at: now,
},
}),
Expand Down Expand Up @@ -684,6 +708,7 @@ export class ConversationRepository {
bodyFormat: ConversationBodyFormat;
bodyText: string | null;
bodyHtml: string | null;
imageUrl?: string | null;
},
audit: (row: { id: bigint }) => AuditEntry,
) {
Expand All @@ -701,6 +726,7 @@ export class ConversationRepository {
body_format: args.bodyFormat,
body_text: args.bodyText,
body_html: args.bodyHtml,
image_url: args.imageUrl ?? null,
created_at: now,
},
});
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import { ConversationInquiryMutationResolver } from '@/features/conversation/res
import { ConversationCenterService } from '@/features/conversation/services/conversation-center.service';
import { ConversationEventsService } from '@/features/conversation/services/conversation-events.service';
import { ConversationInquiryService } from '@/features/conversation/services/conversation-inquiry.service';
import { OrderInquiryRepository } from '@/features/order';
import { CATALOG_QUERY } from '@/features/store';
import { StoreCatalogQueryRepository } from '@/features/store/repositories/store-catalog-query.repository';
import type { PrismaClient } from '@/generated/prisma/client';
Expand All @@ -23,6 +24,7 @@ import {
} from '@/test/factories';
import { createTestingModuleWithRealDb } from '@/test/modules/testing-module.builder';
import { outboxPublisherProviders } from '@/test/outbox';
import { s3TestProviders } from '@/test/storage/s3-test.helper';

describe('Conversation Center Resolvers (real DB)', () => {
let centerResolver: ConversationCenterQueryResolver;
Expand All @@ -40,6 +42,8 @@ describe('Conversation Center Resolvers (real DB)', () => {
// 발행 repository가 OutboxPublisher를 주입받는다
...outboxPublisherProviders(),
ConversationEventsService,
OrderInquiryRepository,
...s3TestProviders(),
AccountUserRepository,
{ provide: CATALOG_QUERY, useClass: StoreCatalogQueryRepository },
{ provide: PUB_SUB, useValue: new PubSub() },
Expand Down
Loading
Loading