1. 통과하는 테스트 뒤에 숨어 있던 것들

시작점: 통합 테스트 0개, Mock 1,336개

AI가 부추기는 관성

Mock을 쓰는 자리와 쓰지 않는 자리

Mock을 세운 결과

  it('브랜드 목록을 매핑한다', async () => {
    const service = new InternalBrandsService(
      …
      categoryRepository as any,
+     {} as any,
+     {} as any,
    );

listBrands가 feeResolverService.resolveBrandPlatformFeeMap을 호출하는데 "브랜드 목록을 매핑한다" 테스트는 6번째 인자를 {}로 넘겨 "is not a function"으로 실패했다. resolveBrandPlatformFeeMap mock을 추가해 그린으로 복구한다.

const service = new InternalBrandsService(
   brandRepository as never,
   brandProductRepository as never,
   userLinkRepository as never,
   settlementRepository as never,
   categoryRepository as never,
   {} as never,   // ← 이 테스트는 안 쓴다고 보고 비워 둔 자리
   {} as never,
 );

Mock 없이 검증할 자리 만들기

// test/integration/setup/global-setup.ts — vitest globalSetup, suite 당 한 번 실행된다.
mysqlContainer = await new MySqlContainer('mysql:8.0')
  .withDatabase('affiliate_test')
  .withUsername('test')
  .withUserPassword('test')
  .start();
wiremockContainer = await new GenericContainer('wiremock/wiremock:3.10.0')
  .withExposedPorts(8080)
  .withWaitStrategy(Wait.forHttp('/__admin/mappings', 8080).forStatusCode(200))
  .start();
// 스키마는 운영 엔티티 정의로 만든다. synchronize 는 테스트 전용이고, 운영은 마이그레이션을 쓴다.
const bootstrap = buildIntegrationDataSource({ /* … */ synchronize: true });
await bootstrap.initialize();
provide('mysqlPort', mysqlContainer.getPort());
provide('wiremockBaseUrl', wiremockUrl(wiremockContainer));

// test/integration/harness/fixtures.ts — 계좌는 여러 스펙이 공유하므로 한 곳에 둔다.
export const KNOWN_BANK_ACCOUNT = { accountNumber: '110123456789', bankCode: '004' } as const;
// test/integration/infrastructure/personal-auth.int.spec.ts
// 경로와 응답 규격은 인증사가 정한 것이라 경계 대역에 모아 둔다.
import { personalAuthServer, VERIFY_ACCOUNT_HOLDER_NAME_PATH } from '../../support/doubles/personal-auth-server.js';
import { KNOWN_BANK_ACCOUNT } from '../harness/fixtures.js';
const PAYLOAD = { ...KNOWN_BANK_ACCOUNT, accountHolderName: 'HONG GILDONG' };
it('인증사가 성공을 주면 검증 결과를 그대로 돌려준다', async () => {
  // 이 경로로 POST 가 오면 이 응답을 돌려주라고 WireMock 에 등록한다.
  await ctx.wiremock.register(
    { method: 'POST', urlPath: VERIFY_ACCOUNT_HOLDER_NAME_PATH },
    personalAuthServer.respondVerified(PAYLOAD),
  );
  await expect(service.verifyAccountHolderName(PAYLOAD).then((r) => r.status)).resolves.toBe('SUCCESS');
  // 응답만 보고 끝내지 않는다. 무엇이 나갔는지도 본다.
  const sent = (await ctx.wiremock.getReceivedRequests()).find((r) => r.url === VERIFY_ACCOUNT_HOLDER_NAME_PATH);
  expect(JSON.parse(sent.body)).toEqual(PAYLOAD); // 계좌 정보가 그대로 전달됐다
});

// Before — Mock. "sendSms 가 한 번 불렸다"
const services = {
  smsService: { sendSms: vi.fn().mockResolvedValue(undefined) },
  alimtalkService: { send: vi.fn().mockResolvedValue(undefined) },
};
it('channel="LMS"는 smsService.sendSms로 라우팅한다', async () => {
  await handler.handleNotification({ channel: 'LMS', receiver: '01012345678', message: '본문' });
  expect(services.smsService.sendSms).toHaveBeenCalledTimes(1);
});

// After — 기록형 Mock. "무엇이 나갔다"
class RecordingSmsTransport {
  public readonly sent: Record<string, unknown>[] = [];
  sendSms = async (payload: Record<string, unknown>) => {
    this.sent.push(payload);
    return { result_code: 1 };
  };
}
it('채널을 메시지 종류로 실어 보낸다', async () => {
  const { handler, sms } = buildHandler();
  await handler.handleNotification(smsMessage({ channel: 'LMS', sender: '028888', title: '제목' }));
  expect(sms.sent[0]).toMatchObject({ receiver: '01012345678', message: '내용', messageType: 'LMS', title: '제목' });
});

Mock 걷어내기

// test/unit/golden-master/money-calculations.spec.ts
/** 실데이터 분포를 흉내 낸 금액 그리드: 0·경계·전형(원 단위)·소수 혼합. 지면상 몇 개만 옮겼습니다. */
const SETTLEMENT_AMOUNTS = [0, 1, 707.4, 1000, 4900.5, 9999, 22515, 49900, 123456.789, 12345678.1234];
const EDGE_AMOUNTS = [-1000, Number.NaN, Number.POSITIVE_INFINITY];
const CREATOR_RATES = [0, 3.3, 5, 10, 12.3456, 20, 33];
const PLATFORM_RATES = [0, 5, 10, 20];
it('buildSettlementFromRates — 금액×커미션율×플랫폼율 전 조합', () => {
  const lines = SETTLEMENT_AMOUNTS.flatMap((price) =>
    CREATOR_RATES.flatMap((creatorRate) =>
      PLATFORM_RATES.map(
        (platformRate) =>
          `price=${price} cr=${creatorRate} pr=${platformRate} => ${JSON.stringify(buildSettlementFromRates(price, creatorRate, platformRate))}`,
      ),
    ),
  );
  expect(lines).toMatchSnapshot();
});

// __snapshots__/money-calculations.spec.ts.snap
exports[`골든마스터: BrandInvoiceEntity VAT (원 단위 trunc) > depositFromSupplyPrice 1`] = `
[
  "supplyPrice=0 => 0",
  "supplyPrice=9 => 9",
  "supplyPrice=10 => 11",
  "supplyPrice=99 => 108",
  "supplyPrice=707.4 => 777",
]
`;

마치며