Things I’ve Built

Reable Homepage · 콘텐츠 편집기

Reable Homepage · 콘텐츠 편집기

EAN테크놀로지 · 2025.06 ~ 2026.07 · 풀스택

백엔드 인력 없이 프론트엔드 2명이 회사 홈페이지와 어드민 CMS를 API까지 개발했습니다. Nx 모노레포 도입을 주도하고, Tiptap 에디터와 S3 파일 라이프사이클을 설계했습니다.

담당: Nx 모노레포 도입 주도, Tiptap 에디터, NestJS API와 파일 관리 구조 설계

기술 스택

TypeScript
Next.js
Tiptap
NestJS
TypeORM
PostgreSQL
TanStack Query
Recharts
Tailwind CSS
AWS S3
Nx
pnpm

프로젝트 소개

  • 회사 홈페이지와 게시글을 작성·관리하는 어드민 CMS입니다. 백엔드 인력이 없어 프론트엔드 2명이 Next.js 15 화면과 NestJS·TypeORM·PostgreSQL API를 함께 개발했습니다.

Nx 모노레포 도입

  • 팀 회의를 리드하며 Turborepo와 Nx를 비교했고, 변경된 프로젝트만 빌드·테스트하는 affected 기능이 강점인 Nx를 선택했습니다.
  • 공통 컴포넌트를 패키지로 묶어 새 프로젝트마다 공통 컴포넌트를 다시 만드는 시간을 줄였고, 디자인·기획이 바뀌어도 컴포넌트 하나만 고치면 되도록 했습니다.

Tiptap 에디터

  • 표·임베드·이미지 리사이즈·캡션을 커스텀 노드와 NodeView로 구현하고, 작성자가 이미지에 링크와 속성을 지정할 수 있도록 했습니다.
  • 입력할 때마다 이미지 NodeView가 다시 그려지던 문제는 shouldUpdate로 해결했습니다. 글 작성에는 자동 임시 저장과 토스트 알림을 제안해 구현했습니다.
// 관심 있는 attr이 바뀔 때만 NodeView를 다시 그린다
export const shouldUpdate =
  (keys: string[] = []) =>
  ({ oldNode, newNode }) => {
    if (!oldNode.sameMarkup(newNode)) return true;            // 타입·마크업 변화
    if (oldNode.content !== newNode.content) return true;      // 내용 변화
    for (const k of keys) if (oldNode.attrs[k] !== newNode.attrs[k]) return true;
    return false; // selection·decoration만 바뀐 경우는 재사용
  };

// 이미지 노드: src·width·caption·link가 바뀔 때만 다시 그림
ImageNodeView({ update: shouldUpdate(["src", "width", "caption", "href"]) });
NodeView 재사용 조건 (실제 코드 축약, 마지막 사용부는 예시)

파일 라이프사이클 설계

  • 게시글을 복제하면 이미지 하나를 여러 글이 참조할 수 있어, 게시글과 이미지를 중간 테이블로 연결했습니다. 글을 저장하면 연결을 만들고, 이미지를 삭제하면 연결을 끊습니다.
  • 매월 정기 배치로 어떤 게시글과도 연결이 남지 않은 파일만 S3에서 정리해, 다른 글에서 쓰는 파일이 지워지지 않도록 했습니다.
posts ──< post_uploads >── uploads (S3 key)
            (postId, uploadId)  UNIQUE

글 저장       → post_uploads 연결 생성
이미지 삭제   → post_uploads 연결 제거
게시글 복제   → 같은 uploadId로 연결만 추가 (파일 복사 없음)

매월 1일 05:00 배치
  └─ post_uploads 연결이 0개인 uploads만 조회
       └─ S3 객체 삭제 → uploads 레코드 삭제
게시글–이미지 관계와 정리 배치 (도식)

일괄 복제, 방문 분석, SEO

  • 여러 게시글을 복제할 때 원본을 게시글마다 다시 조회하던 것을 한 번에 조회해 Map으로 관리하도록 바꿔, 조회 쿼리를 N회에서 1회로 줄였습니다.
  • 방문 분석을 tracker → 수집·집계 API → Recharts 대시보드까지 직접 구축했습니다.
  • 솔루션 페이지를 generateStaticParams로 정적 생성하고 메타데이터와 sitemap을 적용해 Lighthouse SEO 100점을 받았습니다.
// 개선 전: 복제할 게시글마다 원본 조회 (N회)
for (const id of ids) {
  const origin = await postRepo.findOne({ where: { id } });
  ...
}

// 개선 후: 한 번에 조회해 Map으로 찾기 (1회)
const origins = await postRepo.find({ where: { id: In(ids) }, relations: ["postUploads"] });
const originById = new Map(origins.map((post) => [post.id, post]));
for (const id of ids) {
  const origin = originById.get(id)!;
  ...
}
원본 일괄 조회 후 Map 사용 (축약 예시)

측정 방법: SEO 점수는 정적 생성한 솔루션 페이지를 Lighthouse SEO 항목으로 측정했습니다.

결과 및 경험

  • 백엔드 인력 없이 홈페이지와 CMS를 API까지 완성했고, Nx 공통 패키지 덕분에 새 프로젝트에서 공통 컴포넌트를 다시 만드는 시간이 줄었습니다.
  • 편집기에서 이미지를 제거하는 것과 저장소에서 파일을 삭제하는 것은 별개의 작업이었습니다. 다른 게시글에서 사용하는 파일을 지우지 않도록 참조 관계를 데이터 구조로 먼저 정한 뒤, 화면의 편집 기능부터 백엔드의 파일 관리까지 연결해 개발했습니다.