graph TB
    Client["Geminiクライアント"]
    Network["TLS/SSLネットワーク"]
    
    ReactLoop["React EventLoop<br/>イベントループ"]
    TcpServer["TcpServer<br/>TCP接続層"]
    SecureServer["SecureServer<br/>TLS層"]
    
    GeminiServer["GeminiServer<br/>コア処理"]
    RequestParser["RequestParser<br/>リクエスト解析"]
    StaticFileHandler["StaticFileHandler<br/>ファイル配信"]
    ResponseBuilder["ResponseBuilder<br/>レスポンス構築"]
    CertificateGenerator["CertificateGenerator<br/>TLS証明書管理"]
    
    FileSystem["ファイルシステム<br/>ドキュメントルート"]
    Certs["証明書ストレージ<br/>certs/"]
    
    Client -->|"gemini://host/path\r\n"| Network
    Network --> TcpServer
    TcpServer --> SecureServer
    SecureServer -->|"接続イベント"| GeminiServer
    
    GeminiServer -->|"dataイベント<br/>バッファ処理"| RequestParser
    RequestParser -->|"パース結果"| GeminiServer
    GeminiServer -->|"ファイル要求"| StaticFileHandler
    StaticFileHandler -->|"MIME型 + 本体"| GeminiServer
    GeminiServer -->|"レスポンス生成"| ResponseBuilder
    ResponseBuilder -->|"STATUS SPACE META\r\nBODY"| GeminiServer
    
    GeminiServer -->|"データ送信"| SecureServer
    SecureServer -->|"TLS暗号化"| Network
    Network -->|"レスポンス"| Client
    
    GeminiServer -->|"eventLoop駆動"| ReactLoop
    ReactLoop -->|"非同期処理"| GeminiServer
    
    StaticFileHandler -->|"ファイル読み込み"| FileSystem
    CertificateGenerator -->|"証明書生成・読み込み"| Certs
    GeminiServer -->|"証明書パス"| SecureServer
    
    style ReactLoop fill:#e1f5ff
    style GeminiServer fill:#f3e5f5
    style RequestParser fill:#f1f8e9
    style StaticFileHandler fill:#f1f8e9
    style ResponseBuilder fill:#f1f8e9
    style CertificateGenerator fill:#fce4ec
    style TcpServer fill:#fff3e0
    style SecureServer fill:#fff3e0

sequenceDiagram
    actor Client1
    participant Loop as "Event Loop"
    participant Server as "GeminiServer"
    participant Handler as "Handler"
    
    activate Loop
    Loop->>Server: loop.run()実行開始
    
    Client1->>Loop: TCP接続要求
    Loop->>Server: connectionイベント発火
    activate Server
    Server->>Handler: 接続ハンドラー登録<br/>dataイベント・errorイベント
    deactivate Server
    
    Client1->>Loop: Geminiリクエスト送信
    Loop->>Handler: dataイベント発火
    activate Handler
    Handler->>Handler: バッファに蓄積
    Handler->>Handler: \\r\\nで分割チェック
    Handler->>Handler: RequestParser.parse()実行
    Handler->>Handler: StaticFileHandler.handle()実行
    Handler->>Handler: ResponseBuilder.success()実行
    Handler->>Handler: conn.write()レスポンス送信
    Handler->>Handler: conn.end()接続終了
    deactivate Handler
    
    deactivate Loop

graph TD
    A["接続イベント発火"] --> B["バッファ初期化<br/>buffer = ''"]
    B --> C["dataイベント<br/>データ受信"]
    C --> D["バッファに蓄積<br/>buffer += data"]
    D --> E{"\\r\\n検出?"}
    E -->|No| F{"長さ > 1024?"}
    F -->|Yes| G["59 Request too long<br/>接続終了"]
    F -->|No| C
    E -->|Yes| H["RequestParser.parse<br/>リクエスト解析"]
    H --> I{"パース成功?"}
    I -->|失敗| J["59 Invalid request<br/>接続終了"]
    I -->|成功| K["StaticFileHandler.handle<br/>ファイル解決"]
    K --> L{"ファイル存在?"}
    L -->|No| M["51 Not found<br/>接続終了"]
    L -->|Yes| N["ResponseBuilder.success<br/>レスポンス構築"]
    N --> O["conn.write<br/>レスポンス送信"]
    O --> P["conn.end<br/>接続終了"]
    
    style A fill:#e3f2fd
    style G fill:#ffebee
    style J fill:#ffebee
    style M fill:#ffebee
    style P fill:#c8e6c9

graph TD
    A["パス受信<br/>例: /document.gmi"] --> B["ドキュメントルートと結合<br/>docRoot + path"]
    B --> C{"ディレクトリ?"}
    C -->|Yes| D["index.gmiを追加<br/>path/index.gmi"]
    C -->|No| E["ファイルパス確定"]
    D --> E
    E --> F["realpath()実行<br/>正規化・シンボリック解決"]
    F --> G{"存在?"}
    G -->|No| H["null返却"]
    G -->|Yes| I{"ドキュメント<br/>ルート内?"}
    I -->|No| H
    I -->|Yes| J{"ファイル?"}
    J -->|No| H
    J -->|Yes| K["file_get_contents<br/>ファイル読み込み"]
    K --> L["拡張子判定<br/>MIME型決定"]
    L --> M["mime + body<br/>返却"]
    
    style M fill:#c8e6c9
    style H fill:#ffebee

sequenceDiagram
    participant Client as "Geminiクライアント"
    participant Loop as "Event Loop"
    participant Server as "GeminiServer"
    participant Parser as "RequestParser"
    participant Handler as "StaticFileHandler"
    participant Builder as "ResponseBuilder"
    
    Client->>Server: TLS接続
    activate Server
    
    Client->>Server: リクエスト送信<br/>gemini://host/path\r\n
    
    Server->>Server: dataイベント<br/>バッファに蓄積
    Server->>Server: \\r\\n検出
    
    Server->>Parser: parse(buffer)
    activate Parser
    Parser->>Parser: URL解析
    Parser-->>Server: {host, path}
    deactivate Parser
    
    Server->>Handler: handle(path)
    activate Handler
    Handler->>Handler: ドキュメントルート+パス結合
    Handler->>Handler: realpath()正規化
    Handler->>Handler: パストラバーサル検証
    Handler->>Handler: ファイル読み込み
    Handler->>Handler: MIME型判定
    Handler-->>Server: {mime, body}
    deactivate Handler
    
    Server->>Builder: success(mime, body)
    activate Builder
    Builder-->>Server: "20 mime\r\nbody"
    deactivate Builder
    
    Server->>Server: conn.write(response)
    Server->>Client: レスポンス送信<br/>TLS暗号化
    
    Server->>Server: conn.end()
    deactivate Server
    
    Client->>Client: レスポンス受信・処理

graph LR
    subgraph "同期型処理"
        A["リクエスト1受信"] -->|ブロッキング| B["ファイル読み込み"]
        B -->|ブロッキング| C["レスポンス1送信"]
        C -->|待機中| D["リクエスト2受信不可"]
    end
    
    subgraph "非同期型処理\n(React PHP)"
        E["リクエスト1受信"] -->|非同期| F["ファイル読み込み\n(バックグラウンド)"]
        E -->|即座に切り替え| G["リクエスト2受信"]
        G -->|非同期| H["ファイル読み込み\n(バックグラウンド)"]
        F -->|完了| I["レスポンス1送信"]
        H -->|完了| J["レスポンス2送信"]
    end
    
    style A fill:#c8e6c9
    style E fill:#c8e6c9
    style I fill:#c8e6c9
    style J fill:#c8e6c9

graph TB
    PHP["PHP 8.1+"]
    OpenSSL["OpenSSL拡張<br/>証明書生成"]
    FileSystem["ファイルシステム<br/>ドキュメント配信"]
    Network["ネットワークスタック<br/>TLS/SSL"]
    
    GeminiServer -->|"OpenSSL関数"| OpenSSL
    GeminiServer -->|"file_get_contents()"| FileSystem
    GeminiServer -->|"TcpServer/SecureServer"| Network
    GeminiServer -->|"PHP実行環境"| PHP
    
    style OpenSSL fill:#fff3e0
    style FileSystem fill:#f1f8e9
    style Network fill:#f3e5f5