進め方（Dev-Portal 開発タスクの最短ルート）

1) /sql/execute_params の処理パイプラインを固定

Dev-Portal 内の処理はこれで確定で良いです：

1. request を受ける：{ sql_params, options }
2. Chroma 検索（カスタマイズ分の文脈）
3. LLM に投げて SQL 生成（Odoo標準も含める）
4. sql_guard.prepare() で 単文/SELECT-only/危険語/ LIMIT / 正規化
5. Odoo DB に対して SQL 実行（read-only推奨）
6. SqlResult を返す（rows/columns/row_count + executed_sql）

options.dry_run=true のときは、

• **executed_sql だけ返す（rows/columnsは空、row_count=0）**でも契約上は十分です（Phase 7的に便利）。

2) sql_guard の流用方法（おすすめ）

あなたの sql_guard.py はそのまま Dev-Portal に移植できます。

• Dev-Portal 例：api/app/services/sql_guard.py にコピー
• SQL生成直後（LLMの出力SQL）に 必ず prepare() を通す
• 返却する executed_sql は prepare() 後の final_sql を入れる

さらに運用が楽になるので、追加フィールドとして返してOKです（追加のみなので破壊的変更にならない）：

• sql_hash: short_hash12
• guards_applied: applied_guards（例: ["single-statement","select-only","limit-enforced"]）

3) Odoo接続情報の “K8sローカル調査” のやり方（やることだけ）

（あなたが調査する前提で、確認ポイントだけ整理）

• Postgres Service 名、Namespace、Port
  • 例：kubectl get svc -A | grep -i postgres
• Odoo の DB 名 / user / host
  • ConfigMap / Secret を見る
  • 例：
    • kubectl get cm -n odoo -o yaml | grep -n "db_" -n
    • kubectl get secret -n odoo -o yaml
• 実行確認（Dev-Portal Pod から到達できるか）
  • Pod 内から psql またはアプリの DATABASE_URL で接続テスト
• read-only ユーザが無ければ、まずは既存ユーザで疎通 → 後で read-only 切るでもOK

4) Chroma の “入っている情報” 調査で取るべきメモ

調査結果として最低限これが分かれば、SQL生成プロンプトが固まります。

• コレクション名（例：portal_field_ja / portal_view_common_ja / etc）
• 1doc の text 形式（どんなテンプレで入っているか）
• metadata のキー（例：entity, model, natural_key, field_name, model_table, ttype…）
• 検索方法（top_k、filter 条件、model絞り込みの可否）
• embedding model/dim（将来トラブル回避用）

---

スレッド移動用のまとめ（必要箇所だけ Markdown）

# Phase 7 Dev-Portal 実装前提まとめ（SQL Build + Execute for Odoo）

## 仕様（固定）
- SQL生成は Dev-Portal が担当する：
  - ChromaDB（カスタマイズ分の文脈） → LLM（Odoo標準分の補完）で SQL を組み立てる
- 生成したSQLは **OdooのDB(Postgres)に直接アクセスして抽出**する
- KPI Postgres は今回対象外（KPIはDeciKG側）
- Dev-Portal は nlq-dev に **抽出データ + executed_sql** を返す
- nlq-dev は返ってきたデータを基に analysis/提案を行う（SQL実行はしない）

## Dev-Portal API（最低限）
- POST /sql/execute_params
  - request: { sql_params: object, options?: { dry_run?: bool, timeout_ms?: number } }
  - response (SqlResult): { columns, rows, row_count, metabase?, executed_sql? }

## Dev-Portal 内部パイプライン（推奨固定）
1) sql_params 受領
2) Chroma 検索（カスタマイズ分コンテキスト）
3) LLM で SQL 生成
4) SQL Guard（必須）: 単文/SELECT-only/危険語ブロック/LIMIT/正規化
5) Odoo DB で実行（read-only推奨）
6) SqlResult 返却（+ executed_sql）

## 安全制約（流用）
- nlq-dev の api/app/services/sql_guard.py を Dev-Portal に移植し、
  LLM生成SQLに対して Dev-Portal 側で prepare() を必ず適用する
- 追加返却OK（任意）: sql_hash, guards_applied

## ローカル開発で確定が必要（不足分）
1) Odoo DB 接続情報（K8sローカルで調査して確定）
   - host/service, port, dbname, user/pass, namespace
2) Chroma の実データ仕様（調査して確定）
   - collection名 / doc text / metadata keys / embedding dim