package dto /************ updateOrSaveIotTouTemplate（新增/更新模板） ************/ // FwhTestTouTemplateDetailVo 时段明细 // 说明：字段统一用 string，未设置传空串 ""；有值时按下方各字段说明的数值格式填写（与前端 HAR 行为一致）。 type FwhTestTouTemplateDetailVo struct { StartHourTime string `json:"startHourTime"` // 开始时间 格式 HH:mm，如 06:30 EndHourTime string `json:"endHourTime"` // 结束时间 格式 HH:mm，需与下一个 startHourTime 重叠，所有时段需覆盖一整天 WaveType string `json:"waveType"` // 峰平谷定义(flag) 数值：0-谷 1-平 2-峰 3-尖峰 4-低谷 Name string `json:"name"` // 时段名 一般为 supper-off-peak、off-peak、mid-peak、on-peak、supper-on-peak 等 BriefDescribe string `json:"briefDescribe"` // 时段描述 SolarPriority string `json:"solarPriority"` // 光伏供电优先级 格式 "市电,负载,FHP"，如 "1,3,2"；优先级 0/1/2/3，可相同(表示按比例/功率分配)，0-不涉及，数字越大优先级越高 GridDischargeMax string `json:"gridDischargeMax"` // 电池最大允许馈网功率 数值(单位kW，精度0.1)；可选，默认0不能馈网；0-不可馈网，-1-不限制 GridChargeMax string `json:"gridChargeMax"` // 电网允许最大充电功率 数值(单位kW，精度0.1)；可选，默认0不允许；0-不允许，-1-不限制 ChargePower string `json:"chargePower"` // 固定电池充电功率 数值(单位kW，精度0.1)，按单台功率计算；可选，默认-1未设置 DischargePower string `json:"dischargePower"` // 固定电池放电功率 数值(单位kW，精度0.1)，按单台功率计算；可选，默认-1未设置 ChargeMax string `json:"chargeMax"` // 电池最大允许充电功率 数值(单位kW，精度0.1)，按单台功率计算；-1-无限制，默认-1 DischargeMax string `json:"dischargeMax"` // 电池最大允许放电功率 数值(单位kW，精度0.1)，按单台功率计算；-1-无限制，默认-1 GcaoMax string `json:"gcaoMax"` // GCAO(grid charge after an outage) 停电后补电至预留SOC的单台市电取电功率 可选；0-不允许，-1-不限制；默认未设置(-3)；使能后未设值则为 5kw*N(用-2标识) LoadPriority string `json:"loadPriority"` // 负载取电优先级 格式 "市电,光伏,FHP"，如 "1,3,2"；优先级 0/1/2/3，可相同(表示按比例/功率分配)，0-不使用此源，数字越大优先级越高 GridFeedMax string `json:"gridFeedMax"` // 电网允许最大馈网功率 数值(单位kW，精度0.1)；可选，默认-2；0-不允许，-1-不限制，-2-未设置 GridMax string `json:"gridMax"` // 电网允许最大取电功率 数值(单位kW，精度0.1)；可选，默认-1不限制；0-不允许，-1-不限制 MinDischargeSoc string `json:"minDischargeSoc"` // 放电截止SOC 数值(单位%，整数)；达到此SOC后电池不放电，可选，默认0%；若 reserved_soc 大于此值则以 reserved_soc 为准 MaxChargeSoc string `json:"maxChargeSoc"` // 充电截止SOC 数值(单位%，整数)；可选，默认100% HeatEnable string `json:"heatEnable"` // 充电加热使能 数值：0-未设置(默认) 1-不使能 2-使能 PowerOffApower string `json:"powerOffApower"` // 主动关闭APower 可选，0-不控制(默认) 1-关机 2-开机(预留) RampTime string `json:"rampTime"` // 爬坡时间 数值(单位秒，0~300)；默认0，BB套餐默认300 OffGrid string `json:"offGrid"` // 主动断开市电继电器 数值：0-不控制(默认) 1-断开 2-闭合(预留) SolarCutoff string `json:"solarCutoff"` // 主动断开光伏继电器 数值：0-不控制(默认) 1-断开 2-闭合(预留) } // FwhTestTouTemplateStrategy 策略（季节/日类型 + 时段明细列表） type FwhTestTouTemplateStrategy struct { CcociateType string `json:"ccociateType"` // 关联类型 数值编码，如 1 CcociateSn string `json:"ccociateSn"` // 关联设备SN DetailVoList []FwhTestTouTemplateDetailVo `json:"detailVoList"` // 时段策略表，所有配置的时间需覆盖一整天 SeasonName string `json:"seasonName"` // 季节名 用于标识策略范围，可自定义，如 summer、All months Month string `json:"month"` // 逗号分隔的月份，如 1,2,3... DayName string `json:"dayName"` // 日期类型的可读名称，如 Every day、Weekdays（与 dayType 对应） DayType string `json:"dayType"` // 日期类型 数值编码(非自定义字符串)，如 3-Every day；可读名见 dayName // 购电电价（各时段单价；未设置传 null） EleticRatePeak *float64 `json:"eleticRatePeak"` // 峰时购电电价 EleticRateShoulder *float64 `json:"eleticRateShoulder"` // 平时购电电价 EleticRateValley *float64 `json:"eleticRateValley"` // 谷时购电电价 EleticRateSharp *float64 `json:"eleticRateSharp"` // 尖峰购电电价 EleticRateSuperOffPeak *float64 `json:"eleticRateSuperOffPeak"` // 超低谷购电电价 EleticRateGridFee *float64 `json:"eleticRateGridFee"` // 电网附加费 // 卖电（上网）电价（各时段单价；未设置传 null） EleticSellPeak *float64 `json:"eleticSellPeak"` // 峰时卖电电价 EleticSellShoulder *float64 `json:"eleticSellShoulder"` // 平时卖电电价 EleticSellValley *float64 `json:"eleticSellValley"` // 谷时卖电电价 EleticSellSharp *float64 `json:"eleticSellSharp"` // 尖峰卖电电价 EleticSellSuperOffPeak *float64 `json:"eleticSellSuperOffPeak"` // 超低谷卖电电价 } // FwhTestTouTemplateInfo 模板主体 // templateId：创建模板时省略此字段(nil)；更新模板时必须带此字段并填入模板ID。读取(detail/list)返回时该字段必定存在。 type FwhTestTouTemplateInfo struct { CountryId string `json:"countryId"` // 国家ID 数值 ProvinceId string `json:"provinceId"` // 州/省ID 数值 DerSchdule string `json:"derSchdule"` // DER 调度配置 EleCompanyFullName string `json:"eleCompanyFullName"` // 电力公司全称 ElectricCompany string `json:"electricCompany"` // 电力公司 GridType string `json:"gridType"` // 电网类型 ElectricityType string `json:"electricityType"` // 电价类型 数值：1-分时电价 2-阶梯电价 3-固定电价 4-分时&阶梯电价 5-BB套餐 6-Peak Demand Name string `json:"name"` // 模板/策略表名称 MookRunCount string `json:"mookRunCount"` // 模式执行次数(loop) 数值：0-不限次数 1-执行一次 Priority string `json:"priority"` // 模式优先级 数值，默认0，0最低，数字越大优先级越高 Env string `json:"env"` // 模式使用条件 数值(位域)，默认0；bit0~1 光伏；bit2~3 馈网；bit4~5 电网充电 TemplateId *string `json:"templateId,omitempty"` // 模板ID 数值；创建时省略(nil)，更新时必填。读取返回时必定存在 SourceType string `json:"sourceType"` // 模板类型 数值，必填；当前仅允许 0-系统模板（1-API模板 2-用户推荐 暂不支持写入） } // FwhTestUpdateOrSaveTouTemplatePayload 新增/更新模板请求体（JSON） type FwhTestUpdateOrSaveTouTemplatePayload struct { Template FwhTestTouTemplateInfo `json:"template"` StrategyList []FwhTestTouTemplateStrategy `json:"strategyList"` Lang string `json:"lang"` } /************ selectCitesList（查询国家下的省/市列表） ************/ // FwhTestCityInfo 城市 type FwhTestCityInfo struct { Id int `json:"id"` NameEn string `json:"nameEn"` NameZh string `json:"nameZh"` Latitude string `json:"latitude"` Longitude string `json:"longitude"` } // FwhTestProvinceInfo 省/州（可能包含 cityList） type FwhTestProvinceInfo struct { Id int `json:"id"` NameEn string `json:"nameEn"` NameZh string `json:"nameZh"` Latitude string `json:"latitude"` Longitude string `json:"longitude"` CityList []FwhTestCityInfo `json:"cityList"` } // FwhTestCountryInfo 国家 type FwhTestCountryInfo struct { Id int `json:"id"` NameEn string `json:"nameEn"` NameZh string `json:"nameZh"` Latitude string `json:"latitude"` Longitude string `json:"longitude"` } // FwhTestCitesListData selectCitesList 返回结构 type FwhTestCitesListData struct { CountryList []FwhTestCountryInfo `json:"countryList"` ProvinceList []FwhTestProvinceInfo `json:"provinceList"` CityList []FwhTestCityInfo `json:"cityList"` }