45 lines (35 loc) · 2.03 KB

E-Commerce Order Processing

Multi-agent otomasyon sistemi. Python + n8n + Power Automate Desktop. Amazon SP-API, Dynamics GP, ShipRush, 35+ portal entegrasyonu.

Komutlar

pytest api-integration-agent/tests/ -v — API agent testleri
pytest browser-automation-agent/tests/ -v — browser agent testleri
pytest erp-rpa-agent/tests/ -v — ERP agent testleri
python -m [agent]/src/main.py [skill] — tek skill çalıştır
ruff check . — lint
ruff format . — format
mypy [agent]/src/ — tip kontrolü

Mimari

4 bağımsız agent, n8n ile orkestre edilir:

/api-integration-agent — Amazon, Walmart, Shopify, FTP, DCG, Dropbox, Graph API
/browser-automation-agent — Playwright ile portal otomasyon (True Commerce, CHUB, DSCO, 35+ portal)
/erp-rpa-agent — GP ODBC (READ-ONLY), SmartList kuralları, exception report
/ai-operations-agent — Claude API ile warehouse routing, email parsing, dashboard
/n8n/workflows/ — 5 workflow JSON (morning cycle, tracking, EOD, email, error handler)
/pad-flows/ — Power Automate Desktop .robin dosyaları (GP + ShipRush UI)
/knowledge/ — İş kuralları, routing tabloları, portal listesi

Kurallar

GP'ye ASLA doğrudan yazma — tüm GP yazımları PAD üzerinden
gp_odbc.py SADECE okuma yapar, docstring'deki uyarıyı silme
FedEx Residential Box MUTLAKA unchecked — ShipRush PAD'de verify loop zorunlu
CAPTCHA tespit edilirse retry YAPMA → hemen CRITICAL alert + human escalation
API key'ler SADECE env'den — hardcode yasak, log'a secret basma
state_manager.py SQLite WAL mode — değiştirme
n8n cron'ları UTC yazılır (ET = UTC-4/5)
sys.exit(2) = duplicate PO hard stop — n8n IF node bu kodu kontrol eder
[WTL_DATA_NEEDED] etiketli alanlar WTL'den bilgi bekleniyor — varsayım yapma

İş Akışı

Branch: feature/TICKET-kısa-açıklama
PR öncesi: ruff check . && pytest
Yeni entegrasyon için integration-builder skill'ini kullan
Mimari değişiklikler için önce docs/decisions/ altına ADR yaz