必須
docs/dev-portal-integration.md(全文)
DEVPORTAL_MODE=dummy|httpの切替- 呼び出し先:
DEVPORTAL_URL + DEVPORTAL_SQL_PATH(既定/sql/execute_params) - nlq-dev が Dev-Portal に渡すのは
sql_params(SQL文字列ではない) という固定方針
docs/NLQ_API_CONTRACT.mdの Execute 系だけ
- ExecuteRequest の下限:
sql_paramsを持てること(sqlはレガシーで残るがダミー可) - SqlResult の下限形:
columns / rows / row_count / metabase / executed_sql - ExecuteResponse v0.2:
sql_resultをどこに入れるか(nlq-dev側)を確認するため
あると早い
docs/fixtures/execute_sql_only.v0.2.json
→ Dev-Portal 側でまず返せるようにする “完成イメージ” として最速
DeciKG をローカル開発する時に参照する箇所(nlq-dev docs)
必須
docs/decikg-integration.md(全文)
DECIGK_MODE=dummy|httpの切替- nlq-dev が渡すのは
decikg_params(Cypher文字列ではない) - DeciKG が返すのは
graph_result(nodes/edges) の下限形
docs/NLQ_API_CONTRACT.mdの Execute 系(Graph側)だけ
- GraphResult の下限形:
nodes[] / edges[](id/source/target/props) - ExecuteResponse v0.2 の描画ルール(merged/graph の有無)
※DeciKG自体が描画しないとしても、返す形がUIに直結するので参照価値あり
あると早い
docs/fixtures/execute_cypher_only.v0.2.json
→ graph_result の“完成イメージ”
今あなたが「まず作るべき」最小到達点(ローカル)
Dev-Portal:
POST /sql/execute_paramsが 固定レスポンスでもいいのでSqlResult相当を返す
DeciKG:
POST /graph/query(仮)で 固定レスポンスでもいいのでGraphResultを返す
そのあと nlq-dev を DEVPORTAL_MODE=http / DECIGK_MODE=http に切り替えて接続テスト、という順番が最短です。
必要なら次の一手として、Dev-Portal側の /sql/execute_params と DeciKG側の /graph/query を「まず固定レスポンスで返すだけ」の 最小FastAPI実装(router+schema) を貼れます。
コメントを残す