기존 앱을 Daven에 얹기

​

한 줄

​

세 층

​

불변 조건

1. Hub 시작은 {hostedUrl}?session=&proxy=&locale=를 새 탭으로 연다. locale은 Hub 경로와 같다 (en | kr). 앱 라우트가 ko이면 kr을 ko로 받는다. 교실 기본 실행을 대시보드 iframe으로 두지 않는다.
2. 학생·교사는 Hub에서만 로그인한다. 앱에 Daven / Google / 자체 학생 코드 로그인을 Edu 기본 흐름으로 두지 않는다.
3. 브라우저와 공개 번들에 Daven 키, MCP 키, OPENAI_API_KEY, 학교 payer ID를 넣지 않는다.
4. 클라이언트가 studentId, schoolId, classroomId, payer를 고르지 않는다. GET /api/session/context만 믿는다.
5. Edu 런타임의 AI는 proxy만 탄다. 세션이 없거나 만료되면 EDU_RELAUNCH_REQUIRED로 닫고, 운영자 provider 키로 fallback하지 않는다.
6. 사용자 동작마다 안정적인 operationId를 한 번 만든다. 재시도는 그 ID에서 결정적으로 파생한다. 본문이 다른 요청에 같은 멱등키를 쓰지 않는다.
7. 앱 안 “저장 / 공개 / 다운로드”와 Hub 최종 제출은 다른 버튼이다. 제출 externalArtifactId는 앱 작품 ID다. 같은 ID 재제출만 기존 Hub 행을 갱신한다.
8. shouldRelaunchEducationApp(error)가 true면 작업은 유지하고 Hub에서 다시 열라고 안내한다. 자동 로그인 갱신은 기본값이 아니다.
9. 18세 미만 학생 경로에 Gemini 등 약관상 막힌 provider를 쓰지 않는다.
10. 도메인 프롬프트·검증·화면은 앱에 남긴다. SDK로 옮기는 것은 transport뿐이다.
11. 탭 파비콘은 Classroom Hub 마크 /brand/classroom-logo.png다. 탭 제목은 앱 이름이다. Next / Vercel 기본 아이콘을 남기지 않는다.

​

실행 모드

​

책임 경계

​

최소 코드

import { createDavenEduClient } from "@davenai/sdk/edu";

const daven = createDavenEduClient({
  expectedAppSlug: "your-registered-app-slug",
});

const context = await daven.session.getContext();
const quote = await daven.billing.quote({ mediaType: "image" });
const image = await daven.ai.image.generate({ prompt });

app/lib/ai/text-gateway.ts
app/lib/ai/image-gateway.ts
app/lib/edu/runtime-session.ts
app/lib/edu/submission-gateway.ts

text-gateway.generateText()     → daven.ai.text.generate()
image-gateway.generateImage()   → daven.ai.image.generate()
submission-gateway.submit()     → daven.submissions.submit()
사용자 동작에서 만든 operationId → Idempotency-Key

​

인증 브리지

​

AI 어댑터

​

제출

​

호스트와 탭 아이콘

• 공개 URL은 https://{slug}.edu-app.daven.ai입니다. DNS는 *.edu-app.daven.ai → cname.vercel-dns.com 한 장입니다. 앱을 *.edu.daven.ai에 두지 마세요. 그 존은 Hub / api / dev입니다.
• Vercel 프로젝트에 {slug}.edu-app.daven.ai만 추가합니다. 와일드카드 DNS는 이미 있습니다.
• 탭 파비콘은 Classroom Hub 마크입니다. Hub 파일 dv-edu/apps/web/public/brand/classroom-logo.png를 public/brand/classroom-logo.png로 복사하고, metadata icons.icon / icons.apple에 넣습니다.
• 탭 제목은 앱 이름입니다. 예: Image Studio. 파비콘은 Edu입니다. 앱 자체 로고, Vibe, Next/Vercel 기본 아이콘을 탭에 쓰지 마세요.
• 운영 Vercel에는 DAVEN_API_KEY를 넣지 않습니다. 교실은 Hub session만 씁니다. 키는 로컬 next dev와 Playground 개발 모드 전용입니다.
• Playground Submit → Master Approve. appSlug, appName, hostedUrl을 맞춥니다. 교사 전용 화면이 없으면 supportsTeacherManage를 끕니다.
• 카탈로그 Approve 전에 학생 세션으로 텍스트 1번, 이미지 1번이 실제로 나와야 합니다. 래핑·배포·등록을 한 번에 끝내면 아래 오류가 교실에서 처음 드러납니다.

​

Image Studio에서 깨진 것

​

단계 (다른 앱에 그대로 복사)

• 네트워크 탭에 daven.ai / app.daven.ai 브라우저 호출이 없다.
• 키 없이 같은 generate를 치면 401 또는 relaunch이지, 운영자 키가 끼어들지 않는다.
• 세션을 지워도 초안이 남고, AI만 막힌다.
• 교사 preview 세션으로는 제출이 거절된다.

​

하지 말 것

• Hub를 앱 안에 iframe으로 넣거나, 앱을 Hub 대시보드 iframe이 기본이 되게 하기
• Daven 마케팅 화면, 프로필, 결제, auth.daven.ai를 학생에게 보여 주기
• 앱을 SEED Classroom Hub처럼 다시 그리기 — Hub만 SEED다
• Vibe 워드마크·Braid 그라디언트를 교육앱 브랜드로 쓰기
• Next / Vercel 기본 파비콘을 탭에 남기기 — Edu classroom-logo.png를 씁니다
• “플랫폼 / 솔루션 / AI 키”를 학생 버튼에 쓰기

​

참고 구현