이찬양Backend Engineer

언어

← 프로젝트 목록으로 돌아가기

레거시 리뉴얼

어테일·어테일 프로 생애설계 플랫폼 리뉴얼

사용자용 생애설계 서비스와 전문가·운영자용 서비스를 함께 분석해 API·DB·콘텐츠 전환 구조를 재설계했습니다.

Company
라이프플래닝연구소
Service
어테일 / 어테일 프로
Period
2022.03–2022.05 · 3개월
Role
Backend Engineer
Responsibility
End-to-End Renewal · User/Pro API · DB · Migration · AWS
  • TypeScript
  • Express
  • TypeORM
  • MySQL
  • AWS
  • S3
  • Swagger
  • Docker

Project Overview

어테일과 어테일 프로 사이의 목표·콘텐츠 경계를 다시 잡았습니다

프로젝트의 핵심 과제는 사용자용 어테일의 목표 실행 흐름과 어테일 프로의 추천 목표·콘텐츠 관리 흐름을 같은 데이터 구조에 섞지 않는 것이었습니다.

백엔드 리뉴얼 범위에서 두 서비스의 레거시 구조를 분석하고, 큐레이션 원본, 사용자 목표 인스턴스, 목표→태스크→데일리 위계, 8대 영역 분류, 해시태그·콘텐츠 그래프를 나눴습니다. CSV/Notion 기반 운영 콘텐츠를 신규 테이블 구조로 옮기고, Express/TypeORM API와 S3·Swagger·Docker 기반 운영 전환 단서까지 함께 정리했습니다.

  • 어테일은 사용자의 목표 실행·일정 흐름, 어테일 프로는 추천 목표·콘텐츠 관리 흐름으로 보고 공통 데이터 경계를 재설계했습니다.
  • 큐레이션 목표는 원본으로 유지하고, 사용자가 시작한 목표는 개인별 진행 상태를 가진 인스턴스로 분리했습니다.
  • 목표 시작은 복제, 단순 저장은 연결로 나눠 원본 최신성과 개인 편집 가능성을 구분했습니다.
  • 추천 목표 307개, 태스크 1,052개, 아티클 81개 수준의 원천 콘텐츠를 정제·전환한 근거를 공개 가능한 범위로 분리했습니다.

Ownership

직접 담당한 범위

  • 어테일의 사용자 목표 실행 흐름과 어테일 프로의 추천 목표·콘텐츠 관리 흐름을 함께 분석
  • 두 서비스가 공유하는 Express/TypeORM API·DB 구조를 신규 기획 기준으로 재설계
  • 추천 목표를 개인 목표로 시작하는 복제 흐름과 콘텐츠를 저장하는 원본 연결 흐름을 분리해 구현
  • 목표→태스크→데일리 위계, 8대 영역 분류와 해시태그·콘텐츠 그래프 모델링 및 데이터 마이그레이션
  • 인증, S3 업로드, Swagger 문서, Docker/ECR 배포 스크립트 등 운영 전환 기반 구성

Constraints

먼저 해결해야 했던 제약

  • 사용자용 어테일과 전문가·운영자용 어테일 프로가 같은 목표·콘텐츠 데이터를 바라보되, 수정 주체와 사용 맥락은 달랐습니다.
  • 운영자가 편집하는 큐레이션 원본과 사용자가 진행·편집하는 개인 목표는 같은 생명주기를 가질 수 없었습니다.
  • 사용자가 목표를 “시작”하는 행위와 콘텐츠를 “담아두는” 행위는 저장 비용과 최신성 요구가 달랐습니다.
  • 8대 생애 영역과 세부 카테고리는 코드 enum보다 운영 데이터로 관리될 필요가 있었습니다.

Implementation Timeline

두 서비스 범위에서 사용자 실행과 운영 콘텐츠 관리를 분리한 순서입니다

어테일·어테일 프로의 레거시 구조를 함께 보고, 사용자 실행 데이터와 운영 콘텐츠 관리 데이터를 나눠 전환했습니다. 필요한 Phase를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.

Phase 01 · 어테일·어테일 프로 데이터 경계 분리

어테일·어테일 프로 데이터 경계 분리

Phase 01

사용자용 어테일과 전문가용 어테일 프로의 데이터 생명주기를 분리했습니다

같은 목표처럼 보여도 어테일 프로에서 관리하는 추천 목표와 어테일에서 사용자가 실제로 진행하는 목표는 수정 주체, 최신성, 삭제 기준이 다릅니다.

어테일·어테일 프로 데이터 경계Mermaid

다이어그램을 렌더링하는 중입니다.

  1. 01

    요구 분석

    어테일 프로는 추천 목표·아티클·영상을 관리하고, 어테일 사용자는 이를 개인 목표로 가져와 자기 일정과 진행 상태를 붙입니다.

    • 원본 템플릿이 사용자 편집으로 오염되면 다른 사용자에게도 잘못된 내용이 전파됩니다.
    • 사용자 목표는 기간, 예산, 완료 여부, 하위 태스크처럼 개인별 변경 상태를 가져야 했습니다.
  2. 02

    도메인 모델링

    큐레이션 목표·아티클·영상은 원본 콘텐츠로, 사용자 목표·담아둔 콘텐츠는 사용자 데이터로 분리했습니다.

    • 원본 콘텐츠는 운영자가 관리하고 여러 사용자가 참조합니다.
    • 사용자 데이터는 소유자, 진행 상태, 삭제 여부, 하위 계획을 별도로 가집니다.
  3. 03

    아키텍처 결정

    원본과 사용자 데이터를 같은 테이블에 status로 섞지 않고, 복제와 연결이라는 두 경로로 나눴습니다.

    • 편집 가능한 목표는 복제본이 필요하고, 최신 원본을 보고 싶은 북마크는 연결만으로 충분합니다.
    • 이 구분이 이후 템플릿→인스턴스 모델의 기준이 됐습니다.
  4. 04

    구현·검증

    아카이브된 엔티티와 ADR에서 큐레이션 원본, 사용자 목표, 사용자–콘텐츠 연결 모델을 확인했습니다.

    • 활성 엔티티와 주석 처리된 설계 파일을 나눠 구현 완료 범위를 다시 확인했습니다.
    • 서비스명은 범위 설명에 사용하되, 내부 API 경로와 운영 데이터는 공개 copy에서 제거했습니다.
  5. 05

    운영·복구

    데이터가 어긋나면 원본 콘텐츠가 바뀐 것인지, 사용자 복제본이 바뀐 것인지, 단순 연결만 남은 것인지 먼저 구분해야 합니다.

    • 이 구분이 없으면 운영자가 원본을 수정했을 때 사용자 목표까지 의도치 않게 영향을 받을 수 있습니다.
    • 사용자 데이터 삭제는 원본 삭제와 다른 복구 기준을 가져야 합니다.

Project Infrastructure

인증·파일 업로드·문서화·배포 스크립트까지 운영 전환 기반을 구성했습니다

두 서비스의 API 전환을 뒷받침하는 런타임·저장소·인증·파일 업로드·문서화·배포 흔적을 공통 인프라 경계로 정리했습니다.

  1. 01

    런타임

    Node.js/TypeScript와 Express 4 위에 TypeDI 서비스, TypeORM 리포지토리, Swagger 문서화 구성이 있습니다.

  2. 02

    상태 저장소

    MySQL과 TypeORM 엔티티가 목표·콘텐츠·분류·사용자 데이터를 담당합니다.

  3. 03

    외부 연동

    이메일 회원가입, JWT·bcrypt 인증, Kakao·Apple OAuth, S3 업로드 라이브러리, Swagger, logging/security middleware가 package stack에 남아 있습니다.

  4. 04

    배포 흔적

    Docker 빌드와 ECR 푸시 스크립트 흔적은 있으나, 실제 배포 로그·서버 토폴로지·운영 문서는 확인되지 않습니다.

Outcome

확인 가능한 결과

  • 어테일 사용자 목표 실행 흐름과 어테일 프로 추천 콘텐츠 관리 흐름을 함께 고려한 API·DB 리뉴얼 범위 정리
  • 템플릿→사용자 목표 인스턴스 복제와 북마크 연결을 분리한 데이터 모델 정리
  • CSV/Notion 기반 추천 목표·태스크·아티클 원천 콘텐츠를 신규 관계형 구조로 전환
  • 목표→태스크→데일리 위계와 카테고리·콘텐츠 그래프 모델링
  • Express/TypeORM/TypeDI 기반 Router→Controller→Service→Repository→Entity 계층 구조 구성
  • 이메일·JWT·OAuth 인증, S3 이미지 업로드, Swagger 문서화와 Docker/ECR 스크립트 기반 운영 전환 단서 확인
  • 저장소 기간과 스냅샷 검증 기준을 분리해 오래된 프로젝트의 과장 위험 축소

Limitations

한계와 미구현 범위

  • 서비스명은 공개 가능한 범위에서 사용하지만, 비공개 저장소 URL, 운영 데이터, 인증 파일, 내부 API 경로는 공개하지 않습니다.
  • 현재 로컬 원본 repo는 단일 merge snapshot만 확인되어 33 commit 상세 흐름을 재검증하지 못했습니다.
  • 당시 측정한 응답시간과 AWS 청구 기준 개선 수치는 이력서에 기재했지만, 현재 원본 로그·청구 자료가 보존되지 않아 본 상세 페이지에서는 구조 변경 근거만 공개합니다.
  • 주석 처리된 비전·키워드·자산·리포트 이미지 설계는 구현 완료로 표기하지 않습니다.
  • 배포 파이프라인과 서버 토폴로지는 공개 가능한 원천 자료가 부족해 구체 구성으로 표기하지 않습니다.