Skip to main content
Glama
pid-ref

pid-ref

by meloman112
README.md
# pid-symbols-reference

Справочник условных обозначений для P&ID и технологических схем: ISO 10628-2, ISA 5.1, ГОСТ 21.208, ГОСТ 2.780, 2.782, 2.784, 2.785, 2.788–2.795, DIN 2429.
838 символов. У каждого есть SVG, название RU/EN, стандарт, назначение, где ставить, типичные ошибки и похожие символы.
Есть типовые узлы по ГОСТ: обвязка регулирующего клапана, насосная установка с резервом, контур уровня.
В них каждый элемент кликабелен и открывает свою карточку. Ещё есть расшифровка тегов приборов по буквам (PDIT-101, TIC, LSHH) по ГОСТ 21.208 и ISA 5.1.

Что есть:
- **Веб** (без LLM): поиск, фильтры по стандарту и категории, карточка символа, скачивание SVG, правка описаний.
- **Редактор схем** (`/editor`): символы ГОСТ перетаскиваются на лист, трубопроводы и линии связи
  прилипают к точкам подключения, исполнительный механизм сам садится на клапан, тег прибора сразу расшифровывается.
  Схемы хранятся на сервере, выгружаются в SVG, PNG и DXF (AutoCAD, Компас, nanoCAD; 1 единица листа = 0,25 мм).
- **MCP-сервер**: подключается к Gemini CLI, Claude Code или любому MCP-клиенту, чтобы LLM искала символы в справочнике.

## Запуск

    docker compose up -d

- Веб: http://localhost:8080
- MCP: http://localhost:8081/mcp (streamable HTTP)

Настройки — в файле `.env` рядом с `compose.yaml`:

    EDIT_PASSWORD=придумайте-пароль   # без него всё только на чтение: ни правки описаний, ни сохранения схем
    WEB_PORT=8790                     # если 8080 занят
    MCP_PORT=8791                     # если 8081 занят

База лежит в `data/pid.db` и подключена в контейнеры как volume, поэтому правки из веба сохраняются на диске.

## Подключение MCP

Gemini CLI, файл `~/.gemini/settings.json`:

    {"mcpServers": {"pid-ref": {"httpUrl": "http://<хост>:8081/mcp"}}}

Claude Code, файл `.mcp.json`:

    {"mcpServers": {"pid-ref": {"type": "http", "url": "http://<хост>:8081/mcp"}}}

Инструменты:
- `search_symbols(query, standard, category, limit)` — поиск символов;
- `get_symbol(symbol_id)` — полная карточка символа;
- `get_assemblies()` — типовые узлы: описание, на что обратить внимание, состав;
- `decode_tag(tag)` — расшифровка тега прибора по буквам.

MCP только читает базу.

Читать справочник и схемы может любой в сети. Правка описаний и сохранение схем — только после входа по паролю
`EDIT_PASSWORD`. Пароль передаётся по HTTP открытым текстом, поэтому порт держите в локальной сети.

## Без Docker

    python -m venv .venv && .venv/bin/pip install -r requirements.txt
    EDIT_PASSWORD=... .venv/bin/python web.py 8080
    .venv/bin/python mcp_server.py 8081   # без порта запускается по stdio

## Сборка данных

`data/pid.db` уже собрана. Скрипты ниже нужны только для пересборки, повторный запуск ничего не ломает.

    scripts/harvest_iso.py                 # ISO 10628-2: SVG с Wikimedia Commons
    scripts/harvest_din.py                 # приводы DIN 2429 с Commons
    scripts/harvest_kuphaldt.py liii.pdf   # ISA 5.1 из книги Kuphaldt (ссылка на PDF в скрипте)
    scripts/gen_symbols.py                 # ГОСТ 21.208 и 2.785 по рисункам стандартов
    scripts/gen_gost_2_784.py              # ГОСТ 2.784
    scripts/gen_gost_2_788.py … 2_795.py   # ГОСТ 2.788–2.795: оборудование химических производств
    scripts/gen_gost_2_782.py              # насосы ГОСТ 2.782 и фильтр ГОСТ 2.780 для узлов
    scripts/gen_assemblies.py              # типовые узлы из символов базы → svg/assemblies, таблицы assemblies
    scripts/load_letters.py                # буквенные коды ГОСТ 21.208 и ISA 5.1
    scripts/enrich.py export|apply         # описания: work/todo_*.json → LLM → work/done_*.json → база

Что покрыто, откуда взято и что неточно, описано в `catalog/inventory.md`.

## Лицензии

- Код: MIT, см. `LICENSE`.
- Рисунки ISO 10628-2 и DIN 2429 взяты с Wikimedia Commons под лицензией CC BY-SA 4.0 или Public Domain. Автор и ссылка на источник есть в карточке каждого символа.
- Рисунки ISA 5.1 вырезаны из книги T. R. Kuphaldt «Lessons In Industrial Instrumentation», лицензия CC BY 4.0.
- Рисунки ГОСТ нарисованы заново по таблицам стандартов. Тексты стандартов в репозиторий не входят.
- Шрифт Golos Text — SIL Open Font License.
- Описания сгенерированы LLM и со стандартами не сверялись. Перед использованием в проекте проверьте их по стандарту.