MOD-FUEL — Топливо и АЗС
Лицензия: Платный
Топливная база для планирования и контроля затрат: справочник АЗС с сетью, координатами, регионом, видами топлива, доступом грузового транспорта и приёмом карт. Цены поступают из источников разного типа — транзакционных, парсеров, официальных, — и модуль их не усредняет вслепую: каждая котировка хранится отдельно с датой наблюдения и ссылкой, а «достоверная цена» выводится по модели доверия с уровнем уверенности и честными флагами «данные устарели», «источники расходятся», «источник один».
Прикладной выход — деньги: смета заправки по конкретной АЗС (объём вручную или «до полного бака» по данным телематики), скидка топливной карты, которая действует только на сетях эмитента, и репрезентативная цена топлива для сметы маршрута. Все суммы — в копейках, наличие топлива отдаётся честно: да, нет или «неизвестно», без выдумывания за отсутствующие данные.
Возможности
- Справочник АЗС: сеть, координаты, регион, виды топлива, доступ грузовиков, приём карт
- Поиск АЗС по прямоугольнику на карте, региону, сети и виду топлива
- Источники цен трёх типов (транзакционные, парсеры, официальные) с настраиваемым доверием
- Раздельные котировки источников без усреднения, с датой наблюдения и ссылкой
- Достоверная цена с уровнем уверенности, провенансом и флагами устаревания и расхождения
- Ручной и пакетный приём котировок с нормализацией обозначений топлива
- Наличие топлива на АЗС: да, нет или честное «неизвестно»
- Смета заправки: объём вручную или до полного бака по телематике, с учётом скидки карты
- Топливные карты: эмитент, сети действия, скидка процентом, фиксированная или спеццена
- Репрезентативная цена топлива как контракт для оптимизатора маршрутов
- Метрики по региону, сети и виду топлива за период
- Отключение источника вместо удаления — история цен остаётся
Основные MCP-инструменты
| Инструмент | Назначение |
|---|---|
fuel__station.list | Список АЗС с фильтрами и ценами |
fuel__station.get | Карточка АЗС с достоверными ценами по видам топлива |
fuel__station.upsert | Создать или обновить АЗС |
fuel__station.delete | Удалить АЗС (с подтверждением, запись сохраняется) |
fuel__fuel_price.get | Достоверная цена с провенансом и флагами |
fuel__fuel_price.compare_sources | Раздельные котировки источников без усреднения |
fuel__fuel.price_at | Репрезентативная цена топлива для смежных модулей |
fuel__availability.get | Наличие топлива на АЗС с указанием свежести |
fuel__refuel.estimate_cost | Смета заправки по АЗС с учётом скидки карты |
fuel__quote.ingest | Ручной или пакетный приём котировок источника |
fuel__source.create | Зарегистрировать источник цен |
fuel__source.list | Реестр источников с доверием, порогами и статусом |
fuel__source.set_trust | Изменить настройки доверия источника |
fuel__source.disconnect | Отключить источник без удаления истории |
fuel__fuelcard.upsert | Создать или обновить топливную карту |
fuel__fuelcard.list | Справочник топливных карт |
fuel__fuelcard.delete | Удалить топливную карту (с подтверждением) |
fuel__fuel.metrics | Метрики цен по региону, сети и виду топлива |
Блоки холста
station-card— карточка АЗСstation-field— одно поле карточки АЗСtrustedprice-card— достоверная цена с провенансомtrustedprice-field— одно поле достоверной ценыpricesource-card— источник цен и его состояниеfuelcard-card— топливная карта
Связанные модули
- MOD-FLEET — нормы расхода, объём бака и уровень топлива по телематике
- MOD-ROUTE-OPT — цены топлива в смете маршрута
- MOD-TMS-DISPATCH — рейсы, затраты по которым считаются в копейках