このプロジェクトについて

看盤(Kanpan、製品名 Hkline)は Swift ネイティブの iOS 相場・自選・振り返りアプリです。画面は SwiftUI、チャートは UIKit/CoreGraphics による自前描画で、アプリ側にサードパーティ依存はなく、取引・発注機能は提供しません。相場データは Binance の USDT 無期限の公開インターフェースから取得します。設定内の「相場回線」は直結(Binance ドメインのみ)とゲートウェイ(2 台の VPS 経由で OKX 相場を取得)の 2 段階を用意し、ユーザーが手動で選択する方式で、自動切り替えもソースの混在も行いません。 主な機能 - スキン:「青苔・冷」「陶土・暖」「クラシック」の 3 セットを提供し、それぞれライトとダークがあります。システム追従または手動指定が可能です。K ラインの色は 1 セットに統一し、スキンはチャート外の領域にのみ影響します。 - ボトムバー:常駐の「画線・チャート・自選・セクター分類・設定」の 5 分割等幅タブバー。「画線」はアクションで、タップすると横画面で描画し、自動で元に戻ります。 - 相場ページ:トップバーには銘柄バッジ、銘柄名、振り返り入口(未処理バッジ付き)、検索入口があります。価格ブロックは最新価格、騰落額、騰落率を表示し、右側に固定 6 枠の統計(建玉/額、時価総額/手数料率、決済/振幅)を表示します。期間バーは常用行が 6 段の等幅で、全 14 段(1m〜1y)は「もっと見る」でピン留めまたは解除できます。価格エリアを左右に横スワイプすると銘柄を連続切り替えできます。 - 自選ページ:リスト行には銘柄バッジ、価格、騰落ピルがあり、分類フォルダ、並び替え(騰落率基準と「アラートラインに最も近い」を含む)、長押しの読み取り専用プレビューカード、ドラッグ並び替え、スワイプまたは一括削除後の取り消しに対応します。コールドスタート時はお気に入りがあれば自選ページへ、なければ BTC へ遷移します。 - セクター分類:ボトムバーの 4 枠目で、第 1 階層はセクターのバブル、タップでそのセクターの銘柄リストに入り、暗号資産と米国株は上部でハード切り替えします。 - チャート:AICoin の操作感を再現。メインチャートは移動平均線(10/30/120/256)、指数移動平均線、ボリンジャーバンドに対応。サブチャートは初期状態で出来高、建玉量、平滑異同移動平均線で、最大同時 3 つまで。ほかに相対強弱、ストキャスティクス、トゥルーレンジ、ロングショート比、主動売買比、ベーシスなどの候補があります。板情報 10 行ラダー、2 本指ズーム、履歴フォーカスズーム、手動 Y 軸、最終足の右端貼り付きと範囲外ダンピングに対応。41 個の画線ツール(9 グループ)を備え、画線とチャートは座標を共有します。 - アラート:独立モジュール。画線後にヘッダーの価格行が確認カードに変わり、「タッチを待つ」または「終値で抜けるのを待つ」の 2 種類の判定を設定でき、再アラートにも対応します。フォアグラウンドでは AlertEngine がローカル評価し、バックグラウンドでは kanpan-worker サーバー側が評価して同期に書き戻し、active 状態で重複排除します。APNs キーがない場合でも機能は利用可能で、ロック画面バナーが表示されないだけです。 - 振り返り:1 件の記録、リスト/未処理/統計、詳細、1 本ずつの再体験、プライベート OHLC による類似検索に対応し、記録は所属する相場ソースを固定します。 - アカウント:ユーザー名とパスワードによる登録・ログイン、Keychain セッション、デバイス管理、パスワード変更、退会に対応。個人データはアカウントディレクトリごとに分離し、クラウド同期は送信待ちキューを基準とし、メール登録はありません。 コード構成 - Kanpan/Kanpan/:アプリ画面。Main、Symbols、Sector、Panels、Settings、Drawing、Account、ReviewIntegration を含みます。 - Kanpan/Symbols、Kanpan/Settings:KanpanSymbols、KanpanSettings の 2 つのローカルパッケージと単体テスト。 - Kanpan/KanpanUITests/:XCUITest。accessibilityIdentifier でコントロールを特定します。 - KanpanCore/:座標、レイアウト、指標、画線、スキン色パレットなどの純 Swift アルゴリズム。 - KanpanChart/:自前描画チャートと UIKit ジェスチャ。 - KanpanNetwork/:HTTP/WS の最小インターフェース、Binance REST/WS クライアントとレート制限、相場回線、ゲートウェイの競速とクールダウン。 - KanpanData/:相場 feed、ディレクトリ、履歴 OI、スナップショットとキャッシュ。 - KanpanAccount/、KanpanReview/:アカウント同期と振り返りモジュール。 - Backend/kanpan-gateway:2 台の VPS 相場ゲートウェイ(Python + aiohttp、読み取り専用のプローブのみ)。 - Backend/kanpan-api:Rust の個人バックエンド。アカウント、同期、振り返りインデックスを担当します。 - prototype/:HTML プロトタイプ。docs/:仕様インデックス、作業リスト、受け入れ証跡。 ビルドと検証 Swift 6 を使用し、デプロイターゲットは iOS 26.0(iOS 27 もサポート範囲、26 未満はメンテナンス対象外)。Kanpan/Kanpan.xcodeproj またはルートの Kanpan.xcworkspace を開き、Kanpan scheme を選択します。swift test で KanpanCore、KanpanNetwork、KanpanData、Kanpan/Symbols をそれぞれテストでき、ほかに make strict と xcodebuild シミュレータビルドコマンドがあります。検証はシミュレータを主とし、影響を受ける UI ケースはタイムアウト付きで実行し、スクリーンショットを保存します。リポジトリには VPS ログイン設定、秘密鍵、パスワード、トークンは含まれません。