openapi: 3.1.0
info: {title: HAN Bitrix Sync Connectivity Stub, version: 1.0.0}
paths:
  /health/live:
    get:
      responses:
        "200":
          description: Process is live
          content: {application/json: {schema: {$ref: "#/components/schemas/Live"}}}
  /health/ready:
    get:
      responses:
        "200": {description: Latest PostgreSQL probe is fresh and successful}
        "503": {description: Disabled, stale, or database unavailable}
  /internal/sync/v1/status:
    get:
      security: [{BearerAuth: []}]
      parameters:
        - {name: X-Request-ID, in: header, required: false, schema: {type: string}}
      responses:
        "200":
          description: Connectivity-loop status
          content: {application/json: {schema: {$ref: "#/components/schemas/Status"}}}
        "401": {description: Service authentication failed}
components:
  securitySchemes:
    BearerAuth: {type: http, scheme: bearer}
  schemas:
    Live:
      type: object
      required: [status]
      properties: {status: {const: live}}
    Status:
      type: object
      required: [service, enabled, mode, crm_sync_implemented, state, started_at]
      properties:
        service: {const: bitrix-sync}
        enabled: {type: boolean}
        mode: {const: db_connectivity_stub}
        crm_sync_implemented: {const: false}
        state: {type: string, enum: [starting, disabled, healthy, degraded, stopping]}
        started_at: {type: string, format: date-time}
        last_check: {type: [object, "null"]}
        last_success_at: {type: [string, "null"], format: date-time}
        consecutive_failures: {type: integer, minimum: 0}
        next_check_in_seconds: {type: [number, "null"]}