# 本地规范检索服务

## 运行环境

- WSL（适用于 Linux 的 Windows 子系统）Ubuntu。
- Python（编程语言）3.12 或兼容版本。

## 安装

在项目根目录执行：

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r standards_service/requirements.txt
```

pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

## 启动

```bash
source .venv/bin/activate
uvicorn standards_service.app:app --host 127.0.0.1 --port 18765
```

默认读取项目根目录下的 `归集617清洗.csv`，默认把查询日志写入 `standards_service/logs/query.jsonl`。

可以通过环境变量覆盖路径：

```bash
export STANDARDS_CSV_PATH=/path/to/standards.csv
export STANDARDS_LOG_PATH=/path/to/query.jsonl
```

## 调用

```bash
curl --noproxy '*' \
  -X POST http://127.0.0.1:18765/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["GB 50330","建筑边坡工程技术规范"]}'
```

每条查询返回 0～3 条候选规范。状态、实施日期和替代情况只作为结果返回，不参与匹配。

## 测试

```bash
source .venv/bin/activate
python -m pytest -q standards_service/tests
```

测试同时覆盖合成数据和项目中的真实规范清单。

## 并发和超时建议

当前服务支持多个 HTTP（网络请求）并发访问。匹配器在启动时加载本地规范库，查询阶段只读内存数据；查询日志在单进程内使用线程锁写入。

本地压测结果显示，单进程 Uvicorn（Python ASGI 服务）下：

- 10 个并发请求，每个请求约 50 条关键词，可以在 5 秒内返回。
- 10 个并发请求，每个请求 100 条关键词，建议调用端超时设置不低于 15 秒。

如果后续使用多进程部署，需要重新设计日志写入方式，避免多个进程同时写同一个 JSONL（逐行结构化日志）文件。