Battery ERP — управление материалами, ячейками, пакетами и цепочкой поставок с ценами на сырьё в реальном времени

и аналитикой Microsoft Fabric Lakehouse.

Покрывает всю цепочку создания стоимости батарей: литий, кобальт, никель, марганец, графит

через химию ячеек (NMC-811, NCA, LFP, LMO) до батарейных пакетов с расчётом стоимости BOM,

оценкой поставщиков, управлением запасами и сценариями «что если» для затрат.

mcp-name: io.github.icohangar-ops/battery-erp

Что это такое

Battery ERP управляет полной цепочкой создания стоимости батарей — от закупки сырья через производство ячеек до сборки пакетов. Каждая затрата прослеживается до конкретного материала, поставщика и ценовой точки.

Related MCP server: Factory Insight MCP Server

Быстрый старт

# From PyPI — https://pypi.org/project/battery-erp/
python3 -m pip install 'battery-erp[mcp]'   # MCP tools
python3 -m pip install 'battery-erp[api]'   # REST adapter

# From source
git clone https://github.com/icohangar-ops/battery-erp.git
cd battery-erp
python3 -m pip install -e '.[dev]'
PYTHONPATH=src python3 -m pytest tests/ -v

# Domain modules
python3 -c "
from battery_erp.pricing import calculate_cell_cost_summary, get_material_price_table
prices = get_material_price_table()
for chem in ['NMC-811', 'NMC-622', 'NCA', 'LFP', 'LMO']:
    r = calculate_cell_cost_summary(chem, 50.0, prices)
    print(f'{chem}: \${r[\"cost_per_kwh\"]:.1f}/kWh (BOM: \${r[\"bom_cost_usd\"]:.2f})')
"

Архитектура

                    ┌──────────────────────────────────────┐
                    │  Raw Materials (20+ tracked)          │
                    │  Lithium · Cobalt · Nickel · Mn · Gr  │
                    └──────────────┬───────────────────────┘
                                   │ BOM
                    ┌──────────────▼───────────────────────┐
                    │  Cell Chemistries                     │
                    │  NMC-811 · NMC-622 · NCA · LFP · LMO  │
                    └──────────────┬───────────────────────┘
                                   │ cells + components
                    ┌──────────────▼───────────────────────┐
                    │  Battery Packs                        │
                    │  EV · ESS · Consumer · Industrial     │
                    └──────────────────────────────────────┘

Side modules:
  ┌─────────────────┐  ┌──────────────────┐  ┌──────────────────┐
  │ Supplier Scoring │  │ Inventory Mgmt   │  │ Cost Scenarios    │
  │ Composite 0-100  │  │ Reorder logic    │  │ What-if analysis  │
  │ A/B/C/D grades   │  │ Status tracking  │  │ Price shock model │
  └─────────────────┘  └──────────────────┘  └──────────────────┘

Основные модули

battery_erp.core.models

Все доменные dataclass:

• RawMaterial — каталог материалов с ценами, кодами HS, опасностями

• CellChemistry — NMC-111/622/811, NCA, LFP, LMO с плотностью энергии и сроком службы

• BatteryCell — характеристики ячейки (ёмкость, напряжение, форм-фактор, вес)

• BatteryPack — сборка пакета (ячейки + BMS + терморегулирование)

• BOMItem — позиция спецификации (BOM) с коэффициентом отходов

• Supplier — каталог поставщиков с рейтингом качества, сроком поставки, сертификатами

• InventoryRecord — складские позиции с логикой повторного заказа

• PurchaseOrder — отслеживание жизненного цикла заказа на поставку

• ManufacturingBatch — отслеживание выхода производственной партии

• PriceHistory — временные ряды цен на сырьё

battery_erp.core.rules

Детерминированные бизнес-правила:

• rollup_bom_cost() — общая стоимость BOM с разбивкой по материалам и стоимостью отходов

• calculate_cell_bom() — генерация репрезентативной BOM для любой химии

• calculate_pack_bom() — BOM на уровне пакета (ячейки + корпус + BMS + охлаждение)

• update_inventory_status() — пересчёт статусов in_stock/low/out_of_stock

• check_reorder_suggestions() — генерация предложений по заказам на поставку

• calculate_batch_metrics() — агрегированный производственный выход

• analyze_price_history() — анализ ценовых трендов с волатильностью

• estimate_cell_cost_impact() — моделирование сценариев «что если» для затрат

• calculate_pack_metrics() — плотность энергии и эффективность пакета

battery_erp.supply_chain

Управление цепочкой поставок:

• score_supplier() — композитная оценка (качество 35%, OTD 35%, срок поставки 20%, сертификаты 10%)

• rank_suppliers() — ранжирование по оценке, фильтрация по материалу

• create_purchase_order() — создание заказа на поставку из данных поставщика

• analyze_po_pipeline() — анализ конвейера заказов (обнаружение просрочек, отслеживание сроков поставки)

• suggest_dual_sourcing() — рекомендация стратегии двойного sourcing

battery_erp.pricing

Цены на сырьё:

• get_material_price_table() — цены по умолчанию для 20+ материалов для батарей

• calculate_cell_cost_summary() — быстрая оценка затрат по химии

• update_prices_from_alpha_vantage() — получение цен на сырьё в реальном времени

• update_prices_from_fred() — макроэкономические индикаторы

battery_erp.analytics

Отчётность:

• generate_inventory_report() — полная панель состояния запасов

• generate_supply_chain_report() — отчёт по поставщикам и конвейеру заказов

• generate_manufacturing_report() — метрики выхода

• generate_pricing_report() — сравнение затрат по химии + ценовые тренды

Сравнение затрат по химии (цены по умолчанию, ячейка 50Ah)

Интеграция с Microsoft Fabric

Записные книжки Fabric

Схема таблиц Delta

Быстрый старт с Fabric

1. Запустите fabric_setup_lakehouse.py для создания всех 11 таблиц Delta

2. Запустите fabric_cost_dashboard.py для полной панели аналитики

3. Панель охватывает: сравнение затрат по химии, расчёт стоимости пакетов, состояние запасов, оценку поставщиков, ценовые тренды, производственный выход, сценарии затрат

Адаптеры инвентаризации (REST + MCP)

Battery ERP — это доменная библиотека, а не размещённая ERP-система. Для SMS / текстовых и агентских рабочих процессов общий InventoryService находится как под тонким REST API, так и под MCP-сервером. Подробности: docs/INTEGRATION.md.

SMS / ClickSend          Cursor / Claude (stdio MCP)
        │                         │
        ▼                         ▼
  REST API (port 8088)      battery_erp.mcp
        └──────────┬──────────────┘
                   ▼
           InventoryService
                   ▼
        InMemoryInventoryStore (demo)
                   ▼
          Human bin confirmation

Не вызывайте MCP из браузера. Держите REST и MCP в отдельных терминалах.

Установка (macOS / zsh)

Используйте python3. Заключайте pip extras в кавычки, чтобы zsh не интерпретировал их как glob:

cd ~/Desktop/icohangar-repos/battery-erp
python3 -m pip install -e '.[dev]'   # api + mcp + pytest

Терминал A — REST (текстовый бэкенд)

cd ~/Desktop/icohangar-repos/battery-erp
export BATTERY_ERP_CONFIRM_TOKEN=dev-secret
export BATTERY_ERP_AUDIT_LOG=/tmp/battery-erp-audit.jsonl
PYTHONPATH=src python3 -m battery_erp.api
# Uvicorn → http://127.0.0.1:8088

curl -s http://127.0.0.1:8088/health
curl -s http://127.0.0.1:8088/inventory/lookup/lithium

Терминал B — MCP (только для агентов / Cursor)

Оставьте терминал A работающим. В новом терминале:

cd ~/Desktop/icohangar-repos/battery-erp
export BATTERY_ERP_CONFIRM_TOKEN=dev-secret
PYTHONPATH=src python3 -m battery_erp.mcp

Этот процесс остаётся тихим на stdio — это нормально для MCP-хостов. Не вставляйте это в терминал API.

Конфигурация MCP для Cursor

Добавьте в ~/.cursor/mcp.json (абсолютные пути; python3, а не python):

{
  "mcpServers": {
    "battery-erp": {
      "command": "python3",
      "args": ["-m", "battery_erp.mcp"],
      "env": {
        "PYTHONPATH": "/Users/YOU/Desktop/icohangar-repos/battery-erp/src",
        "BATTERY_ERP_CONFIRM_TOKEN": "replace-me",
        "BATTERY_ERP_AUDIT_LOG": "/tmp/battery-erp-audit.jsonl"
      }
    }
  }
}

Затем перезагрузите MCP-серверы в Cursor. Доступные инструменты: lookup_inventory, get_inventory_status, get_inventory_record, list_inventory, create_bin_check_request, record_bin_confirmation.

Для изменения подтверждения bin требуется BATTERY_ERP_CONFIRM_TOKEN и опционально записывается JSONL-аудит в BATTERY_ERP_AUDIT_LOG.

Упаковка каталога / реестра: см. PUBLISH.md (glama.json, Dockerfile, server.json). После слияния в main заявите на Glama как @icohangar-ops/battery-erp.

Тесты

PYTHONPATH=src python3 -m pytest tests/ -v
# Domain tests + inventory service / REST / MCP scaffold

Варианты использования

• Производители ячеек — отслеживание затрат BOM по химиям, оптимизация выхода

• Интеграторы пакетов — оценка затрат на уровне пакета, выбор поставщиков

• Закупки — оценка поставщиков, двойной sourcing, управление конвейером заказов

• Финансы — ценовой риск на сырьё, сценарии «что если», оценка запасов

• Руководство — панель с трендами $/кВт·ч, устойчивость цепочки поставок, возможности снижения затрат

Лицензия

MIT. См. LICENSE.

Управление CHP

Этот репозиторий укреплён с помощью Consensus Hardening Protocol (CHP), уровня управления решениями Cubiczan для мультиагентных ИИ-систем.

Уровни протокола

• R0 Gate: Все решения должны проходить проверки Solvable, Scoped, Valid, Worth_it

• Foundation Disclosure: 1-3 самых слабых допущения, 1-2 условия инвалидации, 1 ключевая уязвимость

• Adversarial Layer: Обязательный адвокат дьявола на Фазе 0 и Раунде 3

• State Machine: EXPLORING → PROVISIONAL → PROVISIONAL_LOCK → LOCKED

• Third-Party Validation: Независимое CONFIRM/REJECT перед блокировкой

Конфигурация домена

• Категория: Горнодобыча / Цепочка поставок

• Порог Foundation: 75

• CFO Accuracy Guard: Отключён

Артефакты соответствия

Версия CHP

cognitive-mesh-orchestrator 0.1.0 | Документация протокола

Демо

Портативное устройство — текстовое поле для контейнеров с деталями

Мобильный захват с живой страницы лида (parts-bin-text-line--icohangar.replit.app). SMS → текст → проверка запасов в ERP для аккумуляторов → подтверждение контейнера оператором.