openapi: "3.0.3"
info:
  title: "Customer schema for an example usability table"
  version: "1.0.0"
  description: "The usability table on this page splits the examples in a spec into the ones that can become rows and the ones that cannot. An example with a placeholder string like <email> is not a seed even though it validates against the schema. The email example in most specs is one of the placeholders, which is the single most common reason a generated seed is rejected. The tier enum example lists both members, so it is a usable seed for the tier column."
paths: {}
x-domain-id: "spec_customer"
x-dialect: "postgres"
components:
  schemas:
    customers:
      type: "object"
      x-primary-key: "id"
      required: ["id", "email", "name", "tier", "created_at"]
      properties:
        id:
          type: "string"
          format: "uuid"
        email:
          type: "string"
          format: "email"
          x-unique: true
        name:
          type: "string"
        tier:
          type: "string"
          enum: ["free", "pro"]
        created_at:
          type: "string"
          format: "date-time"
