設計資料

        flowchart LR
          subgraph internet [インターネット]
            Attacker[不正利用者]
            App[本番アプリ]
          end
          subgraph cf [Cloudflare]
            TLS[HTTPS終端]
            Tunnel[Named Tunnel]
          end
          subgraph host [役場PC]
            API[FastAPI :8000]
            DB[(PostgreSQL)]
            Store[Storage]
            PAT[worker/.env PAT]
          end
          subgraph gh [GitHub]
            GHA[Actions]
          end
          App -->|HTTPS FB POST| TLS --> Tunnel --> API
          Attacker -.->|URL知得時 無認証POST可| TLS
          API --> DB
          API --> Store
          PAT -->|dispatch| GHA
                

        flowchart TB
          subgraph L7["層7 アプリ: HTTP POST /api/v1/feedback"]
            App[本番アプリ]
            Curl[curl いたずら]
            API[FastAPI]
          end
          subgraph L6["層6 表現: TLS"]
            TLS[HTTPS 暗号化]
          end
          subgraph L4["層4 輸送: TCP ポート"]
            CF443["Cloudflare :443"]
            LAN8000["PC LAN :8000 ← 現状 docker expose"]
          end
          subgraph L3["層3 ネットワーク: IP"]
            Internet[インターネット]
            LAN[同一 LAN]
          end
          App --> TLS --> CF443
          Curl --> TLS --> CF443
          CF443 --> Tunnel[cloudflared Tunnel]
          Tunnel --> API
          LAN -->|"FW未設定時 到達可"| LAN8000 --> API
                

        flowchart TB
          subgraph Client["クライアント（スタブアプリ）"]
            FB["FB データ（画像 + 推論結果 JSON）"]
          end
        
          subgraph CFNet["インターネット / Cloudflare"]
            CF["Edge Server（HTTPS 終端）"]
          end
        
          subgraph Server["自宅 PC（Docker）"]
            TUN["cloudflared（Tunnel クライアント）"]
            API[FastAPI]
            DB[(Database)]
            STG[(File Storage)]
            WK[AI Worker]
          end
        
          subgraph CICD["GitHub（インターネット）"]
            GHA[GitHub Actions]
            ART[APK / IPA artifact]
          end
        
          subgraph Deploy["配布"]
            DEV[管理下端末]
          end
        
          FB -->|"①内向き HTTPS"| CF
          CF -->|"Tunnel 中継"| TUN
          TUN --> API
          API --> STG
          API --> DB
          DB --> WK
          STG --> WK
          WK -->|新モデル| STG
          WK -->|"②外向き Webhook"| GHA
          GHA --> ART
          ART -->|"③配布（Tunnel 外）"| DEV
                

        flowchart LR
          A[FB データ蓄積] --> B[AI Worker 再学習]
          B --> C[新モデルファイル]
          C --> D[Git 反映 or 配置]
          D --> E[repository_dispatch]
          E --> F[GHA ビルド]
          F --> G[モデル同梱 APK/IPA]
          G --> H[端末へ配布]
                

        sequenceDiagram
          autonumber
          actor User as 利用者
          participant App as スタブアプリ
          participant Attacker as 不正送信者（任意）
          participant CF as Cloudflare Edge
          participant TUN as cloudflared
          participant API as FastAPI
          participant STG as Storage
          participant DB as Database
        
          Note over App,API: SEC-01 前 — Authorization ヘッダなし
          User->>App: 画像選択・推論
          App->>CF: POST /api/v1/feedback (HTTPS, 画像+JSON)
          CF->>TUN: Tunnel 中継
          TUN->>API: 転送
          API->>STG: 画像保存
          API->>DB: メタデータ記録
          API-->>App: 201 Created
        
          Note over Attacker,API: 抜け道 — URL さえ分かれば同じ POST が通る
          Attacker->>CF: POST（鍵なし curl 等）
          CF->>TUN: 中継
          TUN->>API: 転送
          API-->>Attacker: 201 Created
                

        sequenceDiagram
          autonumber
          actor User as 利用者
          participant App as スタブアプリ
          participant Attacker as 不正送信者
          participant CF as Cloudflare Edge
          participant TUN as cloudflared
          participant API as FastAPI
          participant Auth as SEC-01 認証
          participant STG as Storage
          participant DB as Database
        
          Note over App: APK 内 feedbackApiKey
（ビルド時 dart-define）
          User->>App: 画像選択・推論
          App->>CF: POST + Authorization Bearer 鍵
          CF->>TUN: Tunnel 中継（TLS 済み）
          TUN->>API: 転送
          API->>Auth: 鍵一致?
          Auth-->>API: OK
          API->>STG: 画像保存
          API->>DB: メタデータ
          API-->>App: 201 Created
        
          Note over Attacker: 鍵なし / 誤キー
          Attacker->>CF: POST（Authorization なし）
          CF->>TUN: 中継
          TUN->>API: 転送
          API->>Auth: 鍵一致?
          Auth-->>API: NG
          API-->>Attacker: 401 Unauthorized
                

        flowchart LR
          subgraph ok [守れていたこと]
            TLS["HTTPS: 盗聴防止"]
            TUN["Tunnel: CGNAT 回避"]
          end
          subgraph ng [守れていなかったこと]
            URL["公開 URL の共有"]
            CURL["curl / 任意クライアント"]
            URL --> CURL
            CURL --> API["FastAPI POST → 201"]
          end
                

        sequenceDiagram
          autonumber
          actor Op as 運用者
          participant WK as AI Worker（PC）
          participant STG as Storage
          participant DB as Database
          participant GH as GitHub API
          participant GHA as GitHub Actions
          participant Dev as 管理下端末
        
          Op->>WK: run-training-stub.ps1
          WK->>DB: FB データ参照（ローカル）
          WK->>STG: モデル生成
          Note over WK,GH: PAT（worker/.env）で認証
FEEDBACK_API_KEY とは無関係
          WK->>GH: repository_dispatch + PAT
          GH->>GHA: android-build.yml 起動
          Note over GHA: secrets.FEEDBACK_API_KEY
→ dart-define → APK
          GHA->>GHA: Flutter ビルド
          GHA-->>Dev: artifact → adb install
                

        sequenceDiagram
          actor Op as 運用者
          participant GHA as GitHub Actions
          participant Sec as Actions Secret
          participant Art as Artifact
        
          Op->>GHA: Run workflow（GitHub UI）
          GHA->>Sec: FEEDBACK_API_KEY 読み込み
          Sec-->>GHA: ビルド時 dart-define へ
          GHA->>GHA: flutter build apk --release
          GHA->>Art: APK 出力
          Op->>Art: ダウンロード → adb install
                

        sequenceDiagram
          participant GHA as GitHub Actions
          participant FL as Fastlane
          participant ASC as App Store Connect
          participant TF as TestFlight
          participant iPhone as iPhone
        
          GHA->>FL: iOS ビルド・署名
          FL->>ASC: アップロード
          ASC->>TF: ビルド公開
          iPhone->>TF: 更新取得・インストール