First App
개인 실 사용 AI 어시스턴트. provider를 직접 골라 쓰고, 대화는 어디서든 이어갑니다.
이전 프로젝트 C:\june\old는 컨셉만 참고했고 코드는 가져오지 않았습니다.
읽는 순서
이 저장소에는 문서가 3개 있습니다. 위에서부터 읽으면 되고, 이게 전부입니다.
모델 목록은 문서가 아니라 lib/models.ts 한 곳에서만 봅니다. 모델을 추가·삭제할 때 손댈 곳은 저 파일 하나입니다.
빠른 시작
cd C:\june\first_app
Copy-Item .env.example .env.local
npm install
npm run dev
.env.local에 채울 값 (없으면 앱이 열리지 않습니다 — fail-closed):
OPENROUTER_API_KEY=...
GROQ_API_KEY=...
GEMINI_API_KEY=...
APP_PIN=본인이 정한 6자리 숫자
APP_TOKEN=임의의 긴 랜덤 문자열
SUPABASE_URL=https://xxx.supabase.co
SUPABASE_SERVICE_ROLE_KEY=...
.env가 아니라 .env.local입니다. 둘 다 커밋에서 제외됩니다.SUPABASE_SERVICE_ROLE_KEY에 NEXT_PUBLIC_ 접두사를 절대 붙이지 마세요.
이 키는 DB 권한을 완전히 우회하고, 접두사가 붙는 순간 브라우저 번들에 평문으로 실립니다.
자세한 건 docs/RULE.md.
대화 저장이 안 될 때
가장 흔한 함정입니다. SUPABASE_SERVICE_ROLE_KEY가 없으면 저장이 조용히 꺼집니다.
화면은 정상 작동하고 대화도 되기 때문에 눈에 띄는 실패가 없습니다.
- 대화 목록이 안 보이면 이 키부터 확인하세요 (503을 "저장 안 됨"으로 바꿔 보여 줍니다).
SUPABASE_URL은 예전 이름(NEXT_PUBLIC_SUPABASE_URL)도 읽지만 SUPABASE_SERVICE_ROLE_KEY에는 대체 이름이 없습니다.
스키마는 supabase/schema.sql → supabase/single-user.sql 이 순서로 실행해야 합니다.
순서가 반대면 정책이 참조하던 열이 사라져 실패합니다.
그다음 supabase/add-compaction.sql 을 실행하면 긴 대화의 압축이 켜집니다.
이것만 빠져 있으면 앱은 그대로 돌아가며 긴 대화를 예전처럼 잘라 버립니다.
기술 스택
Next.js 16 (App Router) · TypeScript strict · Tailwind v4 · React 19
LLM 호출은 OpenRouter·Groq가 raw fetch, Gemini만 @google/generative-ai SDK를 씁니다 (Vercel AI SDK 미사용).
대화 저장은 Supabase Postgres. 응답은 비스트리밍입니다 — 전체를 받고 나서 렌더링합니다.
알려진 한계
읽어두면 좋은 것만 적었습니다. 자세한 건 docs/BACKLOG.md.
- 접근 보호가 약합니다. 토큰이
sessionStorage에 있어 개발자도구로 볼 수 있고 시도 제한이 없습니다.
"URL만 아는 사람"은 막지만 "집요한 사람"은 막지 못합니다. 의도적으로 이 수준입니다.
- 긴 대화는 앞부분이 요약으로 바뀝니다. 토큰 예산을 넘으면 오래된 메시지를
버리는 대신 요약문을 남깁니다 — 설계와 판단 근거는
lib/compaction.ts에 있습니다.
화면과 DB에는 전부 그대로 남습니다. 줄어드는 것은 모델에게 보이는 것뿐입니다.
요약은 provider를 새로 고르지 않고 이번 턴에 쓰신 provider로 만듭니다.
supabase/add-compaction.sql을 실행하지 않은 배포에서는 조용히 꺼져 있어
예전처럼 그냥 버립니다 — 이때만 "아까 그 얘기"가 풀리지 않습니다.
