Руководство по запуску платформы «Интеллектуальный ИИ-ассистент геолога»

1. Введение

Платформа «Интеллектуальный ИИ-ассистент геолога» поставляется в виде готовых Docker-образов. Исходный код и сборка не требуются — образы загружаются из приложенных .tar-файлов и запускаются одной командой.

Платформа предназначена для построения блочной модели месторождения по данным скважин (Excel) и предсказания литологии всех блоков с помощью нейросети.

2. Требования к системе

• ОС: Linux (Ubuntu 20.04+, Debian 10+, RHEL/CentOS 8+), Windows 10/11, macOS
• CPU: x86_64, от 2 ядер
• RAM: не менее 4 ГБ
• Свободное место на диске: от 4 ГБ
• ПО: Docker CE 20.10+ и Docker Compose v2+

3. Состав дистрибутива

4. Установка Docker и Docker Compose

Если Docker уже установлен — переходите к следующему разделу.

Ubuntu / Debian:

sudo apt update
sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable docker
sudo systemctl start docker

macOS / Windows: установите Docker Desktop (https://www.docker.com/products/docker-desktop/) и убедитесь, что команда docker compose version работает в терминале.

5. Загрузка и импорт Docker-образов

Перейдите в каталог с файлами поставки и загрузите образы:

cd /путь/к/каталогу/с/файлами
docker load -i neurogeo-api.tar
docker load -i neurogeo-neuro.tar
docker load -i neurogeo-front.tar

После загрузки появятся сообщения вида:

Loaded image: neurogeo-api:latest
Loaded image: neurogeo-neuro:latest
Loaded image: neurogeo-front:latest

6. Структура каталога

neurogeo-dist/
├── docker-compose.yml
├── Caddyfile
├── landing.html
├── Инструкция по развертыванию.pdf
├── template.xlsx
├── neurogeo-api.tar
├── neurogeo-neuro.tar
└── neurogeo-front.tar

7. Запуск решения

docker compose up -d

Поднимутся пять сервисов:

• postgres — база данных (схема создаётся автоматически при первом старте);
• api — сервер обработки данных (применяет миграции и слушает запросы);
• neuro — обучение нейросети и предсказание;
• front — веб-интерфейс;
• caddy — прокси и маршрутизация (порт 8000).

Первый запуск занимает до минуты (инициализация БД и применение миграций).

8. Доступ к системе

После запуска решение доступно по адресу:

http://localhost:8000

Или по IP сервера, если развёрнуто на удалённой машине.

Доступ администратора по умолчанию (страница входа — кнопка «Войти»):

9. Остановка и удаление

docker compose down          # остановить, данные в БД сохраняются
docker compose down -v       # остановить и удалить данные (БД с нуля)

10. Структура программного обеспечения

• Клиентская часть: веб-браузер → SPA (React + TypeScript + MUI).
• Прокси: Caddy — единый вход, маршрутизация /api/* → backend, остальное → frontend.
• Backend (api): NestJS (Node.js) — авторизация и роли, парсинг Excel со скважинами, построение блочной модели, выдача прогресса через SSE, миграции БД.
• Сервис нейросети (neuro): FastAPI (Python) + TensorFlow — обучение модели на известных блоках и предсказание литологии всех блоков.
• Хранилище: PostgreSQL — скважины, породы, блочные модели, нейросети, предсказания.

11. Взаимодействие компонентов

1. Пользователь работает с платформой через веб-браузер (порт 8000).
2. Caddy направляет запросы /api/* в backend (api), остальные — во frontend.
3. api парсит загруженный Excel, строит блочную модель, пишет данные в PostgreSQL.
4. При запуске обучения api обращается к сервису neuro; neuro обучает модель и сохраняет предсказание в PostgreSQL.
5. Прогресс долгих операций (построение модели, обучение) отдаётся в браузер через SSE.

12. Контакты для связи

• Генеральный директор — Савостьянов Александр Владимирович, +7 968 567 5907
• Главный разработчик — Кожухов Артем Александрович, +7 929 597 11 81