플러스프로젝트 배경
1) 문제점 - 성격이 다른 두 화면이 각자 백엔드를 갖게 되면 같은 데이터가 두 벌로 갈라집니다. - 글, 이미지, 번역 이력, 방문 통계, 관리자 인증이 따로 관리되면 운영이 불가능했습니다. - 화면 쪽 저장소가 분리돼 있어, API가 바뀌어도 화면 쪽이 그것을 알 방법이 없었습니다. 2) 프로젝트 목표 - 한 서버에서 콘텐츠 등록·조회, 파일 저장, 다국어 조회, 접속 통계, 관리자
프로젝트 성과
API 응답 형식 미선언 0건
API 72개 중 응답 형식이 선언되지 않은 것이 67개였습니다.
전부 정리해 지금은 0건이고, 다시 늘어나지 않도록 자동 검사로 고정했습니다.
전부 정리해 지금은 0건이고, 다시 늘어나지 않도록 자동 검사로 고정했습니다.
명세와 코드의 어긋남을 자동 차단
API 명세서를 파일로 관리하고, 코드를 바꾼 뒤 명세를 갱신하지 않으면 검사에서 걸리게 했습니다.
화면 쪽이 낡은 명세를 쓰는 일을 막습니다.
화면 쪽이 낡은 명세를 쓰는 일을 막습니다.
테스트가 운영 데이터를 건드리지 못하게 차단
운영용 데이터베이스와 테스트용의 접속 주소가 같아 구분되지 않는 문제를,
서버가 뜨는 시점에 검사해 차단하는 방식으로 막았습니다.
서버가 뜨는 시점에 검사해 차단하는 방식으로 막았습니다.
핵심 기능
콘텐츠 등록·조회 API
글과 포트폴리오 자료의 등록·수정·삭제·조회를 4개 업무 영역에 걸쳐 API 72개로 제공합니다.
진행 단계
API·데이터베이스 설계와 구현
2026.03.
4개 업무 영역의 API와 데이터베이스 21개 표를 설계하고, 언어를 늘려도 구조를 바꾸지 않는 다국어 저장 방식을 잡았습니다.
프로젝트 상세
1) 포트폴리오 소개 성격이 다른 두 개의 웹 서비스(기술 블로그와 포트폴리오 소개)가 하나의 백엔드를 함께 쓰도록 만든 통합 API 서버입니다. 서비스 카테고리는 콘텐츠 관리·게시 백엔드이며, 메인 타깃은 글과 자료를 직접 등록·수정하는 운영자와 그 내용을 조회하는 방문자입니다. 글과 이미지, 다국어 번역, 방문 통계, 관리자 인증을 한 서버에서 처리하면서 화면 쪽이 변경을 즉시 반영할 수 있게 하
