# MODEL CARD — Bayesian Risk Projection (`bayes-risk-v1.0`)

> **Κατάσταση:** Production · **Τύπος:** Early-warning · **Επίπεδο:** Enterprise+ / InvestSense
> **Αρχή:** Κάθε αριθμός με πηγή, n και αποχή όπου το δείγμα δεν αντέχει.
> **Επίσημη θέση:** Το μοντέλο ΔΕΝ είναι πιστοληπτική αξιολόγηση (credit rating)
> και ΔΕΝ παράγει πιστωτική απόφαση. Είναι εργαλείο έγκαιρης προειδοποίησης.

---

## 1. Σκοπός & intended use

- **Τι απαντά:** «Πόσο πιθανή είναι σημαντική επιδείνωση (ή sanctions hit) για
  την εταιρεία Χ εντός 12 μηνών;»
- **Πού χρησιμοποιείται:** RiskSense (Company 360), Entity 360, σενάρια stress,
  Portfolio Sentinel, advisory workflows.
- **Τι ΔΕΝ κάνει:** Δεν εγκρίνει/απορρίπτει χρηματοδότηση, δεν υποκαθιστά
  πιστωτικό φάκελο/rating agency, δεν προβλέπει τιμές.

## 2. Μέθοδος

Naive Bayes σε log-odds με διαφανείς likelihood ratios (LR):

```
log-odds = log(π₀/(1−π₀)) + Σ_{i ενεργά} log(LR_i)
P = 1 / (1 + e^(−log-odds))
```

- **π₀ (base rate)** = 0.08 (αρχικό prior, δηλωμένο).
- **Κάθε driver** εμφανίζεται στην απάντηση με το `log_odds` του — ΠΟΤΕ μαύρο κουτί.
- **Κάλυψη (coverage)**: πόσα indicators έχουν δεδομένα· όσα λείπουν δηλώνονται.

### Indicators (v1.0 — συντηρητικές αρχικές τιμές)

| Code | LR | Σημασία | Πηγή |
|---|---|---|---|
| `sanctions_hit` | 8.0 | Ταίριασμα κυρώσεων | FISMA (UN/OFAC) |
| `negative_equity` | 6.0 | Αρνητικά ίδια κεφάλαια | Financials ΓΕΜΗ |
| `deep_loss` | 3.5 | Ζημιά >50% κύκλου εργασιών | Financials ΓΕΜΗ |
| `high_leverage` | 2.5 | Net Debt/EBITDA >4x | Financials ΓΕΜΗ |
| `debt_without_ebitda` | 2.5 | Χρέος χωρίς κάλυψη EBITDA | Financials ΓΕΜΗ |
| `liquidity_gap` | 2.2 | Current ratio <1 | Financials ΓΕΜΗ |
| `negative_margins` | 2.0 | Καθαρό περιθώριο <−10% | Financials ΓΕΜΗ |
| `awards_decline` | 1.8 | Δημόσιες συμβάσεις −50% YoY | ΚΗΜΔΗΣ |
| `no_recent_activity` | 1.5 | Καμία νέα ανάθεση 18+ μήνες | ΚΗΜΔΗΣ |

## 3. Outcome & accountability

- **Ορισμός outcome (proxy):** `material_deterioration` ή `sanctions_hit` στον
  ορίζοντα (365 ημέρες) — από το deterministic `risk_direction`.
- **Κάθε πρόβλεψη αποθηκεύεται** (`invest_risk_predictions`, dedup 1/ημέρα/εταιρεία)
  και όταν ωριμάσει βαθμολογείται με **Brier score** (`(p−o)²`).
- **Δημόσια διαφάνεια:** Brier + calibration bins εκτίθενται στο
  `/api/investsense/model-governance`.

## 4. Assumptions (ρητές)

1. Conditional independence των indicators (naive Bayes).
2. LRs = αρχικές εκτιμήσεις εμπειρογνώμονα — recalibrated με πραγματικές εκβάσεις.
3. Το outcome proxy ταυτίζεται με «δυσχέρεια» για σκοπούς μέτρησης.
4. Κάλυψη = διαθεσιμότητα financials/αναθέσεων· χωρίς αυτά η πιθανότητα είναι
   συντηρητικά χαμηλή και η coverage το δηλώνει.

## 5. Limitations (ρητές — για model validator)

- **Μικρό δείγμα εκβάσεων** έως σήμερα (ορίζοντας 12 μήνες → οι πρώτες
  εκβάσεις ωριμάζουν σταδιακά· το readiness εκτίθεται live).
- **Δεν ενσωματώνει** μακρο-παράγοντες, market-implied PD (Merton) ή
  πληρωμές/ρευστότητα πελατών πέραν των indicators.
- **Outcome proxy** = ό,τι ορίζει το `risk_direction` — όχι εξωτερική πτώχευση.
- **Selection**: αξιολογούνται εταιρείες με διαθέσιμα δεδομένα.

## 6. Performance & monitoring

- **Brier** (0 τέλειο, 0.25 αβοήθητο) + **baseline Brier** (σταθερό prior) +
  **skill score** (1 − Brier/baseline).
- **Calibration**: bins ανά 20% (predicted vs observed) — μόνο με
  **n ≥ 50** έγκυρες εκβάσεις (αλλιώς `calibration_ready: false`).
- **Backtest**: `scripts/backtest_risk_model.py` → `model_governance_runs`
  (μηνιαίο + σε κάθε αλλαγή).
- **Challenger**: logistic regression στα ίδια indicators — εκπαιδεύεται μόνο
  με n ≥ 50 εκβάσεις και συγκρίνεται στο backtest.

## 7. Versioning

| Version | Ημερομηνία | Αλλαγή |
|---|---|---|
| `bayes-risk-v1.0` | 2026-10 | Αρχική έκδοση (9 indicators, prior 8%) |

**Κανόνας:** οποιαδήποτε αλλαγή σε prior/LR/indicators/outcome = **νέα version**
+ backtest + καταχώριση εδώ. Καμία σιωπηλή αλλαγή.

## 8. Governance

Βλ. [`GOVERNANCE.md`](GOVERNANCE.md) — ρόλοι, διαδικασία έγκρισης, monitoring,
escalation. Το μοντέλο λειτουργεί υπό το καθεστώς «documented, versioned,
monitored» — όχι ad-hoc.