꾸메 — 꿈이 사라지기 전에
일어난 직후, 꿈이 사라지기 전에 잠금화면 위젯에서 곧바로 기록하는 앱.
2026년 2학기 졸업프로젝트 · 1인 개발 · 12주 · iOS.
꿈은 깬 뒤 몇 분 안에 빠르게 잊힌다. 그런데 메모장까지 가는 길은 폰 집기 → 앱 찾기 → 앱 열기 → 새 메모로 길다.
꾸메는 이 길을 폰 집기 → 잠금화면 위젯 누르기 두 단계로 줄인다. 누르는 순간 녹음이 시작되고, 새벽 화면에서는
아무것도 고르게 하지 않는다. 기록은 폰에 먼저 쓰고 서버 동기화는 그다음이다.
| 축 | 하는 일 |
|---|
| 꿈 기록 | 잠금화면 위젯 → 바로 녹음(기기에서 받아쓰기) 또는 적기. 원본 녹음을 함께 보관한다 |
| 꿈 로그 | 남긴 꿈을 다시 보고 고치고 찾는다. 낮에 확인 알림 |
| 꿈 만화 | 꿈을 네 컷 만화로 그린다(Cloudflare Workers AI, 서버를 거침) |
| 꿈 나눔 | 꿈을 익명 닉네임으로 나누고 해몽 댓글 · 공감. 신고 · 차단 · 자동 가림 |
저장소
kkume/
├── mobile/ React Native · Expo SDK 57 · expo-router · TypeScript → mobile/README.md
├── server/ Spring Boot 4.1 · Java 21 · PostgreSQL · Flyway → server/README.md
└── site/ 이용약관 · 개인정보처리방침(GitHub Pages)
돌리기 · 테스트
# 모바일 — 개발 빌드(dev client)가 깔린 아이폰에서
cd mobile
npm ci --legacy-peer-deps
npm start
npx tsc --noEmit
npx eslint app src
node scripts/test-all.mjs # 로직 · 동기화 · 계약 테스트 11종(Node에서, 기기 없이)
# 서버 — Docker만 켜져 있으면 PostgreSQL은 알아서 뜬다
cd server
./gradlew bootRun
./gradlew test # Testcontainers로 진짜 PostgreSQL을 띄운다
PR마다 .github/workflows/ci.yml이 위 검사를 돈다. 잠금화면 위젯 → 녹음 같은 네이티브 진입 경로는 Node 테스트로
재현되지 않아 실기기 확인표로 검증한다.
설계에서 지킨 것
- 기록은 폰(SQLite)에 먼저 쓴다. 새벽에는 네트워크가 없을 수 있고, 기록 유실은 이 앱에서 유일하게 용납되지 않는 실패다.
- 원본 녹음을 함께 보관한다. 받아쓰기가 틀려도 되돌릴 수 있게.
- 새벽 화면에서 사용자가 내리는 결정은 0개다. 모드 선택 · 저장 확인 · 제목 입력을 새벽 흐름에 넣지 않는다.
- 진입점은 잠금화면 위젯 하나다. iOS는 종료된 앱을 알림 응답으로 깨워 주지 않아, 알림으로 기록을 받으면 새벽 기록이 사라진다.
- AI 호출은 서버를 거친다. 앱에 키를 넣지 않고, 만화는 하루 한도와 실제 원가(
comic_costs)를 서버가 관리한다.
작업 규칙과 결정의 이유는 CLAUDE.md(개발 지침), server/README.md · server/deploy/README.md(서버 · 배포)에 있다.
