このページではデータオブジェクトを定義します。レポートの定義、そのスキーマ、およびその結果セットを1つの契約として扱うものです。これはマルチソース作業がその上に構築される設計であり、フォーマット仕様は今日出荷されているドキュメントを記述します。
スコープ: 2026-10-16に提起された概念——データオブジェクトとは何か、このコードベースでどのように表現されているか、それを形式化するのに何が必要か。同じ会話で述べられたマルチソース/サブレポートの組み立ては、契約の帰結としてここに書き留められており、意図的に構築されていません。
日付: 2026-10-16、445794e11で読了。
ステータス: 設計ドキュメント。提案するもので、何も実装せず、ここにあるものは何も予定されていません。プロジェクトのビジョン §1——「レポートとはデータソースからテーブルへの関数である」——が、このファイルが具体化し、コードに名前を付けるビジョンです。
今日、ユーザーは1つのデータベース(MySQL、SQL Server、またはSqlite3)に対してアドホッククエリを設計し、それがデータのテーブルを返し、レポートはそのデータの上にレイアウトツールで構築されます。レポートはクエリとレイアウトです。一般化とは、クエリの半分を取り出してそれをオブジェクトにすることです。
データオブジェクトとは、スキーマと結果セットを生成する名前付き定義です——レポートのクエリを、そのレイアウトから分離し、アイデンティティを与えたもの。その出力はリフレッシュされ、アドレス指定され、別のデータオブジェクトのソースとして使えます。レポートとは、データオブジェクトと、そのオブジェクトの列にバインドされたプレゼンテーションです。
ユーザー自身の言葉(2026-10-16): 「一種のスキーマと結果セットを返すもので、レポートはアドホッククエリ、レポーティング、デザインである。」
3つの帰結があり、それぞれ以下で追跡します。
mad refreshが実行するもの)、将来のウェブサーバー(エンドポイントが実行するもの)、そしてAI(下書きし、エンジンが検証するもの)に使われます。1つの定義、多数の消費者——これはオブジェクトが独自の名前とスキーマを持って初めて真になります。明示的にそうでないもの:
MAD_FORMAT.md §5.1)。データオブジェクトは、キャッシュが今日すでに保持しているものを正確に生成します。| 用語 | それが何か | 今日のクラス |
|---|---|---|
| ソーススキーマ | ユーザーがクエリできるデータベースのテーブルとフィールド | ライブブラウジング: MADDatabaseTable / MADDatabaseField(MADAPI)。スナップショット: RptqDatabaseSchemaTable / RptqDatabaseSchemaField、ドキュメント作成時に一度インポート |
| 定義 | クエリグラフ: どのテーブル、どのフィールド、結合、フィルタ、グループ化、ソート | RptqQuery + RptqQueryTable / RptqQueryField / RptqQueryLinks / RptqQueryPredicate / RptqQueryGroup |
| 結果スキーマ | 出力の列: 名前、型、ネイティブ型、長さ/精度、主キー、非NULL | MADDataColumn(列ごとに1つ)、テーブル上に保持 |
| 結果セット | 行 | MADDataTableクラスクラスタ。MADDataTableFastとしてマテリアライズ |
| マテリアライゼーション | ディスク上の結果セット: SQLiteテーブルとそのシリアライズされたスキーマ | <tag>.maddb(SQLite)+ <tag>.mdcache(plist、MADDataTable -copyPlist)、ドキュメントのキャッシュディレクトリ内 |
| スナップショット | MAD_FUTURE.mdの言葉: 名前、バージョン、アドレスを与えられたマテリアライゼーション |
存在しない。§4.3がその始め方 |
| ストアスキーマ | 上記すべてとは無関係: ドキュメント自身のストレージフォーマット | MADStoreSchema(MAD/Source/rptq/store/) |
今日のドキュメントは定義とレイアウトを保持し、マテリアライゼーションはその隣に、ドキュメント(定義ではない)をキーとして存在します。この分割は正しいものであり(MAD_FORMAT.md §5)、この設計はそれを保ちます。
データオブジェクトの各部分はすでに存在し、異なるレイヤーに、異なる目的のために構築されています。以下はそれぞれの正確な状態と、形式化がつまむことになるシームです。
RptqQueryとそのグラフクエリグラフはコンパイルするのに十分完全です。テーブル(RptqQueryTable、aliasと、1つのスキーマテーブルを複数回含められるdropIndex付き)、射影(RptqQueryField——スキーマテーブル+スキーマフィールドID)、結合(RptqQueryLinks、リンク型付き)、フィルタ(RptqQueryPredicate)、グループ化(RptqQueryGroup、RptqQuery -sortDescriptorsForDatabase:経由でソート記述子を駆動)、そして痕跡的なソート行(RptqQuerySort、デバッグ記述だけが読む)があります。デザイナはMADModel*読み取りモデルを通じてそれを編集します(「Rptqを通じて書き、MADModelを通じて読み観察する」——MADModel_Layer.md)。
グループ化はクエリレベルの定義であり、レポートセクションではありません。RptqQueryGroup.hasFieldはクエリがグループ化するフィールドを、sortはその方向を名指しします。クエリが実行されるには、各グループのフィールドがドキュメントが選択するクエリテーブルに属さなければなりません(hasField.inQueryTable)。グループ化は結果行上の順序付きキーとしてマテリアライズされ(-sortDescriptorsForDatabase:)、フォーマッタはそのキーを比較してグループ境界を見つけます。レポートのグループヘッダー/フッターセクションはそのグループのプレゼンテーションにすぎません——グループ化フィールドを表示する要素を1つも含まなくても、グループ化は依然として行われます。レイアウトが欠けているグループ化フィールドを補うことはできないため、フィールドがnilのグループ、または選択されたクエリテーブルに裏付けられていないフィールドを持つグループは無効なドキュメントです。デザイナは壊れたグループが見えるようにそのようなセクションを構築しラベル付けしますが、クエリ実行とレンダリングはNSInvalidArgumentExceptionでそれを拒否し、グループをログに記録します。
そのアイデンティティに関する2つの事実:
RptqQueryはRptqDatabase行にぶら下がり、「それぞれの最初のもの」を通じてドキュメントに到達します。RptqDatabase -defaultQueryはhasQueries.anyObject(RptqDatabase+Extras.m:88)、RptqDocument -mainQueryも同様です(RptqDocument+Extras.m:184)。MADModelDocumentはRptqQuery行ごとに1つのMADModelDatabaseを構築し(MADModelDocument.m:210-240)、コード自身のコメントは「現在のバージョンのソフトウェアは1つのデータベースとクエリだけを使う」と述べています。基数はアプリのフローの慣習であり、ストアのものではありません。MADQueryFullMADQueryFull -copySQLWithManagedObjectContext:error:(MADQueryFull.m:133)がSQLを構築します。射影される列はMADQuerySelectExpressionActiveFieldsから来ており、これはレポートの要素、リンク、グループが参照するすべてのフィールドをMADQueryActiveQueryFieldsに尋ねます。FROM/JOINはテーブルとリンクのMTGraphからトポロジカルソートされてコンパイルされ(:170-204)、述語とリテラルの引用はMADDatabase(newSafeIdentifier:、newSafeLiteral:)を通り、LIMITはsqlLimitClause:経由です。
これはMAD_FUTURE.md §3が差別化要因として数える決定論的で所有されたSQL生成です——それは存在し、ヘッドレスです(LinuxビルドではMADSources.cmake:93)。
しかしそれはドキュメントに溶接されています。 MADQueryFullは初期化されたクエリをqueryObject(:79)に保存し、決してそれを使いません。SQLパスはドキュメントの最初のデータベースと最初のクエリを再読します(:147-149)。また-getSql:error:を実装していない(ベースは@""を返す、MADQuery.m:48)ため、汎用のMADDatabase -executeQuery:withError:パスはドキュメントのメインクエリをまったく実行できません。渡したクエリオブジェクトは何が実行されるかを決めません。
MADDatabase抽象点は-[MADDatabase executeSQL:fieldKeys:onConnection:intoResultTable:withError:](MADAPI/Source/MADDatabase.m:147、3つのドライバすべてが上書き)です。その宛先はid <MADDataTableWriting>と型付けされています——任意の書き込み可能なテーブルであり、特定のテーブルクラスではありません。充填契約はドライバ間で均一です。removeAllObjects → addColumn: → beginBulkInsert → addRowWithDataForFieldKeys: → endBulkInsert(MAD_DATA_OBJECTのドライバ: MySQL MADMySQLFetch+DataTable.m:148-235、SQL Server MADDatabaseSQLServer.m:485-571、Sqlite3 MADDatabaseSqlite3.m:474-540)。
ドライバはまた、クエリがMADQueryDataTableProtocolに準拠している場合、ドキュメントのターゲットテーブルよりクエリ自身のターゲットテーブルをすでに優先します(MADQuery.h:28-50。各ドライバの-executeQuery:がそれを確認します——例: MADDatabaseMySQL.m:331-339)。プロセスごとに複数の結果テーブルを持つことは意図された拡張ポイントであり、サンプルデータクエリファミリだけが行使しています。
ドキュメントレベルの縫合はMADOperationRefresh(MADDesigner/Source/MADOperationRefresh.m、131行、UIKitゼロ)です。認証情報を受け取り、document.mainQuery → SQL、document.databaseが接続し、document.dataTableに実行し、dataTableMakeCacheが.mdcacheを書き、document.refreshed = YESとします。それはCLIのrefresh動詞でもあり、CLI/build.shのREFRESH_SOURCESによってターゲット境界を越えてコンパイルされます(ROADMAP.md §3.4)。それは実行ではなくリフレッシュ+永続化+公開です。共有ドキュメント状態にハードワイヤードされ、self.dependenciesを検査して認証情報を発見し、ドキュメントを変更します。
MADDataTableとMADDataColumnMADDataTable(MADFoundation/Source/MADDataTable.h)は、その仕事全体が「スキーマと行」であるクラスクラスタです。ベースにメタデータと永続化、サブクラスごとにストレージ(メモリ内のMADDataTableVirtual、SQLite上のMADDataTableFast)を持ちます。スキーマオブジェクトはMADDataColumnです——identifier、fieldName、caption、type(MADDataType)、nativeType、dataLength、dataPercision、isPrimaryKey、isNotNull、isAutoIncrement、defaultValue——第一級でシリアライズ可能な列記述です。
そしてスキーマはすでにディスク上の行から分離可能です。-copyPlist(MADDataTable.m:238-253)は名前+列キー+列plist+行カウンタをシリアライズし、明示的に行を含めません——それがまさに.mdcacheファイルであり、MADDataTableFastが書き読みします(-copyPlist / -loadWithPlist:。MAD_FORMAT.md §5.3)。
このレイヤーで欠けているもの:
SQLITE_ROW反復の内側でのみ列を発見するため(MADDatabaseSqlite3.m:496-535)、空の結果は列もDDLもないテーブルを生成します。MySQLとSQL Serverは行が到着する前に結果メタデータから列を追加するため、このギャップはSqlite3固有です。MADDataTableFastのcolumnKeysは生成されたc<hash>名であり、フィールド名ではありません。使用可能なスキーマ表面はMADDataColumnのcolumns辞書です。そしてfor (x in fastTable)は静かに何も生み出しません——ベースは0アイテムを返し、FastはcountByEnumeratingWithState:を上書きしません。呼び出し元はobjectEnumeratorを使わなければなりません。MADDataTableFastはテーブル上の抽象ではなく、テーブルそのものです。各インスタンスは<tag>.maddb内の1つの物理SQLiteテーブルt<tag>を所有し(-tableName MADDataTableFast.m:498、-filenameCacheMadDB :399)、列はc<hash-of-fieldName>です。2つ目の接続(databaseForSelects)が選択側を実行します。グループ化はその1つのテーブル上のインデックスであり(-sortUsingDescriptors: :737、-setupGroupKeyIndexes :545、グループプレフィックスレベルの数だけインデックス)、集計はキャッシュ上のSQLです(MADQueryCacheAggregateFunction、MADocument -dataForRows:column:groups:function:groupBy:が駆動)。ソースデータベースにはGROUP BYが一切生成されません——検証済み: その文字列はどのソースファイルにも現れません。ソースはフラットにクエリされ、グループ化または集計されたものはすべて、マテリアライゼーション上でSqlite3によってローカルに計算されます。
2つの示唆的なスタブが、アーキテクチャが多数のテーブルを求める理由を示しています。クラスファクトリMADDataTable+Constructor(newDataTableOfType:withObjectID:cacheDirectory:——物理はIDをタグとしてMADDataTableFastにマップ、:56-78)は、2つ目、3つ目のテーブルを構築上安価にします。そして-cacheTableNameForGroupLevel:(MADDataTableFast.m:813)はグループレベルごとにテーブルs<level>を名付けるはずですが、呼び出し元がありません。それが示唆するグループ化ごとのテーブルは決してマテリアライズされません。
アドレスはファイル名です。 ドキュメントのテーブルはinitWithId: fileURL.lastPathComponent.hash(MADocument.m:269-283)で作成され、キャッシュディレクトリはdataTableIdHashと名付けられます(MADURLFactory newURLCacheFilesDirectoryForFilename:)。ドキュメントごとに1つの結果テーブルがあり、その名前はドキュメントが名前変更されると変わり、何もそれを指すことができません。
| レイヤー | 存在する | データオブジェクトに欠けているもの |
|---|---|---|
| 定義 | 完全なクエリグラフ。読み取りモデル。ストアは多数のクエリを許容 | 独自の名前とアイデンティティ。別のデータオブジェクトになり得るソース参照 |
| コンパイラ | グラフからの決定論的SQL | 「ドキュメントの最初のクエリ」からの自由。スキーマ専用パス |
| 実行 | 任意のMADDataTableWritingターゲット。3つのドライバ。クエリごとのターゲットテーブル |
リフレッシュではない実行——ドキュメントの変更なし、認証情報は発見ではなく渡される |
| 結果値 | MADDataTable + MADDataColumn。スキーマ専用永続化(-copyPlist) |
実行なしのスキーマAPI。ゼロ行のスキーマ喪失 |
| マテリアライゼーション | 実際のSQLiteテーブルt<tag>。ローカルのグループ化と集計 |
タグ=ファイル名ハッシュ。慣習によりドキュメントごとに1テーブル |
| バインディング | レイアウト → referencesQueryField → レンダー時にMADDocumentObjectDataReference*で解決 |
ドキュメントの単一クエリではなくあるデータオブジェクトへのバインディング |
| アドレス | — | すべて |
3つのハードワイヤリングポイントが具体的なブロッカーであり、3つともコードに見えます。
MADQueryFullは自身のクエリオブジェクトを無視します(MADQueryFull.m:147-149)。MADDocument -dataTableForQuery:はMADQueryFullに対してself.dataTableを返し、それ以外にはnilを返します(MADocument.m:908)——1スロットのスイッチです。MADQueryActiveQueryFieldsはクエリスコープなしでストア内のすべての要素、リンク、グループをスキャンします(MADQueryActiveQueryFields.m:27-99)。自身のヘッダーのFIXMEはこう述べています。「現在、ソフトウェアは1つのクエリオブジェクトしか扱わない。」 2つ目のクエリのフィールドは最初のクエリのSELECTリストに漏れます。2つの半分を意図的に分離します。
@protocol MADDataObjectSchema <NSObject> // describe: no database needed
- (NSArray<MADDataColumn *> *)resultSchema; // columns, types, from graph + snapshot
@end
@protocol MADDataObjectExecuting <NSObject> // execute: yields the materialization
- (nullable MADDataTable *)executeIntoDataTable:(nullable MADDataTable *)target
credentials:(MADCredentials *)credentials
error:(NSError **)error;
@end
名前は例示であり、分割が要点です。Describeは接続、認証情報、行なしで動作しなければなりません——グラフと保存されたスキーマスナップショットから——なぜならそれがデザイナが描くもの、AIが検証する対象、ウェブサーバーが一覧するもの、名前変更されたドキュメントが壊せないものだからです。Executeはターゲットテーブルと認証情報を引数に取り、テーブルを返さなければなりません——ドキュメントの変更なし。そうすればMADOperationRefreshは「executeを呼び、永続化し、公開する」に縮み、CLI、サーバー、テストがすべて同じものを呼びます。
これは契約が本物である最初の正直な証明です。なぜならそれは導出可能であり、今日何もそれを導出しないからです。結果スキーマはMADQueryFullがすでに計算するSELECTリストそのもの——アクティブなクエリフィールド、Table.Fieldでエイリアスされ、集計とグループ化が射影するものを加えたもの——です。型と幅はスキーマスナップショット(RptqDatabaseSchemaField)から、集計列はMADAggregateFunctionTypeから来ます。作業はSELECTリストの構築を実行から分割し、それをMADDataColumnとして返すことです。また、行の前に列が存在する瞬間に、ゼロ行のSqlite3ギャップも無料で修正します。ドライバはすでにaddRow:の前にaddColumn:を行い、テーブルのDDLは最初の列で作成されます(MADDataTableFast.m:526-543)。
データオブジェクトには、名前変更を生き延びる名前と、再生成を生き延びるアドレスが必要です。
Rptqエンティティと同様、ストア行のidentifier、および人間向けの名前。マテリアライゼーションのタグはオブジェクトの識別子ハッシュになり、fileURL.lastPathComponent.hashではありません——これはこの目的のために、ファイル名をキーとするアドレッシングを退役させます(MAD_FORMAT.md §5.3の危険。MAD_FUTURE.md §2.2の「コンテンツハッシュをキーに」という注記はレンダーレイヤーの同じ修正です)。.maddbを保持しています。自然な形式化は、その中にデータオブジェクトごとに1つのt<tag>テーブルを置くこと(タグはすでにそれらを区別します)、それぞれが独自の.mdcache形式のスキーマplistを持つことです。オブジェクトごとの.maddbファイル(t<tag>/<tag>.maddbの対を文字通りに取る)が代替案であり、§5.1がいつ重要になるかを述べています。最小の形、推奨:
RptqQueryが名前を得る(すでに定義であり、何も移動しません)。RptqQueryTableの参照——今日は1つのRptqDatabase内のスキーマテーブルID——が2つ目の種類を得ます。別のデータオブジェクトです。これは合成が必要とする唯一のスキーマ変更であり、追加的です。スキーマテーブル参照を持つv1行は、今日と同じ意味です。RptqDatabase行をサポートし、それぞれが独自のクエリを持ちます(RptqQueryごとに1つのMADModelDatabase、§3.1)。今日のドキュメントがそれぞれ1つずつ持つのは、作成フローが1つ作るからです。スキーマは2017年に将来対応され、今も待っています。より重い代替案——定義を所有する新しいRptqDataObjectエンティティを作り、RptqQueryを降格する——は、よりクリーンな命名とより大きな移行です。決定9.1として記録されています。
このセクションは意図的に予定されていません(ユーザー、2026-10-16: 「組み立てたくはない……しかしこのアイデアを文書化したい」)。それが存在するのは、必要になったときに発見ではなく計画であるためです。
RptqDatabase、ドライバ、認証情報——に対して実行され、自身のSQLiteテーブルにマテリアライズします(§4.3により、ドキュメントのキャッシュ内のt<tag>)。MADQueryFullが結合グラフですでに実行するのと同じアルゴリズム、MADQueryFull.m:202)。ソースが先、合成するオブジェクトが最後、その結果は他のものと同様にマテリアライズされます。.maddbであるクエリです。MADSqlite3はすでに完全なMADDatabaseであるため、このステップのドライバは今日出荷されています。複数のt<tag>テーブルを保持する1つの.maddbはATTACHをまったく必要としません。ATTACH DATABASEは別々のファイル——オブジェクトごとに1つの.maddb、または異なるドキュメントのオブジェクト——の変種であり、サブレポート境界がファイル境界である場合にATTACH(またはコピーイン)が唯一の結合経路です。一行版は、これがプロジェクトではなく組み立てである理由のすべてです。すべてのクエリの結果はすでにSQLiteテーブルであり、SQLiteはすでにドライバです。 フェデレーションエンジンは箱の中にあり、現在はファイル名ハッシュでアドレス指定されています。
RptqQueryTable → データオブジェクト。SQL生成はそれをdb.tableではなくオブジェクトのマテリアライゼーションテーブルに解決します。MADDatabaseSqlite3のATTACHサポート。見積もりを正直に保つために記録します。§3.6の3つのハードワイヤリングポイント(MADQueryFullの再読、1スロットのdataTableForQuery:、スコープされていないMADQueryActiveQueryFields)はそれぞれ、2つ目のクエリ——ましてネストされたクエリ——が実行できる前に倒れなければなりません。MADModelDocumentは変更パスでfirstQueryだけをミラーし(MADModel_Layer.md §8)、RptqQuery -sortDescriptorsForDatabase:はドキュメントの単一キャッシュに対してグループ化します。どれも難しくはありませんが、すべてが現在の単一クエリアプリにとって負荷を支えています。
ユーザーの問い、2026-10-16: 「CLIは本当にテスト、理解、将来の使用のためのもので……重要だが、目標はウェブサーバーから呼び出せるものを持つことで、CLIがその最良の方法かどうかはわからない。」
成果物が現状のままでの正直な答え:
inspect、schema、query、refresh、export、write——は、§3の呼び出しチェーンのサンプル呼び出しサイトです。コンテナを開き、ストアを読み、SQLを生成し、テーブルに実行し、レンダリングします。ウェブサーバーが必要とするのは、安定したエントリポイントの背後にある同じチェーンです。サブプロセスはそのチェーンの1つのバインディングであり(MAD_LINUX.md §2がスケッチする形: サブプロセスとしてのmad --format json)、リンクされたライブラリは別、インプロセスのObjective-C/Swift APIは3つ目です。.madを開き、クエリを実行し、行を返すUIKitフリーのトップレベルクラスは今日存在しません。AppleではMADocumentはUIDocumentであり、CLIのMADCLIDocumentは振る舞いとしてはヘッドレスですが、そのUIDocumentのためにランループを待ちます。(Phase Dはヘッドレス側を解決しました。MADHeadlessDocumentはLinuxのエントリポイントであり、Phase E以降はレンダー半分も担います——MADDocumentRenderProtocol、MADReportPageBuilder——のでmad exportはそこで実行されます。MAD_LINUX.md §9。)§4の契約は、そのようなエントリポイントが公開するものです。open → データオブジェクトを一覧 → describe → execute → (スキーマ、行)。MAD_CLI.md §8.3、ROADMAP.mdの決定表)とAIレイヤーが検証する構造化出力(MAD_FUTURE.md §7)と同じ形です。MADDataColumnはすでにplist可能な列記述であり、.mdcache plistはすでにシリアライズされた結果スキーマです。JSONの形を一度、公開の場で設計すれば、エクスポート、API、AIがすべてそれを消費します。ROADMAP.md Track 3が設定した規律です。アプリを脇に置いてドキュメントを見えるようにすること、エラー語彙としての終了コード(0〜5)、フォーマットを固定するラウンドトリップフィクスチャ。それらはウェブサーバーに移動せず、ウェブサーバーのエンジンを正直に保つ方法です。「契約が存在すればこれは安い」という背後にある測定済みの事実: データパスはすでにヘッドレスです——SQL生成、ストア、MADDataTableFast、3つのドライバすべてが今日Linuxでコンパイルされ、124のテスト実行ファイルと1,270のテストがグリーン(Linux/README.md)。Phase D以降、CLIはそのイメージ内でビルド・実行されます(inspect、schema、query、refresh、export、write)。したがって続く順序は、契約が最初、エントリポイントが2番目、フロントエンドが3番目であり、「CLIかウェブサーバーか」をアーキテクチャの分岐ではなく二行の答えを持つ問いにします。
アプリが出荷を続け、スイートが全体を通じてグリーンを保つように順序付けられています。各フェーズは引退させる§3の変更を名指しします。
| フェーズ | 作業 | 引退させるもの |
|---|---|---|
| 1 | 契約。 MADQueryFullのSELECTリスト構築を実行から分割し、MADDataColumnとして返す。describe/executeプロトコルを追加し、MADOperationRefreshにそれらを呼ばせる。振る舞いの変更なし。 |
スキーマ専用APIの不在。ゼロ行Sqlite3のスキーマ喪失 |
| 2 | クエリが自身を所有する。 MADQueryFullは与えられたクエリを取る(ドキュメント再読なし)。-dataTableForQuery:はクエリごとに解決する。MADQueryActiveQueryFieldsはクエリにスコープする。MADModelDocumentは任意のクエリをミラーする。1つのドキュメント、多数のオブジェクト。 |
§3.6の3つのハードワイヤリングポイントすべて |
| 3 | アイデンティティとアドレス。 ストアでオブジェクトに名前を付ける。マテリアライゼーションをファイル名ではなくオブジェクト識別子でタグ付けする。キャッシュ内にオブジェクトごとに1つの結果テーブル。オブジェクトごとのスキーマplist。 | ファイル名ハッシュのマテリアライゼーション。ドキュメントごとに1テーブル |
| 4 | バインドと表面。 レイアウトはデータオブジェクトのスキーマにバインドする。CLIはdescribeを獲得する。JSONの形を一度固定する(エクスポート+API+AI)。 |
「ドキュメントのクエリ」へのバインディング |
| 5 | 合成(§5)、求められたときだけ。 | — |
Phase 1は設計の本当のペイロードであり、最小です。ストア変更、UI変更、新しいフォーマットは不要で、すでに存在するコードを並べ替えるだけで、現在のスイートとゼロ行クエリのスキーマアサーションで証明できます。Phase 2〜4は、単一クエリの前提を保持するレイヤーに同じアイデアを適用したものです。Phase 5は組み立てであり、文書化され、予定されていません。
TASKS.md/BUGS.mdの慣習が適用されます。ここにあるものはエージェントの主導で始められません。)MAD_FORMAT.md §5.1が現行の分析です。MADQueryDefinition*、RptqQuerySort、MADQueryFullTableEnumerator、自由テキスト上書きフィールド)にこの一環として触れない——それらは別の整理決定です。RptqQueryに名前を付けるか(最小、推奨)、RptqDataObjectを独自のエンティティとして導入するか(よりクリーン、より大きな移行)?.maddbでオブジェクトごとに1つのt<tag>(推奨——ATTACHなし、新しいファイルなし)、それともオブジェクトごとに1ファイル(合成時にATTACH)?MAD_FUTURE.md §2.2はマテリアライゼーションの対(.maddb + .mdcache)を共有可能な成果物にします。この設計では、共有の単位はデータオブジェクトの結果か、ドキュメントか?MADDataColumnは豊富です。名前/型/長さはウェブサーバーとAIが必要とするものです。JSONの形(一度決定、§6)がこれを固定する場所です。MAD_FUTURE.mdは業界の成果物をモデルと呼びます。何かが構築される前にどちらかが勝つべきです。ストアエンティティ、プロトコル、CLIの動詞に着地するからです。クエリタブはすでに関数を構築し、リフレッシュチェーンはすでにそれをコンパイルして実行し、結果テーブルはすでにSQLiteとしてディスク上にスキーマと結果セットを持ち、2つを結合するドライバはすでに存在しLinuxでコンパイルされます。それらのどれも持っていないのは、名前、アドレス、describe半分です——「レポートのクエリ」をデータオブジェクトに、データオブジェクトを別のデータオブジェクトが使えるテーブルに変える3つのものです。残り——サブレポート、複数のソース、エンジンの上に立つウェブサーバー——はその上の合成であり、何も新しいものを発明する必要がないからこそ正確に合成します。それは既存のパイプラインを、ファイル名ハッシュより良いものでアドレス指定したものです。
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。