Battery-ERP – Material-, Zell-, Pack- und Lieferkettenmanagement mit Echtzeit-Rohstoffpreisen und Fabric-Lakehouse-Analysen.

Deckt die gesamte Batterie-Wertschöpfungskette ab: von Lithium, Kobalt, Nickel, Mangan, Graphit über Zellchemien (NMC-811, NCA, LFP, LMO) bis hin zu Batteriepacks mit BOM-Kalkulation, Lieferantenbewertung, Bestandsverwaltung und Was-wäre-wenn-Kostenszenarien.

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

Worum es sich handelt

Battery ERP verwaltet die komplette Batterie-Wertschöpfungskette – von der Rohstoffbeschaffung über die Zellfertigung bis zur Packmontage. Jede Kostenposition ist einem bestimmten Material, Lieferanten und Preisniveau zuordenbar.

Related MCP server: Factory Insight MCP Server

Schnellstart

# 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})')
"

Architektur

                    ┌──────────────────────────────────────┐
                    │  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 │
  └─────────────────┘  └──────────────────┘  └──────────────────┘

Kernmodule

battery_erp.core.models

Alle Domänen-Dataclasses:

• RawMaterial – Materialkatalog mit Preisen, HS-Codes, Gefahrstoffen

• CellChemistry – NMC-111/622/811, NCA, LFP, LMO mit Energiedichte und Zyklenlebensdauer

• BatteryCell – Zellspezifikationen (Kapazität, Spannung, Bauform, Gewicht)

• BatteryPack – Packmontage (Zellen + BMS + Thermik)

• BOMItem – BOM-Position mit Verschnittfaktor

• Supplier – Lieferantenkatalog mit Qualitätsbewertung, Lieferzeit, Zertifizierungen

• InventoryRecord – Lagerpositionen mit Meldebestandslogik

• PurchaseOrder – Verfolgung des Bestelllebenszyklus

• ManufacturingBatch – Verfolgung der Fertigungsausbeute von Produktionschargen

• PriceHistory – Zeitreihen der Rohstoffpreise

battery_erp.core.rules

Deterministische Geschäftsregeln:

• rollup_bom_cost() – Gesamte BOM-Kosten mit Materialaufschlüsselung und Verschnittkosten

• calculate_cell_bom() – Repräsentative BOM für jede Chemie erzeugen

• calculate_pack_bom() – BOM auf Packebene (Zellen + Gehäuse + BMS + Kühlung)

• update_inventory_status() – in_stock/low/out_of_stock neu berechnen

• check_reorder_suggestions() – Bestellvorschläge erzeugen

• calculate_batch_metrics() – Fertigungsausbeute aggregieren

• analyze_price_history() – Preistrendanalyse mit Volatilität

• estimate_cell_cost_impact() – Was-wäre-wenn-Kostenszenarien modellieren

• calculate_pack_metrics() – Energiedichte und Effizienz des Packs

battery_erp.supply_chain

Lieferkettenmanagement:

• score_supplier() – Zusammengesetzter Score (Qualität 35 %, OTD 35 %, Lieferzeit 20 %, Zertifikate 10 %)

• rank_suppliers() – Nach Score einstufen, nach Material filtern

• create_purchase_order() – Bestellung aus Lieferantendaten erstellen

• analyze_po_pipeline() – Analyse der Bestellpipeline (Erkennung überfälliger Bestellungen, Lieferzeitverfolgung)

• suggest_dual_sourcing() – Empfehlung für Dual-Sourcing-Strategie

battery_erp.pricing

Rohstoffpreise:

• get_material_price_table() – Standardpreise für 20+ Batteriematerialien

• calculate_cell_cost_summary() – Schnelle Kostenschätzung pro Chemie

• update_prices_from_alpha_vantage() – Live-Abruf der Rohstoffpreise

• update_prices_from_fred() – Makroökonomische Indikatoren

battery_erp.analytics

Berichtswesen:

• generate_inventory_report() – Vollständiges Dashboard zur Bestandsgesundheit

• generate_supply_chain_report() – Bericht zu Lieferanten + Bestellpipeline

• generate_manufacturing_report() – Ausbeutekennzahlen

• generate_pricing_report() – Kostenvergleich der Chemien + Preistrends

Kostenvergleich der Chemien (Standardpreise, 50-Ah-Zelle)

Microsoft-Fabric-Integration

Fabric-Notebooks

Delta-Tabellenschema

Fabric-Schnellstart

1. Führen Sie fabric_setup_lakehouse.py aus, um alle 11 Delta-Tabellen zu erstellen

2. Führen Sie fabric_cost_dashboard.py für das vollständige Analyse-Dashboard aus

3. Das Dashboard umfasst: Kostenvergleich der Chemien, Kalkulation auf Packebene, Bestandsgesundheit, Lieferanten-Scorecard, Preistrends, Fertigungsausbeute, Kostenszenarien

Bestandsadapter (REST + MCP)

Battery ERP ist eine Domänenbibliothek, kein gehostetes ERP. Für SMS-/Textzeilen- und Agenten-Workflows liegt ein gemeinsamer InventoryService sowohl unter einer schlanken REST-API als auch unter einem MCP-Server. Ausführliche Details: docs/INTEGRATION.md.

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

Rufen Sie MCP nicht aus einem Browser auf. Halten Sie REST und MCP in getrennten Terminals.

Installation (macOS / zsh)

Verwenden Sie python3. Setzen Sie pip-Extras in Anführungszeichen, damit zsh sie nicht als Glob-Muster interpretiert:

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

Terminal A – REST (Textzeilen-Backend)

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

Terminal B – MCP (nur Agents / Cursor)

Lassen Sie Terminal A laufen. In einem neuen Terminal:

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

Dieser Prozess bleibt auf stdio still – normal für MCP-Hosts. Fügen Sie dies nicht in das API-Terminal ein.

Cursor-MCP-Konfiguration

Fügen Sie Folgendes zu ~/.cursor/mcp.json hinzu (absolute Pfade; python3 statt 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"
      }
    }
  }
}

Laden Sie dann die MCP-Server in Cursor neu. Verfügbare Tools: lookup_inventory, get_inventory_status, get_inventory_record, list_inventory, create_bin_check_request, record_bin_confirmation.

Für die mutierende Behälterbestätigung ist BATTERY_ERP_CONFIRM_TOKEN erforderlich; optional wird ein JSONL-Prüfprotokoll nach BATTERY_ERP_AUDIT_LOG geschrieben.

Verzeichnis-/Registry-Paketierung: siehe PUBLISH.md (glama.json, Dockerfile, server.json). Nach dem Merge in main auf Glama als @icohangar-ops/battery-erp beanspruchen.

Tests

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

Anwendungsfälle

• Zellhersteller – BOM-Kostenverfolgung über Chemien hinweg, Ausbeuteoptimierung

• Pack-Integratoren – Kostenkalkulation auf Packebene, Lieferantenauswahl

• Einkauf – Lieferantenbewertung, Dual Sourcing, Bestellpipeline-Verwaltung

• Finanzen – Rohstoffpreisrisiko, Was-wäre-wenn-Szenarien, Bestandsbewertung

• Führungsebene – Dashboard mit $-/kWh-Trends, Resilienz der Lieferkette, Kostensenkungspotenziale

Lizenz

MIT. Siehe LICENSE.

CHP-Governance

Dieses Repository ist mit dem Consensus Hardening Protocol (CHP) abgesichert, der Entscheidungs-Governance-Ebene von Cubiczan für Multi-Agenten-KI-Systeme.

Protokollebenen

• R0-Gate: Alle Entscheidungen müssen die Prüfungen „Lösbar, Abgegrenzt, Gültig, Lohnend" bestehen

• Offenlegung der Grundlage: 1–3 schwächste Annahmen, 1–2 Ungültigkeitsbedingungen, 1 zentrale Schwachstelle

• Adversariale Ebene: Verpflichtender Advocatus Diaboli in Phase 0 und Runde 3

• Zustandsautomat: EXPLORING → PROVISIONAL → PROVISIONAL_LOCK → LOCKED

• Validierung durch Dritte: Unabhängiges BESTÄTIGEN/ABLEHNEN vor der Sperrung

Domänenkonfiguration

• Kategorie: Bergbau / Lieferkette

• Schwellenwert für die Grundlage: 75

• CFO-Genauigkeitsschutz: Deaktiviert

Compliance-Artefakte

CHP-Version

cognitive-mesh-orchestrator 0.1.0 | Protokolldokumentation

Demo

Handheld — Parts Bin Text Line

Mobile Aufnahme von der Live-Lead-Seite (parts-bin-text-line--icohangar.replit.app). SMS → text-line → Battery-ERP-Bestandsprüfung → menschliche Behälterbestätigung.