version: "1.0"

survey:
  id: "spring-migration-2026"
  name: "Spring Migration Bird Survey"
  description: "Community observations of migratory and resident birds."
  timezone: "America/Toronto"
  season:
    starts_at: "2026-03-15"
    ends_at: "2026-06-15"
  observation_window:
    start_time: "05:30"
    end_time: "10:30"
  protocols:
    - stationary_count
    - traveling_count
  default_duration_minutes: 15
  maximum_travel_distance_km: 5

locations:
  allowed_countries:
    - CA
    - US
  habitats:
    - forest
    - grassland
    - wetland
    - urban
    - coastal
    - agricultural
  require_coordinates: true
  coordinate_precision_meters: 25

observations:
  required_fields:
    - observer_id
    - observed_at
    - latitude
    - longitude
    - protocol
    - species
    - count
    - effort
  species_reference: "eBird/Clements v2025"
  allow_unknown_species: true
  allow_zero_counts: true
  media:
    enabled: true
    accepted_types:
      - image/jpeg
      - image/png
      - audio/mpeg
      - audio/wav
    maximum_file_size_mb: 25
  effort:
    require_duration: true
    require_distance_for_traveling_counts: true
    require_party_size: true

quality_control:
  validate_coordinates: true
  reject_future_timestamps: true
  flag_out_of_season_records: true
  flag_rare_species: true
  flag_high_counts: true
  duplicate_detection:
    enabled: true
    time_tolerance_minutes: 5
    distance_tolerance_meters: 50
  expert_review:
    required_for:
      - unknown_species
      - rare_species
      - range_anomaly
      - count_anomaly

privacy:
  observer_names: "private"
  sensitive_species_coordinates:
    visibility: "obscured"
    radius_km: 10
  public_location_precision_meters: 1000
  retain_contact_information_days: 365

notifications:
  submission_receipt:
    enabled: true
    channels:
      - email
  review_updates:
    enabled: true
    channels:
      - email
  emergency_alerts:
    enabled: false

exports:
  formats:
    - csv
    - geojson
    - darwin-core
  schedule: "0 3 * * *"
  destination: "s3://citizen-science-exports/spring-migration-2026/"
  include_flagged_records: false
  license: "CC-BY-4.0"

api:
  base_path: "/v1/bird-survey"
  rate_limit:
    requests_per_minute: 120
  authentication:
    participant_submissions: "oauth2"
    public_exports: "none"

monitoring:
  healthcheck_path: "/health"
  metrics:
    enabled: true
    path: "/metrics"
  alerts:
    failed_export_threshold: 2
    review_backlog_threshold: 500
    notification_email: "survey-ops@example.org"