name: 土地平整工程竣工结算资料（部分）生成
description: >
  从用户提供的工程量结算前后对比表中提取水浇地15～25°区域各田块的
  清理表土、修平田地、田埂修筑三项工序的工程量，
  生成分部工程工程量汇总表及各田块的竣工结算资料套表
  （计量报验单、工序工程量统计表、工序工程量签证）。
version: 2.0.0
author: SuiteForge
tags: [竣工结算, 土地平整, 工程量, 结算资料, 分部工程]
category: 竣工结算

params:
  input_table_path:
    type: string
    required: true
    desc: >
      用户提供的工程量结算前后对比表路径，支持 .xls / .xlsx 格式。
      该表格应包含"土地平整工程 → 水浇地15～25°区域"下各田块
      （T3～T72 等）的清理表土、修平田地、田埂修筑三项工序的工程量明细。
      示例：/home/user/data/鸡噜工程量结算前后对比表.xlsx
  output_dir:
    type: string
    required: true
    desc: >
      输出目录路径，生成的竣工结算资料文件存放于此。
      示例：/home/user/output/
  generate_all_fields:
    type: string
    required: false
    default: "true"
    desc: >
      是否生成所有田块的独立竣工结算资料（计量报验单+统计表+3份签证）。
      true=生成全部田块，false=只生成第一个田块。
      默认值：true
  subcontractor_name:
    type: string
    required: false
    desc: >
      承包单位名称，如：昭通市北城建筑工程公司
      不填则留空，可手动补充。
  contract_section:
    type: string
    required: false
    desc: >
      合同段，如：一标段
  sub_project_name:
    type: string
    required: false
    default: 水浇地15～25°区域
    desc: >
      分部工程名称，出现在工程量签证文档中。
      默认值：水浇地15～25°区域
  unit_engineer_name:
    type: string
    required: false
    default: 田块修筑
    desc: >
      单位工程名称，出现在工程量签证文档中。
      默认值：田块修筑
  supervision_company:
    type: string
    required: false
    default: 曲靖南天监理有限公司
    desc: >
      监理单位名称。
      默认值：曲靖南天监理有限公司
  project_owner:
    type: string
    required: false
    default: 巧家县国土资源局
    desc: >
      建设单位/业主单位名称。
      默认值：巧家县国土资源局

base_image: gis-base:latest

steps:
  - id: generate_docs
    name: 生成竣工结算资料
    type: python
    script_id: generate
    params:
      input_table_path: $params.input_table_path
      output_dir: $params.output_dir
      generate_all_fields: $params.generate_all_fields
      contractor: $params.subcontractor_name
      contract_section: $params.contract_section
      sub_project_name: $params.sub_project_name
      unit_engineer_name: $params.unit_engineer_name
      supervision_company: $params.supervision_company
      project_owner: $params.project_owner