Docs: 캠퍼스맵 API 명세 추가

components/schemas/campus-map/BuildingDetailResponse.yaml

@@ -0,0 +1,154 @@
+type: object
+description: 캠퍼스맵 건물 상세 조회 응답의 data
+required:
+  - id
+  - name
+  - address
+  - latitude
+  - longitude
+  - imageUrl
+  - operatingHours
+  - 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.541823
+  longitude:
+    type: number
+    format: double
+    description: 건물 경도
+    example: 127.0779007
+  imageUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 건물 이미지 URL. 등록된 이미지가 없으면 null
+    example: https://placehold.co/1200x800/png?text=Student+Center
+  operatingHours:
+    type: array
+    description: 기간·요일별 전체 운영시간. 배열 순서와 관계없이 isCurrent가 true인 항목이 현재 적용되는 운영시간
+    items:
+      $ref: ./OperatingHoursDto.yaml
+  campusPlaces:
+    type: array
+    description: 건물에 등록된 주요시설 및 편의시설 목록
+    items:
+      $ref: ./CampusPlaceDetail.yaml
+example:
+  id: 4
+  name: 학생회관
+  address: 서울특별시 광진구 능동로 120
+  latitude: 37.541823
+  longitude: 127.0779007
+  imageUrl: https://placehold.co/1200x800/png?text=Student+Center
+  operatingHours:
+    - period: SEMESTER
+      dayGroup: WEEKDAY
+      status: SCHEDULED
+      opensAt: '08:00'
+      closesAt: '22:00'
+      isCurrent: false
+    - period: SEMESTER
+      dayGroup: WEEKEND
+      status: SCHEDULED
+      opensAt: '09:00'
+      closesAt: '18:00'
+      isCurrent: false
+    - period: VACATION
+      dayGroup: WEEKDAY
+      status: SCHEDULED
+      opensAt: '09:00'
+      closesAt: '18:00'
+      isCurrent: true
+    - period: VACATION
+      dayGroup: WEEKEND
+      status: UNKNOWN
+      opensAt: null
+      closesAt: null
+      isCurrent: false
+  campusPlaces:
+    - id: 402
+      name: 학생회관 복사실
+      category: printer
+      categoryKorName: 프린터
+      imageUrl: https://placehold.co/1200x800/png?text=Student+Center
+      locationType: INDOOR
+      floor: 1F
+      locationDetail: 학생회관 1층
+      quantity: 2
+      operatingHours:
+        - period: SEMESTER
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '08:00'
+          closesAt: '22:00'
+          isCurrent: false
+        - period: SEMESTER
+          dayGroup: WEEKEND
+          status: SCHEDULED
+          opensAt: '09:00'
+          closesAt: '18:00'
+          isCurrent: false
+        - period: VACATION
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '09:00'
+          closesAt: '18:00'
+          isCurrent: true
+        - period: VACATION
+          dayGroup: WEEKEND
+          status: UNKNOWN
+          opensAt: null
+          closesAt: null
+          isCurrent: false
+      externalUrl: null
+    - id: 406
+      name: 신한은행
+      category: bank_atm
+      categoryKorName: 은행·ATM
+      imageUrl: https://placehold.co/1200x800/png?text=Student+Center
+      locationType: INDOOR
+      floor: 1F
+      locationDetail: 학생회관 1층
+      quantity: null
+      operatingHours:
+        - period: SEMESTER
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '08:00'
+          closesAt: '22:00'
+          isCurrent: false
+        - period: SEMESTER
+          dayGroup: WEEKEND
+          status: SCHEDULED
+          opensAt: '09:00'
+          closesAt: '18:00'
+          isCurrent: false
+        - period: VACATION
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '09:00'
+          closesAt: '18:00'
+          isCurrent: true
+        - period: VACATION
+          dayGroup: WEEKEND
+          status: UNKNOWN
+          opensAt: null
+          closesAt: null
+          isCurrent: false
+      externalUrl: null

components/schemas/campus-map/BuildingListResponse.yaml

@@ -0,0 +1,48 @@
+type: object
+description: 캠퍼스맵 전체 건물 목록 조회 응답의 data
+required:
+  - buildings
+properties:
+  buildings:
+    type: array
+    description: 캠퍼스에 등록된 건물 목록
+    items:
+      $ref: ./BuildingOverview.yaml
+example:
+  buildings:
+    - id: 1
+      name: 행정관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.5444801
+      longitude: 127.0748518
+      displayOrder: 1
+    - id: 2
+      name: 경영관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.5443474
+      longitude: 127.0761119
+      displayOrder: 1
+    - id: 3
+      name: 법학관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.5417036
+      longitude: 127.0750767
+      displayOrder: 1
+    - id: 4
+      name: 학생회관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.541823
+      longitude: 127.0779007
+      displayOrder: 2
+    - id: 10
+      name: 상허기념도서관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.5420474
+      longitude: 127.0738384
+      displayOrder: 2
+    - id: 20
+      name: 과학관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.541467
+      longitude: 127.0805824
+      displayOrder: 3

components/schemas/campus-map/BuildingOverview.yaml

@@ -0,0 +1,40 @@
+title: BuildingOverview
+type: object
+description: 캠퍼스맵 전체 건물 목록에 표시되는 건물 정보
+required:
+  - id
+  - name
+  - address
+  - latitude
+  - longitude
+  - displayOrder
+properties:
+  id:
+    type: integer
+    format: int64
+    description: 건물 ID
+    example: 35
+  name:
+    type: string
+    description: 건물명
+    example: 학생회관
+  address:
+    type: string
+    description: 건물 주소
+    example: 서울특별시 광진구 능동로 120
+  latitude:
+    type: number
+    format: double
+    description: 건물 위도
+    example: 37.541875
+  longitude:
+    type: number
+    format: double
+    description: 건물 경도
+    example: 127.077966
+  displayOrder:
+    type: integer
+    format: int32
+    nullable: true
+    description: 건물 노출 우선순위. 값이 없으면 우선순위가 지정된 건물 다음에 노출됩니다.
+    example: 1

components/schemas/campus-map/BuildingSummary.yaml

@@ -0,0 +1,46 @@
+type: object
+description: 캠퍼스맵 건물 요약 정보
+required:
+  - id
+  - name
+  - address
+  - latitude
+  - longitude
+  - imageUrl
+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.541823
+  longitude:
+    type: number
+    format: double
+    description: 건물 경도
+    example: 127.0779007
+  imageUrl:
+    type: string
+    format: uri
+    nullable: true
+    description: 건물 이미지 URL. 등록된 이미지가 없으면 null
+    example: https://cdn.example.com/campus-map/student-center.jpg
+example:
+  id: 4
+  name: 학생회관
+  address: 서울특별시 광진구 능동로 120
+  latitude: 37.541823
+  longitude: 127.0779007
+  imageUrl: https://cdn.example.com/campus-map/student-center.jpg

components/schemas/campus-map/CampusMapSearchResponse.yaml

@@ -0,0 +1,67 @@
+type: object
+description: 캠퍼스맵 건물 및 시설 통합 검색 응답의 data
+required:
+  - buildings
+  - campusPlaces
+properties:
+  buildings:
+    type: array
+    description: 검색어와 일치하는 건물 목록
+    items:
+      $ref: ./BuildingSummary.yaml
+  campusPlaces:
+    type: array
+    description: 검색어와 일치하는 캠퍼스 시설 목록
+    items:
+      $ref: ./CampusPlaceItem.yaml
+example:
+  buildings:
+    - id: 4
+      name: 학생회관
+      address: 서울특별시 광진구 능동로 120
+      latitude: 37.541823
+      longitude: 127.0779007
+      imageUrl: https://cdn.example.com/campus-map/student-center.jpg
+  campusPlaces:
+    - id: 401
+      name: 학생회관 식당
+      category: restaurant
+      categoryKorName: 식당
+      imageUrl: https://cdn.example.com/campus-map/student-center.jpg
+      locationType: INDOOR
+      floor: 1F
+      locationDetail: 학생회관 1층
+      quantity: null
+      operatingHours:
+        - period: SEMESTER
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '08:00'
+          closesAt: '20:00'
+          isCurrent: true
+        - period: SEMESTER
+          dayGroup: WEEKEND
+          status: UNKNOWN
+          opensAt: null
+          closesAt: null
+          isCurrent: false
+        - period: VACATION
+          dayGroup: WEEKDAY
+          status: SCHEDULED
+          opensAt: '09:00'
+          closesAt: '18:00'
+          isCurrent: false
+        - period: VACATION
+          dayGroup: WEEKEND
+          status: UNKNOWN
+          opensAt: null
+          closesAt: null
+          isCurrent: false
+      externalUrl: null
+      building:
+        id: 4
+        name: 학생회관
+        address: 서울특별시 광진구 능동로 120
+        latitude: 37.541823
+        longitude: 127.0779007
+        imageUrl: https://cdn.example.com/campus-map/student-center.jpg