All systemsTüm sistemler Aegis
MechanismMekanizma

PRESCRIPTIVE CHURN OPERATIONS

Risk is not the answer.Risk cevap değildir.Action is.Eylem cevaptır.

Aegis validates the customer contract, calibrates churn risk, exposes the local reason and actionable counterfactual, grades treatment evidence and recommends only interventions whose expected value clears policy.Aegis müşteri sözleşmesini doğrular, churn riskini kalibre eder, yerel nedeni ve uygulanabilir karşı-olguyu açar, treatment kanıtını derecelendirir ve yalnızca beklenen değeri politikayı geçen müdahaleleri önerir.

MAKER
Emir Hüseyin İnci
RUNTIME
Python · Litestar
CONSOLE
Next.js
AEGIS / OPERATING CONTRACTTENANT BOUND
CUSTOMER CONTRACT

Bind identity before scoring risk.

POST /api/predict
INPUT
Stable customer ID · binary outcome · observation window
REQUIRED
METHOD
Schema + leakage validation
ACTIVE
EVIDENCE
Dataset profile + policy snapshot
BOUND
STATE
Post-treatment and cancellation fields are rejected.
CONTRACT VALID
RISK
Calibrated
REASON
SHAP
COUNTERFACTUAL
DiCE
UPLIFT
Evidence-graded

OPERATING CONTRACT

Not a churn score. An intervention decision.Churn skoru değil. Müdahale kararı.

Aegis keeps prediction, explanation, causal evidence and economics separate until policy joins them. That separation prevents an attractive score from silently becoming an operational claim.Aegis tahmin, açıklama, nedensel kanıt ve ekonomiyi politika birleştirene kadar ayrı tutar. Bu ayrım, çekici bir skorun sessizce operasyon iddiasına dönüşmesini engeller.

01

Validate the contractSözleşmeyi doğrula

Stable identity, binary churn outcome and observation window are required; leakage and post-treatment fields are removed.Sabit kimlik, binary churn sonucu ve gözlem penceresi zorunludur; leakage ve post-treatment alanları çıkarılır.

02

Calibrate riskRiski kalibre et

Persisted feature state feeds XGBoost, LightGBM or CatBoost and preserves the model artifact manifest.Kalıcı feature state XGBoost, LightGBM veya CatBoost’u besler ve model artifact manifestini korur.

03

Expose the local reasonYerel nedeni aç

SHAP contributions show the active drivers behind one customer’s calibrated risk.SHAP katkıları tek bir müşterinin kalibre riskinin arkasındaki aktif sürücüleri gösterir.

04

Search actionable worldsUygulanabilir dünyaları ara

DiCE counterfactuals are limited to features an operator can actually change.DiCE karşı-olguları operatörün gerçekten değiştirebileceği özelliklerle sınırlıdır.

05

Grade uplift evidenceUplift kanıtını derecelendir

T-learner CATE carries treatment source metadata; simulation is never presented as causal-grade evidence.T-learner CATE treatment kaynağı metadata’sını taşır; simülasyon causal-grade kanıt gibi sunulmaz.

06

Value the interventionMüdahaleyi değerle

CLTV, margin, action cost and WACC enter the policy before a retention action is recommended.Retention eylemi önerilmeden önce CLTV, marj, aksiyon maliyeti ve WACC politikaya girer.

DECISION TRACE

Follow the real API path.Gerçek API yolunu izle.

The built-in IBM Telco flow is a local smoke-test and UI fixture. Because it lacks true treatment assignment, uplift remains simulation-grade until randomized or audited observational treatment data is supplied.Built-in IBM Telco akışı yerel smoke-test ve arayüz fixture’ıdır. Gerçek treatment ataması içermediği için randomized veya denetlenmiş observational treatment verisi gelene kadar uplift simulation-grade kalır.

AEGIS / DECISION PIPELINEIBM TELCO · LOCAL FIXTURE
CONTRACT VALID
ACTIVE SURFACESchema + leakage gate

EVIDENCE GRADE

Uplift never travels without its source.Uplift kaynağından ayrı dolaşmaz.

Randomized treatment may be marked causal-grade. Observational treatment is marked non-causal-grade until adjustment and review. Synthetic labels stay simulation-grade.Randomized treatment causal-grade işaretlenebilir. Observational treatment, adjustment ve review tamamlanana kadar non-causal-grade kalır. Sentetik etiketler simulation-grade kalır.

AEGIS / CATE EVIDENCEVISIBLE

SIMULATION
GRADE

TREATMENT SOURCE
synthetic fixture
MODEL PATH
T-learner
EXPLANATION
SHAP + DiCE
POLICY SNAPSHOT
immutable
AUDIT
tenant-safe · redacted
07 / IMPLEMENTATION DOSSIER AEGIS · RELEASE 1.0.0

From probability to operable action.Olasılıktan işletilebilir eyleme.

The repository is built around a deliberate separation: prediction estimates risk, explanation exposes drivers, uplift grades intervention evidence, and an economic policy decides whether acting is defensible.Kod tabanı bilinçli bir ayrım üzerine kurulu: tahmin riski ölçer, açıklama sürücüleri açar, uplift müdahale kanıtını derecelendirir, ekonomik politika ise harekete geçmenin savunulabilir olup olmadığına karar verir.

01 / CONTRACT

Bind the observation.Gözlemi bağla.

Stable identity, target window and leakage rules are validated before scoring.Sabit kimlik, hedef penceresi ve leakage kuralları skordan önce doğrulanır.

02 / PREDICT

Calibrate the risk.Riski kalibre et.

Polars state feeds calibrated XGBoost, LightGBM or CatBoost artifacts.Polars durumu kalibre XGBoost, LightGBM veya CatBoost artifact'larını besler.

03 / EXPLAIN

Expose a feasible why.Uygulanabilir nedeni aç.

SHAP attributes the local score; DiCE searches only operator-controlled changes.SHAP yerel skoru açıklar; DiCE yalnızca operatörün değiştirebildiği alanları arar.

04 / UPLIFT

Grade treatment evidence.Treatment kanıtını derecele.

T-learner CATE travels with assignment-source and evidence-grade metadata.T-learner CATE, atama kaynağı ve kanıt seviyesi metadata'sıyla birlikte taşınır.

05 / VALUE

Gate the intervention.Müdahaleyi eşikten geçir.

CLTV, margin, action cost and WACC determine whether the action clears policy.CLTV, marj, aksiyon maliyeti ve WACC eylemin politikayı geçip geçmediğini belirler.

OPERATING SURFACE

One decision, multiple inspectable records.Tek karar, birden çok incelenebilir kayıt.

DECISION APIs
predict · explain · uplift · targeting · backtest
CONTROL APIs
artifacts · policies · drift · metrics · health
STATE PATHS
PostgreSQL · Redis · DuckDB · local fallback
DELIVERY
Litestar API · Next.js console · Python runtime
TRUST CONTROLS

Evidence cannot outrank its source.Kanıt, kaynağından yüksek olamaz.

Treatment provenance, policy snapshots, model manifests and tenant-safe redacted audit events stay attached to the decision path.Treatment kökeni, politika snapshot'ları, model manifestleri ve tenant-safe redacted audit olayları karar yoluna bağlı kalır.

REPOSITORY CHECK

185 backend tests.backend testi.

The published repository records a clean Ruff run plus passing frontend lint and production build checks.Yayınlanan kod tabanı temiz Ruff çalışmasıyla birlikte geçen frontend lint ve production build kontrollerini kaydeder.

CAUSAL DATA CONTRACT

Randomized, observational and synthetic are not synonyms.Randomized, observational ve sentetik aynı şey değildir.

RANDOMIZED
Eligible for causal-grade review when assignment and arms validate.Atama ve kollar doğrulandığında causal-grade incelemeye uygundur.
OBSERVATIONAL
Requires adjustment, provenance and an explicit non-causal-grade label.Adjustment, provenance ve açık non-causal-grade etiketi gerektirir.
SYNTHETIC
Useful for plumbing and UI fixtures; remains simulation-grade.Akış ve UI fixture'ları için yararlıdır; simulation-grade kalır.

AEGIS · BY EMIR HÜSEYİN İNCİ

Know who may leave. Prove what can change it.Kimin gideceğini bil. Neyin değiştireceğini kanıtla.