프로젝트 기록

PROJECT RECORD

기록을 돌아보도록 만든 체질로그

EN 한국어

체질로그는 그날의 감정과 몸 상태, 생활 속 상황을 날짜별로 적고 다시 펼쳐 보는 앱이다. 사상의학에서 쓰는 관찰 표현을 참고하되, 기록을 몇 번 입력했다고 체질을 판정하는 앱으로 만들지는 않으려 했다. 사용자가 남긴 말과 앱이 정리해 보여 주는 내용을 구분하는 것이 설계의 중심이었다.

기록에는 감정, 몸의 반응, 상황과 자유 메모를 담고, 달력과 돌아보기 화면에서는 날짜별 기록이나 자주 나타난 항목을 확인하도록 구성했다. React와 Vite로 웹 화면을 만들고 Capacitor로 Android 앱에 넣었다. Capacitor는 웹 화면을 앱 안에서 띄우면서 파일 저장 같은 기기 기능에 연결해 주는 도구다.

화면을 바꾸면서 기록은 그대로 두기

개선 과정에서는 홈·기록·돌아보기 흐름을 단순하게 만들면서 기존에 쓴 기록이 깨지지 않도록 저장값과 표시값을 나눴다. 감정의 기본값은 哀·怒·喜·樂 같은 한자 키로 남아 있고, 화면에 보여 줄 때는 이를 한국어와 이모지가 붙은 표현으로 바꾼다. 예를 들어 저장된 哀는 화면에서 ‘😢 슬픔(哀)’으로 읽힌다.

한글로 쉽게 보이게 하려고 저장 형식까지 바꾸면 이전 기록을 읽는 코드와 맞지 않을 수 있다. 그래서 표시를 담당하는 emotionDisplay() 함수를 거치게 했다. 몸 상태 선택지도 편안한 신호와 불편한 신호로 나눠 배치하되 저장값은 유지하는 쪽을 택했다. 이런 화면·백업 구현을 다듬는 과정에는 AI의 코드 지원을 받았다.

백업은 파일을 만드는 것에서 끝나지 않았다

기록을 다른 기기로 옮길 수 있도록 JSON 백업과 읽기용 텍스트 내보내기를 넣었다. JSON에는 기록의 식별값과 날짜, 항목별 내용이 들어가 복원에 쓰이고, 텍스트 리포트는 저장한 내용을 읽거나 공유하는 용도다. 같은 ‘내보내기’라도 나중에 앱으로 되돌릴 파일인지 사람이 읽을 파일인지가 다르다.

안드로이드 백업에서는 브라우저의 다운로드 동작만으로 처리하지 않고 기기에 임시 파일을 만든 뒤 운영체제의 공유 창으로 넘기는 경로를 넣었다. 웹에서는 기존 다운로드 방식을 유지한다. 가져오기에서는 식별값과 날짜가 있는 기록을 읽고, 같은 식별값이 이미 있으면 중복해서 추가하지 않는다.

다만 공유 창을 열었다는 사실이 사용자가 파일을 최종 보관했다는 뜻은 아니다. 현재 코드는 공유 창을 취소해도 오류로 처리하지 않으므로, 백업 성공 표시만으로 복원 가능한 파일이 남았다고 단정할 수 없다. 실제 기기에서 저장과 복원을 끝까지 확인할 필요가 남아 있다.

기기에 저장하는 기록과 AI에 보내는 내용

기본 기록은 기기의 브라우저 저장소인 localStorage에 담는다. 여기에 사용자가 자신의 Gemini API 키를 등록해 AI 기능을 사용하는 경로가 더해져 있다. 이때는 기록 텍스트가 Google의 API로 전송되므로 앱의 모든 처리가 기기 안에서만 이루어진다고 설명하면 안 된다.

AI 메모에는 선택한 기록의 감정·몸 반응·상황·자유 메모를 보내고, 흐름 요약에는 최근 기록을 최대 10건까지 묶어 보낸다. 흐름 요약용 자유 메모는 기록당 앞 60자까지만 포함하도록 했다. 고전 구절 찾기에서도 기록 텍스트를 숫자 벡터로 바꾸는 외부 요청이 있다. 이 기능은 기록과 표현이 가까운 구절을 찾는 데 쓰이며, 그 유사성이 건강 상태의 근거가 되지는 않는다.

나는 AI의 역할을 자기관찰 메모와 돌아볼 질문을 정리하는 데 두고, 체질 판정이나 진단·처방을 하지 말라는 지시를 넣었다. 그러나 지시문이 있다는 것과 모든 응답이 그 범위를 지킨다는 것은 다르다. 이 앱의 기록과 생성 메모는 의료 판단이나 효과를 입증하는 자료가 아니다.

등록과 테스트 이후의 상태

체질로그는 2026년 5월 8일 컴퓨터프로그램저작물로 저작권 등록됐다. 등록증의 창작·공표일은 4월 27일이다. 앱은 비공개 테스트와 업로드까지 진행했다. 남아 있는 Android 소스의 설정은 버전 1.6.0, 버전 코드 12이며 앱 번들도 준비돼 있다.

기록을 쓰고 다시 읽는 화면과 기기별 내보내기는 만들었지만, 실제 기기에서 백업을 저장하고 복원하는 확인은 더 필요하다. 2026년 9월 7일 기준으로 현재 공개 스토어 배포 상태와 실제 이용 규모, 수익은 확인하지 못했다.

연구 목록 · 작업 목록

Research index · Work index

Woong Works에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기