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 и со стандартами не сверялись. Перед использованием в проекте проверьте их по стандарту.