name: 永善县增减挂钩后备资源调查数据库生成
description: 从三调及年度变更数据中提取建设用地，逐层擦除限制要素，生成增减挂钩后备资源调查数据库
version: 1.0.0
author: SuiteForge
tags: [增减挂钩, 建设用地, 叠加分析, 后备资源, 永善县]
category: 城乡建设用地增减挂钩

params:
  db_2019_path:
    type: string
    required: true
    desc: 2019年三调数据库路径，支持 .gpkg / .shp / .gdb 格式
  db_2025_path:
    type: string
    required: true
    desc: 2025年度国土变更调查数据库路径，支持 .gpkg / .shp / .gdb 格式
  restriction_dir:
    type: string
    required: true
    desc: 限制要素目录路径，目录下存放所有限制要素矢量文件（.shp / .gpkg），包括：永久基本农田、生态保护红线、村庄建设边界、国土空间规划重大项目、城镇开发边界、矿权、生态修复项目、历史遗留矿山图斑、长江经济带项目、增减挂钩已验收项目
  output_path:
    type: string
    required: true
    desc: 输出 GeoPackage 文件路径，如 /home/user/output/ys_houbei.gpkg
  layer_2019:
    type: string
    required: false
    desc: 2019年数据库图层名（GeoPackage 格式时指定），不填自动检测
  layer_2025:
    type: string
    required: false
    desc: 2025年数据库图层名（GeoPackage 格式时指定），不填自动检测
  min_area:
    type: number
    required: false
    default: 70
    desc: 最小图斑面积（平方米），小于此面积的将被自动删除
  orthophoto_dir:
    type: string
    required: false
    desc: 正射影像目录（可选），用于生成影像核实清单时记录影像文件路径

base_image: gis-base:latest

steps:
  - id: extract_2019
    name: 提取2019年三调建设用地
    type: python
    script_id: process
    params:
      mode: extract
      db_path: $params.db_2019_path
      layer: $params.layer_2019
      label: 2019年三调建设用地
      output: /tmp/output/step1_2019.gpkg
      log: /tmp/output/process.log

  - id: extract_2025
    name: 提取2025年度变更建设用地
    type: python
    script_id: process
    params:
      mode: extract
      db_path: $params.db_2025_path
      layer: $params.layer_2025
      label: 2025年度变更建设用地
      output: /tmp/output/step2_2025.gpkg
      log: /tmp/output/process.log

  - id: overlay_intersect
    name: 叠加分析取交集
    type: python
    script_id: process
    params:
      mode: overlay
      input1: /tmp/output/step1_2019.gpkg
      input2: /tmp/output/step2_2025.gpkg
      output: /tmp/output/step3_common.gpkg
      log: /tmp/output/process.log
    depends_on: [extract_2019, extract_2025]

  - id: erase_restrictions
    name: 逐层擦除限制要素
    type: python
    script_id: process
    params:
      mode: erase
      input_path: /tmp/output/step3_common.gpkg
      restriction_dir: $params.restriction_dir
      output: /tmp/output/step4_erased.gpkg
      log: /tmp/output/process.log
    depends_on: [overlay_intersect]

  - id: filter_area
    name: 面积过滤与输出成果
    type: python
    script_id: process
    params:
      mode: filter
      input_path: /tmp/output/step4_erased.gpkg
      output: $params.output_path
      log: /tmp/output/process.log
      min_area: $params.min_area
      orthophoto_dir: $params.orthophoto_dir
    depends_on: [erase_restrictions]