goals.md

Goals API

홈/목표 위젯용 데이터입니다. 학교의 목표 표시 설정과 로그인한 사용자의 기록·필수 양식 진행 요약 등을 반환합니다. 수업 요약은 프론트엔드에서 목록 UI와 맞춰 계산합니다.

라우트 파일: backend/src/routes/goals.js
컨트롤러 파일: backend/src/controllers/goals.js
서비스: backend/src/services/goals.js

---

엔드포인트 요약

메서드	경로	설명	권한
GET	/api/goals/me	내 목표/진행 요약	isLoggedIn

---

내 목표 조회

GET /api/goals/me?school=&season=

권한: isLoggedIn

쿼리

필드	타입	필수	설명
school	string	O	학교 ObjectId
season	string	X	학기 ObjectId (역할·문맥 결정). 없으면 최근 등록 역할 사용

동작

1. 학교의 goalsEnabled가 false이면 403입니다.
2. 등록 역할(teacher / student)에 맞는 goalDisplay를 병합합니다.
3. 표시가 켜진 항목에 대해 기록(archive) 라벨별 건수, 필수 Alt Form 진행 등을 담아 반환합니다.

응답 (200)

응답 필드는 학교 goalDisplay 설정에 따라 달라질 수 있습니다. 대표적인 형태:

{
  "role": "student",
  "display": { },
  "archive": [
    { "label": "상담", "count": 2, "dataType": "object" }
  ],
  "board": {
    "submitted": 1,
    "total": 3,
    "forms": []
  }
}

오류

상태	조건
400	school 누락
403	목표 기능 비활성 (goalsEnabled === false)
404	학교 없음

---

관련 문서

• 학생 기록 API
• API 개요