{ "cells": [ { "cell_type": "markdown", "metadata": { "id": "rU_PV6xN6ijY" }, "source": "# ATM Quantum Cash Optimization — POC v1\n\n**Amaç:** Ham ATM journal loglarından canonical event'ler, transaction aggregates, denomination inventory snapshot'ları ve ATM cash-state üretmek; ardından forecasting ve replenishment optimization için hazır bir veri sözleşmesi oluşturmak.\n\n> Bu POC'nin önemli sınırı: sağlanan iki örnek journal'da **cash-in / deposit** sinyalleri güçlüdür; **cash withdrawal / dispense** sinyali yeterli değildir. Bu nedenle gerçek cash-demand forecast modeli için withdrawal/dispense feed'i ayrıca bağlanmalıdır. Buradaki forecasting bölümü, gerçek withdrawal veri kontratını hazırlar ve örnek amaçlı sentetik withdrawal üretimi içerir.\n", "id": "rU_PV6xN6ijY" }, { "cell_type": "markdown", "metadata": { "id": "DYtfn6vW6ijf" }, "source": "## 0 — Notebook architecture\n\n```text\nRaw EJ/AJ\n ↓\nJournal Parser\n ↓\nCanonical Events\n ↓\nTransaction Reconstruction\n ↓\nDenomination Snapshot Extraction\n ↓\nATM Cash-State Reconstruction\n ↓\nFeature Dataset\n ↓\nForecast Contract\n ↓\nClassical MILP / QUBO\n ↓\nQuantum Backend Adapter Layer\n```\n", "id": "DYtfn6vW6ijf" }, { "cell_type": "code", "execution_count": 4, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "GhNCSR6q6ijg", "executionInfo": { "status": "ok", "timestamp": 1789557240312, "user_tz": -180, "elapsed": 11, "user": { "displayName": "Joseph Volkan ÖZCAN", "userId": "11389530967736397480" } }, "outputId": "647328b6-8da9-4ab6-8aef-6f177d56b999" }, "outputs": [ { "output_type": "stream", "name": "stdout", "text": [ "Files:\n", " - /mnt/data/EJ Data 2098.txt True 26807\n", " - /mnt/data/AHB deposit AJ.txt True 18412\n" ] } ], "source": "# 1 — Environment\nimport re\nimport json\nimport math\nimport hashlib\nfrom pathlib import Path\nfrom datetime import datetime, timedelta\n\nimport pandas as pd\nimport numpy as np\n\ntry:\n from IPython.display import display\nexcept Exception:\n pass\n\nBASE = Path(\"/mnt/data\")\nFILES = [\n BASE / \"EJ Data 2098.txt\",\n BASE / \"AHB deposit AJ.txt\",\n]\n\nprint(\"Files:\")\nfor f in FILES:\n print(\" -\", f, f.exists(), f.stat().st_size if f.exists() else \"\")\n", "id": "GhNCSR6q6ijg" }, { "cell_type": "code", "execution_count": 5, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "a63NRFiG6ijj", "executionInfo": { "status": "ok", "timestamp": 1789557247243, "user_tz": -180, "elapsed": 27, "user": { "displayName": "Joseph Volkan ÖZCAN", "userId": "11389530967736397480" } }, "outputId": "df4b00cb-186d-403a-e1d4-b62f3254ab92" }, "outputs": [ { "output_type": "stream", "name": "stdout", "text": [ "EJ Data 2098.txt: 25,809 chars / 999 lines\n", "AHB deposit AJ.txt: 17,717 chars / 696 lines\n" ] } ], "source": "# 2 — Load raw journals\ndef load_text(path: Path) -> str:\n return path.read_text(encoding=\"utf-8\", errors=\"ignore\")\n\nraw = {f.name: load_text(f) for f in FILES}\n\nfor name, txt in raw.items():\n print(f\"{name}: {len(txt):,} chars / {len(txt.splitlines()):,} lines\")\n", "id": "a63NRFiG6ijj" }, { "cell_type": "markdown", "metadata": { "id": "bTMW8sQb6ijk" }, "source": "## 3 — Canonical event taxonomy\n\nThe parser intentionally separates raw device messages from business-semantic events.\n\nCore event types:\n\n- `TRANSACTION_STARTED`\n- `TRANSACTION_COMPLETED`\n- `TRANSACTION_FAILED`\n- `CASH_IN_STARTED`\n- `CASH_IN_COMPLETED`\n- `CASH_OUT_STARTED`\n- `CASH_OUT_COMPLETED`\n- `CASH_REJECTED`\n- `CASSETTE_SNAPSHOT`\n- `CASSETTE_REMOVED`\n- `CASSETTE_INSERTED`\n- `SUPERVISOR_ENTRY`\n- `SUPERVISOR_EXIT`\n- `ATM_OUT_OF_SERVICE`\n- `ATM_IN_SERVICE`\n- `HARDWARE_ERROR`\n- `RECOVERY_FAILED`\n- `RECOVERY_COMPLETED`\n- `SERIAL_READ_FAILURE`\n", "id": "bTMW8sQb6ijk" }, { "cell_type": "code", "execution_count": 6, "metadata": { "id": "pl649N1O6ijk", "executionInfo": { "status": "ok", "timestamp": 1789557252709, "user_tz": -180, "elapsed": 6, "user": { "displayName": "Joseph Volkan ÖZCAN", "userId": "11389530967736397480" } } }, "outputs": [], "source": "# 4 — Journal parser helpers\nHEADER_RE = re.compile(\n r'^\\*(?P\\d+)\\*(?P\\d{2}/\\d{2}/\\d{4})\\*(?P