# 格士立全球运输本体开发环境 v3

这是格士立全球运输与自主货代运营本体的开发环境。青岛出口继续作为第一组测试样例，但本体本身不再受青岛、出口或单一运输方式限制。

你打开这个文件夹后，应该看到：

```text
README.md
docker-compose.yml
ontology/
data/
queries/
app/
tests/
docs/
```

## 这个环境有什么

- `ontology/global-shipment.ttl`：全球运输与自主货代运营本体
- `data/qingdao-export-sample.ttl`：青岛出口样例数据
- `queries/order-status.rq`：查询订单当前状态
- `queries/risk-orders.rq`：查询有风险的订单
- `queries/operation-flow.rq`：查询青岛出口标准流程
- `queries/exception-risk-map.rq`：查询异常影响节点和风险
- `queries/node-time-status.rq`：查询节点计划时间、截止时间和完成状态
- `queries/order-cutoff-times.rq`：查询订单截关、截港、VGM和预计开船时间
- `queries/business-partners.rq`：查询统一的往来单位，包括客户和平台供应商
- `queries/business-partner-contacts.rq`：查询统一的往来单位联系人
- `queries/customer-profile-summary.rq`：查询客户画像摘要
- `queries/customer-counterparty-network.rq`：查询客户交易对象网络
- `queries/customer-transaction-records.rq`：查询客户询价/交易记录，包含成交和未成交
- `queries/platform-supplier-classification.rq`：查询格士立货代平台供应商分类和地域服务范围
- `queries/platform-supplier-profile-summary.rq`：查询平台供应商画像摘要
- `queries/supplier-product-quotes.rq`：查询产品品牌、具体产品、供应商产品关系及供应商报价
- `queries/product-performance.rq`：查询产品本身的班期、时效和路由履约表现
- `queries/ai-market-recommended-prices.rq`：查询市场基准、产品策略、AI市场推荐价格、客户溢价及最终报价
- `queries/supplier-share-governance.rq`：查询预留的平台供应商份额治理策略及启用状态
- `docs/customer-supplier-profile-mapping.md`：客户画像与平台供应商画像对应关系
- `docs/product-supplier-market-model.md`：产品、供应商、组合方案和AI市场推荐价格模型
- `app/main.py`：简单接口服务
- `tests/basic_check.py`：基础检查脚本
- `docker-compose.yml`：启动 Fuseki 本体数据库

## 第一步检查

在 Cursor 终端里运行：

```bash
python3 tests/basic_check.py
```

如果看到：

```text
基础检查通过
```

说明文件是完整的。

## 第二步启动本体数据库

如果你的电脑有 Docker，在 Cursor 终端里运行：

```bash
docker compose up -d
```

然后打开：

```text
http://localhost:3030
```

账号密码：

```text
admin / admin
```

## 启动操作员前端

确认 Fuseki 已经运行，并且 `gesli` 数据集已经依次导入 `ontology/global-shipment.ttl` 和 `data/qingdao-export-sample.ttl` 后，在本目录运行：

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload
```

打开：

```text
http://localhost:8000
```

前端会显示：

```text
订单状态
风险订单
标准流程
节点时间状态
订单关键时限
异常影响
```

## 给你的判断标准

如果 Cursor 左边看不到 `README.md`、`ontology`、`data`、`queries`，说明打开的不是这个文件夹。