用途:把国家与市场成本基(cost bases)载入 OpenConstructionERP。基目录(2026)含 8 个国家基:TR_NATIONAL 土耳其 Birim Fiyat(22,704 条,TRY,已定价)、ZH_CHINA 中国(11,312,CNY)、BR_NATIONAL 巴西 SINAPI(9,723,BRL)、ES_ANDALUCIA 西班牙 BCCA 2023(6,453,EUR)、IT_TOSCANA 意大利(5,836,EUR)、VN_NATIONAL 越南(4,299,VND,系数、费率 0)、ID_NATIONAL 印尼(2,784,IDR,系数、费率 0)、GR_NATIONAL 希腊(2,647,EUR,部分定价)。另有全球基 CIS-Russia-GESN-FER-TER 下 30 个市场(如 USA_USD、DE_BERLIN、RU_STPETERSBURG)。每个国家基提供 95 列 parquet 及 26 种语言版本,markets/ 文件夹含 48 个 PPP 重定价资源目录。
主要能力与用法:加载基用 POST /api/v1/costs/load-cwicr/TR_NATIONAL,按 rate_code 分组(每工作项一行,components[] 内联),对 (code, region) 幂等,重复调用返回 already_loaded;加载后区域文本切换为该基母语 parquet。校验用 GET /api/v1/costs/regions/stats/、GET /api/v1/costs/?region=TR_NATIONAL&limit=5、GET /api/v1/costs/{id}、GET /api/v1/costs/category-tree/?region=TR_NATIONAL。导入资源目录用 POST /api/v1/catalog/import/TR_NATIONAL,读取 DDC_CWICR_TR_Catalog.csv。PPP 重定价:从 GET /api/v1/costs/base-catalog 选市场卡(如 TR_NATIONAL:DE_BERLIN_de),平台下载该市场 Catalog.csv 并就地对基区域资源价格表重定价。
限制与排错:404 表示无本地 parquet 且 GitHub 下载失败,检查 ~/.openestimator/cache/{db_id}.parquet 与网络;空 currency 表示区域未加入 currency map,需加到 cwicr_v3_catalogue.py/_REGION_CURRENCY;系数基费率 0 对 VN/ID 属预期,需用 ResourcePriceService.seed_region 播种价格;重复行按 (code, region) 折叠,同码多层价格保留首个。其他细节暂未提供。