用途：在 OpenConstructionERP 中浏览、检索造价数据库。成本数据库（2026）包含八个国家级基础库（78,228 个条目）加 30 个全球市场，均采用 95 列的 CWICR 主架构，另有 26 个语言版本和每基础库 48 个 PPP 重定价资源目录。
主要能力与接口：基础选择器 GET /api/v1/costs/base-catalog，用于列出族、变体、货币、条目数和已加载标记；列表与搜索 GET /api/v1/costs/?region=...&q=...&limit=...，为 SQL 关键词搜索，无需 Qdrant 也可用；分类树 GET /api/v1/costs/category-tree/?region=...，层级为 collection → department → section → subsection → category；条目详情 GET /api/v1/costs/{id}，返回完整 components[] 明细、元数据与变体；自动补全 GET /api/v1/costs/autocomplete?q=...，供 BOQ 编辑器快速输入；语义检索走 /qdrant-search（Qdrant），基于 BGE-M3 多语言排序，覆盖 cwicr_<lang>_v3 集合。
分类树：每个条目携带 classification{}，依次为 collection（来源，如 İnşaat）、department（专业）、section（章节）、subsection、category（规范化类型）。中文条目可能只显示部分分类，这是来源范围所致，并非错误。
确定度与变体：部分条目带有抽象资源变体（如混凝土强度等级选择器），条目详情通过 variants[] 暴露各变体价格，选择后会替换 BOQ 行描述与价格。certainty 标记表示条目与 BIM 元素的匹配置信度，低置信度的选择需人工复核。
资源目录：该模块存储各市场的紧凑目录，含 resource_code、名称、类型、类别、单位、price_avg/min/max、货币、usage_count，分类信息位于 specifications 下。系数库（VN、ID）在此生成可编辑的资源价格表，从而可参与估价。
最佳实践与限制：始终按 region 过滤，因为同一代码在不同基础库中价格不同；浏览时以分类树为准，自由文本用于查找。VN/ID 上 rate = 0 应视为“尚未定价”，而非免费工作。资料未提供鉴权、安装命令、配额或收费信息。