openapi: 3.0.0
info:
  title: 订单评论状态 API
  description: 订单评论状态管理相关接口
  version: 1.0.0
  contact:
    name: 订单服务团队
    email: order-service@example.com

servers:
  - url: https://dec-dev.k3d.kuaizu.cn/application
    description: 迪乐租开发环境
  - url: https://ms-dec-dev.k3d.kuaizu.cn/api
    description: 迪乐租ms开发环境
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: header

  schemas:
    Error:
      type: object
      properties:
        code:
          type: integer
          description: 错误码
          example: 1001
        message:
          type: string
          description: 错误信息
          example: 参数错误
        details:
          type: object
          description: 错误详情
          properties:
            field:
              type: string
              description: 错误字段
            reason:
              type: string
              description: 错误原因

    OrderComment:
      type: object
      properties:
        id:
          type: integer
          description: 订单ID
        storeName:
          type: string
          description: 门店名称
        rentStartTime:
          type: string
          description: 实际租赁开始时间
        rentEndTime:
          type: string
          description: 实际租赁结束时间
        rentDays:
          type: integer
          description: 实际租赁时长
        innerTradeNo:
          type: string
          description: 订单号
        
paths:
  /order/order-comments:
    get:
      operationId: listOrderComments
      summary: 获取订单评论订单ID列表
      description: 根据过滤条件分页查询订单ID列表
      security:
        - BearerAuth: []
      tags:
        - 订单评论状态
      parameters:
        - name: storeName
          in: query
          schema:
            type: string
          description: 门店名称（模糊匹配）
        - name: innerTradeNo
          in: query
          schema:
            type: string
          description: 订单号（模糊匹配）
        - name: rentStartTime
          in: query
          schema:
            type: string
            format: "YYYY-MM-DD HH:mm:ss"
          description: 实际租赁开始时间
        - name: rentEndTime
          in: query
          schema:
            type: string
            format: "YYYY-MM-DD HH:mm:ss"
          description: 实际租赁结束时间
        - name: rentDaysOp
          in: query
          schema:
            type: string
            enum: [gt, lt, eq]
          description: 实际租赁时长操作符（gt/lt/eq）
        - name: rentDays
          in: query
          schema:
            type: integer
          description: 实际租赁时长（天）
        - name: commentStatus 
          in: query
          schema:
            type: integer
            enum:
              - 1
              - 2
              - 3
            x-enum-varnames: ["Pending", "Approved", "Rejected"]
            x-enum-descriptions:
              - 待评论
              - 已评论
              - 已取消
          description: 评论状态
          
        - name: commentStartTime
          in: query
          schema:
            type: string
            format: "YYYY-MM-DD HH:mm:ss"
          description: 评价开始时间
        - name: commentEndTime
          in: query
          schema:
            type: string
            format: "YYYY-MM-DD HH:mm:ss"
          description: 评价结束时间
        - name: pageNum
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: 页码
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
          description: 每页数量
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 0
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: 总记录数
                      list:
                        type: array
                        items:
                          type: object 
                          $ref: '#/components/schemas/OrderComment'
        '400':
          description: 参数错误
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: 服务器内部错误
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'


  
tags:
  - name: 订单评论状态
    description: 订单评论状态管理相关接口

x-codegen-request-body-name: request
x-codegen-response-body-name: response 