组件市场与代码仓库：资产分发与口径复用

1. 打开"商品市场"（/foundry/marketplace），点发布
2. 来源类型选 metric，来源 ID 填指标 api_name：sales_amount
3. 填商品名 / 描述 / 标签（如"销售额指标"、"销售、指标"），点发布
4. 在商品列表核对 rid、版本、状态与下载数

{ "code": 0, "data": {
  "id": 5, "rid": "marketplace:metric:sales_amount",
  "item_type": "metric", "name": "销售额指标",
  "version": 1, "status": "published", "downloads": 0, "author": "admin",
  "payload": { "format": "json", "content": {
      "entity": { "name": "sales_order_entity", ... },
      "object_type_name": "sales_order",
      "dimensions": [...], "measures": [...],
      "metric": { "name": "sales_amount", "measure": "total_amount", ... } } } } }

1. 在商品市场找到 sales_amount 商品，点"安装"
2. 看返回记录 status 与 target_ref
3. 再装一次，观察 target_ref 带 _imported_<ts> 后缀、downloads +1
4. 对另一商品 PUT status=unlisted，再点安装观察拒绝

POST /api/v1/marketplace/items/5/install
->
{ "code": 0, "data": { "id": 12, "item_id": 5, "version": 1,
    "status": "success", "target_ref": "metric:sales_amount" } }

{ "code": "VALIDATION_ERROR", "error": "unlisted 商品不可安装" }

1. POST /api/v1/coderepo/repos 建 macro 仓库"公共口径宏"
2. POST /coderepo/repos/:id/files 添加 region_filter（内容 AND region = '华东'）与 active_status
3. 在 SQL 工作台写含 {{macro:region_filter}} {{macro:active_status}} 的 SELECT
4. 用 POST /coderepo/macros/resolve 调试展开结果

POST /api/v1/coderepo/repos { "name": "公共口径宏", "repo_type": "macro" }
-> { "code": 0, "data": { "id": "6a1f...", "name": "公共口径宏",
     "repo_type": "macro", "owner": "admin" } }
POST /api/v1/coderepo/repos/6a1f.../files
{ "path": "region_filter", "content": "AND region = '华东'" }
-> { "code": 0, "data": { "id": "9b2c...", "repo_id": "6a1f...",
     "path": "region_filter", "version": 1 } }

POST /api/v1/coderepo/macros/resolve
{ "sql": "SELECT region, SUM(amount) FROM orders WHERE amount > 100 {{macro:region_filter}} {{macro:active_status}} GROUP BY region" }
->
{ "code": 0, "data": { "sql": "SELECT region, SUM(amount) FROM orders WHERE amount > 100 AND region = '华东' AND status IN ('pending','shipped') GROUP BY region" } }

1. POST /coderepo/repos 建 template 仓库，POST /repos/:id/files 添加 monthly_report.sql（v1）
2. PUT /coderepo/files/:id 覆盖为 v2（旧 v1 归档），再覆盖为 v3（v2 归档）
3. GET /coderepo/files/:id/revisions 查看版本历史
4. 前端点"恢复"v2（恢复=覆盖写入，产生新版本）

PUT /api/v1/coderepo/files/9b2c... { "content": "报告B" }
->
{ "code": 0, "data": { "id": "9b2c...", "path": "monthly_report.sql",
    "version": 2, "updated_by": "alice" } }

GET /api/v1/coderepo/files/9b2c.../revisions
->
{ "code": 0, "data": { "revisions": [
    { "version": 2, "content": "报告B", "updated_by": "alice", "updated_at": "..." },
    { "version": 1, "content": "报告A", "updated_by": "alice", "updated_at": "..." } ],
  "total": 2 } }