Battery ERP — 소재, 셀, 팩, 공급망 관리와 실시간

원자재 가격 및 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

모든 도메인 데이터클래스:

• RawMaterial — 가격, HS 코드, 위험 정보를 포함한 소재 카탈로그

• CellChemistry — 에너지 밀도와 수명 주기를 포함한 NMC-111/622/811, NCA, LFP, LMO

• BatteryCell — 셀 사양(용량, 전압, 폼 팩터, 무게)

• BatteryPack — 팩 조립(셀 + BMS + 열 관리)

• BOMItem — 폐기율을 포함한 BOM 라인 항목

• Supplier — 품질 등급, 리드 타임, 인증을 포함한 공급업체 카탈로그

• InventoryRecord — 재주문 로직이 포함된 창고 위치

• PurchaseOrder — PO 수명 주기 추적

• 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() — PO 제안 생성

• 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() — 공급업체 데이터로 PO 생성

• analyze_po_pipeline() — PO 파이프라인 분석(지연 감지, 리드 타임 추적)

• suggest_dual_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() — 공급업체 + PO 파이프라인 보고서

• 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을 사용하세요. zsh가 글로브하지 않도록 pip extras를 따옴표로 묶으세요:

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 터미널에 붙여넣지 마세요.

Cursor MCP 구성

~/.cursor/mcp.json에 추가하세요(절대 경로; python이 아닌 python3):

{
  "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"
      }
    }
  }
}

그런 다음 Cursor에서 MCP 서버를 다시 로드하세요. 노출되는 도구: lookup_inventory, get_inventory_status, get_inventory_record, list_inventory, create_bin_check_request, record_bin_confirmation.

변경을 수행하는 빈 확인에는 BATTERY_ERP_CONFIRM_TOKEN이 필요하며 선택적으로 BATTERY_ERP_AUDIT_LOG에 JSONL 감사 로그를 작성합니다.

디렉터리 / 레지스트리 패키징: 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 원가 추적, 수율 최적화

• 팩 통합업체 — 팩 수준 비용 추정, 공급업체 선택

• 구매 — 공급업체 평가, 이중 소싱, PO 파이프라인 관리

• 재무 — 원자재 가격 리스크, 가상 시나리오, 재고 평가

• 최고 경영진 — $/kWh 추세, 공급망 복원력, 비용 절감 기회를 보여주는 대시보드

라이선스

MIT. LICENSE를 참조하세요.

CHP 거버넌스

이 저장소는 다중 에이전트 AI 시스템을 위한 Cubiczan의 의사 결정 거버넌스 계층인 Consensus Hardening Protocol (CHP)로 강화되었습니다.

프로토콜 계층

• R0 게이트: 모든 결정은 Solvable, Scoped, Valid, Worth_it 검사를 통과해야 합니다

• 기반 공개: 가장 약한 가정 1-3개, 무효화 조건 1-2개, 핵심 취약점 1개

• 적대적 계층: Phase 0과 Round 3에서 의무적 악마의 대변인

• 상태 머신: EXPLORING → PROVISIONAL → PROVISIONAL_LOCK → LOCKED

• 제3자 검증: 잠금 전 독립적인 CONFIRM/REJECT

도메인 구성

• 카테고리: 채굴 / 공급망

• 기반 임계값: 75

• CFO 정확도 가드: 비활성화

컴플라이언스 산출물

CHP 버전

cognitive-mesh-orchestrator 0.1.0 | 프로토콜 문서

데모

휴대용 — 부품 보관함 텍스트 라인

실시간 리드 페이지의 모바일 캡처 (parts-bin-text-line--icohangar.replit.app). SMS → 텍스트 라인 → 배터리 ERP 재고 확인 → 작업자 보관함 확인.