레거시 리뉴얼
어테일·어테일 프로 생애설계 플랫폼 리뉴얼
사용자용 생애설계 서비스와 전문가·운영자용 서비스를 함께 분석해 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를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.
어테일·어테일 프로 데이터 경계 분리
Project Infrastructure
인증·파일 업로드·문서화·배포 스크립트까지 운영 전환 기반을 구성했습니다
두 서비스의 API 전환을 뒷받침하는 런타임·저장소·인증·파일 업로드·문서화·배포 흔적을 공통 인프라 경계로 정리했습니다.
- 01
런타임
Node.js/TypeScript와 Express 4 위에 TypeDI 서비스, TypeORM 리포지토리, Swagger 문서화 구성이 있습니다.
- 02
상태 저장소
MySQL과 TypeORM 엔티티가 목표·콘텐츠·분류·사용자 데이터를 담당합니다.
- 03
외부 연동
이메일 회원가입, JWT·bcrypt 인증, Kakao·Apple OAuth, S3 업로드 라이브러리, Swagger, logging/security middleware가 package stack에 남아 있습니다.
- 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 청구 기준 개선 수치는 이력서에 기재했지만, 현재 원본 로그·청구 자료가 보존되지 않아 본 상세 페이지에서는 구조 변경 근거만 공개합니다.
- 주석 처리된 비전·키워드·자산·리포트 이미지 설계는 구현 완료로 표기하지 않습니다.
- 배포 파이프라인과 서버 토폴로지는 공개 가능한 원천 자료가 부족해 구체 구성으로 표기하지 않습니다.