document-management/backend/openapi/paths/notifications.yaml

Notifications:
  get:
    operationId: listNotifications
    summary: 查询当前用户站内通知（id倒序，最近200条）
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 通知列表
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/NotificationListResponse'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

NotificationsUnreadCount:
  get:
    operationId: getNotificationUnreadCount
    summary: 查询当前用户未读通知数（红圈徽标数据源）
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 未读数
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/NotificationUnreadCountResponse'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

NotificationsReadAll:
  post:
    operationId: markNotificationsReadAll
    summary: 当前用户通知全部标记已读（打开通知页后清红圈）
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 标记完成（返回更新条数）
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/NotificationReadAllResponse'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

NotificationHandle:
  parameters:
    - name: id
      in: path
      required: true
      schema:
        $ref: '../components/schemas.yaml#/StringId'
  post:
    operationId: handleNotification
    summary: 处理待办通知（仅action=PENDING且归属本人可同意/拒绝）
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '../components/schemas.yaml#/HandleNotificationRequest'
    responses:
      '200':
        description: 处理完成（返回处理后的通知）
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/NotificationResponse'
      '400':
        $ref: '../components/responses.yaml#/InvalidArgument'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '404':
        $ref: '../components/responses.yaml#/NotFound'
      '409':
        $ref: '../components/responses.yaml#/Conflict'
      '500':
        $ref: '../components/responses.yaml#/InternalError'