Docs: 캠퍼스맵 API 명세 추가

components/schemas/campus-map/BuildingDetailResponse.yaml

@@ -0,0 +1,94 @@
+type: object
+description: 캠퍼스맵 건물 상세 조회 응답의 data
+required:
+  - id
+  - name
+  - address
+  - latitude
+  - longitude
+  - imageUrl
+  - currentOperatingHours
+  - campusPlaces
+properties:
+  id:
+    type: integer
+    format: int64
+    description: 건물 ID
+    example: 4
+  name:
+    type: string
+    description: 건물명
+    example: 학생회관
+  address:
+    type: string
+    description: 건물 주소
+    example: 서울특별시 광진구 능동로 120
+  latitude:
+    type: number
+    format: double
+    description: 건물 위도
+    example: 37.5412
+  longitude:
+    type: number
+    format: double
+    description: 건물 경도
+    example: 127.0784
+  imageUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 건물 이미지 URL. 등록된 이미지가 없으면 null
+    example: https://placehold.co/1200x800/png?text=Student+Center
+  currentOperatingHours:
+    $ref: ./CurrentOperatingHours.yaml
+  campusPlaces:
+    type: array
+    description: 건물에 등록된 주요시설 및 편의시설 목록
+    items:
+      $ref: ./CampusPlaceDetail.yaml
+example:
+  id: 4
+  name: 학생회관
+  address: 서울특별시 광진구 능동로 120
+  latitude: 37.5412
+  longitude: 127.0784
+  imageUrl: https://placehold.co/1200x800/png?text=Student+Center
+  currentOperatingHours:
+    period: SEMESTER
+    dayGroup: WEEKDAY
+    status: SCHEDULED
+    opensAt: '08:00'
+    closesAt: '22:00'
+  campusPlaces:
+    - id: 101
+      name: 학생회관 편의점
+      category: convenience_store
+      categoryKorName: 편의점
+      imageUrl: https://placehold.co/600x400/png?text=Convenience+Store
+      locationType: INDOOR
+      floor: 1F
+      locationDetail: 학생회관 정문 오른쪽
+      quantity: null
+      currentOperatingHours:
+        period: SEMESTER
+        dayGroup: WEEKDAY
+        status: SCHEDULED
+        opensAt: '08:00'
+        closesAt: '22:00'
+      externalUrl: null
+    - id: 103
+      name: 신한은행 학생회관 ATM
+      category: bank_atm
+      categoryKorName: 은행·ATM
+      imageUrl: https://placehold.co/600x400/png?text=ATM
+      locationType: INDOOR
+      floor: 1F
+      locationDetail: 서측 출입구 옆
+      quantity: 2
+      currentOperatingHours:
+        period: SEMESTER
+        dayGroup: WEEKDAY
+        status: OPEN_24_HOURS
+        opensAt: null
+        closesAt: null
+      externalUrl: null

components/schemas/campus-map/BuildingListResponse.yaml

@@ -0,0 +1,32 @@
+type: object
+description: 캠퍼스맵 전체 건물 목록 조회 응답의 data
+required:
+  - buildings
+properties:
+  buildings:
+    type: array
+    description: 캠퍼스에 등록된 건물 목록
+    items:
+      $ref: ./BuildingSummary.yaml
+example:
+  buildings:
+    - id: 1
+      name: 행정관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.54241
+      longitude: 127.07382
+    - id: 2
+      name: 경영관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.54196
+      longitude: 127.07531
+    - id: 3
+      name: 법학관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.54174
+      longitude: 127.07649
+    - id: 4
+      name: 학생회관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.5412
+      longitude: 127.0784

components/schemas/campus-map/BuildingSummary.yaml

@@ -0,0 +1,38 @@
+type: object
+description: 캠퍼스맵 건물 요약 정보
+required:
+  - id
+  - name
+  - address
+  - latitude
+  - longitude
+properties:
+  id:
+    type: integer
+    format: int64
+    description: 건물 ID
+    example: 4
+  name:
+    type: string
+    description: 건물명
+    example: 학생회관
+  address:
+    type: string
+    description: 건물 주소
+    example: 서울특별시 광진구 능동로 120
+  latitude:
+    type: number
+    format: double
+    description: 건물 위도
+    example: 37.5412
+  longitude:
+    type: number
+    format: double
+    description: 건물 경도
+    example: 127.0784
+example:
+  id: 4
+  name: 학생회관
+  address: 서울특별시 광진구 능동로 120
+  latitude: 37.5412
+  longitude: 127.0784

components/schemas/campus-map/CampusPlaceDetail.yaml

@@ -0,0 +1,86 @@
+type: object
+description: 건물 상세 화면에 포함되는 시설 정보
+required:
+  - id
+  - name
+  - category
+  - categoryKorName
+  - imageUrl
+  - locationType
+  - floor
+  - locationDetail
+  - quantity
+  - currentOperatingHours
+  - externalUrl
+properties:
+  id:
+    type: integer
+    format: int64
+    description: 시설 ID
+    example: 102
+  name:
+    type: string
+    description: 시설명
+    example: 학생회관 1층 라운지 프린터
+  category:
+    type: string
+    description: 카테고리 목록 조회 API에서 제공하는 카테고리 코드
+    example: printer
+  categoryKorName:
+    type: string
+    description: 카테고리 한글명
+    example: 프린터
+  imageUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 시설 이미지 URL. 등록된 이미지가 없으면 null
+    example: https://placehold.co/600x400/png?text=Printer
+  locationType:
+    type: string
+    description: 시설 위치 유형
+    enum:
+      - INDOOR
+      - OUTDOOR
+    example: INDOOR
+  floor:
+    type: string
+    description: 시설이 위치한 층. 외부 시설은 OUTDOOR
+    example: 1F
+  locationDetail:
+    type: string
+    nullable: true
+    description: 시설의 상세 위치
+    example: 라운지 안쪽
+  quantity:
+    type: integer
+    format: int32
+    minimum: 1
+    nullable: true
+    description: 동일 위치에 있는 시설 수량. 수량 개념이 없으면 null
+    example: 3
+  currentOperatingHours:
+    $ref: ./CurrentOperatingHours.yaml
+  externalUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 시설 관련 외부 페이지 URL. 연결할 페이지가 없으면 null
+    example: https://wein.konkuk.ac.kr/
+example:
+  id: 102
+  name: 학생회관 1층 라운지 프린터
+  category: printer
+  categoryKorName: 프린터
+  imageUrl: https://placehold.co/600x400/png?text=Printer
+  locationType: INDOOR
+  floor: 1F
+  locationDetail: 라운지 안쪽
+  quantity: 3
+  currentOperatingHours:
+    period: SEMESTER
+    dayGroup: WEEKDAY
+    status: SCHEDULED
+    opensAt: '08:00'
+    closesAt: '22:00'
+  externalUrl: null

components/schemas/campus-map/CampusPlaceItem.yaml

@@ -0,0 +1,95 @@
+type: object
+description: 캠퍼스 건물 내부 또는 외부에 있는 시설 정보
+required:
+  - id
+  - name
+  - category
+  - categoryKorName
+  - imageUrl
+  - locationType
+  - floor
+  - locationDetail
+  - quantity
+  - currentOperatingHours
+  - externalUrl
+  - building
+properties:
+  id:
+    type: integer
+    format: int64
+    description: 시설 ID
+    example: 102
+  name:
+    type: string
+    description: 시설명
+    example: 학생회관 1층 라운지 프린터
+  category:
+    type: string
+    description: 카테고리 목록 조회 API에서 제공하는 카테고리 코드
+    example: printer
+  categoryKorName:
+    type: string
+    description: 카테고리 한글명
+    example: 프린터
+  imageUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 시설 이미지 URL. 등록된 이미지가 없으면 null
+    example: https://placehold.co/600x400/png?text=Printer
+  locationType:
+    type: string
+    description: 시설 위치 유형
+    enum:
+      - INDOOR
+      - OUTDOOR
+    example: INDOOR
+  floor:
+    type: string
+    description: 시설이 위치한 층. 외부 시설은 OUTDOOR
+    example: 1F
+  locationDetail:
+    type: string
+    nullable: true
+    description: 시설의 상세 위치
+    example: 라운지 안쪽
+  quantity:
+    type: integer
+    format: int32
+    minimum: 1
+    nullable: true
+    description: 동일 위치에 있는 시설 수량. 수량 개념이 없으면 null
+    example: 3
+  currentOperatingHours:
+    $ref: ./CurrentOperatingHours.yaml
+  externalUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 시설 관련 외부 페이지 URL. 연결할 페이지가 없으면 null
+    example: https://wein.konkuk.ac.kr/
+  building:
+    $ref: ./BuildingSummary.yaml
+example:
+  id: 102
+  name: 학생회관 1층 라운지 프린터
+  category: printer
+  categoryKorName: 프린터
+  imageUrl: https://placehold.co/600x400/png?text=Printer
+  locationType: INDOOR
+  floor: 1F
+  locationDetail: 라운지 안쪽
+  quantity: 3
+  currentOperatingHours:
+    period: SEMESTER
+    dayGroup: WEEKDAY
+    status: SCHEDULED
+    opensAt: '08:00'
+    closesAt: '22:00'
+  externalUrl: null
+  building:
+    id: 4
+    name: 학생회관
+    address: 서울특별시 광진구 능동로 120
+    latitude: 37.5412
+    longitude: 127.0784