NFT Minter — 이미지 생성기

02기술 결정

문제가 무엇이었고, 무엇을 골랐고, 그래서 어떻게 됐는지.

1. 결정 01

   업로드 결과를 만들기 전에 보여준다

   문제

   이미지를 올린 뒤 결과가 만들어지고 나서야 잘못 올린 걸 알게 되면, 사용자는 처음부터 다시 해야 합니다. 잘못 고른 파일은 생각보다 자주 생깁니다.

   선택

   파일을 놓는 즉시 브라우저에서 미리보기를 그려 주고, 그 상태에서 교체할 수 있게 했습니다. 서버에 보내는 것은 사용자가 확인한 뒤입니다.

   결과

   잘못 올린 파일 때문에 처음부터 다시 하는 일이 사라졌습니다. 서버로 가는 불필요한 요청도 함께 줄었습니다.

2. 결정 02

   확장자는 이름일 뿐이라고 전제한다

   문제

   `.png`로 끝난다고 해서 그 파일이 이미지인 것은 아닙니다. 이름만 바꾼 파일을 올리면 그대로 통과합니다.

   선택

   브라우저에서 실제로 이미지로 읽히는지 먼저 확인하고, 크기와 형식은 서버에서 다시 검사하도록 나눴습니다. 브라우저 쪽 검사는 사용자에게 빨리 알려주기 위한 것이고, 실제 판정은 서버가 합니다.

   결과

   이름을 바꿔 올린 파일이 걸러졌습니다. '클라이언트 검증은 편의, 서버 검증은 안전'이라는 구분을 이 프로젝트에서 처음 명확히 정리했습니다.

3. 결정 03

   금칙어는 코드가 아니라 목록으로 관리한다

   문제

   부적절한 문구를 막아야 했는데, 조건문으로 단어를 넣기 시작하면 단어가 추가될 때마다 배포를 해야 합니다. 운영자가 직접 손댈 수 없습니다.

   선택

   필터 대상을 코드 밖의 목록으로 빼서, 배포 없이 갱신할 수 있게 했습니다.

   결과

   운영 중 대응이 개발자를 거치지 않게 됐습니다. 정책성 데이터를 코드에 박지 않는 습관은 여기서 시작됐습니다.

03주요 기능

• 드래그 앤 드롭 업로드

  파일을 끌어다 놓아 올리고, 잘못 놓은 파일은 그 자리에서 교체.

• 즉시 미리보기

  서버로 보내기 전에 브라우저에서 결과를 먼저 확인.

• 파일 검증

  실제 이미지 여부·크기·형식을 클라이언트와 서버 양쪽에서 검사.

• 문구 필터링

  코드 밖 목록으로 관리되는 금칙어 필터.

04회고