v2.0: synthetic demo model (not a real-data candidate)

README.md

@@ -0,0 +1,61 @@
+---
+language: tr
+library_name: sklearn
+tags:
+  - onnx
+  - tabular-classification
+  - education
+  - synthetic-demo
+  - logistic-regression
+model-index:
+  - name: SE Primer Kriz Freni
+    results: []
+---
+
+# SE Primer — Kriz freni model kartı
+
+> **Sentetik demo (`synthetic-demo`):** Bu artefakt yalnız `scripts/generate_demo.py`
+> tarafından üretilen sentetik veriyle eğitilmiştir. Gerçek kullanıcı verisiyle
+> eğitilmedi; gerçek öğrenci başarımı, genelleme veya üretim kullanımı iddiası taşımaz.
+> Gerçek veri adayı eval kapısını geçemediği için yayınlanmamıştır.
+
+## Amaç
+Muhteşem Cuma ödeme krizi oyununda oyuncunun yönlendirici ipucu isteyip istemediğini
+tahmin etmek. Lojistik regresyon + StandardScaler tek ONNX pipeline'ıdır. Ölçeklemeyi
+istemci ayrıca yapmaz. Pozitif sınıf 1; karar eşiği 0.60. Sahneye özgü soru, mentorun
+açılma zamanı ve deneyimli modun sayaç durdurması bu kararı kullanır.
+
+## Veri ve ölçüm
+Güncel durum ve kesin metrikler aynı commit'teki `config.json` içindedir.
+`status=synthetic-demo` ise gerçek insan başarımı **ölçülmemiştir**; sentetik doğruluk
+gerçek kullanıcılarda başarı demek değildir. 240 sentetik oturumun üreticisi seed=42 ile
+`scripts/generate_demo.py` dosyasında; veri sözlüğünde açık kuralı yazılıdır.
+Gerçek veri adayı yalnız en az 15 tamamlanmış gerçek oturumdan eğitilebilir.
+Etiket karar öncesi öz bildirimdir; modelden veya A/B sonucundan üretilmez.
+
+Holdout oturum bazlı %25; seed=42. Test doğruluğu `p>=0.60` kararıyla hesaplanır.
+Kabul kapısı accuracy>=0.75. Her iki sınıf hem eğitim hem testte bulunmalıdır.
+Ayrıca holdout çoğunluk baseline'ı hesaplanır; model bunu kesin olarak aşmalıdır,
+eşitlik de reddedilir. Tek sınıfı tahmin eden model yayımlanmaz.
+ONNX/sklearn tüm veri ve referanslarda mutlak olasılık farkı <1e-4.
+Test kümesiyle model seçimi yapılmaz; başarısızlıkta daha çeşitli veri toplanır.
+
+## Sözleşme ve yeniden üretim
+`contract.json` eğitim öncesi özellik sırası, aralıklar ve eşiklerdir.
+`config.json` giriş `[N,5] float32`, çıkış adı, sınıf sırası, metrikler, veri/model SHA256
+ve bağımlılık sürümlerini içerir. Model dosyası ile config birlikte sürümlenir.
+Tam bağımlılıklar `requirements-lock.txt`; eğitim komutu repo README'sinde.
+Python oracle ve gerçek tarayıcı WASM'ı aynı beş referansla karşılaştırılır.
+
+## Sınırlar / kullanılmaması gereken durumlar
+Küçük ve tek hikâyeye ait veri; tekrar oyunlarında öğrenme etkisi; öz bildirim yanlılığı.
+Profil seçimi uzmanlığın nesnel ölçümü değildir. Uzun düşünmek başarısızlık değildir.
+Oturum ayrımı kişi ayrımı garantilemez. Model olasılıkları kalibre edilmiş güven puanı değildir.
+Öğrenci notlandırma, işe alım, kişilik/sağlık değerlendirmesi veya gerçek ödeme sistemlerinde
+karar verme için kullanılmaz. İstemciye indirilen model gizli değildir.
+
+## Kaynaklar
+- https://scikit-learn.org/stable/modules/generated/sklearn.linear_model.LogisticRegression.html
+- https://scikit-learn.org/stable/modules/generated/sklearn.model_selection.GroupShuffleSplit.html
+- https://onnx.ai/sklearn-onnx/auto_tutorial/plot_dbegin_options_zipmap.html
+- https://onnxruntime.ai/docs/tutorials/web/deploy.html

config.json

@@ -0,0 +1,89 @@
+{
+  "schema_version": 1,
+  "features": [
+    "seviye",
+    "karar_suresi_sn",
+    "onceki_yanlis_sayisi",
+    "ipucu_sayisi",
+    "sahne_no"
+  ],
+  "ranges": [
+    [
+      0,
+      1
+    ],
+    [
+      0,
+      600
+    ],
+    [
+      0,
+      2
+    ],
+    [
+      0,
+      30
+    ],
+    [
+      1,
+      3
+    ]
+  ],
+  "integer_features": [
+    0,
+    2,
+    3,
+    4
+  ],
+  "labels": {
+    "0": "normal_akis",
+    "1": "kriz_freni"
+  },
+  "decision_threshold": 0.6,
+  "acceptance_accuracy": 0.75,
+  "tolerance": 0.0001,
+  "seed": 42,
+  "model_version": "2.0.0",
+  "status": "synthetic-demo",
+  "input": {
+    "name": "features",
+    "dtype": "float32",
+    "shape": [
+      null,
+      5
+    ]
+  },
+  "output": {
+    "name": "probabilities",
+    "positive_class_index": 1
+  },
+  "model_sha256": "c4f7734a68d93a40d114960c44b47111e950fcaef02c1db5a28a71e5ceb46289",
+  "data_sha256": "d1dcd344e2f7815763143fd40d984577312bed3bc04a140f9bad6caf7697df6b",
+  "metrics": {
+    "accuracy": 0.9055555555555556,
+    "onnx_max_abs_error": 1.3763748296646838e-07,
+    "confusion_matrix": [
+      [
+        99,
+        3
+      ],
+      [
+        14,
+        64
+      ]
+    ],
+    "train_sessions": 180,
+    "test_sessions": 60,
+    "train_rows": 540,
+    "test_rows": 180,
+    "real_sessions": 0
+  },
+  "split": "GroupShuffleSplit: oturum_id, holdout=0.25; test oturumlari egitimde yok",
+  "dependencies": {
+    "numpy": "2.2.6",
+    "scikit-learn": "1.7.2",
+    "skl2onnx": "1.19.1",
+    "onnx": "1.19.1",
+    "onnxruntime": "1.23.2"
+  }
+}

config.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Primer v2 model config",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "features",
+    "ranges",
+    "labels",
+    "decision_threshold",
+    "acceptance_accuracy",
+    "metrics",
+    "input",
+    "output",
+    "model_sha256",
+    "status"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "features": {
+      "const": [
+        "seviye",
+        "karar_suresi_sn",
+        "onceki_yanlis_sayisi",
+        "ipucu_sayisi",
+        "sahne_no"
+      ]
+    },
+    "decision_threshold": {
+      "const": 0.6
+    },
+    "acceptance_accuracy": {
+      "const": 0.75
+    },
+    "tolerance": {
+      "const": 0.0001
+    },
+    "status": {
+      "enum": [
+        "synthetic-demo",
+        "real-data-candidate"
+      ]
+    },
+    "model_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "input": {
+      "type": "object",
+      "required": [
+        "name",
+        "dtype",
+        "shape"
+      ],
+      "properties": {
+        "name": {
+          "const": "features"
+        },
+        "dtype": {
+          "const": "float32"
+        },
+        "shape": {
+          "const": [
+            null,
+            5
+          ]
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "required": [
+        "name",
+        "positive_class_index"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "positive_class_index": {
+          "const": 1
+        }
+      }
+    },
+    "metrics": {
+      "type": "object",
+      "required": [
+        "accuracy",
+        "onnx_max_abs_error",
+        "real_sessions"
+      ],
+      "properties": {
+        "accuracy": {
+          "type": "number",
+          "minimum": 0.75,
+          "maximum": 1
+        },
+        "majority_baseline": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "onnx_max_abs_error": {
+          "type": "number",
+          "minimum": 0,
+          "exclusiveMaximum": 0.0001
+        },
+        "real_sessions": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    }
+  }
+}

contract.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 1,
+  "features": ["seviye", "karar_suresi_sn", "onceki_yanlis_sayisi", "ipucu_sayisi", "sahne_no"],
+  "ranges": [[0, 1], [0, 600], [0, 2], [0, 30], [1, 3]],
+  "integer_features": [0, 2, 3, 4],
+  "labels": {"0": "normal_akis", "1": "kriz_freni"},
+  "decision_threshold": 0.6,
+  "acceptance_accuracy": 0.75,
+  "tolerance": 0.0001,
+  "seed": 42
+}

model.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c4f7734a68d93a40d114960c44b47111e950fcaef02c1db5a28a71e5ceb46289
+size 541