학생 제출

교육앱에서 학생이 최종 제출할 때 Classroom Hub(LMS)로 보내는 형식입니다.
개발자 Playground → Master 앱 검수 제출과는 별개입니다. JSON Schema: activity-submission.schema.json
OpenAPI: lms-openapi.yaml

원칙

본문은 URL envelope (primaryUrl + assets[])
파일(zip/PDF)은 필요할 때만 attachments로 선택
localhost / blob: URL 금지 — 업로드 후 영구 HTTPS URL만
학생·활동 ID는 Edu 세션에서 확정 (앱이 위조하지 않음)

API

POST /api/v1/activities/{activityId}/submissions
Authorization: Bearer {session}
X-Edu-Session: {session}
Content-Type: application/json

Base: https://edu.daven.ai/api/v1 (로컬 Hub: http://localhost:3001/api/v1) 교사용 목록:

GET /api/v1/activities/{activityId}/submissions

Body

필드	필수	설명
`title`	예	교사 목록 한 줄
`summary`	아니오	미리보기 텍스트
`primaryUrl`	예	교사가 먼저 여는 URL
`assets`	예 (1+)	`role` + `url` (+ mime/label)
`attachments`	아니오	아카이브/인쇄용 파일
`meta`	아니오	앱별 확장 필드

assets[].role: cover · image · audio · video · page · file · other

예시

{
  "title": "벚꽃 시화",
  "summary": "학생이 쓴 시 + 이미지·낭독·음악",
  "primaryUrl": "https://cdn.example/cover.png",
  "assets": [
    {
      "role": "cover",
      "url": "https://cdn.example/cover.png",
      "mimeType": "image/png"
    },
    {
      "role": "page",
      "url": "https://cdn.example/poem.html",
      "mimeType": "text/html"
    },
    {
      "role": "audio",
      "url": "https://cdn.example/tts.mp3",
      "mimeType": "audio/mpeg",
      "label": "낭독"
    }
  ],
  "meta": { "poemTitle": "벚꽃" }
}

LMS / Artifact 매핑

Hub는 제출을 저장한 뒤 갤러리 Artifact로 미러할 수 있습니다.

Submission	Artifact
—	`type: "submission"`
`title`	`title`
`summary`	`summary`
`primaryUrl`	`primaryUrl`
`assets`	`assets`
`attachments`	`attachments`
`meta`	`meta`
record `id`	`submissionId`

앱 개발 (에이전트)

@davenai/mcp 도구:

daven_guidelines  topic=submission

명시적 제출 버튼 → envelope POST → 성공 후에만 “제출 완료” UI.

시작하기

MCP

출시

원칙

API

Body

예시

LMS / Artifact 매핑

앱 개발 (에이전트)

​원칙

​API

​Body

​예시

​LMS / Artifact 매핑

​앱 개발 (에이전트)

원칙

API

Body

예시

LMS / Artifact 매핑

앱 개발 (에이전트)