Susanoh

README excerpt

# Susanoh (スサノヲ)

> **[Status: Prototype / Beta]**
> 本プロジェクトは現在プロトタイプ段階であり、プロダクション運用に向けたアーキテクチャ設計（[docs/SPEC.md](docs/SPEC.md)）と実装計画（[docs/PLAN.md](docs/PLAN.md)）を策定中です。
> 現行実装はデモ用のインメモリ構成で動作します。

**AI駆動型 経済圏防衛ミドルウェア — ゲーム内不正取引をリアルタイムで検知・隔離・監査**

Susanoh は、オンラインゲーム経済圏におけるRMT（リアルマネートレーディング）、資金洗浄、Bot活動などの不正取引を、ゲームサーバーからのイベント送信だけで導入できる開発者向けセキュリティミドルウェアです。

---

## 主な機能 (Target Architecture)

以下の機能は、プロダクション版での実現を目指すターゲット仕様です。（現行プロトタイプでは一部簡略化されています）

- **🛡️ L1 高速ルール判定 (Real-time Screening)**
  Redisを用いたスライディングウィンドウにより、イベント受信から50ms以内に不審な動きを検知し、即座に一次対応を行います。
  *(Current: Pythonインメモリ実装)*

- **🧠 L2 Gemini 文脈判定 (Contextual Analysis)**
  Google Gemini API を活用し、チャットログや取引パターンから「なぜ不正と疑われるか」の文脈を解析。構造化された監査レポート（判定理由）を提供します。

- **🍯 ハニーポット制御 (Dynamic State Machine)**
  疑わしいアカウントに対し、即座にBANするのではなく「出金のみをブロック」するステートへ遷移。業者の活動を泳がせつつ、経済圏からの資産流出を確実に阻止します。
  *(Current: L2 Low Risk verdict時の自動復旧に対応済み)*

- **📊 統合ダッシュボード (Observability)**
  資金フローの可視化グラフ、リアルタイム監査ログ、手動介入インターフェースを備えた管理画面を提供します。

---

## アーキテクチャ

Susanoh は、スケールアウト可能なマイクロサービスアーキテクチャへの移行を進めています。

### Target Architecture (Production Goal)

```mermaid
graph TD
    GameServer -->|HTTP/REST| APIGateway[FastAPI Gateway]
    APIGateway -->|Events| L1[L1 Screening Engine]
    L1 -->|State| Redis[(Redis State Store)]
    L1 -->|Async Task| Queue[Task Queue]
    Queue --> Worker[L2 Analysis Worker]
    Worker -->|Prompt| LLM[Gemini API]
    APIGateway -->|Logs| DB[(PostgreSQL)]
    Dashboard -->|Query| APIGateway
```

### Current Implementation (Prototy