name: 土地平整工程竣工结算资料（部分）生成
description: >
  从土地平整工程单项工程结算表中提取清理表土、修平田地、田埂修筑三项工序的工程量，
  自动生成 T3 田块单元工程竣工结算资料套表，包含：
  计量报验单、工序工程量统计表、三份工序工程量签证。
version: 1.0.0
author: SuiteForge
tags: [竣工结算, 土地平整, 工程量, 结算资料]
category: 竣工结算

params:
  input_path:
    type: string
    required: true
    desc: >
      用户提供的土地平整工程单项工程工作量结算表路径，支持 .xls / .xlsx 格式。
      该表格应包含"清理表土""修平田地""田埂修筑"三项工序的工程量。
      示例：/home/user/data/单项工程结算表.xls
  output_dir:
    type: string
    required: true
    desc: >
      输出目录路径，生成的竣工结算资料文件存放于此。
      示例：/home/user/output/
  field_name:
    type: string
    required: false
    default: T3田块
    desc: >
      单元工程名称，如 T3田块 / T4田块 / T5田块 等。
      此名称会出现在所有输出文档的标题及相关位置。
      默认值：T3田块
  sub_project_name:
    type: string
    required: false
    default: 水浇地15～25°区域
    desc: >
      分部工程名称，出现在工程量签证文档中。
      默认值：水浇地15～25°区域
  unit_engineer_name:
    type: string
    required: false
    default: 田块修筑
    desc: >
      单位工程名称，出现在工程量签证文档中。
      默认值：田块修筑
  project_name:
    type: string
    required: false
    desc: >
      项目名称，不填则自动从结算表中提取。
  contractor:
    type: string
    required: false
    desc: >
      承包单位名称，不填则自动从结算表中提取。
  contract_section:
    type: string
    required: false
    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_path: $params.input_path
      output_dir: $params.output_dir
      field_name: $params.field_name
      sub_project_name: $params.sub_project_name
      unit_engineer_name: $params.unit_engineer_name
      project_name: $params.project_name
      contractor: $params.contractor
      contract_section: $params.contract_section
      supervision_company: $params.supervision_company
      project_owner: $params.project_owner