メインコンテンツへスキップ
見出し画像

Sieve シリーズの構造設計 — 依存方向がアーキテクチャを決める

    はじめに — 「機能の集まり」と「構造」は別の話

    Sieve シリーズを外から見ると、5 つの PyPI パッケージと 1 つのデスクトップアプリがある。各エンジンの解説記事では、それぞれの内部(4 段パイプライン、7-bit 観測空間、16 状態 LUT、決定論的マスキング)を語ってきた。

    この記事は、残るもう一つの階層 — エンジンとエンジンを繋ぐ構造についての記録だ。なぜコアは単一ファイルなのか。なぜ PDF 対応は「コアへの機能追加」ではなく「拡張の install」なのか。なぜ Lens と Redact は直接関数を呼び合わず、カタログというファイルで繋がるのか。そしてなぜ、Redact のコピーを Tray の中に置き、そのコピーが本家と同一バイトであることを CI が毎回確認するのか。

    これらの判断は、個別の事情ではなく、一貫したひとつの原則から導かれている。依存は一方向にのみ流れ、循環を作らない。そして、境界を跨ぐものは必ず「ファイル」や「明示的な契約」という形にする。 この原則が、実装の細部まで構造を決めていく様子を記録する。

    以降の有料部分では、これらの判断を 1 つずつ掘り下げる。各章で扱うのは、判断の理由(なぜそうしたか)だけでなく、反例(そうしなかったらどう壊れるか)の具体的な姿と、判断が連鎖して今の構造に至った経緯までだ。

    対象読者
    自作ライブラリのパッケージ分割やプラグイン機構に迷っている方・複数ツールを連携させるシステムの設計をこれから行う方・GUI とエンジンの依存関係に悩んだことがある方。プログラミングの経験は問いません。構造の判断の記録として読めます。コード断片(JSON・pyproject・クラス図に相当するもの)は出てくるが、読めなくても判断の流れは追えるようにしてあります。

     
     
    現在は国際中等教育学校に通う中等生の neguseatama です。プロダクトやツールを開発しています。 このnoteでは、探求のストーリー、デザインや設計のプロセスなどを発信していきます。 ■ GitHub https://github.com/neguseatama

    あなたへのおすすめ